@mquan/portal 0.0.1

package/dist/src/network/client.js

@@ -0,0 +1,540 @@
+import { randomUUID } from "node:crypto";
+import { PROTOCOL_LIMITS, PROTOCOL_VERSION, clientMessageSchema, parseNetworkMessage, } from "./protocol.js";
+/**
+ * Reusable client transport for the Portal relay protocol.
+ *
+ * A connection is usable only after the versioned hello exchange succeeds.
+ * Requests in flight when a socket drops are rejected (never silently
+ * replayed); later requests wait for the reconnect handshake.
+ */
+export class RemoteNetworkClient {
+    url;
+    #options;
+    #messageHandlers = new Set();
+    #envelopeHandlers = new Set();
+    #stateHandlers = new Set();
+    #errorHandlers = new Set();
+    #pendingRequests = new Map();
+    #pendingEnvelopes = new Map();
+    #envelopeRequests = new Map();
+    #envelopeMetadata = new Map();
+    #socket = null;
+    #state = "connecting";
+    #connectPromise = null;
+    #connectResolve = null;
+    #connectReject = null;
+    #helloTimer = null;
+    #reconnectTimer = null;
+    #reconnectAttempts = 0;
+    #frameQueue = Promise.resolve();
+    #serverHello = null;
+    #closed = false;
+    constructor(url, options) {
+        this.url = normalizeRemoteServerUrl(url);
+        this.#options = {
+            ...options,
+            connectTimeoutMs: options.connectTimeoutMs ?? 10_000,
+            requestTimeoutMs: options.requestTimeoutMs ?? 10_000,
+            reconnect: options.reconnect ?? true,
+            reconnectDelayMs: options.reconnectDelayMs ?? 250,
+            maximumReconnectDelayMs: options.maximumReconnectDelayMs ?? 5_000,
+        };
+    }
+    static async connect(url, options) {
+        const client = new RemoteNetworkClient(url, options);
+        await client.#startConnection(false);
+        return client;
+    }
+    get state() {
+        return this.#state;
+    }
+    get serverHello() {
+        return this.#serverHello;
+    }
+    onMessage(handler) {
+        return subscribe(this.#messageHandlers, handler);
+    }
+    onEnvelope(handler) {
+        return subscribe(this.#envelopeHandlers, handler);
+    }
+    onStateChange(handler) {
+        return subscribe(this.#stateHandlers, handler);
+    }
+    onError(handler) {
+        return subscribe(this.#errorHandlers, handler);
+    }
+    async register(input) {
+        const response = await this.#request("agent.registered", (requestId) => ({
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.register",
+            requestId,
+            ...input,
+        }));
+        return response.agent;
+    }
+    async renew(input) {
+        const response = await this.#request("agent.renewed", (requestId) => ({
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.renew",
+            requestId,
+            ...input,
+        }));
+        return response.agent;
+    }
+    async unregister(routeId) {
+        await this.#request("agent.unregistered", (requestId) => ({
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.unregister",
+            requestId,
+            routeId,
+        }));
+    }
+    async discover(input = {}) {
+        const response = await this.#request("agent.presence", (requestId) => ({
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.discover",
+            requestId,
+            ...input,
+            limit: input.limit ?? 20,
+        }));
+        return response.agents;
+    }
+    async sendEnvelope(envelope) {
+        await this.#awaitConnected();
+        if (this.#pendingEnvelopes.has(envelope.envelopeId)) {
+            throw new Error(`envelope is already awaiting acknowledgement: ${envelope.envelopeId}`);
+        }
+        return new Promise((resolve, reject) => {
+            const requestId = this.#requestId();
+            const timer = this.#requestTimer(() => {
+                this.#pendingEnvelopes.delete(envelope.envelopeId);
+                this.#envelopeRequests.delete(requestId);
+                this.#envelopeMetadata.delete(envelope.envelopeId);
+                reject(new Error(`remote envelope acknowledgement timed out: ${envelope.envelopeId}`));
+            });
+            this.#pendingEnvelopes.set(envelope.envelopeId, {
+                expectedType: "envelope.acknowledged",
+                timer,
+                resolve,
+                reject,
+            });
+            this.#envelopeRequests.set(requestId, envelope.envelopeId);
+            this.#envelopeMetadata.set(envelope.envelopeId, { requestId, eventId: envelope.event.eventId });
+            try {
+                this.#sendOnSocket({
+                    protocolVersion: PROTOCOL_VERSION,
+                    type: "envelope.send",
+                    requestId,
+                    envelope,
+                });
+            }
+            catch (error) {
+                this.#pendingEnvelopes.delete(envelope.envelopeId);
+                this.#envelopeRequests.delete(requestId);
+                this.#envelopeMetadata.delete(envelope.envelopeId);
+                clearTimeout(timer);
+                reject(asError(error));
+            }
+        });
+    }
+    async acknowledge(input) {
+        await this.#request("envelope.acknowledge.accepted", (requestId) => ({
+            protocolVersion: PROTOCOL_VERSION,
+            type: "envelope.acknowledge",
+            requestId,
+            ...input,
+        }));
+    }
+    async send(message) {
+        const parsed = clientMessageSchema.parse(message);
+        await this.#awaitConnected();
+        this.#sendOnSocket(parsed);
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#setState("closed");
+        if (this.#reconnectTimer !== null)
+            clearTimeout(this.#reconnectTimer);
+        this.#reconnectTimer = null;
+        if (this.#helloTimer !== null)
+            clearTimeout(this.#helloTimer);
+        this.#helloTimer = null;
+        this.#rejectConnect(new Error("remote WebSocket client closed"));
+        this.#failPending(new Error("remote WebSocket client closed"));
+        const socket = this.#socket;
+        this.#socket = null;
+        socket?.close(1000, "client closed");
+        this.#messageHandlers.clear();
+        this.#envelopeHandlers.clear();
+        this.#stateHandlers.clear();
+        this.#errorHandlers.clear();
+    }
+    async #request(expectedType, createMessage) {
+        await this.#awaitConnected();
+        const requestId = this.#requestId();
+        return new Promise((resolve, reject) => {
+            const timer = this.#requestTimer(() => {
+                this.#pendingRequests.delete(requestId);
+                reject(new Error(`remote request timed out: ${expectedType}`));
+            });
+            this.#pendingRequests.set(requestId, {
+                expectedType,
+                timer,
+                resolve: resolve,
+                reject,
+            });
+            try {
+                this.#sendOnSocket(createMessage(requestId));
+            }
+            catch (error) {
+                this.#pendingRequests.delete(requestId);
+                clearTimeout(timer);
+                reject(asError(error));
+            }
+        });
+    }
+    async #startConnection(reconnecting) {
+        if (this.#closed)
+            throw new Error("remote WebSocket client is closed");
+        if (this.#connectPromise !== null)
+            return this.#connectPromise;
+        this.#setState(reconnecting ? "reconnecting" : "connecting");
+        this.#connectPromise = new Promise((resolve, reject) => {
+            this.#connectResolve = resolve;
+            this.#connectReject = reject;
+        });
+        const promise = this.#connectPromise;
+        let socket;
+        try {
+            socket = (this.#options.webSocketFactory ?? defaultWebSocketFactory)(this.url);
+            this.#socket = socket;
+        }
+        catch (error) {
+            this.#rejectConnect(asError(error));
+            return promise;
+        }
+        socket.addEventListener("open", () => this.#handleOpen(socket), { once: true });
+        socket.addEventListener("message", (event) => {
+            this.#frameQueue = this.#frameQueue.then(() => this.#handleFrame(socket, event.data)).catch((error) => this.#emitError(asError(error)));
+        });
+        socket.addEventListener("error", () => this.#handleDisconnect(socket, new Error("remote WebSocket failed")));
+        socket.addEventListener("close", () => this.#handleDisconnect(socket, new Error("remote WebSocket closed")));
+        this.#helloTimer = setTimeout(() => {
+            if (socket !== this.#socket || this.#state === "connected")
+                return;
+            this.#handleDisconnect(socket, new Error("remote WebSocket hello timed out"));
+            socket.close(1000, "hello timeout");
+        }, this.#options.connectTimeoutMs);
+        this.#helloTimer.unref();
+        return promise;
+    }
+    #handleOpen(socket) {
+        if (socket !== this.#socket || this.#closed)
+            return;
+        const hello = {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "client.hello",
+            clientId: this.#options.clientId,
+            installationId: this.#options.installationId,
+            sentAt: (this.#options.now ?? (() => new Date()))().toISOString(),
+        };
+        try {
+            this.#sendOnSocket(hello);
+        }
+        catch (error) {
+            this.#handleDisconnect(socket, asError(error));
+        }
+    }
+    async #handleFrame(socket, data) {
+        if (socket !== this.#socket || this.#closed)
+            return;
+        let message;
+        try {
+            const text = await frameText(data);
+            const parsed = parseNetworkMessage(text);
+            if (!isServerMessage(parsed))
+                throw new Error(`relay sent a client message: ${parsed.type}`);
+            message = parsed;
+        }
+        catch (error) {
+            this.#emitError(asError(error));
+            return;
+        }
+        if (this.#state !== "connected" && message.type !== "server.hello" && message.type !== "protocol.error") {
+            const error = new Error(`relay sent ${message.type} before server.hello`);
+            this.#emitError(error);
+            this.#handleDisconnect(socket, error);
+            socket.close(1002, "handshake required");
+            return;
+        }
+        if (this.#state === "connected" && message.type === "server.hello") {
+            const error = new Error("relay sent duplicate server.hello");
+            this.#emitError(error);
+            this.#handleDisconnect(socket, error);
+            socket.close(1002, "duplicate hello");
+            return;
+        }
+        if (message.type === "server.hello") {
+            this.#acceptHello(message);
+        }
+        else if (message.type === "protocol.error") {
+            this.#handleProtocolError(message);
+        }
+        else if ("requestId" in message) {
+            this.#settleRequest(message);
+        }
+        else if (message.type === "envelope.acknowledged") {
+            this.#settleEnvelope(message);
+        }
+        else if (message.type === "envelope.delivery") {
+            for (const handler of [...this.#envelopeHandlers])
+                void Promise.resolve(handler(message.envelope)).catch((error) => this.#emitError(asError(error)));
+        }
+        for (const handler of [...this.#messageHandlers])
+            void Promise.resolve(handler(message)).catch((error) => this.#emitError(asError(error)));
+    }
+    #acceptHello(hello) {
+        if (this.#state === "connected")
+            return;
+        if (this.#helloTimer !== null)
+            clearTimeout(this.#helloTimer);
+        this.#helloTimer = null;
+        this.#reconnectAttempts = 0;
+        this.#serverHello = hello;
+        this.#setState("connected");
+        this.#connectResolve?.();
+        this.#clearConnect();
+    }
+    #handleProtocolError(error) {
+        const protocolError = new Error(`remote protocol error (${error.code}): ${error.message}`);
+        if (error.requestId !== undefined) {
+            const pending = this.#pendingRequests.get(error.requestId);
+            if (pending !== undefined) {
+                this.#pendingRequests.delete(error.requestId);
+                clearTimeout(pending.timer);
+                pending.reject(protocolError);
+                return;
+            }
+            const envelopeId = this.#envelopeRequests.get(error.requestId);
+            if (envelopeId !== undefined) {
+                this.#envelopeRequests.delete(error.requestId);
+                this.#envelopeMetadata.delete(envelopeId);
+                const envelope = this.#pendingEnvelopes.get(envelopeId);
+                if (envelope !== undefined) {
+                    this.#pendingEnvelopes.delete(envelopeId);
+                    clearTimeout(envelope.timer);
+                    envelope.reject(protocolError);
+                    return;
+                }
+            }
+        }
+        if (this.#state !== "connected" && this.#socket !== null) {
+            const socket = this.#socket;
+            this.#handleDisconnect(socket, protocolError);
+            socket.close(1002, "protocol error");
+        }
+        this.#emitError(protocolError);
+    }
+    #settleRequest(message) {
+        const pending = this.#pendingRequests.get(message.requestId);
+        if (pending === undefined)
+            return;
+        this.#pendingRequests.delete(message.requestId);
+        clearTimeout(pending.timer);
+        if (pending.expectedType !== message.type) {
+            pending.reject(new Error(`unexpected remote response ${message.type}; expected ${pending.expectedType}`));
+            return;
+        }
+        pending.resolve(message);
+    }
+    #settleEnvelope(message) {
+        const pending = this.#pendingEnvelopes.get(message.envelopeId);
+        if (pending === undefined)
+            return;
+        const metadata = this.#envelopeMetadata.get(message.envelopeId);
+        if (metadata === undefined || metadata.eventId !== message.eventId) {
+            this.#emitError(new Error(`envelope acknowledgement event does not match: ${message.envelopeId}`));
+            return;
+        }
+        this.#envelopeRequests.delete(metadata.requestId);
+        this.#envelopeMetadata.delete(message.envelopeId);
+        this.#pendingEnvelopes.delete(message.envelopeId);
+        clearTimeout(pending.timer);
+        pending.resolve(message);
+    }
+    #handleDisconnect(socket, error) {
+        if (socket !== this.#socket || this.#closed)
+            return;
+        this.#socket = null;
+        this.#serverHello = null;
+        if (this.#helloTimer !== null)
+            clearTimeout(this.#helloTimer);
+        this.#helloTimer = null;
+        const wasInitialConnection = this.#state === "connecting";
+        this.#rejectConnect(error);
+        this.#failPending(error);
+        this.#emitError(error);
+        if (wasInitialConnection || !this.#options.reconnect) {
+            this.#setState("closed");
+            this.#closed = true;
+            return;
+        }
+        this.#scheduleReconnect();
+    }
+    #scheduleReconnect() {
+        if (this.#closed || this.#reconnectTimer !== null)
+            return;
+        this.#setState("reconnecting");
+        const delay = Math.min(this.#options.reconnectDelayMs * 2 ** this.#reconnectAttempts, this.#options.maximumReconnectDelayMs);
+        this.#reconnectAttempts += 1;
+        this.#reconnectTimer = setTimeout(() => {
+            this.#reconnectTimer = null;
+            void this.#startConnection(true).catch((error) => {
+                if (this.#closed)
+                    return;
+                this.#emitError(asError(error));
+                this.#scheduleReconnect();
+            });
+        }, delay);
+        this.#reconnectTimer.unref();
+    }
+    async #awaitConnected() {
+        if (this.#closed)
+            throw new Error("remote WebSocket client is closed");
+        if (this.#state === "connected" && this.#socket !== null)
+            return;
+        if (this.#connectPromise !== null)
+            return this.#connectPromise;
+        return this.#startConnection(this.#state === "reconnecting");
+    }
+    #sendOnSocket(message) {
+        const socket = this.#socket;
+        if (socket === null || socket.readyState !== 1)
+            throw new Error("remote WebSocket is not open");
+        const encoded = JSON.stringify(clientMessageSchema.parse(message));
+        if (Buffer.byteLength(encoded, "utf8") > PROTOCOL_LIMITS.encodedMessageBytes) {
+            throw new Error("remote message exceeds protocol limit");
+        }
+        socket.send(encoded);
+    }
+    #requestId() {
+        const requestId = (this.#options.requestIdFactory ?? randomUUID)();
+        if (this.#pendingRequests.has(requestId) || this.#envelopeRequests.has(requestId)) {
+            throw new Error(`remote request ID is already in flight: ${requestId}`);
+        }
+        return requestId;
+    }
+    #requestTimer(onTimeout) {
+        const timer = setTimeout(onTimeout, this.#options.requestTimeoutMs);
+        timer.unref();
+        return timer;
+    }
+    #rejectConnect(error) {
+        this.#connectReject?.(error);
+        this.#clearConnect();
+    }
+    #clearConnect() {
+        this.#connectPromise = null;
+        this.#connectResolve = null;
+        this.#connectReject = null;
+    }
+    #failPending(error) {
+        for (const pending of this.#pendingRequests.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.#pendingRequests.clear();
+        for (const pending of this.#pendingEnvelopes.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(error);
+        }
+        this.#pendingEnvelopes.clear();
+        this.#envelopeRequests.clear();
+        this.#envelopeMetadata.clear();
+    }
+    #setState(state) {
+        if (this.#state === state)
+            return;
+        this.#state = state;
+        for (const handler of [...this.#stateHandlers]) {
+            try {
+                handler(state);
+            }
+            catch (error) {
+                this.#emitError(asError(error));
+            }
+        }
+    }
+    #emitError(error) {
+        for (const handler of [...this.#errorHandlers]) {
+            try {
+                handler(error);
+            }
+            catch {
+                // Error observers must not destabilize the transport.
+            }
+        }
+    }
+}
+export function normalizeRemoteServerUrl(input) {
+    let url;
+    try {
+        url = new URL(input.trim());
+    }
+    catch {
+        throw new TypeError(`invalid remote server URL: ${input}`);
+    }
+    if (url.username.length > 0 || url.password.length > 0) {
+        throw new TypeError("remote server URL must not contain credentials");
+    }
+    if (url.protocol === "http:")
+        url.protocol = "ws:";
+    else if (url.protocol === "https:")
+        url.protocol = "wss:";
+    else if (url.protocol !== "ws:" && url.protocol !== "wss:") {
+        throw new TypeError("remote server URL must use http, https, ws, or wss");
+    }
+    url.hash = "";
+    if (url.pathname === "/" || url.pathname.length === 0)
+        url.pathname = "/ws";
+    else if (url.pathname.length > 1 && url.pathname.endsWith("/"))
+        url.pathname = url.pathname.slice(0, -1);
+    return url.toString();
+}
+function defaultWebSocketFactory(url) {
+    return new WebSocket(url);
+}
+function subscribe(listeners, listener) {
+    listeners.add(listener);
+    let active = true;
+    return () => {
+        if (!active)
+            return;
+        active = false;
+        listeners.delete(listener);
+    };
+}
+async function frameText(data) {
+    if (typeof data === "string")
+        return data;
+    if (data instanceof ArrayBuffer)
+        return Buffer.from(data).toString("utf8");
+    if (ArrayBuffer.isView(data))
+        return Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString("utf8");
+    if (typeof Blob !== "undefined" && data instanceof Blob)
+        return data.text();
+    throw new Error("remote WebSocket frame must contain UTF-8 text");
+}
+function isServerMessage(message) {
+    return message.type === "server.hello" || message.type === "agent.registered" ||
+        message.type === "agent.renewed" || message.type === "agent.unregistered" ||
+        message.type === "agent.presence" || message.type === "envelope.delivery" ||
+        message.type === "envelope.acknowledge.accepted" ||
+        message.type === "envelope.acknowledged" || message.type === "protocol.error";
+}
+function asError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+//# sourceMappingURL=client.js.map

package/dist/src/network/client.js.map

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

package/dist/src/network/coordinator.d.ts

@@ -0,0 +1,83 @@
+import { type RemoteClientState } from "./client.js";
+import type { AgentPresence, Envelope, EnvelopeAcknowledge, EnvelopeAcknowledged } from "./protocol.js";
+export interface AdvertiseRemoteAgentInput {
+    serverUrl: string;
+    sessionId: string;
+    agentName: string;
+    provider: "codex" | "claude";
+    description: string;
+    capabilities?: Array<"message" | "task">;
+    state?: "available" | "busy";
+}
+export interface RemotePeer extends AgentPresence {
+    serverUrl: string;
+    authenticated: false;
+}
+export interface RemoteClientApi {
+    readonly state: RemoteClientState;
+    register(input: {
+        sessionId: string;
+        agentName: string;
+        provider: "codex" | "claude";
+        description: string;
+        capabilities: Array<"message" | "task">;
+        state: "available" | "busy";
+        leaseSeconds: number;
+    }): Promise<AgentPresence>;
+    renew(input: {
+        routeId: string;
+        state?: "available" | "busy";
+        leaseSeconds: number;
+    }): Promise<AgentPresence>;
+    unregister(routeId: string): Promise<void>;
+    discover(input?: {
+        query?: string;
+        capability?: "message" | "task";
+        limit?: number;
+    }): Promise<AgentPresence[]>;
+    sendEnvelope(envelope: Envelope): Promise<EnvelopeAcknowledged>;
+    acknowledge(input: Omit<EnvelopeAcknowledge, "protocolVersion" | "type" | "requestId">): Promise<void>;
+    onEnvelope(handler: (envelope: Envelope) => void | Promise<void>): () => void;
+    onStateChange(handler: (state: RemoteClientState) => void): () => void;
+    onError(handler: (error: Error) => void): () => void;
+    close(): Promise<void>;
+}
+export interface RemoteCoordinatorOptions {
+    installationId?: string;
+    clientId?: string;
+    leaseSeconds?: number;
+    clientFactory?: (url: string, options: {
+        clientId: string;
+        installationId: string;
+    }) => Promise<RemoteClientApi>;
+    onEnvelope?: (serverUrl: string, envelope: Envelope) => void | Promise<void>;
+    onError?: (serverUrl: string, error: Error) => void;
+}
+/** Multiplexes explicitly advertised local sessions over one client per relay URL. */
+export declare class RemoteCoordinator {
+    #private;
+    readonly installationId: string;
+    readonly clientId: string;
+    readonly leaseSeconds: number;
+    constructor(options?: RemoteCoordinatorOptions);
+    advertise(input: AdvertiseRemoteAgentInput): Promise<RemotePeer>;
+    unadvertise(serverUrl: string, sessionId: string): Promise<void>;
+    discover(serverUrl: string, input?: {
+        query?: string;
+        capability?: "message" | "task";
+        limit?: number;
+    }, excludeSessionId?: string): Promise<RemotePeer[]>;
+    serverForSession(sessionId: string): string | null;
+    discoverForSession(sessionId: string, input?: {
+        query?: string;
+        capability?: "message" | "task";
+        limit?: number;
+    }): Promise<RemotePeer[]>;
+    sendEnvelope(serverUrl: string, envelope: Envelope): Promise<EnvelopeAcknowledged>;
+    onEnvelope(handler: (serverUrl: string, envelope: Envelope) => void | Promise<void>): () => void;
+    localRoute(serverUrl: string, sessionId: string): Promise<AgentPresence | null>;
+    localSessionForRoute(serverUrl: string, routeId: string): Promise<string | null>;
+    peerByRoute(serverUrl: string, routeId: string): Promise<RemotePeer | null>;
+    acknowledge(serverUrl: string, input: Omit<EnvelopeAcknowledge, "protocolVersion" | "type" | "requestId">): Promise<void>;
+    close(): Promise<void>;
+}