tandem-editor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bryan Kolb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+<p align="center">
+  <img src="docs/assets/banner.png" alt="Tandem — Collaborative AI-Human Document Editor" width="800">
+</p>
+
+A collaborative document editor where Claude and a human work on the same document in real-time -- editing, highlighting, commenting, and annotating together.
+
+![Tandem editor showing a document with annotations, side panel, and Claude's presence](docs/screenshots/01-editor-overview.png)
+
+```mermaid
+graph LR
+    Browser["Browser<br/>Tiptap Editor"] <-->|WebSocket| Server["Tandem Server<br/>Node.js"]
+    Server <-->|MCP HTTP| Claude["Claude Code"]
+    Server <-->|File I/O| Files[".md .txt .docx"]
+    Server -->|SSE events| Shim["Channel Shim"]
+    Shim -->|push notifications| Claude
+```
+
+## Getting Started
+
+### Prerequisites
+
+- **Node.js 22+** ([download](https://nodejs.org))
+- **Claude Code** (`irm https://claude.ai/install.ps1 | iex`)
+
+### Option A: Global Install (recommended)
+
+```bash
+npm install -g tandem-editor
+tandem setup     # registers MCP tools with Claude Code / Claude Desktop
+tandem           # starts server + opens browser
+```
+
+`tandem setup` auto-detects Claude Code and Claude Desktop and writes MCP configuration so tools work from any directory. Re-run after upgrading (`npm update -g tandem-editor`).
+
+### Option B: Development Setup
+
+```bash
+git clone https://github.com/bloknayrb/tandem.git
+cd tandem
+npm install
+npm run dev:standalone   # starts server (:3478/:3479) + browser client (:5173)
+```
+
+Open http://localhost:5173 -- you'll see `sample/welcome.md` loaded automatically on first run. The `.mcp.json` in the repo configures Claude Code automatically when run from this directory.
+
+### Connect Claude Code
+
+Start Claude Code and try:
+
+```
+"Review the welcome document with me"
+```
+
+Claude calls `tandem_open`, the document appears in the browser, and annotations start flowing.
+
+### Verify (if something seems wrong)
+
+```bash
+npm run doctor    # from the repo, or after global install
+```
+
+This checks Node.js version, MCP configuration (both `.mcp.json` and `~/.claude/mcp_settings.json`), server health, and port status with actionable fix suggestions. You can also check the raw health endpoint:
+
+```bash
+curl http://localhost:3479/health
+# → {"status":"ok","version":"0.1.0","transport":"http","hasSession":false}
+```
+
+`hasSession` becomes `true` once Claude Code connects.
+
+## MCP Configuration
+
+Tandem uses two MCP connections: **HTTP** for document tools (27 tools including annotation editing), and a **channel shim** for real-time push notifications.
+
+**Global install** (`tandem setup`): Automatically writes both entries to `~/.claude/mcp_settings.json` (Claude Code) and/or `claude_desktop_config.json` (Claude Desktop) with absolute paths. No manual configuration needed.
+
+**Development setup** (`.mcp.json`): The repo includes a `.mcp.json` that configures both entries automatically when Claude Code runs from the repo directory:
+
+```json
+{
+  "mcpServers": {
+    "tandem": {
+      "type": "http",
+      "url": "http://localhost:3479/mcp"
+    },
+    "tandem-channel": {
+      "command": "npx",
+      "args": ["tsx", "src/channel/index.ts"],
+      "env": { "TANDEM_URL": "http://localhost:3479" }
+    }
+  }
+}
+```
+
+Both entries are cross-platform -- no platform-specific configuration needed.
+
+The channel shim is optional -- without it, Claude relies on polling via `tandem_checkInbox` instead of receiving real-time push events.
+
+**Important:** The server must be running before Claude Code connects.
+
+## Environment Variables
+
+All optional -- defaults work out of the box.
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `TANDEM_PORT` | `3478` | Hocuspocus WebSocket port |
+| `TANDEM_MCP_PORT` | `3479` | MCP HTTP + REST API port |
+| `TANDEM_URL` | `http://localhost:3479` | Channel shim server URL |
+| `TANDEM_TRANSPORT` | `http` | Transport mode (`http` or `stdio`) |
+| `TANDEM_NO_SAMPLE` | unset | Set to `1` to skip auto-opening `sample/welcome.md` |
+
+See `.env.example` for a copy-paste template.
+
+## Troubleshooting
+
+Run `npm run doctor` for a quick diagnostic of your setup. It checks Node.js version, `.mcp.json` config, server health, and port status.
+
+**Claude Code says "MCP failed to connect"**
+Start the server first (`tandem` for global install, or `npm run dev:standalone` for dev setup), then open Claude Code. The server must be running before Claude Code probes the MCP URL. If you restart the server, run `/mcp` in Claude Code to reconnect.
+
+**Port already in use**
+Tandem kills stale processes on :3478/:3479 at startup. If another app uses those ports, set `TANDEM_PORT` / `TANDEM_MCP_PORT` to different values and update `TANDEM_URL` to match.
+
+**Channel shim fails to start**
+The `tandem-channel` entry spawns a subprocess. For global installs, `tandem setup` writes absolute paths to the bundled `dist/channel/index.js` -- re-run `tandem setup` after upgrading. For dev setup, if you see `MODULE_NOT_FOUND` with a production config (`node dist/channel/index.js`), run `npm run build`. The default dev config uses `npx tsx` and doesn't require a build step.
+
+**Browser shows "Cannot reach the Tandem server"**
+The browser connects to the server via WebSocket. For global installs, run `tandem` to start the server. For dev setup, use `npm run dev:standalone` (or `npm run dev:server`). The message appears after 3 seconds of failed connection.
+
+**Empty browser with no document**
+On first run, `sample/welcome.md` auto-opens. If you've cleared sessions or deleted the sample file, click the **+** button in the tab bar or drop a file onto the editor.
+
+## Features
+
+### Annotations
+
+Claude adds highlights, comments, suggestions, and flags directly in the document. Each annotation type has distinct styling -- colored backgrounds for highlights, dashed underlines for comments, wavy underlines for suggestions -- so you can scan at a glance.
+
+![Side panel showing annotation cards with text excerpts, accept/dismiss buttons, filtering, and bulk actions](docs/screenshots/03-side-panel.png)
+
+The side panel lists all annotations with filtering by type, author, and status. Each card shows a preview of the annotated text. Bulk accept/dismiss buttons appear when multiple annotations are pending. Annotations can be edited after creation via the pencil button -- typos in comments or suggestions no longer require deleting and recreating.
+
+### Chat Sidebar
+
+![Chat sidebar showing Claude review messages, typing indicator, and panel toggle tabs](docs/screenshots/02-chat-sidebar.png)
+
+The right sidebar toggles between **Annotations** and **Chat** views. In chat mode, send freeform messages to Claude alongside annotation review. If you have text selected when you hit Send, it is attached as a clickable anchor -- clicking it later scrolls the editor back to that passage. Claude's responses are rendered as Markdown. An unread badge on the Chat tab appears when Claude has replied while you were in the Annotations view.
+
+### Toolbar
+
+![Toolbar with annotation buttons, multiple document tabs with format indicators, and side panel header](docs/screenshots/04-toolbar-actions.png)
+
+Select text in the editor to activate the toolbar buttons: Highlight (with color picker), Comment, Suggest, Flag, and Ask Claude. The tab bar shows open documents with format indicators (M for Markdown, W for Word, T for Text). Tabs scroll horizontally when they overflow, and can be reordered via drag-and-drop or Alt+Left/Right.
+
+### Keyboard Review Mode
+
+![Review mode with dimmed editor text and active annotation highlighted](docs/screenshots/05-review-mode.png)
+
+Press **Ctrl+Shift+R** or click "Review in sequence" to enter review mode. The editor dims non-annotated text so annotations stand out. Navigate with **Tab/Shift+Tab**, accept with **Y**, dismiss with **N**, or examine with **E**. The side panel tracks your position (e.g. "Reviewing 1 / 7").
+
+### Claude's Presence
+
+![Status bar showing connection state, document count, interruption mode, and Claude's current activity](docs/screenshots/06-claude-presence.png)
+
+The status bar shows real-time connection state with reconnect attempt count and elapsed time, open document count, and Claude's current activity. A prominent banner appears after 30 seconds of continuous disconnect with actionable guidance. Claude's focus paragraph gets a subtle blue highlight in the editor. Interruption modes (All / Urgent / Paused) control which annotations surface immediately vs. get held for later.
+
+### Toast Notifications
+
+![Toast notification showing an annotation failure message with dismiss button](docs/screenshots/07-toast-notification.png)
+
+Annotation failures and save errors surface as dismissible toast notifications. Toasts auto-dismiss by severity (errors linger longest) and deduplicate with a count badge when the same message repeats.
+
+### Onboarding Tutorial
+
+![Onboarding tutorial card showing step 1 of 3 with progress dots and next button](docs/screenshots/08-onboarding-tutorial.png)
+
+On first launch, a 3-step guided walkthrough appears over the welcome document. Pre-placed annotations let you practice reviewing, asking Claude a question, and editing -- then the tutorial dismisses itself. Progress persists in localStorage so it only shows once.
+
+### More
+
+- **Multi-document tabs** -- open `.md`, `.txt`, `.docx` files side by side, each in its own Y.Doc room
+- **Browser file open** -- click "+" in the tab bar or drag-and-drop a file onto the editor (no Claude needed); recent files remembered
+- **Markdown round-trip** -- lossless MDAST-based conversion preserves formatting through load/save cycles
+- **.docx review-only mode** -- open Word documents for annotation; a banner makes clear edits aren't saved back to the original
+- **Session persistence** -- Y.Doc state and annotations survive server restarts
+- **Real-time channel push** -- annotation accepts/dismisses, chat messages, and document switches push to Claude instantly via the Channels API (no polling)
+- **User→Claude inbox** -- highlights, comments, and questions you add are surfaced to Claude via push events or `tandem_checkInbox` fallback
+- **Unsaved-changes indicator** -- dot on the tab title when a document has pending edits
+- **Configurable display name** -- set your name so Claude knows who's reviewing
+- **Annotation text preview** -- each card in the side panel shows an excerpt of the annotated text
+- **Keyboard shortcuts reference** -- press `?` to open the in-app shortcut reference
+- **E2E tested** -- Playwright tests cover the annotation lifecycle end-to-end
+- **Atomic file saves** -- write to temp, then rename, preventing partial writes
+
+## CLI Commands
+
+| Command | What it does |
+|---------|-------------|
+| `tandem` | Start server and open browser (global install) |
+| `tandem setup` | Register MCP tools with Claude Code / Claude Desktop |
+| `tandem setup --force` | Register to default paths regardless of auto-detection |
+| `tandem --version` | Show installed version |
+| `tandem --help` | Show usage |
+
+## Development Scripts
+
+| Command | What it does |
+|---------|-------------|
+| `npm run dev:standalone` | **Recommended** -- both frontend + backend (via concurrently) |
+| `npm run dev:server` | Backend only: Hocuspocus (:3478) + MCP HTTP (:3479) |
+| `npm run dev:client` | Frontend only: Vite dev server (:5173) |
+| `npm run build` | Production build (`dist/server/` + `dist/channel/` + `dist/cli/` + `dist/client/`) |
+| `npm test` | Run vitest (unit tests) |
+| `npm run test:e2e` | Run Playwright E2E tests |
+| `npm run test:e2e:ui` | Playwright UI mode |
+
+## Documentation
+
+- [MCP Tool Reference](docs/mcp-tools.md) -- 27 MCP tools + channel API endpoints
+- [Architecture](docs/architecture.md) -- System design, data flows, coordinate systems, channel push
+- [Workflows](docs/workflows.md) -- Real-world usage patterns
+- [Roadmap](docs/roadmap.md) -- Phase 2+ roadmap, known issues, future extensions
+- [Design Decisions](docs/decisions.md) -- ADR-001 through ADR-021
+- [Lessons Learned](docs/lessons-learned.md) -- 31 implementation lessons
+
+## Tech Stack
+
+**Frontend:** React 19, Tiptap, Vite, TypeScript
+**Backend:** Node.js, Hocuspocus (Yjs WebSocket), MCP SDK (Streamable HTTP transport), Express
+**Collaboration:** Yjs (CRDT), @hocuspocus/provider, y-prosemirror
+**File I/O:** mammoth.js (.docx), unified/remark (.md)

package/dist/channel/index.js

@@ -0,0 +1,383 @@
+#!/usr/bin/env node
+
+// src/channel/index.ts
+import { createConnection } from "net";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+
+// src/shared/constants.ts
+var DEFAULT_MCP_PORT = 3479;
+var MAX_FILE_SIZE = 50 * 1024 * 1024;
+var MAX_WS_PAYLOAD = 10 * 1024 * 1024;
+var IDLE_TIMEOUT = 30 * 60 * 1e3;
+var SESSION_MAX_AGE = 30 * 24 * 60 * 60 * 1e3;
+var CHANNEL_MAX_RETRIES = 5;
+var CHANNEL_RETRY_DELAY_MS = 2e3;
+
+// src/server/events/types.ts
+var VALID_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "annotation:created",
+  "annotation:accepted",
+  "annotation:dismissed",
+  "chat:message",
+  "selection:changed",
+  "document:opened",
+  "document:closed",
+  "document:switched"
+]);
+function parseTandemEvent(raw) {
+  if (typeof raw !== "object" || raw === null || !("id" in raw) || typeof raw.id !== "string" || !("type" in raw) || !VALID_EVENT_TYPES.has(raw.type) || !("timestamp" in raw) || typeof raw.timestamp !== "number" || !("payload" in raw) || typeof raw.payload !== "object") {
+    return null;
+  }
+  return raw;
+}
+function formatEventContent(event) {
+  const doc = event.documentId ? ` [doc: ${event.documentId}]` : "";
+  switch (event.type) {
+    case "annotation:created": {
+      const { annotationType, content, textSnippet } = event.payload;
+      const snippet = textSnippet ? ` on "${textSnippet}"` : "";
+      return `User created ${annotationType}${snippet}: ${content || "(no content)"}${doc}`;
+    }
+    case "annotation:accepted": {
+      const { annotationId, textSnippet } = event.payload;
+      return `User accepted annotation ${annotationId}${textSnippet ? ` ("${textSnippet}")` : ""}${doc}`;
+    }
+    case "annotation:dismissed": {
+      const { annotationId, textSnippet } = event.payload;
+      return `User dismissed annotation ${annotationId}${textSnippet ? ` ("${textSnippet}")` : ""}${doc}`;
+    }
+    case "chat:message": {
+      const { text, replyTo } = event.payload;
+      const reply = replyTo ? ` (replying to ${replyTo})` : "";
+      return `User says${reply}: ${text}${doc}`;
+    }
+    case "selection:changed": {
+      const { from, to, selectedText } = event.payload;
+      if (!selectedText) return `User cleared selection${doc}`;
+      return `User selected text (${from}-${to}): "${selectedText}"${doc}`;
+    }
+    case "document:opened": {
+      const { fileName, format } = event.payload;
+      return `User opened document: ${fileName} (${format})${doc}`;
+    }
+    case "document:closed": {
+      const { fileName } = event.payload;
+      return `User closed document: ${fileName}${doc}`;
+    }
+    case "document:switched": {
+      const { fileName } = event.payload;
+      return `User switched to document: ${fileName}${doc}`;
+    }
+    default: {
+      const _exhaustive = event;
+      return `Unknown event${doc}`;
+    }
+  }
+}
+function formatEventMeta(event) {
+  const meta = {
+    event_type: event.type
+  };
+  if (event.documentId) meta.document_id = event.documentId;
+  switch (event.type) {
+    case "annotation:created":
+    case "annotation:accepted":
+    case "annotation:dismissed":
+      meta.annotation_id = event.payload.annotationId;
+      break;
+    case "chat:message":
+      meta.message_id = event.payload.messageId;
+      break;
+  }
+  return meta;
+}
+
+// src/channel/event-bridge.ts
+var AWARENESS_DEBOUNCE_MS = 500;
+async function startEventBridge(mcp2, tandemUrl) {
+  let retries = 0;
+  let lastEventId;
+  while (retries < CHANNEL_MAX_RETRIES) {
+    try {
+      await connectAndStream(mcp2, tandemUrl, lastEventId, (id) => {
+        lastEventId = id;
+        retries = 0;
+      });
+    } catch (err) {
+      retries++;
+      console.error(
+        `[Channel] SSE connection failed (${retries}/${CHANNEL_MAX_RETRIES}):`,
+        err instanceof Error ? err.message : err
+      );
+      if (retries >= CHANNEL_MAX_RETRIES) {
+        console.error("[Channel] SSE connection exhausted, reporting error and exiting");
+        try {
+          await fetch(`${tandemUrl}/api/channel-error`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+              error: "CHANNEL_CONNECT_FAILED",
+              message: `Channel shim lost connection after ${CHANNEL_MAX_RETRIES} retries.`
+            })
+          });
+        } catch (reportErr) {
+          console.error(
+            "[Channel] Could not report failure to server:",
+            reportErr instanceof Error ? reportErr.message : reportErr
+          );
+        }
+        process.exit(1);
+      }
+      await new Promise((r) => setTimeout(r, CHANNEL_RETRY_DELAY_MS));
+    }
+  }
+}
+async function connectAndStream(mcp2, tandemUrl, lastEventId, onEventId) {
+  const headers = { Accept: "text/event-stream" };
+  if (lastEventId) headers["Last-Event-ID"] = lastEventId;
+  const res = await fetch(`${tandemUrl}/api/events`, { headers });
+  if (!res.ok) throw new Error(`SSE endpoint returned ${res.status}`);
+  if (!res.body) throw new Error("SSE endpoint returned no body");
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let awarenessTimer = null;
+  let pendingAwareness = null;
+  function flushAwareness() {
+    if (!pendingAwareness) return;
+    const event = pendingAwareness;
+    pendingAwareness = null;
+    fetch(`${tandemUrl}/api/channel-awareness`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        documentId: event.documentId,
+        status: `processing: ${event.type}`,
+        active: true
+      })
+    }).catch((err) => {
+      console.error("[Channel] Awareness update failed:", err instanceof Error ? err.message : err);
+    });
+  }
+  function scheduleAwareness(event) {
+    pendingAwareness = event;
+    if (awarenessTimer) clearTimeout(awarenessTimer);
+    awarenessTimer = setTimeout(flushAwareness, AWARENESS_DEBOUNCE_MS);
+  }
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) throw new Error("SSE stream ended");
+    buffer += decoder.decode(value, { stream: true });
+    let boundary;
+    while ((boundary = buffer.indexOf("\n\n")) !== -1) {
+      const frame = buffer.slice(0, boundary);
+      buffer = buffer.slice(boundary + 2);
+      if (frame.startsWith(":")) continue;
+      let eventId;
+      let data;
+      for (const line of frame.split("\n")) {
+        if (line.startsWith("id: ")) eventId = line.slice(4);
+        else if (line.startsWith("data: ")) data = line.slice(6);
+      }
+      if (!data) continue;
+      let event;
+      try {
+        event = parseTandemEvent(JSON.parse(data));
+      } catch {
+        console.error("[Channel] Malformed SSE event data (skipping):", data.slice(0, 200));
+        continue;
+      }
+      if (!event) {
+        console.error("[Channel] Received invalid SSE event, skipping");
+        continue;
+      }
+      if (eventId) onEventId(eventId);
+      try {
+        await mcp2.notification({
+          method: "notifications/claude/channel",
+          params: {
+            content: formatEventContent(event),
+            meta: formatEventMeta(event)
+          }
+        });
+      } catch (err) {
+        console.error("[Channel] MCP notification failed (transport broken?):", err);
+        throw err;
+      }
+      scheduleAwareness(event);
+    }
+  }
+}
+
+// src/channel/index.ts
+console.log = console.error;
+console.warn = console.error;
+console.info = console.error;
+var TANDEM_URL = process.env.TANDEM_URL || "http://localhost:3479";
+async function checkServerReachable(url, timeoutMs = 2e3) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    console.error(
+      `[Channel] Invalid TANDEM_URL: "${url}" \u2014 expected format: http://localhost:3479`
+    );
+    return false;
+  }
+  const port = parseInt(parsed.port || String(DEFAULT_MCP_PORT), 10);
+  return new Promise((resolve) => {
+    const socket = createConnection({ port, host: parsed.hostname }, () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.setTimeout(timeoutMs);
+    socket.on("timeout", () => {
+      socket.destroy();
+      resolve(false);
+    });
+    socket.on("error", (err) => {
+      console.error(`[Channel] Server probe failed: ${err.message}`);
+      socket.destroy();
+      resolve(false);
+    });
+  });
+}
+var mcp = new Server(
+  { name: "tandem-channel", version: "0.1.0" },
+  {
+    capabilities: {
+      experimental: {
+        "claude/channel": {},
+        "claude/channel/permission": {}
+      },
+      tools: {}
+    },
+    instructions: [
+      'Events from Tandem arrive as <channel source="tandem-channel" event_type="..." document_id="...">.',
+      "These are real-time push notifications of user actions in the collaborative document editor.",
+      "Event types: annotation:created, annotation:accepted, annotation:dismissed,",
+      "chat:message, selection:changed, document:opened, document:closed, document:switched.",
+      "Use your tandem MCP tools (tandem_getTextContent, tandem_comment, tandem_highlight, etc.) to act on them.",
+      "Reply to chat messages using tandem_reply. Pass document_id from the tag attributes.",
+      "Do not reply to non-chat events \u2014 just act on them using tools.",
+      "If you haven't received channel notifications recently, call tandem_checkInbox as a fallback."
+    ].join(" ")
+  }
+);
+mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "tandem_reply",
+      description: "Reply to a chat message in Tandem",
+      inputSchema: {
+        type: "object",
+        properties: {
+          text: { type: "string", description: "The reply message" },
+          documentId: {
+            type: "string",
+            description: "Document ID from the channel event (optional)"
+          },
+          replyTo: {
+            type: "string",
+            description: "Message ID being replied to (optional)"
+          }
+        },
+        required: ["text"]
+      }
+    }
+  ]
+}));
+mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
+  if (req.params.name === "tandem_reply") {
+    const args = req.params.arguments;
+    try {
+      const res = await fetch(`${TANDEM_URL}/api/channel-reply`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(args)
+      });
+      let data;
+      try {
+        data = await res.json();
+      } catch {
+        data = { message: "Non-JSON response" };
+      }
+      if (!res.ok) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Reply failed (${res.status}): ${JSON.stringify(data)}`
+            }
+          ],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    } catch (err) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Failed to send reply: ${err instanceof Error ? err.message : String(err)}`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
+  throw new Error(`Unknown tool: ${req.params.name}`);
+});
+var PermissionRequestSchema = z.object({
+  method: z.literal("notifications/claude/channel/permission_request"),
+  params: z.object({
+    request_id: z.string(),
+    tool_name: z.string(),
+    description: z.string(),
+    input_preview: z.string()
+  })
+});
+mcp.setNotificationHandler(PermissionRequestSchema, async ({ params }) => {
+  try {
+    const res = await fetch(`${TANDEM_URL}/api/channel-permission`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        requestId: params.request_id,
+        toolName: params.tool_name,
+        description: params.description,
+        inputPreview: params.input_preview
+      })
+    });
+    if (!res.ok) {
+      console.error(
+        `[Channel] Permission relay got HTTP ${res.status} \u2014 browser may not see prompt`
+      );
+    }
+  } catch (err) {
+    console.error("[Channel] Failed to forward permission request:", err);
+  }
+});
+async function main() {
+  console.error(`[Channel] Tandem channel shim starting (server: ${TANDEM_URL})`);
+  const reachable = await checkServerReachable(TANDEM_URL);
+  if (!reachable) {
+    console.error(`[Channel] Cannot reach Tandem server at ${TANDEM_URL}`);
+    console.error("[Channel] Start it with: npm run dev:standalone");
+  }
+  const transport = new StdioServerTransport();
+  await mcp.connect(transport);
+  console.error("[Channel] Connected to Claude Code via stdio");
+  startEventBridge(mcp, TANDEM_URL).catch((err) => {
+    console.error("[Channel] Event bridge failed unexpectedly:", err);
+    process.exit(1);
+  });
+}
+main().catch((err) => {
+  console.error("[Channel] Fatal error:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map