@insitue/claude-plugin 0.3.1 → 0.3.3

package/commands/connect.md

@@ -21,7 +21,11 @@ not need to ask the user to run any extra commands.
    to click Send in the InSitue panel"). Otherwise just say
    "Connected. Pick something in the browser when you're ready."
 2. Enter the loop: call `mcp__insitue__next_pick`. It long-polls
-   (~5 min default). When it returns with `status: "ok"`:
+   (~25s default — short on purpose so the chat stays responsive
+   to other questions the user might type while you wait). When
+   it returns with `status: "timeout"`, **call it again immediately
+   without announcing it** — the timeout is just a heartbeat, not
+   news. When it returns with `status: "ok"`:
    - **Always echo the prompt back first.** Before any action,
      diff, or follow-up question, lead with:
 
@@ -54,7 +58,13 @@ not need to ask the user to run any extra commands.
    - Loop back to `next_pick`.
 3. If `next_pick` returns `status: "timeout"`, the user simply
    hasn't picked anything yet. Stay quiet and call `next_pick`
-   again.
+   again. **Do not narrate the loop** — no "still waiting…", no
+   "polling again…". The user sees `[insitue] 📥 pick received`
+   on stderr the moment their pick lands; that's the
+   confirmation, not your narration. If the user types another
+   question while you're between calls, answer it first (since
+   the chat is responsive), then resume the loop with
+   `next_pick`.
 4. If a pick comes back with `target` starting with
    `[insitue]` (e.g. "companion disconnected"), tell the user
    what happened in one sentence and call `next_pick` again —

package/dist/mcp-server.js

@@ -10,7 +10,7 @@ import { dirname, join, resolve } from "path";
 import WebSocket from "ws";
 import { z } from "zod";
 var MAX_BUFFERED_PICKS = 32;
-var NEXT_PICK_DEFAULT_TIMEOUT_MS = 5 * 60 * 1e3;
+var NEXT_PICK_DEFAULT_TIMEOUT_MS = 25 * 1e3;
 var NEXT_PICK_MAX_TIMEOUT_MS = 30 * 60 * 1e3;
 function findSession(start = process.cwd()) {
   let dir = resolve(start);
@@ -54,7 +54,8 @@ function summariseBundle(raw) {
     selector: t?.selector ?? null,
     userNote: raw.bundle.userNote ?? null,
     url: raw.bundle.runtime?.url ?? null,
-    componentStack
+    componentStack,
+    ...t?.cmsSource ? { cmsSource: t.cmsSource } : {}
   };
 }
 var PickBuffer = class {
@@ -239,8 +240,15 @@ function connectToCompanion(session2) {
       }
       if (tag === "broadcast-capture") {
         try {
-          buffer.push(
-            summariseBundle(m)
+          const summary = summariseBundle(
+            m
+          );
+          buffer.push(summary);
+          const note = summary.userNote ? summary.userNote.length > 60 ? `${summary.userNote.slice(0, 57)}\u2026` : summary.userNote : "(no description)";
+          const where = summary.source ? `${summary.source.file}:${summary.source.line}` : summary.target;
+          process.stderr.write(
+            `[insitue] \u{1F4E5} pick received \u2014 "${note}" @ ${where}
+`
           );
         } catch (err) {
           process.stderr.write(
@@ -265,7 +273,11 @@ if (!session) {
   process.stderr.write(
     "[insitue-mcp] no companion available \u2014 `next_pick` will time out.\n"
   );
-} else {
+}
+var attached = false;
+function ensureSubscriberAttached() {
+  if (attached || !session) return;
+  attached = true;
   connectToCompanion(session);
 }
 var server = new McpServer({
@@ -283,6 +295,7 @@ server.registerTool(
     }
   },
   async ({ timeout_ms }) => {
+    ensureSubscriberAttached();
     const ms = timeout_ms ?? NEXT_PICK_DEFAULT_TIMEOUT_MS;
     const pick = await buffer.next(ms);
     if (!pick) {
@@ -311,6 +324,7 @@ server.registerTool(
     }
   },
   async ({ limit }) => {
+    ensureSubscriberAttached();
     const picks = buffer.recent(limit ?? 10);
     return {
       content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insitue/claude-plugin",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Drive a Claude Code session from the InSitue browser overlay — pick an element in your app, claude reads the file and proposes the edit.",
   "license": "MIT",
   "type": "module",