@tritard/waterbrother 0.16.87 → 0.16.89

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tritard/waterbrother",
-  "version": "0.16.87",
+  "version": "0.16.89",
   "description": "Waterbrother: bring-your-own-model coding CLI with local tools, sessions, operator modes, and approval controls",
   "type": "module",
   "bin": {

package/src/gateway.js

@@ -276,7 +276,7 @@ function buildTelegramDmOnboardingMarkup({ cwd = "", project = null, peer = null
   const activeProject = project?.projectName || (cwd ? path.basename(cwd) : "");
   return [
     "<b>Waterbrother on Telegram</b>",
-    "You can talk to me here much like the TUI. Ask questions, make changes, refine work, or share a project into a room.",
+    "This chat is a first-class Waterbrother surface. Ask questions, make changes, refine work, or share the current project into a team room.",
     activeProject ? `current project: <code>${escapeTelegramHtml(activeProject)}</code>` : "",
     cwd ? `cwd: <code>${escapeTelegramHtml(cwd)}</code>` : "",
     peer?.sessionId ? `linked session: <code>${escapeTelegramHtml(peer.sessionId)}</code>` : "",
@@ -285,6 +285,7 @@ function buildTelegramDmOnboardingMarkup({ cwd = "", project = null, peer = null
     "• ask <code>what project are you in?</code>",
     "• say <code>make a test page in this project</code>",
     "• say <code>share this project in my Telegram room</code>",
+    "• ask <code>what can I do here?</code>",
     "",
     "<b>Need the full command list?</b>",
     "Use <code>/help</code>."
@@ -294,6 +295,8 @@ function buildTelegramDmOnboardingMarkup({ cwd = "", project = null, peer = null
 function buildTelegramRoomOnboardingMarkup({ project = null, actorName = "", executor = {} } = {}) {
   const participants = listProjectParticipants(project);
   const agents = listProjectAgents(project);
+  const reviewer = chooseReviewerAgent(project);
+  const blockingReview = getLatestBlockingReviewPolicy(project);
   return [
     "<b>Roundtable room</b>",
     actorName ? `${escapeTelegramHtml(actorName)} is talking to Waterbrother in the shared room for <code>${escapeTelegramHtml(project?.projectName || "this project")}</code>.` : "",
@@ -301,11 +304,14 @@ function buildTelegramRoomOnboardingMarkup({ project = null, actorName = "", exe
     `participants: <code>${escapeTelegramHtml(String(participants.length || (project?.members || []).length || 0))}</code>`,
     `agents: <code>${escapeTelegramHtml(String(agents.length || 0))}</code>`,
     executor?.provider && executor?.model ? `active runtime: <code>${escapeTelegramHtml(`${executor.provider}/${executor.model}`)}</code>` : "",
+    reviewer ? `reviewer: <code>${escapeTelegramHtml(reviewer.ownerName || reviewer.label || reviewer.ownerId || reviewer.id || "unknown")}</code>` : "",
+    `blocking review: <code>${escapeTelegramHtml(blockingReview ? "yes" : "no")}</code>`,
     "",
     "<b>What you can do here</b>",
     "• ask <code>what project is this chat bound to?</code>",
     "• ask <code>who is in the room?</code>",
     "• say <code>add Austin as editor</code>",
+    "• ask <code>which terminals are live?</code>",
     "• in execute mode, address Waterbrother directly to build or change code",
     "",
     "Use <code>/help</code> for the full command list."
@@ -340,14 +346,22 @@ function buildTelegramAgentAnnouncementMarkup(event = {}) {
   const label = String(meta.label || meta.agentId || "").trim() || "terminal";
   const runtime = meta.provider && meta.model ? `${meta.provider}/${meta.model}` : "";
   const title = meta.isNew ? "Roundtable terminal joined" : "Roundtable terminal updated";
+  const role = String(meta.role || "standby").trim() || "standby";
+  const roleGuidance = role === "executor"
+    ? "This terminal is the selected executor and can take room work when it is live."
+    : role === "reviewer"
+      ? "This terminal is the room reviewer and can be asked for a second opinion or blocking review."
+      : "This terminal is on standby until the room assigns it a more active role.";
   return [
     `<b>${escapeTelegramHtml(title)}</b>`,
     `owner: <code>${escapeTelegramHtml(ownerName)}</code>`,
     `terminal: <code>${escapeTelegramHtml(label)}</code>`,
-    `role: <code>${escapeTelegramHtml(String(meta.role || "standby"))}</code>`,
+    `role: <code>${escapeTelegramHtml(role)}</code>`,
     `surface: <code>${escapeTelegramHtml(String(meta.surface || "unknown"))}</code>`,
     runtime ? `runtime: <code>${escapeTelegramHtml(runtime)}</code>` : "",
-    meta.runtimeProfile ? `runtime profile: <code>${escapeTelegramHtml(String(meta.runtimeProfile || ""))}</code>` : ""
+    meta.runtimeProfile ? `runtime profile: <code>${escapeTelegramHtml(String(meta.runtimeProfile || ""))}</code>` : "",
+    roleGuidance,
+    "Examples: <code>which terminals are live?</code>, <code>have Austin's bot be reviewer</code>, <code>have Phillip's bot take execution</code>"
   ].filter(Boolean).join("\n");
 }
 
@@ -1606,6 +1620,8 @@ class TelegramGateway {
     const participants = listProjectParticipants(project);
     const agents = listProjectAgents(project);
     const executorAgent = agents.find((agent) => String(agent?.role || "").trim() === "executor") || null;
+    const reviewerAgent = chooseReviewerAgent(project);
+    const blockingReview = getLatestBlockingReviewPolicy(project);
     return [
       "<b>Roundtable room</b>",
       `${escapeTelegramHtml(actor.displayName || actor.userId)} is now in <code>${escapeTelegramHtml(project.projectName || "this project")}</code> as <code>observer</code>.`,
@@ -1615,9 +1631,11 @@ class TelegramGateway {
         : "active operator: <code>none</code>",
       `participants: <code>${escapeTelegramHtml(String(participants.length || (project.members || []).length))}</code>`,
       executorAgent ? `active terminal: <code>${escapeTelegramHtml(formatAgentLabel(executorAgent) || executorAgent.id)}</code>` : "",
+      reviewerAgent ? `reviewer: <code>${escapeTelegramHtml(reviewerAgent.ownerName || reviewerAgent.label || reviewerAgent.ownerId || reviewerAgent.id || "unknown")}</code>` : "",
+      `blocking review: <code>${escapeTelegramHtml(blockingReview ? "yes" : "no")}</code>`,
       "As observer, you can ask questions, discuss plans, and review work here.",
       "An owner can promote you to editor or owner conversationally.",
-      "Examples: <code>what project is this chat bound to?</code>, <code>who is in the room?</code>, <code>what can I do here?</code>"
+      "Examples: <code>what project is this chat bound to?</code>, <code>who is in the room?</code>, <code>which terminals are live?</code>, <code>what can I do here?</code>"
     ].filter(Boolean).join("\n");
   }