@ouro.bot/cli 0.1.0-alpha.956 → 0.1.0-alpha.958

package/dist/senses/telegram.js

@@ -1137,13 +1137,22 @@ function createTelegramSenseApp(options) {
         const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
         return (0, telegram_handoff_1.ownerChatHandedOff)((0, session_events_1.loadSessionEnvelopeFile)(sessionPath)?.events ?? [], Date.now());
     };
-    const holdNoticeDuringHandoff = (text, key) => {
-        if (!ownerChatIsHandedOff())
+    const proactiveLedgerPath = path.join(agentRoot, "state", "telegram", "proactive-sends.json");
+    const countProactiveSend = () => { if (options.proactivePacing)
+        (0, telegram_handoff_1.recordProactiveSend)(proactiveLedgerPath, new Date(), options.proactivePacing); };
+    const releasedHeldKeysPath = path.join(agentRoot, "state", "telegram", "released-held-keys.json");
+    const holdNoticeDuringHandoff = (text, key, critical = (0, telegram_handoff_1.isCriticalNoticeKey)(key)) => {
+        const handedOff = ownerChatIsHandedOff();
+        const pacingReason = !handedOff && options.proactivePacing && !critical ? (0, telegram_handoff_1.proactiveHoldReason)(proactiveLedgerPath, new Date(), options.proactivePacing) : null;
+        if (!handedOff && !pacingReason)
             return false;
         const held = (0, telegram_handoff_1.readHeldNotices)(heldNoticesPath);
         if (!held.some((notice) => notice.key === key))
             (0, telegram_handoff_1.writeHeldNotices)(heldNoticesPath, [...held, { key, text }]);
-        (0, runtime_1.emitNervesEvent)({ component: "senses", event: "senses.telegram_notice_held_for_handoff", message: "held a house notice while the owner's chat is handed to someone else", meta: { agentName: options.agentName } });
+        if (handedOff)
+            (0, runtime_1.emitNervesEvent)({ component: "senses", event: "senses.telegram_notice_held_for_handoff", message: "held a house notice while the owner's chat is handed to someone else", meta: { agentName: options.agentName } });
+        else
+            (0, runtime_1.emitNervesEvent)({ component: "senses", event: "senses.telegram_notice_held_for_pacing", message: "held a house notice for quiet hours or the daily message cap", meta: { agentName: options.agentName, reason: pacingReason } });
         return true;
     };
     let heldNoticeRelease = Promise.resolve();
@@ -1156,6 +1165,21 @@ function createTelegramSenseApp(options) {
             if (ownerChatIsHandedOff())
                 return;
             const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
+            if (options.proactivePacing) {
+                // Held notices go out as one message, and only when an unprompted message is allowed now (quiet hours and the daily cap).
+                if ((0, telegram_handoff_1.proactiveHoldReason)(proactiveLedgerPath, new Date(), options.proactivePacing))
+                    return;
+                /* v8 ignore next -- the caller already saw held notices; only a concurrent release can empty the file before this re-read @preserve */
+                if (held.length === 0)
+                    return;
+                const folded = (0, telegram_handoff_1.foldHeldNotices)(held);
+                if (held.length > 1)
+                    (0, telegram_handoff_1.recordReleasedHeldKeys)(releasedHeldKeysPath, held.map((notice) => notice.key));
+                (0, telegram_handoff_1.writeHeldNotices)(heldNoticesPath, (0, telegram_handoff_1.readHeldNotices)(heldNoticesPath).filter((entry) => !held.some((notice) => notice.key === entry.key)));
+                await recordAcceptedEffects(sessionPath, [await deliverButlerEffect(folded.text, folded.key, signal)]);
+                countProactiveSend();
+                return;
+            }
             for (const notice of held) {
                 (0, telegram_handoff_1.writeHeldNotices)(heldNoticesPath, (0, telegram_handoff_1.readHeldNotices)(heldNoticesPath).filter((entry) => entry.key !== notice.key));
                 await recordAcceptedEffects(sessionPath, [await deliverButlerEffect(notice.text, notice.key, signal)]);
@@ -1949,6 +1973,7 @@ function createTelegramSenseApp(options) {
                     return;
                 await releaseHeldNotices(signal);
                 const effect = await deliverButlerEffect(proactiveText, key, signal);
+                countProactiveSend();
                 const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
                 await recordAcceptedEffects(sessionPath, [effect]);
             });
@@ -1967,7 +1992,9 @@ function createTelegramSenseApp(options) {
                 const text = requiredText(input.text, "external event decision");
                 const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
                 const held = (0, telegram_handoff_1.readHeldNotices)(heldNoticesPath);
+                const releasedKeys = (0, telegram_handoff_1.readReleasedHeldKeys)(releasedHeldKeysPath);
                 const ownerMessageExists = (candidate) => held.some((notice) => notice.key === candidate)
+                    || releasedKeys.includes(candidate)
                     || getEffectJournal().readByIdempotencyKey(candidate) !== null;
                 if (ownerMessageExists(key)) {
                     // A retry after the message went out (or was held): finish the original send, never send a reworded second one.
@@ -1991,10 +2018,11 @@ function createTelegramSenseApp(options) {
                     });
                     return { status: "covered", effectKey: coveredBy };
                 }
-                if (holdNoticeDuringHandoff(text, key))
+                if (holdNoticeDuringHandoff(text, key, [key, ...relatedKeys].some(telegram_handoff_1.isCriticalNoticeKey)))
                     return { status: "sent", effectKey: key };
                 await releaseHeldNotices(input.signal);
                 const effect = await deliverButlerEffect(text, key, input.signal);
+                countProactiveSend();
                 await recordAcceptedEffects(sessionPath, [effect]);
                 return { status: "sent", effectKey: key };
             });
@@ -2012,6 +2040,7 @@ function createTelegramSenseApp(options) {
                     return;
                 await releaseHeldNotices(input.signal);
                 const effect = await deliverButlerEffect(text, `owner-notice:${noticeId}`, input.signal);
+                countProactiveSend();
                 const sessionPath = (0, shared_turn_1.getSenseSessionPath)(options.agentName, configuredOwnerFriendId, "telegram", configuredOwnerSessionKey, agentRoot);
                 await recordAcceptedEffects(sessionPath, [effect]);
             });
@@ -2323,6 +2352,8 @@ async function startTelegramSenseApp(agentName, waitForAuthority = false) {
             agentName,
             credentials,
             authorityTransport,
+            // The owner is in Los Angeles; a container without TZ would otherwise run quiet hours on UTC.
+            proactivePacing: { timeZone: process.env.TZ || "America/Los_Angeles" },
             ...(await createProductionTelegramRelationshipComposition(agentName, credentials, undefined, authorityTransport)),
             ...(agentName === "sanctuary" ? { privilegedFailsafe: {
                     eventRoot: (0, router_1.getExternalEventRoot)(),

package/npm-shrinkwrap.json

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