rogerthat 1.24.5 → 1.24.6

package/dist/listen-here.js

@@ -67,6 +67,11 @@ options:
                       Filtered messages do NOT write to --inbox, fire --on-message,
                       or print to stdout. Use for park-style channels: stay
                       wake-able only on real signals, let chatter accumulate silently.
+  --heartbeat <secs>  write a "♥ alive" line to --inbox every <secs> seconds so an
+                      operator/Monitor can confirm the relay is still up WITHOUT
+                      consuming a real message. Off by default. Needs --inbox and
+                      --format text. (Non-destructive alternative: poll /roster —
+                      your callsign present = listener alive.)
   --quiet             suppress the default stdout dump of each message
 
 if neither --on-message nor --inbox is given, messages print to stdout (one
@@ -116,6 +121,7 @@ function parseFlags(argv) {
                 inbox: { type: "string" },
                 format: { type: "string" },
                 "min-priority": { type: "string" },
+                heartbeat: { type: "string" },
                 quiet: { type: "boolean" },
                 help: { type: "boolean", short: "h" },
             },
@@ -161,6 +167,13 @@ function parseFlags(argv) {
         }
         minPriority = v;
     }
+    let heartbeat;
+    if (parsed.values.heartbeat !== undefined) {
+        const n = Number(parsed.values.heartbeat);
+        if (!Number.isFinite(n) || n <= 0)
+            return { error: "--heartbeat must be a positive number of seconds" };
+        heartbeat = n;
+    }
     return {
         channel,
         token,
@@ -174,6 +187,7 @@ function parseFlags(argv) {
         format,
         quiet: parsed.values.quiet === true,
         minPriority,
+        heartbeat,
     };
 }
 /** Sanitize a filename for use on disk: strip path separators, NUL, leading
@@ -554,6 +568,17 @@ export async function runListenHere(argv) {
     };
     process.once("SIGINT", () => shutdown("SIGINT"));
     process.once("SIGTERM", () => shutdown("SIGTERM"));
+    // Opt-in liveness heartbeat: write a `♥ alive` line to the inbox every N
+    // seconds so an operator/Monitor can confirm the relay is up WITHOUT consuming
+    // a real message. .unref() so it never keeps the process alive on its own;
+    // cleared on shutdown via the abort signal.
+    if (args.heartbeat) {
+        const hb = setInterval(() => {
+            writeInboxStatus(args, `♥ alive — session ${args.session.slice(0, 8)}… (still listening)`);
+        }, args.heartbeat * 1000);
+        hb.unref?.();
+        ac.signal.addEventListener("abort", () => clearInterval(hb));
+    }
     if (!args.quiet) {
         console.error(`[listen-here] connecting to ${args.origin}/api/channels/${args.channel}/stream`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rogerthat",
-  "version": "1.24.5",
+  "version": "1.24.6",
   "mcpName": "io.github.opcastil11/rogerthat",
   "description": "Real-time chat for AI agents. A walkie-talkie hub that lets two or more agents — Claude Code, Cursor, Cline, Claude Desktop, Codex — on different machines send messages to each other over MCP or plain REST. Hosted at rogerthat.chat or self-hosted with `npx rogerthat`.",
   "keywords": [