@ouro.bot/cli 0.1.0-alpha.821 → 0.1.0-alpha.822

package/changelog.json

@@ -1,6 +1,13 @@
 {
   "_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.822",
+      "changes": [
+        "Suppress a proactive Telegram message that repeats a recent one apart from its clock reading.",
+        "Evict the repetition guard's oldest entry in insertion order, removing a comparison branch monotonic time could never take."
+      ]
+    },
     {
       "version": "0.1.0-alpha.821",
       "changes": [

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

@@ -1,5 +1,5 @@
 {
-  "runtimeVersion": "0.1.0-alpha.821",
+  "runtimeVersion": "0.1.0-alpha.822",
   "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.821</Repository>
+  <Repository>ghcr.io/ourostack/ouroboros-butler:0.1.0-alpha.822</Repository>
   <Registry>https://github.com/ourostack/ouroboros/pkgs/container/ouroboros-butler</Registry>
   <Network>host</Network>
   <Shell>sh</Shell>

package/dist/senses/telegram.js

@@ -51,6 +51,7 @@ exports.loadTelegramSenseCredentials = loadTelegramSenseCredentials;
 exports.createProductionTelegramRelationshipComposition = createProductionTelegramRelationshipComposition;
 exports.startTelegramSenseApp = startTelegramSenseApp;
 exports.sendTelegramExternalEventDecision = sendTelegramExternalEventDecision;
+exports.createProactiveRepetitionGuard = createProactiveRepetitionGuard;
 exports.withTelegramTypingIndicator = withTelegramTypingIndicator;
 exports.sendTelegramAwaitFollowUp = sendTelegramAwaitFollowUp;
 const node_crypto_1 = require("node:crypto");
@@ -720,6 +721,7 @@ function createTelegramSenseApp(options) {
     const api = authorityTransport?.api ?? options.api ?? (0, telegram_client_1.createTelegramBotApi)({ token: botToken });
     // Only the root authority transport admits sendChatAction, so presence is offered
     // exactly where it is actually supported rather than attempted everywhere.
+    const proactiveRepetitionGuard = createProactiveRepetitionGuard();
     const sendTypingIndicator = authorityTransport
         ? async (chatId) => { await api.request("sendChatAction", { chat_id: chatId, action: "typing" }); }
         : undefined;
@@ -1879,7 +1881,20 @@ function createTelegramSenseApp(options) {
         },
         async sendProactive(text, signal) {
             await runWithAcceptanceAuditOwner(async () => {
-                const effect = await deliverButlerEffect(requiredText(text, "proactive message"), `proactive:${(0, node_crypto_1.randomUUID)()}`, signal);
+                const proactiveText = requiredText(text, "proactive message");
+                // Unsolicited repetition is the one thing a household agent cannot take
+                // back. External-event decisions are deliberately not guarded here:
+                // dropping one could leave its event undispositioned.
+                if (!proactiveRepetitionGuard.shouldSend(proactiveText)) {
+                    (0, runtime_1.emitNervesEvent)({
+                        component: "senses",
+                        event: "senses.telegram_proactive_repetition_suppressed",
+                        message: "suppressed a proactive message repeating a recent one",
+                        meta: { agentName: options.agentName, subject },
+                    });
+                    return;
+                }
+                const effect = await deliverButlerEffect(proactiveText, `proactive:${(0, node_crypto_1.randomUUID)()}`, signal);
                 const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
                 await recordAcceptedEffects(sessionPath, [effect]);
             });
@@ -2234,6 +2249,51 @@ async function sendTelegramExternalEventDecision(agentName, input) {
         await app.stop();
     }
 }
+/**
+ * Suppresses a proactive message that repeats one sent recently.
+ *
+ * Ari received four probe messages in about two minutes, three of them identical
+ * apart from the clock reading. Only the clock is normalised away — counts and
+ * every other number are the payload, so "3 of 10 episodes" and "7 of 10" stay
+ * distinct and both send.
+ *
+ * This catches verbatim-apart-from-the-clock repetition, not semantic near
+ * duplicates: a message reworded between sends still goes out.
+ */
+function createProactiveRepetitionGuard(options) {
+    const windowMs = options?.windowMs ?? 900_000;
+    const now = options?.now ?? (() => Date.now());
+    const maxEntries = options?.maxEntries ?? 32;
+    const seen = new Map();
+    const normalize = (text) => text
+        .trim()
+        .replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?Z?/gu, "<timestamp>")
+        .replace(/\b\d{1,2}:\d{2}(?::\d{2})?\b/gu, "<clock>")
+        .replace(/\s+/gu, " ");
+    return {
+        shouldSend(text) {
+            const at = now();
+            for (const [key, sentAt] of [...seen]) {
+                if (at - sentAt >= windowMs)
+                    seen.delete(key);
+            }
+            const key = normalize(text);
+            const previous = seen.get(key);
+            if (previous !== undefined && at - previous < windowMs)
+                return false;
+            seen.set(key, at);
+            // A Map keeps insertion order and entries are inserted in send order, so
+            // the earliest key is the oldest; scanning for a minimum would carry a
+            // comparison branch that monotonic time can never take.
+            for (const oldest of seen.keys()) {
+                if (seen.size <= maxEntries)
+                    break;
+                seen.delete(oldest);
+            }
+            return true;
+        },
+    };
+}
 /**
  * Telegram clears a typing indicator after roughly five seconds, so a turn that
  * thinks for longer has to refresh it or the chat goes silent while the Butler is

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.821",
+  "version": "0.1.0-alpha.822",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@ouro.bot/cli",
-      "version": "0.1.0-alpha.821",
+      "version": "0.1.0-alpha.822",
       "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.821",
+  "version": "0.1.0-alpha.822",
   "engines": {
     "node": ">=22"
   },