@kvsm/blether 0.2.1 → 0.2.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvsm/blether",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Agent-to-agent communication for distributed teams of human developers: the blether CLI, the bridge (an MCP server), and the Claude Code plugin.",
   "keywords": [
     "agents",
@@ -31,8 +31,8 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.31.0",
     "esbuild": "^0.28.2",
-    "@blether/bridge": "0.2.1",
-    "@blether/relay": "0.2.1"
+    "@blether/bridge": "0.2.2",
+    "@blether/relay": "0.2.2"
   },
   "publishConfig": {
     "access": "public"

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "blether",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "displayName": "Blether",
   "description": "Message your teammates' coding agents through Blether: the bridge, new-mail notices, and skills for when and how to reach out.",
   "author": {

package/plugin/dist/bridge.js

@@ -36960,7 +36960,7 @@ var DeviceGrant = external_exports.object({
 });
 
 // ../protocol/dist/version.js
-var BLETHER_VERSION = "0.2.1";
+var BLETHER_VERSION = "0.2.2";
 
 // ../protocol/dist/wire.js
 var AudienceHint = external_exports.object({
@@ -51693,7 +51693,7 @@ function connectedGuidance({ agent, team, inbox, pendingEscalations }) {
     "",
     "Now:",
     "1. Call read_mailbox.",
-    `2. Start a watch, so you hear about new mail between prompts: use the Monitor tool (load it with ToolSearch first if it's deferred) with the command: ${watch} \u2014 the description "Blether mail for ${agent}", and timeout_ms 1800000. Each line it prints means new mail: call read_mailbox. When the watch expires, start it again. If it stops by itself (this session disconnected, or another session took the agent over), don't.`
+    `2. Start a watch, so you hear about new mail between prompts: use the Monitor tool (load it with ToolSearch first if it's deferred) with the command: ${watch} \u2014 the description "Blether mail for ${agent}", and timeout_ms 1800000. Each line it prints means new mail: call read_mailbox. When the watch expires, start it again with --quiet-start added to the command, silently: don't mention the expiry or the restart to your developer. If it stops by itself (this session disconnected, or another session took the agent over), don't.`
   ].join("\n");
 }
 async function connect(env, log, into) {

package/plugin/dist/cli.js

@@ -27618,7 +27618,7 @@ function parseDeviceGrant(text) {
 }
 
 // ../protocol/dist/version.js
-var BLETHER_VERSION = "0.2.1";
+var BLETHER_VERSION = "0.2.2";
 
 // ../protocol/dist/wire.js
 var AudienceHint = external_exports.object({
@@ -28737,6 +28737,9 @@ function writeSessionFile(projectDir, contents, bletherHome) {
   return path;
 }
 
+// ../bridge/dist/watch.js
+import { readFileSync as readFileSync6, renameSync as renameSync2, writeFileSync as writeFileSync6 } from "node:fs";
+
 // ../bridge/dist/inbox-file.js
 import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5, renameSync, writeFileSync as writeFileSync5 } from "node:fs";
 var InboxState = external_exports.object({
@@ -28769,7 +28772,8 @@ function unreadSummary(state) {
 }
 
 // ../bridge/dist/watch.js
-function watchInbox(path, session, emit, end, { intervalMs = 1e3 } = {}) {
+function watchInbox(path, session, emit, end, { intervalMs = 1e3, quietStart = false } = {}) {
+  const seenPath = `${path}.watched`;
   let arrivals;
   let timer;
   let stopped = false;
@@ -28786,18 +28790,39 @@ function watchInbox(path, session, emit, end, { intervalMs = 1e3 } = {}) {
       end(state.session === session ? "disconnected" : "taken-over");
       return;
     }
+    const seen = arrivals ?? (quietStart ? readSeen(seenPath, session) : void 0);
     const summary = unreadSummary(state);
-    const arrived = arrivals !== void 0 && state.arrivals > arrivals;
-    if (summary && (arrivals === void 0 || arrived)) {
+    const arrived = seen !== void 0 && state.arrivals > seen;
+    if (summary && (seen === void 0 || arrived)) {
       emit(arrived && state.lastFrom ? `New Blether message from ${state.lastFrom}. ${summary}` : summary);
     }
-    arrivals = state.arrivals;
+    if (state.arrivals !== arrivals) {
+      arrivals = state.arrivals;
+      writeSeen(seenPath, session, arrivals);
+    }
   };
   check2();
   if (!stopped)
     timer = setInterval(check2, intervalMs);
   return stop;
 }
+function readSeen(path, session) {
+  try {
+    const seen = JSON.parse(readFileSync6(path, "utf8"));
+    return seen.session === session && Number.isInteger(seen.arrivals) ? seen.arrivals : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function writeSeen(path, session, arrivals) {
+  try {
+    const temp = `${path}.${process.pid}.tmp`;
+    writeFileSync6(temp, `${JSON.stringify({ session, arrivals })}
+`);
+    renameSync2(temp, path);
+  } catch {
+  }
+}
 
 // ../bridge/dist/claude-install.js
 import { spawn } from "node:child_process";
@@ -28888,9 +28913,10 @@ Commands:
   use <team> <agent name> [--dir <path>]
                                      Make sessions started in this project (or <path>) act as the agent
   claude install                     Install (or update) the Blether plugin in Claude Code
-  watch --inbox <path> --session <id>
+  watch --inbox <path> --session <id> [--quiet-start]
                                      Print a line whenever a connected session's agent gets mail
-                                     (the bridge gives its agent this command when it connects)
+                                     (the bridge gives its agent this command when it connects;
+                                     --quiet-start, for a restart, skips mail already reported)
   escalations                        List messages your agents are holding for your decision
   status                             One line for your Claude Code status line: escalations waiting
   policy                             Show your Approval Policy on this device
@@ -29543,13 +29569,17 @@ async function agentDelete(args, ctx) {
 async function watch(args, ctx) {
   const { values } = parseArgs({
     args,
-    options: { inbox: { type: "string" }, session: { type: "string" } }
+    options: {
+      inbox: { type: "string" },
+      session: { type: "string" },
+      "quiet-start": { type: "boolean" }
+    }
   });
   if (!values.inbox || !values.session) {
-    throw new CliError("Usage: blether watch --inbox <path> --session <id>");
+    throw new CliError("Usage: blether watch --inbox <path> --session <id> [--quiet-start]");
   }
   const ended = await new Promise((resolve3) => {
-    const stop = watchInbox(values.inbox, values.session, ctx.io.out, (why) => resolve3(why === "taken-over" ? "Blether watch stopped: another session took over this agent." : "Blether watch stopped: this session disconnected from Blether."));
+    const stop = watchInbox(values.inbox, values.session, ctx.io.out, (why) => resolve3(why === "taken-over" ? "Blether watch stopped: another session took over this agent." : "Blether watch stopped: this session disconnected from Blether."), { quietStart: values["quiet-start"] ?? false });
     for (const signal of ["SIGINT", "SIGTERM"]) {
       process.once(signal, () => {
         stop();