sbuilder-mcp 0.63.1 → 0.63.2

package/CHANGELOG.md

@@ -6,6 +6,11 @@ All notable changes to this project are 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.63.2] - 2026-09-24
+
+### Fixed
+- The live-edit socket now holds frames sent before the server's welcome instead of dropping them, so a section added right after `sb_page_open` reaches an editor watching the page instead of leaving it showing "This page is empty" and risking that empty state being autosaved over the agent's work; the held queue is capped at 500 frames so a long reconnect loop cannot grow memory without bound.
+
 ## [0.63.1] - 2026-09-24
 
 ### Fixed

package/CHANGELOG.vi.md

@@ -6,6 +6,11 @@ Mọi thay đổi đáng chú ý của dự án được ghi lại trong file n
 Định dạng dựa trên [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 và dự án tuân theo [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.63.2] - 2026-09-24
+
+### Fixed
+- Socket live-edit giờ giữ lại các frame được gửi trước khi server chào (welcome) thay vì loại bỏ chúng, để một section được thêm ngay sau `sb_page_open` đến được với editor đang xem trang thay vì để trang đó hiển thị "This page is empty" và có nguy cơ trạng thái rỗng đó bị autosave đè lên công việc của agent; hàng đợi giữ frame bị giới hạn ở 500 frame để một vòng lặp reconnect kéo dài không thể làm bộ nhớ tăng vô hạn.
+
 ## [0.63.1] - 2026-09-24
 
 ### Fixed

package/dist/transport/socket.js

@@ -11,6 +11,8 @@ import { agentIdentity } from './identity.js';
 const OPEN = 1;
 const RETRY_BASE_MS = 500;
 const RETRY_MAX_MS = 15_000;
+/** Frames held while not ready. A reconnect loop must not grow memory forever. */
+const QUEUE_MAX = 500;
 export class RealtimeSocket {
     url;
     token;
@@ -20,6 +22,19 @@ export class RealtimeSocket {
     attempt = 0;
     handlers = [];
     timer = null;
+    /** The server has welcomed THIS connection — frames sent now are read. */
+    ready = false;
+    /**
+     * Frames sent while not ready, flushed on the welcome.
+     *
+     * `sb_page_open` starts the connection and returns; the `sb_add` right after
+     * it ran before the handshake finished, and a send that DROPPED on a
+     * not-open socket lost it without a trace. The editor watching the page never
+     * saw the section appear — it showed an empty page, and its next autosave
+     * could write that empty page over the agent's work. Same for every edit made
+     * during a reconnect.
+     */
+    queue = [];
     constructor(url, 
     /**
      * A GETTER, read per attempt. The access token lives ~15 minutes and
@@ -44,6 +59,7 @@ export class RealtimeSocket {
         const ws = this.factory(this.url);
         this.ws = ws;
         this.attempt += 1;
+        this.ready = false;
         ws.onopen = () => {
             // Auth is the FIRST message, never a header (a browser cannot set one on a
             // WebSocket) and never a query parameter (a token in a URL lands in logs).
@@ -92,10 +108,17 @@ export class RealtimeSocket {
             catch {
                 return; // a malformed frame must never throw into the socket
             }
+            // Ready BEFORE the handlers, flushed AFTER them: the page announcement
+            // the welcome triggers goes out directly, ahead of the ops held for it.
+            const held = this.ready ? [] : this.queue.splice(0);
+            this.ready = true;
             for (const h of this.handlers)
                 h(parsed);
+            for (const f of held)
+                ws.send(f);
         };
         ws.onclose = () => {
+            this.ready = false;
             if (this.closed)
                 return;
             const wait = Math.min(RETRY_BASE_MS * 2 ** this.attempt, RETRY_MAX_MS);
@@ -109,12 +132,21 @@ export class RealtimeSocket {
     send(e) {
         if (this.closed)
             return;
-        if (this.ws?.readyState !== OPEN)
+        const frame = JSON.stringify(e);
+        if (this.ready && this.ws?.readyState === OPEN) {
+            this.ws.send(frame);
             return;
-        this.ws.send(JSON.stringify(e));
+        }
+        if (this.queue.length >= QUEUE_MAX) {
+            // ponytail: drops the oldest past the cap; the peer re-pulls on the gap.
+            console.error('[sbuilder-mcp] live queue full, dropping the oldest frame');
+            this.queue.shift();
+        }
+        this.queue.push(frame);
     }
     close() {
         this.closed = true;
+        this.queue = [];
         if (this.timer)
             clearTimeout(this.timer);
         this.ws?.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sbuilder-mcp",
-  "version": "0.63.1",
+  "version": "0.63.2",
   "description": "MCP server that designs and operates a Store Builder site — pages, data, theme and publish — through the platform's own API and live-edit protocol.",
   "mcpName": "io.github.vuluu2k/sbuilder-mcp",
   "type": "module",