@mquan/portal 0.0.1

package/dist/src/network/server.js

@@ -0,0 +1,474 @@
+import { randomUUID } from "node:crypto";
+import { createServer } from "node:http";
+import WebSocket, { WebSocketServer } from "ws";
+import { PROTOCOL_LIMITS, PROTOCOL_VERSION, NetworkProtocolError, clientMessageSchema, parseNetworkMessage, } from "./protocol.js";
+const DEFAULT_HOST = "127.0.0.1";
+const DEFAULT_PORT = 8787;
+const DEFAULT_HEARTBEAT_SECONDS = 10;
+/** In-memory demo registry and relay. Restarting it intentionally clears all state. */
+export class PortalRelayServer {
+    host;
+    port;
+    heartbeatIntervalSeconds;
+    #sweepIntervalMs;
+    #now;
+    #idFactory;
+    #connections = new Map();
+    #agents = new Map();
+    #envelopes = new Map();
+    #httpServer = null;
+    #webSocketServer = null;
+    #sweepTimer = null;
+    #address = null;
+    constructor(options = {}) {
+        this.host = options.host ?? DEFAULT_HOST;
+        this.port = options.port ?? DEFAULT_PORT;
+        this.heartbeatIntervalSeconds = options.heartbeatIntervalSeconds ?? DEFAULT_HEARTBEAT_SECONDS;
+        if (!Number.isInteger(this.heartbeatIntervalSeconds)
+            || this.heartbeatIntervalSeconds < PROTOCOL_LIMITS.minimumHeartbeatSeconds
+            || this.heartbeatIntervalSeconds > PROTOCOL_LIMITS.maximumHeartbeatSeconds) {
+            throw new RangeError("heartbeat interval is outside protocol limits");
+        }
+        this.#sweepIntervalMs = options.sweepIntervalMs ?? this.heartbeatIntervalSeconds * 1_000;
+        if (!Number.isInteger(this.#sweepIntervalMs) || this.#sweepIntervalMs <= 0) {
+            throw new RangeError("presence sweep interval must be positive");
+        }
+        this.#now = options.now ?? (() => new Date());
+        this.#idFactory = options.idFactory ?? randomUUID;
+    }
+    get address() {
+        return this.#address;
+    }
+    get connectionCount() {
+        return this.#connections.size;
+    }
+    get agentCount() {
+        this.sweepExpiredPresence();
+        return this.#agents.size;
+    }
+    async start() {
+        if (this.#httpServer !== null)
+            throw new Error("Portal relay server is already started");
+        const httpServer = createServer((request, response) => {
+            if (request.method === "GET" && request.url === "/health") {
+                this.sweepExpiredPresence();
+                response.writeHead(200, { "content-type": "application/json; charset=utf-8" });
+                response.end(JSON.stringify({
+                    status: "ok",
+                    protocolVersion: PROTOCOL_VERSION,
+                    connections: this.#connections.size,
+                    agents: this.#agents.size,
+                }));
+                return;
+            }
+            response.writeHead(404, { "content-type": "application/json; charset=utf-8" });
+            response.end(JSON.stringify({ error: "not_found" }));
+        });
+        const webSocketServer = new WebSocketServer({
+            noServer: true,
+            clientTracking: false,
+            maxPayload: PROTOCOL_LIMITS.encodedMessageBytes,
+        });
+        httpServer.on("upgrade", (request, socket, head) => {
+            const path = new URL(request.url ?? "/", "http://portal.local").pathname;
+            if (path !== "/ws") {
+                rejectUpgrade(socket);
+                return;
+            }
+            webSocketServer.handleUpgrade(request, socket, head, (webSocket) => {
+                webSocketServer.emit("connection", webSocket, request);
+            });
+        });
+        webSocketServer.on("connection", (socket) => this.#accept(socket));
+        this.#httpServer = httpServer;
+        this.#webSocketServer = webSocketServer;
+        try {
+            await listen(httpServer, this.port, this.host);
+        }
+        catch (error) {
+            this.#httpServer = null;
+            this.#webSocketServer = null;
+            webSocketServer.close();
+            throw error;
+        }
+        const bound = httpServer.address();
+        const urlHost = this.host.includes(":") ? `[${this.host}]` : this.host;
+        this.#address = {
+            host: this.host,
+            port: bound.port,
+            httpUrl: `http://${urlHost}:${bound.port}`,
+            webSocketUrl: `ws://${urlHost}:${bound.port}/ws`,
+        };
+        this.#sweepTimer = setInterval(() => this.sweepExpiredPresence(), this.#sweepIntervalMs);
+        this.#sweepTimer.unref();
+        return this.#address;
+    }
+    async close() {
+        if (this.#sweepTimer !== null)
+            clearInterval(this.#sweepTimer);
+        this.#sweepTimer = null;
+        for (const connection of this.#connections.values())
+            connection.socket.terminate();
+        this.#connections.clear();
+        this.#agents.clear();
+        this.#envelopes.clear();
+        this.#address = null;
+        const webSocketServer = this.#webSocketServer;
+        const httpServer = this.#httpServer;
+        this.#webSocketServer = null;
+        this.#httpServer = null;
+        if (webSocketServer !== null)
+            await closeWebSocketServer(webSocketServer);
+        if (httpServer !== null)
+            await closeHttpServer(httpServer);
+    }
+    sweepExpiredPresence() {
+        const now = this.#now().getTime();
+        for (const [routeId, registered] of this.#agents) {
+            if (Date.parse(registered.presence.expiresAt) <= now)
+                this.#removeRoute(routeId);
+        }
+        for (const [envelopeId, delivery] of this.#envelopes) {
+            if (Date.parse(delivery.envelope.expiresAt) <= now)
+                this.#envelopes.delete(envelopeId);
+        }
+    }
+    #accept(socket) {
+        const connection = {
+            socket,
+            connectionId: `conn_${this.#idFactory()}`,
+            clientId: null,
+            installationId: null,
+            routeIds: new Set(),
+        };
+        this.#connections.set(socket, connection);
+        socket.on("message", (data, isBinary) => {
+            void this.#receive(connection, data, isBinary).catch((error) => {
+                this.#sendError(connection, error);
+            });
+        });
+        socket.on("close", () => this.#disconnect(connection));
+        socket.on("error", () => {
+            // The close event owns cleanup. ws emits error before close for transport failures.
+        });
+    }
+    async #receive(connection, data, isBinary) {
+        if (isBinary)
+            throw new NetworkProtocolError("malformed_message", "binary messages are not supported");
+        const parsed = parseNetworkMessage(data.toString("utf8"));
+        const clientResult = clientMessageSchema.safeParse(parsed);
+        if (!clientResult.success) {
+            throw new NetworkProtocolError("malformed_message", "clients may only send client protocol messages");
+        }
+        const message = clientResult.data;
+        if (message.type === "client.hello") {
+            if (connection.clientId !== null) {
+                this.#sendError(connection, new RelayOperationError("invalid_state", "client hello was already received"));
+                return;
+            }
+            connection.clientId = message.clientId;
+            connection.installationId = message.installationId;
+            this.#send(connection, {
+                protocolVersion: PROTOCOL_VERSION,
+                type: "server.hello",
+                connectionId: connection.connectionId,
+                heartbeatIntervalSeconds: this.heartbeatIntervalSeconds,
+                sentAt: this.#now().toISOString(),
+            });
+            return;
+        }
+        if (connection.clientId === null) {
+            this.#sendError(connection, new RelayOperationError("handshake_required", "client.hello must be sent before other operations", requestIdOf(message)));
+            return;
+        }
+        this.sweepExpiredPresence();
+        switch (message.type) {
+            case "agent.register":
+                this.#register(connection, message);
+                return;
+            case "agent.renew":
+                this.#renew(connection, message);
+                return;
+            case "agent.unregister":
+                this.#unregister(connection, message.requestId, message.routeId);
+                return;
+            case "agent.discover":
+                this.#discover(connection, message);
+                return;
+            case "envelope.send":
+                this.#forwardEnvelope(connection, message.requestId, message.envelope);
+                return;
+            case "envelope.acknowledge":
+                this.#acknowledgeEnvelope(connection, message);
+                return;
+        }
+    }
+    #register(connection, message) {
+        const routeId = `route_${this.#idFactory()}`;
+        const presence = {
+            routeId,
+            sessionId: message.sessionId,
+            agentName: message.agentName,
+            provider: message.provider,
+            description: message.description,
+            capabilities: message.capabilities,
+            state: message.state,
+            expiresAt: this.#leaseExpiry(message.leaseSeconds),
+        };
+        this.#agents.set(routeId, { connection, presence });
+        connection.routeIds.add(routeId);
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.registered",
+            requestId: message.requestId,
+            agent: presence,
+        });
+    }
+    #renew(connection, message) {
+        const registered = this.#ownedRoute(connection, message.routeId, message.requestId);
+        if (registered === null)
+            return;
+        registered.presence = {
+            ...registered.presence,
+            ...(message.state === undefined ? {} : { state: message.state }),
+            expiresAt: this.#leaseExpiry(message.leaseSeconds),
+        };
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.renewed",
+            requestId: message.requestId,
+            agent: registered.presence,
+        });
+    }
+    #unregister(connection, requestId, routeId) {
+        if (this.#ownedRoute(connection, routeId, requestId) === null)
+            return;
+        this.#removeRoute(routeId);
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.unregistered",
+            requestId,
+            routeId,
+        });
+    }
+    #discover(connection, message) {
+        const query = message.query?.toLocaleLowerCase();
+        const candidates = Array.from(this.#agents.values(), ({ presence }) => presence)
+            .filter((presence) => message.capability === undefined || presence.capabilities.includes(message.capability))
+            .filter((presence) => query === undefined || `${presence.agentName}\n${presence.description}`
+            .toLocaleLowerCase().includes(query))
+            .sort((left, right) => left.agentName.localeCompare(right.agentName) || left.routeId.localeCompare(right.routeId))
+            .slice(0, message.limit);
+        const agents = [];
+        for (const candidate of candidates) {
+            const next = {
+                protocolVersion: PROTOCOL_VERSION,
+                type: "agent.presence",
+                requestId: message.requestId,
+                agents: [...agents, candidate],
+            };
+            if (Buffer.byteLength(JSON.stringify(next), "utf8") > PROTOCOL_LIMITS.encodedMessageBytes)
+                break;
+            agents.push(candidate);
+        }
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "agent.presence",
+            requestId: message.requestId,
+            agents,
+        });
+    }
+    #forwardEnvelope(connection, requestId, envelope) {
+        const sender = this.#ownedRoute(connection, envelope.senderRouteId, requestId);
+        if (sender === null)
+            return;
+        const target = this.#agents.get(envelope.targetRouteId);
+        if (target === undefined) {
+            this.#sendError(connection, new RelayOperationError("route_not_found", `target route is not live: ${envelope.targetRouteId}`, requestId));
+            return;
+        }
+        if (Date.parse(envelope.expiresAt) <= this.#now().getTime()) {
+            this.#sendError(connection, new RelayOperationError("envelope_expired", "envelope has expired", requestId));
+            return;
+        }
+        const existing = this.#envelopes.get(envelope.envelopeId);
+        if (existing !== undefined) {
+            if (JSON.stringify(existing.envelope) !== JSON.stringify(envelope)) {
+                this.#sendError(connection, new RelayOperationError("envelope_conflict", "envelope ID was reused with different content", requestId));
+            }
+            else if (existing.acknowledgement !== null) {
+                this.#sendAcknowledgement(connection, existing.acknowledgement);
+            }
+            return;
+        }
+        const delivery = {
+            requestId,
+            envelope,
+            sender: sender.connection,
+            target: target.connection,
+            acknowledgement: null,
+        };
+        this.#envelopes.set(envelope.envelopeId, delivery);
+        if (!this.#send(target.connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "envelope.delivery",
+            envelope,
+        })) {
+            this.#envelopes.delete(envelope.envelopeId);
+            this.#sendError(connection, new RelayOperationError("route_not_found", `target route is disconnected: ${envelope.targetRouteId}`, requestId));
+        }
+    }
+    #acknowledgeEnvelope(connection, acknowledgement) {
+        if (this.#ownedRoute(connection, acknowledgement.targetRouteId, acknowledgement.requestId) === null)
+            return;
+        const delivery = this.#envelopes.get(acknowledgement.envelopeId);
+        if (delivery === undefined) {
+            this.#sendError(connection, new RelayOperationError("route_not_found", `unknown envelope: ${acknowledgement.envelopeId}`, acknowledgement.requestId));
+            return;
+        }
+        if (delivery.target !== connection) {
+            this.#sendError(connection, new RelayOperationError("route_not_owned", "only the target connection may acknowledge this envelope", acknowledgement.requestId));
+            return;
+        }
+        if (delivery.envelope.targetRouteId !== acknowledgement.targetRouteId) {
+            this.#sendError(connection, new RelayOperationError("route_not_owned", "acknowledgement target route does not match the envelope", acknowledgement.requestId));
+            return;
+        }
+        if (delivery.envelope.event.eventId !== acknowledgement.eventId) {
+            this.#sendError(connection, new RelayOperationError("envelope_conflict", "acknowledgement event ID does not match the envelope", acknowledgement.requestId));
+            return;
+        }
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "envelope.acknowledge.accepted",
+            requestId: acknowledgement.requestId,
+            envelopeId: acknowledgement.envelopeId,
+            eventId: acknowledgement.eventId,
+        });
+        if (delivery.acknowledgement === null) {
+            delivery.acknowledgement = acknowledgement;
+            this.#sendAcknowledgement(delivery.sender, acknowledgement);
+        }
+    }
+    #sendAcknowledgement(connection, acknowledgement) {
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "envelope.acknowledged",
+            envelopeId: acknowledgement.envelopeId,
+            eventId: acknowledgement.eventId,
+            status: acknowledgement.status,
+            receivedAt: acknowledgement.receivedAt,
+            ...(acknowledgement.error === undefined ? {} : { error: acknowledgement.error }),
+        });
+    }
+    #ownedRoute(connection, routeId, requestId) {
+        const registered = this.#agents.get(routeId);
+        if (registered === undefined) {
+            this.#sendError(connection, new RelayOperationError("route_not_found", `route is not live: ${routeId}`, requestId));
+            return null;
+        }
+        if (registered.connection !== connection) {
+            this.#sendError(connection, new RelayOperationError("route_not_owned", `route belongs to another connection: ${routeId}`, requestId));
+            return null;
+        }
+        return registered;
+    }
+    #removeRoute(routeId) {
+        const registered = this.#agents.get(routeId);
+        if (registered === undefined)
+            return;
+        this.#agents.delete(routeId);
+        registered.connection.routeIds.delete(routeId);
+        for (const [envelopeId, delivery] of this.#envelopes) {
+            if (delivery.envelope.senderRouteId === routeId) {
+                this.#envelopes.delete(envelopeId);
+            }
+            else if (delivery.envelope.targetRouteId === routeId) {
+                if (delivery.acknowledgement === null) {
+                    this.#sendError(delivery.sender, new RelayOperationError("route_not_found", `target route disconnected: ${routeId}`, delivery.requestId));
+                }
+                this.#envelopes.delete(envelopeId);
+            }
+        }
+    }
+    #disconnect(connection) {
+        if (!this.#connections.delete(connection.socket))
+            return;
+        for (const routeId of [...connection.routeIds])
+            this.#removeRoute(routeId);
+    }
+    #leaseExpiry(leaseSeconds) {
+        return new Date(this.#now().getTime() + leaseSeconds * 1_000).toISOString();
+    }
+    #send(connection, message) {
+        if (connection.socket.readyState !== WebSocket.OPEN)
+            return false;
+        try {
+            const encoded = JSON.stringify(message);
+            if (Buffer.byteLength(encoded, "utf8") > PROTOCOL_LIMITS.encodedMessageBytes)
+                return false;
+            connection.socket.send(encoded);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    #sendError(connection, error) {
+        const operationError = error instanceof RelayOperationError ? error : null;
+        const protocolError = error instanceof NetworkProtocolError ? error : null;
+        const code = operationError?.code ?? protocolError?.code ?? "malformed_message";
+        const message = error instanceof Error ? error.message : "relay operation failed";
+        this.#send(connection, {
+            protocolVersion: PROTOCOL_VERSION,
+            type: "protocol.error",
+            code,
+            message: message.slice(0, PROTOCOL_LIMITS.errorCharacters),
+            ...(operationError?.requestId === undefined ? {} : { requestId: operationError.requestId }),
+            ...(code === "protocol_mismatch" ? { supportedVersion: PROTOCOL_VERSION } : {}),
+        });
+    }
+}
+class RelayOperationError extends Error {
+    code;
+    requestId;
+    constructor(code, message, requestId) {
+        super(message);
+        this.code = code;
+        this.requestId = requestId;
+    }
+}
+function requestIdOf(message) {
+    return "requestId" in message ? message.requestId : undefined;
+}
+function rejectUpgrade(socket) {
+    socket.end("HTTP/1.1 404 Not Found\r\nConnection: close\r\n\r\n");
+}
+function listen(server, port, host) {
+    return new Promise((resolve, reject) => {
+        const onError = (error) => {
+            server.off("listening", onListening);
+            reject(error);
+        };
+        const onListening = () => {
+            server.off("error", onError);
+            resolve();
+        };
+        server.once("error", onError);
+        server.once("listening", onListening);
+        server.listen(port, host);
+    });
+}
+function closeHttpServer(server) {
+    if (!server.listening)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        server.close((error) => error === undefined ? resolve() : reject(error));
+    });
+}
+function closeWebSocketServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => error === undefined ? resolve() : reject(error));
+    });
+}
+//# sourceMappingURL=server.js.map

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

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

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

@@ -0,0 +1,65 @@
+import type { PortalService, RunnerCompletion } from "../service.js";
+import type { StoredRemoteTask, StoredRemoteTaskEvent } from "../storage/repository.js";
+import { RemoteCoordinator } from "./coordinator.js";
+import { type EnvelopeAcknowledged } from "./protocol.js";
+export interface DelegateRemoteTaskInput {
+    senderSessionId: string;
+    target: string;
+    objective: string;
+    context?: string;
+    expectedResult?: string;
+    ttlSeconds?: number;
+}
+export interface RemoteTaskCandidate {
+    routeId: string;
+    agentName: string;
+    description: string;
+    state: "available" | "busy";
+    authenticated: false;
+}
+export type DelegateRemoteTaskResult = {
+    delivery: "not_sent";
+    resolution: "unresolved" | "ambiguous";
+    candidates: RemoteTaskCandidate[];
+} | {
+    delivery: "delivered";
+    task: StoredRemoteTask;
+    target: RemoteTaskCandidate;
+    acknowledgement: EnvelopeAcknowledged;
+};
+export type RemoteTaskUpdate = {
+    action: "accepted";
+    message?: string;
+} | {
+    action: "declined";
+    reason?: string;
+} | {
+    action: "running";
+    message?: string;
+} | {
+    action: "progress";
+    message: string;
+} | {
+    action: "question";
+    question: string;
+} | {
+    action: "answer";
+    answer: string;
+} | {
+    action: "completed";
+    result: string;
+    artifactReferences?: string[];
+} | {
+    action: "failed";
+    error: string;
+};
+/** Bridges durable local task events to transport-independent relay envelopes. */
+export declare class RemoteTaskManager {
+    #private;
+    constructor(service: PortalService, remote: RemoteCoordinator);
+    close(): void;
+    delegate(input: DelegateRemoteTaskInput): Promise<DelegateRemoteTaskResult>;
+    update(localSessionId: string, taskId: string, update: RemoteTaskUpdate): Promise<StoredRemoteTaskEvent>;
+    runnerCompleted(completion: RunnerCompletion): Promise<void>;
+    runnerFailed(completion: RunnerCompletion): Promise<void>;
+}