tandem-editor 0.17.0 → 0.18.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "tandem",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Edit and iterate on documents with any MCP-capable AI. Claude is the default and best-supported client today.",
   "author": {
     "name": "Tandem"
@@ -11,14 +11,14 @@
   "mcpServers": {
     "tandem": {
       "command": "npx",
-      "args": ["-y", "tandem-editor@0.17.0", "mcp-stdio"],
+      "args": ["-y", "tandem-editor@0.18.0", "mcp-stdio"],
       "env": {
         "TANDEM_URL": "http://127.0.0.1:3479"
       }
     },
     "tandem-channel": {
       "command": "npx",
-      "args": ["-y", "tandem-editor@0.17.0", "channel"],
+      "args": ["-y", "tandem-editor@0.18.0", "channel"],
       "env": {
         "TANDEM_URL": "http://127.0.0.1:3479"
       }
@@ -28,7 +28,7 @@
     "monitors": [
       {
         "name": "tandem-events",
-        "command": "node ${CLAUDE_PLUGIN_ROOT}/dist/monitor/index.js",
+        "command": "npx -y tandem-editor@0.18.0 monitor",
         "description": "Tandem real-time document events (annotations, chat, selections)"
       }
     ]

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to Tandem will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),\
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.18.0] - 2026-07-19
+
+### Added
+
+- **Real-time push now works for manually-launched Claude Code sessions, through the plugin monitor (#1201).** Until now, a Claude Code session received live document events (annotations, chat, selections) only if Tandem's own auto-launcher started it with a special flag — a session you started yourself by hand got nothing and had to poll for changes. The Tandem plugin now ships a *monitor* that Claude Code 2.1.212+ activates at launch and that pushes those events with no flag required. Install it once — `claude plugin marketplace add bloknayrb/tandem`, then `claude plugin install tandem@tandem-editor` — and every `claude` you start afterward wakes on document changes. (This is a Claude Code plugin capability; the desktop app and Cowork keep using their existing transports and are unchanged by this release.)
+
+  One caveat: if you install the plugin *and* also launch with `--dangerously-load-development-channels server:tandem-channel`, both transports deliver each event and you'll see it twice. For a hand-launched session, install the plugin and drop the flag.
+
+### Fixed
+
+- **The server no longer crashes when an event subscriber's connection drops abruptly (#1202).** The `/api/events` push stream sends a periodic keepalive; if the client socket had already died, that write threw from inside a timer where nothing caught it, and the unhandled error took the whole server process down. The keepalive and event writes are now guarded and clean up the dead subscriber instead of crashing.
+
+### Internal
+
+- **The `tandem_checkInbox` tool description now explains why to poll steadily (#1200).** A session can't tell from the server whether real-time push is actually reaching it, so the guidance to poll at a steady cadence — plus the note that polling dedups against already-pushed items, making it cheap and safe — now lives in the tool description itself. That reaches every MCP client, not only the ones that installed the Tandem skill.
+
 ## [0.17.0] - 2026-07-17
 
 ### Changed
@@ -19,8 +35,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Keyboard activation works again in the Cowork "admin declined" dialog (#1186).** The dialog sits inside its backdrop, whose unguarded keydown handler called `preventDefault()` on Enter/Space as they bubbled up from the dialog's own buttons and the Learn-more link — so every control in that dialog was dead to the keyboard, and pressing a key dismissed the dialog out from under you. The backdrop now only acts on events that originate on itself.
 
-- **The text selection popup no longer paints a stray frosted-glass rectangle behind itself (#1189).** Selecting text in the desktop app drew a blurred rectangle spanning the popup's whole bounding box — including the empty space beside the narrower Annotate row, where no chrome is actually visible. The shared `.tandem-floating-pill` recipe carried a `backdrop-filter: blur(8px)` that every other pill hides behind its opaque background; the selection popup's shell is deliberately transparent (the two-capsule design), so there the blur had nothing to hide behind. The blur is now gone from the recipe, where it was invisible dead weight on every other surface anyway. The popup's capsules keep their background, border, shadow, and the gap the editor shows through — unchanged.
-
 - **The text selection popup no longer paints a stray frosted-glass rectangle behind itself (#1189).** Selecting text in the desktop app drew a blurred rectangle spanning the popup's whole bounding box — including the empty space beside the narrower Annotate row, where no chrome is actually visible. The shared `.tandem-floating-pill` recipe carried a `backdrop-filter: blur(8px)` that every other pill hides behind its opaque background; the selection popup's shell is deliberately transparent (the two-capsule design), so there the blur had nothing to hide behind. The blur is now gone from the recipe, where it was invisible dead weight on every other surface anyway. The popup's capsules keep their background, border, shadow, and the gap the editor shows through — unchanged.
 
   Only production builds were affected, which is why it survived since the two-capsule popup landed in #798: that redesign shipped with a `backdrop-filter: none` reset on the shell meant to cancel the recipe's blur, and the reset never survived minification. lightningcss (Vite's default CSS minifier) collapses a `backdrop-filter` + `-webkit-backdrop-filter` pair into the `-webkit-` form alone, and Chromium does not honour the prefixed form, so the reset silently evaporated in the packaged app while working fine in dev. That minifier hazard is tracked separately in #1188; a regression test now forbids both the blur on the recipe and the prefixed-pair pattern that hid it.

package/dist/cli/index.js

@@ -290,7 +290,7 @@ function resolveChannelDist(env = process.env, exists = existsSync) {
   return resolve2(PACKAGE_ROOT, "dist/channel/index.js");
 }
 function resolveCliVersion() {
-  if (true) return "0.17.0";
+  if (true) return "0.18.0";
   if (typeof __APP_VERSION__ !== "undefined") return __APP_VERSION__;
   for (const rel of ["../../package.json", "../../../package.json"]) {
     try {
@@ -1238,7 +1238,7 @@ function printPushStatus() {
 
 ` : "";
   console.error(
-    "\n\x1B[1mReal-time push notifications:\x1B[0m\n" + (channelRegistered ? "  \x1B[32mEnabled\x1B[0m \u2014 the channel shim is registered; Claude Code receives events in real time.\n  Relaunch any Claude Code session you started manually so it picks up the new server.\n\n" : "  \x1B[33mUnavailable\x1B[0m \u2014 dist/channel/index.js not found; Claude Code will poll via tandem_checkInbox.\n  Run 'npm run build' and re-run setup to enable push.\n\n") + "  A Tandem plugin is also published (skill + MCP; the real-time monitor it carries is\n  forward-looking, pending Claude Code support):\n\n    claude plugin marketplace add bloknayrb/tandem\n    claude plugin install tandem@tandem-editor\n\n" + devInstructions
+    "\n\x1B[1mReal-time push notifications:\x1B[0m\n" + (channelRegistered ? "  \x1B[32mEnabled\x1B[0m \u2014 the channel shim is registered; Claude Code receives events in real time.\n  Relaunch any Claude Code session you started manually so it picks up the new server.\n\n" : "  \x1B[33mUnavailable\x1B[0m \u2014 dist/channel/index.js not found; Claude Code will poll via tandem_checkInbox.\n  Run 'npm run build' and re-run setup to enable push.\n\n") + "  A Tandem plugin is also published (skill + MCP + a real-time monitor that\n  activates on Claude Code 2.1.212+ and needs no --dangerously-... flag):\n\n    claude plugin marketplace add bloknayrb/tandem\n    claude plugin install tandem@tandem-editor\n\n" + devInstructions
   );
 }
 var init_setup = __esm({
@@ -1822,7 +1822,7 @@ var init_types2 = __esm({
 
 // src/shared/types.ts
 import { z } from "zod";
-var AnnotationTypeSchema, AnnotationStatusSchema, HighlightColorSchema, SeveritySchema, TandemModeSchema, AuthorSchema, ReplyAuthorSchema, AnnotationActionSchema, ExportFormatSchema, DocumentFormatSchema, ToolErrorCodeSchema, ChannelErrorCodeSchema, CHANNEL_CONNECT_FAILED;
+var AnnotationTypeSchema, AnnotationStatusSchema, HighlightColorSchema, SeveritySchema, TandemModeSchema, AuthorSchema, ReplyAuthorSchema, AnnotationActionSchema, ExportFormatSchema, DocumentFormatSchema, ToolErrorCodeSchema, ChannelErrorCodeSchema, CHANNEL_CONNECT_FAILED, MONITOR_CONNECT_FAILED;
 var init_types3 = __esm({
   "src/shared/types.ts"() {
     "use strict";
@@ -1852,6 +1852,7 @@ var init_types3 = __esm({
     ]);
     ChannelErrorCodeSchema = z.enum(["CHANNEL_CONNECT_FAILED", "MONITOR_CONNECT_FAILED"]);
     CHANNEL_CONNECT_FAILED = "CHANNEL_CONNECT_FAILED";
+    MONITOR_CONNECT_FAILED = "MONITOR_CONNECT_FAILED";
   }
 });
 
@@ -2155,6 +2156,63 @@ function refreshMode(tandemUrl, logPrefix) {
     cachedModeFailedAt = Date.now();
   });
 }
+async function flushFinalAwareness(tandemUrl, logPrefix = "[Tandem]") {
+  if (shutdownTimers.awarenessTimer) clearTimeout(shutdownTimers.awarenessTimer);
+  if (shutdownTimers.clearAwarenessTimer) clearTimeout(shutdownTimers.clearAwarenessTimer);
+  if (outstandingAwareness.size > 0) {
+    await Promise.allSettled(outstandingAwareness);
+  }
+  if (shutdownTimers.lastDocumentId === null) return true;
+  try {
+    const res = await fetchWithTimeout(
+      `${tandemUrl}${API_CHANNEL_AWARENESS}`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          documentId: shutdownTimers.lastDocumentId,
+          status: "idle",
+          active: false
+        })
+      },
+      CHANNEL_AWARENESS_FETCH_TIMEOUT_MS
+    );
+    if (!res.ok) {
+      console.error(`${logPrefix} Shutdown awareness clear returned ${res.status}`);
+      return false;
+    }
+    return true;
+  } catch (err) {
+    console.error(
+      `${logPrefix} Shutdown awareness clear failed:`,
+      describeFetchError(
+        err,
+        `${API_CHANNEL_AWARENESS} shutdown`,
+        CHANNEL_AWARENESS_FETCH_TIMEOUT_MS
+      )
+    );
+    return false;
+  }
+}
+function _resetSseConsumerStateForTests() {
+  cachedMode = TANDEM_MODE_DEFAULT;
+  cachedModeAt = 0;
+  cachedModeFailedAt = 0;
+  _modeRefreshInFlight = null;
+  shutdownTimers.awarenessTimer = null;
+  shutdownTimers.clearAwarenessTimer = null;
+  shutdownTimers.lastDocumentId = null;
+  outstandingAwareness.clear();
+}
+function _setLastDocumentIdForTests(id) {
+  shutdownTimers.lastDocumentId = id;
+}
+function _getLastDocumentIdForTests() {
+  return shutdownTimers.lastDocumentId;
+}
+function _addOutstandingAwarenessForTests(p) {
+  trackAwareness(p);
+}
 var AWARENESS_DEBOUNCE_MS, AWARENESS_CLEAR_MS, MODE_CACHE_TTL_MS, STABLE_CONNECTION_MS, RETRY_MAX_DELAY_MS, shutdownTimers, outstandingAwareness, cachedMode, cachedModeAt, cachedModeFailedAt, _modeRefreshInFlight;
 var init_sse_consumer = __esm({
   "src/shared/sse-consumer.ts"() {
@@ -2417,6 +2475,114 @@ var init_channel = __esm({
   }
 });
 
+// src/monitor/run.ts
+var run_exports = {};
+__export(run_exports, {
+  _addOutstandingAwarenessForTests: () => _addOutstandingAwarenessForTests2,
+  _getLastDocumentIdForTests: () => _getLastDocumentIdForTests2,
+  _monitorTestExports: () => _monitorTestExports,
+  _resetMonitorStateForTests: () => _resetMonitorStateForTests,
+  _setLastDocumentIdForTests: () => _setLastDocumentIdForTests2,
+  connectAndStream: () => connectAndStream,
+  getCachedMode: () => getCachedMode2,
+  getModeSync: () => getModeSync2,
+  main: () => main,
+  shutdownMonitor: () => shutdownMonitor
+});
+function buildOptions() {
+  return {
+    tandemUrl: TANDEM_URL,
+    logPrefix: LOG_PREFIX,
+    errorCode: MONITOR_CONNECT_FAILED,
+    onEvent: (event) => {
+      const content = formatEventContent(event).replace(/\n/g, " ");
+      process.stdout.write(content + "\n");
+    },
+    onExhaustion: () => {
+      process.stdout.write(
+        "Tandem monitor disconnected \u2014 restart Tandem to restore real-time events\n"
+      );
+    }
+  };
+}
+async function main() {
+  installShutdownHandlers();
+  installStdoutErrorHandler();
+  console.error(`${LOG_PREFIX} Tandem monitor starting (server: ${TANDEM_URL})`);
+  await getCachedMode2().catch(() => {
+  });
+  await runEventConsumer(buildOptions());
+}
+async function connectAndStream(lastEventId, onEventId, onStable = () => {
+}) {
+  return connectAndStreamOnce(buildOptions(), lastEventId, { onEventId, onStable });
+}
+async function shutdownMonitor(signal) {
+  console.error(`${LOG_PREFIX} Received ${signal}, clearing awareness and exiting`);
+  const ok = await flushFinalAwareness(TANDEM_URL, LOG_PREFIX);
+  process.exit(ok ? 0 : 1);
+}
+function _setLastDocumentIdForTests2(id) {
+  _setLastDocumentIdForTests(id);
+}
+function _getLastDocumentIdForTests2() {
+  return _getLastDocumentIdForTests();
+}
+function _addOutstandingAwarenessForTests2(p) {
+  _addOutstandingAwarenessForTests(p);
+}
+function installShutdownHandlers() {
+  if (IS_VITEST) return;
+  const handler = (signal) => {
+    shutdownMonitor(signal).catch((err) => {
+      console.error(`${LOG_PREFIX} Shutdown handler failed:`, err);
+      process.exit(1);
+    });
+  };
+  process.on("SIGINT", () => handler("SIGINT"));
+  process.on("SIGTERM", () => handler("SIGTERM"));
+}
+function onStdoutError(err) {
+  console.error(`${LOG_PREFIX} stdout error (plugin-host pipe likely closed):`, err);
+  process.exit(1);
+}
+function installStdoutErrorHandler() {
+  if (IS_VITEST) return;
+  process.stdout.on("error", onStdoutError);
+}
+async function getCachedMode2() {
+  return getCachedMode(TANDEM_URL, LOG_PREFIX);
+}
+function getModeSync2() {
+  return getModeSync();
+}
+function _resetMonitorStateForTests() {
+  _resetSseConsumerStateForTests();
+  process.removeAllListeners("SIGINT");
+  process.removeAllListeners("SIGTERM");
+}
+var IS_VITEST, TANDEM_URL, LOG_PREFIX, _monitorTestExports;
+var init_run2 = __esm({
+  "src/monitor/run.ts"() {
+    "use strict";
+    init_cli_runtime();
+    init_types();
+    init_sse_consumer();
+    init_types3();
+    IS_VITEST = process.env.VITEST === "true";
+    if (!IS_VITEST) {
+      console.log = console.error;
+      console.warn = console.error;
+      console.info = console.error;
+    }
+    TANDEM_URL = resolveTandemUrl();
+    LOG_PREFIX = "[Monitor]";
+    _monitorTestExports = {
+      onStdoutError
+    };
+  }
+});
+
 // src/server/annotations/lockfile.ts
 function parseLockfile(raw) {
   const trimmed = raw.trim();
@@ -3125,7 +3291,7 @@ function evaluateStaleGlobal(bundled, globalVersion) {
   };
 }
 async function checkStaleGlobal(r) {
-  const bundled = true ? "0.17.0" : null;
+  const bundled = true ? "0.18.0" : null;
   if (!bundled) return;
   let globalVersion;
   try {
@@ -4218,7 +4384,7 @@ process.once("unhandledRejection", (reason) => {
 `);
   process.exit(1);
 });
-var version = true ? "0.17.0" : "0.0.0-dev";
+var version = true ? "0.18.0" : "0.0.0-dev";
 var args = process.argv.slice(2);
 if (args.includes("--help") || args.includes("-h")) {
   console.log(`tandem v${version}
@@ -4246,6 +4412,10 @@ Usage:
                                     tandem server running on the host)
   tandem channel                    Run the Tandem channel shim (stdio MCP)
                                     (used by the plugin's tandem-channel entry)
+  tandem monitor                    Run the Tandem plugin monitor: stream event
+                                    lines to stdout for Claude Code to surface as
+                                    notifications (used by the plugin's
+                                    experimental.monitors entry; needs no flag)
   tandem --version
   tandem --help
 `);
@@ -4255,7 +4425,7 @@ if (args.includes("--version") || args.includes("-v")) {
   console.log(version);
   process.exit(0);
 }
-var isStdioMode = args[0] === "mcp-stdio" || args[0] === "channel";
+var isStdioMode = args[0] === "mcp-stdio" || args[0] === "channel" || args[0] === "monitor";
 if (!isStdioMode) {
   const { default: updateNotifier } = await import("update-notifier");
   updateNotifier({ pkg: { name: "tandem-editor", version } }).notify();
@@ -4291,6 +4461,9 @@ try {
   } else if (args[0] === "channel") {
     const { runChannelCli: runChannelCli2 } = await Promise.resolve().then(() => (init_channel(), channel_exports));
     await runChannelCli2();
+  } else if (args[0] === "monitor") {
+    const { main: main2 } = await Promise.resolve().then(() => (init_run2(), run_exports));
+    await main2();
   } else if (args[0] === "doctor") {
     const { runDoctorCli: runDoctorCli2 } = await Promise.resolve().then(() => (init_doctor(), doctor_exports));
     const exitCode = await runDoctorCli2({ json: args.includes("--json") });