@openvtc/trust-tasks 0.28.6 → 0.28.8

package/dist/vtc/rooms/memberships/list/0.2/payload.d.ts

@@ -0,0 +1,830 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/rooms/memberships/list/0.2/payload.schema.json
+ */
+import type { ArchiveAccess, Ext, MemberAction, MemberActions, MemberStateV2, RoomDescription, RoomLabel, RoomMembershipV2, RoomState, Visibility } from "../../../../../_shared/components.js";
+export interface VTCRoomsMembershipsListPayload {
+    /**
+     * Opaque continuation token from a previous page's `nextCursor`.
+     */
+    cursor?: string;
+    /**
+     * Page size. The community chooses when absent (50 in the reference implementation).
+     */
+    limit?: number;
+    ext?: Ext;
+}
+/**
+ * Success response to vtc/rooms/memberships/list. Type https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response. The community's record of the caller's admissions to the rooms it owns, in every state, each with the room's own state, and no one else's.
+ */
+export interface VTCRoomsMembershipsListResponsePayload {
+    /**
+     * @maxItems 100
+     */
+    items: RoomMembershipV2[];
+    /**
+     * Present when more remain; pass it as `cursor`.
+     */
+    nextCursor?: string;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { ArchiveAccess, Ext, MemberAction, MemberActions, MemberStateV2, RoomDescription, RoomLabel, RoomMembershipV2, RoomState, Visibility };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2";
+/**
+ * The earlier version of this specification that this one declares it
+ * extends (front matter `extends`, SPEC §5.2 "Declared extension"), or
+ * `null`. Only the direct declaration — follow the chain with
+ * `extendsChain` / `readForSpec`.
+ */
+export declare const EXTENDS: string | null;
+/**
+ * Why this version is deprecated, or `null` while it is current. A
+ * superseded or retired version is still supported, and is withdrawn from
+ * this package in a later scheduled batch (SPEC "Superseded and Withdrawn
+ * Versions").
+ */
+export declare const DEPRECATION: string | null;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRoomsMembershipsListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRoomsMembershipsListResponsePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2";
+    readonly title: "VTC Rooms Memberships List — payload";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly cursor: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1024;
+            readonly description: "Opaque continuation token from a previous page's `nextCursor`.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 100;
+            readonly description: "Page size. The community chooses when absent (50 in the reference implementation).";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms Memberships List — response payload";
+            readonly description: "Success response to vtc/rooms/memberships/list. Type https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response. The community's record of the caller's admissions to the rooms it owns, in every state, each with the room's own state, and no one else's.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 100;
+                    readonly items: {
+                        readonly $ref: "#/$defs/RoomMembershipV2";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "Present when more remain; pass it as `cursor`.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly RoomMembershipV2: {
+            readonly title: "RoomMembershipV2";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "host", "label", "visibility", "actions", "validUntil", "state", "offeredAt", "roomState"];
+            readonly description: "What vtc/rooms/memberships/list/0.2 returns: `RoomMembership` with `MemberStateV2`, `suspendedAt`, and the room's own state, so that a member can tell a room that is read-only, closed or going away from one they were removed from.";
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                };
+                readonly host: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The room's host: this community.";
+                };
+                readonly label: {
+                    readonly $ref: "#/$defs/RoomLabel";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/RoomDescription";
+                    readonly description: "Absent when the room has none.";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/Visibility";
+                };
+                readonly actions: {
+                    readonly $ref: "#/$defs/MemberActions";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the member's authority credential expires.";
+                };
+                readonly state: {
+                    readonly $ref: "#/$defs/MemberStateV2";
+                };
+                readonly offeredAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly admittedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community recorded the admission. Present when `state` is `admitted`, and kept when it becomes `removed`.";
+                };
+                readonly removedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present exactly when `state` is `removed`.";
+                };
+                readonly repeatAcceptUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "On an `attributed` or `private` room in state `admitted`: until when the community keeps the Welcome, so that a repeated vtc/rooms/offers/accept carrying the same KeyPackage is answered with it. Absent on an `open` room, in any other state, and once the community no longer keeps it. A surface finding the member admitted but the room absent from its key holder's rooms/keys/list finishes the acceptance before this time, and asks an administrator to re-admit the member after it.";
+                };
+                readonly suspendedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present exactly when `state` is `suspended`.";
+                };
+                readonly roomState: {
+                    readonly $ref: "#/$defs/RoomState";
+                    readonly description: "The room's state in its owner's lifecycle. `purging` is shown to members as `removalScheduled`: to them, the room is going away either way.";
+                };
+                readonly roomAccess: {
+                    readonly $ref: "#/$defs/ArchiveAccess";
+                    readonly description: "Present exactly when `roomState` is `archived` or `removalScheduled`.";
+                };
+                readonly purgeAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present when `roomState` is `removalScheduled`: when the room's content is to be deleted.";
+                };
+            };
+        };
+        readonly ArchiveAccess: {
+            readonly title: "ArchiveAccess";
+            readonly type: "string";
+            readonly enum: readonly ["readOnly", "noAccess"];
+            readonly description: "What an archived room's members may still do. `readOnly`: their credentials stand and they keep reading what the room holds; the room's host refuses every write, upload and curation from a member. `noAccess`: every credential the room issued before the archival is withdrawn at its host — a room reset — so the host refuses every member's every task; the content is kept intact, and each withdrawn admission is `suspended`, restored when the room is unarchived or made `readOnly`. Neither recalls what a member already read or saved, and on a sealed tier neither removes anyone from the room's group.";
+        };
+        readonly RoomState: {
+            readonly title: "RoomState";
+            readonly type: "string";
+            readonly enum: readonly ["active", "archived", "removalScheduled", "purging", "removed"];
+            readonly description: "Where a room the community owns stands in its owner's lifecycle — distinct from `HostedRoom.lifecycle`, which is the host's clock (`live`, `lapsed`, `dormant`, `reclaimable`) and is computed from the room's epoch, never set. `active`: open to change. `archived`: closed to change by an administrator — no admissions, and the room's host accepts no writes from its members; what members may still do is `ArchiveAccess`. Reversible with vtc/rooms/community/unarchive. `removalScheduled`: an administrator removed the room with a grace period; it admits nobody and its content is kept until `purgeAt`, and vtc/rooms/community/removal/cancel returns it to `archived`. `purging`: the grace period ended (or there was none) and the community is deleting the room's content from its host and storage; not reversible. `removed`: the content is gone; the community keeps only this record of the room, for its history.";
+        };
+        readonly MemberStateV2: {
+            readonly title: "MemberStateV2";
+            readonly type: "string";
+            readonly enum: readonly ["offered", "admitted", "suspended", "removed"];
+            readonly description: "`MemberState` plus `suspended`. `offered`: credentials issued and waiting for the member to collect and accept them. `admitted`: accepted — on a sealed tier, the member is in the room's group. `suspended`: admitted, but the room was archived with `noAccess` (or scheduled for removal), so the room's host refuses the member's credentials; on a sealed tier they are still in the room's group. Restored to `admitted` with freshly issued credentials when the room leaves that state, and never restored if it is removed. `removed`: an administrator removed them, or withdrew their offer — archiving withdraws every open offer; on a sealed tier the room has advanced past an admitted member.";
+        };
+        readonly MemberActions: {
+            readonly title: "MemberActions";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 3;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/MemberAction";
+            };
+            readonly description: "The actions granted, at least one. An empty list confers nothing rather than everything, and a schema that allowed it would make the more dangerous reading available to a careless consumer.";
+        };
+        readonly MemberAction: {
+            readonly title: "MemberAction";
+            readonly type: "string";
+            readonly enum: readonly ["read", "write", "curate"];
+            readonly description: "What a member of a community-owned room may do there. `admin` is not among them: minting epochs, admitting and removing members are the community's, as the room's owner, and are exercised through the vtc/rooms/community/* tasks rather than by any member's credential. `curate` is not implied by `write`.";
+        };
+        readonly RoomDescription: {
+            readonly title: "RoomDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly description: "What the room is for, in a sentence or a short paragraph, written by an administrator: shown to administrators holding `vtc.rooms.manage` and to the members the room is offered to. Plain text — a consumer renders it as text, never as markup. Like `RoomLabel`, it is the community's own record as the room's owner: not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `description` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. It MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+        };
+        readonly RoomLabel: {
+            readonly title: "RoomLabel";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "A name for the room, chosen by an administrator: shown to administrators and to the members a room is offered to. Not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `name` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. MUST NOT carry personal data.";
+        };
+        readonly Visibility: {
+            readonly title: "Visibility";
+            readonly type: "string";
+            readonly enum: readonly ["open", "attributed", "private"];
+            readonly description: "How much of a room its host can see, fixed at creation and immutable thereafter. `open`: records are cleartext, searchable and fully audited. `attributed`: record content is sealed, and the host still learns which member acted. `private`: content is sealed and membership is presented in zero knowledge, so the host verifies that a member acted without learning which. Immutable because a downgrade cannot un-see cleartext and an upgrade would protect only what came after while presenting as though it protected everything.";
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Rooms Memberships List — response payload";
+            readonly description: "Success response to vtc/rooms/memberships/list. Type https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response. The community's record of the caller's admissions to the rooms it owns, in every state, each with the room's own state, and no one else's.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 100;
+                    readonly items: {
+                        readonly $ref: "#/$defs/RoomMembershipV2";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "Present when more remain; pass it as `cursor`.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+        readonly RoomMembershipV2: {
+            readonly title: "RoomMembershipV2";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "host", "label", "visibility", "actions", "validUntil", "state", "offeredAt", "roomState"];
+            readonly description: "What vtc/rooms/memberships/list/0.2 returns: `RoomMembership` with `MemberStateV2`, `suspendedAt`, and the room's own state, so that a member can tell a room that is read-only, closed or going away from one they were removed from.";
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                };
+                readonly host: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The room's host: this community.";
+                };
+                readonly label: {
+                    readonly $ref: "#/$defs/RoomLabel";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/RoomDescription";
+                    readonly description: "Absent when the room has none.";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/Visibility";
+                };
+                readonly actions: {
+                    readonly $ref: "#/$defs/MemberActions";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the member's authority credential expires.";
+                };
+                readonly state: {
+                    readonly $ref: "#/$defs/MemberStateV2";
+                };
+                readonly offeredAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly admittedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community recorded the admission. Present when `state` is `admitted`, and kept when it becomes `removed`.";
+                };
+                readonly removedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present exactly when `state` is `removed`.";
+                };
+                readonly repeatAcceptUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "On an `attributed` or `private` room in state `admitted`: until when the community keeps the Welcome, so that a repeated vtc/rooms/offers/accept carrying the same KeyPackage is answered with it. Absent on an `open` room, in any other state, and once the community no longer keeps it. A surface finding the member admitted but the room absent from its key holder's rooms/keys/list finishes the acceptance before this time, and asks an administrator to re-admit the member after it.";
+                };
+                readonly suspendedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present exactly when `state` is `suspended`.";
+                };
+                readonly roomState: {
+                    readonly $ref: "#/$defs/RoomState";
+                    readonly description: "The room's state in its owner's lifecycle. `purging` is shown to members as `removalScheduled`: to them, the room is going away either way.";
+                };
+                readonly roomAccess: {
+                    readonly $ref: "#/$defs/ArchiveAccess";
+                    readonly description: "Present exactly when `roomState` is `archived` or `removalScheduled`.";
+                };
+                readonly purgeAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Present when `roomState` is `removalScheduled`: when the room's content is to be deleted.";
+                };
+            };
+        };
+        readonly ArchiveAccess: {
+            readonly title: "ArchiveAccess";
+            readonly type: "string";
+            readonly enum: readonly ["readOnly", "noAccess"];
+            readonly description: "What an archived room's members may still do. `readOnly`: their credentials stand and they keep reading what the room holds; the room's host refuses every write, upload and curation from a member. `noAccess`: every credential the room issued before the archival is withdrawn at its host — a room reset — so the host refuses every member's every task; the content is kept intact, and each withdrawn admission is `suspended`, restored when the room is unarchived or made `readOnly`. Neither recalls what a member already read or saved, and on a sealed tier neither removes anyone from the room's group.";
+        };
+        readonly RoomState: {
+            readonly title: "RoomState";
+            readonly type: "string";
+            readonly enum: readonly ["active", "archived", "removalScheduled", "purging", "removed"];
+            readonly description: "Where a room the community owns stands in its owner's lifecycle — distinct from `HostedRoom.lifecycle`, which is the host's clock (`live`, `lapsed`, `dormant`, `reclaimable`) and is computed from the room's epoch, never set. `active`: open to change. `archived`: closed to change by an administrator — no admissions, and the room's host accepts no writes from its members; what members may still do is `ArchiveAccess`. Reversible with vtc/rooms/community/unarchive. `removalScheduled`: an administrator removed the room with a grace period; it admits nobody and its content is kept until `purgeAt`, and vtc/rooms/community/removal/cancel returns it to `archived`. `purging`: the grace period ended (or there was none) and the community is deleting the room's content from its host and storage; not reversible. `removed`: the content is gone; the community keeps only this record of the room, for its history.";
+        };
+        readonly MemberStateV2: {
+            readonly title: "MemberStateV2";
+            readonly type: "string";
+            readonly enum: readonly ["offered", "admitted", "suspended", "removed"];
+            readonly description: "`MemberState` plus `suspended`. `offered`: credentials issued and waiting for the member to collect and accept them. `admitted`: accepted — on a sealed tier, the member is in the room's group. `suspended`: admitted, but the room was archived with `noAccess` (or scheduled for removal), so the room's host refuses the member's credentials; on a sealed tier they are still in the room's group. Restored to `admitted` with freshly issued credentials when the room leaves that state, and never restored if it is removed. `removed`: an administrator removed them, or withdrew their offer — archiving withdraws every open offer; on a sealed tier the room has advanced past an admitted member.";
+        };
+        readonly MemberActions: {
+            readonly title: "MemberActions";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 3;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/MemberAction";
+            };
+            readonly description: "The actions granted, at least one. An empty list confers nothing rather than everything, and a schema that allowed it would make the more dangerous reading available to a careless consumer.";
+        };
+        readonly MemberAction: {
+            readonly title: "MemberAction";
+            readonly type: "string";
+            readonly enum: readonly ["read", "write", "curate"];
+            readonly description: "What a member of a community-owned room may do there. `admin` is not among them: minting epochs, admitting and removing members are the community's, as the room's owner, and are exercised through the vtc/rooms/community/* tasks rather than by any member's credential. `curate` is not implied by `write`.";
+        };
+        readonly RoomDescription: {
+            readonly title: "RoomDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly description: "What the room is for, in a sentence or a short paragraph, written by an administrator: shown to administrators holding `vtc.rooms.manage` and to the members the room is offered to. Plain text — a consumer renders it as text, never as markup. Like `RoomLabel`, it is the community's own record as the room's owner: not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `description` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. It MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+        };
+        readonly RoomLabel: {
+            readonly title: "RoomLabel";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "A name for the room, chosen by an administrator: shown to administrators and to the members a room is offered to. Not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `name` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. MUST NOT carry personal data.";
+        };
+        readonly Visibility: {
+            readonly title: "Visibility";
+            readonly type: "string";
+            readonly enum: readonly ["open", "attributed", "private"];
+            readonly description: "How much of a room its host can see, fixed at creation and immutable thereafter. `open`: records are cleartext, searchable and fully audited. `attributed`: record content is sealed, and the host still learns which member acted. `private`: content is sealed and membership is presented in zero knowledge, so the host verifies that a member acted without learning which. Immutable because a downgrade cannot un-see cleartext and an upgrade would protect only what came after while presenting as though it protected everything.";
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2";
+        readonly title: "VTC Rooms Memberships List — payload";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly cursor: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1024;
+                readonly description: "Opaque continuation token from a previous page's `nextCursor`.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size. The community chooses when absent (50 in the reference implementation).";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms Memberships List — response payload";
+                readonly description: "Success response to vtc/rooms/memberships/list. Type https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response. The community's record of the caller's admissions to the rooms it owns, in every state, each with the room's own state, and no one else's.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 100;
+                        readonly items: {
+                            readonly $ref: "#/$defs/RoomMembershipV2";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "Present when more remain; pass it as `cursor`.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly RoomMembershipV2: {
+                readonly title: "RoomMembershipV2";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "host", "label", "visibility", "actions", "validUntil", "state", "offeredAt", "roomState"];
+                readonly description: "What vtc/rooms/memberships/list/0.2 returns: `RoomMembership` with `MemberStateV2`, `suspendedAt`, and the room's own state, so that a member can tell a room that is read-only, closed or going away from one they were removed from.";
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                    };
+                    readonly host: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The room's host: this community.";
+                    };
+                    readonly label: {
+                        readonly $ref: "#/$defs/RoomLabel";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/RoomDescription";
+                        readonly description: "Absent when the room has none.";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/Visibility";
+                    };
+                    readonly actions: {
+                        readonly $ref: "#/$defs/MemberActions";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the member's authority credential expires.";
+                    };
+                    readonly state: {
+                        readonly $ref: "#/$defs/MemberStateV2";
+                    };
+                    readonly offeredAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly admittedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community recorded the admission. Present when `state` is `admitted`, and kept when it becomes `removed`.";
+                    };
+                    readonly removedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present exactly when `state` is `removed`.";
+                    };
+                    readonly repeatAcceptUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "On an `attributed` or `private` room in state `admitted`: until when the community keeps the Welcome, so that a repeated vtc/rooms/offers/accept carrying the same KeyPackage is answered with it. Absent on an `open` room, in any other state, and once the community no longer keeps it. A surface finding the member admitted but the room absent from its key holder's rooms/keys/list finishes the acceptance before this time, and asks an administrator to re-admit the member after it.";
+                    };
+                    readonly suspendedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present exactly when `state` is `suspended`.";
+                    };
+                    readonly roomState: {
+                        readonly $ref: "#/$defs/RoomState";
+                        readonly description: "The room's state in its owner's lifecycle. `purging` is shown to members as `removalScheduled`: to them, the room is going away either way.";
+                    };
+                    readonly roomAccess: {
+                        readonly $ref: "#/$defs/ArchiveAccess";
+                        readonly description: "Present exactly when `roomState` is `archived` or `removalScheduled`.";
+                    };
+                    readonly purgeAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present when `roomState` is `removalScheduled`: when the room's content is to be deleted.";
+                    };
+                };
+            };
+            readonly ArchiveAccess: {
+                readonly title: "ArchiveAccess";
+                readonly type: "string";
+                readonly enum: readonly ["readOnly", "noAccess"];
+                readonly description: "What an archived room's members may still do. `readOnly`: their credentials stand and they keep reading what the room holds; the room's host refuses every write, upload and curation from a member. `noAccess`: every credential the room issued before the archival is withdrawn at its host — a room reset — so the host refuses every member's every task; the content is kept intact, and each withdrawn admission is `suspended`, restored when the room is unarchived or made `readOnly`. Neither recalls what a member already read or saved, and on a sealed tier neither removes anyone from the room's group.";
+            };
+            readonly RoomState: {
+                readonly title: "RoomState";
+                readonly type: "string";
+                readonly enum: readonly ["active", "archived", "removalScheduled", "purging", "removed"];
+                readonly description: "Where a room the community owns stands in its owner's lifecycle — distinct from `HostedRoom.lifecycle`, which is the host's clock (`live`, `lapsed`, `dormant`, `reclaimable`) and is computed from the room's epoch, never set. `active`: open to change. `archived`: closed to change by an administrator — no admissions, and the room's host accepts no writes from its members; what members may still do is `ArchiveAccess`. Reversible with vtc/rooms/community/unarchive. `removalScheduled`: an administrator removed the room with a grace period; it admits nobody and its content is kept until `purgeAt`, and vtc/rooms/community/removal/cancel returns it to `archived`. `purging`: the grace period ended (or there was none) and the community is deleting the room's content from its host and storage; not reversible. `removed`: the content is gone; the community keeps only this record of the room, for its history.";
+            };
+            readonly MemberStateV2: {
+                readonly title: "MemberStateV2";
+                readonly type: "string";
+                readonly enum: readonly ["offered", "admitted", "suspended", "removed"];
+                readonly description: "`MemberState` plus `suspended`. `offered`: credentials issued and waiting for the member to collect and accept them. `admitted`: accepted — on a sealed tier, the member is in the room's group. `suspended`: admitted, but the room was archived with `noAccess` (or scheduled for removal), so the room's host refuses the member's credentials; on a sealed tier they are still in the room's group. Restored to `admitted` with freshly issued credentials when the room leaves that state, and never restored if it is removed. `removed`: an administrator removed them, or withdrew their offer — archiving withdraws every open offer; on a sealed tier the room has advanced past an admitted member.";
+            };
+            readonly MemberActions: {
+                readonly title: "MemberActions";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 3;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/MemberAction";
+                };
+                readonly description: "The actions granted, at least one. An empty list confers nothing rather than everything, and a schema that allowed it would make the more dangerous reading available to a careless consumer.";
+            };
+            readonly MemberAction: {
+                readonly title: "MemberAction";
+                readonly type: "string";
+                readonly enum: readonly ["read", "write", "curate"];
+                readonly description: "What a member of a community-owned room may do there. `admin` is not among them: minting epochs, admitting and removing members are the community's, as the room's owner, and are exercised through the vtc/rooms/community/* tasks rather than by any member's credential. `curate` is not implied by `write`.";
+            };
+            readonly RoomDescription: {
+                readonly title: "RoomDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly description: "What the room is for, in a sentence or a short paragraph, written by an administrator: shown to administrators holding `vtc.rooms.manage` and to the members the room is offered to. Plain text — a consumer renders it as text, never as markup. Like `RoomLabel`, it is the community's own record as the room's owner: not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `description` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. It MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+            };
+            readonly RoomLabel: {
+                readonly title: "RoomLabel";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "A name for the room, chosen by an administrator: shown to administrators and to the members a room is offered to. Not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `name` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. MUST NOT carry personal data.";
+            };
+            readonly Visibility: {
+                readonly title: "Visibility";
+                readonly type: "string";
+                readonly enum: readonly ["open", "attributed", "private"];
+                readonly description: "How much of a room its host can see, fixed at creation and immutable thereafter. `open`: records are cleartext, searchable and fully audited. `attributed`: record content is sealed, and the host still learns which member acted. `private`: content is sealed and membership is presented in zero knowledge, so the host verifies that a member acted without learning which. Immutable because a downgrade cannot un-see cleartext and an upgrade would protect only what came after while presenting as though it protected everything.";
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Rooms Memberships List — response payload";
+                readonly description: "Success response to vtc/rooms/memberships/list. Type https://trusttasks.org/spec/vtc/rooms/memberships/list/0.2#response. The community's record of the caller's admissions to the rooms it owns, in every state, each with the room's own state, and no one else's.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 100;
+                        readonly items: {
+                            readonly $ref: "#/$defs/RoomMembershipV2";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "Present when more remain; pass it as `cursor`.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly description: "Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+            readonly RoomMembershipV2: {
+                readonly title: "RoomMembershipV2";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "host", "label", "visibility", "actions", "validUntil", "state", "offeredAt", "roomState"];
+                readonly description: "What vtc/rooms/memberships/list/0.2 returns: `RoomMembership` with `MemberStateV2`, `suspendedAt`, and the room's own state, so that a member can tell a room that is read-only, closed or going away from one they were removed from.";
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                    };
+                    readonly host: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The room's host: this community.";
+                    };
+                    readonly label: {
+                        readonly $ref: "#/$defs/RoomLabel";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/RoomDescription";
+                        readonly description: "Absent when the room has none.";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/Visibility";
+                    };
+                    readonly actions: {
+                        readonly $ref: "#/$defs/MemberActions";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the member's authority credential expires.";
+                    };
+                    readonly state: {
+                        readonly $ref: "#/$defs/MemberStateV2";
+                    };
+                    readonly offeredAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly admittedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community recorded the admission. Present when `state` is `admitted`, and kept when it becomes `removed`.";
+                    };
+                    readonly removedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present exactly when `state` is `removed`.";
+                    };
+                    readonly repeatAcceptUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "On an `attributed` or `private` room in state `admitted`: until when the community keeps the Welcome, so that a repeated vtc/rooms/offers/accept carrying the same KeyPackage is answered with it. Absent on an `open` room, in any other state, and once the community no longer keeps it. A surface finding the member admitted but the room absent from its key holder's rooms/keys/list finishes the acceptance before this time, and asks an administrator to re-admit the member after it.";
+                    };
+                    readonly suspendedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present exactly when `state` is `suspended`.";
+                    };
+                    readonly roomState: {
+                        readonly $ref: "#/$defs/RoomState";
+                        readonly description: "The room's state in its owner's lifecycle. `purging` is shown to members as `removalScheduled`: to them, the room is going away either way.";
+                    };
+                    readonly roomAccess: {
+                        readonly $ref: "#/$defs/ArchiveAccess";
+                        readonly description: "Present exactly when `roomState` is `archived` or `removalScheduled`.";
+                    };
+                    readonly purgeAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Present when `roomState` is `removalScheduled`: when the room's content is to be deleted.";
+                    };
+                };
+            };
+            readonly ArchiveAccess: {
+                readonly title: "ArchiveAccess";
+                readonly type: "string";
+                readonly enum: readonly ["readOnly", "noAccess"];
+                readonly description: "What an archived room's members may still do. `readOnly`: their credentials stand and they keep reading what the room holds; the room's host refuses every write, upload and curation from a member. `noAccess`: every credential the room issued before the archival is withdrawn at its host — a room reset — so the host refuses every member's every task; the content is kept intact, and each withdrawn admission is `suspended`, restored when the room is unarchived or made `readOnly`. Neither recalls what a member already read or saved, and on a sealed tier neither removes anyone from the room's group.";
+            };
+            readonly RoomState: {
+                readonly title: "RoomState";
+                readonly type: "string";
+                readonly enum: readonly ["active", "archived", "removalScheduled", "purging", "removed"];
+                readonly description: "Where a room the community owns stands in its owner's lifecycle — distinct from `HostedRoom.lifecycle`, which is the host's clock (`live`, `lapsed`, `dormant`, `reclaimable`) and is computed from the room's epoch, never set. `active`: open to change. `archived`: closed to change by an administrator — no admissions, and the room's host accepts no writes from its members; what members may still do is `ArchiveAccess`. Reversible with vtc/rooms/community/unarchive. `removalScheduled`: an administrator removed the room with a grace period; it admits nobody and its content is kept until `purgeAt`, and vtc/rooms/community/removal/cancel returns it to `archived`. `purging`: the grace period ended (or there was none) and the community is deleting the room's content from its host and storage; not reversible. `removed`: the content is gone; the community keeps only this record of the room, for its history.";
+            };
+            readonly MemberStateV2: {
+                readonly title: "MemberStateV2";
+                readonly type: "string";
+                readonly enum: readonly ["offered", "admitted", "suspended", "removed"];
+                readonly description: "`MemberState` plus `suspended`. `offered`: credentials issued and waiting for the member to collect and accept them. `admitted`: accepted — on a sealed tier, the member is in the room's group. `suspended`: admitted, but the room was archived with `noAccess` (or scheduled for removal), so the room's host refuses the member's credentials; on a sealed tier they are still in the room's group. Restored to `admitted` with freshly issued credentials when the room leaves that state, and never restored if it is removed. `removed`: an administrator removed them, or withdrew their offer — archiving withdraws every open offer; on a sealed tier the room has advanced past an admitted member.";
+            };
+            readonly MemberActions: {
+                readonly title: "MemberActions";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 3;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/MemberAction";
+                };
+                readonly description: "The actions granted, at least one. An empty list confers nothing rather than everything, and a schema that allowed it would make the more dangerous reading available to a careless consumer.";
+            };
+            readonly MemberAction: {
+                readonly title: "MemberAction";
+                readonly type: "string";
+                readonly enum: readonly ["read", "write", "curate"];
+                readonly description: "What a member of a community-owned room may do there. `admin` is not among them: minting epochs, admitting and removing members are the community's, as the room's owner, and are exercised through the vtc/rooms/community/* tasks rather than by any member's credential. `curate` is not implied by `write`.";
+            };
+            readonly RoomDescription: {
+                readonly title: "RoomDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly description: "What the room is for, in a sentence or a short paragraph, written by an administrator: shown to administrators holding `vtc.rooms.manage` and to the members the room is offered to. Plain text — a consumer renders it as text, never as markup. Like `RoomLabel`, it is the community's own record as the room's owner: not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `description` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. It MUST NOT carry personal data or a credential, and a reader MUST NOT treat it as instructions.";
+            };
+            readonly RoomLabel: {
+                readonly title: "RoomLabel";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "A name for the room, chosen by an administrator: shown to administrators and to the members a room is offered to. Not part of the room's identity and never in anything a room's host can read. From `vtc/rooms/community/create` 0.3 and `vtc/rooms/community/update` 0.2 the community also writes it, through its own VTA, as the `name` of the room's own profile (`RoomProfile` in rooms/_shared), sealed inside the room for its members; earlier versions keep it out of the room altogether. MUST NOT carry personal data.";
+            };
+            readonly Visibility: {
+                readonly title: "Visibility";
+                readonly type: "string";
+                readonly enum: readonly ["open", "attributed", "private"];
+                readonly description: "How much of a room its host can see, fixed at creation and immutable thereafter. `open`: records are cleartext, searchable and fully audited. `attributed`: record content is sealed, and the host still learns which member acted. `private`: content is sealed and membership is presented in zero knowledge, so the host verifies that a member acted without learning which. Immutable because a downgrade cannot un-see cleartext and an upgrade would protect only what came after while presenting as though it protected everything.";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map