rogerrat 1.18.1 → 1.19.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, } 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,11 @@ 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);
+        }
         const channel = getOrCreateChannel(channelId);
         try {
             const isBand = getChannelIsBand(channelId);
@@ -755,12 +760,19 @@ 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);
             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 } : {}),
+            });
         }
         catch (e) {
             return handleChannelError(c, e);

package/dist/channel.js

@@ -1,3 +1,13 @@
+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";
+}
 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 +203,7 @@ export class Channel {
     sessionExists(sessionId) {
         return this.callsignBySession.has(sessionId);
     }
-    send(sessionId, to, text) {
+    send(sessionId, to, text, priority) {
         this.ensureJoined(sessionId);
         const from = this.callsignBySession.get(sessionId);
         const dest = this.resolveAddress(to);
@@ -214,6 +224,10 @@ 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;
         this.messages.push(msg);
         if (this.messages.length > HISTORY_CAP)
             this.messages.shift();

package/dist/listen-here.js

@@ -35,16 +35,23 @@ 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 are set (RR_PRIORITY = "default" when omitted)
   --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>"
+                        jsonl (default) — one JSON object per line: {id,from,to,text,at,priority?}
+                        text            — one line per message:
+                                          "[<priority>] [<from>] <text>" if priority set,
+                                          "[<from>] <text>" otherwise.
                                           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 +77,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 +98,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 +131,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 +149,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 +193,22 @@ 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}] ` : "";
+        return `${prio}[${msg.from}] ${flat}`;
     }
     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 +234,7 @@ async function dispatch(args, msg) {
                 RR_TO: msg.to,
                 RR_MSG_ID: String(msg.id),
                 RR_CHANNEL: args.channel,
+                RR_PRIORITY: msg.priority ?? "default",
             },
         });
         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 } 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,17 @@ 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) — receivers may wake immediately on high/urgent and filter min/low.",
         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.",
+                },
             },
             required: ["to", "message"],
         },
@@ -316,11 +326,13 @@ 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 msg = channel.send(sessionId, to, message, priority);
             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}]` : "";
+            return textContent(`sent #${msg.id}${prio} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}`);
         }
         case "listen": {
             const seconds = typeof args.timeout_seconds === "number" ? args.timeout_seconds : 30;
@@ -598,11 +610,13 @@ 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 msg = channel.send(sessionId, to, message, priority);
             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}]` : "";
+            return textContent(`sent #${msg.id}${prio} to ${msg.to}${queued ? " (queued — recipient is offline, will be delivered when they rejoin)" : ""}`);
         }
         case "listen": {
             const seconds = typeof args.timeout_seconds === "number" ? args.timeout_seconds : 30;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rogerrat",
-  "version": "1.18.1",
+  "version": "1.19.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": [