@super-coding/cli 0.0.0-stage → 0.1.0

package/dist/daemon/transport/ws-client.js

@@ -0,0 +1,121 @@
+import WebSocket from "ws";
+/**
+ * daemon 侧 WS transport：主动连出 remote-server。
+ * - 连接成功后自动发送 hello；
+ * - 收到 ping 自动回 pong，其余消息交给 onMessage；
+ * - 断线后指数退避重连（1s 起步，上限 30s）；
+ * - 断线期间 send 静默丢弃——事件可靠性由本地 SQLite 落盘 + 重连后 resume 补发保证。
+ *
+ * 退避重置时机很关键：以前「连接一 open 就清零 attempts」，而服务端可能在鉴权通过前
+ * 就 close（4402 auth_unavailable / 4408 hello timeout），于是每次都是 1s 重试，
+ * 退避永远涨不上去 → webhook 抖动期变成重连风暴。现在改为：
+ * 「连接存活 ≥ 10s」或「收到任意服务端消息（说明鉴权已过）」才清零。
+ */
+const STABLE_CONNECTION_MS = 10_000;
+export class DaemonWsClient {
+    opts;
+    ws;
+    attempts = 0;
+    closed = false;
+    reconnectTimer;
+    stableTimer;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    connect() {
+        // 单连接不变式：已有一条在连/已连的 socket 时不再新建。
+        // 否则「旧 socket 的 close 晚于新 socket 建立」会让重连锁死：
+        // 每建一条，服务端 register 就把上一条踢掉，被踢的又触发重连 → 互相踢成风暴。
+        if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) {
+            return;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        const WsImpl = this.opts.wsImpl ?? WebSocket;
+        const ws = new WsImpl(this.opts.url);
+        this.ws = ws;
+        ws.on("open", () => {
+            if (ws !== this.ws)
+                return; // 已被取代
+            // 不再在这里清零：能连上 ≠ 能通过鉴权
+            this.send({
+                type: "hello",
+                device_token: this.opts.device_token,
+                daemon_version: this.opts.daemon_version,
+                agents: this.opts.agents,
+                ...(this.opts.features?.length ? { features: this.opts.features } : {}),
+            });
+            if (this.stableTimer)
+                clearTimeout(this.stableTimer);
+            this.stableTimer = setTimeout(() => {
+                this.attempts = 0;
+            }, STABLE_CONNECTION_MS);
+            this.opts.onOpen?.();
+        });
+        ws.on("message", (data) => {
+            if (ws !== this.ws)
+                return; // 旧连接残留消息
+            let msg;
+            try {
+                msg = JSON.parse(String(data));
+            }
+            catch {
+                return; // 无法解析的消息直接忽略
+            }
+            // 服务端只会对已鉴权连接下发消息（首个通常是 resume）→ 收到即可认为链路可用
+            this.attempts = 0;
+            if (msg.type === "ping") {
+                this.send({ type: "pong", ts: msg.ts });
+                return;
+            }
+            this.opts.onMessage(msg);
+        });
+        const scheduleReconnect = () => {
+            if (this.stableTimer) {
+                clearTimeout(this.stableTimer);
+                this.stableTimer = undefined;
+            }
+            if (this.closed)
+                return;
+            if (this.reconnectTimer)
+                return; // 已排重连，避免多个 close 各排一次
+            const base = this.opts.reconnectBaseMs ?? 1_000;
+            const max = this.opts.reconnectMaxMs ?? 30_000;
+            // 加 0~30% 抖动，避免多台设备同一时刻一起重连（惊群）
+            const delay = Math.min(max, base * 2 ** this.attempts++) * (1 + Math.random() * 0.3);
+            this.reconnectTimer = setTimeout(() => {
+                this.reconnectTimer = undefined;
+                if (!this.closed)
+                    this.connect();
+            }, Math.round(delay));
+        };
+        ws.on("close", (code, reason) => {
+            // 关键：只有「当前 socket」的关闭才代表链路断了。
+            // 旧 socket 的 close 晚到（服务端踢旧连接）时若也去重连，就会形成互踢风暴。
+            if (ws !== this.ws)
+                return;
+            this.ws = undefined;
+            this.opts.onClose?.(code, reason.toString());
+            scheduleReconnect();
+        });
+        ws.on("error", () => {
+            // error 之后必跟随 close，重连统一在 close 里调度
+        });
+    }
+    /** 断线期间静默丢弃（不抛错、不缓冲） */
+    send(msg) {
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify(msg));
+        }
+    }
+    close() {
+        this.closed = true;
+        if (this.reconnectTimer)
+            clearTimeout(this.reconnectTimer);
+        if (this.stableTimer)
+            clearTimeout(this.stableTimer);
+        this.ws?.close();
+    }
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@super-coding/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Super Coding CLI：把本机 Claude Code / Cursor 接入远程控制台（scode 命令与后台 daemon）",
+  "license": "UNLICENSED",
+  "type": "module",
+  "bin": {
+    "scode": "dist/cli.js"
+  },
+  "main": "dist/cli.js",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "super-coding",
+    "agent",
+    "daemon",
+    "claude-code",
+    "cursor",
+    "remote"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.7"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "ws": "^8.21.3",
+    "@super-coding/protocol": "0.1.0"
+  },
+  "scripts": {
+    "dev": "tsx watch src/cli.ts",
+    "build": "pnpm --filter @super-coding/protocol build && rm -rf dist && tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "start": "node dist/cli.js daemon run",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
 }