@pairlobby/protocol 0.11.0

package/dist/records.d.ts

@@ -0,0 +1,1109 @@
+import { z } from 'zod';
+export declare const RoomLifecycle: z.ZodEnum<["open", "closed", "expired", "deleted"]>;
+export type RoomLifecycle = z.infer<typeof RoomLifecycle>;
+export declare const RoomPolicySchema: z.ZodObject<{
+    joinPolicy: z.ZodDefault<z.ZodEnum<["invite_only", "open_to_guests"]>>;
+    inviteRole: z.ZodOptional<z.ZodEnum<["member", "guest"]>>;
+    autoClose: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+        mode: z.ZodLiteral<"off">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "off";
+    }, {
+        mode: "off";
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"inactivity">;
+        afterMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        mode: "inactivity";
+        afterMs: number;
+    }, {
+        mode: "inactivity";
+        afterMs: number;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"age">;
+        afterMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        mode: "age";
+        afterMs: number;
+    }, {
+        mode: "age";
+        afterMs: number;
+    }>, z.ZodObject<{
+        mode: z.ZodLiteral<"agents_and_guests_left">;
+    }, "strip", z.ZodTypeAny, {
+        mode: "agents_and_guests_left";
+    }, {
+        mode: "agents_and_guests_left";
+    }>]>>;
+    localJoin: z.ZodOptional<z.ZodBoolean>;
+    maxParticipants: z.ZodNumber;
+    maxEventPayloadBytes: z.ZodNumber;
+    maxRetainedEventBytes: z.ZodNumber;
+    maxRetainedEvents: z.ZodNumber;
+    roomLifetimeMs: z.ZodNullable<z.ZodNumber>;
+    inviteLifetimeMs: z.ZodNullable<z.ZodNumber>;
+    exportWindowMs: z.ZodNumber;
+    connectTicketLifetimeMs: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    joinPolicy: "invite_only" | "open_to_guests";
+    maxParticipants: number;
+    maxEventPayloadBytes: number;
+    maxRetainedEventBytes: number;
+    maxRetainedEvents: number;
+    roomLifetimeMs: number | null;
+    inviteLifetimeMs: number | null;
+    exportWindowMs: number;
+    connectTicketLifetimeMs: number;
+    autoClose?: {
+        mode: "off";
+    } | {
+        mode: "inactivity";
+        afterMs: number;
+    } | {
+        mode: "age";
+        afterMs: number;
+    } | {
+        mode: "agents_and_guests_left";
+    } | undefined;
+    inviteRole?: "guest" | "member" | undefined;
+    localJoin?: boolean | undefined;
+}, {
+    maxParticipants: number;
+    maxEventPayloadBytes: number;
+    maxRetainedEventBytes: number;
+    maxRetainedEvents: number;
+    roomLifetimeMs: number | null;
+    inviteLifetimeMs: number | null;
+    exportWindowMs: number;
+    connectTicketLifetimeMs: number;
+    autoClose?: {
+        mode: "off";
+    } | {
+        mode: "inactivity";
+        afterMs: number;
+    } | {
+        mode: "age";
+        afterMs: number;
+    } | {
+        mode: "agents_and_guests_left";
+    } | undefined;
+    joinPolicy?: "invite_only" | "open_to_guests" | undefined;
+    inviteRole?: "guest" | "member" | undefined;
+    localJoin?: boolean | undefined;
+}>;
+export declare const RoomRecord: z.ZodObject<{
+    roomId: z.ZodString;
+    name: z.ZodString;
+    createdAt: z.ZodNumber;
+    /** Null for a room that does not expire. */
+    expiresAt: z.ZodNullable<z.ZodNumber>;
+    closedAt: z.ZodNullable<z.ZodNumber>;
+    lifecycle: z.ZodEnum<["open", "closed", "expired", "deleted"]>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    policy: z.ZodObject<{
+        joinPolicy: z.ZodDefault<z.ZodEnum<["invite_only", "open_to_guests"]>>;
+        inviteRole: z.ZodOptional<z.ZodEnum<["member", "guest"]>>;
+        autoClose: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"inactivity">;
+            afterMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "inactivity";
+            afterMs: number;
+        }, {
+            mode: "inactivity";
+            afterMs: number;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"age">;
+            afterMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "age";
+            afterMs: number;
+        }, {
+            mode: "age";
+            afterMs: number;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"agents_and_guests_left">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "agents_and_guests_left";
+        }, {
+            mode: "agents_and_guests_left";
+        }>]>>;
+        localJoin: z.ZodOptional<z.ZodBoolean>;
+        maxParticipants: z.ZodNumber;
+        maxEventPayloadBytes: z.ZodNumber;
+        maxRetainedEventBytes: z.ZodNumber;
+        maxRetainedEvents: z.ZodNumber;
+        roomLifetimeMs: z.ZodNullable<z.ZodNumber>;
+        inviteLifetimeMs: z.ZodNullable<z.ZodNumber>;
+        exportWindowMs: z.ZodNumber;
+        connectTicketLifetimeMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        joinPolicy: "invite_only" | "open_to_guests";
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    }, {
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        joinPolicy?: "invite_only" | "open_to_guests" | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    }>;
+    controllerCredentialHash: z.ZodString;
+    /** Bumped by every control request so a late acknowledgement cannot overwrite newer state. */
+    controlRevision: z.ZodNumber;
+    turnMode: z.ZodOptional<z.ZodEnum<["sequential", "parallel"]>>;
+    turnRevision: z.ZodOptional<z.ZodNumber>;
+    turnChangedAt: z.ZodOptional<z.ZodNumber>;
+    allStartIndex: z.ZodOptional<z.ZodNumber>;
+    nextRequestSeq: z.ZodOptional<z.ZodNumber>;
+    /** When the last `message` was accepted; drives inactivity auto-close without scanning the transcript. */
+    lastMessageAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    /** The agents-and-guests mode closes only after one has joined. */
+    autoCloseArmed: z.ZodOptional<z.ZodBoolean>;
+    /** The computed next auto-close deadline, or null; recomputed in every mutation. */
+    autoCloseAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    closeReason: z.ZodOptional<z.ZodEnum<["manual", "inactivity", "age", "agents_and_guests_left"]>>;
+    nextSeq: z.ZodNumber;
+    retainedEventBytes: z.ZodNumber;
+    retainedEvents: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    expiresAt: number | null;
+    roomId: string;
+    createdAt: number;
+    closedAt: number | null;
+    lifecycle: "open" | "closed" | "expired" | "deleted";
+    policy: {
+        joinPolicy: "invite_only" | "open_to_guests";
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    };
+    controllerCredentialHash: string;
+    controlRevision: number;
+    nextSeq: number;
+    retainedEventBytes: number;
+    retainedEvents: number;
+    locked?: boolean | undefined;
+    turnMode?: "sequential" | "parallel" | undefined;
+    turnRevision?: number | undefined;
+    turnChangedAt?: number | undefined;
+    allStartIndex?: number | undefined;
+    nextRequestSeq?: number | undefined;
+    lastMessageAt?: number | null | undefined;
+    autoCloseArmed?: boolean | undefined;
+    autoCloseAt?: number | null | undefined;
+    closeReason?: "inactivity" | "age" | "agents_and_guests_left" | "manual" | undefined;
+}, {
+    name: string;
+    expiresAt: number | null;
+    roomId: string;
+    createdAt: number;
+    closedAt: number | null;
+    lifecycle: "open" | "closed" | "expired" | "deleted";
+    policy: {
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        joinPolicy?: "invite_only" | "open_to_guests" | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    };
+    controllerCredentialHash: string;
+    controlRevision: number;
+    nextSeq: number;
+    retainedEventBytes: number;
+    retainedEvents: number;
+    locked?: boolean | undefined;
+    turnMode?: "sequential" | "parallel" | undefined;
+    turnRevision?: number | undefined;
+    turnChangedAt?: number | undefined;
+    allStartIndex?: number | undefined;
+    nextRequestSeq?: number | undefined;
+    lastMessageAt?: number | null | undefined;
+    autoCloseArmed?: boolean | undefined;
+    autoCloseAt?: number | null | undefined;
+    closeReason?: "inactivity" | "age" | "agents_and_guests_left" | "manual" | undefined;
+}>;
+export type RoomRecord = z.infer<typeof RoomRecord>;
+export declare const ParticipantRecord: z.ZodObject<{
+    participantId: z.ZodString;
+    roomId: z.ZodString;
+    /** A label for humans. Never an authentication identity and never a routing key on its own. */
+    displayName: z.ZodString;
+    nameSource: z.ZodOptional<z.ZodEnum<["profile", "room"]>>;
+    kind: z.ZodEnum<["agent", "human"]>;
+    role: z.ZodEnum<["guest", "member", "controller"]>;
+    /** Distinguishes two sessions of the same runtime in the same working directory. */
+    sessionId: z.ZodNullable<z.ZodString>;
+    credentialHash: z.ZodString;
+    capabilities: z.ZodNullable<z.ZodObject<{
+        deliverUnsolicited: z.ZodDefault<z.ZodBoolean>;
+        cancelTurn: z.ZodDefault<z.ZodBoolean>;
+        cancelTool: z.ZodDefault<z.ZodBoolean>;
+        runtime: z.ZodOptional<z.ZodString>;
+        runtimeVersion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        deliverUnsolicited: boolean;
+        cancelTurn: boolean;
+        cancelTool: boolean;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    }, {
+        deliverUnsolicited?: boolean | undefined;
+        cancelTurn?: boolean | undefined;
+        cancelTool?: boolean | undefined;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    }>>;
+    joinedAt: z.ZodNumber;
+    revokedAt: z.ZodNullable<z.ZodNumber>;
+    leftAt: z.ZodNullable<z.ZodNumber>;
+    muted: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    participantId: string;
+    displayName: string;
+    kind: "agent" | "human";
+    role: "controller" | "guest" | "member";
+    capabilities: {
+        deliverUnsolicited: boolean;
+        cancelTurn: boolean;
+        cancelTool: boolean;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    } | null;
+    roomId: string;
+    sessionId: string | null;
+    credentialHash: string;
+    joinedAt: number;
+    revokedAt: number | null;
+    leftAt: number | null;
+    muted?: boolean | undefined;
+    nameSource?: "profile" | "room" | undefined;
+}, {
+    participantId: string;
+    displayName: string;
+    kind: "agent" | "human";
+    role: "controller" | "guest" | "member";
+    capabilities: {
+        deliverUnsolicited?: boolean | undefined;
+        cancelTurn?: boolean | undefined;
+        cancelTool?: boolean | undefined;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    } | null;
+    roomId: string;
+    sessionId: string | null;
+    credentialHash: string;
+    joinedAt: number;
+    revokedAt: number | null;
+    leftAt: number | null;
+    muted?: boolean | undefined;
+    nameSource?: "profile" | "room" | undefined;
+}>;
+export type ParticipantRecord = z.infer<typeof ParticipantRecord>;
+export declare const InviteRedemption: z.ZodEnum<["unused", "reserved", "redeemed"]>;
+export type InviteRedemption = z.infer<typeof InviteRedemption>;
+export declare const InviteRecord: z.ZodObject<{
+    /** SHA-256 of the normalized code. The code itself is never stored. */
+    digest: z.ZodString;
+    roomId: z.ZodString;
+    role: z.ZodEnum<["guest", "member", "controller"]>;
+    defaultName: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    /** Null for an invite that does not expire. */
+    expiresAt: z.ZodNullable<z.ZodNumber>;
+    state: z.ZodEnum<["unused", "reserved", "redeemed"]>;
+    /**
+     * A reusable code behaves as a seat: it admits one participant at a time and
+     * becomes available again when that participant leaves. A single-use code is
+     * spent on first redemption.
+     */
+    reusable: z.ZodDefault<z.ZodBoolean>;
+    /** Set once an attempt reserves the invite, so a retry of that attempt recovers the same membership. */
+    boundAttemptId: z.ZodNullable<z.ZodString>;
+    boundCredentialHash: z.ZodNullable<z.ZodString>;
+    redeemedParticipantId: z.ZodNullable<z.ZodString>;
+    /** Tombstone horizon: a consumed code stays unclaimable by anyone else until this time. */
+    recoverableUntil: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    role: "controller" | "guest" | "member";
+    expiresAt: number | null;
+    state: "unused" | "reserved" | "redeemed";
+    roomId: string;
+    createdAt: number;
+    digest: string;
+    reusable: boolean;
+    boundAttemptId: string | null;
+    boundCredentialHash: string | null;
+    redeemedParticipantId: string | null;
+    recoverableUntil: number | null;
+    defaultName?: string | undefined;
+}, {
+    role: "controller" | "guest" | "member";
+    expiresAt: number | null;
+    state: "unused" | "reserved" | "redeemed";
+    roomId: string;
+    createdAt: number;
+    digest: string;
+    boundAttemptId: string | null;
+    boundCredentialHash: string | null;
+    redeemedParticipantId: string | null;
+    recoverableUntil: number | null;
+    defaultName?: string | undefined;
+    reusable?: boolean | undefined;
+}>;
+export type InviteRecord = z.infer<typeof InviteRecord>;
+export declare const HandoverRecord: z.ZodObject<{
+    handoverId: z.ZodString;
+    roomId: z.ZodString;
+    senderId: z.ZodString;
+    recipientId: z.ZodString;
+    /** Immutable per revision. An amendment produces the next revision; acceptance names an exact one. */
+    revision: z.ZodNumber;
+    document: z.ZodObject<{
+        metadata: z.ZodObject<{
+            goal: z.ZodString;
+            recipient: z.ZodString;
+            mode: z.ZodEnum<["sequential", "concurrent"]>;
+            nextAction: z.ZodString;
+            decisions: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            blockers: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            repository: z.ZodOptional<z.ZodObject<{
+                remote: z.ZodOptional<z.ZodString>;
+                branch: z.ZodString;
+                commit: z.ZodString;
+                worktreePath: z.ZodOptional<z.ZodString>;
+                dirty: z.ZodBoolean;
+                missingPaths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                missingPaths: string[];
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+            }, {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+                missingPaths?: string[] | undefined;
+            }>>;
+            tests: z.ZodOptional<z.ZodObject<{
+                command: z.ZodString;
+                result: z.ZodEnum<["passed", "failed", "not_run"]>;
+                notes: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            }, {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions: string[];
+            blockers: string[];
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                missingPaths: string[];
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        }, {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions?: string[] | undefined;
+            blockers?: string[] | undefined;
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+                missingPaths?: string[] | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        }>;
+        body: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        metadata: {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions: string[];
+            blockers: string[];
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                missingPaths: string[];
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        };
+        body: string;
+    }, {
+        metadata: {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions?: string[] | undefined;
+            blockers?: string[] | undefined;
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+                missingPaths?: string[] | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        };
+        body: string;
+    }>;
+    state: z.ZodEnum<["offered", "accepted", "declined"]>;
+    offeredEventId: z.ZodString;
+    resolvedEventId: z.ZodNullable<z.ZodString>;
+    resolvedAt: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    handoverId: string;
+    revision: number;
+    document: {
+        metadata: {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions: string[];
+            blockers: string[];
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                missingPaths: string[];
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        };
+        body: string;
+    };
+    state: "offered" | "accepted" | "declined";
+    roomId: string;
+    senderId: string;
+    recipientId: string;
+    offeredEventId: string;
+    resolvedEventId: string | null;
+    resolvedAt: number | null;
+}, {
+    handoverId: string;
+    revision: number;
+    document: {
+        metadata: {
+            mode: "sequential" | "concurrent";
+            goal: string;
+            recipient: string;
+            nextAction: string;
+            decisions?: string[] | undefined;
+            blockers?: string[] | undefined;
+            repository?: {
+                dirty: boolean;
+                branch: string;
+                commit: string;
+                remote?: string | undefined;
+                worktreePath?: string | undefined;
+                missingPaths?: string[] | undefined;
+            } | undefined;
+            tests?: {
+                command: string;
+                result: "passed" | "failed" | "not_run";
+                notes?: string | undefined;
+            } | undefined;
+        };
+        body: string;
+    };
+    state: "offered" | "accepted" | "declined";
+    roomId: string;
+    senderId: string;
+    recipientId: string;
+    offeredEventId: string;
+    resolvedEventId: string | null;
+    resolvedAt: number | null;
+}>;
+export type HandoverRecord = z.infer<typeof HandoverRecord>;
+export declare const ControlRecord: z.ZodObject<{
+    roomId: z.ZodString;
+    targetParticipantId: z.ZodString;
+    paused: z.ZodBoolean;
+    /** The latest pause also asked to stop the current turn. Absent on older records. */
+    interruptRequested: z.ZodOptional<z.ZodBoolean>;
+    revision: z.ZodNumber;
+    requestedAt: z.ZodNumber;
+    acknowledgedRevision: z.ZodNumber;
+    acknowledgedOutcome: z.ZodNullable<z.ZodEnum<["pause_requested", "paused_between_turns", "current_turn_cancelled", "tool_cancellation_unknown", "resumed", "unsupported", "disconnected"]>>;
+    acknowledgedAt: z.ZodNullable<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    revision: number;
+    targetParticipantId: string;
+    roomId: string;
+    paused: boolean;
+    requestedAt: number;
+    acknowledgedRevision: number;
+    acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+    acknowledgedAt: number | null;
+    interruptRequested?: boolean | undefined;
+}, {
+    revision: number;
+    targetParticipantId: string;
+    roomId: string;
+    paused: boolean;
+    requestedAt: number;
+    acknowledgedRevision: number;
+    acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+    acknowledgedAt: number | null;
+    interruptRequested?: boolean | undefined;
+}>;
+export type ControlRecord = z.infer<typeof ControlRecord>;
+/** What a member sees about another participant. Credential hashes never leave the server. */
+export declare const ParticipantView: z.ZodObject<{
+    participantId: z.ZodString;
+    displayName: z.ZodString;
+    nameSource: z.ZodOptional<z.ZodEnum<["profile", "room"]>>;
+    kind: z.ZodEnum<["agent", "human"]>;
+    role: z.ZodEnum<["guest", "member", "controller"]>;
+    capabilities: z.ZodNullable<z.ZodObject<{
+        deliverUnsolicited: z.ZodDefault<z.ZodBoolean>;
+        cancelTurn: z.ZodDefault<z.ZodBoolean>;
+        cancelTool: z.ZodDefault<z.ZodBoolean>;
+        runtime: z.ZodOptional<z.ZodString>;
+        runtimeVersion: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        deliverUnsolicited: boolean;
+        cancelTurn: boolean;
+        cancelTool: boolean;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    }, {
+        deliverUnsolicited?: boolean | undefined;
+        cancelTurn?: boolean | undefined;
+        cancelTool?: boolean | undefined;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    }>>;
+    joinedAt: z.ZodNumber;
+    revoked: z.ZodBoolean;
+    left: z.ZodBoolean;
+    paused: z.ZodBoolean;
+    muted: z.ZodOptional<z.ZodBoolean>;
+    controlRevision: z.ZodNumber;
+    acknowledgedOutcome: z.ZodNullable<z.ZodEnum<["pause_requested", "paused_between_turns", "current_turn_cancelled", "tool_cancellation_unknown", "resumed", "unsupported", "disconnected"]>>;
+    /** The revision the receiver last acknowledged, so a client can tell whether the latest control was answered. */
+    acknowledgedRevision: z.ZodOptional<z.ZodNumber>;
+    interruptRequested: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    participantId: string;
+    displayName: string;
+    kind: "agent" | "human";
+    role: "controller" | "guest" | "member";
+    capabilities: {
+        deliverUnsolicited: boolean;
+        cancelTurn: boolean;
+        cancelTool: boolean;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    } | null;
+    controlRevision: number;
+    joinedAt: number;
+    paused: boolean;
+    acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+    revoked: boolean;
+    left: boolean;
+    muted?: boolean | undefined;
+    nameSource?: "profile" | "room" | undefined;
+    interruptRequested?: boolean | undefined;
+    acknowledgedRevision?: number | undefined;
+}, {
+    participantId: string;
+    displayName: string;
+    kind: "agent" | "human";
+    role: "controller" | "guest" | "member";
+    capabilities: {
+        deliverUnsolicited?: boolean | undefined;
+        cancelTurn?: boolean | undefined;
+        cancelTool?: boolean | undefined;
+        runtime?: string | undefined;
+        runtimeVersion?: string | undefined;
+    } | null;
+    controlRevision: number;
+    joinedAt: number;
+    paused: boolean;
+    acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+    revoked: boolean;
+    left: boolean;
+    muted?: boolean | undefined;
+    nameSource?: "profile" | "room" | undefined;
+    interruptRequested?: boolean | undefined;
+    acknowledgedRevision?: number | undefined;
+}>;
+export type ParticipantView = z.infer<typeof ParticipantView>;
+export declare const RoomSnapshot: z.ZodObject<{
+    roomId: z.ZodString;
+    /** Absent on older relays, which only accept addressed-recipient receipts. */
+    messageReceiptScope: z.ZodOptional<z.ZodEnum<["recipient", "members"]>>;
+    messageStagesSupported: z.ZodOptional<z.ZodBoolean>;
+    rejoinSupported: z.ZodOptional<z.ZodBoolean>;
+    renameSelfSupported: z.ZodOptional<z.ZodBoolean>;
+    adminRolesSupported: z.ZodOptional<z.ZodBoolean>;
+    inviteRoleSupported: z.ZodOptional<z.ZodBoolean>;
+    autoCloseSupported: z.ZodOptional<z.ZodBoolean>;
+    interruptSupported: z.ZodOptional<z.ZodBoolean>;
+    lastMessageAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    autoCloseArmed: z.ZodOptional<z.ZodBoolean>;
+    autoCloseAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    closeReason: z.ZodOptional<z.ZodEnum<["manual", "inactivity", "age", "agents_and_guests_left"]>>;
+    quotedMessagesSupported: z.ZodOptional<z.ZodBoolean>;
+    groupTurnsSupported: z.ZodOptional<z.ZodBoolean>;
+    workingStatusSupported: z.ZodOptional<z.ZodBoolean>;
+    turnMode: z.ZodOptional<z.ZodEnum<["sequential", "parallel"]>>;
+    name: z.ZodString;
+    lifecycle: z.ZodEnum<["open", "closed", "expired", "deleted"]>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodNumber;
+    expiresAt: z.ZodNullable<z.ZodNumber>;
+    closedAt: z.ZodNullable<z.ZodNumber>;
+    controlRevision: z.ZodNumber;
+    latestSeq: z.ZodNumber;
+    earliestSeq: z.ZodNumber;
+    participants: z.ZodArray<z.ZodObject<{
+        participantId: z.ZodString;
+        displayName: z.ZodString;
+        nameSource: z.ZodOptional<z.ZodEnum<["profile", "room"]>>;
+        kind: z.ZodEnum<["agent", "human"]>;
+        role: z.ZodEnum<["guest", "member", "controller"]>;
+        capabilities: z.ZodNullable<z.ZodObject<{
+            deliverUnsolicited: z.ZodDefault<z.ZodBoolean>;
+            cancelTurn: z.ZodDefault<z.ZodBoolean>;
+            cancelTool: z.ZodDefault<z.ZodBoolean>;
+            runtime: z.ZodOptional<z.ZodString>;
+            runtimeVersion: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            deliverUnsolicited: boolean;
+            cancelTurn: boolean;
+            cancelTool: boolean;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        }, {
+            deliverUnsolicited?: boolean | undefined;
+            cancelTurn?: boolean | undefined;
+            cancelTool?: boolean | undefined;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        }>>;
+        joinedAt: z.ZodNumber;
+        revoked: z.ZodBoolean;
+        left: z.ZodBoolean;
+        paused: z.ZodBoolean;
+        muted: z.ZodOptional<z.ZodBoolean>;
+        controlRevision: z.ZodNumber;
+        acknowledgedOutcome: z.ZodNullable<z.ZodEnum<["pause_requested", "paused_between_turns", "current_turn_cancelled", "tool_cancellation_unknown", "resumed", "unsupported", "disconnected"]>>;
+        /** The revision the receiver last acknowledged, so a client can tell whether the latest control was answered. */
+        acknowledgedRevision: z.ZodOptional<z.ZodNumber>;
+        interruptRequested: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        participantId: string;
+        displayName: string;
+        kind: "agent" | "human";
+        role: "controller" | "guest" | "member";
+        capabilities: {
+            deliverUnsolicited: boolean;
+            cancelTurn: boolean;
+            cancelTool: boolean;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        } | null;
+        controlRevision: number;
+        joinedAt: number;
+        paused: boolean;
+        acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+        revoked: boolean;
+        left: boolean;
+        muted?: boolean | undefined;
+        nameSource?: "profile" | "room" | undefined;
+        interruptRequested?: boolean | undefined;
+        acknowledgedRevision?: number | undefined;
+    }, {
+        participantId: string;
+        displayName: string;
+        kind: "agent" | "human";
+        role: "controller" | "guest" | "member";
+        capabilities: {
+            deliverUnsolicited?: boolean | undefined;
+            cancelTurn?: boolean | undefined;
+            cancelTool?: boolean | undefined;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        } | null;
+        controlRevision: number;
+        joinedAt: number;
+        paused: boolean;
+        acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+        revoked: boolean;
+        left: boolean;
+        muted?: boolean | undefined;
+        nameSource?: "profile" | "room" | undefined;
+        interruptRequested?: boolean | undefined;
+        acknowledgedRevision?: number | undefined;
+    }>, "many">;
+    policy: z.ZodObject<{
+        joinPolicy: z.ZodDefault<z.ZodEnum<["invite_only", "open_to_guests"]>>;
+        inviteRole: z.ZodOptional<z.ZodEnum<["member", "guest"]>>;
+        autoClose: z.ZodOptional<z.ZodDiscriminatedUnion<"mode", [z.ZodObject<{
+            mode: z.ZodLiteral<"off">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "off";
+        }, {
+            mode: "off";
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"inactivity">;
+            afterMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "inactivity";
+            afterMs: number;
+        }, {
+            mode: "inactivity";
+            afterMs: number;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"age">;
+            afterMs: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mode: "age";
+            afterMs: number;
+        }, {
+            mode: "age";
+            afterMs: number;
+        }>, z.ZodObject<{
+            mode: z.ZodLiteral<"agents_and_guests_left">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "agents_and_guests_left";
+        }, {
+            mode: "agents_and_guests_left";
+        }>]>>;
+        localJoin: z.ZodOptional<z.ZodBoolean>;
+        maxParticipants: z.ZodNumber;
+        maxEventPayloadBytes: z.ZodNumber;
+        maxRetainedEventBytes: z.ZodNumber;
+        maxRetainedEvents: z.ZodNumber;
+        roomLifetimeMs: z.ZodNullable<z.ZodNumber>;
+        inviteLifetimeMs: z.ZodNullable<z.ZodNumber>;
+        exportWindowMs: z.ZodNumber;
+        connectTicketLifetimeMs: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        joinPolicy: "invite_only" | "open_to_guests";
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    }, {
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        joinPolicy?: "invite_only" | "open_to_guests" | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    expiresAt: number | null;
+    roomId: string;
+    createdAt: number;
+    closedAt: number | null;
+    lifecycle: "open" | "closed" | "expired" | "deleted";
+    policy: {
+        joinPolicy: "invite_only" | "open_to_guests";
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    };
+    controlRevision: number;
+    latestSeq: number;
+    earliestSeq: number;
+    participants: {
+        participantId: string;
+        displayName: string;
+        kind: "agent" | "human";
+        role: "controller" | "guest" | "member";
+        capabilities: {
+            deliverUnsolicited: boolean;
+            cancelTurn: boolean;
+            cancelTool: boolean;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        } | null;
+        controlRevision: number;
+        joinedAt: number;
+        paused: boolean;
+        acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+        revoked: boolean;
+        left: boolean;
+        muted?: boolean | undefined;
+        nameSource?: "profile" | "room" | undefined;
+        interruptRequested?: boolean | undefined;
+        acknowledgedRevision?: number | undefined;
+    }[];
+    locked?: boolean | undefined;
+    turnMode?: "sequential" | "parallel" | undefined;
+    lastMessageAt?: number | null | undefined;
+    autoCloseArmed?: boolean | undefined;
+    autoCloseAt?: number | null | undefined;
+    closeReason?: "inactivity" | "age" | "agents_and_guests_left" | "manual" | undefined;
+    messageReceiptScope?: "recipient" | "members" | undefined;
+    messageStagesSupported?: boolean | undefined;
+    rejoinSupported?: boolean | undefined;
+    renameSelfSupported?: boolean | undefined;
+    adminRolesSupported?: boolean | undefined;
+    inviteRoleSupported?: boolean | undefined;
+    autoCloseSupported?: boolean | undefined;
+    interruptSupported?: boolean | undefined;
+    quotedMessagesSupported?: boolean | undefined;
+    groupTurnsSupported?: boolean | undefined;
+    workingStatusSupported?: boolean | undefined;
+}, {
+    name: string;
+    expiresAt: number | null;
+    roomId: string;
+    createdAt: number;
+    closedAt: number | null;
+    lifecycle: "open" | "closed" | "expired" | "deleted";
+    policy: {
+        maxParticipants: number;
+        maxEventPayloadBytes: number;
+        maxRetainedEventBytes: number;
+        maxRetainedEvents: number;
+        roomLifetimeMs: number | null;
+        inviteLifetimeMs: number | null;
+        exportWindowMs: number;
+        connectTicketLifetimeMs: number;
+        autoClose?: {
+            mode: "off";
+        } | {
+            mode: "inactivity";
+            afterMs: number;
+        } | {
+            mode: "age";
+            afterMs: number;
+        } | {
+            mode: "agents_and_guests_left";
+        } | undefined;
+        joinPolicy?: "invite_only" | "open_to_guests" | undefined;
+        inviteRole?: "guest" | "member" | undefined;
+        localJoin?: boolean | undefined;
+    };
+    controlRevision: number;
+    latestSeq: number;
+    earliestSeq: number;
+    participants: {
+        participantId: string;
+        displayName: string;
+        kind: "agent" | "human";
+        role: "controller" | "guest" | "member";
+        capabilities: {
+            deliverUnsolicited?: boolean | undefined;
+            cancelTurn?: boolean | undefined;
+            cancelTool?: boolean | undefined;
+            runtime?: string | undefined;
+            runtimeVersion?: string | undefined;
+        } | null;
+        controlRevision: number;
+        joinedAt: number;
+        paused: boolean;
+        acknowledgedOutcome: "pause_requested" | "paused_between_turns" | "current_turn_cancelled" | "tool_cancellation_unknown" | "resumed" | "unsupported" | "disconnected" | null;
+        revoked: boolean;
+        left: boolean;
+        muted?: boolean | undefined;
+        nameSource?: "profile" | "room" | undefined;
+        interruptRequested?: boolean | undefined;
+        acknowledgedRevision?: number | undefined;
+    }[];
+    locked?: boolean | undefined;
+    turnMode?: "sequential" | "parallel" | undefined;
+    lastMessageAt?: number | null | undefined;
+    autoCloseArmed?: boolean | undefined;
+    autoCloseAt?: number | null | undefined;
+    closeReason?: "inactivity" | "age" | "agents_and_guests_left" | "manual" | undefined;
+    messageReceiptScope?: "recipient" | "members" | undefined;
+    messageStagesSupported?: boolean | undefined;
+    rejoinSupported?: boolean | undefined;
+    renameSelfSupported?: boolean | undefined;
+    adminRolesSupported?: boolean | undefined;
+    inviteRoleSupported?: boolean | undefined;
+    autoCloseSupported?: boolean | undefined;
+    interruptSupported?: boolean | undefined;
+    quotedMessagesSupported?: boolean | undefined;
+    groupTurnsSupported?: boolean | undefined;
+    workingStatusSupported?: boolean | undefined;
+}>;
+export type RoomSnapshot = z.infer<typeof RoomSnapshot>;
+//# sourceMappingURL=records.d.ts.map