@openvtc/trust-tasks 0.26.13 → 0.26.15

package/dist/rooms/keys/list/0.2/payload.d.ts

@@ -0,0 +1,667 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/rooms/keys/list/0.2/payload.schema.json
+ */
+import type { Ext, PersonalLabel, PersonalLabelDescription, PersonalLabelName, PersonalLabelNotes, PersonalLabelTag, PersonalLabelTags } from "../../../../_shared/components.js";
+/**
+ * List the rooms the key holder can open for members the caller may act as. `includePersonal` asks for each entry's personal label as well; absent, none is returned. Carries no filter: the recipient answers for the members its caller acts as, and there is nothing to ask it about. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface RoomsKeysListPayload {
+    /**
+     * `true` asks for each entry's personal label (rooms/keys/label) in `personal`. Absent or `false`: no entry carries one. A request option, not a filter — it changes which members of an entry are returned, never which entries — and off by default so that a caller that has no use for the member's own names, or will pass the list on, never receives them.
+     */
+    includePersonal?: boolean;
+    /**
+     * Ecosystem-defined extension members per SPEC.md §4.5.1.
+     */
+    ext?: Ext;
+}
+/**
+ * Success response to rooms/keys/list. Type https://trusttasks.org/spec/rooms/keys/list/0.2#response. The rooms this key holder can open, one entry per room and member, for the members the caller may act as. This is key custody, not membership: a room whose group state was never delivered is absent here and the member may still hold a perfectly good VMC for it.
+ */
+export interface RoomsKeysListResponsePayload {
+    /**
+     * One entry per room and member, in no guaranteed order. A room held as two members the caller may act as appears twice, once per member.
+     */
+    rooms: {
+        /**
+         * The room's identifier.
+         */
+        roomId: string;
+        /**
+         * The member this entry's group state is held for: the DID the room admitted. What a client names as `member` to rooms/keys/label, and as `issuer` to rooms/keys/act, to act on this entry rather than on the same room held as another member.
+         */
+        member: string;
+        /**
+         * The epoch this key holder is at for this member. Behind the room's own epoch means a commit has not been delivered, and records sealed since will not open.
+         */
+        epoch: number;
+        /**
+         * The earliest epoch this key holder can derive a key for, for this member, walking the epoch key chain it holds. Equal to `epoch` means it reads only from where it joined; `1` means the room's whole retained history. Anything between is a chain that has been delivered in part, or one deliberately severed below that point.
+         */
+        earliestReadableEpoch: number;
+        /**
+         * The member's own label for the room (rooms/keys/label). Present only when the request set `includePersonal: true` and the member has one. Private to the member: a caller MUST NOT pass it to the room's host, its owner, a community or a website the member has not chosen to show it to.
+         */
+        personal?: PersonalLabel;
+    }[];
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext, PersonalLabel, PersonalLabelDescription, PersonalLabelName, PersonalLabelNotes, PersonalLabelTag, PersonalLabelTags };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/rooms/keys/list/0.2";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RoomsKeysListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/rooms/keys/list/0.2#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RoomsKeysListResponsePayload;
+/**
+ * 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/rooms/keys/list/0.2";
+    readonly title: "Rooms Keys List — payload";
+    readonly description: "List the rooms the key holder can open for members the caller may act as. `includePersonal` asks for each entry's personal label as well; absent, none is returned. Carries no filter: the recipient answers for the members its caller acts as, and there is nothing to ask it about. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly includePersonal: {
+            readonly type: "boolean";
+            readonly description: "`true` asks for each entry's personal label (rooms/keys/label) in `personal`. Absent or `false`: no entry carries one. A request option, not a filter — it changes which members of an entry are returned, never which entries — and off by default so that a caller that has no use for the member's own names, or will pass the list on, never receives them.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+            readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Rooms Keys List — response payload";
+            readonly description: "Success response to rooms/keys/list. Type https://trusttasks.org/spec/rooms/keys/list/0.2#response. The rooms this key holder can open, one entry per room and member, for the members the caller may act as. This is key custody, not membership: a room whose group state was never delivered is absent here and the member may still hold a perfectly good VMC for it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["rooms"];
+            readonly properties: {
+                readonly rooms: {
+                    readonly type: "array";
+                    readonly description: "One entry per room and member, in no guaranteed order. A room held as two members the caller may act as appears twice, once per member.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["roomId", "member", "epoch", "earliestReadableEpoch"];
+                        readonly properties: {
+                            readonly roomId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 512;
+                                readonly description: "The room's identifier.";
+                            };
+                            readonly member: {
+                                readonly type: "string";
+                                readonly pattern: "^did:";
+                                readonly maxLength: 2048;
+                                readonly description: "The member this entry's group state is held for: the DID the room admitted. What a client names as `member` to rooms/keys/label, and as `issuer` to rooms/keys/act, to act on this entry rather than on the same room held as another member.";
+                            };
+                            readonly epoch: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                                readonly description: "The epoch this key holder is at for this member. Behind the room's own epoch means a commit has not been delivered, and records sealed since will not open.";
+                            };
+                            readonly earliestReadableEpoch: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                                readonly description: "The earliest epoch this key holder can derive a key for, for this member, walking the epoch key chain it holds. Equal to `epoch` means it reads only from where it joined; `1` means the room's whole retained history. Anything between is a chain that has been delivered in part, or one deliberately severed below that point.";
+                            };
+                            readonly personal: {
+                                readonly $ref: "#/$defs/PersonalLabel";
+                                readonly description: "The member's own label for the room (rooms/keys/label). Present only when the request set `includePersonal: true` and the member has one. Private to the member: a caller MUST NOT pass it to the room's host, its owner, a community or a website the member has not chosen to show it to.";
+                            };
+                        };
+                    };
+                };
+                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 PersonalLabel: {
+            readonly title: "PersonalLabel";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["updatedAt"];
+            readonly minProperties: 2;
+            readonly description: "A member's personal label for one room, as their key holder keeps it: at least one detail (`minProperties` counts `updatedAt`), and when it last changed. A key holder that holds no detail for the room holds no label, and returns none — there is no empty label.";
+            readonly properties: {
+                readonly label: {
+                    readonly $ref: "#/$defs/PersonalLabelName";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/PersonalLabelDescription";
+                };
+                readonly notes: {
+                    readonly $ref: "#/$defs/PersonalLabelNotes";
+                };
+                readonly tags: {
+                    readonly $ref: "#/$defs/PersonalLabelTags";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the label last changed, as the key holder recorded it. A request that changed nothing does not move it.";
+                };
+            };
+        };
+        readonly PersonalLabelTags: {
+            readonly title: "PersonalLabelTags";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/PersonalLabelTag";
+            };
+            readonly description: "The member's tags for the room, one to sixteen, as a set: order carries no meaning. A room with no tags has no `tags` member, never an empty list, so there is one way to say \"none\".";
+        };
+        readonly PersonalLabelTag: {
+            readonly title: "PersonalLabelTag";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 32;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            readonly description: "A word or short phrase the member files the room under, in any script, so their own surfaces can group and filter their rooms. Compared exactly, as a string: a key holder does not case-fold or normalise it.";
+        };
+        readonly PersonalLabelNotes: {
+            readonly title: "PersonalLabelNotes";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 4000;
+            readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+            readonly description: "Longer free-form notes the member keeps about the room: who introduced them, what to look for in it, what they agreed there. Line breaks and tabs are allowed; other control characters are not.";
+        };
+        readonly PersonalLabelDescription: {
+            readonly title: "PersonalLabelDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+            readonly description: "What the room is to the member, in a sentence or a short paragraph. Line breaks and tabs are allowed; other control characters are not.";
+        };
+        readonly PersonalLabelName: {
+            readonly title: "PersonalLabelName";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            readonly description: "The member's own name for the room, on one line: no control characters, line breaks included. Shown before every name a third party gave the room, because it is the only one nobody else wrote.";
+        };
+    };
+};
+/** 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: "Rooms Keys List — response payload";
+            readonly description: "Success response to rooms/keys/list. Type https://trusttasks.org/spec/rooms/keys/list/0.2#response. The rooms this key holder can open, one entry per room and member, for the members the caller may act as. This is key custody, not membership: a room whose group state was never delivered is absent here and the member may still hold a perfectly good VMC for it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["rooms"];
+            readonly properties: {
+                readonly rooms: {
+                    readonly type: "array";
+                    readonly description: "One entry per room and member, in no guaranteed order. A room held as two members the caller may act as appears twice, once per member.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["roomId", "member", "epoch", "earliestReadableEpoch"];
+                        readonly properties: {
+                            readonly roomId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 512;
+                                readonly description: "The room's identifier.";
+                            };
+                            readonly member: {
+                                readonly type: "string";
+                                readonly pattern: "^did:";
+                                readonly maxLength: 2048;
+                                readonly description: "The member this entry's group state is held for: the DID the room admitted. What a client names as `member` to rooms/keys/label, and as `issuer` to rooms/keys/act, to act on this entry rather than on the same room held as another member.";
+                            };
+                            readonly epoch: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                                readonly description: "The epoch this key holder is at for this member. Behind the room's own epoch means a commit has not been delivered, and records sealed since will not open.";
+                            };
+                            readonly earliestReadableEpoch: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                                readonly description: "The earliest epoch this key holder can derive a key for, for this member, walking the epoch key chain it holds. Equal to `epoch` means it reads only from where it joined; `1` means the room's whole retained history. Anything between is a chain that has been delivered in part, or one deliberately severed below that point.";
+                            };
+                            readonly personal: {
+                                readonly $ref: "#/$defs/PersonalLabel";
+                                readonly description: "The member's own label for the room (rooms/keys/label). Present only when the request set `includePersonal: true` and the member has one. Private to the member: a caller MUST NOT pass it to the room's host, its owner, a community or a website the member has not chosen to show it to.";
+                            };
+                        };
+                    };
+                };
+                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 PersonalLabel: {
+            readonly title: "PersonalLabel";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["updatedAt"];
+            readonly minProperties: 2;
+            readonly description: "A member's personal label for one room, as their key holder keeps it: at least one detail (`minProperties` counts `updatedAt`), and when it last changed. A key holder that holds no detail for the room holds no label, and returns none — there is no empty label.";
+            readonly properties: {
+                readonly label: {
+                    readonly $ref: "#/$defs/PersonalLabelName";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/PersonalLabelDescription";
+                };
+                readonly notes: {
+                    readonly $ref: "#/$defs/PersonalLabelNotes";
+                };
+                readonly tags: {
+                    readonly $ref: "#/$defs/PersonalLabelTags";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the label last changed, as the key holder recorded it. A request that changed nothing does not move it.";
+                };
+            };
+        };
+        readonly PersonalLabelTags: {
+            readonly title: "PersonalLabelTags";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 16;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/PersonalLabelTag";
+            };
+            readonly description: "The member's tags for the room, one to sixteen, as a set: order carries no meaning. A room with no tags has no `tags` member, never an empty list, so there is one way to say \"none\".";
+        };
+        readonly PersonalLabelTag: {
+            readonly title: "PersonalLabelTag";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 32;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            readonly description: "A word or short phrase the member files the room under, in any script, so their own surfaces can group and filter their rooms. Compared exactly, as a string: a key holder does not case-fold or normalise it.";
+        };
+        readonly PersonalLabelNotes: {
+            readonly title: "PersonalLabelNotes";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 4000;
+            readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+            readonly description: "Longer free-form notes the member keeps about the room: who introduced them, what to look for in it, what they agreed there. Line breaks and tabs are allowed; other control characters are not.";
+        };
+        readonly PersonalLabelDescription: {
+            readonly title: "PersonalLabelDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+            readonly description: "What the room is to the member, in a sentence or a short paragraph. Line breaks and tabs are allowed; other control characters are not.";
+        };
+        readonly PersonalLabelName: {
+            readonly title: "PersonalLabelName";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            readonly description: "The member's own name for the room, on one line: no control characters, line breaks included. Shown before every name a third party gave the room, because it is the only one nobody else wrote.";
+        };
+    };
+};
+/**
+ * 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/rooms/keys/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/rooms/keys/list/0.2";
+        readonly title: "Rooms Keys List — payload";
+        readonly description: "List the rooms the key holder can open for members the caller may act as. `includePersonal` asks for each entry's personal label as well; absent, none is returned. Carries no filter: the recipient answers for the members its caller acts as, and there is nothing to ask it about. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly includePersonal: {
+                readonly type: "boolean";
+                readonly description: "`true` asks for each entry's personal label (rooms/keys/label) in `personal`. Absent or `false`: no entry carries one. A request option, not a filter — it changes which members of an entry are returned, never which entries — and off by default so that a caller that has no use for the member's own names, or will pass the list on, never receives them.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+                readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Rooms Keys List — response payload";
+                readonly description: "Success response to rooms/keys/list. Type https://trusttasks.org/spec/rooms/keys/list/0.2#response. The rooms this key holder can open, one entry per room and member, for the members the caller may act as. This is key custody, not membership: a room whose group state was never delivered is absent here and the member may still hold a perfectly good VMC for it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["rooms"];
+                readonly properties: {
+                    readonly rooms: {
+                        readonly type: "array";
+                        readonly description: "One entry per room and member, in no guaranteed order. A room held as two members the caller may act as appears twice, once per member.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["roomId", "member", "epoch", "earliestReadableEpoch"];
+                            readonly properties: {
+                                readonly roomId: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 512;
+                                    readonly description: "The room's identifier.";
+                                };
+                                readonly member: {
+                                    readonly type: "string";
+                                    readonly pattern: "^did:";
+                                    readonly maxLength: 2048;
+                                    readonly description: "The member this entry's group state is held for: the DID the room admitted. What a client names as `member` to rooms/keys/label, and as `issuer` to rooms/keys/act, to act on this entry rather than on the same room held as another member.";
+                                };
+                                readonly epoch: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly description: "The epoch this key holder is at for this member. Behind the room's own epoch means a commit has not been delivered, and records sealed since will not open.";
+                                };
+                                readonly earliestReadableEpoch: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly description: "The earliest epoch this key holder can derive a key for, for this member, walking the epoch key chain it holds. Equal to `epoch` means it reads only from where it joined; `1` means the room's whole retained history. Anything between is a chain that has been delivered in part, or one deliberately severed below that point.";
+                                };
+                                readonly personal: {
+                                    readonly $ref: "#/$defs/PersonalLabel";
+                                    readonly description: "The member's own label for the room (rooms/keys/label). Present only when the request set `includePersonal: true` and the member has one. Private to the member: a caller MUST NOT pass it to the room's host, its owner, a community or a website the member has not chosen to show it to.";
+                                };
+                            };
+                        };
+                    };
+                    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 PersonalLabel: {
+                readonly title: "PersonalLabel";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["updatedAt"];
+                readonly minProperties: 2;
+                readonly description: "A member's personal label for one room, as their key holder keeps it: at least one detail (`minProperties` counts `updatedAt`), and when it last changed. A key holder that holds no detail for the room holds no label, and returns none — there is no empty label.";
+                readonly properties: {
+                    readonly label: {
+                        readonly $ref: "#/$defs/PersonalLabelName";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/PersonalLabelDescription";
+                    };
+                    readonly notes: {
+                        readonly $ref: "#/$defs/PersonalLabelNotes";
+                    };
+                    readonly tags: {
+                        readonly $ref: "#/$defs/PersonalLabelTags";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the label last changed, as the key holder recorded it. A request that changed nothing does not move it.";
+                    };
+                };
+            };
+            readonly PersonalLabelTags: {
+                readonly title: "PersonalLabelTags";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 16;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/PersonalLabelTag";
+                };
+                readonly description: "The member's tags for the room, one to sixteen, as a set: order carries no meaning. A room with no tags has no `tags` member, never an empty list, so there is one way to say \"none\".";
+            };
+            readonly PersonalLabelTag: {
+                readonly title: "PersonalLabelTag";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 32;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+                readonly description: "A word or short phrase the member files the room under, in any script, so their own surfaces can group and filter their rooms. Compared exactly, as a string: a key holder does not case-fold or normalise it.";
+            };
+            readonly PersonalLabelNotes: {
+                readonly title: "PersonalLabelNotes";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 4000;
+                readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+                readonly description: "Longer free-form notes the member keeps about the room: who introduced them, what to look for in it, what they agreed there. Line breaks and tabs are allowed; other control characters are not.";
+            };
+            readonly PersonalLabelDescription: {
+                readonly title: "PersonalLabelDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+                readonly description: "What the room is to the member, in a sentence or a short paragraph. Line breaks and tabs are allowed; other control characters are not.";
+            };
+            readonly PersonalLabelName: {
+                readonly title: "PersonalLabelName";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+                readonly description: "The member's own name for the room, on one line: no control characters, line breaks included. Shown before every name a third party gave the room, because it is the only one nobody else wrote.";
+            };
+        };
+    };
+};
+/**
+ * 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/rooms/keys/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: "Rooms Keys List — response payload";
+                readonly description: "Success response to rooms/keys/list. Type https://trusttasks.org/spec/rooms/keys/list/0.2#response. The rooms this key holder can open, one entry per room and member, for the members the caller may act as. This is key custody, not membership: a room whose group state was never delivered is absent here and the member may still hold a perfectly good VMC for it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["rooms"];
+                readonly properties: {
+                    readonly rooms: {
+                        readonly type: "array";
+                        readonly description: "One entry per room and member, in no guaranteed order. A room held as two members the caller may act as appears twice, once per member.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["roomId", "member", "epoch", "earliestReadableEpoch"];
+                            readonly properties: {
+                                readonly roomId: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                    readonly maxLength: 512;
+                                    readonly description: "The room's identifier.";
+                                };
+                                readonly member: {
+                                    readonly type: "string";
+                                    readonly pattern: "^did:";
+                                    readonly maxLength: 2048;
+                                    readonly description: "The member this entry's group state is held for: the DID the room admitted. What a client names as `member` to rooms/keys/label, and as `issuer` to rooms/keys/act, to act on this entry rather than on the same room held as another member.";
+                                };
+                                readonly epoch: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly description: "The epoch this key holder is at for this member. Behind the room's own epoch means a commit has not been delivered, and records sealed since will not open.";
+                                };
+                                readonly earliestReadableEpoch: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                    readonly description: "The earliest epoch this key holder can derive a key for, for this member, walking the epoch key chain it holds. Equal to `epoch` means it reads only from where it joined; `1` means the room's whole retained history. Anything between is a chain that has been delivered in part, or one deliberately severed below that point.";
+                                };
+                                readonly personal: {
+                                    readonly $ref: "#/$defs/PersonalLabel";
+                                    readonly description: "The member's own label for the room (rooms/keys/label). Present only when the request set `includePersonal: true` and the member has one. Private to the member: a caller MUST NOT pass it to the room's host, its owner, a community or a website the member has not chosen to show it to.";
+                                };
+                            };
+                        };
+                    };
+                    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 PersonalLabel: {
+                readonly title: "PersonalLabel";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["updatedAt"];
+                readonly minProperties: 2;
+                readonly description: "A member's personal label for one room, as their key holder keeps it: at least one detail (`minProperties` counts `updatedAt`), and when it last changed. A key holder that holds no detail for the room holds no label, and returns none — there is no empty label.";
+                readonly properties: {
+                    readonly label: {
+                        readonly $ref: "#/$defs/PersonalLabelName";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/PersonalLabelDescription";
+                    };
+                    readonly notes: {
+                        readonly $ref: "#/$defs/PersonalLabelNotes";
+                    };
+                    readonly tags: {
+                        readonly $ref: "#/$defs/PersonalLabelTags";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the label last changed, as the key holder recorded it. A request that changed nothing does not move it.";
+                    };
+                };
+            };
+            readonly PersonalLabelTags: {
+                readonly title: "PersonalLabelTags";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 16;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/PersonalLabelTag";
+                };
+                readonly description: "The member's tags for the room, one to sixteen, as a set: order carries no meaning. A room with no tags has no `tags` member, never an empty list, so there is one way to say \"none\".";
+            };
+            readonly PersonalLabelTag: {
+                readonly title: "PersonalLabelTag";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 32;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+                readonly description: "A word or short phrase the member files the room under, in any script, so their own surfaces can group and filter their rooms. Compared exactly, as a string: a key holder does not case-fold or normalise it.";
+            };
+            readonly PersonalLabelNotes: {
+                readonly title: "PersonalLabelNotes";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 4000;
+                readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+                readonly description: "Longer free-form notes the member keeps about the room: who introduced them, what to look for in it, what they agreed there. Line breaks and tabs are allowed; other control characters are not.";
+            };
+            readonly PersonalLabelDescription: {
+                readonly title: "PersonalLabelDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly pattern: "^[^\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F]+$";
+                readonly description: "What the room is to the member, in a sentence or a short paragraph. Line breaks and tabs are allowed; other control characters are not.";
+            };
+            readonly PersonalLabelName: {
+                readonly title: "PersonalLabelName";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+                readonly description: "The member's own name for the room, on one line: no control characters, line breaks included. Shown before every name a third party gave the room, because it is the only one nobody else wrote.";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map