@wangyaoshen/remux 0.3.8-dev.a8ceb0c

package/native/ios/ProtocolModels.swift

@@ -0,0 +1,200 @@
+public struct ProtocolCapabilities: Codable, Equatable {
+  public let envelope: Bool
+  public let inspectV2: Bool
+  public let deviceTrust: Bool
+}
+
+public struct AuthPayload: Codable, Equatable {
+  public let token: String
+  public let password: String?
+  public let cols: Int?
+  public let rows: Int?
+  public let capabilities: ProtocolCapabilities?
+}
+
+public struct AuthOkPayload: Codable, Equatable {
+  public let capabilities: ProtocolCapabilities
+}
+
+public struct AuthErrorPayload: Codable, Equatable {
+  public let reason: String
+}
+
+public struct InspectContentPayload: Codable, Equatable {
+  public let content: String
+}
+
+public struct RemuxEnvelope<Payload: Codable & Equatable>: Codable, Equatable {
+  public let domain: String
+  public let type: String
+  public let version: Int
+  public let requestId: String?
+  public let emittedAt: String
+  public let source: String
+  public let payload: Payload
+}
+
+public struct WorkspacePane: Codable, Equatable {
+  public let id: String
+  public let focused: Bool
+  public let title: String
+  public let command: String?
+  public let cwd: String?
+  public let rows: Int
+  public let cols: Int
+  public let x: Int
+  public let y: Int
+}
+
+public struct WorkspaceTab: Codable, Equatable {
+  public let index: Int
+  public let name: String
+  public let active: Bool
+  public let isFullscreen: Bool
+  public let hasBell: Bool
+  public let panes: [WorkspacePane]
+}
+
+public struct WorkspaceState: Codable, Equatable {
+  public let session: String
+  public let tabs: [WorkspaceTab]
+  public let activeTabIndex: Int
+}
+
+public struct InspectHighlight: Codable, Equatable {
+  public let start: Int
+  public let end: Int
+}
+
+public struct InspectDescriptor: Codable, Equatable {
+  public let scope: String
+  public let source: String
+  public let precision: String
+  public let staleness: String
+  public let capturedAt: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let totalItems: Int?
+}
+
+public struct InspectItem: Codable, Equatable {
+  public let type: String
+  public let content: String
+  public let lineNumber: Int?
+  public let timestamp: String
+  public let paneId: String?
+  public let highlights: [InspectHighlight]?
+}
+
+public struct InspectSnapshot: Codable, Equatable {
+  public let descriptor: InspectDescriptor
+  public let items: [InspectItem]
+  public let cursor: String?
+  public let truncated: Bool
+}
+
+public struct InspectRequest: Codable, Equatable {
+  public let scope: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let cursor: String?
+  public let query: String?
+  public let limit: Int?
+}
+
+public struct BandwidthStats: Codable, Equatable {
+  public let rawBytesPerSec: Double
+  public let compressedBytesPerSec: Double
+  public let savedPercent: Double
+  public let fullSnapshotsSent: Int
+  public let diffUpdatesSent: Int
+  public let avgChangedRowsPerDiff: Double
+  public let totalRawBytes: Int
+  public let totalCompressedBytes: Int
+  public let totalSavedBytes: Int
+  public let rttMs: Int?
+  public let protocolName: String
+
+  enum CodingKeys: String, CodingKey {
+    case rawBytesPerSec
+    case compressedBytesPerSec
+    case savedPercent
+    case fullSnapshotsSent
+    case diffUpdatesSent
+    case avgChangedRowsPerDiff
+    case totalRawBytes
+    case totalCompressedBytes
+    case totalSavedBytes
+    case rttMs
+    case protocolName = "protocol"
+  }
+}
+
+public struct BandwidthStatsPayload: Codable, Equatable {
+  public let stats: BandwidthStats
+}
+
+public struct LegacyAuthOk: Codable, Equatable {
+  public let type: String
+  public let capabilities: ProtocolCapabilities
+}
+
+public struct LegacyAuth: Codable, Equatable {
+  public let type: String
+  public let token: String
+  public let password: String?
+  public let cols: Int?
+  public let rows: Int?
+  public let capabilities: ProtocolCapabilities?
+}
+
+public struct LegacyAuthError: Codable, Equatable {
+  public let type: String
+  public let reason: String
+}
+
+public struct LegacyErrorMessage: Codable, Equatable {
+  public let type: String
+  public let code: Int?
+  public let message: String
+}
+
+public struct LegacyPong: Codable, Equatable {
+  public let type: String
+  public let timestamp: Double
+}
+
+public struct LegacyWorkspaceState: Codable, Equatable {
+  public let type: String
+  public let session: String
+  public let tabs: [WorkspaceTab]
+  public let activeTabIndex: Int
+}
+
+public struct LegacyInspectRequest: Codable, Equatable {
+  public let type: String
+  public let scope: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let cursor: String?
+  public let query: String?
+  public let limit: Int?
+}
+
+public struct LegacyInspectSnapshot: Codable, Equatable {
+  public let type: String
+  public let descriptor: InspectDescriptor
+  public let items: [InspectItem]
+  public let cursor: String?
+  public let truncated: Bool
+}
+
+public struct LegacyBandwidthStats: Codable, Equatable {
+  public let type: String
+  public let stats: BandwidthStats
+}
+
+public struct LegacyInspectContent: Codable, Equatable {
+  public let type: String
+  public let content: String
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@wangyaoshen/remux",
+  "version": "0.3.8-dev.a8ceb0c",
+  "description": "Remote terminal workspace — powered by ghostty-web",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yaoshenwang/remux.git"
+  },
+  "type": "module",
+  "bin": {
+    "remux": "server.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "ghostty-web": "^0.4.0",
+    "node-pty": "^1.1.0",
+    "qrcode-terminal": "^0.12.0",
+    "simple-git": "^3.33.0",
+    "web-push": "^3.6.7",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.5.0",
+    "@types/ws": "^8.18.1",
+    "esbuild": "^0.27.4",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "start": "node server.js",
+    "dev": "pnpm build && node server.js",
+    "build": "node build.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "npx playwright test",
+    "postinstall": "node --input-type=commonjs -e \"var fs=require('fs'),p=require('path');['darwin-arm64','darwin-x64'].forEach(function(d){var f=p.join('node_modules','node-pty','prebuilds',d,'spawn-helper');try{fs.chmodSync(f,0o755)}catch(e){}})\""
+  }
+}

package/packages/RemuxKit/Package.swift

@@ -0,0 +1,27 @@
+// swift-tools-version: 6.0
+
+import PackageDescription
+
+let package = Package(
+    name: "RemuxKit",
+    platforms: [
+        .iOS(.v17),
+        .macOS(.v14),
+    ],
+    products: [
+        .library(
+            name: "RemuxKit",
+            targets: ["RemuxKit"]
+        ),
+    ],
+    targets: [
+        .target(
+            name: "RemuxKit",
+            exclude: ["Terminal/Resources"]
+        ),
+        .testTarget(
+            name: "RemuxKitTests",
+            dependencies: ["RemuxKit"]
+        ),
+    ]
+)

package/packages/RemuxKit/Sources/RemuxKit/Device/DeviceManager.swift

@@ -0,0 +1,27 @@
+import Foundation
+
+/// Manages device trust operations via WebSocket messages.
+/// All messages use JSONSerialization for safe construction.
+@MainActor
+public final class DeviceManager {
+
+    private weak var connection: RemuxConnection?
+
+    public init(connection: RemuxConnection) {
+        self.connection = connection
+    }
+
+    public func listDevices() { sendJSON(["type": "list_devices"]) }
+    public func trustDevice(id: String) { sendJSON(["type": "trust_device", "deviceId": id]) }
+    public func blockDevice(id: String) { sendJSON(["type": "block_device", "deviceId": id]) }
+    public func renameDevice(id: String, name: String) { sendJSON(["type": "rename_device", "deviceId": id, "name": name]) }
+    public func revokeDevice(id: String) { sendJSON(["type": "revoke_device", "deviceId": id]) }
+    public func generatePairCode() { sendJSON(["type": "generate_pair_code"]) }
+    public func pair(code: String) { sendJSON(["type": "pair", "code": code]) }
+
+    private func sendJSON(_ dict: [String: Any]) {
+        guard let data = try? JSONSerialization.data(withJSONObject: dict),
+              let str = String(data: data, encoding: .utf8) else { return }
+        connection?.sendString(str)
+    }
+}

package/packages/RemuxKit/Sources/RemuxKit/Models/ProtocolModels.swift

@@ -0,0 +1,206 @@
+public struct ProtocolCapabilities: Codable, Equatable, Sendable {
+  public let envelope: Bool
+  public let inspectV2: Bool
+  public let deviceTrust: Bool
+}
+
+public struct AuthPayload: Codable, Equatable, Sendable {
+  public let token: String
+  public let password: String?
+  public let cols: Int?
+  public let rows: Int?
+  public let capabilities: ProtocolCapabilities?
+}
+
+public struct AuthOkPayload: Codable, Equatable, Sendable {
+  public let capabilities: ProtocolCapabilities
+}
+
+public struct AuthErrorPayload: Codable, Equatable, Sendable {
+  public let reason: String
+}
+
+public struct InspectContentPayload: Codable, Equatable, Sendable {
+  public let content: String
+}
+
+public struct RemuxEnvelope<Payload: Codable & Equatable & Sendable>: Codable, Equatable, Sendable {
+  public let domain: String
+  public let type: String
+  public let version: Int
+  public let requestId: String?
+  public let emittedAt: String
+  public let source: String
+  public let payload: Payload
+
+  enum CodingKeys: String, CodingKey {
+    case domain, type
+    case version = "v"
+    case requestId, emittedAt, source, payload
+  }
+}
+
+public struct WorkspacePane: Codable, Equatable, Sendable {
+  public let id: String
+  public let focused: Bool
+  public let title: String
+  public let command: String?
+  public let cwd: String?
+  public let rows: Int
+  public let cols: Int
+  public let x: Int
+  public let y: Int
+}
+
+public struct WorkspaceTab: Codable, Equatable, Sendable {
+  public let index: Int
+  public let name: String
+  public let active: Bool
+  public let isFullscreen: Bool
+  public let hasBell: Bool
+  public let panes: [WorkspacePane]
+}
+
+public struct WorkspaceState: Codable, Equatable, Sendable {
+  public let session: String
+  public let tabs: [WorkspaceTab]
+  public let activeTabIndex: Int
+}
+
+public struct InspectHighlight: Codable, Equatable, Sendable {
+  public let start: Int
+  public let end: Int
+}
+
+public struct InspectDescriptor: Codable, Equatable, Sendable {
+  public let scope: String
+  public let source: String
+  public let precision: String
+  public let staleness: String
+  public let capturedAt: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let totalItems: Int?
+}
+
+public struct InspectItem: Codable, Equatable, Sendable {
+  public let type: String
+  public let content: String
+  public let lineNumber: Int?
+  public let timestamp: String
+  public let paneId: String?
+  public let highlights: [InspectHighlight]?
+}
+
+public struct InspectSnapshot: Codable, Equatable, Sendable {
+  public let descriptor: InspectDescriptor
+  public let items: [InspectItem]
+  public let cursor: String?
+  public let truncated: Bool
+}
+
+public struct InspectRequest: Codable, Equatable, Sendable {
+  public let scope: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let cursor: String?
+  public let query: String?
+  public let limit: Int?
+}
+
+public struct BandwidthStats: Codable, Equatable, Sendable {
+  public let rawBytesPerSec: Double
+  public let compressedBytesPerSec: Double
+  public let savedPercent: Double
+  public let fullSnapshotsSent: Int
+  public let diffUpdatesSent: Int
+  public let avgChangedRowsPerDiff: Double
+  public let totalRawBytes: Int
+  public let totalCompressedBytes: Int
+  public let totalSavedBytes: Int
+  public let rttMs: Int?
+  public let protocolName: String
+
+  enum CodingKeys: String, CodingKey {
+    case rawBytesPerSec
+    case compressedBytesPerSec
+    case savedPercent
+    case fullSnapshotsSent
+    case diffUpdatesSent
+    case avgChangedRowsPerDiff
+    case totalRawBytes
+    case totalCompressedBytes
+    case totalSavedBytes
+    case rttMs
+    case protocolName = "protocol"
+  }
+}
+
+public struct BandwidthStatsPayload: Codable, Equatable, Sendable {
+  public let stats: BandwidthStats
+}
+
+public struct LegacyAuthOk: Codable, Equatable, Sendable {
+  public let type: String
+  public let capabilities: ProtocolCapabilities
+}
+
+public struct LegacyAuth: Codable, Equatable, Sendable {
+  public let type: String
+  public let token: String
+  public let password: String?
+  public let cols: Int?
+  public let rows: Int?
+  public let capabilities: ProtocolCapabilities?
+}
+
+public struct LegacyAuthError: Codable, Equatable, Sendable {
+  public let type: String
+  public let reason: String
+}
+
+public struct LegacyErrorMessage: Codable, Equatable, Sendable {
+  public let type: String
+  public let code: Int?
+  public let message: String
+}
+
+public struct LegacyPong: Codable, Equatable, Sendable {
+  public let type: String
+  public let timestamp: Double
+}
+
+public struct LegacyWorkspaceState: Codable, Equatable, Sendable {
+  public let type: String
+  public let session: String
+  public let tabs: [WorkspaceTab]
+  public let activeTabIndex: Int
+}
+
+public struct LegacyInspectRequest: Codable, Equatable, Sendable {
+  public let type: String
+  public let scope: String
+  public let paneId: String?
+  public let tabIndex: Int?
+  public let cursor: String?
+  public let query: String?
+  public let limit: Int?
+}
+
+public struct LegacyInspectSnapshot: Codable, Equatable, Sendable {
+  public let type: String
+  public let descriptor: InspectDescriptor
+  public let items: [InspectItem]
+  public let cursor: String?
+  public let truncated: Bool
+}
+
+public struct LegacyBandwidthStats: Codable, Equatable, Sendable {
+  public let type: String
+  public let stats: BandwidthStats
+}
+
+public struct LegacyInspectContent: Codable, Equatable, Sendable {
+  public let type: String
+  public let content: String
+}

package/packages/RemuxKit/Sources/RemuxKit/Networking/MessageRouter.swift

@@ -0,0 +1,108 @@
+import Foundation
+
+/// Routes incoming WebSocket messages to the appropriate handler.
+/// Supports both envelope format (v:1) and legacy bare messages.
+public struct MessageRouter: Sendable {
+
+    /// Parsed message with type info extracted
+    public enum RoutedMessage: Sendable {
+        case state(WorkspaceState)
+        case inspectResult(InspectSnapshot)
+        case roleChanged(String) // "active" or "observer"
+        case deviceList([DeviceInfo])
+        case pairResult(PairResultPayload)
+        case pushStatus(PushStatusPayload)
+        case error(String)
+        case unknown(type: String, raw: String)
+    }
+
+    public init() {}
+
+    /// Parse and route a raw JSON message string.
+    public func route(_ text: String) -> RoutedMessage? {
+        guard let data = text.data(using: .utf8),
+              let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+            return nil
+        }
+
+        // Extract type — handle both envelope (v:1) and legacy format
+        let msgType: String?
+        let payload: [String: Any]?
+
+        if let v = json["v"] as? Int, v >= 1 {
+            // Envelope format
+            msgType = json["type"] as? String
+            payload = json["payload"] as? [String: Any]
+        } else {
+            // Legacy format — type is top-level
+            msgType = json["type"] as? String
+            payload = json
+        }
+
+        guard let type = msgType else { return nil }
+
+        switch type {
+        case "state":
+            if let p = payload, let state = decode(WorkspaceState.self, from: p) {
+                return .state(state)
+            }
+        case "inspect_result":
+            if let p = payload, let snapshot = decode(InspectSnapshot.self, from: p) {
+                return .inspectResult(snapshot)
+            }
+        case "role_changed":
+            if let role = payload?["role"] as? String {
+                return .roleChanged(role)
+            }
+        case "device_list":
+            if let p = payload, let list = decode(DeviceListPayload.self, from: p) {
+                return .deviceList(list.devices)
+            }
+        case "pair_result":
+            if let p = payload, let result = decode(PairResultPayload.self, from: p) {
+                return .pairResult(result)
+            }
+        case "push_status":
+            if let p = payload, let status = decode(PushStatusPayload.self, from: p) {
+                return .pushStatus(status)
+            }
+        case "error":
+            let message = payload?["message"] as? String ?? "Unknown error"
+            return .error(message)
+        default:
+            return .unknown(type: type, raw: text)
+        }
+
+        return .unknown(type: type, raw: text)
+    }
+
+    private func decode<T: Decodable>(_ type: T.Type, from dict: [String: Any]) -> T? {
+        guard let data = try? JSONSerialization.data(withJSONObject: dict) else { return nil }
+        return try? JSONDecoder().decode(type, from: data)
+    }
+}
+
+// MARK: - Additional payload types needed by router
+
+public struct DeviceInfo: Codable, Equatable, Sendable {
+    public let id: String
+    public let fingerprint: String?
+    public let name: String?
+    public let platform: String?
+    public let trustLevel: String
+    public let lastSeen: String?
+}
+
+public struct DeviceListPayload: Codable, Equatable, Sendable {
+    public let devices: [DeviceInfo]
+}
+
+public struct PairResultPayload: Codable, Equatable, Sendable {
+    public let success: Bool
+    public let deviceId: String?
+    public let error: String?
+}
+
+public struct PushStatusPayload: Codable, Equatable, Sendable {
+    public let subscribed: Bool
+}