rogerrat 1.18.1 → 1.20.0

package/dist/app.js

@@ -4,7 +4,7 @@ import { dirname, join as joinPath } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Hono } from "hono";
 import { streamSSE } from "hono/streaming";
-import { ChannelError, setSessionTtlLookup, startPeriodicGc } from "./channel.js";
+import { ChannelError, isPriority, setSessionTtlLookup, startPeriodicGc, validateSuggestedReplies, } from "./channel.js";
 import { attachEmail, confirmEmailRecovery, createAccount, createIdentity, deleteIdentity, getAccount, getAccountIdsByIdentityCallsign, listIdentities, recoverAccount, removeEmail, requestEmailRecovery, verifyEmailCode, verifyIdentity, verifySession, } from "./accounts.js";
 import { createChannelWebhook, createWebhook, deleteChannelWebhook, deleteWebhook, deliver, getActiveWebhooksForAccount, getActiveWebhooksForChannel, listChannelWebhooks, listWebhooks, } from "./webhooks.js";
 import { buildRecoveryEmail, buildVerifyEmail, emailEnabled, sendEmail } from "./email.js";
@@ -743,6 +743,18 @@ export function createApp(opts) {
         const to = String(body.to ?? "");
         // Accept either `message` or `text` (transcripts return `text`, so clients reasonably try both).
         const message = String(body.message ?? body.text ?? "");
+        // Optional ntfy-style priority. Server stores it; receivers decide what to do.
+        const priorityInput = body.priority;
+        if (priorityInput !== undefined && !isPriority(priorityInput)) {
+            return c.json({ error: "invalid priority; must be one of min|low|default|high|urgent", code: "invalid" }, 400);
+        }
+        let suggestedReplies;
+        try {
+            suggestedReplies = validateSuggestedReplies(body.suggested_replies);
+        }
+        catch (e) {
+            return handleChannelError(c, e);
+        }
         const channel = getOrCreateChannel(channelId);
         try {
             const isBand = getChannelIsBand(channelId);
@@ -755,12 +767,20 @@ export function createApp(opts) {
                     retry_after_seconds: rate.retryAfter,
                 }, 429);
             }
-            const msg = channel.send(sessionId, to, message);
+            const msg = channel.send(sessionId, to, message, priorityInput, suggestedReplies);
             statsRecordMessage();
             transcriptRecordMessage(channelId, getChannelRetention(channelId), msg);
             fanoutWebhooks(channelId, msg);
             const queued = msg.to !== "all" && !channel.isCallsignOnline(msg.to);
-            return c.json({ ok: true, id: msg.id, at: msg.at, queued, to: msg.to });
+            return c.json({
+                ok: true,
+                id: msg.id,
+                at: msg.at,
+                queued,
+                to: msg.to,
+                ...(msg.priority ? { priority: msg.priority } : {}),
+                ...(msg.suggested_replies ? { suggested_replies: msg.suggested_replies } : {}),
+            });
         }
         catch (e) {
             return handleChannelError(c, e);

package/dist/channel.js

@@ -1,3 +1,44 @@
+export const PRIORITY_RANK = {
+    min: 0,
+    low: 1,
+    default: 2,
+    high: 3,
+    urgent: 4,
+};
+export function isPriority(v) {
+    return v === "min" || v === "low" || v === "default" || v === "high" || v === "urgent";
+}
+export const MAX_SUGGESTED_REPLIES = 4;
+export const MAX_SUGGESTED_REPLY_LENGTH = 64;
+/** Validate + normalize a suggested_replies array. Returns the cleaned array
+ *  or throws a ChannelError describing what's wrong. Returns undefined if
+ *  the input is undefined (the caller meant "no suggestions"). */
+export function validateSuggestedReplies(v) {
+    if (v === undefined || v === null)
+        return undefined;
+    if (!Array.isArray(v)) {
+        throw new ChannelError("suggested_replies must be an array of strings", "invalid", 400);
+    }
+    if (v.length === 0)
+        return undefined; // empty array = same as omitted
+    if (v.length > MAX_SUGGESTED_REPLIES) {
+        throw new ChannelError(`suggested_replies: max ${MAX_SUGGESTED_REPLIES} entries (got ${v.length})`, "invalid", 400);
+    }
+    const out = [];
+    for (const item of v) {
+        if (typeof item !== "string") {
+            throw new ChannelError("suggested_replies entries must all be strings", "invalid", 400);
+        }
+        const trimmed = item.trim();
+        if (!trimmed)
+            continue; // skip empty strings silently
+        if (trimmed.length > MAX_SUGGESTED_REPLY_LENGTH) {
+            throw new ChannelError(`suggested_replies entry too long (max ${MAX_SUGGESTED_REPLY_LENGTH} chars)`, "invalid", 400);
+        }
+        out.push(trimmed);
+    }
+    return out.length > 0 ? out : undefined;
+}
 const HISTORY_CAP = 100;
 // Default idle TTL; channels can override via session_ttl_seconds at creation (max 24h).
 const DEFAULT_ROSTER_IDLE_MS = 30 * 60 * 1000;
@@ -193,7 +234,7 @@ export class Channel {
     sessionExists(sessionId) {
         return this.callsignBySession.has(sessionId);
     }
-    send(sessionId, to, text) {
+    send(sessionId, to, text, priority, suggestedReplies) {
         this.ensureJoined(sessionId);
         const from = this.callsignBySession.get(sessionId);
         const dest = this.resolveAddress(to);
@@ -214,6 +255,13 @@ export class Channel {
         const now = Date.now();
         this.nextMsgId = Math.max(now, this.nextMsgId + 1);
         const msg = { id: this.nextMsgId, from, to: dest, text, at: now };
+        // Only attach `priority` when explicitly non-default — keeps the wire format
+        // backward-compatible for consumers that don't know about priorities.
+        if (priority && priority !== "default")
+            msg.priority = priority;
+        if (suggestedReplies && suggestedReplies.length > 0) {
+            msg.suggested_replies = suggestedReplies;
+        }
         this.messages.push(msg);
         if (this.messages.length > HISTORY_CAP)
             this.messages.shift();

package/dist/listen-here.js

@@ -35,16 +35,25 @@ options:
   --origin <url>      RogerRat origin (default: https://rogerrat.chat)
   --since <msg_id>    resume from a known message id (skips per-session cursor)
   --on-message <cmd>  shell command to run for each delivered message; env vars
-                      RR_MESSAGE, RR_FROM, RR_TO, RR_MSG_ID, RR_CHANNEL are set
+                      RR_MESSAGE, RR_FROM, RR_TO, RR_MSG_ID, RR_CHANNEL,
+                      RR_PRIORITY, RR_REPLIES are set
+                      (RR_PRIORITY = "default" when omitted;
+                       RR_REPLIES = tab-separated suggested replies, empty if none)
   --inbox <file>      append each message to this file (parent dir created if
                       missing). Format controlled by --format.
   --format <fmt>      output format for stdout and --inbox lines:
-                        jsonl (default) — one JSON object per line: {id,from,to,text,at}
-                        text            — one line per message: "[<from>] <text>"
-                                          newlines in text collapsed to spaces.
+                        jsonl (default) — one JSON object per line: {id,from,to,text,at,priority?,suggested_replies?}
+                        text            — one line per message:
+                                          "[<priority>] [<from>] <text>  → [r1] [r2]"
+                                          where [<priority>] and  → [r1] [r2] only appear
+                                          when set. Newlines in text collapsed to spaces.
                                           Use this when feeding a Monitor/tail consumer
                                           so each line is a human-readable notification
                                           with no parser needed in the watcher.
+  --min-priority <p>  drop messages below this priority (min|low|default|high|urgent).
+                      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.
   --quiet             suppress the default stdout dump of each message
 
 if neither --on-message nor --inbox is given, messages print to stdout (one
@@ -70,6 +79,13 @@ examples:
   rogerrat listen-here --channel ch1 --token t --session s \\
     --on-message 'claude -p "rogerrat msg from $RR_FROM: $RR_MESSAGE"'
 `;
+const PRIORITY_RANK = {
+    min: 0,
+    low: 1,
+    default: 2,
+    high: 3,
+    urgent: 4,
+};
 function parseFlags(argv) {
     let parsed;
     try {
@@ -84,6 +100,7 @@ function parseFlags(argv) {
                 "on-message": { type: "string" },
                 inbox: { type: "string" },
                 format: { type: "string" },
+                "min-priority": { type: "string" },
                 quiet: { type: "boolean" },
                 help: { type: "boolean", short: "h" },
             },
@@ -116,6 +133,14 @@ function parseFlags(argv) {
         }
         format = parsed.values.format;
     }
+    let minPriority;
+    if (parsed.values["min-priority"] !== undefined) {
+        const v = parsed.values["min-priority"];
+        if (v !== "min" && v !== "low" && v !== "default" && v !== "high" && v !== "urgent") {
+            return { error: "--min-priority must be one of min|low|default|high|urgent" };
+        }
+        minPriority = v;
+    }
     return {
         channel,
         token,
@@ -126,6 +151,7 @@ function parseFlags(argv) {
         inbox: parsed.values.inbox,
         format,
         quiet: parsed.values.quiet === true,
+        minPriority,
     };
 }
 /** Yield one SSE block (the lines between two blank-line separators) at a time.
@@ -169,11 +195,27 @@ function formatLine(args, msg) {
         // one notification per message. Use a single space; the JSONL format is
         // available for callers that need lossless body content.
         const flat = msg.text.replace(/\r?\n/g, " ").trim();
-        return `[${msg.from}] ${flat}`;
+        // Surface non-default priority as a leading tag so a Monitor tail of the
+        // inbox file can grep for urgency without parsing JSON. e.g. `[urgent] `
+        const prio = msg.priority && msg.priority !== "default" ? `[${msg.priority}] ` : "";
+        // Surface suggested_replies as a trailing  → [yes] [no]  hint so the
+        // agent sees the canned options without parsing JSON.
+        const replies = msg.suggested_replies && msg.suggested_replies.length > 0
+            ? "  → " + msg.suggested_replies.map((r) => `[${r}]`).join(" ")
+            : "";
+        return `${prio}[${msg.from}] ${flat}${replies}`;
     }
     return JSON.stringify(msg);
 }
 async function dispatch(args, msg) {
+    // --min-priority filter: drop messages below the threshold entirely (no
+    // inbox write, no hook spawn, no stdout). Missing priority counts as
+    // "default" (rank 2).
+    if (args.minPriority) {
+        const incomingRank = PRIORITY_RANK[msg.priority ?? "default"];
+        if (incomingRank < PRIORITY_RANK[args.minPriority])
+            return;
+    }
     const line = formatLine(args, msg);
     if (args.inbox) {
         const dir = dirname(args.inbox);
@@ -199,6 +241,10 @@ async function dispatch(args, msg) {
                 RR_TO: msg.to,
                 RR_MSG_ID: String(msg.id),
                 RR_CHANNEL: args.channel,
+                RR_PRIORITY: msg.priority ?? "default",
+                // Tab-separated so the hook can split on $'\t' cleanly even if a reply
+                // contains spaces or punctuation. Empty string when no suggestions.
+                RR_REPLIES: (msg.suggested_replies ?? []).join("\t"),
             },
         });
         child.on("error", (err) => {

package/dist/mcp.js

@@ -1,6 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { createAccount, createIdentity as accountCreateIdentity, verifyIdentity, verifySession } from "./accounts.js";
-import { getOrCreateChannel } from "./channel.js";
+import { getOrCreateChannel, isPriority, validateSuggestedReplies, } from "./channel.js";
 import { buildConnectInfo } from "./connect.js";
 import { createRemoteControl } from "./remote-control.js";
 import { getPreset } from "./presets.js";
@@ -62,12 +62,17 @@ const CHANNEL_TOOLS = [
     },
     {
         name: "send",
-        description: "Send a message to another agent on the channel by their callsign, or to 'all' to broadcast. Returns the message id.",
+        description: "Send a message to another agent on the channel by their callsign, or to 'all' to broadcast. Returns the message id. Optional `priority` (min|low|default|high|urgent) — receivers may wake immediately on high/urgent.",
         inputSchema: {
             type: "object",
             properties: {
                 to: { type: "string", description: "Recipient callsign, or 'all' for broadcast." },
                 message: { type: "string", description: "Message text. Max 8192 chars." },
+                priority: {
+                    type: "string",
+                    enum: ["min", "low", "default", "high", "urgent"],
+                    description: "Optional urgency. Default = 'default'. Receivers interpret.",
+                },
             },
             required: ["to", "message"],
         },
@@ -164,12 +169,23 @@ const UNIFIED_TOOLS = [
     },
     {
         name: "send",
-        description: "Send a message to another agent on the channel you joined, or to 'all' to broadcast. Requires a prior join() in this session. The 'to' field accepts: a callsign ('front'), an index ('#1' or '1') from roster(), or 'all'.",
+        description: "Send a message to another agent on the channel you joined, or to 'all' to broadcast. Requires a prior join() in this session. The 'to' field accepts: a callsign ('front'), an index ('#1' or '1') from roster(), or 'all'. Optional `priority` tags urgency (min|low|default|high|urgent). Optional `suggested_replies` hints up to 4 canned replies that human-in-the-loop UIs (like the /remote phone view) render as tappable chips — agent receivers can read them too and pick one.",
         inputSchema: {
             type: "object",
             properties: {
                 to: { type: "string", description: "Recipient: callsign, '#N' index, or 'all' for broadcast." },
                 message: { type: "string", description: "Message text. Max 8192 chars." },
+                priority: {
+                    type: "string",
+                    enum: ["min", "low", "default", "high", "urgent"],
+                    description: "Optional urgency tag. Default = 'default'. The server doesn't enforce semantics — receivers (listen-here, agents, webhooks) interpret. Use 'urgent' when the peer should wake right now; 'low' or 'min' for background updates the peer can batch.",
+                },
+                suggested_replies: {
+                    type: "array",
+                    items: { type: "string", maxLength: 64 },
+                    maxItems: 4,
+                    description: "Optional array of up to 4 short canned replies (max 64 chars each). Useful when asking the peer a multiple-choice-ish question, especially in human-in-the-loop channels. E.g. send 'shall I deploy?' with suggested_replies=['yes', 'no', 'show me the diff']. The 'click' from a receiver is just a normal /send with that text.",
+                },
             },
             required: ["to", "message"],
         },
@@ -316,11 +332,15 @@ async function callChannelTool(channel, sessionId, name, args) {
         case "send": {
             const to = String(args.to ?? "");
             const message = String(args.message ?? args.text ?? "");
-            const msg = channel.send(sessionId, to, message);
+            const priority = isPriority(args.priority) ? args.priority : undefined;
+            const suggestedReplies = validateSuggestedReplies(args.suggested_replies);
+            const msg = channel.send(sessionId, to, message, priority, suggestedReplies);
             statsRecordMessage();
             transcriptRecordMessage(channel.id, getChannelRetention(channel.id), msg);
             const queued = msg.to !== "all" && !channel.isCallsignOnline(msg.to);
-            return textContent(`sent #${msg.id} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}`);
+            const prio = msg.priority ? ` [${msg.priority}]` : "";
+            const replies = msg.suggested_replies ? ` (suggested: ${msg.suggested_replies.join(" | ")})` : "";
+            return textContent(`sent #${msg.id}${prio} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}${replies}`);
         }
         case "listen": {
             const seconds = typeof args.timeout_seconds === "number" ? args.timeout_seconds : 30;
@@ -598,11 +618,15 @@ async function callUnifiedTool(name, args, state, sessionId, publicOrigin, mode
         case "send": {
             const to = String(args.to ?? "");
             const message = String(args.message ?? args.text ?? "");
-            const msg = channel.send(sessionId, to, message);
+            const priority = isPriority(args.priority) ? args.priority : undefined;
+            const suggestedReplies = validateSuggestedReplies(args.suggested_replies);
+            const msg = channel.send(sessionId, to, message, priority, suggestedReplies);
             statsRecordMessage();
             transcriptRecordMessage(channel.id, getChannelRetention(channel.id), msg);
             const queued = msg.to !== "all" && !channel.isCallsignOnline(msg.to);
-            return textContent(`sent #${msg.id} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}`);
+            const prio = msg.priority ? ` [${msg.priority}]` : "";
+            const replies = msg.suggested_replies ? ` (suggested: ${msg.suggested_replies.join(" | ")})` : "";
+            return textContent(`sent #${msg.id}${prio} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}${replies}`);
         }
         case "listen": {
             const seconds = typeof args.timeout_seconds === "number" ? args.timeout_seconds : 30;

package/dist/remote-ui.js

@@ -113,6 +113,19 @@ export function remoteHtml(channelId) {
   }
   .msg.sys.error .bubble { color: var(--warn); }
   .msg .when { font-size: 10px; color: var(--dim); padding: 0 6px; }
+  .msg .chips {
+    display: flex; flex-wrap: wrap; gap: 6px;
+    margin-top: 4px; padding: 0 4px;
+  }
+  .msg .chip {
+    font-family: inherit; font-size: 13px;
+    padding: 6px 12px;
+    background: var(--paper); color: var(--ink);
+    border: 1px solid var(--warn); border-radius: 14px;
+    cursor: pointer; touch-action: manipulation;
+    transition: background 0.1s;
+  }
+  .msg .chip:active { background: var(--warn); color: white; }
 
   footer {
     flex-shrink: 0; background: var(--paper);
@@ -315,6 +328,29 @@ export function remoteHtml(channelId) {
     var when = document.createElement('div'); when.className = 'when';
     when.textContent = fmtTime(m.at);
     d.appendChild(who); d.appendChild(b); d.appendChild(when);
+    // Suggested replies → render as tappable chips below the bubble (only on
+    // incoming msgs; if I sent it, no point clicking my own suggestion).
+    if (!mine && m.suggested_replies && m.suggested_replies.length){
+      var chipBar = document.createElement('div');
+      chipBar.className = 'chips';
+      for (var i = 0; i < m.suggested_replies.length; i++){
+        var chip = document.createElement('button');
+        chip.type = 'button';
+        chip.className = 'chip';
+        chip.textContent = m.suggested_replies[i];
+        // Capture in closure-friendly way for older mobile JS engines
+        chip.addEventListener('click', (function(text, fromCallsign){
+          return function(){
+            elInput.value = text;
+            elTarget.value = fromCallsign; // reply to whoever sent the suggestion
+            autosize();
+            send();
+          };
+        })(m.suggested_replies[i], m.from));
+        chipBar.appendChild(chip);
+      }
+      d.appendChild(chipBar);
+    }
     elLog.appendChild(d);
     scrollDown();
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rogerrat",
-  "version": "1.18.1",
+  "version": "1.20.0",
   "mcpName": "io.github.opcastil11/rogerrat",
   "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 rogerrat.chat or self-hosted with `npx rogerrat`.",
   "keywords": [