@openvtc/trust-tasks 0.28.10 → 0.28.11

package/dist/vtc/notifications/list/0.1/payload.d.ts

@@ -0,0 +1,1311 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/notifications/list/0.1/payload.schema.json
+ */
+import type { Did_NotificationsV0_1 as Did, Ext, GroupId, Kind_NotificationsV0_1 as Kind, Notification, NotificationId, ReceivedNotification, Recipients, RecipientScope, RecordId_VtcNotificationsV0_1 as RecordId, RelayDecision, Status, Subject } from "../../../../_shared/components.js";
+/**
+ * An administrator with `vtc.notifications.read` lists the notifications the community holds as their addressee — filtered by kind or holder — with, for each, whether the community may relay it, what a relay of it would disclose, and the relay decisions already made (VTI-NTF-070). Lapsed notifications are left out unless asked for. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.
+ */
+export interface VTCNotificationsListPayload {
+    /**
+     * Only notifications of this kind.
+     */
+    kind?: Kind;
+    /**
+     * Only notifications whose thing is held by this DID — for example, one community's elections.
+     */
+    heldBy?: Did;
+    /**
+     * Also return notifications that are withdrawn, or whose `validUntil` has passed, and that the community still holds. Absent or false: only notifications whose thing can still be acted on.
+     */
+    includeLapsed?: boolean;
+    /**
+     * An opaque cursor from a previous response's `nextCursor`, for the same filters. The community refuses one it did not issue.
+     */
+    cursor?: string;
+    /**
+     * The most items to return.
+     */
+    limit?: number;
+    ext?: Ext;
+}
+/**
+ * One page of the received notifications that match, most recently received first.
+ */
+export interface VTCNotificationsListResponsePayload {
+    items: ReceivedNotification[];
+    /**
+     * Present when more items remain; absent on the last page.
+     */
+    nextCursor?: string;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Did, Ext, GroupId, Kind, Notification, NotificationId, ReceivedNotification, Recipients, RecipientScope, RecordId, RelayDecision, Status, Subject };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/notifications/list/0.1";
+/**
+ * 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 = VTCNotificationsListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/notifications/list/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCNotificationsListResponsePayload;
+/**
+ * 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/notifications/list/0.1";
+    readonly title: "VTC Notifications — List — payload";
+    readonly description: "An administrator with `vtc.notifications.read` lists the notifications the community holds as their addressee — filtered by kind or holder — with, for each, whether the community may relay it, what a relay of it would disclose, and the relay decisions already made (VTI-NTF-070). Lapsed notifications are left out unless asked for. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly kind: {
+            readonly $ref: "#/$defs/Kind";
+            readonly description: "Only notifications of this kind.";
+        };
+        readonly heldBy: {
+            readonly $ref: "#/$defs/Did";
+            readonly description: "Only notifications whose thing is held by this DID — for example, one community's elections.";
+        };
+        readonly includeLapsed: {
+            readonly type: "boolean";
+            readonly description: "Also return notifications that are withdrawn, or whose `validUntil` has passed, and that the community still holds. Absent or false: only notifications whose thing can still be acted on.";
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 512;
+            readonly description: "An opaque cursor from a previous response's `nextCursor`, for the same filters. The community refuses one it did not issue.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 200;
+            readonly description: "The most items to return.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Notifications — List — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly description: "One page of the received notifications that match, most recently received first.";
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ReceivedNotification";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "Present when more items remain; absent on the last page.";
+                };
+            };
+        };
+        readonly ReceivedNotification: {
+            readonly title: "ReceivedNotification";
+            readonly description: "One notification the community holds, as an administrator with `vtc.notifications.read` sees it. `originator`, `deliveredBy` and every entry of `relayedBy` were verified by the community when it accepted the notification (VTI-NTF-042); an administrator that does not take the community's word for them reads the document with vtc/notifications/show and verifies it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["recordId", "originator", "relayedBy", "notification", "receivedAt", "mayRelay", "relayDecisions"];
+            readonly properties: {
+                readonly recordId: {
+                    readonly $ref: "#/$defs/RecordId";
+                };
+                readonly originator: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The issuer of the notifications/notify document: who said the thing exists.";
+                };
+                readonly relayedBy: {
+                    readonly type: "array";
+                    readonly maxItems: 4;
+                    readonly items: {
+                        readonly $ref: "#/$defs/Did";
+                    };
+                    readonly description: "The relayers the held revision passed through before it reached the community, in the order they relayed it; the last delivered it here, and is the party the acceptance policy counted (VTI-NTF-031). Empty for a notification the originator sent the community directly.";
+                };
+                readonly notification: {
+                    readonly $ref: "#/$defs/Notification";
+                    readonly description: "The notification's members at the revision held.";
+                };
+                readonly receivedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community accepted the revision held.";
+                };
+                readonly mayRelay: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the community may relay the revision held now: its `relayable` is true, its kind may be relayed, the received chain carries at most three relays so that the community's own makes at most four (VTI-NTF-041), and it is neither withdrawn nor past its `validUntil`.";
+                };
+                readonly relayDisclosure: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "What a relay of the notification discloses about the community, as the kind's definition states it (VTI-NTF-046) — for the kind `election`, that the community is a member of the community holding the election. Present exactly when the kind's definition says a relay discloses something; the administrator deciding a relay is shown it, and acknowledges it in vtc/notifications/relay.";
+                };
+                readonly relayDecisions: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/RelayDecision";
+                    };
+                    readonly description: "The relay decisions made for this notification, oldest first. Empty while none has been. Every later revision, a withdrawal included, is relayed to every party an earlier one was, without a new decision (VTI-NTF-044).";
+                };
+            };
+        };
+        readonly RelayDecision: {
+            readonly title: "RelayDecision";
+            readonly description: "One administrator's decision to relay a received notification, as the community records it (VTI-NTF-073). It records the selection and how many parties it added, never who they are: the record of whom the community relayed to exists only to relay later revisions to them (VTI-NTF-044).";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["decidedAt", "decidedBy", "recipients", "recipientCount"];
+            readonly properties: {
+                readonly decidedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the decision was made.";
+                };
+                readonly decidedBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The administrator who made it.";
+                };
+                readonly recipients: {
+                    readonly $ref: "#/$defs/Recipients";
+                };
+                readonly recipientCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many parties this decision added to those the notification is relayed to. Parties an earlier decision already reached are not counted again.";
+                };
+            };
+        };
+        readonly Recipients: {
+            readonly title: "Recipients";
+            readonly description: "The members a relay decision reaches, resolved by the community from its own records when the decision is made (VTI-NTF-072). `groupId` is present exactly when `scope` is `group`, and `role` exactly when `scope` is `role`. Whatever the scope, the community never relays to itself, to the notification's originator, or to any relayer the received chain names (VTI-NTF-047), and relays to each party at most once per revision.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["scope"];
+            readonly properties: {
+                readonly scope: {
+                    readonly $ref: "#/$defs/RecipientScope";
+                };
+                readonly groupId: {
+                    readonly $ref: "#/$defs/GroupId";
+                    readonly description: "The community group whose active members the relay reaches.";
+                };
+                readonly role: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "The community role whose active holders the relay reaches, in the wire form the community's member records use — for example `moderator`, or `custom:editor`.";
+                };
+            };
+            readonly dependentSchemas: {
+                readonly scope: {
+                    readonly anyOf: readonly [{
+                        readonly required: readonly ["groupId"];
+                    }, {
+                        readonly required: readonly ["role"];
+                    }, {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "allMembers";
+                            };
+                        };
+                    }];
+                };
+                readonly groupId: {
+                    readonly properties: {
+                        readonly scope: {
+                            readonly const: "group";
+                        };
+                    };
+                };
+                readonly role: {
+                    readonly properties: {
+                        readonly scope: {
+                            readonly const: "role";
+                        };
+                    };
+                };
+            };
+        };
+        readonly RecipientScope: {
+            readonly title: "RecipientScope";
+            readonly description: "Which of the community's members a relay decision reaches: `allMembers` — every active member; `group` — the active members of one community group; `role` — the active members holding one community role.";
+            readonly type: "string";
+            readonly enum: readonly ["allMembers", "group", "role"];
+        };
+        readonly GroupId: {
+            readonly title: "GroupId";
+            readonly description: "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.";
+            readonly type: "string";
+            readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+        };
+        readonly Did: {
+            readonly title: "Did";
+            readonly description: "A DID.";
+            readonly type: "string";
+            readonly minLength: 8;
+            readonly maxLength: 2048;
+            readonly pattern: "^did:[a-z0-9]+:\\S+$";
+        };
+        readonly RecordId: {
+            readonly title: "RecordId";
+            readonly description: "The community's own identifier for one received notification, stable across the revisions that replace it. Opaque and compared for equality only; unguessable, because a read by a caller without the capability is refused and an enumerable identifier would turn the refusal into an oracle.";
+            readonly type: "string";
+            readonly minLength: 16;
+            readonly maxLength: 128;
+            readonly pattern: "^[A-Za-z0-9._~:-]+$";
+        };
+        readonly Notification: {
+            readonly title: "Notification";
+            readonly description: "The members of one notification, as notifications/notify carries them and as a recipient's agent records them. The originator is the `issuer` of the notifications/notify document and the addressee its `recipient`; neither is repeated here, because the originator's proof covers both.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["notificationId", "revision", "kind", "subject", "audience", "status", "relayable"];
+            readonly properties: {
+                readonly notificationId: {
+                    readonly $ref: "#/$defs/NotificationId";
+                };
+                readonly revision: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 1000000;
+                    readonly description: "The revision of this notification. A recipient replaces the record it holds with a higher revision and leaves it unchanged for an equal or lower one (VTI-NTF-022). The first revision is 1.";
+                };
+                readonly kind: {
+                    readonly $ref: "#/$defs/Kind";
+                };
+                readonly subject: {
+                    readonly $ref: "#/$defs/Subject";
+                };
+                readonly audience: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The DID whose holders or members the thing concerns — for an election under a credential roll, the DID the roll names (`roll.memberOf`); otherwise the community's own. It says whom the thing is for, not that the recipient is one of them: a recipient may be the audience itself, or a party the audience relayed the notification to.";
+                };
+                readonly status: {
+                    readonly $ref: "#/$defs/Status";
+                };
+                readonly relayable: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the addressee may relay this notification to the parties it stands for (notifications/relay). The originator states it explicitly; an addressee MUST NOT relay a notification whose `relayable` is false, or whose kind may not be relayed (VTI-NTF-041).";
+                };
+                readonly validFrom: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the thing can first be acted on — for an election, when voting opens. Absent: it can be acted on now.";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the thing can no longer be acted on, and the notification lapses — for an election, when voting closes. A recipient discards a notification received after it (VTI-NTF-032). Absent: the kind's definition says when it lapses.";
+                };
+            };
+        };
+        readonly Status: {
+            readonly title: "Status";
+            readonly description: "Whether the thing is still open to the audience: `available`, or `withdrawn` — cancelled by its holder, or no longer open to the audience — in which case the recipient keeps the record only to show that it was withdrawn (VTI-NTF-024).";
+            readonly type: "string";
+            readonly enum: readonly ["available", "withdrawn"];
+        };
+        readonly Subject: {
+            readonly title: "Subject";
+            readonly description: "Where the thing is and how to open it. Only these three members: what the thing contains is shown by its holder, to a reader it admits, when the thing is opened with `openWith`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["heldBy", "id", "openWith"];
+            readonly properties: {
+                readonly heldBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The DID of the party holding the thing — for an election, the community. The party a recipient sends `openWith` to.";
+                };
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The thing's identifier at `heldBy`, in the form the `openWith` task takes it — for an election, its `electionId`.";
+                };
+                readonly openWith: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly pattern: "^https://\\S+$";
+                    readonly description: "The Type URI of the Trust Task by which a recipient opens the thing at `heldBy` — for an election, `https://trusttasks.org/spec/vtc/elections/show/0.6`. A recipient opens it only at its principal's choice (VTI-NTF-053), and only by a version of that task it and `heldBy` both serve.";
+                };
+            };
+        };
+        readonly Kind: {
+            readonly title: "Kind";
+            readonly description: "What the thing is. Either a registered kind — one lowerCamelCase name in the VTI specification's notification kind registry (Appendix G), such as `election` — or an unregistered kind, written `<reverse-DNS domain>:<name>` under a domain its definer controls, such as `org.example:meetingInvite`. A recipient that does not recognise a kind holds, lists and discards it and does nothing else with it (VTI-NTF-012).";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 256;
+            readonly pattern: "^([a-z][a-zA-Z0-9]{0,63}|[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)+:[a-z][a-zA-Z0-9]{0,63})$";
+        };
+        readonly NotificationId: {
+            readonly title: "NotificationId";
+            readonly description: "The originator's identifier for one notification, unique among the notifications that originator issues and the same in every document that carries it — retries, re-issued documents and relayed copies alike. It is the notification's idempotency key (VTI-NTF-021). Compared for equality only. An originator SHOULD make it unguessable and SHOULD NOT make it descriptive: it travels as far as the notification does.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 256;
+            readonly pattern: "^[A-Za-z0-9._~:-]+$";
+        };
+        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-]+)+$";
+            };
+        };
+    };
+};
+/** 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 Notifications — List — response payload";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly description: "One page of the received notifications that match, most recently received first.";
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/ReceivedNotification";
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly description: "Present when more items remain; absent on the last page.";
+                };
+            };
+        };
+        readonly ReceivedNotification: {
+            readonly title: "ReceivedNotification";
+            readonly description: "One notification the community holds, as an administrator with `vtc.notifications.read` sees it. `originator`, `deliveredBy` and every entry of `relayedBy` were verified by the community when it accepted the notification (VTI-NTF-042); an administrator that does not take the community's word for them reads the document with vtc/notifications/show and verifies it.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["recordId", "originator", "relayedBy", "notification", "receivedAt", "mayRelay", "relayDecisions"];
+            readonly properties: {
+                readonly recordId: {
+                    readonly $ref: "#/$defs/RecordId";
+                };
+                readonly originator: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The issuer of the notifications/notify document: who said the thing exists.";
+                };
+                readonly relayedBy: {
+                    readonly type: "array";
+                    readonly maxItems: 4;
+                    readonly items: {
+                        readonly $ref: "#/$defs/Did";
+                    };
+                    readonly description: "The relayers the held revision passed through before it reached the community, in the order they relayed it; the last delivered it here, and is the party the acceptance policy counted (VTI-NTF-031). Empty for a notification the originator sent the community directly.";
+                };
+                readonly notification: {
+                    readonly $ref: "#/$defs/Notification";
+                    readonly description: "The notification's members at the revision held.";
+                };
+                readonly receivedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community accepted the revision held.";
+                };
+                readonly mayRelay: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the community may relay the revision held now: its `relayable` is true, its kind may be relayed, the received chain carries at most three relays so that the community's own makes at most four (VTI-NTF-041), and it is neither withdrawn nor past its `validUntil`.";
+                };
+                readonly relayDisclosure: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 1024;
+                    readonly description: "What a relay of the notification discloses about the community, as the kind's definition states it (VTI-NTF-046) — for the kind `election`, that the community is a member of the community holding the election. Present exactly when the kind's definition says a relay discloses something; the administrator deciding a relay is shown it, and acknowledges it in vtc/notifications/relay.";
+                };
+                readonly relayDecisions: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/RelayDecision";
+                    };
+                    readonly description: "The relay decisions made for this notification, oldest first. Empty while none has been. Every later revision, a withdrawal included, is relayed to every party an earlier one was, without a new decision (VTI-NTF-044).";
+                };
+            };
+        };
+        readonly RelayDecision: {
+            readonly title: "RelayDecision";
+            readonly description: "One administrator's decision to relay a received notification, as the community records it (VTI-NTF-073). It records the selection and how many parties it added, never who they are: the record of whom the community relayed to exists only to relay later revisions to them (VTI-NTF-044).";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["decidedAt", "decidedBy", "recipients", "recipientCount"];
+            readonly properties: {
+                readonly decidedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the decision was made.";
+                };
+                readonly decidedBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The administrator who made it.";
+                };
+                readonly recipients: {
+                    readonly $ref: "#/$defs/Recipients";
+                };
+                readonly recipientCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many parties this decision added to those the notification is relayed to. Parties an earlier decision already reached are not counted again.";
+                };
+            };
+        };
+        readonly Recipients: {
+            readonly title: "Recipients";
+            readonly description: "The members a relay decision reaches, resolved by the community from its own records when the decision is made (VTI-NTF-072). `groupId` is present exactly when `scope` is `group`, and `role` exactly when `scope` is `role`. Whatever the scope, the community never relays to itself, to the notification's originator, or to any relayer the received chain names (VTI-NTF-047), and relays to each party at most once per revision.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["scope"];
+            readonly properties: {
+                readonly scope: {
+                    readonly $ref: "#/$defs/RecipientScope";
+                };
+                readonly groupId: {
+                    readonly $ref: "#/$defs/GroupId";
+                    readonly description: "The community group whose active members the relay reaches.";
+                };
+                readonly role: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "The community role whose active holders the relay reaches, in the wire form the community's member records use — for example `moderator`, or `custom:editor`.";
+                };
+            };
+            readonly dependentSchemas: {
+                readonly scope: {
+                    readonly anyOf: readonly [{
+                        readonly required: readonly ["groupId"];
+                    }, {
+                        readonly required: readonly ["role"];
+                    }, {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "allMembers";
+                            };
+                        };
+                    }];
+                };
+                readonly groupId: {
+                    readonly properties: {
+                        readonly scope: {
+                            readonly const: "group";
+                        };
+                    };
+                };
+                readonly role: {
+                    readonly properties: {
+                        readonly scope: {
+                            readonly const: "role";
+                        };
+                    };
+                };
+            };
+        };
+        readonly RecipientScope: {
+            readonly title: "RecipientScope";
+            readonly description: "Which of the community's members a relay decision reaches: `allMembers` — every active member; `group` — the active members of one community group; `role` — the active members holding one community role.";
+            readonly type: "string";
+            readonly enum: readonly ["allMembers", "group", "role"];
+        };
+        readonly GroupId: {
+            readonly title: "GroupId";
+            readonly description: "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.";
+            readonly type: "string";
+            readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+        };
+        readonly Did: {
+            readonly title: "Did";
+            readonly description: "A DID.";
+            readonly type: "string";
+            readonly minLength: 8;
+            readonly maxLength: 2048;
+            readonly pattern: "^did:[a-z0-9]+:\\S+$";
+        };
+        readonly RecordId: {
+            readonly title: "RecordId";
+            readonly description: "The community's own identifier for one received notification, stable across the revisions that replace it. Opaque and compared for equality only; unguessable, because a read by a caller without the capability is refused and an enumerable identifier would turn the refusal into an oracle.";
+            readonly type: "string";
+            readonly minLength: 16;
+            readonly maxLength: 128;
+            readonly pattern: "^[A-Za-z0-9._~:-]+$";
+        };
+        readonly Notification: {
+            readonly title: "Notification";
+            readonly description: "The members of one notification, as notifications/notify carries them and as a recipient's agent records them. The originator is the `issuer` of the notifications/notify document and the addressee its `recipient`; neither is repeated here, because the originator's proof covers both.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["notificationId", "revision", "kind", "subject", "audience", "status", "relayable"];
+            readonly properties: {
+                readonly notificationId: {
+                    readonly $ref: "#/$defs/NotificationId";
+                };
+                readonly revision: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 1000000;
+                    readonly description: "The revision of this notification. A recipient replaces the record it holds with a higher revision and leaves it unchanged for an equal or lower one (VTI-NTF-022). The first revision is 1.";
+                };
+                readonly kind: {
+                    readonly $ref: "#/$defs/Kind";
+                };
+                readonly subject: {
+                    readonly $ref: "#/$defs/Subject";
+                };
+                readonly audience: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The DID whose holders or members the thing concerns — for an election under a credential roll, the DID the roll names (`roll.memberOf`); otherwise the community's own. It says whom the thing is for, not that the recipient is one of them: a recipient may be the audience itself, or a party the audience relayed the notification to.";
+                };
+                readonly status: {
+                    readonly $ref: "#/$defs/Status";
+                };
+                readonly relayable: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the addressee may relay this notification to the parties it stands for (notifications/relay). The originator states it explicitly; an addressee MUST NOT relay a notification whose `relayable` is false, or whose kind may not be relayed (VTI-NTF-041).";
+                };
+                readonly validFrom: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the thing can first be acted on — for an election, when voting opens. Absent: it can be acted on now.";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the thing can no longer be acted on, and the notification lapses — for an election, when voting closes. A recipient discards a notification received after it (VTI-NTF-032). Absent: the kind's definition says when it lapses.";
+                };
+            };
+        };
+        readonly Status: {
+            readonly title: "Status";
+            readonly description: "Whether the thing is still open to the audience: `available`, or `withdrawn` — cancelled by its holder, or no longer open to the audience — in which case the recipient keeps the record only to show that it was withdrawn (VTI-NTF-024).";
+            readonly type: "string";
+            readonly enum: readonly ["available", "withdrawn"];
+        };
+        readonly Subject: {
+            readonly title: "Subject";
+            readonly description: "Where the thing is and how to open it. Only these three members: what the thing contains is shown by its holder, to a reader it admits, when the thing is opened with `openWith`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["heldBy", "id", "openWith"];
+            readonly properties: {
+                readonly heldBy: {
+                    readonly $ref: "#/$defs/Did";
+                    readonly description: "The DID of the party holding the thing — for an election, the community. The party a recipient sends `openWith` to.";
+                };
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 256;
+                    readonly description: "The thing's identifier at `heldBy`, in the form the `openWith` task takes it — for an election, its `electionId`.";
+                };
+                readonly openWith: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 512;
+                    readonly pattern: "^https://\\S+$";
+                    readonly description: "The Type URI of the Trust Task by which a recipient opens the thing at `heldBy` — for an election, `https://trusttasks.org/spec/vtc/elections/show/0.6`. A recipient opens it only at its principal's choice (VTI-NTF-053), and only by a version of that task it and `heldBy` both serve.";
+                };
+            };
+        };
+        readonly Kind: {
+            readonly title: "Kind";
+            readonly description: "What the thing is. Either a registered kind — one lowerCamelCase name in the VTI specification's notification kind registry (Appendix G), such as `election` — or an unregistered kind, written `<reverse-DNS domain>:<name>` under a domain its definer controls, such as `org.example:meetingInvite`. A recipient that does not recognise a kind holds, lists and discards it and does nothing else with it (VTI-NTF-012).";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 256;
+            readonly pattern: "^([a-z][a-zA-Z0-9]{0,63}|[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)+:[a-z][a-zA-Z0-9]{0,63})$";
+        };
+        readonly NotificationId: {
+            readonly title: "NotificationId";
+            readonly description: "The originator's identifier for one notification, unique among the notifications that originator issues and the same in every document that carries it — retries, re-issued documents and relayed copies alike. It is the notification's idempotency key (VTI-NTF-021). Compared for equality only. An originator SHOULD make it unguessable and SHOULD NOT make it descriptive: it travels as far as the notification does.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 256;
+            readonly pattern: "^[A-Za-z0-9._~:-]+$";
+        };
+        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-]+)+$";
+            };
+        };
+    };
+};
+/**
+ * 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/notifications/list/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/notifications/list/0.1";
+        readonly title: "VTC Notifications — List — payload";
+        readonly description: "An administrator with `vtc.notifications.read` lists the notifications the community holds as their addressee — filtered by kind or holder — with, for each, whether the community may relay it, what a relay of it would disclose, and the relay decisions already made (VTI-NTF-070). Lapsed notifications are left out unless asked for. The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly kind: {
+                readonly $ref: "#/$defs/Kind";
+                readonly description: "Only notifications of this kind.";
+            };
+            readonly heldBy: {
+                readonly $ref: "#/$defs/Did";
+                readonly description: "Only notifications whose thing is held by this DID — for example, one community's elections.";
+            };
+            readonly includeLapsed: {
+                readonly type: "boolean";
+                readonly description: "Also return notifications that are withdrawn, or whose `validUntil` has passed, and that the community still holds. Absent or false: only notifications whose thing can still be acted on.";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 512;
+                readonly description: "An opaque cursor from a previous response's `nextCursor`, for the same filters. The community refuses one it did not issue.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 200;
+                readonly description: "The most items to return.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Notifications — List — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly description: "One page of the received notifications that match, most recently received first.";
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/ReceivedNotification";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "Present when more items remain; absent on the last page.";
+                    };
+                };
+            };
+            readonly ReceivedNotification: {
+                readonly title: "ReceivedNotification";
+                readonly description: "One notification the community holds, as an administrator with `vtc.notifications.read` sees it. `originator`, `deliveredBy` and every entry of `relayedBy` were verified by the community when it accepted the notification (VTI-NTF-042); an administrator that does not take the community's word for them reads the document with vtc/notifications/show and verifies it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["recordId", "originator", "relayedBy", "notification", "receivedAt", "mayRelay", "relayDecisions"];
+                readonly properties: {
+                    readonly recordId: {
+                        readonly $ref: "#/$defs/RecordId";
+                    };
+                    readonly originator: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The issuer of the notifications/notify document: who said the thing exists.";
+                    };
+                    readonly relayedBy: {
+                        readonly type: "array";
+                        readonly maxItems: 4;
+                        readonly items: {
+                            readonly $ref: "#/$defs/Did";
+                        };
+                        readonly description: "The relayers the held revision passed through before it reached the community, in the order they relayed it; the last delivered it here, and is the party the acceptance policy counted (VTI-NTF-031). Empty for a notification the originator sent the community directly.";
+                    };
+                    readonly notification: {
+                        readonly $ref: "#/$defs/Notification";
+                        readonly description: "The notification's members at the revision held.";
+                    };
+                    readonly receivedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community accepted the revision held.";
+                    };
+                    readonly mayRelay: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the community may relay the revision held now: its `relayable` is true, its kind may be relayed, the received chain carries at most three relays so that the community's own makes at most four (VTI-NTF-041), and it is neither withdrawn nor past its `validUntil`.";
+                    };
+                    readonly relayDisclosure: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "What a relay of the notification discloses about the community, as the kind's definition states it (VTI-NTF-046) — for the kind `election`, that the community is a member of the community holding the election. Present exactly when the kind's definition says a relay discloses something; the administrator deciding a relay is shown it, and acknowledges it in vtc/notifications/relay.";
+                    };
+                    readonly relayDecisions: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/RelayDecision";
+                        };
+                        readonly description: "The relay decisions made for this notification, oldest first. Empty while none has been. Every later revision, a withdrawal included, is relayed to every party an earlier one was, without a new decision (VTI-NTF-044).";
+                    };
+                };
+            };
+            readonly RelayDecision: {
+                readonly title: "RelayDecision";
+                readonly description: "One administrator's decision to relay a received notification, as the community records it (VTI-NTF-073). It records the selection and how many parties it added, never who they are: the record of whom the community relayed to exists only to relay later revisions to them (VTI-NTF-044).";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["decidedAt", "decidedBy", "recipients", "recipientCount"];
+                readonly properties: {
+                    readonly decidedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the decision was made.";
+                    };
+                    readonly decidedBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The administrator who made it.";
+                    };
+                    readonly recipients: {
+                        readonly $ref: "#/$defs/Recipients";
+                    };
+                    readonly recipientCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many parties this decision added to those the notification is relayed to. Parties an earlier decision already reached are not counted again.";
+                    };
+                };
+            };
+            readonly Recipients: {
+                readonly title: "Recipients";
+                readonly description: "The members a relay decision reaches, resolved by the community from its own records when the decision is made (VTI-NTF-072). `groupId` is present exactly when `scope` is `group`, and `role` exactly when `scope` is `role`. Whatever the scope, the community never relays to itself, to the notification's originator, or to any relayer the received chain names (VTI-NTF-047), and relays to each party at most once per revision.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["scope"];
+                readonly properties: {
+                    readonly scope: {
+                        readonly $ref: "#/$defs/RecipientScope";
+                    };
+                    readonly groupId: {
+                        readonly $ref: "#/$defs/GroupId";
+                        readonly description: "The community group whose active members the relay reaches.";
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "The community role whose active holders the relay reaches, in the wire form the community's member records use — for example `moderator`, or `custom:editor`.";
+                    };
+                };
+                readonly dependentSchemas: {
+                    readonly scope: {
+                        readonly anyOf: readonly [{
+                            readonly required: readonly ["groupId"];
+                        }, {
+                            readonly required: readonly ["role"];
+                        }, {
+                            readonly properties: {
+                                readonly scope: {
+                                    readonly const: "allMembers";
+                                };
+                            };
+                        }];
+                    };
+                    readonly groupId: {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "group";
+                            };
+                        };
+                    };
+                    readonly role: {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "role";
+                            };
+                        };
+                    };
+                };
+            };
+            readonly RecipientScope: {
+                readonly title: "RecipientScope";
+                readonly description: "Which of the community's members a relay decision reaches: `allMembers` — every active member; `group` — the active members of one community group; `role` — the active members holding one community role.";
+                readonly type: "string";
+                readonly enum: readonly ["allMembers", "group", "role"];
+            };
+            readonly GroupId: {
+                readonly title: "GroupId";
+                readonly description: "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.";
+                readonly type: "string";
+                readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+            };
+            readonly Did: {
+                readonly title: "Did";
+                readonly description: "A DID.";
+                readonly type: "string";
+                readonly minLength: 8;
+                readonly maxLength: 2048;
+                readonly pattern: "^did:[a-z0-9]+:\\S+$";
+            };
+            readonly RecordId: {
+                readonly title: "RecordId";
+                readonly description: "The community's own identifier for one received notification, stable across the revisions that replace it. Opaque and compared for equality only; unguessable, because a read by a caller without the capability is refused and an enumerable identifier would turn the refusal into an oracle.";
+                readonly type: "string";
+                readonly minLength: 16;
+                readonly maxLength: 128;
+                readonly pattern: "^[A-Za-z0-9._~:-]+$";
+            };
+            readonly Notification: {
+                readonly title: "Notification";
+                readonly description: "The members of one notification, as notifications/notify carries them and as a recipient's agent records them. The originator is the `issuer` of the notifications/notify document and the addressee its `recipient`; neither is repeated here, because the originator's proof covers both.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["notificationId", "revision", "kind", "subject", "audience", "status", "relayable"];
+                readonly properties: {
+                    readonly notificationId: {
+                        readonly $ref: "#/$defs/NotificationId";
+                    };
+                    readonly revision: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 1000000;
+                        readonly description: "The revision of this notification. A recipient replaces the record it holds with a higher revision and leaves it unchanged for an equal or lower one (VTI-NTF-022). The first revision is 1.";
+                    };
+                    readonly kind: {
+                        readonly $ref: "#/$defs/Kind";
+                    };
+                    readonly subject: {
+                        readonly $ref: "#/$defs/Subject";
+                    };
+                    readonly audience: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The DID whose holders or members the thing concerns — for an election under a credential roll, the DID the roll names (`roll.memberOf`); otherwise the community's own. It says whom the thing is for, not that the recipient is one of them: a recipient may be the audience itself, or a party the audience relayed the notification to.";
+                    };
+                    readonly status: {
+                        readonly $ref: "#/$defs/Status";
+                    };
+                    readonly relayable: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the addressee may relay this notification to the parties it stands for (notifications/relay). The originator states it explicitly; an addressee MUST NOT relay a notification whose `relayable` is false, or whose kind may not be relayed (VTI-NTF-041).";
+                    };
+                    readonly validFrom: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the thing can first be acted on — for an election, when voting opens. Absent: it can be acted on now.";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the thing can no longer be acted on, and the notification lapses — for an election, when voting closes. A recipient discards a notification received after it (VTI-NTF-032). Absent: the kind's definition says when it lapses.";
+                    };
+                };
+            };
+            readonly Status: {
+                readonly title: "Status";
+                readonly description: "Whether the thing is still open to the audience: `available`, or `withdrawn` — cancelled by its holder, or no longer open to the audience — in which case the recipient keeps the record only to show that it was withdrawn (VTI-NTF-024).";
+                readonly type: "string";
+                readonly enum: readonly ["available", "withdrawn"];
+            };
+            readonly Subject: {
+                readonly title: "Subject";
+                readonly description: "Where the thing is and how to open it. Only these three members: what the thing contains is shown by its holder, to a reader it admits, when the thing is opened with `openWith`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["heldBy", "id", "openWith"];
+                readonly properties: {
+                    readonly heldBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The DID of the party holding the thing — for an election, the community. The party a recipient sends `openWith` to.";
+                    };
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The thing's identifier at `heldBy`, in the form the `openWith` task takes it — for an election, its `electionId`.";
+                    };
+                    readonly openWith: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly pattern: "^https://\\S+$";
+                        readonly description: "The Type URI of the Trust Task by which a recipient opens the thing at `heldBy` — for an election, `https://trusttasks.org/spec/vtc/elections/show/0.6`. A recipient opens it only at its principal's choice (VTI-NTF-053), and only by a version of that task it and `heldBy` both serve.";
+                    };
+                };
+            };
+            readonly Kind: {
+                readonly title: "Kind";
+                readonly description: "What the thing is. Either a registered kind — one lowerCamelCase name in the VTI specification's notification kind registry (Appendix G), such as `election` — or an unregistered kind, written `<reverse-DNS domain>:<name>` under a domain its definer controls, such as `org.example:meetingInvite`. A recipient that does not recognise a kind holds, lists and discards it and does nothing else with it (VTI-NTF-012).";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 256;
+                readonly pattern: "^([a-z][a-zA-Z0-9]{0,63}|[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)+:[a-z][a-zA-Z0-9]{0,63})$";
+            };
+            readonly NotificationId: {
+                readonly title: "NotificationId";
+                readonly description: "The originator's identifier for one notification, unique among the notifications that originator issues and the same in every document that carries it — retries, re-issued documents and relayed copies alike. It is the notification's idempotency key (VTI-NTF-021). Compared for equality only. An originator SHOULD make it unguessable and SHOULD NOT make it descriptive: it travels as far as the notification does.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 256;
+                readonly pattern: "^[A-Za-z0-9._~:-]+$";
+            };
+            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-]+)+$";
+                };
+            };
+        };
+    };
+};
+/**
+ * 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/notifications/list/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    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 Notifications — List — response payload";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly description: "One page of the received notifications that match, most recently received first.";
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/ReceivedNotification";
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly description: "Present when more items remain; absent on the last page.";
+                    };
+                };
+            };
+            readonly ReceivedNotification: {
+                readonly title: "ReceivedNotification";
+                readonly description: "One notification the community holds, as an administrator with `vtc.notifications.read` sees it. `originator`, `deliveredBy` and every entry of `relayedBy` were verified by the community when it accepted the notification (VTI-NTF-042); an administrator that does not take the community's word for them reads the document with vtc/notifications/show and verifies it.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["recordId", "originator", "relayedBy", "notification", "receivedAt", "mayRelay", "relayDecisions"];
+                readonly properties: {
+                    readonly recordId: {
+                        readonly $ref: "#/$defs/RecordId";
+                    };
+                    readonly originator: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The issuer of the notifications/notify document: who said the thing exists.";
+                    };
+                    readonly relayedBy: {
+                        readonly type: "array";
+                        readonly maxItems: 4;
+                        readonly items: {
+                            readonly $ref: "#/$defs/Did";
+                        };
+                        readonly description: "The relayers the held revision passed through before it reached the community, in the order they relayed it; the last delivered it here, and is the party the acceptance policy counted (VTI-NTF-031). Empty for a notification the originator sent the community directly.";
+                    };
+                    readonly notification: {
+                        readonly $ref: "#/$defs/Notification";
+                        readonly description: "The notification's members at the revision held.";
+                    };
+                    readonly receivedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community accepted the revision held.";
+                    };
+                    readonly mayRelay: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the community may relay the revision held now: its `relayable` is true, its kind may be relayed, the received chain carries at most three relays so that the community's own makes at most four (VTI-NTF-041), and it is neither withdrawn nor past its `validUntil`.";
+                    };
+                    readonly relayDisclosure: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 1024;
+                        readonly description: "What a relay of the notification discloses about the community, as the kind's definition states it (VTI-NTF-046) — for the kind `election`, that the community is a member of the community holding the election. Present exactly when the kind's definition says a relay discloses something; the administrator deciding a relay is shown it, and acknowledges it in vtc/notifications/relay.";
+                    };
+                    readonly relayDecisions: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/RelayDecision";
+                        };
+                        readonly description: "The relay decisions made for this notification, oldest first. Empty while none has been. Every later revision, a withdrawal included, is relayed to every party an earlier one was, without a new decision (VTI-NTF-044).";
+                    };
+                };
+            };
+            readonly RelayDecision: {
+                readonly title: "RelayDecision";
+                readonly description: "One administrator's decision to relay a received notification, as the community records it (VTI-NTF-073). It records the selection and how many parties it added, never who they are: the record of whom the community relayed to exists only to relay later revisions to them (VTI-NTF-044).";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["decidedAt", "decidedBy", "recipients", "recipientCount"];
+                readonly properties: {
+                    readonly decidedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the decision was made.";
+                    };
+                    readonly decidedBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The administrator who made it.";
+                    };
+                    readonly recipients: {
+                        readonly $ref: "#/$defs/Recipients";
+                    };
+                    readonly recipientCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many parties this decision added to those the notification is relayed to. Parties an earlier decision already reached are not counted again.";
+                    };
+                };
+            };
+            readonly Recipients: {
+                readonly title: "Recipients";
+                readonly description: "The members a relay decision reaches, resolved by the community from its own records when the decision is made (VTI-NTF-072). `groupId` is present exactly when `scope` is `group`, and `role` exactly when `scope` is `role`. Whatever the scope, the community never relays to itself, to the notification's originator, or to any relayer the received chain names (VTI-NTF-047), and relays to each party at most once per revision.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["scope"];
+                readonly properties: {
+                    readonly scope: {
+                        readonly $ref: "#/$defs/RecipientScope";
+                    };
+                    readonly groupId: {
+                        readonly $ref: "#/$defs/GroupId";
+                        readonly description: "The community group whose active members the relay reaches.";
+                    };
+                    readonly role: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "The community role whose active holders the relay reaches, in the wire form the community's member records use — for example `moderator`, or `custom:editor`.";
+                    };
+                };
+                readonly dependentSchemas: {
+                    readonly scope: {
+                        readonly anyOf: readonly [{
+                            readonly required: readonly ["groupId"];
+                        }, {
+                            readonly required: readonly ["role"];
+                        }, {
+                            readonly properties: {
+                                readonly scope: {
+                                    readonly const: "allMembers";
+                                };
+                            };
+                        }];
+                    };
+                    readonly groupId: {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "group";
+                            };
+                        };
+                    };
+                    readonly role: {
+                        readonly properties: {
+                            readonly scope: {
+                                readonly const: "role";
+                            };
+                        };
+                    };
+                };
+            };
+            readonly RecipientScope: {
+                readonly title: "RecipientScope";
+                readonly description: "Which of the community's members a relay decision reaches: `allMembers` — every active member; `group` — the active members of one community group; `role` — the active members holding one community role.";
+                readonly type: "string";
+                readonly enum: readonly ["allMembers", "group", "role"];
+            };
+            readonly GroupId: {
+                readonly title: "GroupId";
+                readonly description: "Opaque identifier of a community group: `grp_` followed by 16 to 64 base64url characters. Random and community-scoped; not the group's DID.";
+                readonly type: "string";
+                readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+            };
+            readonly Did: {
+                readonly title: "Did";
+                readonly description: "A DID.";
+                readonly type: "string";
+                readonly minLength: 8;
+                readonly maxLength: 2048;
+                readonly pattern: "^did:[a-z0-9]+:\\S+$";
+            };
+            readonly RecordId: {
+                readonly title: "RecordId";
+                readonly description: "The community's own identifier for one received notification, stable across the revisions that replace it. Opaque and compared for equality only; unguessable, because a read by a caller without the capability is refused and an enumerable identifier would turn the refusal into an oracle.";
+                readonly type: "string";
+                readonly minLength: 16;
+                readonly maxLength: 128;
+                readonly pattern: "^[A-Za-z0-9._~:-]+$";
+            };
+            readonly Notification: {
+                readonly title: "Notification";
+                readonly description: "The members of one notification, as notifications/notify carries them and as a recipient's agent records them. The originator is the `issuer` of the notifications/notify document and the addressee its `recipient`; neither is repeated here, because the originator's proof covers both.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["notificationId", "revision", "kind", "subject", "audience", "status", "relayable"];
+                readonly properties: {
+                    readonly notificationId: {
+                        readonly $ref: "#/$defs/NotificationId";
+                    };
+                    readonly revision: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 1000000;
+                        readonly description: "The revision of this notification. A recipient replaces the record it holds with a higher revision and leaves it unchanged for an equal or lower one (VTI-NTF-022). The first revision is 1.";
+                    };
+                    readonly kind: {
+                        readonly $ref: "#/$defs/Kind";
+                    };
+                    readonly subject: {
+                        readonly $ref: "#/$defs/Subject";
+                    };
+                    readonly audience: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The DID whose holders or members the thing concerns — for an election under a credential roll, the DID the roll names (`roll.memberOf`); otherwise the community's own. It says whom the thing is for, not that the recipient is one of them: a recipient may be the audience itself, or a party the audience relayed the notification to.";
+                    };
+                    readonly status: {
+                        readonly $ref: "#/$defs/Status";
+                    };
+                    readonly relayable: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the addressee may relay this notification to the parties it stands for (notifications/relay). The originator states it explicitly; an addressee MUST NOT relay a notification whose `relayable` is false, or whose kind may not be relayed (VTI-NTF-041).";
+                    };
+                    readonly validFrom: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the thing can first be acted on — for an election, when voting opens. Absent: it can be acted on now.";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the thing can no longer be acted on, and the notification lapses — for an election, when voting closes. A recipient discards a notification received after it (VTI-NTF-032). Absent: the kind's definition says when it lapses.";
+                    };
+                };
+            };
+            readonly Status: {
+                readonly title: "Status";
+                readonly description: "Whether the thing is still open to the audience: `available`, or `withdrawn` — cancelled by its holder, or no longer open to the audience — in which case the recipient keeps the record only to show that it was withdrawn (VTI-NTF-024).";
+                readonly type: "string";
+                readonly enum: readonly ["available", "withdrawn"];
+            };
+            readonly Subject: {
+                readonly title: "Subject";
+                readonly description: "Where the thing is and how to open it. Only these three members: what the thing contains is shown by its holder, to a reader it admits, when the thing is opened with `openWith`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["heldBy", "id", "openWith"];
+                readonly properties: {
+                    readonly heldBy: {
+                        readonly $ref: "#/$defs/Did";
+                        readonly description: "The DID of the party holding the thing — for an election, the community. The party a recipient sends `openWith` to.";
+                    };
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 256;
+                        readonly description: "The thing's identifier at `heldBy`, in the form the `openWith` task takes it — for an election, its `electionId`.";
+                    };
+                    readonly openWith: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 512;
+                        readonly pattern: "^https://\\S+$";
+                        readonly description: "The Type URI of the Trust Task by which a recipient opens the thing at `heldBy` — for an election, `https://trusttasks.org/spec/vtc/elections/show/0.6`. A recipient opens it only at its principal's choice (VTI-NTF-053), and only by a version of that task it and `heldBy` both serve.";
+                    };
+                };
+            };
+            readonly Kind: {
+                readonly title: "Kind";
+                readonly description: "What the thing is. Either a registered kind — one lowerCamelCase name in the VTI specification's notification kind registry (Appendix G), such as `election` — or an unregistered kind, written `<reverse-DNS domain>:<name>` under a domain its definer controls, such as `org.example:meetingInvite`. A recipient that does not recognise a kind holds, lists and discards it and does nothing else with it (VTI-NTF-012).";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 256;
+                readonly pattern: "^([a-z][a-zA-Z0-9]{0,63}|[a-z0-9]+(-[a-z0-9]+)*(\\.[a-z0-9]+(-[a-z0-9]+)*)+:[a-z][a-zA-Z0-9]{0,63})$";
+            };
+            readonly NotificationId: {
+                readonly title: "NotificationId";
+                readonly description: "The originator's identifier for one notification, unique among the notifications that originator issues and the same in every document that carries it — retries, re-issued documents and relayed copies alike. It is the notification's idempotency key (VTI-NTF-021). Compared for equality only. An originator SHOULD make it unguessable and SHOULD NOT make it descriptive: it travels as far as the notification does.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 256;
+                readonly pattern: "^[A-Za-z0-9._~:-]+$";
+            };
+            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-]+)+$";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map