@mquan/portal 0.0.1

package/dist/src/network/protocol.js

@@ -0,0 +1,360 @@
+import { z } from "zod";
+export const PROTOCOL_VERSION = 1;
+export const PROTOCOL_LIMITS = Object.freeze({
+    encodedMessageBytes: 64 * 1024,
+    idCharacters: 128,
+    agentNameCharacters: 64,
+    descriptionCharacters: 280,
+    discoveryQueryCharacters: 256,
+    objectiveCharacters: 4 * 1024,
+    contextCharacters: 16 * 1024,
+    expectedResultCharacters: 2 * 1024,
+    eventBodyCharacters: 32 * 1024,
+    errorCharacters: 2 * 1024,
+    artifactReferenceCharacters: 2 * 1024,
+    artifactReferences: 16,
+    capabilities: 16,
+    presenceResults: 100,
+    minimumHeartbeatSeconds: 5,
+    maximumHeartbeatSeconds: 60,
+    minimumLeaseSeconds: 15,
+    maximumLeaseSeconds: 120,
+    maximumTaskTtlMilliseconds: 24 * 60 * 60 * 1_000,
+});
+export class NetworkProtocolError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "NetworkProtocolError";
+    }
+}
+const protocolShape = { protocolVersion: z.literal(PROTOCOL_VERSION) };
+const idSchema = z.string().trim().min(1).max(PROTOCOL_LIMITS.idCharacters)
+    .regex(/^[A-Za-z0-9][A-Za-z0-9._:-]*$/, "must be an opaque protocol identifier");
+const timestampSchema = z.string().datetime({ offset: true });
+const agentNameSchema = z.string().trim().min(1).max(PROTOCOL_LIMITS.agentNameCharacters);
+const descriptionSchema = z.string().trim().min(1).max(PROTOCOL_LIMITS.descriptionCharacters);
+const heartbeatSecondsSchema = z.number().int()
+    .min(PROTOCOL_LIMITS.minimumHeartbeatSeconds)
+    .max(PROTOCOL_LIMITS.maximumHeartbeatSeconds);
+const leaseSecondsSchema = z.number().int()
+    .min(PROTOCOL_LIMITS.minimumLeaseSeconds)
+    .max(PROTOCOL_LIMITS.maximumLeaseSeconds);
+export const providerSchema = z.enum(["codex", "claude"]);
+export const capabilitySchema = z.enum(["message", "task"]);
+export const presenceStateSchema = z.enum(["available", "busy"]);
+export const taskEventKindSchema = z.enum([
+    "offer",
+    "accepted",
+    "declined",
+    "running",
+    "progress",
+    "question",
+    "answer",
+    "completed",
+    "failed",
+]);
+export const taskStateSchema = z.enum([
+    "offered",
+    "accepted",
+    "declined",
+    "running",
+    "completed",
+    "failed",
+]);
+const registrationShape = {
+    sessionId: idSchema,
+    agentName: agentNameSchema,
+    provider: providerSchema,
+    description: descriptionSchema,
+    capabilities: z.array(capabilitySchema).min(1).max(PROTOCOL_LIMITS.capabilities),
+    state: presenceStateSchema,
+};
+export const agentPresenceSchema = z.object({
+    routeId: idSchema,
+    ...registrationShape,
+    expiresAt: timestampSchema,
+}).strict();
+export const clientHelloSchema = z.object({
+    ...protocolShape,
+    type: z.literal("client.hello"),
+    clientId: idSchema,
+    installationId: idSchema,
+    sentAt: timestampSchema,
+}).strict();
+export const serverHelloSchema = z.object({
+    ...protocolShape,
+    type: z.literal("server.hello"),
+    connectionId: idSchema,
+    heartbeatIntervalSeconds: heartbeatSecondsSchema,
+    sentAt: timestampSchema,
+}).strict();
+export const agentRegisterSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.register"),
+    requestId: idSchema,
+    ...registrationShape,
+    leaseSeconds: leaseSecondsSchema,
+}).strict();
+export const agentRegisteredSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.registered"),
+    requestId: idSchema,
+    agent: agentPresenceSchema,
+}).strict();
+export const agentRenewSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.renew"),
+    requestId: idSchema,
+    routeId: idSchema,
+    state: presenceStateSchema.optional(),
+    leaseSeconds: leaseSecondsSchema,
+}).strict();
+export const agentRenewedSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.renewed"),
+    requestId: idSchema,
+    agent: agentPresenceSchema,
+}).strict();
+export const agentUnregisterSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.unregister"),
+    requestId: idSchema,
+    routeId: idSchema,
+}).strict();
+export const agentUnregisteredSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.unregistered"),
+    requestId: idSchema,
+    routeId: idSchema,
+}).strict();
+export const agentDiscoverSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.discover"),
+    requestId: idSchema,
+    query: z.string().trim().min(1).max(PROTOCOL_LIMITS.discoveryQueryCharacters).optional(),
+    capability: capabilitySchema.optional(),
+    limit: z.number().int().min(1).max(PROTOCOL_LIMITS.presenceResults).default(20),
+}).strict();
+export const agentPresenceResultSchema = z.object({
+    ...protocolShape,
+    type: z.literal("agent.presence"),
+    requestId: idSchema,
+    agents: z.array(agentPresenceSchema).max(PROTOCOL_LIMITS.presenceResults),
+}).strict();
+const taskEventBaseShape = {
+    eventId: idSchema,
+    taskId: idSchema,
+    createdAt: timestampSchema,
+};
+const bodySchema = z.string().trim().min(1).max(PROTOCOL_LIMITS.eventBodyCharacters);
+export const taskOfferEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("offer"),
+    state: z.literal("offered"),
+    objective: z.string().trim().min(1).max(PROTOCOL_LIMITS.objectiveCharacters),
+    context: z.string().trim().min(1).max(PROTOCOL_LIMITS.contextCharacters).optional(),
+    expectedResult: z.string().trim().min(1).max(PROTOCOL_LIMITS.expectedResultCharacters).optional(),
+}).strict();
+export const taskAcceptedEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("accepted"),
+    state: z.literal("accepted"),
+    message: bodySchema.optional(),
+}).strict();
+export const taskDeclinedEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("declined"),
+    state: z.literal("declined"),
+    reason: bodySchema.optional(),
+}).strict();
+export const taskRunningEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("running"),
+    state: z.literal("running"),
+    message: bodySchema.optional(),
+}).strict();
+export const taskProgressEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("progress"),
+    state: z.literal("running"),
+    message: bodySchema,
+}).strict();
+export const taskQuestionEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("question"),
+    state: z.literal("running"),
+    question: bodySchema,
+}).strict();
+export const taskAnswerEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("answer"),
+    state: z.literal("running"),
+    answer: bodySchema,
+}).strict();
+export const taskCompletedEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("completed"),
+    state: z.literal("completed"),
+    result: bodySchema,
+    artifactReferences: z.array(z.string().trim().min(1).max(PROTOCOL_LIMITS.artifactReferenceCharacters)).max(PROTOCOL_LIMITS.artifactReferences).optional(),
+}).strict();
+export const taskFailedEventSchema = z.object({
+    ...taskEventBaseShape,
+    kind: z.literal("failed"),
+    state: z.literal("failed"),
+    error: z.string().trim().min(1).max(PROTOCOL_LIMITS.errorCharacters),
+}).strict();
+export const taskEventSchema = z.discriminatedUnion("kind", [
+    taskOfferEventSchema,
+    taskAcceptedEventSchema,
+    taskDeclinedEventSchema,
+    taskRunningEventSchema,
+    taskProgressEventSchema,
+    taskQuestionEventSchema,
+    taskAnswerEventSchema,
+    taskCompletedEventSchema,
+    taskFailedEventSchema,
+]);
+export const envelopeSchema = z.object({
+    envelopeId: idSchema,
+    senderRouteId: idSchema,
+    targetRouteId: idSchema,
+    sentAt: timestampSchema,
+    expiresAt: timestampSchema,
+    event: taskEventSchema,
+}).strict().superRefine((envelope, context) => {
+    const sentAt = Date.parse(envelope.sentAt);
+    const expiresAt = Date.parse(envelope.expiresAt);
+    if (expiresAt <= sentAt) {
+        context.addIssue({ code: "custom", path: ["expiresAt"], message: "must be after sentAt" });
+    }
+    else if (expiresAt - sentAt > PROTOCOL_LIMITS.maximumTaskTtlMilliseconds) {
+        context.addIssue({
+            code: "custom",
+            path: ["expiresAt"],
+            message: "task expiry exceeds the maximum TTL",
+        });
+    }
+});
+export const envelopeSendSchema = z.object({
+    ...protocolShape,
+    type: z.literal("envelope.send"),
+    requestId: idSchema,
+    envelope: envelopeSchema,
+}).strict();
+export const envelopeDeliverySchema = z.object({
+    ...protocolShape,
+    type: z.literal("envelope.delivery"),
+    envelope: envelopeSchema,
+}).strict();
+export const envelopeAcknowledgeSchema = z.object({
+    ...protocolShape,
+    type: z.literal("envelope.acknowledge"),
+    requestId: idSchema,
+    targetRouteId: idSchema,
+    envelopeId: idSchema,
+    eventId: idSchema,
+    status: z.enum(["received", "rejected"]),
+    receivedAt: timestampSchema,
+    error: z.string().trim().min(1).max(PROTOCOL_LIMITS.errorCharacters).optional(),
+}).strict().superRefine((acknowledgement, context) => {
+    if (acknowledgement.status === "rejected" && acknowledgement.error === undefined) {
+        context.addIssue({ code: "custom", path: ["error"], message: "is required when rejected" });
+    }
+    if (acknowledgement.status === "received" && acknowledgement.error !== undefined) {
+        context.addIssue({ code: "custom", path: ["error"], message: "is not allowed when received" });
+    }
+});
+export const envelopeAcknowledgeAcceptedSchema = z.object({
+    ...protocolShape,
+    type: z.literal("envelope.acknowledge.accepted"),
+    requestId: idSchema,
+    envelopeId: idSchema,
+    eventId: idSchema,
+}).strict();
+export const envelopeAcknowledgedSchema = z.object({
+    ...protocolShape,
+    type: z.literal("envelope.acknowledged"),
+    envelopeId: idSchema,
+    eventId: idSchema,
+    status: z.enum(["received", "rejected"]),
+    receivedAt: timestampSchema,
+    error: z.string().trim().min(1).max(PROTOCOL_LIMITS.errorCharacters).optional(),
+}).strict();
+export const protocolErrorSchema = z.object({
+    ...protocolShape,
+    type: z.literal("protocol.error"),
+    requestId: idSchema.optional(),
+    code: z.enum([
+        "protocol_mismatch",
+        "malformed_message",
+        "message_too_large",
+        "handshake_required",
+        "invalid_state",
+        "not_connected",
+        "route_not_found",
+        "route_not_owned",
+        "envelope_expired",
+        "envelope_conflict",
+        "internal_error",
+    ]),
+    message: z.string().trim().min(1).max(PROTOCOL_LIMITS.errorCharacters),
+    supportedVersion: z.literal(PROTOCOL_VERSION).optional(),
+}).strict();
+export const clientMessageSchema = z.discriminatedUnion("type", [
+    clientHelloSchema,
+    agentRegisterSchema,
+    agentRenewSchema,
+    agentUnregisterSchema,
+    agentDiscoverSchema,
+    envelopeSendSchema,
+    envelopeAcknowledgeSchema,
+]);
+export const serverMessageSchema = z.discriminatedUnion("type", [
+    serverHelloSchema,
+    agentRegisteredSchema,
+    agentRenewedSchema,
+    agentUnregisteredSchema,
+    agentPresenceResultSchema,
+    envelopeDeliverySchema,
+    envelopeAcknowledgeAcceptedSchema,
+    envelopeAcknowledgedSchema,
+    protocolErrorSchema,
+]);
+export const networkMessageSchema = z.union([clientMessageSchema, serverMessageSchema]);
+/** M0 compatibility rule: peers communicate only when protocol versions are exactly equal. */
+export function isProtocolVersionCompatible(peerVersion) {
+    return peerVersion === PROTOCOL_VERSION;
+}
+/** Parse a decoded object or a UTF-8 JSON WebSocket frame with uniform wire errors. */
+export function parseNetworkMessage(input) {
+    let decoded = input;
+    if (typeof input === "string") {
+        if (Buffer.byteLength(input, "utf8") > PROTOCOL_LIMITS.encodedMessageBytes) {
+            throw new NetworkProtocolError("message_too_large", "encoded message exceeds protocol limit");
+        }
+        try {
+            decoded = JSON.parse(input);
+        }
+        catch (error) {
+            throw new NetworkProtocolError("malformed_message", "message is not valid JSON", error);
+        }
+    }
+    if (isRecord(decoded) && typeof decoded.protocolVersion === "number"
+        && !isProtocolVersionCompatible(decoded.protocolVersion)) {
+        throw new NetworkProtocolError("protocol_mismatch", `unsupported protocol version ${decoded.protocolVersion}; expected ${PROTOCOL_VERSION}`);
+    }
+    const result = networkMessageSchema.safeParse(decoded);
+    if (!result.success) {
+        throw new NetworkProtocolError("malformed_message", "message does not match the protocol", result.error);
+    }
+    return result.data;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=protocol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/network/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,mBAAmB,EAAE,EAAE,GAAG,IAAI;IAC9B,YAAY,EAAE,GAAG;IACjB,mBAAmB,EAAE,EAAE;IACvB,qBAAqB,EAAE,GAAG;IAC1B,wBAAwB,EAAE,GAAG;IAC7B,mBAAmB,EAAE,CAAC,GAAG,IAAI;IAC7B,iBAAiB,EAAE,EAAE,GAAG,IAAI;IAC5B,wBAAwB,EAAE,CAAC,GAAG,IAAI;IAClC,mBAAmB,EAAE,EAAE,GAAG,IAAI;IAC9B,eAAe,EAAE,CAAC,GAAG,IAAI;IACzB,2BAA2B,EAAE,CAAC,GAAG,IAAI;IACrC,kBAAkB,EAAE,EAAE;IACtB,YAAY,EAAE,EAAE;IAChB,eAAe,EAAE,GAAG;IACpB,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,mBAAmB,EAAE,GAAG;IACxB,0BAA0B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK;CACjD,CAAC,CAAC;AAeH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAElC,IAAI;IAEJ,OAAO;IAHlB,YACW,IAAuB,EAChC,OAAe,EACN,OAAiB;QAE1B,KAAK,CAAC,OAAO,CAAC,CAAC;oBAJN,IAAI;uBAEJ,OAAO;QAGhB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,aAAa,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;AACvE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC;KACxE,KAAK,CAAC,+BAA+B,EAAE,uCAAuC,CAAC,CAAC;AACnF,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAC1F,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC;AAC9F,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;KAC5C,GAAG,CAAC,eAAe,CAAC,uBAAuB,CAAC;KAC5C,GAAG,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;AAChD,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;KACxC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC;KACxC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAE5C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACxC,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,UAAU;IACV,UAAU;IACV,QAAQ;IACR,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,SAAS;IACT,UAAU;IACV,UAAU;IACV,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG;IACxB,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,cAAc;IACxB,WAAW,EAAE,iBAAiB;IAC9B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC;IAChF,KAAK,EAAE,mBAAmB;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,QAAQ;IACjB,GAAG,iBAAiB;IACpB,SAAS,EAAE,eAAe;CAC3B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ;IAClB,cAAc,EAAE,QAAQ;IACxB,MAAM,EAAE,eAAe;CACxB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,YAAY,EAAE,QAAQ;IACtB,wBAAwB,EAAE,sBAAsB;IAChD,MAAM,EAAE,eAAe;CACxB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,SAAS,EAAE,QAAQ;IACnB,GAAG,iBAAiB;IACpB,YAAY,EAAE,kBAAkB;CACjC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,mBAAmB;CAC3B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,KAAK,EAAE,mBAAmB,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,kBAAkB;CACjC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,mBAAmB;CAC3B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACnC,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACxF,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAChF,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC;CAC1E,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,kBAAkB,GAAG;IACzB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,eAAe;CAC3B,CAAC;AACF,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,mBAAmB,CAAC;IAC5E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IACnF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;CAClG,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5B,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,OAAO,EAAE,UAAU;CACpB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,QAAQ,EAAE,UAAU;CACrB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3B,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC7B,MAAM,EAAE,UAAU;IAClB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CACzB,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,2BAA2B,CAAC,CAC1E,CAAC,GAAG,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,kBAAkB;IACrB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC;CACrE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC1D,oBAAoB;IACpB,uBAAuB;IACvB,uBAAuB;IACvB,sBAAsB;IACtB,uBAAuB;IACvB,uBAAuB;IACvB,qBAAqB;IACrB,wBAAwB;IACxB,qBAAqB;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,QAAQ;IACpB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,eAAe;IAC1B,KAAK,EAAE,eAAe;CACvB,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC7F,CAAC;SAAM,IAAI,SAAS,GAAG,MAAM,GAAG,eAAe,CAAC,0BAA0B,EAAE,CAAC;QAC3E,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,OAAO,EAAE,qCAAqC;SAC/C,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,QAAQ;IACnB,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,QAAQ,EAAE,cAAc;CACzB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACvC,SAAS,EAAE,QAAQ;IACnB,aAAa,EAAE,QAAQ;IACvB,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxC,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAChF,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,EAAE;IACnD,IAAI,eAAe,CAAC,MAAM,KAAK,UAAU,IAAI,eAAe,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjF,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,eAAe,CAAC,MAAM,KAAK,UAAU,IAAI,eAAe,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjF,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACjG,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,+BAA+B,CAAC;IAChD,SAAS,EAAE,QAAQ;IACnB,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,QAAQ;CAClB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACxC,UAAU,EAAE,QAAQ;IACpB,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxC,UAAU,EAAE,eAAe;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAChF,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,aAAa;IAChB,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,mBAAmB;QACnB,mBAAmB;QACnB,mBAAmB;QACnB,oBAAoB;QACpB,eAAe;QACf,eAAe;QACf,iBAAiB;QACjB,iBAAiB;QACjB,kBAAkB;QAClB,mBAAmB;QACnB,gBAAgB;KACjB,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,eAAe,CAAC;IACtE,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9D,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,mBAAmB;IACnB,kBAAkB;IAClB,yBAAyB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC9D,iBAAiB;IACjB,qBAAqB;IACrB,kBAAkB;IAClB,uBAAuB;IACvB,yBAAyB;IACzB,sBAAsB;IACtB,iCAAiC;IACjC,0BAA0B;IAC1B,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AA2BxF,8FAA8F;AAC9F,MAAM,UAAU,2BAA2B,CAAC,WAAmB;IAC7D,OAAO,WAAW,KAAK,gBAAgB,CAAC;AAC1C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,KAAuB;IACzD,IAAI,OAAO,GAAY,KAAK,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,eAAe,CAAC,mBAAmB,EAAE,CAAC;YAC3E,MAAM,IAAI,oBAAoB,CAAC,mBAAmB,EAAE,wCAAwC,CAAC,CAAC;QAChG,CAAC;QACD,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,oBAAoB,CAAC,mBAAmB,EAAE,2BAA2B,EAAE,KAAK,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ;WAC/D,CAAC,2BAA2B,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,oBAAoB,CAC5B,mBAAmB,EACnB,gCAAgC,OAAO,CAAC,eAAe,cAAc,gBAAgB,EAAE,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,oBAAoB,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAQD,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

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

@@ -0,0 +1,28 @@
+export interface RelayServerOptions {
+    host?: string;
+    port?: number;
+    heartbeatIntervalSeconds?: number;
+    sweepIntervalMs?: number;
+    now?: () => Date;
+    idFactory?: () => string;
+}
+export interface RelayServerAddress {
+    host: string;
+    port: number;
+    httpUrl: string;
+    webSocketUrl: string;
+}
+/** In-memory demo registry and relay. Restarting it intentionally clears all state. */
+export declare class PortalRelayServer {
+    #private;
+    readonly host: string;
+    readonly port: number;
+    readonly heartbeatIntervalSeconds: number;
+    constructor(options?: RelayServerOptions);
+    get address(): RelayServerAddress | null;
+    get connectionCount(): number;
+    get agentCount(): number;
+    start(): Promise<RelayServerAddress>;
+    close(): Promise<void>;
+    sweepExpiredPresence(): void;
+}