herdr-remote-relay 0.3.18 → 0.3.19

package/dist/protocol/messages.d.ts

@@ -9,13 +9,18 @@ export declare const CAPABILITY: {
     readonly idleHeartbeat: "idle_heartbeat";
     /** The host routes output by 16-bit stream index (v2 frames). */
     readonly binaryFrameV2: "binary_frame_v2";
+    /** The host can route elevated Windows PTYs through its local broker. */
+    readonly adminSessions: "admin_sessions";
 };
 export type ClientRole = 'controller' | 'viewer';
+export type HostShellProfile = 'posix' | 'cmd' | 'powershell' | 'git-bash';
 export interface ClientHelloMessage {
     type: 'hello';
     protocol: 1;
     token?: string;
     pairCode?: string;
+    /** Open this window's PTY through the host's pre-authorized admin broker. */
+    adminTerminal?: boolean;
     clientId: string;
     cols: number;
     rows: number;
@@ -73,6 +78,10 @@ export interface ServerReadyMessage {
     controllerId?: string | null;
     hostId?: string;
     hostname?: string;
+    platform?: string;
+    shellProfile?: HostShellProfile;
+    /** The relay and Windows host both understand administrator-terminal requests. */
+    adminTerminalSupported?: boolean;
     clientId?: string;
     terminalPalette?: HostTerminalPalette | null;
     terminalFont?: HostTerminalFont | null;
@@ -110,6 +119,9 @@ export interface ServerSessionRestartedMessage {
     cols?: number;
     rows?: number;
     hostname?: string;
+    platform?: string;
+    shellProfile?: HostShellProfile;
+    adminTerminalSupported?: boolean;
     terminalPalette?: HostTerminalPalette | null;
     terminalFont?: HostTerminalFont | null;
 }
@@ -210,6 +222,7 @@ export interface HostHelloMessage {
     password?: string | null;
     hostname?: string;
     platform?: string;
+    shellProfile?: HostShellProfile;
     arch?: string;
     terminalPalette?: HostTerminalPalette | null;
     terminalFont?: HostTerminalFont | null;
@@ -278,6 +291,7 @@ export interface RelaySessionStartMessage extends StreamAddressed {
     cols: number;
     rows: number;
     role: ClientRole;
+    adminTerminal?: boolean;
     /** Present when the host negotiated v2 frames and an index was free. */
     streamIndex?: number;
 }

package/dist/protocol/messages.js

@@ -15,4 +15,6 @@ export const CAPABILITY = {
     idleHeartbeat: 'idle_heartbeat',
     /** The host routes output by 16-bit stream index (v2 frames). */
     binaryFrameV2: 'binary_frame_v2',
+    /** The host can route elevated Windows PTYs through its local broker. */
+    adminSessions: 'admin_sessions',
 };

package/dist/server/client-channel.js

@@ -86,6 +86,7 @@ export function handleClientConnection(relay, ws, req) {
                 // Stable per browser profile; used to recognise a reconnect from the
                 // same browser rather than a genuinely separate viewer.
                 browserClientId: typeof message.clientId === 'string' ? message.clientId.slice(0, 128) : null,
+                adminTerminal: message.adminTerminal === true,
                 handoffCapable: Array.isArray(message.capabilities) &&
                     message.capabilities.includes(CAPABILITY.hostHandoff),
                 session: null,
@@ -136,6 +137,9 @@ export function handleClientConnection(relay, ws, req) {
                 controllerId: null,
                 hostId: host.id,
                 hostname: host.hostname,
+                platform: host.platform,
+                ...(host.shellProfile ? { shellProfile: host.shellProfile } : {}),
+                adminTerminalSupported: host.adminSessionsAvailable,
                 clientId: client.id,
                 // Delivered with `ready`, before the first PTY byte, so the terminal
                 // is painted in the host's colors from its very first frame.

package/dist/server/host-channel.js

@@ -15,6 +15,8 @@ function createHostRecord(message, ws, pending, clients = new Set()) {
         ws,
         hostname: typeof message.hostname === 'string' ? message.hostname.slice(0, 128) : os.hostname(),
         platform: typeof message.platform === 'string' ? message.platform.slice(0, 32) : process.platform,
+        ...(message.shellProfile === 'git-bash' ? { shellProfile: message.shellProfile } : {}),
+        adminSessionsAvailable: capabilities.includes(CAPABILITY.adminSessions),
         arch: typeof message.arch === 'string' ? message.arch.slice(0, 32) : process.arch,
         connectedAt: new Date(pending.connectedAt).toISOString(),
         connectedAtMs: pending.connectedAt,

package/dist/server/sessions.js

@@ -34,6 +34,14 @@ export function releaseSession(relay, host, client) {
 export function startSession(relay, host, client, { restarted = false } = {}) {
     if (!client || !isOpen(host.ws))
         return;
+    if (client.adminTerminal && !host.adminSessionsAvailable) {
+        jsonSend(client.ws, {
+            type: 'error',
+            code: 'admin_terminal_unsupported',
+            message: 'Update the host connector to support administrator terminals.',
+        });
+        return;
+    }
     const streamId = randomId('session');
     let streamIndex = null;
     if (host.binaryFrameV2) {
@@ -57,6 +65,7 @@ export function startSession(relay, host, client, { restarted = false } = {}) {
         cols: Math.max(MIN_SESSION_COLS, client.cols),
         rows: Math.max(MIN_SESSION_ROWS, client.rows),
         role: 'controller',
+        ...(client.adminTerminal ? { adminTerminal: true } : {}),
         ...(streamIndex !== null ? { streamIndex } : {}),
     });
     if (restarted) {
@@ -66,6 +75,9 @@ export function startSession(relay, host, client, { restarted = false } = {}) {
             cols: client.cols,
             rows: client.rows,
             hostname: host.hostname,
+            platform: host.platform,
+            ...(host.shellProfile ? { shellProfile: host.shellProfile } : {}),
+            adminTerminalSupported: host.adminSessionsAvailable,
             terminalPalette: host.terminalPalette || null,
             terminalFont: host.terminalFont || null,
         });

package/dist/server/types.d.ts

@@ -1,7 +1,7 @@
 import type { WebSocket } from 'ws';
 import type { AuthStore } from '../auth-store.js';
 import type { RelayMetrics } from '../metrics.js';
-import type { ClientRole, HostPtySummary, ServerAgentStatusMessage, ServerUpdateStatusMessage } from '../protocol/messages.js';
+import type { ClientRole, HostPtySummary, ServerAgentStatusMessage, ServerUpdateStatusMessage, HostShellProfile } from '../protocol/messages.js';
 import type { HostTerminalFont, HostTerminalPalette } from '../protocol/terminal.js';
 import type { RelayConfig } from '../relay-config.js';
 /** A WebSocket plus the liveness flag the heartbeat keeps on it. */
@@ -23,6 +23,8 @@ export interface RelayHost {
     ws: RelaySocket | null;
     hostname: string;
     platform: string;
+    shellProfile?: HostShellProfile;
+    adminSessionsAvailable: boolean;
     arch: string;
     connectedAt: string;
     connectedAtMs: number;
@@ -57,6 +59,7 @@ export interface RelayClient {
     deviceId: string;
     /** Stable per browser profile, supplied by the browser itself. */
     browserClientId: string | null;
+    adminTerminal: boolean;
     handoffCapable: boolean;
     session: ClientSession | null;
     role: ClientRole;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "herdr-remote-relay",
-  "version": "0.3.18",
+  "version": "0.3.19",
   "description": "Standalone relay server and web terminal for Herdr Remote",
   "license": "MIT",
   "type": "module",