@lopecode/channel 0.1.0 → 0.1.2

package/lopecode-channel.ts

@@ -16,9 +16,10 @@ import type { ServerWebSocket } from "bun";
 import { join, dirname, basename } from "path";
 
 // --- Configuration ---
-const PORT = Number(process.env.LOPECODE_PORT ?? 8787);
+const REQUESTED_PORT = Number(process.env.LOPECODE_PORT ?? 0); // 0 = OS picks a free port
+let PORT = REQUESTED_PORT;
 
-// --- Pairing token ---
+// --- Pairing token (generated after port binding) ---
 function generateToken(): string {
   const chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789"; // no O/0/I/1
   let code = "";
@@ -26,7 +27,7 @@ function generateToken(): string {
   return `LOPE-${PORT}-${code}`;
 }
 
-const PAIRING_TOKEN = generateToken();
+let PAIRING_TOKEN = "";
 
 // --- State ---
 type ConnectionMeta = { url: string; title: string; modules?: string[] };
@@ -59,13 +60,16 @@ const mcp = new Server(
     },
     instructions: `You are connected to Lopecode notebooks via the lopecode channel.
 
-## Starting a notebook
+## Starting a lopecode notebook
 
-When the user asks to start/open/create a notebook, or when no notebooks are connected and collaboration would benefit from one:
-1. Call get_pairing_token to get the token
-2. Open the browser with: open 'https://tomlarkworthy.github.io/lopecode/notebooks/@tomlarkworthy_blank-notebook.html#view=R100(S50(@tomlarkworthy/blank-notebook),S25(@tomlarkworthy/module-selection),S25(@tomlarkworthy/claude-code-pairing))&cc=TOKEN'
-3. The notebook auto-connects — wait for the connected notification
-4. Send a welcome message via reply
+When the user asks to start/open a lopecode notebook, or start a pairing/collaboration session:
+1. Call get_pairing_token to get the token (format: LOPE-PORT-XXXX)
+2. Construct the URL: https://tomlarkworthy.github.io/lopecode/notebooks/@tomlarkworthy_blank-notebook.html#view=R100(S50(@tomlarkworthy/blank-notebook),S25(@tomlarkworthy/module-selection),S25(@tomlarkworthy/claude-code-pairing))&cc=TOKEN
+3. Open the browser: run open 'URL' (macOS) or xdg-open 'URL' (Linux)
+4. Wait for the connected notification
+5. Send a welcome message via reply
+
+If channels are not enabled, tell the user to restart with: claude --channels server:lopecode
 
 ## Message formats
 
@@ -531,53 +535,40 @@ function handleWsClose(ws: ServerWebSocket<unknown>) {
 await mcp.connect(new StdioServerTransport());
 
 // Start WebSocket + HTTP server
-try {
-  Bun.serve({
-    port: PORT,
-    hostname: "127.0.0.1",
-    fetch(req, server) {
-      const url = new URL(req.url);
-      if (url.pathname === "/ws") {
-        if (server.upgrade(req)) return;
-        return new Response("WebSocket upgrade failed", { status: 400 });
-      }
-      // Health check
-      if (url.pathname === "/health") {
-        return new Response(JSON.stringify({
-          paired: pairedConnections.size,
-          pending: pendingConnections.size,
-        }), { headers: { "content-type": "application/json" } });
-      }
-      // Root: redirect to blank notebook with auto-connect token
-      if (url.pathname === "/") {
-        const notebookUrl = `https://tomlarkworthy.github.io/lopecode/notebooks/@tomlarkworthy_blank-notebook.html#view=R100(S50(@tomlarkworthy/blank-notebook),S25(@tomlarkworthy/module-selection),S25(@tomlarkworthy/claude-code-pairing))&cc=${PAIRING_TOKEN}`;
-        return new Response(null, {
-          status: 302,
-          headers: { Location: notebookUrl },
-        });
-      }
-      return new Response("lopecode-channel", { status: 200 });
-    },
-    websocket: {
-      open(ws) {
-        pendingConnections.add(ws);
-      },
-      message: handleWsMessage,
-      close: handleWsClose,
+const server = Bun.serve({
+  port: REQUESTED_PORT,
+  hostname: "127.0.0.1",
+  fetch(req, server) {
+    const url = new URL(req.url);
+    if (url.pathname === "/ws") {
+      if (server.upgrade(req)) return;
+      return new Response("WebSocket upgrade failed", { status: 400 });
+    }
+    if (url.pathname === "/health") {
+      return new Response(JSON.stringify({
+        paired: pairedConnections.size,
+        pending: pendingConnections.size,
+      }), { headers: { "content-type": "application/json" } });
+    }
+    if (url.pathname === "/") {
+      const notebookUrl = `https://tomlarkworthy.github.io/lopecode/notebooks/@tomlarkworthy_blank-notebook.html#view=R100(S50(@tomlarkworthy/blank-notebook),S25(@tomlarkworthy/module-selection),S25(@tomlarkworthy/claude-code-pairing))&cc=${PAIRING_TOKEN}`;
+      return new Response(null, {
+        status: 302,
+        headers: { Location: notebookUrl },
+      });
+    }
+    return new Response("lopecode-channel", { status: 200 });
+  },
+  websocket: {
+    open(ws) {
+      pendingConnections.add(ws);
     },
-  });
-} catch (err) {
-  const msg = err instanceof Error ? err.message : String(err);
-  if (msg.includes("EADDRINUSE") || msg.includes("address already in use") || msg.includes("port") && msg.includes("in use")) {
-    process.stderr.write(
-      `lopecode-channel: ERROR — port ${PORT} is already in use.\n` +
-      `Another lopecode-channel or other service is running on this port.\n` +
-      `Kill the existing process or set LOPECODE_PORT=<other port>.\n`
-    );
-    process.exit(1);
-  }
-  throw err;
-}
+    message: handleWsMessage,
+    close: handleWsClose,
+  },
+});
 
+PORT = server.port; // read actual port (important when REQUESTED_PORT is 0)
+PAIRING_TOKEN = generateToken();
 process.stderr.write(`lopecode-channel: pairing token: ${PAIRING_TOKEN}\n`);
 process.stderr.write(`lopecode-channel: WebSocket server on ws://127.0.0.1:${PORT}/ws\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lopecode/channel",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Pair program with Claude inside Lopecode notebooks. MCP server bridging browser notebooks and Claude Code.",
   "type": "module",
   "bin": {