@skillpie/dsh-remote 0.0.0-stage → 1.0.0

package/lib/remote.js

@@ -0,0 +1,181 @@
+/**
+ * dsh-remote — outbound control link (host role).
+ *
+ * Dials `relayUrl + HOST_UPGRADE_PATH` over one WebSocket, registers the
+ * 8-digit code and identity, and feeds every control frame to the shared
+ * HostEngine. Reconnects with jittered backoff; mints/re-persists the token
+ * whenever the relay hands one back (first registration, or after the relay
+ * lost its registry).
+ */
+import WebSocket from 'ws'
+import { HOST_UPGRADE_PATH, PROTOCOL_VERSION } from './protocol.js'
+import { adaptSocket } from './ws-adapter.js'
+
+const BACKOFF_INITIAL_MS = 1_000
+const BACKOFF_MAX_MS = 30_000
+const HEARTBEAT_MS = 15_000
+const IDLE_TIMEOUT_MS = 45_000
+
+export class RelayLink {
+  /**
+   * @param identity { hostId, code, token, name, dsh } — read live via getters
+   * @param onToken (token) — persist a relay-minted token
+   * @param peer { attach(channel), detach(channel) } — the GUI bridge or
+   *        command engine; attached on a healthy link
+   */
+  constructor({ relayUrl, identity, onToken, peer, log = () => {} }) {
+    this.relayUrl = relayUrl
+    this.identity = identity
+    this.onToken = onToken
+    this.peer = peer
+    this.log = log
+    this.raw = undefined
+    this.backoffMs = BACKOFF_INITIAL_MS
+    this.retryTimer = undefined
+    this.hbTimer = undefined
+    this.idleTimer = undefined
+    this.stopped = true
+    this.connectedSince = undefined
+    this.lastError = undefined
+  }
+
+  get connected() {
+    return this.raw !== undefined && this.connectedSince !== undefined
+  }
+
+  start() {
+    if (!this.stopped) return
+    this.stopped = false
+    this.connect()
+  }
+
+  stop() {
+    this.stopped = true
+    this.clearTimers()
+    if (this.retryTimer) { clearTimeout(this.retryTimer); this.retryTimer = undefined }
+    this.detachPeer()
+    if (this.raw) {
+      try { this.raw.close(1000) } catch { /* already gone */ }
+      this.raw = undefined
+    }
+    this.connectedSince = undefined
+  }
+
+  clearTimers() {
+    if (this.hbTimer) { clearInterval(this.hbTimer); this.hbTimer = undefined }
+    if (this.idleTimer) { clearTimeout(this.idleTimer); this.idleTimer = undefined }
+  }
+
+  detachPeer() {
+    if (this.peer && this.adapter) this.peer.detach(this.adapter)
+    this.adapter = undefined
+  }
+
+  connect() {
+    if (this.stopped) return
+    const url = new URL(this.relayUrl)
+    url.protocol = url.protocol === 'http:' ? 'ws:' : url.protocol === 'https:' ? 'wss:' : url.protocol
+    url.pathname = HOST_UPGRADE_PATH
+    let raw
+    try {
+      raw = new WebSocket(url, { handshakeTimeout: 10_000 })
+    } catch (error) {
+      this.lastError = error?.message ?? String(error)
+      this.scheduleRetry()
+      return
+    }
+    this.raw = raw
+    raw.on('open', () => {
+      raw.send(JSON.stringify({
+        t: 'hello',
+        v: PROTOCOL_VERSION,
+        hostId: this.identity.hostId,
+        code: this.identity.code,
+        token: this.identity.token ?? '',
+        name: this.identity.name,
+        dsh: this.identity.dsh,
+      }))
+    })
+    raw.on('message', (data) => this.onFrame(String(data)))
+    raw.on('close', () => {
+      const wasConnected = this.connected
+      this.clearTimers()
+      this.detachPeer()
+      this.raw = undefined
+      this.connectedSince = undefined
+      if (this.stopped) return
+      if (wasConnected) this.log('relay', '中转连接断开，准备重连')
+      this.scheduleRetry()
+    })
+    raw.on('error', (error) => {
+      this.lastError = error?.message ?? String(error)
+    })
+  }
+
+  scheduleRetry() {
+    if (this.stopped || this.retryTimer) return
+    const jitter = Math.floor(Math.random() * this.backoffMs * 0.5)
+    const delay = this.backoffMs + jitter
+    this.backoffMs = Math.min(this.backoffMs * 2, BACKOFF_MAX_MS)
+    this.retryTimer = setTimeout(() => {
+      this.retryTimer = undefined
+      this.connect()
+    }, delay)
+    this.log('relay', `将在 ${Math.round(delay / 100) / 10}s 后重连中转`)
+  }
+
+  onFrame(text) {
+    let frame
+    try { frame = JSON.parse(text) } catch { return }
+    if (!frame || typeof frame !== 'object') return
+    if (frame.t === 'hello') {
+      if (frame.ok !== true) {
+        this.lastError = frame.error ?? 'relay rejected registration'
+        this.log('relay', `中转拒绝注册: ${this.lastError}`)
+        // Registration refused (e.g. code taken): back off like a network failure.
+        try { this.raw?.close() } catch { /* noop */ }
+        return
+      }
+      this.backoffMs = BACKOFF_INITIAL_MS
+      this.connectedSince = Date.now()
+      this.lastError = undefined
+      if (typeof frame.token === 'string' && frame.token !== this.identity.token) {
+        this.identity.token = frame.token
+        try { this.onToken?.(frame.token) } catch (error) {
+          this.log('relay', `token 持久化失败: ${error?.message ?? error}`)
+        }
+      }
+      this.armIdle()
+      this.adapter = adaptSocket(this.raw)
+      this.peer.attach(this.adapter)
+      this.hbTimer = setInterval(() => {
+        if (this.raw?.readyState === 1) this.raw.send(JSON.stringify({ t: 'hb' }))
+      }, HEARTBEAT_MS)
+      this.log('relay', `已连接中转，远程码 ${this.identity.code} 生效`)
+      return
+    }
+    if (frame.t === 'hb') {
+      this.armIdle()
+      return
+    }
+    // res/push frames belong to the engine's channel adapter; its own
+    // onMessage handler consumed them already (adapter shares this socket).
+  }
+
+  armIdle() {
+    if (this.idleTimer) clearTimeout(this.idleTimer)
+    this.idleTimer = setTimeout(() => {
+      this.log('relay', '中转心跳超时，主动断开')
+      try { this.raw?.close() } catch { /* noop */ }
+    }, IDLE_TIMEOUT_MS)
+  }
+
+  status() {
+    return {
+      relayUrl: this.relayUrl,
+      connected: this.connected,
+      connectedSince: this.connectedSince,
+      lastError: this.lastError,
+    }
+  }
+}

package/lib/ws-adapter.js

@@ -0,0 +1,49 @@
+/**
+ * dsh-remote — adapter from a raw `ws` socket to the small surface the
+ * plugin uses:
+ *   send(obj)          JSON text frame
+ *   sendRaw(buffer)    binary frame (GUI splice payloads)
+ *   onMessage(cb)      cb(text | Buffer) — text for JSON frames, Buffer for binary
+ *   onClose(cb), close()
+ */
+export function adaptSocket(raw) {
+  const end = {
+    open: raw.readyState === 1,
+    send(obj) {
+      if (raw.readyState !== 1) return
+      raw.send(JSON.stringify(obj))
+    },
+    sendRaw(buffer) {
+      if (raw.readyState !== 1) return
+      raw.send(buffer, { binary: true })
+    },
+    sendText(text) {
+      if (raw.readyState !== 1) return
+      raw.send(text)
+    },
+    onMessage(handler) {
+      const listener = (data, isBinary) => {
+        try {
+          handler(isBinary ? data : String(data))
+        } catch {
+          // A listener bug must never crash the host process.
+        }
+      }
+      raw.on('message', listener)
+      return () => raw.off('message', listener)
+    },
+    onClose(handler) {
+      const listener = () => {
+        try { handler() } catch { /* contained */ }
+      }
+      raw.on('close', listener)
+      return () => raw.off('close', listener)
+    },
+    close() {
+      try { raw.close(1000) } catch { raw.terminate() }
+    },
+    raw,
+  }
+  raw.on('close', () => { end.open = false })
+  return end
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Remote control",
+    "description": "Lets a browser reach this host with an 8-digit code through a relay origin, view sessions, send prompts and interrupt runs."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "远程控制",
+    "description": "通过中转站以 8 位远程码在浏览器里访问本机：查看会话、发送指令、中断运行。"
+  }
+}

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@skillpie/dsh-remote",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Remote control for DeepSeek Harness: reach any host by its 8-digit code through a relay origin such as dsh.skillpie.cn.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "remote-control",
+    "relay",
+    "remote-assistance"
+  ],
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "lib",
+    "locale/*.json",
+    "cordis.patch.yml",
+    "icon.svg",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22.13",
+    "dsh": ">=0.2.1-rc.3"
+  },
+  "dependencies": {
+    "ws": "^8.22.2"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}