@ouro.bot/cli 0.1.0-alpha.960 → 0.1.0-alpha.962

package/changelog.json

@@ -1,6 +1,20 @@
 {
   "_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.962",
+      "changes": [
+        "The upgrade check that asks the Butler to change his personality now asks for a change for everyone, so his saved per-person preference can no longer make the check pass or fail at random.",
+        "When the Butler finishes watching something for you, he now tells you in his own plain words what he checked, instead of forwarding his internal notes.",
+        "If the Butler's first try at telling you a watch finished does not go through, he resends the same words instead of getting stuck."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.961",
+      "changes": [
+        "When Butler finishes a watch you asked for in Telegram, he now actually tells you and closes it, instead of silently re-checking every few hours."
+      ]
+    },
     {
       "version": "0.1.0-alpha.960",
       "changes": [

package/deploy/unraid/sanctuary-replay-gate.mjs

@@ -428,7 +428,8 @@ export const CASES = [
   {
     id: "psyche-via-pr",
     // A concrete ask. Given only "can you change your personality?" the Butler describes the pull-request path and offers to file it once told what to change (alpha.878 session bf112be9), which is reasonable, so he never calls a filing tool.
-    words: "change your personality: drop the jokes and be formal and flat with me from now on",
+    // It asks for everyone, not "with me": the replay principal already has a saved formal, flat preference, so "with me" is already met and offering to file was an equally right answer, which failed this case in about half of runs (alpha.961 sessions 09585e4a, c9d1ee4d, b196f170).
+    words: "change your personality for everyone you talk to, not just me: drop the jokes and be formal and flat from now on",
     sender: "principal",
     delegated: false,
     readback: ({ trace, reply, said, before, after }) => {

package/deploy/unraid/sanctuary.ouro/bundle-meta.json

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.960",
+  "runtimeVersion": "0.1.0-alpha.962",
   "bundleSchemaVersion": 3,
   "lastUpdated": "2026-09-03T00:00:00.000Z"
 }

package/deploy/unraid/sanctuary.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <Container version="2">
   <Name>ouro-butler</Name>
-  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.960</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.962</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/heart/awaiting/await-runtime-state.js

@@ -38,6 +38,9 @@ exports.applyAwaitRuntimeState = applyAwaitRuntimeState;
 exports.writeAwaitRuntimeState = writeAwaitRuntimeState;
 exports.recordAwaitDispatch = recordAwaitDispatch;
 exports.recordAwaitCheck = recordAwaitCheck;
+exports.pinAwaitAlertContent = pinAwaitAlertContent;
+exports.clearAwaitAlertContent = clearAwaitAlertContent;
+const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const json_store_1 = require("../../arc/json-store");
 const session_events_1 = require("../session-events");
@@ -109,3 +112,19 @@ function recordAwaitCheck(agentRoot, name, observation, now) {
         checked_count: nextCount,
     });
 }
+// A request-bound alert's Telegram effect is keyed by the await name alone, so a
+// retry with different words is refused as a reused key and the watch never
+// closes. The first text tried is pinned and every retry resends it.
+function awaitAlertDir(agentRoot) {
+    return path.join(agentRoot, "state", "await-alerts");
+}
+function pinAwaitAlertContent(agentRoot, name, content) {
+    const pinned = (0, json_store_1.readJsonFile)(awaitAlertDir(agentRoot), name);
+    if (typeof pinned?.content === "string")
+        return pinned.content;
+    (0, json_store_1.writeJsonFile)(awaitAlertDir(agentRoot), name, { schemaVersion: 1, name, content });
+    return content;
+}
+function clearAwaitAlertContent(agentRoot, name) {
+    fs.rmSync(path.join(awaitAlertDir(agentRoot), `${name}.json`), { force: true });
+}

package/dist/repertoire/tools-awaiting.js

@@ -55,6 +55,7 @@ const session_events_1 = require("../heart/session-events");
 const runtime_1 = require("../nerves/runtime");
 const await_parser_1 = require("../heart/awaiting/await-parser");
 const await_alert_1 = require("../heart/awaiting/await-alert");
+const await_runtime_state_1 = require("../heart/awaiting/await-runtime-state");
 const friends_1 = require("@ouro.bot/friends");
 const a2a_await_delivery_1 = require("../heart/awaiting/a2a-await-delivery");
 const pending_1 = require("../mind/pending");
@@ -143,9 +144,28 @@ function setAwaitToolDeps(deps) {
 function resetAwaitToolDeps() {
     injected = {};
 }
+/**
+ * A tick runs in the private runtime, where no resident Telegram sense registered a deliverer. Without this one-shot
+ * sender a Telegram-bound watch queued its alert in the inner pending folder, never reached the owner, and never closed.
+ * A resident sense's own deliverer still wins when one is registered.
+ */
+async function sendTelegramAwaitAlert(agentName, request) {
+    // Only a request-bound watch has an exact chat to answer; any other alert keeps queueing for the agent's next turn.
+    if (!request.requestId)
+        return { status: "unavailable", detail: "no request-bound Telegram chat to answer" };
+    const { sendTelegramAwaitFollowUp } = await Promise.resolve().then(() => __importStar(require("../senses/telegram")));
+    return sendTelegramAwaitFollowUp(agentName, request);
+}
 function resolveDeliveryDeps(agentName) {
     const deps = injected.buildDeliveryDeps ? injected.buildDeliveryDeps(agentName) : defaultDeliveryDeps(agentName);
-    return { ...deps, deliverers: { a2a: (0, a2a_await_delivery_1.createA2AAwaitOwnerDeliverer)(agentName), ...deps.deliverers } };
+    return {
+        ...deps,
+        deliverers: {
+            a2a: (0, a2a_await_delivery_1.createA2AAwaitOwnerDeliverer)(agentName),
+            telegram: (request) => sendTelegramAwaitAlert(agentName, request),
+            ...deps.deliverers,
+        },
+    };
 }
 const ASK_OWNER_MIN_CHOICES = 2;
 const ASK_OWNER_MAX_CHOICES = 4;
@@ -462,7 +482,9 @@ function fulfillAwaitObligation(agentRoot, awaitFile) {
 /** The package-managed daily sweep must stay a byte-exact pending file in awaiting/, so it can only ever be resolved 'no'. */
 exports.HOUSE_CARE_AWAIT = "house-care-sweep";
 const isHouseCareAwait = (name) => String(name ?? "").replace(/\.md$/u, "") === exports.HOUSE_CARE_AWAIT;
-async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName, ask) {
+async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName, ask, message) {
+    // The words for whoever asked; without them they get the condition and observation, which read as unsourced notes.
+    const content = typeof message === "string" && message.trim() ? message.trim() : undefined;
     const nameError = validateName(name);
     if (nameError)
         return JSON.stringify({ error: nameError });
@@ -500,7 +522,7 @@ async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName
     let alert = null;
     if (existing.request_id && existing.filed_from !== "external-event") {
         try {
-            alert = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: existing, reason: "resolved", observation: observation.trim(), agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
+            alert = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: existing, reason: "resolved", observation: observation.trim(), content: (0, await_runtime_state_1.pinAwaitAlertContent)(agentRoot, name, content ?? (0, await_alert_1.buildAlertContent)(existing, "resolved", observation.trim())), agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
         }
         catch (error) {
             (0, runtime_1.emitNervesEvent)({ level: "error", component: "repertoire", event: "repertoire.await_alert_error", message: "await alert delivery threw", meta: { agent: agentName, name, error: error instanceof Error ? error.message : String(error) } });
@@ -530,6 +552,8 @@ async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName
     if (!archive.ok)
         return JSON.stringify({ error: archive.error });
     fulfillAwaitObligation(agentRoot, archive.file);
+    if (existing.request_id)
+        (0, await_runtime_state_1.clearAwaitAlertContent)(agentRoot, name);
     (0, runtime_1.emitNervesEvent)({
         component: "repertoire",
         event: "repertoire.await_resolved",
@@ -538,7 +562,7 @@ async function resolveAwaitTool(name, verdict, observation, agentRoot, agentName
     });
     if (!existing.request_id) {
         try {
-            alert = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: archive.file, reason: "resolved", observation: observation.trim(), agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
+            alert = await (0, await_alert_1.deliverAwaitAlert)({ awaitFile: archive.file, reason: "resolved", observation: observation.trim(), content, agentRoot, agentName, deliveryDeps: resolveDeliveryDeps(agentName) });
         }
         catch (error) {
             (0, runtime_1.emitNervesEvent)({ level: "error", component: "repertoire", event: "repertoire.await_alert_error", message: "await alert delivery threw", meta: { agent: agentName, name, error: error instanceof Error ? error.message : String(error) } });
@@ -783,6 +807,7 @@ exports.awaitingToolDefinitions = [
                         name: { type: "string", description: "Await name (filename stem)." },
                         verdict: { type: "string", enum: ["yes", "no", "ask_owner"], description: "Exactly 'yes' if the condition is met. Exactly 'no' for anything else, including still pending, not yet, or unable to tell: send 'no' with an observation and polling continues. 'ask_owner' only when the condition cannot be met without the owner deciding; it needs question and choices." },
                         observation: { type: "string", description: "One-line summary of what I saw this tick." },
+                        message: { type: "string", description: "Only for 'yes': what I tell whoever asked, written to them in plain words and sent as is. Say what I just checked and what it means for them." },
                         question: { type: "string", description: "Only for ask_owner: the decision I need from my owner, in plain words." },
                         choices: { type: "array", items: { type: "string" }, minItems: 2, maxItems: 4, description: "Only for ask_owner: 2 to 4 short options the owner can pick from." },
                     },
@@ -825,7 +850,7 @@ exports.awaitingToolDefinitions = [
                 if (!binding?.active)
                     return JSON.stringify({ error: "resolve_await is limited to the current relationship request or bound external event" });
             }
-            return resolveAwaitTool(a.name, a.verdict, a.observation, agentRoot, agentName, { question: a.question, choices: a.choices });
+            return resolveAwaitTool(a.name, a.verdict, a.observation, agentRoot, agentName, { question: a.question, choices: a.choices }, a.message);
         },
         riskProfile: {
             mutates: ["durable_state_write", "external_side_effect"],

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

@@ -59,7 +59,7 @@ function buildAwaitTurnMessage(options) {
         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.");
+    lines.push("look around and decide. if the condition is met, call resolve_await with verdict='yes', a one-line observation, and a message: what i tell whoever asked, in plain words to them, saying what i just checked. otherwise call resolve_await with verdict='no' and a one-line observation of what i saw this tick.");
     lines.push("verdicts: 'yes' (condition met), 'no' (not yet or unsure), 'ask_owner' (only when the condition cannot be met without my owner deciding, e.g. a confirmed dead download, or a stall the tool marks owner_decision_needed; give a plain question and 2-4 choices).");
     return lines.join("\n");
 }

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.960",
+  "version": "0.1.0-alpha.962",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.960",
+      "version": "0.1.0-alpha.962",
       "dependencies": {
         "@anthropic-ai/sdk": "^0.78.0",
         "@azure/identity": "^4.13.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.960",
+  "version": "0.1.0-alpha.962",
   "engines": {
     "node": ">=22"
   },