@workerdeck/relay-client 3.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tobias Strebitzer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,40 @@
+# @workerdeck/relay-client
+
+The gateway side of the WorkerDeck relay: the relay wire frames, `connectRelay` (dial out, auth,
+heartbeat, reconnect with backoff), the diffing session-registry publisher, and the request
+routing that lets agents on separate gateways list, peek at and message each other.
+
+Part of [WorkerDeck](https://github.com/workerdeck/workerdeck). You rarely use it directly: set the
+`relay` option on [`@workerdeck/server`](https://www.npmjs.com/package/@workerdeck/server) (or in
+`workerdeck.config.mjs`) and the gateway connects on its own. The relay itself is
+[`@workerdeck/relay`](https://www.npmjs.com/package/@workerdeck/relay).
+
+## Install
+
+```bash
+npm install @workerdeck/relay-client
+```
+
+## Usage
+
+```ts
+import { connectRelay } from '@workerdeck/relay-client'
+
+const relay = connectRelay(
+  { url: 'ws://relay.local:7777', gateway: 'mac-mini', key: process.env.RELAY_KEY!, allow: ['send', 'peek'] },
+  {
+    snapshot: async () => sessions(), // every session this gateway publishes
+    peek: async (origin, sessionId, recent) => peekLocal(sessionId, recent),
+    send: async (origin, sessionId, text) => deliverLocal(origin, sessionId, text),
+  },
+)
+
+const rows = await relay.list('my-session-id')
+```
+
+See the [cross-gateway peers guide](https://workerdeck.github.io/workerdeck/guides/cross-gateway-peers/).
+
+## License
+
+MIT © Tobias Strebitzer - see
+[LICENSE](https://github.com/workerdeck/workerdeck/blob/master/LICENSE).

package/build/index.d.mts

@@ -0,0 +1,213 @@
+import { ContextReading, ProfileEngine, SessionStatus } from "@workerdeck/protocol";
+//#region src/frames.d.ts
+declare const RELAY_WIRE_VERSION = 1;
+declare const RELAY_OPS: readonly ["send", "peek"];
+type RelayOp = (typeof RELAY_OPS)[number];
+declare const RELAY_CLOSE: {
+  readonly badHello: 4400;
+  readonly unauthorized: 4401;
+  readonly revoked: 4403;
+  readonly versionMismatch: 4426;
+  readonly replaced: 4409;
+  readonly timeout: 4408;
+};
+declare const RELAY_FRAME_MAX_BYTES: number;
+declare const RELAY_MESSAGE_MAX_CHARS = 16000;
+declare const RELAY_MAX_HOPS = 12;
+declare const RELAY_GATEWAY_NAME: RegExp;
+type RelaySessionEntry = {
+  id: string;
+  engine?: ProfileEngine;
+  status: SessionStatus;
+  title?: string;
+  project?: {
+    name: string;
+    root: string;
+  };
+  cwd: string;
+  profile?: string;
+  model?: string;
+  permissionMode?: string;
+  contextUsage?: ContextReading;
+  checklist?: {
+    done: number;
+    total: number;
+  };
+  numTurns?: number;
+  createdAt: number;
+  lastActivityAt?: number;
+  pendingPermissionCount: number;
+  live: boolean;
+};
+type RelayPeerRow = RelaySessionEntry & {
+  gateway: string;
+  allow: RelayOp[];
+};
+type RelayOrigin = {
+  gateway: string;
+  sessionId: string;
+  name?: string;
+  engine?: ProfileEngine;
+  hops: string[];
+};
+type RelayPeek = RelaySessionEntry & {
+  checklistItems?: Array<{
+    text: string;
+    status: string;
+  }>;
+  pendingApprovals: string[];
+  recent: string[];
+};
+type RelaySendResult = {
+  delivered: true;
+  sessionId: string;
+  name?: string;
+  queued: boolean;
+} | {
+  delivered: false;
+  reason: string;
+};
+type RelayTarget = {
+  gateway: string;
+  id: string;
+};
+type HelloFrame = {
+  t: 'hello';
+  gateway: string;
+  key: string;
+  version: number;
+  ceiling: {
+    ops: RelayOp[];
+  };
+};
+type WelcomeFrame = {
+  t: 'welcome';
+  relayVersion: number;
+};
+type SnapshotFrame = {
+  t: 'registry.snapshot';
+  seq: number;
+  entries: RelaySessionEntry[];
+};
+type DeltaFrame = {
+  t: 'registry.delta';
+  seq: number;
+  upsert: RelaySessionEntry[];
+  remove: string[];
+};
+type DigestFrame = {
+  t: 'registry.digest';
+  seq: number;
+  count: number;
+  hash: string;
+};
+type ResyncFrame = {
+  t: 'registry.resync';
+};
+type ListRequest = {
+  t: 'peer.list';
+  id: string;
+  from: string;
+};
+type PeekRequest = {
+  t: 'peer.peek';
+  id: string;
+  from: string;
+  to: RelayTarget;
+  recent?: number;
+};
+type SendRequest = {
+  t: 'peer.send';
+  id: string;
+  from: string;
+  to: RelayTarget;
+  text: string;
+  hops: string[];
+};
+type InboundPeek = {
+  t: 'peer.peek';
+  id: string;
+  origin: RelayOrigin;
+  to: string;
+  recent?: number;
+};
+type InboundSend = {
+  t: 'peer.send';
+  id: string;
+  origin: RelayOrigin;
+  to: string;
+  text: string;
+};
+type ResponseFrame = {
+  t: 'res';
+  id: string;
+  ok: true;
+  result: unknown;
+} | {
+  t: 'res';
+  id: string;
+  ok: false;
+  error: string;
+};
+type GatewayFrame = HelloFrame | SnapshotFrame | DeltaFrame | DigestFrame | ListRequest | PeekRequest | SendRequest | ResponseFrame;
+type RelayFrame = WelcomeFrame | ResyncFrame | InboundPeek | InboundSend | ResponseFrame;
+declare function encodeFrame(frame: GatewayFrame | RelayFrame): string;
+declare function decodeFrame(raw: unknown): {
+  t: string;
+  [key: string]: unknown;
+} | undefined;
+declare function isRelayOp(value: unknown): value is RelayOp;
+declare function relayPeerId(gateway: string, sessionId: string): string;
+declare function parseRelayPeerId(id: string): RelayTarget | undefined;
+//#endregion
+//#region src/registry.d.ts
+declare function canonicalJson(value: unknown): string;
+declare function registryHash(entries: Iterable<[string, string]>): string;
+declare function digestOf(entries: readonly RelaySessionEntry[]): {
+  count: number;
+  hash: string;
+};
+type RegistryPublisher = {
+  snapshot(entries: readonly RelaySessionEntry[]): SnapshotFrame;
+  delta(entries: readonly RelaySessionEntry[]): DeltaFrame | undefined;
+  digest(): DigestFrame;
+};
+declare function createRegistryPublisher(): RegistryPublisher;
+//#endregion
+//#region src/connection.d.ts
+type RelayHost = {
+  snapshot(): Promise<RelaySessionEntry[]>;
+  peek(origin: RelayOrigin, sessionId: string, recent?: number): Promise<RelayPeek | undefined>;
+  send(origin: RelayOrigin, sessionId: string, text: string): Promise<RelaySendResult>;
+};
+type RelayConnectOptions = {
+  url: string;
+  gateway: string;
+  key: string;
+  allow?: readonly RelayOp[];
+  ca?: string | Buffer;
+  tickMs?: number;
+  digestMs?: number;
+  heartbeatMs?: number;
+  requestTimeoutMs?: number;
+  backoffMinMs?: number;
+  backoffMaxMs?: number;
+  log?: (message: string) => void;
+};
+type RelayState = 'connecting' | 'online' | 'offline' | 'stopped';
+type RelayConnection = {
+  state(): RelayState;
+  list(from: string): Promise<RelayPeerRow[]>;
+  peek(from: string, to: RelayTarget, recent?: number): Promise<RelayPeek | undefined>;
+  send(from: string, to: RelayTarget, text: string, hops: string[]): Promise<RelaySendResult>;
+  nudge(): void;
+  setHost(host: RelayHost): void;
+  close(): void;
+};
+declare class RelayUnavailableError extends Error {
+  constructor(message?: string);
+}
+declare function connectRelay(options: RelayConnectOptions, initialHost: RelayHost): RelayConnection;
+//#endregion
+export { DeltaFrame, DigestFrame, GatewayFrame, HelloFrame, InboundPeek, InboundSend, ListRequest, PeekRequest, RELAY_CLOSE, RELAY_FRAME_MAX_BYTES, RELAY_GATEWAY_NAME, RELAY_MAX_HOPS, RELAY_MESSAGE_MAX_CHARS, RELAY_OPS, RELAY_WIRE_VERSION, RegistryPublisher, RelayConnectOptions, RelayConnection, RelayFrame, RelayHost, RelayOp, RelayOrigin, RelayPeek, RelayPeerRow, RelaySendResult, RelaySessionEntry, RelayState, RelayTarget, RelayUnavailableError, ResponseFrame, ResyncFrame, SendRequest, SnapshotFrame, WelcomeFrame, canonicalJson, connectRelay, createRegistryPublisher, decodeFrame, digestOf, encodeFrame, isRelayOp, parseRelayPeerId, registryHash, relayPeerId };
+//# sourceMappingURL=index.d.mts.map

package/build/index.mjs

@@ -0,0 +1,381 @@
+import { createHash } from "node:crypto";
+import { WebSocket } from "ws";
+//#region src/frames.ts
+const RELAY_WIRE_VERSION = 1;
+const RELAY_OPS = ["send", "peek"];
+const RELAY_CLOSE = {
+	badHello: 4400,
+	unauthorized: 4401,
+	revoked: 4403,
+	versionMismatch: 4426,
+	replaced: 4409,
+	timeout: 4408
+};
+const RELAY_FRAME_MAX_BYTES = 4194304;
+const RELAY_MESSAGE_MAX_CHARS = 16e3;
+const RELAY_MAX_HOPS = 12;
+const RELAY_GATEWAY_NAME = /^[a-z0-9][a-z0-9-]{0,62}$/;
+function encodeFrame(frame) {
+	return JSON.stringify(frame);
+}
+function decodeFrame(raw) {
+	const text = typeof raw === "string" ? raw : raw instanceof Buffer ? raw.toString("utf8") : void 0;
+	if (text === void 0) return;
+	try {
+		const value = JSON.parse(text);
+		if (typeof value !== "object" || value === null || Array.isArray(value) || typeof value.t !== "string") return;
+		return value;
+	} catch {
+		return;
+	}
+}
+function isRelayOp(value) {
+	return value === "send" || value === "peek";
+}
+function relayPeerId(gateway, sessionId) {
+	return `${gateway}:${sessionId}`;
+}
+function parseRelayPeerId(id) {
+	const at = id.indexOf(":");
+	if (at <= 0 || at === id.length - 1) return;
+	const gateway = id.slice(0, at);
+	return RELAY_GATEWAY_NAME.test(gateway) ? {
+		gateway,
+		id: id.slice(at + 1)
+	} : void 0;
+}
+//#endregion
+//#region src/registry.ts
+function canonicalJson(value) {
+	if (Array.isArray(value)) return `[${value.map(canonicalJson).join(",")}]`;
+	if (value !== null && typeof value === "object") return `{${Object.keys(value).filter((key) => value[key] !== void 0).sort().map((key) => `${JSON.stringify(key)}:${canonicalJson(value[key])}`).join(",")}}`;
+	return JSON.stringify(value);
+}
+function registryHash(entries) {
+	const hash = createHash("sha256");
+	for (const [id, json] of [...entries].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0)) hash.update(id).update("\n").update(json).update("\n");
+	return hash.digest("base64url");
+}
+function digestOf(entries) {
+	return {
+		count: entries.length,
+		hash: registryHash(entries.map((entry) => [entry.id, canonicalJson(entry)]))
+	};
+}
+function createRegistryPublisher() {
+	let sent = /* @__PURE__ */ new Map();
+	let seq = 0;
+	const index = (entries) => new Map(entries.map((entry) => [entry.id, canonicalJson(entry)]));
+	return {
+		snapshot(entries) {
+			sent = index(entries);
+			seq += 1;
+			return {
+				t: "registry.snapshot",
+				seq,
+				entries: [...entries]
+			};
+		},
+		delta(entries) {
+			const next = index(entries);
+			const upsert = entries.filter((entry) => sent.get(entry.id) !== next.get(entry.id));
+			const remove = [...sent.keys()].filter((id) => !next.has(id));
+			if (upsert.length === 0 && remove.length === 0) return;
+			sent = next;
+			seq += 1;
+			return {
+				t: "registry.delta",
+				seq,
+				upsert,
+				remove
+			};
+		},
+		digest() {
+			return {
+				t: "registry.digest",
+				seq,
+				count: sent.size,
+				hash: registryHash(sent)
+			};
+		}
+	};
+}
+//#endregion
+//#region src/connection.ts
+var RelayUnavailableError = class extends Error {
+	constructor(message = "remote gateways unavailable") {
+		super(message);
+		this.name = "RelayUnavailableError";
+	}
+};
+const TERMINAL_CLOSES = /* @__PURE__ */ new Map([
+	[RELAY_CLOSE.unauthorized, "the relay refused this gateway key"],
+	[RELAY_CLOSE.revoked, "this gateway is not enrolled at the relay"],
+	[RELAY_CLOSE.versionMismatch, "the relay speaks a different wire version"],
+	[RELAY_CLOSE.badHello, "the relay refused the hello frame"]
+]);
+function connectRelay(options, initialHost) {
+	const tickMs = options.tickMs ?? 2e3;
+	const digestMs = options.digestMs ?? 3e4;
+	const heartbeatMs = options.heartbeatMs ?? 15e3;
+	const requestTimeoutMs = options.requestTimeoutMs ?? 1e4;
+	const backoffMin = options.backoffMinMs ?? 1e3;
+	const backoffMax = options.backoffMaxMs ?? 6e4;
+	const allow = new Set((options.allow ?? RELAY_OPS).filter(isRelayOp));
+	const log = options.log ?? (() => {});
+	let host = initialHost;
+	let state = "connecting";
+	let socket;
+	let attempt = 0;
+	let reconnectTimer;
+	let tickTimer;
+	let digestTimer;
+	let heartbeatTimer;
+	let lastHeard = 0;
+	let ticking = false;
+	let tickAgain = false;
+	let nextId = 0;
+	let lastTerminal;
+	let publisher = createRegistryPublisher();
+	const pending = /* @__PURE__ */ new Map();
+	const sendFrame = (frame) => {
+		if (socket?.readyState === WebSocket.OPEN) socket.send(encodeFrame(frame));
+	};
+	const failPending = (reason) => {
+		for (const [id, entry] of pending) {
+			clearTimeout(entry.timer);
+			entry.reject(new RelayUnavailableError(reason));
+			pending.delete(id);
+		}
+	};
+	const stopTimers = () => {
+		clearInterval(tickTimer);
+		clearInterval(digestTimer);
+		clearInterval(heartbeatTimer);
+		tickTimer = digestTimer = heartbeatTimer = void 0;
+	};
+	const publishSnapshot = async () => {
+		const entries = await host.snapshot();
+		if (state === "online") sendFrame(publisher.snapshot(entries));
+	};
+	const tick = async () => {
+		if (state !== "online") return;
+		if (ticking) {
+			tickAgain = true;
+			return;
+		}
+		ticking = true;
+		try {
+			const entries = await host.snapshot();
+			const delta = state === "online" ? publisher.delta(entries) : void 0;
+			if (delta) sendFrame(delta);
+		} catch (error) {
+			log(`relay: registry tick failed: ${error instanceof Error ? error.message : String(error)}`);
+		} finally {
+			ticking = false;
+			if (tickAgain) {
+				tickAgain = false;
+				tick();
+			}
+		}
+	};
+	const answer = async (id, work) => {
+		try {
+			sendFrame({
+				t: "res",
+				id,
+				ok: true,
+				result: await work() ?? null
+			});
+		} catch (error) {
+			sendFrame({
+				t: "res",
+				id,
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	};
+	const onInbound = (frame) => {
+		const id = typeof frame.id === "string" ? frame.id : void 0;
+		const origin = frame.origin;
+		const to = typeof frame.to === "string" ? frame.to : void 0;
+		if (!id || !origin || typeof origin.gateway !== "string" || typeof origin.sessionId !== "string" || !to) return;
+		const hops = Array.isArray(origin.hops) ? origin.hops.filter((hop) => typeof hop === "string") : [];
+		const stamped = {
+			...origin,
+			hops
+		};
+		if (frame.t === "peer.peek") {
+			if (!allow.has("peek")) {
+				answer(id, async () => null);
+				return;
+			}
+			const recent = typeof frame.recent === "number" ? frame.recent : void 0;
+			answer(id, () => host.peek(stamped, to, recent));
+			return;
+		}
+		if (frame.t === "peer.send") {
+			if (!allow.has("send")) {
+				answer(id, async () => ({
+					delivered: false,
+					reason: `no such session: ${to}`
+				}));
+				return;
+			}
+			const text = typeof frame.text === "string" ? frame.text : "";
+			answer(id, () => host.send(stamped, to, text));
+		}
+	};
+	const onFrame = (raw) => {
+		lastHeard = Date.now();
+		const frame = decodeFrame(Array.isArray(raw) ? Buffer.concat(raw) : raw instanceof ArrayBuffer ? Buffer.from(raw) : raw);
+		if (!frame) return;
+		switch (frame.t) {
+			case "welcome":
+				if (state !== "connecting") return;
+				state = "online";
+				attempt = 0;
+				lastTerminal = void 0;
+				log(`relay: connected to ${options.url} as ${options.gateway}`);
+				publisher = createRegistryPublisher();
+				publishSnapshot().catch((error) => log(`relay: snapshot failed: ${error instanceof Error ? error.message : String(error)}`));
+				tickTimer = setInterval(() => void tick(), tickMs);
+				digestTimer = setInterval(() => sendFrame(publisher.digest()), digestMs);
+				return;
+			case "registry.resync":
+				publishSnapshot().catch(() => {});
+				return;
+			case "res": {
+				const id = typeof frame.id === "string" ? frame.id : "";
+				const entry = pending.get(id);
+				if (!entry) return;
+				pending.delete(id);
+				clearTimeout(entry.timer);
+				if (frame.ok === true) entry.resolve(frame.result);
+				else entry.reject(new Error(typeof frame.error === "string" ? frame.error : "relay request failed"));
+				return;
+			}
+			case "peer.peek":
+			case "peer.send":
+				if (state === "online") onInbound(frame);
+				return;
+		}
+	};
+	const scheduleReconnect = () => {
+		if (state === "stopped") return;
+		attempt += 1;
+		const ceiling = lastTerminal !== void 0 ? backoffMax : Math.min(backoffMax, backoffMin * 2 ** (attempt - 1));
+		const delay = Math.round(ceiling / 2 + Math.random() * (ceiling / 2));
+		reconnectTimer = setTimeout(dial, delay);
+	};
+	const onClose = (code, reason) => {
+		stopTimers();
+		socket = void 0;
+		failPending("remote gateways unavailable");
+		if (state === "stopped") return;
+		const wasOnline = state === "online";
+		state = "offline";
+		const terminal = TERMINAL_CLOSES.get(code);
+		if (terminal) {
+			if (lastTerminal !== code) log(`relay: ${terminal}${reason ? ` (${reason})` : ""}; retrying every ${Math.round(backoffMax / 1e3)}s`);
+			lastTerminal = code;
+		} else if (wasOnline) log(`relay: connection lost (${code}${reason ? ` ${reason}` : ""}); reconnecting`);
+		scheduleReconnect();
+	};
+	function dial() {
+		reconnectTimer = void 0;
+		if (state === "stopped") return;
+		state = "connecting";
+		const ws = new WebSocket(options.url, {
+			maxPayload: RELAY_FRAME_MAX_BYTES,
+			handshakeTimeout: requestTimeoutMs,
+			ca: options.ca
+		});
+		socket = ws;
+		lastHeard = Date.now();
+		ws.on("open", () => {
+			sendFrame({
+				t: "hello",
+				gateway: options.gateway,
+				key: options.key,
+				version: 1,
+				ceiling: { ops: [...allow] }
+			});
+			heartbeatTimer = setInterval(() => {
+				if (Date.now() - lastHeard > heartbeatMs * 2 + 1e3) {
+					ws.terminate();
+					return;
+				}
+				ws.ping();
+			}, heartbeatMs);
+		});
+		ws.on("message", onFrame);
+		ws.on("pong", () => {
+			lastHeard = Date.now();
+		});
+		ws.on("ping", () => {
+			lastHeard = Date.now();
+		});
+		ws.on("error", () => {});
+		ws.on("close", (code, reason) => {
+			if (socket === ws) onClose(code, reason.toString("utf8"));
+		});
+	}
+	const request = (frame) => {
+		if (state !== "online") return Promise.reject(new RelayUnavailableError());
+		return new Promise((resolve, reject) => {
+			const timer = setTimeout(() => {
+				pending.delete(frame.id);
+				reject(new RelayUnavailableError("the relay did not answer in time"));
+			}, requestTimeoutMs);
+			pending.set(frame.id, {
+				resolve,
+				reject,
+				timer
+			});
+			sendFrame(frame);
+		});
+	};
+	const newId = () => `g${++nextId}`;
+	dial();
+	return {
+		state: () => state,
+		list: (from) => request({
+			t: "peer.list",
+			id: newId(),
+			from
+		}),
+		peek: async (from, to, recent) => await request({
+			t: "peer.peek",
+			id: newId(),
+			from,
+			to,
+			recent
+		}) ?? void 0,
+		send: (from, to, text, hops) => request({
+			t: "peer.send",
+			id: newId(),
+			from,
+			to,
+			text,
+			hops
+		}),
+		nudge: () => void tick(),
+		setHost: (next) => {
+			host = next;
+		},
+		close: () => {
+			state = "stopped";
+			clearTimeout(reconnectTimer);
+			stopTimers();
+			failPending("relay connection closed");
+			socket?.close(1e3, "gateway closing");
+			socket = void 0;
+		}
+	};
+}
+//#endregion
+export { RELAY_CLOSE, RELAY_FRAME_MAX_BYTES, RELAY_GATEWAY_NAME, RELAY_MAX_HOPS, RELAY_MESSAGE_MAX_CHARS, RELAY_OPS, RELAY_WIRE_VERSION, RelayUnavailableError, canonicalJson, connectRelay, createRegistryPublisher, decodeFrame, digestOf, encodeFrame, isRelayOp, parseRelayPeerId, registryHash, relayPeerId };
+
+//# sourceMappingURL=index.mjs.map

package/build/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/frames.ts","../src/registry.ts","../src/connection.ts"],"sourcesContent":["import type { ContextReading, ProfileEngine, SessionStatus } from '@workerdeck/protocol'\n\nexport const RELAY_WIRE_VERSION = 1\n\nexport const RELAY_OPS = ['send', 'peek'] as const\nexport type RelayOp = (typeof RELAY_OPS)[number]\n\nexport const RELAY_CLOSE = {\n  badHello: 4400,\n  unauthorized: 4401,\n  revoked: 4403,\n  versionMismatch: 4426,\n  replaced: 4409,\n  timeout: 4408,\n} as const\n\nexport const RELAY_FRAME_MAX_BYTES = 4 * 1024 * 1024\nexport const RELAY_MESSAGE_MAX_CHARS = 16_000\nexport const RELAY_MAX_HOPS = 12\nexport const RELAY_GATEWAY_NAME = /^[a-z0-9][a-z0-9-]{0,62}$/\n\nexport type RelaySessionEntry = {\n  id: string\n  engine?: ProfileEngine\n  status: SessionStatus\n  title?: string\n  project?: { name: string; root: string }\n  cwd: string\n  profile?: string\n  model?: string\n  permissionMode?: string\n  contextUsage?: ContextReading\n  checklist?: { done: number; total: number }\n  numTurns?: number\n  createdAt: number\n  lastActivityAt?: number\n  pendingPermissionCount: number\n  live: boolean\n}\n\nexport type RelayPeerRow = RelaySessionEntry & { gateway: string; allow: RelayOp[] }\n\nexport type RelayOrigin = {\n  gateway: string\n  sessionId: string\n  name?: string\n  engine?: ProfileEngine\n  hops: string[]\n}\n\nexport type RelayPeek = RelaySessionEntry & {\n  checklistItems?: Array<{ text: string; status: string }>\n  pendingApprovals: string[]\n  recent: string[]\n}\n\nexport type RelaySendResult = { delivered: true; sessionId: string; name?: string; queued: boolean } | { delivered: false; reason: string }\n\nexport type RelayTarget = { gateway: string; id: string }\n\nexport type HelloFrame = { t: 'hello'; gateway: string; key: string; version: number; ceiling: { ops: RelayOp[] } }\nexport type WelcomeFrame = { t: 'welcome'; relayVersion: number }\nexport type SnapshotFrame = { t: 'registry.snapshot'; seq: number; entries: RelaySessionEntry[] }\nexport type DeltaFrame = { t: 'registry.delta'; seq: number; upsert: RelaySessionEntry[]; remove: string[] }\nexport type DigestFrame = { t: 'registry.digest'; seq: number; count: number; hash: string }\nexport type ResyncFrame = { t: 'registry.resync' }\n\nexport type ListRequest = { t: 'peer.list'; id: string; from: string }\nexport type PeekRequest = { t: 'peer.peek'; id: string; from: string; to: RelayTarget; recent?: number }\nexport type SendRequest = { t: 'peer.send'; id: string; from: string; to: RelayTarget; text: string; hops: string[] }\n\nexport type InboundPeek = { t: 'peer.peek'; id: string; origin: RelayOrigin; to: string; recent?: number }\nexport type InboundSend = { t: 'peer.send'; id: string; origin: RelayOrigin; to: string; text: string }\n\nexport type ResponseFrame = { t: 'res'; id: string; ok: true; result: unknown } | { t: 'res'; id: string; ok: false; error: string }\n\nexport type GatewayFrame = HelloFrame | SnapshotFrame | DeltaFrame | DigestFrame | ListRequest | PeekRequest | SendRequest | ResponseFrame\n\nexport type RelayFrame = WelcomeFrame | ResyncFrame | InboundPeek | InboundSend | ResponseFrame\n\nexport function encodeFrame(frame: GatewayFrame | RelayFrame): string {\n  return JSON.stringify(frame)\n}\n\n// Only the envelope is checked here; each side narrows the payload of the frames it accepts.\nexport function decodeFrame(raw: unknown): { t: string; [key: string]: unknown } | undefined {\n  const text = typeof raw === 'string' ? raw : raw instanceof Buffer ? raw.toString('utf8') : undefined\n  if (text === undefined) {\n    return undefined\n  }\n  try {\n    const value: unknown = JSON.parse(text)\n    if (typeof value !== 'object' || value === null || Array.isArray(value) || typeof (value as { t?: unknown }).t !== 'string') {\n      return undefined\n    }\n    return value as { t: string; [key: string]: unknown }\n  } catch {\n    return undefined\n  }\n}\n\nexport function isRelayOp(value: unknown): value is RelayOp {\n  return value === 'send' || value === 'peek'\n}\n\nexport function relayPeerId(gateway: string, sessionId: string): string {\n  return `${gateway}:${sessionId}`\n}\n\nexport function parseRelayPeerId(id: string): RelayTarget | undefined {\n  const at = id.indexOf(':')\n  if (at <= 0 || at === id.length - 1) {\n    return undefined\n  }\n  const gateway = id.slice(0, at)\n  return RELAY_GATEWAY_NAME.test(gateway) ? { gateway, id: id.slice(at + 1) } : undefined\n}\n","import { createHash } from 'node:crypto'\nimport type { DeltaFrame, DigestFrame, RelaySessionEntry, SnapshotFrame } from './frames.ts'\n\nexport function canonicalJson(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map(canonicalJson).join(',')}]`\n  }\n  if (value !== null && typeof value === 'object') {\n    const keys = Object.keys(value)\n      .filter((key) => (value as Record<string, unknown>)[key] !== undefined)\n      .sort()\n    return `{${keys.map((key) => `${JSON.stringify(key)}:${canonicalJson((value as Record<string, unknown>)[key])}`).join(',')}}`\n  }\n  return JSON.stringify(value)\n}\n\nexport function registryHash(entries: Iterable<[string, string]>): string {\n  const hash = createHash('sha256')\n  for (const [id, json] of [...entries].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) {\n    hash.update(id).update('\\n').update(json).update('\\n')\n  }\n  return hash.digest('base64url')\n}\n\nexport function digestOf(entries: readonly RelaySessionEntry[]): { count: number; hash: string } {\n  return { count: entries.length, hash: registryHash(entries.map((entry) => [entry.id, canonicalJson(entry)])) }\n}\n\nexport type RegistryPublisher = {\n  snapshot(entries: readonly RelaySessionEntry[]): SnapshotFrame\n  delta(entries: readonly RelaySessionEntry[]): DeltaFrame | undefined\n  digest(): DigestFrame\n}\n\n// Diffs what the host reports against what was last sent, so a session that vanished by any path is\n// removed on the next tick. Nothing listens for session events; the snapshot is the only input.\nexport function createRegistryPublisher(): RegistryPublisher {\n  let sent = new Map<string, string>()\n  let seq = 0\n\n  const index = (entries: readonly RelaySessionEntry[]): Map<string, string> =>\n    new Map(entries.map((entry) => [entry.id, canonicalJson(entry)]))\n\n  return {\n    snapshot(entries) {\n      sent = index(entries)\n      seq += 1\n      return { t: 'registry.snapshot', seq, entries: [...entries] }\n    },\n    delta(entries) {\n      const next = index(entries)\n      const upsert = entries.filter((entry) => sent.get(entry.id) !== next.get(entry.id))\n      const remove = [...sent.keys()].filter((id) => !next.has(id))\n      if (upsert.length === 0 && remove.length === 0) {\n        return undefined\n      }\n      sent = next\n      seq += 1\n      return { t: 'registry.delta', seq, upsert, remove }\n    },\n    digest() {\n      return { t: 'registry.digest', seq, count: sent.size, hash: registryHash(sent) }\n    },\n  }\n}\n","import { WebSocket, type RawData } from 'ws'\nimport {\n  RELAY_CLOSE,\n  RELAY_FRAME_MAX_BYTES,\n  RELAY_OPS,\n  RELAY_WIRE_VERSION,\n  decodeFrame,\n  encodeFrame,\n  isRelayOp,\n  type GatewayFrame,\n  type RelayOp,\n  type RelayOrigin,\n  type RelayPeek,\n  type RelayPeerRow,\n  type RelaySendResult,\n  type RelaySessionEntry,\n  type RelayTarget,\n} from './frames.ts'\nimport { createRegistryPublisher } from './registry.ts'\n\nexport type RelayHost = {\n  snapshot(): Promise<RelaySessionEntry[]>\n  peek(origin: RelayOrigin, sessionId: string, recent?: number): Promise<RelayPeek | undefined>\n  send(origin: RelayOrigin, sessionId: string, text: string): Promise<RelaySendResult>\n}\n\nexport type RelayConnectOptions = {\n  url: string\n  gateway: string\n  key: string\n  allow?: readonly RelayOp[]\n  ca?: string | Buffer\n  tickMs?: number\n  digestMs?: number\n  heartbeatMs?: number\n  requestTimeoutMs?: number\n  backoffMinMs?: number\n  backoffMaxMs?: number\n  log?: (message: string) => void\n}\n\nexport type RelayState = 'connecting' | 'online' | 'offline' | 'stopped'\n\nexport type RelayConnection = {\n  state(): RelayState\n  list(from: string): Promise<RelayPeerRow[]>\n  peek(from: string, to: RelayTarget, recent?: number): Promise<RelayPeek | undefined>\n  send(from: string, to: RelayTarget, text: string, hops: string[]): Promise<RelaySendResult>\n  nudge(): void\n  setHost(host: RelayHost): void\n  close(): void\n}\n\nexport class RelayUnavailableError extends Error {\n  constructor(message = 'remote gateways unavailable') {\n    super(message)\n    this.name = 'RelayUnavailableError'\n  }\n}\n\ntype Pending = { resolve: (value: unknown) => void; reject: (error: Error) => void; timer: NodeJS.Timeout }\n\nconst TERMINAL_CLOSES: ReadonlyMap<number, string> = new Map([\n  [RELAY_CLOSE.unauthorized, 'the relay refused this gateway key'],\n  [RELAY_CLOSE.revoked, 'this gateway is not enrolled at the relay'],\n  [RELAY_CLOSE.versionMismatch, 'the relay speaks a different wire version'],\n  [RELAY_CLOSE.badHello, 'the relay refused the hello frame'],\n])\n\nexport function connectRelay(options: RelayConnectOptions, initialHost: RelayHost): RelayConnection {\n  const tickMs = options.tickMs ?? 2_000\n  const digestMs = options.digestMs ?? 30_000\n  const heartbeatMs = options.heartbeatMs ?? 15_000\n  const requestTimeoutMs = options.requestTimeoutMs ?? 10_000\n  const backoffMin = options.backoffMinMs ?? 1_000\n  const backoffMax = options.backoffMaxMs ?? 60_000\n  const allow = new Set<RelayOp>((options.allow ?? RELAY_OPS).filter(isRelayOp))\n  const log = options.log ?? (() => {})\n\n  let host = initialHost\n  let state: RelayState = 'connecting'\n  let socket: WebSocket | undefined\n  let attempt = 0\n  let reconnectTimer: NodeJS.Timeout | undefined\n  let tickTimer: NodeJS.Timeout | undefined\n  let digestTimer: NodeJS.Timeout | undefined\n  let heartbeatTimer: NodeJS.Timeout | undefined\n  let lastHeard = 0\n  let ticking = false\n  let tickAgain = false\n  let nextId = 0\n  let lastTerminal: number | undefined\n  let publisher = createRegistryPublisher()\n  const pending = new Map<string, Pending>()\n\n  const sendFrame = (frame: GatewayFrame): void => {\n    if (socket?.readyState === WebSocket.OPEN) {\n      socket.send(encodeFrame(frame))\n    }\n  }\n\n  const failPending = (reason: string): void => {\n    for (const [id, entry] of pending) {\n      clearTimeout(entry.timer)\n      entry.reject(new RelayUnavailableError(reason))\n      pending.delete(id)\n    }\n  }\n\n  const stopTimers = (): void => {\n    clearInterval(tickTimer)\n    clearInterval(digestTimer)\n    clearInterval(heartbeatTimer)\n    tickTimer = digestTimer = heartbeatTimer = undefined\n  }\n\n  const publishSnapshot = async (): Promise<void> => {\n    const entries = await host.snapshot()\n    if (state === 'online') {\n      sendFrame(publisher.snapshot(entries))\n    }\n  }\n\n  const tick = async (): Promise<void> => {\n    if (state !== 'online') {\n      return\n    }\n    if (ticking) {\n      tickAgain = true\n      return\n    }\n    ticking = true\n    try {\n      const entries = await host.snapshot()\n      const delta = state === 'online' ? publisher.delta(entries) : undefined\n      if (delta) {\n        sendFrame(delta)\n      }\n    } catch (error) {\n      log(`relay: registry tick failed: ${error instanceof Error ? error.message : String(error)}`)\n    } finally {\n      ticking = false\n      if (tickAgain) {\n        tickAgain = false\n        void tick()\n      }\n    }\n  }\n\n  const answer = async (id: string, work: () => Promise<unknown>): Promise<void> => {\n    try {\n      sendFrame({ t: 'res', id, ok: true, result: (await work()) ?? null })\n    } catch (error) {\n      sendFrame({ t: 'res', id, ok: false, error: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  const onInbound = (frame: { t: string; [key: string]: unknown }): void => {\n    const id = typeof frame.id === 'string' ? frame.id : undefined\n    const origin = frame.origin as RelayOrigin | undefined\n    const to = typeof frame.to === 'string' ? frame.to : undefined\n    if (!id || !origin || typeof origin.gateway !== 'string' || typeof origin.sessionId !== 'string' || !to) {\n      return\n    }\n    const hops = Array.isArray(origin.hops) ? origin.hops.filter((hop): hop is string => typeof hop === 'string') : []\n    const stamped: RelayOrigin = { ...origin, hops }\n    if (frame.t === 'peer.peek') {\n      if (!allow.has('peek')) {\n        void answer(id, async () => null)\n        return\n      }\n      const recent = typeof frame.recent === 'number' ? frame.recent : undefined\n      void answer(id, () => host.peek(stamped, to, recent))\n      return\n    }\n    if (frame.t === 'peer.send') {\n      if (!allow.has('send')) {\n        void answer(id, async () => ({ delivered: false, reason: `no such session: ${to}` }))\n        return\n      }\n      const text = typeof frame.text === 'string' ? frame.text : ''\n      void answer(id, () => host.send(stamped, to, text))\n    }\n  }\n\n  const onFrame = (raw: RawData): void => {\n    lastHeard = Date.now()\n    const frame = decodeFrame(Array.isArray(raw) ? Buffer.concat(raw) : raw instanceof ArrayBuffer ? Buffer.from(raw) : raw)\n    if (!frame) {\n      return\n    }\n    switch (frame.t) {\n      case 'welcome': {\n        if (state !== 'connecting') {\n          return\n        }\n        state = 'online'\n        attempt = 0\n        lastTerminal = undefined\n        log(`relay: connected to ${options.url} as ${options.gateway}`)\n        publisher = createRegistryPublisher()\n        void publishSnapshot().catch((error) => log(`relay: snapshot failed: ${error instanceof Error ? error.message : String(error)}`))\n        tickTimer = setInterval(() => void tick(), tickMs)\n        digestTimer = setInterval(() => sendFrame(publisher.digest()), digestMs)\n        return\n      }\n      case 'registry.resync': {\n        void publishSnapshot().catch(() => {})\n        return\n      }\n      case 'res': {\n        const id = typeof frame.id === 'string' ? frame.id : ''\n        const entry = pending.get(id)\n        if (!entry) {\n          return\n        }\n        pending.delete(id)\n        clearTimeout(entry.timer)\n        if (frame.ok === true) {\n          entry.resolve(frame.result)\n        } else {\n          entry.reject(new Error(typeof frame.error === 'string' ? frame.error : 'relay request failed'))\n        }\n        return\n      }\n      case 'peer.peek':\n      case 'peer.send': {\n        if (state === 'online') {\n          onInbound(frame)\n        }\n        return\n      }\n    }\n  }\n\n  const scheduleReconnect = (): void => {\n    if (state === 'stopped') {\n      return\n    }\n    attempt += 1\n    const ceiling = lastTerminal !== undefined ? backoffMax : Math.min(backoffMax, backoffMin * 2 ** (attempt - 1))\n    const delay = Math.round(ceiling / 2 + Math.random() * (ceiling / 2))\n    reconnectTimer = setTimeout(dial, delay)\n  }\n\n  const onClose = (code: number, reason: string): void => {\n    stopTimers()\n    socket = undefined\n    failPending('remote gateways unavailable')\n    if (state === 'stopped') {\n      return\n    }\n    const wasOnline = state === 'online'\n    state = 'offline'\n    const terminal = TERMINAL_CLOSES.get(code)\n    if (terminal) {\n      if (lastTerminal !== code) {\n        log(`relay: ${terminal}${reason ? ` (${reason})` : ''}; retrying every ${Math.round(backoffMax / 1000)}s`)\n      }\n      lastTerminal = code\n    } else if (wasOnline) {\n      log(`relay: connection lost (${code}${reason ? ` ${reason}` : ''}); reconnecting`)\n    }\n    scheduleReconnect()\n  }\n\n  function dial(): void {\n    reconnectTimer = undefined\n    if (state === 'stopped') {\n      return\n    }\n    state = 'connecting'\n    const ws = new WebSocket(options.url, { maxPayload: RELAY_FRAME_MAX_BYTES, handshakeTimeout: requestTimeoutMs, ca: options.ca })\n    socket = ws\n    lastHeard = Date.now()\n    ws.on('open', () => {\n      sendFrame({ t: 'hello', gateway: options.gateway, key: options.key, version: RELAY_WIRE_VERSION, ceiling: { ops: [...allow] } })\n      heartbeatTimer = setInterval(() => {\n        if (Date.now() - lastHeard > heartbeatMs * 2 + 1_000) {\n          ws.terminate()\n          return\n        }\n        ws.ping()\n      }, heartbeatMs)\n    })\n    ws.on('message', onFrame)\n    ws.on('pong', () => {\n      lastHeard = Date.now()\n    })\n    ws.on('ping', () => {\n      lastHeard = Date.now()\n    })\n    ws.on('error', () => {})\n    ws.on('close', (code, reason) => {\n      if (socket === ws) {\n        onClose(code, reason.toString('utf8'))\n      }\n    })\n  }\n\n  const request = <T>(frame: GatewayFrame & { id: string }): Promise<T> => {\n    if (state !== 'online') {\n      return Promise.reject(new RelayUnavailableError())\n    }\n    return new Promise<T>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        pending.delete(frame.id)\n        reject(new RelayUnavailableError('the relay did not answer in time'))\n      }, requestTimeoutMs)\n      pending.set(frame.id, { resolve: resolve as (value: unknown) => void, reject, timer })\n      sendFrame(frame)\n    })\n  }\n\n  const newId = (): string => `g${++nextId}`\n\n  dial()\n\n  return {\n    state: () => state,\n    list: (from) => request<RelayPeerRow[]>({ t: 'peer.list', id: newId(), from }),\n    peek: async (from, to, recent) => (await request<RelayPeek | null>({ t: 'peer.peek', id: newId(), from, to, recent })) ?? undefined,\n    send: (from, to, text, hops) => request<RelaySendResult>({ t: 'peer.send', id: newId(), from, to, text, hops }),\n    nudge: () => void tick(),\n    setHost: (next) => {\n      host = next\n    },\n    close: () => {\n      state = 'stopped'\n      clearTimeout(reconnectTimer)\n      stopTimers()\n      failPending('relay connection closed')\n      socket?.close(1000, 'gateway closing')\n      socket = undefined\n    },\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@workerdeck/relay-client",
+  "version": "3.3.0",
+  "type": "module",
+  "description": "Gateway side of the WorkerDeck relay: the relay wire frames, the dial-out connection with auth, heartbeat and reconnect, the session registry publisher, and the remote peer directory. Lets agents on separate gateways list, peek at and message each other.",
+  "license": "MIT",
+  "main": "./build/index.mjs",
+  "types": "./build/index.d.mts",
+  "files": [
+    "build"
+  ],
+  "exports": {
+    ".": {
+      "@workerdeck/source": "./src/index.ts",
+      "types": "./build/index.d.mts",
+      "default": "./build/index.mjs"
+    }
+  },
+  "dependencies": {
+    "ws": "^8.21.3",
+    "@workerdeck/protocol": "3.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.1",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.22.14",
+    "vitest": "^4.1.11",
+    "@types/ws": "^8.18.1"
+  },
+  "author": "Tobias Strebitzer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/workerdeck/workerdeck.git",
+    "directory": "packages/relay-client"
+  },
+  "homepage": "https://workerdeck.github.io/workerdeck/",
+  "bugs": "https://github.com/workerdeck/workerdeck/issues",
+  "keywords": [
+    "workerdeck",
+    "relay",
+    "agent",
+    "peers",
+    "gateway"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "build": "tsdown",
+    "typecheck": "tsgo -p tsconfig.json",
+    "test": "vitest run"
+  }
+}