@openvtc/trust-tasks 0.26.17 → 0.26.18

package/dist/persona/contact/list/1.1/payload.d.ts

@@ -0,0 +1,803 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/persona/contact/list/1.1/payload.schema.json
+ */
+import type { DirectoryEntryId, DirectoryRef, Ext, ListId, ListIds, Petname, Ulid } from "../../../../_shared/components.js";
+/**
+ * Enumerate contacts in a context, optionally narrowed to those known by one persona, those the holder starred, those on one of the holder's lists, or those linked to one community's directory. Summaries only, with the holder's annotations; documents are fetched one at a time. Filters combine as AND.
+ */
+export interface PersonaContactListPayload {
+    contextId: string;
+    /**
+     * Narrow to contacts known by this persona. Omitting it lists the context's contacts across every persona in it, which a producer SHOULD offer deliberately rather than by default — the unfiltered view is the one that shows the holder's personas side by side.
+     */
+    knownByPersona?: string;
+    /**
+     * Return only contacts whose current revision was received after this instant. Annotation changes do not count: they are the holder's own and need no "what changed while I was away".
+     */
+    changedSince?: string;
+    /**
+     * `true`: only starred contacts. `false`: only unstarred ones. Absent: both.
+     */
+    starred?: boolean;
+    /**
+     * Only contacts on this list. A list this context does not hold is `listUnknown`, not an empty page, because a list identifier is the holder's own and its absence is a definite answer worth giving.
+     */
+    listId?: ListId;
+    /**
+     * Only contacts whose `directoryRef` names this community. What the holder's own client asks for when it joins that community's directory with the holder's contacts, locally.
+     */
+    directoryVtcDid?: string;
+    cursor?: string;
+    limit?: number;
+    ext?: Ext;
+}
+/**
+ * Success response to persona/contact/list. Type https://trusttasks.org/spec/persona/contact/list/1.1#response. Summaries carry no claim values: a list is for finding a contact, and finding one does not require disclosing every contact's details. They do carry the holder's own annotations, which a client needs to sort, badge and filter, and which go to no one but the holder's own client.
+ */
+export interface PersonaContactListResponsePayload {
+    /**
+     * @maxItems 500
+     */
+    contacts: {
+        contactId: Ulid;
+        subjectDid: string;
+        knownByPersona: string;
+        rev: number;
+        /**
+         * A rendering hint drawn from the contact's own disclosed display-name claim, so a list is legible. Absent when they disclosed none; a producer MUST NOT substitute the DID — or the petname — silently as though it were the contact's own name.
+         */
+        displayName?: string;
+        claimCount?: number;
+        receivedAt: string;
+        /**
+         * True when the current revision superseded another and the holder has not yet acknowledged the difference.
+         */
+        hasUnreviewedChange?: boolean;
+        /**
+         * Whether the holder starred the contact. Always present.
+         */
+        starred: boolean;
+        petname?: Petname;
+        lists?: ListIds;
+        directoryRef?: DirectoryRef;
+    }[];
+    nextCursor?: string;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { DirectoryEntryId, DirectoryRef, Ext, ListId, ListIds, Petname, Ulid };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/persona/contact/list/1.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PersonaContactListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/persona/contact/list/1.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PersonaContactListResponsePayload;
+/**
+ * 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/persona/contact/list/1.1";
+    readonly title: "Persona Contact List — payload";
+    readonly description: "Enumerate contacts in a context, optionally narrowed to those known by one persona, those the holder starred, those on one of the holder's lists, or those linked to one community's directory. Summaries only, with the holder's annotations; documents are fetched one at a time. Filters combine as AND.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["contextId"];
+    readonly properties: {
+        readonly contextId: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly knownByPersona: {
+            readonly type: "string";
+            readonly maxLength: 2048;
+            readonly description: "Narrow to contacts known by this persona. Omitting it lists the context's contacts across every persona in it, which a producer SHOULD offer deliberately rather than by default — the unfiltered view is the one that shows the holder's personas side by side.";
+        };
+        readonly changedSince: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly description: "Return only contacts whose current revision was received after this instant. Annotation changes do not count: they are the holder's own and need no \"what changed while I was away\".";
+        };
+        readonly starred: {
+            readonly type: "boolean";
+            readonly description: "`true`: only starred contacts. `false`: only unstarred ones. Absent: both.";
+        };
+        readonly listId: {
+            readonly $ref: "#/$defs/ListId";
+            readonly description: "Only contacts on this list. A list this context does not hold is `listUnknown`, not an empty page, because a list identifier is the holder's own and its absence is a definite answer worth giving.";
+        };
+        readonly directoryVtcDid: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 2048;
+            readonly pattern: "^did:[a-z0-9]+:";
+            readonly description: "Only contacts whose `directoryRef` names this community. What the holder's own client asks for when it joins that community's directory with the holder's contacts, locally.";
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly maxLength: 4096;
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 500;
+            readonly default: 100;
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Persona Contact List — response payload";
+            readonly description: "Success response to persona/contact/list. Type https://trusttasks.org/spec/persona/contact/list/1.1#response. Summaries carry no claim values: a list is for finding a contact, and finding one does not require disclosing every contact's details. They do carry the holder's own annotations, which a client needs to sort, badge and filter, and which go to no one but the holder's own client.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["contacts"];
+            readonly properties: {
+                readonly contacts: {
+                    readonly type: "array";
+                    readonly maxItems: 500;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["contactId", "subjectDid", "knownByPersona", "rev", "receivedAt", "starred"];
+                        readonly properties: {
+                            readonly contactId: {
+                                readonly $ref: "#/$defs/Ulid";
+                            };
+                            readonly subjectDid: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly knownByPersona: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly rev: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                            };
+                            readonly displayName: {
+                                readonly type: "string";
+                                readonly maxLength: 256;
+                                readonly description: "A rendering hint drawn from the contact's own disclosed display-name claim, so a list is legible. Absent when they disclosed none; a producer MUST NOT substitute the DID — or the petname — silently as though it were the contact's own name.";
+                            };
+                            readonly claimCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly receivedAt: {
+                                readonly type: "string";
+                                readonly format: "date-time";
+                            };
+                            readonly hasUnreviewedChange: {
+                                readonly type: "boolean";
+                                readonly description: "True when the current revision superseded another and the holder has not yet acknowledged the difference.";
+                            };
+                            readonly starred: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the holder starred the contact. Always present.";
+                            };
+                            readonly petname: {
+                                readonly $ref: "#/$defs/Petname";
+                            };
+                            readonly lists: {
+                                readonly $ref: "#/$defs/ListIds";
+                            };
+                            readonly directoryRef: {
+                                readonly $ref: "#/$defs/DirectoryRef";
+                            };
+                        };
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 4096;
+                };
+                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 DirectoryRef: {
+            readonly title: "DirectoryRef";
+            readonly description: "Links a contact to the entry in a community's member directory it corresponds to, so the holder's own client can join that community's directory with the holder's address book — showing a star or a petname beside an entry — without either side telling the other. The community never learns the link exists; the contact never learns it either. A contact has at most one.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["vtcDid", "entryId"];
+            readonly properties: {
+                readonly vtcDid: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 2048;
+                    readonly pattern: "^did:[a-z0-9]+:";
+                    readonly description: "The DID of the community whose directory holds the entry.";
+                };
+                readonly entryId: {
+                    readonly $ref: "#/$defs/DirectoryEntryId";
+                    readonly description: "The entry, as that community's directory identifies it.";
+                };
+            };
+        };
+        readonly DirectoryEntryId: {
+            readonly title: "DirectoryEntryId";
+            readonly description: "A community directory entry's identifier, exactly as that community's directory returned it. Opaque and community-scoped: the agent stores and compares it as a string, never parses it, and never treats the same value under two communities as the same entry.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^[A-Za-z0-9_-]+$";
+        };
+        readonly ListIds: {
+            readonly title: "ListIds";
+            readonly description: "The lists a contact is on, as a set: order carries no meaning. A contact on no list has no `lists` member, never an empty array, so there is one way to say \"none\".";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 64;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/ListId";
+            };
+        };
+        readonly ListId: {
+            readonly title: "ListId";
+            readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+        readonly Petname: {
+            readonly title: "Petname";
+            readonly description: "The holder's private name for a contact, on one line: no control characters, line breaks included. A petname in Zooko's sense — chosen by the holder, meaningful to the holder, and unforgeable by anyone else, because nobody else can write it. Distinct from the contact's own disclosed `nickname` or display name, which the contact chose and may change. Compared exactly, as a string: an agent does not case-fold or normalise it.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+        };
+        readonly Ulid: {
+            readonly title: "Ulid";
+            readonly description: "A ULID in Crockford base32, uppercase. Used for `attributeId` and `profileId`. Chosen over a UUID because the leading 48 bits are a timestamp, so a key-ordered scan of the store is also creation-ordered and a `list` needs no secondary sort. Server-assigned on create; a producer MAY supply one to make a create idempotent, and a maintainer MUST reject a supplied value that already exists rather than silently overwriting.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+    };
+};
+/** 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: "Persona Contact List — response payload";
+            readonly description: "Success response to persona/contact/list. Type https://trusttasks.org/spec/persona/contact/list/1.1#response. Summaries carry no claim values: a list is for finding a contact, and finding one does not require disclosing every contact's details. They do carry the holder's own annotations, which a client needs to sort, badge and filter, and which go to no one but the holder's own client.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["contacts"];
+            readonly properties: {
+                readonly contacts: {
+                    readonly type: "array";
+                    readonly maxItems: 500;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["contactId", "subjectDid", "knownByPersona", "rev", "receivedAt", "starred"];
+                        readonly properties: {
+                            readonly contactId: {
+                                readonly $ref: "#/$defs/Ulid";
+                            };
+                            readonly subjectDid: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly knownByPersona: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly rev: {
+                                readonly type: "integer";
+                                readonly minimum: 1;
+                            };
+                            readonly displayName: {
+                                readonly type: "string";
+                                readonly maxLength: 256;
+                                readonly description: "A rendering hint drawn from the contact's own disclosed display-name claim, so a list is legible. Absent when they disclosed none; a producer MUST NOT substitute the DID — or the petname — silently as though it were the contact's own name.";
+                            };
+                            readonly claimCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly receivedAt: {
+                                readonly type: "string";
+                                readonly format: "date-time";
+                            };
+                            readonly hasUnreviewedChange: {
+                                readonly type: "boolean";
+                                readonly description: "True when the current revision superseded another and the holder has not yet acknowledged the difference.";
+                            };
+                            readonly starred: {
+                                readonly type: "boolean";
+                                readonly description: "Whether the holder starred the contact. Always present.";
+                            };
+                            readonly petname: {
+                                readonly $ref: "#/$defs/Petname";
+                            };
+                            readonly lists: {
+                                readonly $ref: "#/$defs/ListIds";
+                            };
+                            readonly directoryRef: {
+                                readonly $ref: "#/$defs/DirectoryRef";
+                            };
+                        };
+                    };
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 4096;
+                };
+                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 DirectoryRef: {
+            readonly title: "DirectoryRef";
+            readonly description: "Links a contact to the entry in a community's member directory it corresponds to, so the holder's own client can join that community's directory with the holder's address book — showing a star or a petname beside an entry — without either side telling the other. The community never learns the link exists; the contact never learns it either. A contact has at most one.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["vtcDid", "entryId"];
+            readonly properties: {
+                readonly vtcDid: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 2048;
+                    readonly pattern: "^did:[a-z0-9]+:";
+                    readonly description: "The DID of the community whose directory holds the entry.";
+                };
+                readonly entryId: {
+                    readonly $ref: "#/$defs/DirectoryEntryId";
+                    readonly description: "The entry, as that community's directory identifies it.";
+                };
+            };
+        };
+        readonly DirectoryEntryId: {
+            readonly title: "DirectoryEntryId";
+            readonly description: "A community directory entry's identifier, exactly as that community's directory returned it. Opaque and community-scoped: the agent stores and compares it as a string, never parses it, and never treats the same value under two communities as the same entry.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^[A-Za-z0-9_-]+$";
+        };
+        readonly ListIds: {
+            readonly title: "ListIds";
+            readonly description: "The lists a contact is on, as a set: order carries no meaning. A contact on no list has no `lists` member, never an empty array, so there is one way to say \"none\".";
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 64;
+            readonly uniqueItems: true;
+            readonly items: {
+                readonly $ref: "#/$defs/ListId";
+            };
+        };
+        readonly ListId: {
+            readonly title: "ListId";
+            readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+        readonly Petname: {
+            readonly title: "Petname";
+            readonly description: "The holder's private name for a contact, on one line: no control characters, line breaks included. A petname in Zooko's sense — chosen by the holder, meaningful to the holder, and unforgeable by anyone else, because nobody else can write it. Distinct from the contact's own disclosed `nickname` or display name, which the contact chose and may change. Compared exactly, as a string: an agent does not case-fold or normalise it.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+        };
+        readonly Ulid: {
+            readonly title: "Ulid";
+            readonly description: "A ULID in Crockford base32, uppercase. Used for `attributeId` and `profileId`. Chosen over a UUID because the leading 48 bits are a timestamp, so a key-ordered scan of the store is also creation-ordered and a `list` needs no secondary sort. Server-assigned on create; a producer MAY supply one to make a create idempotent, and a maintainer MUST reject a supplied value that already exists rather than silently overwriting.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+    };
+};
+/**
+ * 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/persona/contact/list/1.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/persona/contact/list/1.1";
+        readonly title: "Persona Contact List — payload";
+        readonly description: "Enumerate contacts in a context, optionally narrowed to those known by one persona, those the holder starred, those on one of the holder's lists, or those linked to one community's directory. Summaries only, with the holder's annotations; documents are fetched one at a time. Filters combine as AND.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["contextId"];
+        readonly properties: {
+            readonly contextId: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly knownByPersona: {
+                readonly type: "string";
+                readonly maxLength: 2048;
+                readonly description: "Narrow to contacts known by this persona. Omitting it lists the context's contacts across every persona in it, which a producer SHOULD offer deliberately rather than by default — the unfiltered view is the one that shows the holder's personas side by side.";
+            };
+            readonly changedSince: {
+                readonly type: "string";
+                readonly format: "date-time";
+                readonly description: "Return only contacts whose current revision was received after this instant. Annotation changes do not count: they are the holder's own and need no \"what changed while I was away\".";
+            };
+            readonly starred: {
+                readonly type: "boolean";
+                readonly description: "`true`: only starred contacts. `false`: only unstarred ones. Absent: both.";
+            };
+            readonly listId: {
+                readonly $ref: "#/$defs/ListId";
+                readonly description: "Only contacts on this list. A list this context does not hold is `listUnknown`, not an empty page, because a list identifier is the holder's own and its absence is a definite answer worth giving.";
+            };
+            readonly directoryVtcDid: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 2048;
+                readonly pattern: "^did:[a-z0-9]+:";
+                readonly description: "Only contacts whose `directoryRef` names this community. What the holder's own client asks for when it joins that community's directory with the holder's contacts, locally.";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly maxLength: 4096;
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+                readonly default: 100;
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Persona Contact List — response payload";
+                readonly description: "Success response to persona/contact/list. Type https://trusttasks.org/spec/persona/contact/list/1.1#response. Summaries carry no claim values: a list is for finding a contact, and finding one does not require disclosing every contact's details. They do carry the holder's own annotations, which a client needs to sort, badge and filter, and which go to no one but the holder's own client.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["contacts"];
+                readonly properties: {
+                    readonly contacts: {
+                        readonly type: "array";
+                        readonly maxItems: 500;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["contactId", "subjectDid", "knownByPersona", "rev", "receivedAt", "starred"];
+                            readonly properties: {
+                                readonly contactId: {
+                                    readonly $ref: "#/$defs/Ulid";
+                                };
+                                readonly subjectDid: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly knownByPersona: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly rev: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                };
+                                readonly displayName: {
+                                    readonly type: "string";
+                                    readonly maxLength: 256;
+                                    readonly description: "A rendering hint drawn from the contact's own disclosed display-name claim, so a list is legible. Absent when they disclosed none; a producer MUST NOT substitute the DID — or the petname — silently as though it were the contact's own name.";
+                                };
+                                readonly claimCount: {
+                                    readonly type: "integer";
+                                    readonly minimum: 0;
+                                };
+                                readonly receivedAt: {
+                                    readonly type: "string";
+                                    readonly format: "date-time";
+                                };
+                                readonly hasUnreviewedChange: {
+                                    readonly type: "boolean";
+                                    readonly description: "True when the current revision superseded another and the holder has not yet acknowledged the difference.";
+                                };
+                                readonly starred: {
+                                    readonly type: "boolean";
+                                    readonly description: "Whether the holder starred the contact. Always present.";
+                                };
+                                readonly petname: {
+                                    readonly $ref: "#/$defs/Petname";
+                                };
+                                readonly lists: {
+                                    readonly $ref: "#/$defs/ListIds";
+                                };
+                                readonly directoryRef: {
+                                    readonly $ref: "#/$defs/DirectoryRef";
+                                };
+                            };
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 4096;
+                    };
+                    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 DirectoryRef: {
+                readonly title: "DirectoryRef";
+                readonly description: "Links a contact to the entry in a community's member directory it corresponds to, so the holder's own client can join that community's directory with the holder's address book — showing a star or a petname beside an entry — without either side telling the other. The community never learns the link exists; the contact never learns it either. A contact has at most one.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["vtcDid", "entryId"];
+                readonly properties: {
+                    readonly vtcDid: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 2048;
+                        readonly pattern: "^did:[a-z0-9]+:";
+                        readonly description: "The DID of the community whose directory holds the entry.";
+                    };
+                    readonly entryId: {
+                        readonly $ref: "#/$defs/DirectoryEntryId";
+                        readonly description: "The entry, as that community's directory identifies it.";
+                    };
+                };
+            };
+            readonly DirectoryEntryId: {
+                readonly title: "DirectoryEntryId";
+                readonly description: "A community directory entry's identifier, exactly as that community's directory returned it. Opaque and community-scoped: the agent stores and compares it as a string, never parses it, and never treats the same value under two communities as the same entry.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^[A-Za-z0-9_-]+$";
+            };
+            readonly ListIds: {
+                readonly title: "ListIds";
+                readonly description: "The lists a contact is on, as a set: order carries no meaning. A contact on no list has no `lists` member, never an empty array, so there is one way to say \"none\".";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 64;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/ListId";
+                };
+            };
+            readonly ListId: {
+                readonly title: "ListId";
+                readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+            readonly Petname: {
+                readonly title: "Petname";
+                readonly description: "The holder's private name for a contact, on one line: no control characters, line breaks included. A petname in Zooko's sense — chosen by the holder, meaningful to the holder, and unforgeable by anyone else, because nobody else can write it. Distinct from the contact's own disclosed `nickname` or display name, which the contact chose and may change. Compared exactly, as a string: an agent does not case-fold or normalise it.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            };
+            readonly Ulid: {
+                readonly title: "Ulid";
+                readonly description: "A ULID in Crockford base32, uppercase. Used for `attributeId` and `profileId`. Chosen over a UUID because the leading 48 bits are a timestamp, so a key-ordered scan of the store is also creation-ordered and a `list` needs no secondary sort. Server-assigned on create; a producer MAY supply one to make a create idempotent, and a maintainer MUST reject a supplied value that already exists rather than silently overwriting.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+        };
+    };
+};
+/**
+ * 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/persona/contact/list/1.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: "Persona Contact List — response payload";
+                readonly description: "Success response to persona/contact/list. Type https://trusttasks.org/spec/persona/contact/list/1.1#response. Summaries carry no claim values: a list is for finding a contact, and finding one does not require disclosing every contact's details. They do carry the holder's own annotations, which a client needs to sort, badge and filter, and which go to no one but the holder's own client.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["contacts"];
+                readonly properties: {
+                    readonly contacts: {
+                        readonly type: "array";
+                        readonly maxItems: 500;
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["contactId", "subjectDid", "knownByPersona", "rev", "receivedAt", "starred"];
+                            readonly properties: {
+                                readonly contactId: {
+                                    readonly $ref: "#/$defs/Ulid";
+                                };
+                                readonly subjectDid: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly knownByPersona: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly rev: {
+                                    readonly type: "integer";
+                                    readonly minimum: 1;
+                                };
+                                readonly displayName: {
+                                    readonly type: "string";
+                                    readonly maxLength: 256;
+                                    readonly description: "A rendering hint drawn from the contact's own disclosed display-name claim, so a list is legible. Absent when they disclosed none; a producer MUST NOT substitute the DID — or the petname — silently as though it were the contact's own name.";
+                                };
+                                readonly claimCount: {
+                                    readonly type: "integer";
+                                    readonly minimum: 0;
+                                };
+                                readonly receivedAt: {
+                                    readonly type: "string";
+                                    readonly format: "date-time";
+                                };
+                                readonly hasUnreviewedChange: {
+                                    readonly type: "boolean";
+                                    readonly description: "True when the current revision superseded another and the holder has not yet acknowledged the difference.";
+                                };
+                                readonly starred: {
+                                    readonly type: "boolean";
+                                    readonly description: "Whether the holder starred the contact. Always present.";
+                                };
+                                readonly petname: {
+                                    readonly $ref: "#/$defs/Petname";
+                                };
+                                readonly lists: {
+                                    readonly $ref: "#/$defs/ListIds";
+                                };
+                                readonly directoryRef: {
+                                    readonly $ref: "#/$defs/DirectoryRef";
+                                };
+                            };
+                        };
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 4096;
+                    };
+                    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 DirectoryRef: {
+                readonly title: "DirectoryRef";
+                readonly description: "Links a contact to the entry in a community's member directory it corresponds to, so the holder's own client can join that community's directory with the holder's address book — showing a star or a petname beside an entry — without either side telling the other. The community never learns the link exists; the contact never learns it either. A contact has at most one.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["vtcDid", "entryId"];
+                readonly properties: {
+                    readonly vtcDid: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 2048;
+                        readonly pattern: "^did:[a-z0-9]+:";
+                        readonly description: "The DID of the community whose directory holds the entry.";
+                    };
+                    readonly entryId: {
+                        readonly $ref: "#/$defs/DirectoryEntryId";
+                        readonly description: "The entry, as that community's directory identifies it.";
+                    };
+                };
+            };
+            readonly DirectoryEntryId: {
+                readonly title: "DirectoryEntryId";
+                readonly description: "A community directory entry's identifier, exactly as that community's directory returned it. Opaque and community-scoped: the agent stores and compares it as a string, never parses it, and never treats the same value under two communities as the same entry.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^[A-Za-z0-9_-]+$";
+            };
+            readonly ListIds: {
+                readonly title: "ListIds";
+                readonly description: "The lists a contact is on, as a set: order carries no meaning. A contact on no list has no `lists` member, never an empty array, so there is one way to say \"none\".";
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 64;
+                readonly uniqueItems: true;
+                readonly items: {
+                    readonly $ref: "#/$defs/ListId";
+                };
+            };
+            readonly ListId: {
+                readonly title: "ListId";
+                readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+            readonly Petname: {
+                readonly title: "Petname";
+                readonly description: "The holder's private name for a contact, on one line: no control characters, line breaks included. A petname in Zooko's sense — chosen by the holder, meaningful to the holder, and unforgeable by anyone else, because nobody else can write it. Distinct from the contact's own disclosed `nickname` or display name, which the contact chose and may change. Compared exactly, as a string: an agent does not case-fold or normalise it.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            };
+            readonly Ulid: {
+                readonly title: "Ulid";
+                readonly description: "A ULID in Crockford base32, uppercase. Used for `attributeId` and `profileId`. Chosen over a UUID because the leading 48 bits are a timestamp, so a key-ordered scan of the store is also creation-ordered and a `list` needs no secondary sort. Server-assigned on create; a producer MAY supply one to make a create idempotent, and a maintainer MUST reject a supplied value that already exists rather than silently overwriting.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map