@openvtc/trust-tasks 0.27.3 → 0.27.4

package/dist/vtc/groups/list/0.2/payload.d.ts

@@ -0,0 +1,1139 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/groups/list/0.2/payload.schema.json
+ */
+import type { DynamicRule, EntryId, Ext, FieldKey, Group, GroupAudience, GroupDescription, GroupId, GroupKind, GroupName, JoinPolicy, RuleCondition } from "../../../../_shared/components.js";
+/**
+ * List the community groups the caller may see — all of them for an administrator, the visible ones for a member — optionally only those they belong to or could join. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCGroupsListPayload {
+    /**
+     * Only groups the caller belongs to.
+     */
+    mine?: boolean;
+    /**
+     * Only static groups with `joinPolicy` `open` or `request` the caller does not belong to.
+     */
+    joinable?: boolean;
+    /**
+     * An opaque continuation token from a previous response's `nextCursor`, bound to the caller and the filters; a responder MUST NOT accept a cursor it did not issue.
+     */
+    cursor?: string;
+    /**
+     * The most items to return, at most 200; the responder chooses a default (50) and MAY return fewer.
+     */
+    limit?: number;
+    ext?: Ext;
+}
+/**
+ * The success response to a vtc/groups/list/0.2 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/groups/list/0.2#response.
+ */
+export interface VTCGroupsListResponsePayload {
+    /**
+     * @maxItems 200
+     */
+    items: {
+        group: Group;
+        /**
+         * The caller's own standing in the group.
+         */
+        myMembership: "member" | "pending" | "requested" | "optedOut" | "none";
+    }[];
+    /**
+     * Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.
+     */
+    nextCursor?: string;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { DynamicRule, EntryId, Ext, FieldKey, Group, GroupAudience, GroupDescription, GroupId, GroupKind, GroupName, JoinPolicy, RuleCondition };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/groups/list/0.2";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCGroupsListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/groups/list/0.2#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCGroupsListResponsePayload;
+/**
+ * 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/groups/list/0.2";
+    readonly title: "VTC Groups — List — payload";
+    readonly description: "List the community groups the caller may see — all of them for an administrator, the visible ones for a member — optionally only those they belong to or could join. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly mine: {
+            readonly type: "boolean";
+            readonly description: "Only groups the caller belongs to.";
+        };
+        readonly joinable: {
+            readonly type: "boolean";
+            readonly description: "Only static groups with `joinPolicy` `open` or `request` the caller does not belong to.";
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1024;
+            readonly description: "An opaque continuation token from a previous response's `nextCursor`, bound to the caller and the filters; a responder MUST NOT accept a cursor it did not issue.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 200;
+            readonly description: "The most items to return, at most 200; the responder chooses a default (50) and MAY return fewer.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Groups — List — response payload";
+            readonly description: "The success response to a vtc/groups/list/0.2 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/groups/list/0.2#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 200;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["group", "myMembership"];
+                        readonly properties: {
+                            readonly group: {
+                                readonly $ref: "#/$defs/Group";
+                            };
+                            readonly myMembership: {
+                                readonly type: "string";
+                                readonly enum: readonly ["member", "pending", "requested", "optedOut", "none"];
+                                readonly description: "The caller's own standing in the group.";
+                            };
+                        };
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 1024;
+                    readonly description: "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.";
+                };
+                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 Group: {
+            readonly title: "Group";
+            readonly description: "A community group, as a caller who may see it sees it. Members a caller may not see are absent: `memberCount` only to those who may see the group's members, `managers` and `credentialAuthorityValidUntil` only to its managers.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["groupId", "groupDid", "name", "kind", "visibility", "showMembers", "issuesCredentials", "carriesAuthority", "createdAt"];
+            readonly properties: {
+                readonly groupId: {
+                    readonly $ref: "#/$defs/GroupId";
+                };
+                readonly groupDid: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The group's own DID, minted by the community's VTA for this group alone. It issues the group's membership credentials. Its DID document carries no name or description.";
+                };
+                readonly name: {
+                    readonly $ref: "#/$defs/GroupName";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/GroupDescription";
+                };
+                readonly kind: {
+                    readonly $ref: "#/$defs/GroupKind";
+                };
+                readonly rule: {
+                    readonly $ref: "#/$defs/DynamicRule";
+                    readonly description: "Present exactly when `kind` is `dynamic`.";
+                };
+                readonly joinPolicy: {
+                    readonly $ref: "#/$defs/JoinPolicy";
+                    readonly description: "Present exactly when `kind` is `static`.";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/GroupAudience";
+                    readonly description: "Who may see that the group exists, and its name and description.";
+                };
+                readonly showMembers: {
+                    readonly $ref: "#/$defs/GroupAudience";
+                    readonly description: "Who may see the group's member list. Separate from `visibility`: a group everyone sees may show its members only to administrators. Never wider than `visibility`.";
+                };
+                readonly issuesCredentials: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the group's DID issues its members a membership credential. Default true.";
+                };
+                readonly carriesAuthority: {
+                    readonly type: "boolean";
+                    readonly description: "`true` while the group has a `grants` or `role` binding. Such a group is `static` and `closed` for as long as it does.";
+                };
+                readonly memberCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Active members. Only to callers who may see the member list.";
+                };
+                readonly managers: {
+                    readonly type: "array";
+                    readonly maxItems: 256;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly $ref: "#/$defs/EntryId";
+                    };
+                    readonly description: "Entries holding `vtc.groups.manage` qualified to this group, read from the access-control list. Informational: managers are appointed by an access-control grant (vtc/groups/managers/add), never by this record.";
+                };
+                readonly credentialAuthorityValidUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community's authorization credential to the group expires. The community renews it well before.";
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly createdBy: {
+                    readonly $ref: "#/$defs/EntryId";
+                    readonly description: "The creating administrator's directory entry, where they have one.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry authority.";
+                };
+            };
+        };
+        readonly GroupAudience: {
+            readonly title: "GroupAudience";
+            readonly description: "Who may see something about a group, narrowest first. `admins`: holders of `vtc.groups.manage` for the group (unqualified, or qualified `group:<groupId>`). `groupMembers`: the group's own members, and its managers. `members`: every active member of the community.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groupMembers", "members"];
+        };
+        readonly JoinPolicy: {
+            readonly title: "JoinPolicy";
+            readonly description: "How a member enters a static group by themselves. `closed`: only a manager adds them. `request`: a member asks and a manager decides. `open`: a member joins at once, subject to the community's `groups` policy. A group carrying authority is always `closed`.";
+            readonly type: "string";
+            readonly enum: readonly ["closed", "request", "open"];
+        };
+        readonly DynamicRule: {
+            readonly title: "DynamicRule";
+            readonly description: "A dynamic group's membership rule: a member belongs when every condition holds and they have not opted out. The community evaluates it under its `groups` policy and recomputes membership whenever a fact it reads changes, always excluding opted-out entries.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["all"];
+            readonly properties: {
+                readonly all: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 16;
+                    readonly items: {
+                        readonly $ref: "#/$defs/RuleCondition";
+                    };
+                };
+            };
+        };
+        readonly RuleCondition: {
+            readonly title: "RuleCondition";
+            readonly description: "One test over a verified fact about a member. `fact: role` tests the member's community role; `fact: field` tests an `admin`- or `credential`-sourced directory field named by `field`; `fact: personhood` tests whether a personhood assertion is on file; `fact: joinedAt` tests when they joined. A rule never reads a self-asserted (`member`-sourced) field: a member must not be able to join a group by editing their card.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["fact", "op"];
+            readonly properties: {
+                readonly fact: {
+                    readonly type: "string";
+                    readonly enum: readonly ["role", "field", "personhood", "joinedAt"];
+                };
+                readonly field: {
+                    readonly $ref: "#/$defs/FieldKey";
+                    readonly description: "Present exactly when `fact` is `field`.";
+                };
+                readonly op: {
+                    readonly type: "string";
+                    readonly enum: readonly ["equals", "oneOf", "exists", "before", "after"];
+                    readonly description: "`equals` compares with `value`; `oneOf` with any of `values`; `exists` needs neither; `before` and `after` compare a date fact with `value`.";
+                };
+                readonly value: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                    }, {
+                        readonly type: "boolean";
+                    }];
+                };
+                readonly values: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                    };
+                };
+            };
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+        readonly GroupKind: {
+            readonly title: "GroupKind";
+            readonly description: "`static`: membership is explicit — added, joined, or granted on request. `dynamic`: membership is computed from `rule` over verified facts only; nobody is added by hand, but a member may opt out (vtc/groups/leave), an exclusion the rule cannot override, and undo it (vtc/groups/join). A dynamic group never confers authority. Fixed for the group's life.";
+            readonly type: "string";
+            readonly enum: readonly ["static", "dynamic"];
+        };
+        readonly GroupDescription: {
+            readonly title: "GroupDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly description: "What the group is for. Plain text; a reader MUST NOT treat it as instructions. Same placement rules as `GroupName`.";
+        };
+        readonly GroupName: {
+            readonly title: "GroupName";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The group's name, shown to those who may see the group. The community's own record: never in the group's DID document or its credentials' subject beyond the group's DID. Plain text.";
+        };
+        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 EntryId: {
+            readonly title: "EntryId";
+            readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+            readonly type: "string";
+            readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+        };
+    };
+};
+/** 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 Groups — List — response payload";
+            readonly description: "The success response to a vtc/groups/list/0.2 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/groups/list/0.2#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["items"];
+            readonly properties: {
+                readonly items: {
+                    readonly type: "array";
+                    readonly maxItems: 200;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["group", "myMembership"];
+                        readonly properties: {
+                            readonly group: {
+                                readonly $ref: "#/$defs/Group";
+                            };
+                            readonly myMembership: {
+                                readonly type: "string";
+                                readonly enum: readonly ["member", "pending", "requested", "optedOut", "none"];
+                                readonly description: "The caller's own standing in the group.";
+                            };
+                        };
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 1024;
+                    readonly description: "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.";
+                };
+                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 Group: {
+            readonly title: "Group";
+            readonly description: "A community group, as a caller who may see it sees it. Members a caller may not see are absent: `memberCount` only to those who may see the group's members, `managers` and `credentialAuthorityValidUntil` only to its managers.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["groupId", "groupDid", "name", "kind", "visibility", "showMembers", "issuesCredentials", "carriesAuthority", "createdAt"];
+            readonly properties: {
+                readonly groupId: {
+                    readonly $ref: "#/$defs/GroupId";
+                };
+                readonly groupDid: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "The group's own DID, minted by the community's VTA for this group alone. It issues the group's membership credentials. Its DID document carries no name or description.";
+                };
+                readonly name: {
+                    readonly $ref: "#/$defs/GroupName";
+                };
+                readonly description: {
+                    readonly $ref: "#/$defs/GroupDescription";
+                };
+                readonly kind: {
+                    readonly $ref: "#/$defs/GroupKind";
+                };
+                readonly rule: {
+                    readonly $ref: "#/$defs/DynamicRule";
+                    readonly description: "Present exactly when `kind` is `dynamic`.";
+                };
+                readonly joinPolicy: {
+                    readonly $ref: "#/$defs/JoinPolicy";
+                    readonly description: "Present exactly when `kind` is `static`.";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/GroupAudience";
+                    readonly description: "Who may see that the group exists, and its name and description.";
+                };
+                readonly showMembers: {
+                    readonly $ref: "#/$defs/GroupAudience";
+                    readonly description: "Who may see the group's member list. Separate from `visibility`: a group everyone sees may show its members only to administrators. Never wider than `visibility`.";
+                };
+                readonly issuesCredentials: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the group's DID issues its members a membership credential. Default true.";
+                };
+                readonly carriesAuthority: {
+                    readonly type: "boolean";
+                    readonly description: "`true` while the group has a `grants` or `role` binding. Such a group is `static` and `closed` for as long as it does.";
+                };
+                readonly memberCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Active members. Only to callers who may see the member list.";
+                };
+                readonly managers: {
+                    readonly type: "array";
+                    readonly maxItems: 256;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly $ref: "#/$defs/EntryId";
+                    };
+                    readonly description: "Entries holding `vtc.groups.manage` qualified to this group, read from the access-control list. Informational: managers are appointed by an access-control grant (vtc/groups/managers/add), never by this record.";
+                };
+                readonly credentialAuthorityValidUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community's authorization credential to the group expires. The community renews it well before.";
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly createdBy: {
+                    readonly $ref: "#/$defs/EntryId";
+                    readonly description: "The creating administrator's directory entry, where they have one.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry authority.";
+                };
+            };
+        };
+        readonly GroupAudience: {
+            readonly title: "GroupAudience";
+            readonly description: "Who may see something about a group, narrowest first. `admins`: holders of `vtc.groups.manage` for the group (unqualified, or qualified `group:<groupId>`). `groupMembers`: the group's own members, and its managers. `members`: every active member of the community.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groupMembers", "members"];
+        };
+        readonly JoinPolicy: {
+            readonly title: "JoinPolicy";
+            readonly description: "How a member enters a static group by themselves. `closed`: only a manager adds them. `request`: a member asks and a manager decides. `open`: a member joins at once, subject to the community's `groups` policy. A group carrying authority is always `closed`.";
+            readonly type: "string";
+            readonly enum: readonly ["closed", "request", "open"];
+        };
+        readonly DynamicRule: {
+            readonly title: "DynamicRule";
+            readonly description: "A dynamic group's membership rule: a member belongs when every condition holds and they have not opted out. The community evaluates it under its `groups` policy and recomputes membership whenever a fact it reads changes, always excluding opted-out entries.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["all"];
+            readonly properties: {
+                readonly all: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 16;
+                    readonly items: {
+                        readonly $ref: "#/$defs/RuleCondition";
+                    };
+                };
+            };
+        };
+        readonly RuleCondition: {
+            readonly title: "RuleCondition";
+            readonly description: "One test over a verified fact about a member. `fact: role` tests the member's community role; `fact: field` tests an `admin`- or `credential`-sourced directory field named by `field`; `fact: personhood` tests whether a personhood assertion is on file; `fact: joinedAt` tests when they joined. A rule never reads a self-asserted (`member`-sourced) field: a member must not be able to join a group by editing their card.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["fact", "op"];
+            readonly properties: {
+                readonly fact: {
+                    readonly type: "string";
+                    readonly enum: readonly ["role", "field", "personhood", "joinedAt"];
+                };
+                readonly field: {
+                    readonly $ref: "#/$defs/FieldKey";
+                    readonly description: "Present exactly when `fact` is `field`.";
+                };
+                readonly op: {
+                    readonly type: "string";
+                    readonly enum: readonly ["equals", "oneOf", "exists", "before", "after"];
+                    readonly description: "`equals` compares with `value`; `oneOf` with any of `values`; `exists` needs neither; `before` and `after` compare a date fact with `value`.";
+                };
+                readonly value: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                    }, {
+                        readonly type: "boolean";
+                    }];
+                };
+                readonly values: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly maxLength: 256;
+                    };
+                };
+            };
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+        readonly GroupKind: {
+            readonly title: "GroupKind";
+            readonly description: "`static`: membership is explicit — added, joined, or granted on request. `dynamic`: membership is computed from `rule` over verified facts only; nobody is added by hand, but a member may opt out (vtc/groups/leave), an exclusion the rule cannot override, and undo it (vtc/groups/join). A dynamic group never confers authority. Fixed for the group's life.";
+            readonly type: "string";
+            readonly enum: readonly ["static", "dynamic"];
+        };
+        readonly GroupDescription: {
+            readonly title: "GroupDescription";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 1000;
+            readonly description: "What the group is for. Plain text; a reader MUST NOT treat it as instructions. Same placement rules as `GroupName`.";
+        };
+        readonly GroupName: {
+            readonly title: "GroupName";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The group's name, shown to those who may see the group. The community's own record: never in the group's DID document or its credentials' subject beyond the group's DID. Plain text.";
+        };
+        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 EntryId: {
+            readonly title: "EntryId";
+            readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+            readonly type: "string";
+            readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+        };
+    };
+};
+/**
+ * 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/groups/list/0.2";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    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/groups/list/0.2";
+        readonly title: "VTC Groups — List — payload";
+        readonly description: "List the community groups the caller may see — all of them for an administrator, the visible ones for a member — optionally only those they belong to or could join. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly mine: {
+                readonly type: "boolean";
+                readonly description: "Only groups the caller belongs to.";
+            };
+            readonly joinable: {
+                readonly type: "boolean";
+                readonly description: "Only static groups with `joinPolicy` `open` or `request` the caller does not belong to.";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1024;
+                readonly description: "An opaque continuation token from a previous response's `nextCursor`, bound to the caller and the filters; a responder MUST NOT accept a cursor it did not issue.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 200;
+                readonly description: "The most items to return, at most 200; the responder chooses a default (50) and MAY return fewer.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Groups — List — response payload";
+                readonly description: "The success response to a vtc/groups/list/0.2 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/groups/list/0.2#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 200;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["group", "myMembership"];
+                            readonly properties: {
+                                readonly group: {
+                                    readonly $ref: "#/$defs/Group";
+                                };
+                                readonly myMembership: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["member", "pending", "requested", "optedOut", "none"];
+                                    readonly description: "The caller's own standing in the group.";
+                                };
+                            };
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 1024;
+                        readonly description: "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.";
+                    };
+                    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 Group: {
+                readonly title: "Group";
+                readonly description: "A community group, as a caller who may see it sees it. Members a caller may not see are absent: `memberCount` only to those who may see the group's members, `managers` and `credentialAuthorityValidUntil` only to its managers.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["groupId", "groupDid", "name", "kind", "visibility", "showMembers", "issuesCredentials", "carriesAuthority", "createdAt"];
+                readonly properties: {
+                    readonly groupId: {
+                        readonly $ref: "#/$defs/GroupId";
+                    };
+                    readonly groupDid: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The group's own DID, minted by the community's VTA for this group alone. It issues the group's membership credentials. Its DID document carries no name or description.";
+                    };
+                    readonly name: {
+                        readonly $ref: "#/$defs/GroupName";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/GroupDescription";
+                    };
+                    readonly kind: {
+                        readonly $ref: "#/$defs/GroupKind";
+                    };
+                    readonly rule: {
+                        readonly $ref: "#/$defs/DynamicRule";
+                        readonly description: "Present exactly when `kind` is `dynamic`.";
+                    };
+                    readonly joinPolicy: {
+                        readonly $ref: "#/$defs/JoinPolicy";
+                        readonly description: "Present exactly when `kind` is `static`.";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/GroupAudience";
+                        readonly description: "Who may see that the group exists, and its name and description.";
+                    };
+                    readonly showMembers: {
+                        readonly $ref: "#/$defs/GroupAudience";
+                        readonly description: "Who may see the group's member list. Separate from `visibility`: a group everyone sees may show its members only to administrators. Never wider than `visibility`.";
+                    };
+                    readonly issuesCredentials: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the group's DID issues its members a membership credential. Default true.";
+                    };
+                    readonly carriesAuthority: {
+                        readonly type: "boolean";
+                        readonly description: "`true` while the group has a `grants` or `role` binding. Such a group is `static` and `closed` for as long as it does.";
+                    };
+                    readonly memberCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Active members. Only to callers who may see the member list.";
+                    };
+                    readonly managers: {
+                        readonly type: "array";
+                        readonly maxItems: 256;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly $ref: "#/$defs/EntryId";
+                        };
+                        readonly description: "Entries holding `vtc.groups.manage` qualified to this group, read from the access-control list. Informational: managers are appointed by an access-control grant (vtc/groups/managers/add), never by this record.";
+                    };
+                    readonly credentialAuthorityValidUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community's authorization credential to the group expires. The community renews it well before.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly createdBy: {
+                        readonly $ref: "#/$defs/EntryId";
+                        readonly description: "The creating administrator's directory entry, where they have one.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry authority.";
+                    };
+                };
+            };
+            readonly GroupAudience: {
+                readonly title: "GroupAudience";
+                readonly description: "Who may see something about a group, narrowest first. `admins`: holders of `vtc.groups.manage` for the group (unqualified, or qualified `group:<groupId>`). `groupMembers`: the group's own members, and its managers. `members`: every active member of the community.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groupMembers", "members"];
+            };
+            readonly JoinPolicy: {
+                readonly title: "JoinPolicy";
+                readonly description: "How a member enters a static group by themselves. `closed`: only a manager adds them. `request`: a member asks and a manager decides. `open`: a member joins at once, subject to the community's `groups` policy. A group carrying authority is always `closed`.";
+                readonly type: "string";
+                readonly enum: readonly ["closed", "request", "open"];
+            };
+            readonly DynamicRule: {
+                readonly title: "DynamicRule";
+                readonly description: "A dynamic group's membership rule: a member belongs when every condition holds and they have not opted out. The community evaluates it under its `groups` policy and recomputes membership whenever a fact it reads changes, always excluding opted-out entries.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["all"];
+                readonly properties: {
+                    readonly all: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 16;
+                        readonly items: {
+                            readonly $ref: "#/$defs/RuleCondition";
+                        };
+                    };
+                };
+            };
+            readonly RuleCondition: {
+                readonly title: "RuleCondition";
+                readonly description: "One test over a verified fact about a member. `fact: role` tests the member's community role; `fact: field` tests an `admin`- or `credential`-sourced directory field named by `field`; `fact: personhood` tests whether a personhood assertion is on file; `fact: joinedAt` tests when they joined. A rule never reads a self-asserted (`member`-sourced) field: a member must not be able to join a group by editing their card.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["fact", "op"];
+                readonly properties: {
+                    readonly fact: {
+                        readonly type: "string";
+                        readonly enum: readonly ["role", "field", "personhood", "joinedAt"];
+                    };
+                    readonly field: {
+                        readonly $ref: "#/$defs/FieldKey";
+                        readonly description: "Present exactly when `fact` is `field`.";
+                    };
+                    readonly op: {
+                        readonly type: "string";
+                        readonly enum: readonly ["equals", "oneOf", "exists", "before", "after"];
+                        readonly description: "`equals` compares with `value`; `oneOf` with any of `values`; `exists` needs neither; `before` and `after` compare a date fact with `value`.";
+                    };
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly maxLength: 256;
+                        }, {
+                            readonly type: "boolean";
+                        }];
+                    };
+                    readonly values: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly maxLength: 256;
+                        };
+                    };
+                };
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+            readonly GroupKind: {
+                readonly title: "GroupKind";
+                readonly description: "`static`: membership is explicit — added, joined, or granted on request. `dynamic`: membership is computed from `rule` over verified facts only; nobody is added by hand, but a member may opt out (vtc/groups/leave), an exclusion the rule cannot override, and undo it (vtc/groups/join). A dynamic group never confers authority. Fixed for the group's life.";
+                readonly type: "string";
+                readonly enum: readonly ["static", "dynamic"];
+            };
+            readonly GroupDescription: {
+                readonly title: "GroupDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly description: "What the group is for. Plain text; a reader MUST NOT treat it as instructions. Same placement rules as `GroupName`.";
+            };
+            readonly GroupName: {
+                readonly title: "GroupName";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The group's name, shown to those who may see the group. The community's own record: never in the group's DID document or its credentials' subject beyond the group's DID. Plain text.";
+            };
+            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 EntryId: {
+                readonly title: "EntryId";
+                readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+                readonly type: "string";
+                readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+            };
+        };
+    };
+};
+/**
+ * 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/groups/list/0.2#response";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    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 Groups — List — response payload";
+                readonly description: "The success response to a vtc/groups/list/0.2 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/groups/list/0.2#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["items"];
+                readonly properties: {
+                    readonly items: {
+                        readonly type: "array";
+                        readonly maxItems: 200;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["group", "myMembership"];
+                            readonly properties: {
+                                readonly group: {
+                                    readonly $ref: "#/$defs/Group";
+                                };
+                                readonly myMembership: {
+                                    readonly type: "string";
+                                    readonly enum: readonly ["member", "pending", "requested", "optedOut", "none"];
+                                    readonly description: "The caller's own standing in the group.";
+                                };
+                            };
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 1024;
+                        readonly description: "Continuation token for the next page; pass it back as `cursor`. Absent on the last page — never `null`.";
+                    };
+                    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 Group: {
+                readonly title: "Group";
+                readonly description: "A community group, as a caller who may see it sees it. Members a caller may not see are absent: `memberCount` only to those who may see the group's members, `managers` and `credentialAuthorityValidUntil` only to its managers.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["groupId", "groupDid", "name", "kind", "visibility", "showMembers", "issuesCredentials", "carriesAuthority", "createdAt"];
+                readonly properties: {
+                    readonly groupId: {
+                        readonly $ref: "#/$defs/GroupId";
+                    };
+                    readonly groupDid: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "The group's own DID, minted by the community's VTA for this group alone. It issues the group's membership credentials. Its DID document carries no name or description.";
+                    };
+                    readonly name: {
+                        readonly $ref: "#/$defs/GroupName";
+                    };
+                    readonly description: {
+                        readonly $ref: "#/$defs/GroupDescription";
+                    };
+                    readonly kind: {
+                        readonly $ref: "#/$defs/GroupKind";
+                    };
+                    readonly rule: {
+                        readonly $ref: "#/$defs/DynamicRule";
+                        readonly description: "Present exactly when `kind` is `dynamic`.";
+                    };
+                    readonly joinPolicy: {
+                        readonly $ref: "#/$defs/JoinPolicy";
+                        readonly description: "Present exactly when `kind` is `static`.";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/GroupAudience";
+                        readonly description: "Who may see that the group exists, and its name and description.";
+                    };
+                    readonly showMembers: {
+                        readonly $ref: "#/$defs/GroupAudience";
+                        readonly description: "Who may see the group's member list. Separate from `visibility`: a group everyone sees may show its members only to administrators. Never wider than `visibility`.";
+                    };
+                    readonly issuesCredentials: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the group's DID issues its members a membership credential. Default true.";
+                    };
+                    readonly carriesAuthority: {
+                        readonly type: "boolean";
+                        readonly description: "`true` while the group has a `grants` or `role` binding. Such a group is `static` and `closed` for as long as it does.";
+                    };
+                    readonly memberCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Active members. Only to callers who may see the member list.";
+                    };
+                    readonly managers: {
+                        readonly type: "array";
+                        readonly maxItems: 256;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly $ref: "#/$defs/EntryId";
+                        };
+                        readonly description: "Entries holding `vtc.groups.manage` qualified to this group, read from the access-control list. Informational: managers are appointed by an access-control grant (vtc/groups/managers/add), never by this record.";
+                    };
+                    readonly credentialAuthorityValidUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community's authorization credential to the group expires. The community renews it well before.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly createdBy: {
+                        readonly $ref: "#/$defs/EntryId";
+                        readonly description: "The creating administrator's directory entry, where they have one.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry authority.";
+                    };
+                };
+            };
+            readonly GroupAudience: {
+                readonly title: "GroupAudience";
+                readonly description: "Who may see something about a group, narrowest first. `admins`: holders of `vtc.groups.manage` for the group (unqualified, or qualified `group:<groupId>`). `groupMembers`: the group's own members, and its managers. `members`: every active member of the community.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groupMembers", "members"];
+            };
+            readonly JoinPolicy: {
+                readonly title: "JoinPolicy";
+                readonly description: "How a member enters a static group by themselves. `closed`: only a manager adds them. `request`: a member asks and a manager decides. `open`: a member joins at once, subject to the community's `groups` policy. A group carrying authority is always `closed`.";
+                readonly type: "string";
+                readonly enum: readonly ["closed", "request", "open"];
+            };
+            readonly DynamicRule: {
+                readonly title: "DynamicRule";
+                readonly description: "A dynamic group's membership rule: a member belongs when every condition holds and they have not opted out. The community evaluates it under its `groups` policy and recomputes membership whenever a fact it reads changes, always excluding opted-out entries.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["all"];
+                readonly properties: {
+                    readonly all: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 16;
+                        readonly items: {
+                            readonly $ref: "#/$defs/RuleCondition";
+                        };
+                    };
+                };
+            };
+            readonly RuleCondition: {
+                readonly title: "RuleCondition";
+                readonly description: "One test over a verified fact about a member. `fact: role` tests the member's community role; `fact: field` tests an `admin`- or `credential`-sourced directory field named by `field`; `fact: personhood` tests whether a personhood assertion is on file; `fact: joinedAt` tests when they joined. A rule never reads a self-asserted (`member`-sourced) field: a member must not be able to join a group by editing their card.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["fact", "op"];
+                readonly properties: {
+                    readonly fact: {
+                        readonly type: "string";
+                        readonly enum: readonly ["role", "field", "personhood", "joinedAt"];
+                    };
+                    readonly field: {
+                        readonly $ref: "#/$defs/FieldKey";
+                        readonly description: "Present exactly when `fact` is `field`.";
+                    };
+                    readonly op: {
+                        readonly type: "string";
+                        readonly enum: readonly ["equals", "oneOf", "exists", "before", "after"];
+                        readonly description: "`equals` compares with `value`; `oneOf` with any of `values`; `exists` needs neither; `before` and `after` compare a date fact with `value`.";
+                    };
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly maxLength: 256;
+                        }, {
+                            readonly type: "boolean";
+                        }];
+                    };
+                    readonly values: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly maxLength: 256;
+                        };
+                    };
+                };
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+            readonly GroupKind: {
+                readonly title: "GroupKind";
+                readonly description: "`static`: membership is explicit — added, joined, or granted on request. `dynamic`: membership is computed from `rule` over verified facts only; nobody is added by hand, but a member may opt out (vtc/groups/leave), an exclusion the rule cannot override, and undo it (vtc/groups/join). A dynamic group never confers authority. Fixed for the group's life.";
+                readonly type: "string";
+                readonly enum: readonly ["static", "dynamic"];
+            };
+            readonly GroupDescription: {
+                readonly title: "GroupDescription";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 1000;
+                readonly description: "What the group is for. Plain text; a reader MUST NOT treat it as instructions. Same placement rules as `GroupName`.";
+            };
+            readonly GroupName: {
+                readonly title: "GroupName";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The group's name, shown to those who may see the group. The community's own record: never in the group's DID document or its credentials' subject beyond the group's DID. Plain text.";
+            };
+            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 EntryId: {
+                readonly title: "EntryId";
+                readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+                readonly type: "string";
+                readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map