@songsid/agend 2.3.5-alpha.4 → 2.3.5-alpha.5

package/dist/hub/protocol.d.ts

@@ -0,0 +1,779 @@
+/** Strict P1 frame schemas; importing this file creates no state, sockets or timers. */
+import { z } from "zod";
+import type { HubMemberFrame, HubServerFrame, HubAuthorizationRequest, HubAskerEnvelope } from "./types.js";
+export declare const HUB_VERSION = 1;
+export declare const HUB_PATHS: {
+    readonly pair: "/hub/v1/pair";
+    readonly claim: "/hub/v1/claim";
+    readonly connect: "/hub/v1/connect";
+};
+export declare const HUB_CAPABILITIES: readonly ["identity-v1", "receipts-v1", "reconcile-v1"];
+/** Optional link features this build offers, never required: an older peer that lacks one keeps working without it.
+ * `welcome-caps-v1` lets the Hub answer with its own list; a feature is enabled only when both ends list it. Each feature
+ * PR adds its own flag here (#3226: attachments-v1, buttons-v1, quota-band-v1) and checks `features` before sending. */
+export declare const HUB_OPTIONAL_CAPABILITIES: readonly string[];
+export declare const HUB_ATTACHMENT_FILE_MAX: number;
+export declare const HUB_ATTACHMENTS_PER_MESSAGE = 10;
+/** Raw bytes per attachment chunk: base64 (4/3) plus the frame envelope stays under HUB_LIMITS.frame (256 KiB). */
+export declare const HUB_ATTACHMENT_CHUNK: number;
+export declare const HUB_LIMITS: {
+    readonly frame: number;
+    readonly question: number;
+    readonly answer: number;
+    readonly pending: 32;
+    readonly sendQueue: number;
+    readonly heartbeat: 15000;
+    readonly rpcTimeout: 5000;
+};
+export declare const askerSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    issuer: z.ZodString;
+    issuerKeyId: z.ZodString;
+    messageId: z.ZodString;
+    asker: z.ZodObject<{
+        realm: z.ZodString;
+        objectId: z.ZodString;
+    }, z.core.$strict>;
+    owner: z.ZodObject<{
+        realm: z.ZodString;
+        objectId: z.ZodString;
+    }, z.core.$strict>;
+    destinationFleetId: z.ZodString;
+    exposureId: z.ZodString;
+    roomId: z.ZodString;
+    grantId: z.ZodString;
+    grantRevision: z.ZodNumber;
+    exposureRevision: z.ZodNumber;
+    revocationVersion: z.ZodNumber;
+    contentDigest: z.ZodString;
+    issuedAt: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    nonce: z.ZodString;
+    signature: z.ZodString;
+}, z.core.$strict>;
+export declare const exposureSchema: z.ZodObject<{
+    id: z.ZodString;
+    fleetId: z.ZodString;
+    owner: z.ZodObject<{
+        realm: z.ZodString;
+        objectId: z.ZodString;
+    }, z.core.$strict>;
+    displayName: z.ZodString;
+    revision: z.ZodNumber;
+    state: z.ZodEnum<{
+        frozen: "frozen";
+        published: "published";
+        withdrawn: "withdrawn";
+    }>;
+    dataViewId: z.ZodString;
+    allowedTools: z.ZodArray<z.ZodString>;
+    policyDigest: z.ZodString;
+}, z.core.$strict>;
+/** No extensible bag: percentages, provider/profile ids and precise reset times are refused. */
+export declare const quotaSchema: z.ZodUnion<readonly [z.ZodObject<{
+    band: z.ZodEnum<{
+        available: "available";
+        near_limit: "near_limit";
+        unknown: "unknown";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    band: z.ZodLiteral<"exhausted">;
+    resetsAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>]>;
+export declare const exposureQuotaSchema: z.ZodObject<{
+    exposureId: z.ZodString;
+    quota: z.ZodUnion<readonly [z.ZodObject<{
+        band: z.ZodEnum<{
+            available: "available";
+            near_limit: "near_limit";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        band: z.ZodLiteral<"exhausted">;
+        resetsAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+/** A file's name as shown and saved: one path segment, no control characters, no leading dot. */
+export declare const attachmentName: z.ZodString;
+export declare const attachmentMime: z.ZodString;
+export declare const attachmentRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    size: z.ZodNumber;
+    mime: z.ZodString;
+    sha256: z.ZodString;
+}, z.core.$strict>;
+/** `attachments` only ever goes to a peer whose link enabled attachments-v1 (an old peer's strict schema refuses it). */
+export declare const questionSchema: z.ZodObject<{
+    text: z.ZodString;
+    identity: z.ZodObject<{
+        v: z.ZodLiteral<1>;
+        issuer: z.ZodString;
+        issuerKeyId: z.ZodString;
+        messageId: z.ZodString;
+        asker: z.ZodObject<{
+            realm: z.ZodString;
+            objectId: z.ZodString;
+        }, z.core.$strict>;
+        owner: z.ZodObject<{
+            realm: z.ZodString;
+            objectId: z.ZodString;
+        }, z.core.$strict>;
+        destinationFleetId: z.ZodString;
+        exposureId: z.ZodString;
+        roomId: z.ZodString;
+        grantId: z.ZodString;
+        grantRevision: z.ZodNumber;
+        exposureRevision: z.ZodNumber;
+        revocationVersion: z.ZodNumber;
+        contentDigest: z.ZodString;
+        issuedAt: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+        nonce: z.ZodString;
+        signature: z.ZodString;
+    }, z.core.$strict>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        size: z.ZodNumber;
+        mime: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const receiptSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    contentDigest: z.ZodString;
+    stage: z.ZodEnum<{
+        answered: "answered";
+        cancelled: "cancelled";
+        consumed: "consumed";
+        delivered: "delivered";
+        failed: "failed";
+        queued: "queued";
+        rejected: "rejected";
+        uncertain: "uncertain";
+    }>;
+    sequence: z.ZodNumber;
+    at: z.ZodNumber;
+    memberDeliveryId: z.ZodOptional<z.ZodString>;
+    reasonCode: z.ZodOptional<z.ZodEnum<{
+        backpressure: "backpressure";
+        conflict: "conflict";
+        denied: "denied";
+        expired: "expired";
+        incompatible: "incompatible";
+        invalid: "invalid";
+        "not-found": "not-found";
+        revoked: "revoked";
+        stale: "stale";
+        unavailable: "unavailable";
+        uncertain: "uncertain";
+    }>>;
+}, z.core.$strict>;
+export declare const authorizationSchema: z.ZodUnion<readonly [z.ZodObject<{
+    messageId: z.ZodString;
+    operationId: z.ZodString;
+    exposureRevision: z.ZodNumber;
+    phase: z.ZodEnum<{
+        admit: "admit";
+        begin: "begin";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    messageId: z.ZodString;
+    operationId: z.ZodString;
+    exposureRevision: z.ZodNumber;
+    phase: z.ZodLiteral<"tool">;
+    tool: z.ZodObject<{
+        name: z.ZodString;
+        argumentsDigest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    messageId: z.ZodString;
+    operationId: z.ZodString;
+    exposureRevision: z.ZodNumber;
+    phase: z.ZodLiteral<"release-answer">;
+    answer: z.ZodObject<{
+        answerId: z.ZodString;
+        contentDigest: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export declare const leaseSchema: z.ZodObject<{
+    decisionId: z.ZodString;
+    messageId: z.ZodString;
+    operationId: z.ZodString;
+    phase: z.ZodEnum<{
+        admit: "admit";
+        begin: "begin";
+        "release-answer": "release-answer";
+        tool: "tool";
+    }>;
+    operationDigest: z.ZodString;
+    revocationVersion: z.ZodNumber;
+    exposureRevision: z.ZodNumber;
+    linkEpoch: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+}, z.core.$strict>;
+/** buttons-v1 uses the fleet's normalized poll config (the raw tool uses show_voters instead). */
+export declare const answerButtonsSchema: z.ZodObject<{
+    id: z.ZodString;
+    labels: z.ZodArray<z.ZodString>;
+    values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    poll: z.ZodOptional<z.ZodObject<{
+        seconds: z.ZodNumber;
+        multi: z.ZodBoolean;
+        reveal: z.ZodEnum<{
+            close: "close";
+            live: "live";
+        }>;
+        showVoters: z.ZodBoolean;
+        question: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const answerSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    answerId: z.ZodString;
+    text: z.ZodString;
+    contentDigest: z.ZodString;
+    releaseLease: z.ZodObject<{
+        decisionId: z.ZodString;
+        messageId: z.ZodString;
+        operationId: z.ZodString;
+        phase: z.ZodEnum<{
+            admit: "admit";
+            begin: "begin";
+            "release-answer": "release-answer";
+            tool: "tool";
+        }>;
+        operationDigest: z.ZodString;
+        revocationVersion: z.ZodNumber;
+        exposureRevision: z.ZodNumber;
+        linkEpoch: z.ZodNumber;
+        expiresAt: z.ZodNumber;
+    }, z.core.$strict>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        size: z.ZodNumber;
+        mime: z.ZodString;
+        sha256: z.ZodString;
+    }, z.core.$strict>>>;
+    buttons: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        labels: z.ZodArray<z.ZodString>;
+        values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        poll: z.ZodOptional<z.ZodObject<{
+            seconds: z.ZodNumber;
+            multi: z.ZodBoolean;
+            reveal: z.ZodEnum<{
+                close: "close";
+                live: "live";
+            }>;
+            showVoters: z.ZodBoolean;
+            question: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const revocationSchema: z.ZodObject<{
+    revocationVersion: z.ZodNumber;
+    reasonCode: z.ZodEnum<{
+        backpressure: "backpressure";
+        conflict: "conflict";
+        denied: "denied";
+        expired: "expired";
+        incompatible: "incompatible";
+        invalid: "invalid";
+        "not-found": "not-found";
+        revoked: "revoked";
+        stale: "stale";
+        unavailable: "unavailable";
+        uncertain: "uncertain";
+    }>;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"person">;
+        personId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"fleet">;
+        fleetId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"exposure">;
+        exposureId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"grant">;
+        grantId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+}, z.core.$strict>;
+export declare const memberFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"hello">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        supportedVersions: z.ZodArray<z.ZodNumber>;
+        capabilities: z.ZodArray<z.ZodString>;
+        memberBootId: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"exposure.snapshot">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        revision: z.ZodNumber;
+        exposures: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            fleetId: z.ZodString;
+            owner: z.ZodObject<{
+                realm: z.ZodString;
+                objectId: z.ZodString;
+            }, z.core.$strict>;
+            displayName: z.ZodString;
+            revision: z.ZodNumber;
+            state: z.ZodEnum<{
+                frozen: "frozen";
+                published: "published";
+                withdrawn: "withdrawn";
+            }>;
+            dataViewId: z.ZodString;
+            allowedTools: z.ZodArray<z.ZodString>;
+            policyDigest: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"receipt">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        messageId: z.ZodString;
+        contentDigest: z.ZodString;
+        stage: z.ZodEnum<{
+            answered: "answered";
+            cancelled: "cancelled";
+            consumed: "consumed";
+            delivered: "delivered";
+            failed: "failed";
+            queued: "queued";
+            rejected: "rejected";
+            uncertain: "uncertain";
+        }>;
+        sequence: z.ZodNumber;
+        at: z.ZodNumber;
+        memberDeliveryId: z.ZodOptional<z.ZodString>;
+        reasonCode: z.ZodOptional<z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"answer">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        messageId: z.ZodString;
+        answerId: z.ZodString;
+        text: z.ZodString;
+        contentDigest: z.ZodString;
+        releaseLease: z.ZodObject<{
+            decisionId: z.ZodString;
+            messageId: z.ZodString;
+            operationId: z.ZodString;
+            phase: z.ZodEnum<{
+                admit: "admit";
+                begin: "begin";
+                "release-answer": "release-answer";
+                tool: "tool";
+            }>;
+            operationDigest: z.ZodString;
+            revocationVersion: z.ZodNumber;
+            exposureRevision: z.ZodNumber;
+            linkEpoch: z.ZodNumber;
+            expiresAt: z.ZodNumber;
+        }, z.core.$strict>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            size: z.ZodNumber;
+            mime: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>>>;
+        buttons: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            labels: z.ZodArray<z.ZodString>;
+            values: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            poll: z.ZodOptional<z.ZodObject<{
+                seconds: z.ZodNumber;
+                multi: z.ZodBoolean;
+                reveal: z.ZodEnum<{
+                    close: "close";
+                    live: "live";
+                }>;
+                showVoters: z.ZodBoolean;
+                question: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"reconcile">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        afterReceiptSequence: z.ZodNumber;
+        messages: z.ZodArray<z.ZodObject<{
+            messageId: z.ZodString;
+            contentDigest: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"authorize.request">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        messageId: z.ZodString;
+        operationId: z.ZodString;
+        exposureRevision: z.ZodNumber;
+        phase: z.ZodEnum<{
+            admit: "admit";
+            begin: "begin";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        messageId: z.ZodString;
+        operationId: z.ZodString;
+        exposureRevision: z.ZodNumber;
+        phase: z.ZodLiteral<"tool">;
+        tool: z.ZodObject<{
+            name: z.ZodString;
+            argumentsDigest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        messageId: z.ZodString;
+        operationId: z.ZodString;
+        exposureRevision: z.ZodNumber;
+        phase: z.ZodLiteral<"release-answer">;
+        answer: z.ZodObject<{
+            answerId: z.ZodString;
+            contentDigest: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"error">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        code: z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>;
+        retryable: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"attachment.get">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        id: z.ZodString;
+        offset: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"attachment.put">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        id: z.ZodString;
+        offset: z.ZodNumber;
+        total: z.ZodNumber;
+        sha256: z.ZodString;
+        data: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"exposure.quota">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        exposureId: z.ZodString;
+        quota: z.ZodUnion<readonly [z.ZodObject<{
+            band: z.ZodEnum<{
+                available: "available";
+                near_limit: "near_limit";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            band: z.ZodLiteral<"exhausted">;
+            resetsAt: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export declare const serverFrameSchema: z.ZodUnion<readonly [z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"welcome">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        selectedVersion: z.ZodLiteral<1>;
+        hubId: z.ZodString;
+        fleetId: z.ZodString;
+        linkEpoch: z.ZodNumber;
+        revocationVersion: z.ZodNumber;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"question">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        text: z.ZodString;
+        identity: z.ZodObject<{
+            v: z.ZodLiteral<1>;
+            issuer: z.ZodString;
+            issuerKeyId: z.ZodString;
+            messageId: z.ZodString;
+            asker: z.ZodObject<{
+                realm: z.ZodString;
+                objectId: z.ZodString;
+            }, z.core.$strict>;
+            owner: z.ZodObject<{
+                realm: z.ZodString;
+                objectId: z.ZodString;
+            }, z.core.$strict>;
+            destinationFleetId: z.ZodString;
+            exposureId: z.ZodString;
+            roomId: z.ZodString;
+            grantId: z.ZodString;
+            grantRevision: z.ZodNumber;
+            exposureRevision: z.ZodNumber;
+            revocationVersion: z.ZodNumber;
+            contentDigest: z.ZodString;
+            issuedAt: z.ZodNumber;
+            expiresAt: z.ZodNumber;
+            nonce: z.ZodString;
+            signature: z.ZodString;
+        }, z.core.$strict>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            size: z.ZodNumber;
+            mime: z.ZodString;
+            sha256: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"receipt">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        messageId: z.ZodString;
+        contentDigest: z.ZodString;
+        stage: z.ZodEnum<{
+            answered: "answered";
+            cancelled: "cancelled";
+            consumed: "consumed";
+            delivered: "delivered";
+            failed: "failed";
+            queued: "queued";
+            rejected: "rejected";
+            uncertain: "uncertain";
+        }>;
+        sequence: z.ZodNumber;
+        at: z.ZodNumber;
+        memberDeliveryId: z.ZodOptional<z.ZodString>;
+        reasonCode: z.ZodOptional<z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"reconcile">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        receipts: z.ZodArray<z.ZodObject<{
+            messageId: z.ZodString;
+            contentDigest: z.ZodString;
+            stage: z.ZodEnum<{
+                answered: "answered";
+                cancelled: "cancelled";
+                consumed: "consumed";
+                delivered: "delivered";
+                failed: "failed";
+                queued: "queued";
+                rejected: "rejected";
+                uncertain: "uncertain";
+            }>;
+            sequence: z.ZodNumber;
+            at: z.ZodNumber;
+            memberDeliveryId: z.ZodOptional<z.ZodString>;
+            reasonCode: z.ZodOptional<z.ZodEnum<{
+                backpressure: "backpressure";
+                conflict: "conflict";
+                denied: "denied";
+                expired: "expired";
+                incompatible: "incompatible";
+                invalid: "invalid";
+                "not-found": "not-found";
+                revoked: "revoked";
+                stale: "stale";
+                unavailable: "unavailable";
+                uncertain: "uncertain";
+            }>>;
+        }, z.core.$strict>>;
+        nextReceiptSequence: z.ZodNumber;
+        more: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"authorize.result">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodUnion<readonly [z.ZodObject<{
+        ok: z.ZodLiteral<true>;
+        lease: z.ZodObject<{
+            decisionId: z.ZodString;
+            messageId: z.ZodString;
+            operationId: z.ZodString;
+            phase: z.ZodEnum<{
+                admit: "admit";
+                begin: "begin";
+                "release-answer": "release-answer";
+                tool: "tool";
+            }>;
+            operationDigest: z.ZodString;
+            revocationVersion: z.ZodNumber;
+            exposureRevision: z.ZodNumber;
+            linkEpoch: z.ZodNumber;
+            expiresAt: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>, z.ZodObject<{
+        ok: z.ZodLiteral<false>;
+        reasonCode: z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"revoke">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        revocationVersion: z.ZodNumber;
+        reasonCode: z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"person">;
+            personId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"fleet">;
+            fleetId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"exposure">;
+            exposureId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"grant">;
+            grantId: z.ZodString;
+        }, z.core.$strict>], "kind">;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"error">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        code: z.ZodEnum<{
+            backpressure: "backpressure";
+            conflict: "conflict";
+            denied: "denied";
+            expired: "expired";
+            incompatible: "incompatible";
+            invalid: "invalid";
+            "not-found": "not-found";
+            revoked: "revoked";
+            stale: "stale";
+            unavailable: "unavailable";
+            uncertain: "uncertain";
+        }>;
+        retryable: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"attachment.chunk">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        id: z.ZodString;
+        offset: z.ZodNumber;
+        total: z.ZodNumber;
+        sha256: z.ZodString;
+        data: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"attachment.ack">;
+    requestId: z.ZodString;
+    linkEpoch: z.ZodNumber;
+    payload: z.ZodObject<{
+        id: z.ZodString;
+        offset: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>]>;
+export declare const parseMemberFrame: (input: string | Buffer) => HubMemberFrame;
+export declare const parseServerFrame: (input: string | Buffer) => HubServerFrame;
+export declare function encodeMemberFrame(value: HubMemberFrame): string;
+export declare function encodeServerFrame(value: HubServerFrame): string;
+export declare const validateAsker: (input: unknown) => HubAskerEnvelope;
+export declare const validateAuthorization: (input: unknown) => HubAuthorizationRequest;