@kdonev/termscape 0.1.0

package/dist/protocol/ws.d.ts

@@ -0,0 +1,416 @@
+import { z } from 'zod';
+export declare const BinaryFrameKind: {
+    readonly PtyOutput: 1;
+    readonly PtyInput: 2;
+};
+export type BinaryFrameKind = (typeof BinaryFrameKind)[keyof typeof BinaryFrameKind];
+export declare function encodeBinaryFrame(kind: BinaryFrameKind, sessionId: string, payload: Uint8Array): Uint8Array;
+export interface DecodedBinaryFrame {
+    kind: number;
+    sessionId: string;
+    payload: Uint8Array;
+}
+export declare function decodeBinaryFrame(buf: Uint8Array): DecodedBinaryFrame;
+export declare const ClientMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    t: z.ZodLiteral<"hello">;
+    token: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"attach">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"detach">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"resize">;
+    sessionId: z.ZodString;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"createWorkspace">;
+    name: z.ZodString;
+    rootPath: z.ZodString;
+    hostId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"removeWorkspace">;
+    workspaceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"startSession">;
+    workspaceId: z.ZodString;
+    profile: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"stopSession">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"removeSession">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"resumeSession">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"resumeWorkspace">;
+    workspaceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"moveWindow">;
+    sessionId: z.ZodString;
+    rect: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+        z: z.ZodNumber;
+        collapsed: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"setViewport">;
+    viewport: z.ZodObject<{
+        panX: z.ZodNumber;
+        panY: z.ZodNumber;
+        zoom: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"addHost">;
+    label: z.ZodString;
+    sshHost: z.ZodString;
+    sshUser: z.ZodString;
+    sshPort: z.ZodDefault<z.ZodNumber>;
+    privateKeyPath: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"removeHost">;
+    hostId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"connectHost">;
+    hostId: z.ZodString;
+}, z.core.$strip>], "t">;
+export type ClientMsg = z.infer<typeof ClientMsg>;
+export declare const HubState: z.ZodObject<{
+    hubVersion: z.ZodString;
+    enrollUrl: z.ZodNullable<z.ZodString>;
+    enrollAltUrl: z.ZodNullable<z.ZodString>;
+    hosts: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            ssh: "ssh";
+            enrolled: "enrolled";
+        }>>;
+        sshHost: z.ZodNullable<z.ZodString>;
+        sshUser: z.ZodNullable<z.ZodString>;
+        sshPort: z.ZodDefault<z.ZodNumber>;
+        platform: z.ZodNullable<z.ZodString>;
+        hubVersion: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            error: "error";
+            disconnected: "disconnected";
+            connecting: "connecting";
+            connected: "connected";
+        }>;
+        lastSeenAt: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    workspaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            local: "local";
+            remote: "remote";
+        }>;
+        rootPath: z.ZodString;
+        hostId: z.ZodNullable<z.ZodString>;
+        color: z.ZodString;
+        createdAt: z.ZodNumber;
+        archivedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    sessions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        workspaceId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        profile: z.ZodString;
+        cwd: z.ZodString;
+        agentSessionUuid: z.ZodNullable<z.ZodString>;
+        spawnedBy: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            starting: "starting";
+            running: "running";
+            stopped: "stopped";
+            exited: "exited";
+            failed: "failed";
+        }>;
+        status: z.ZodEnum<{
+            idle: "idle";
+            busy: "busy";
+            unknown: "unknown";
+        }>;
+        statusText: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+        resumable: z.ZodBoolean;
+        createdAt: z.ZodNumber;
+        exitedAt: z.ZodNullable<z.ZodNumber>;
+        lastActiveAt: z.ZodNumber;
+        window: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+            z: z.ZodNumber;
+            collapsed: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>>;
+    messages: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        fromAddr: z.ZodString;
+        toAddr: z.ZodString;
+        body: z.ZodString;
+        sentAt: z.ZodNumber;
+        deliveredAt: z.ZodNullable<z.ZodNumber>;
+        deliveryState: z.ZodEnum<{
+            failed: "failed";
+            delivered: "delivered";
+        }>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    viewport: z.ZodObject<{
+        panX: z.ZodNumber;
+        panY: z.ZodNumber;
+        zoom: z.ZodNumber;
+    }, z.core.$strip>;
+    profiles: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        mcp: z.ZodBoolean;
+        resumable: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type HubState = z.infer<typeof HubState>;
+export declare const ServerMsg: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    t: z.ZodLiteral<"ready">;
+    state: z.ZodObject<{
+        hubVersion: z.ZodString;
+        enrollUrl: z.ZodNullable<z.ZodString>;
+        enrollAltUrl: z.ZodNullable<z.ZodString>;
+        hosts: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<{
+                ssh: "ssh";
+                enrolled: "enrolled";
+            }>>;
+            sshHost: z.ZodNullable<z.ZodString>;
+            sshUser: z.ZodNullable<z.ZodString>;
+            sshPort: z.ZodDefault<z.ZodNumber>;
+            platform: z.ZodNullable<z.ZodString>;
+            hubVersion: z.ZodNullable<z.ZodString>;
+            state: z.ZodEnum<{
+                error: "error";
+                disconnected: "disconnected";
+                connecting: "connecting";
+                connected: "connected";
+            }>;
+            lastSeenAt: z.ZodNullable<z.ZodNumber>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        workspaces: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            kind: z.ZodEnum<{
+                local: "local";
+                remote: "remote";
+            }>;
+            rootPath: z.ZodString;
+            hostId: z.ZodNullable<z.ZodString>;
+            color: z.ZodString;
+            createdAt: z.ZodNumber;
+            archivedAt: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        sessions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            workspaceId: z.ZodString;
+            name: z.ZodString;
+            address: z.ZodString;
+            profile: z.ZodString;
+            cwd: z.ZodString;
+            agentSessionUuid: z.ZodNullable<z.ZodString>;
+            spawnedBy: z.ZodNullable<z.ZodString>;
+            state: z.ZodEnum<{
+                starting: "starting";
+                running: "running";
+                stopped: "stopped";
+                exited: "exited";
+                failed: "failed";
+            }>;
+            status: z.ZodEnum<{
+                idle: "idle";
+                busy: "busy";
+                unknown: "unknown";
+            }>;
+            statusText: z.ZodNullable<z.ZodString>;
+            title: z.ZodNullable<z.ZodString>;
+            pid: z.ZodNullable<z.ZodNumber>;
+            exitCode: z.ZodNullable<z.ZodNumber>;
+            cols: z.ZodNumber;
+            rows: z.ZodNumber;
+            resumable: z.ZodBoolean;
+            createdAt: z.ZodNumber;
+            exitedAt: z.ZodNullable<z.ZodNumber>;
+            lastActiveAt: z.ZodNumber;
+            window: z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+                z: z.ZodNumber;
+                collapsed: z.ZodBoolean;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        messages: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            fromAddr: z.ZodString;
+            toAddr: z.ZodString;
+            body: z.ZodString;
+            sentAt: z.ZodNumber;
+            deliveredAt: z.ZodNullable<z.ZodNumber>;
+            deliveryState: z.ZodEnum<{
+                failed: "failed";
+                delivered: "delivered";
+            }>;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        viewport: z.ZodObject<{
+            panX: z.ZodNumber;
+            panY: z.ZodNumber;
+            zoom: z.ZodNumber;
+        }, z.core.$strip>;
+        profiles: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodString;
+            mcp: z.ZodBoolean;
+            resumable: z.ZodBoolean;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"sessionUpserted">;
+    session: z.ZodObject<{
+        id: z.ZodString;
+        workspaceId: z.ZodString;
+        name: z.ZodString;
+        address: z.ZodString;
+        profile: z.ZodString;
+        cwd: z.ZodString;
+        agentSessionUuid: z.ZodNullable<z.ZodString>;
+        spawnedBy: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            starting: "starting";
+            running: "running";
+            stopped: "stopped";
+            exited: "exited";
+            failed: "failed";
+        }>;
+        status: z.ZodEnum<{
+            idle: "idle";
+            busy: "busy";
+            unknown: "unknown";
+        }>;
+        statusText: z.ZodNullable<z.ZodString>;
+        title: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        cols: z.ZodNumber;
+        rows: z.ZodNumber;
+        resumable: z.ZodBoolean;
+        createdAt: z.ZodNumber;
+        exitedAt: z.ZodNullable<z.ZodNumber>;
+        lastActiveAt: z.ZodNumber;
+        window: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+            z: z.ZodNumber;
+            collapsed: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"sessionRemoved">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"workspaceUpserted">;
+    workspace: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            local: "local";
+            remote: "remote";
+        }>;
+        rootPath: z.ZodString;
+        hostId: z.ZodNullable<z.ZodString>;
+        color: z.ZodString;
+        createdAt: z.ZodNumber;
+        archivedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"workspaceRemoved">;
+    workspaceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"hostUpserted">;
+    host: z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<{
+            ssh: "ssh";
+            enrolled: "enrolled";
+        }>>;
+        sshHost: z.ZodNullable<z.ZodString>;
+        sshUser: z.ZodNullable<z.ZodString>;
+        sshPort: z.ZodDefault<z.ZodNumber>;
+        platform: z.ZodNullable<z.ZodString>;
+        hubVersion: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<{
+            error: "error";
+            disconnected: "disconnected";
+            connecting: "connecting";
+            connected: "connected";
+        }>;
+        lastSeenAt: z.ZodNullable<z.ZodNumber>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"hostRemoved">;
+    hostId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"hostLog">;
+    hostId: z.ZodString;
+    line: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"messageSent">;
+    message: z.ZodObject<{
+        id: z.ZodString;
+        fromAddr: z.ZodString;
+        toAddr: z.ZodString;
+        body: z.ZodString;
+        sentAt: z.ZodNumber;
+        deliveredAt: z.ZodNullable<z.ZodNumber>;
+        deliveryState: z.ZodEnum<{
+            failed: "failed";
+            delivered: "delivered";
+        }>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"snapshot">;
+    sessionId: z.ZodString;
+    serialized: z.ZodString;
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    t: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "t">;
+export type ServerMsg = z.infer<typeof ServerMsg>;
+//# sourceMappingURL=ws.d.ts.map

package/dist/protocol/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,eAAe;;;CAGlB,CAAC;AACX,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEzD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,GAClB,UAAU,CASZ;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,kBAAkB,CAOrE;AAMD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAwCpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAqBpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/protocol/ws.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+import { Host, Message, Session, Viewport, Workspace, WindowRect, AgentProfileInfo, } from './domain.js';
+/* ------------------------------------------------------------------ *
+ * Binary framing for PTY traffic.
+ *
+ * Control messages are JSON text frames; terminal bytes ride in binary
+ * frames so we never base64 the hot path. Layout:
+ *   [0]      frame kind
+ *   [1]      session id length (utf8 bytes, <= 255)
+ *   [2..n]   session id
+ *   [n..]    raw payload
+ * ------------------------------------------------------------------ */
+export const BinaryFrameKind = {
+    PtyOutput: 0x01,
+    PtyInput: 0x02,
+};
+export function encodeBinaryFrame(kind, sessionId, payload) {
+    const id = new TextEncoder().encode(sessionId);
+    if (id.length > 255)
+        throw new Error('session id too long for binary frame');
+    const out = new Uint8Array(2 + id.length + payload.length);
+    out[0] = kind;
+    out[1] = id.length;
+    out.set(id, 2);
+    out.set(payload, 2 + id.length);
+    return out;
+}
+export function decodeBinaryFrame(buf) {
+    if (buf.length < 2)
+        throw new Error('binary frame too short');
+    const kind = buf[0];
+    const idLen = buf[1];
+    if (buf.length < 2 + idLen)
+        throw new Error('binary frame truncated');
+    const sessionId = new TextDecoder().decode(buf.subarray(2, 2 + idLen));
+    return { kind, sessionId, payload: buf.subarray(2 + idLen) };
+}
+/* ------------------------------------------------------------------ *
+ * Control messages
+ * ------------------------------------------------------------------ */
+export const ClientMsg = z.discriminatedUnion('t', [
+    z.object({ t: z.literal('hello'), token: z.string() }),
+    // terminal attach / detach drives the LOD swap on the canvas
+    z.object({ t: z.literal('attach'), sessionId: z.string() }),
+    z.object({ t: z.literal('detach'), sessionId: z.string() }),
+    z.object({ t: z.literal('resize'), sessionId: z.string(), cols: z.number().int().positive(), rows: z.number().int().positive() }),
+    // workspaces
+    z.object({ t: z.literal('createWorkspace'), name: z.string().min(1), rootPath: z.string().min(1), hostId: z.string().nullable().optional() }),
+    z.object({ t: z.literal('removeWorkspace'), workspaceId: z.string() }),
+    // sessions
+    z.object({
+        t: z.literal('startSession'),
+        workspaceId: z.string(),
+        profile: z.string(),
+        name: z.string().optional(),
+        cwd: z.string().optional(),
+    }),
+    z.object({ t: z.literal('stopSession'), sessionId: z.string() }),
+    z.object({ t: z.literal('removeSession'), sessionId: z.string() }),
+    z.object({ t: z.literal('resumeSession'), sessionId: z.string() }),
+    z.object({ t: z.literal('resumeWorkspace'), workspaceId: z.string() }),
+    // canvas layout
+    z.object({ t: z.literal('moveWindow'), sessionId: z.string(), rect: WindowRect }),
+    z.object({ t: z.literal('setViewport'), viewport: Viewport }),
+    // hosts
+    z.object({
+        t: z.literal('addHost'),
+        label: z.string(),
+        sshHost: z.string(),
+        sshUser: z.string(),
+        sshPort: z.number().int().positive().default(22),
+        privateKeyPath: z.string().optional(),
+    }),
+    z.object({ t: z.literal('removeHost'), hostId: z.string() }),
+    z.object({ t: z.literal('connectHost'), hostId: z.string() }),
+]);
+export const HubState = z.object({
+    hubVersion: z.string(),
+    /**
+     * Where another machine can reach this hub's join page, or null when the
+     * hub is bound to loopback and nothing else can see it.
+     */
+    enrollUrl: z.string().nullable(),
+    /**
+     * The same page by IP, when the primary uses this machine's name. A name
+     * only resolves if the other machine's network can resolve it, so the
+     * numeric form is always offered rather than assumed unnecessary.
+     */
+    enrollAltUrl: z.string().nullable(),
+    hosts: z.array(Host),
+    workspaces: z.array(Workspace),
+    sessions: z.array(Session),
+    messages: z.array(Message),
+    viewport: Viewport,
+    profiles: z.array(AgentProfileInfo),
+});
+export const ServerMsg = z.discriminatedUnion('t', [
+    z.object({ t: z.literal('ready'), state: HubState }),
+    z.object({ t: z.literal('sessionUpserted'), session: Session }),
+    z.object({ t: z.literal('sessionRemoved'), sessionId: z.string() }),
+    z.object({ t: z.literal('workspaceUpserted'), workspace: Workspace }),
+    z.object({ t: z.literal('workspaceRemoved'), workspaceId: z.string() }),
+    z.object({ t: z.literal('hostUpserted'), host: Host }),
+    z.object({ t: z.literal('hostRemoved'), hostId: z.string() }),
+    // Deploy progress. A remote install rebuilds native modules and takes
+    // minutes; without this the panel is a frozen button.
+    z.object({ t: z.literal('hostLog'), hostId: z.string(), line: z.string() }),
+    z.object({ t: z.literal('messageSent'), message: Message }),
+    // sent on attach: serialized screen, replayed before the live stream
+    z.object({
+        t: z.literal('snapshot'),
+        sessionId: z.string(),
+        serialized: z.string(),
+        cols: z.number(),
+        rows: z.number(),
+    }),
+    z.object({ t: z.literal('error'), message: z.string(), sessionId: z.string().optional() }),
+]);
+//# sourceMappingURL=ws.js.map

package/dist/protocol/ws.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.js","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"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"}

package/dist/remote/deployer.d.ts

@@ -0,0 +1,78 @@
+import { type Server as NetServer } from 'node:net';
+import { Client as SshClient } from 'ssh2';
+/**
+ * Provisions and reaches a hub on a remote machine.
+ *
+ * The chosen model is a daemon on the remote host rather than an `ssh`
+ * subprocess per terminal, so remote sessions survive the SSH link dropping.
+ * That costs a deploy step, which is what most of this file is.
+ *
+ * The remote hub always binds 127.0.0.1 on its own machine. It is reachable
+ * only through the tunnel opened here, so it is never exposed on a network
+ * interface even briefly.
+ */
+export interface HostCredentials {
+    sshHost: string;
+    sshUser: string;
+    sshPort: number;
+    privateKeyPath?: string;
+    passphrase?: string;
+}
+export interface DeployResult {
+    /** Loopback URL on *this* machine that tunnels to the remote hub. */
+    localUrl: string;
+    remotePort: number;
+    remoteHubVersion: string;
+    /** Close the tunnel and the SSH connection. */
+    dispose: () => Promise<void>;
+}
+export interface DeployOptions extends HostCredentials {
+    /** Token the remote hub will require on its /peer endpoint. */
+    token: string;
+    /** Local tarball produced by `npm pack`, uploaded when the remote is stale. */
+    packagePath?: string;
+    expectedVersion: string;
+    /** Where the hub lives on the remote machine. */
+    remoteDir?: string;
+    log?: (line: string) => void;
+}
+export declare function sshConnect(c: HostCredentials): Promise<SshClient>;
+export interface ExecResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function exec(conn: SshClient, command: string): Promise<ExecResult>;
+export interface Probe {
+    nodeVersion: string | null;
+    nodeMajor: number;
+    installedVersion: string | null;
+}
+/** What is already on the remote machine, before we change anything. */
+export declare function probe(conn: SshClient, remoteDir?: string): Promise<Probe>;
+/**
+ * Install or upgrade the hub on the remote machine. Native modules are rebuilt
+ * there, because node-pty and better-sqlite3 prebuilds are per platform and
+ * per architecture and the remote is frequently neither.
+ */
+export declare function provision(conn: SshClient, opts: DeployOptions): Promise<void>;
+/**
+ * Start the remote hub detached, so it outlives this SSH session — the whole
+ * reason for running a daemon instead of an ssh subprocess.
+ */
+export declare function startRemoteHub(conn: SshClient, opts: DeployOptions): Promise<{
+    port: number;
+    version: string;
+}>;
+/**
+ * Local TCP listener that pipes every connection through the SSH channel to
+ * the remote hub's loopback port. Gives us a plain ws:// URL to hand the peer
+ * client, which keeps SSH entirely out of the peer protocol.
+ */
+export declare function openTunnel(conn: SshClient, remotePort: number): Promise<{
+    localPort: number;
+    server: NetServer;
+}>;
+/** Probe, provision if needed, start, and tunnel. */
+export declare function deploy(opts: DeployOptions): Promise<DeployResult>;
+//# sourceMappingURL=deployer.d.ts.map

package/dist/remote/deployer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployer.d.ts","sourceRoot":"","sources":["../../src/remote/deployer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,IAAI,SAAS,EAAE,MAAM,UAAU,CAAC;AAGlE,OAAO,EAAE,MAAM,IAAI,SAAS,EAAsB,MAAM,MAAM,CAAC;AAE/D;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAsBD,wBAAgB,UAAU,CAAC,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAOjE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAW1E;AAED,MAAM,WAAW,KAAK;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,wEAAwE;AACxE,wBAAsB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,SAAqB,GAAG,OAAO,CAAC,KAAK,CAAC,CAW3F;AAWD;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqC5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,CAqBnD;AAED,qDAAqD;AACrD,wBAAsB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAqCvE"}