rogerrat 1.19.0 → 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, isPriority, 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";
@@ -748,6 +748,13 @@ export function createApp(opts) {
         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);
@@ -760,7 +767,7 @@ export function createApp(opts) {
                     retry_after_seconds: rate.retryAfter,
                 }, 429);
             }
-            const msg = channel.send(sessionId, to, message, priorityInput);
+            const msg = channel.send(sessionId, to, message, priorityInput, suggestedReplies);
             statsRecordMessage();
             transcriptRecordMessage(channelId, getChannelRetention(channelId), msg);
             fanoutWebhooks(channelId, msg);
@@ -772,6 +779,7 @@ export function createApp(opts) {
                 queued,
                 to: msg.to,
                 ...(msg.priority ? { priority: msg.priority } : {}),
+                ...(msg.suggested_replies ? { suggested_replies: msg.suggested_replies } : {}),
             });
         }
         catch (e) {

package/dist/channel.js

@@ -8,6 +8,37 @@ export const PRIORITY_RANK = {
 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;
@@ -203,7 +234,7 @@ export class Channel {
     sessionExists(sessionId) {
         return this.callsignBySession.has(sessionId);
     }
-    send(sessionId, to, text, priority) {
+    send(sessionId, to, text, priority, suggestedReplies) {
         this.ensureJoined(sessionId);
         const from = this.callsignBySession.get(sessionId);
         const dest = this.resolveAddress(to);
@@ -228,6 +259,9 @@ export class Channel {
         // 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

@@ -36,15 +36,17 @@ options:
   --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,
-                      RR_PRIORITY are set (RR_PRIORITY = "default" when omitted)
+                      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,priority?}
+                        jsonl (default) — one JSON object per line: {id,from,to,text,at,priority?,suggested_replies?}
                         text            — one line per message:
-                                          "[<priority>] [<from>] <text>" if priority set,
-                                          "[<from>] <text>" otherwise.
-                                          newlines in text collapsed to spaces.
+                                          "[<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.
@@ -196,7 +198,12 @@ function formatLine(args, msg) {
         // 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}`;
+        // 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);
 }
@@ -235,6 +242,9 @@ async function dispatch(args, msg) {
                 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, isPriority } 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";
@@ -169,7 +169,7 @@ 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'. Optional `priority` tags urgency (min|low|default|high|urgent) — receivers may wake immediately on high/urgent and filter min/low.",
+        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: {
@@ -180,6 +180,12 @@ const UNIFIED_TOOLS = [
                     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"],
         },
@@ -327,12 +333,14 @@ async function callChannelTool(channel, sessionId, name, args) {
             const to = String(args.to ?? "");
             const message = String(args.message ?? args.text ?? "");
             const priority = isPriority(args.priority) ? args.priority : undefined;
-            const msg = channel.send(sessionId, to, message, priority);
+            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);
             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)" : ""}`);
+            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;
@@ -611,12 +619,14 @@ async function callUnifiedTool(name, args, state, sessionId, publicOrigin, mode
             const to = String(args.to ?? "");
             const message = String(args.message ?? args.text ?? "");
             const priority = isPriority(args.priority) ? args.priority : undefined;
-            const msg = channel.send(sessionId, to, message, priority);
+            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);
             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)" : ""}`);
+            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.19.0",
+  "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": [