@openvtc/trust-tasks 0.19.16 → 0.19.18

package/dist/persona/profile/compose/1.0/payload.d.ts

@@ -0,0 +1,951 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/persona/profile/compose/1.0/payload.schema.json
+ */
+import type { ClaimType, Ext, Slot, Ulid, ValueType, Version_PersonaV0_1 as Version } from "../../../../_shared/components.js";
+/**
+ * One claim of the face being composed: a value typed now, or an attribute the holder already keeps.
+ */
+export type ComposeClaim = NewClaim | HeldClaim;
+/**
+ * Compose a face for one context, where it is needed, from values typed now and attributes already held — and optionally wear it there in the same act. Local by default: a value typed here stays in this context unless the holder says it should be reusable. Where the face lives follows from what it carries, so there is no scope parameter to get wrong.
+ */
+export interface PersonaProfileComposePayload {
+    /**
+     * The context the face is composed for. A face whose every claim is local lives in this context and nowhere else; a face carrying any pool claim lives above contexts, and is bound into this one when `personaDid` is given.
+     */
+    contextId: string;
+    /**
+     * The holder's name for the face. Never disclosed; what a context may call the face is `label`.
+     */
+    name: string;
+    /**
+     * Ordered; the order is display order.
+     *
+     * @minItems 1
+     * @maxItems 64
+     */
+    claims: [ComposeClaim, ...ComposeClaim[]];
+    /**
+     * Wear the new face as this persona in `contextId`, in the same act. Omit to compose without wearing it.
+     */
+    personaDid?: string;
+    /**
+     * What the context may call the face, as on persona/binding/set. Meaningful only with `personaDid`; a maintainer MUST refuse it without one rather than drop it.
+     */
+    label?: string;
+    ext?: Ext;
+}
+/**
+ * A value the holder types now. Self-asserted: a value typed at this step has no issuer behind it, and a claim that could carry a provenance here would let a typed value present as attested.
+ */
+export interface NewClaim {
+    type: ClaimType;
+    valueType: ValueType;
+    value: unknown;
+    /**
+     * The holder's note to self for this value. Never disclosed.
+     */
+    label?: string;
+    slot?: Slot;
+    /**
+     * `local` (the default) keeps the value in this face alone: it is carried inline and enters no pool, so no other face can come to present it by accident. `pool` makes it reusable — the maintainer references a self-asserted pool attribute holding exactly this type and value, creating one when none exists.
+     */
+    share?: "local" | "pool";
+}
+/**
+ * An attribute already in the holder's pool, presented live.
+ */
+export interface HeldClaim {
+    attributeId: Ulid;
+    slot?: Slot;
+}
+/**
+ * Success response to persona/profile/compose. Type https://trusttasks.org/spec/persona/profile/compose/1.0#response.
+ */
+export interface PersonaProfileComposeResponsePayload {
+    profileId: Ulid;
+    /**
+     * Where the face lives. `local`: in `contextId` only, readable through persona/local/profile/get. `pool`: above contexts, readable through persona/profile/get, and able to be worn in other contexts later.
+     */
+    scope: "local" | "pool";
+    version: Version;
+    /**
+     * For each `share: pool` claim, in request order, the pool attribute the face now references and whether this compose created it. `created: false` means the holder already kept exactly this value, and the face now shares it with whatever else presents it. Absent when no claim was pooled.
+     *
+     * @maxItems 64
+     */
+    pooled?: {
+        attributeId: Ulid;
+        created: boolean;
+    }[];
+    /**
+     * Present when `personaDid` was given: the face is now worn there.
+     */
+    binding?: {
+        personaDid: string;
+        version: Version;
+        /**
+         * How many other personas in this context wear this face. Always zero for a face this task just created; present for parity with persona/binding/set.
+         */
+        alsoBoundPersonaCount?: number;
+    };
+    /**
+     * Advisory, as on persona/profile/put: how many of the face's claims present a value another face also presents. A count; identifiers come from persona/correlation/analyze. The write has applied.
+     */
+    correlation?: {
+        severity: "none" | "low" | "high";
+        sharedAttributeCount?: number;
+    };
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { ClaimType, Ext, Slot, Ulid, ValueType, Version };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/persona/profile/compose/1.0";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PersonaProfileComposePayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/persona/profile/compose/1.0#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PersonaProfileComposeResponsePayload;
+/**
+ * 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/profile/compose/1.0";
+    readonly title: "Persona Profile Compose — payload";
+    readonly description: "Compose a face for one context, where it is needed, from values typed now and attributes already held — and optionally wear it there in the same act. Local by default: a value typed here stays in this context unless the holder says it should be reusable. Where the face lives follows from what it carries, so there is no scope parameter to get wrong.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["contextId", "name", "claims"];
+    readonly properties: {
+        readonly contextId: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "The context the face is composed for. A face whose every claim is local lives in this context and nowhere else; a face carrying any pool claim lives above contexts, and is bound into this one when `personaDid` is given.";
+        };
+        readonly name: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The holder's name for the face. Never disclosed; what a context may call the face is `label`.";
+        };
+        readonly claims: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 64;
+            readonly items: {
+                readonly $ref: "#/$defs/ComposeClaim";
+            };
+            readonly description: "Ordered; the order is display order.";
+        };
+        readonly personaDid: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 2048;
+            readonly description: "Wear the new face as this persona in `contextId`, in the same act. Omit to compose without wearing it.";
+        };
+        readonly label: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "What the context may call the face, as on persona/binding/set. Meaningful only with `personaDid`; a maintainer MUST refuse it without one rather than drop it.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly ComposeClaim: {
+            readonly title: "ComposeClaim";
+            readonly description: "One claim of the face being composed: a value typed now, or an attribute the holder already keeps.";
+            readonly oneOf: readonly [{
+                readonly $ref: "#/$defs/NewClaim";
+            }, {
+                readonly $ref: "#/$defs/HeldClaim";
+            }];
+        };
+        readonly NewClaim: {
+            readonly title: "NewClaim";
+            readonly description: "A value the holder types now. Self-asserted: a value typed at this step has no issuer behind it, and a claim that could carry a provenance here would let a typed value present as attested.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["type", "valueType", "value"];
+            readonly properties: {
+                readonly type: {
+                    readonly $ref: "#/$defs/ClaimType";
+                };
+                readonly valueType: {
+                    readonly $ref: "#/$defs/ValueType";
+                };
+                readonly value: {};
+                readonly label: {
+                    readonly type: "string";
+                    readonly maxLength: 128;
+                    readonly description: "The holder's note to self for this value. Never disclosed.";
+                };
+                readonly slot: {
+                    readonly $ref: "#/$defs/Slot";
+                };
+                readonly share: {
+                    readonly type: "string";
+                    readonly enum: readonly ["local", "pool"];
+                    readonly default: "local";
+                    readonly description: "`local` (the default) keeps the value in this face alone: it is carried inline and enters no pool, so no other face can come to present it by accident. `pool` makes it reusable — the maintainer references a self-asserted pool attribute holding exactly this type and value, creating one when none exists.";
+                };
+            };
+        };
+        readonly HeldClaim: {
+            readonly title: "HeldClaim";
+            readonly description: "An attribute already in the holder's pool, presented live.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["attributeId"];
+            readonly properties: {
+                readonly attributeId: {
+                    readonly $ref: "#/$defs/Ulid";
+                };
+                readonly slot: {
+                    readonly $ref: "#/$defs/Slot";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Persona Profile Compose — response payload";
+            readonly description: "Success response to persona/profile/compose. Type https://trusttasks.org/spec/persona/profile/compose/1.0#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["profileId", "scope", "version"];
+            readonly properties: {
+                readonly profileId: {
+                    readonly $ref: "#/$defs/Ulid";
+                };
+                readonly scope: {
+                    readonly type: "string";
+                    readonly enum: readonly ["local", "pool"];
+                    readonly description: "Where the face lives. `local`: in `contextId` only, readable through persona/local/profile/get. `pool`: above contexts, readable through persona/profile/get, and able to be worn in other contexts later.";
+                };
+                readonly version: {
+                    readonly $ref: "#/$defs/Version";
+                };
+                readonly pooled: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly description: "For each `share: pool` claim, in request order, the pool attribute the face now references and whether this compose created it. `created: false` means the holder already kept exactly this value, and the face now shares it with whatever else presents it. Absent when no claim was pooled.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["attributeId", "created"];
+                        readonly properties: {
+                            readonly attributeId: {
+                                readonly $ref: "#/$defs/Ulid";
+                            };
+                            readonly created: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                };
+                readonly binding: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["personaDid", "version"];
+                    readonly description: "Present when `personaDid` was given: the face is now worn there.";
+                    readonly properties: {
+                        readonly personaDid: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly version: {
+                            readonly $ref: "#/$defs/Version";
+                        };
+                        readonly alsoBoundPersonaCount: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly description: "How many other personas in this context wear this face. Always zero for a face this task just created; present for parity with persona/binding/set.";
+                        };
+                    };
+                };
+                readonly correlation: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["severity"];
+                    readonly description: "Advisory, as on persona/profile/put: how many of the face's claims present a value another face also presents. A count; identifiers come from persona/correlation/analyze. The write has applied.";
+                    readonly properties: {
+                        readonly severity: {
+                            readonly type: "string";
+                            readonly enum: readonly ["none", "low", "high"];
+                        };
+                        readonly sharedAttributeCount: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
+                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 Version: {
+            readonly title: "Version";
+            readonly description: "A value of the store's monotonic write counter. Server-assigned; a producer never chooses one.";
+            readonly type: "integer";
+            readonly minimum: 1;
+        };
+        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}$";
+        };
+        readonly Slot: {
+            readonly title: "Slot";
+            readonly type: "string";
+            readonly pattern: "^[a-z][A-Za-z0-9]{0,31}$";
+            readonly description: "A role a profile entry plays within its profile, so a consumer can find it without guessing from its claim type. A profile MAY hold several entries of one type — a legal name and a display name, two phone numbers — and only a slot says which answers a given question. Unique within a profile.\n\nWell-known slots:\n\n- `displayName` — what this face calls itself. The entry a consumer renders as the face's name to anyone it is shown to. Distinct from the profile's own `name`, which is the holder's private label and never disclosed.\n- `primaryEmail`, `primaryPhone`, `primaryAddress` — the entry to use where a counterparty asks for one of a kind and the profile holds several.\n- `avatar` — the image this face presents.\n\nOther values are the holder's or the producer's own and carry no meaning a maintainer interprets.";
+        };
+        readonly ValueType: {
+            readonly title: "ValueType";
+            readonly description: "The JSON shape of `value`, declared so that a consumer can render and compare without guessing. The maintainer validates that `value` agrees with this member and does nothing further: it does NOT validate a phone number against a phone-number grammar. That is a producer's affordance, and a store that grows opinions about the contents of its records eventually blocks its consumer's release.";
+            readonly type: "string";
+            readonly enum: readonly ["string", "number", "boolean", "date", "object"];
+        };
+        readonly ClaimType: {
+            readonly title: "ClaimType";
+            readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly ComposeClaim: {
+            readonly title: "ComposeClaim";
+            readonly description: "One claim of the face being composed: a value typed now, or an attribute the holder already keeps.";
+            readonly oneOf: readonly [{
+                readonly $ref: "#/$defs/NewClaim";
+            }, {
+                readonly $ref: "#/$defs/HeldClaim";
+            }];
+        };
+        readonly NewClaim: {
+            readonly title: "NewClaim";
+            readonly description: "A value the holder types now. Self-asserted: a value typed at this step has no issuer behind it, and a claim that could carry a provenance here would let a typed value present as attested.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["type", "valueType", "value"];
+            readonly properties: {
+                readonly type: {
+                    readonly $ref: "#/$defs/ClaimType";
+                };
+                readonly valueType: {
+                    readonly $ref: "#/$defs/ValueType";
+                };
+                readonly value: {};
+                readonly label: {
+                    readonly type: "string";
+                    readonly maxLength: 128;
+                    readonly description: "The holder's note to self for this value. Never disclosed.";
+                };
+                readonly slot: {
+                    readonly $ref: "#/$defs/Slot";
+                };
+                readonly share: {
+                    readonly type: "string";
+                    readonly enum: readonly ["local", "pool"];
+                    readonly default: "local";
+                    readonly description: "`local` (the default) keeps the value in this face alone: it is carried inline and enters no pool, so no other face can come to present it by accident. `pool` makes it reusable — the maintainer references a self-asserted pool attribute holding exactly this type and value, creating one when none exists.";
+                };
+            };
+        };
+        readonly HeldClaim: {
+            readonly title: "HeldClaim";
+            readonly description: "An attribute already in the holder's pool, presented live.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["attributeId"];
+            readonly properties: {
+                readonly attributeId: {
+                    readonly $ref: "#/$defs/Ulid";
+                };
+                readonly slot: {
+                    readonly $ref: "#/$defs/Slot";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Persona Profile Compose — response payload";
+            readonly description: "Success response to persona/profile/compose. Type https://trusttasks.org/spec/persona/profile/compose/1.0#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["profileId", "scope", "version"];
+            readonly properties: {
+                readonly profileId: {
+                    readonly $ref: "#/$defs/Ulid";
+                };
+                readonly scope: {
+                    readonly type: "string";
+                    readonly enum: readonly ["local", "pool"];
+                    readonly description: "Where the face lives. `local`: in `contextId` only, readable through persona/local/profile/get. `pool`: above contexts, readable through persona/profile/get, and able to be worn in other contexts later.";
+                };
+                readonly version: {
+                    readonly $ref: "#/$defs/Version";
+                };
+                readonly pooled: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly description: "For each `share: pool` claim, in request order, the pool attribute the face now references and whether this compose created it. `created: false` means the holder already kept exactly this value, and the face now shares it with whatever else presents it. Absent when no claim was pooled.";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["attributeId", "created"];
+                        readonly properties: {
+                            readonly attributeId: {
+                                readonly $ref: "#/$defs/Ulid";
+                            };
+                            readonly created: {
+                                readonly type: "boolean";
+                            };
+                        };
+                    };
+                };
+                readonly binding: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["personaDid", "version"];
+                    readonly description: "Present when `personaDid` was given: the face is now worn there.";
+                    readonly properties: {
+                        readonly personaDid: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly version: {
+                            readonly $ref: "#/$defs/Version";
+                        };
+                        readonly alsoBoundPersonaCount: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                            readonly description: "How many other personas in this context wear this face. Always zero for a face this task just created; present for parity with persona/binding/set.";
+                        };
+                    };
+                };
+                readonly correlation: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["severity"];
+                    readonly description: "Advisory, as on persona/profile/put: how many of the face's claims present a value another face also presents. A count; identifiers come from persona/correlation/analyze. The write has applied.";
+                    readonly properties: {
+                        readonly severity: {
+                            readonly type: "string";
+                            readonly enum: readonly ["none", "low", "high"];
+                        };
+                        readonly sharedAttributeCount: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                    };
+                };
+                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 Version: {
+            readonly title: "Version";
+            readonly description: "A value of the store's monotonic write counter. Server-assigned; a producer never chooses one.";
+            readonly type: "integer";
+            readonly minimum: 1;
+        };
+        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}$";
+        };
+        readonly Slot: {
+            readonly title: "Slot";
+            readonly type: "string";
+            readonly pattern: "^[a-z][A-Za-z0-9]{0,31}$";
+            readonly description: "A role a profile entry plays within its profile, so a consumer can find it without guessing from its claim type. A profile MAY hold several entries of one type — a legal name and a display name, two phone numbers — and only a slot says which answers a given question. Unique within a profile.\n\nWell-known slots:\n\n- `displayName` — what this face calls itself. The entry a consumer renders as the face's name to anyone it is shown to. Distinct from the profile's own `name`, which is the holder's private label and never disclosed.\n- `primaryEmail`, `primaryPhone`, `primaryAddress` — the entry to use where a counterparty asks for one of a kind and the profile holds several.\n- `avatar` — the image this face presents.\n\nOther values are the holder's or the producer's own and carry no meaning a maintainer interprets.";
+        };
+        readonly ValueType: {
+            readonly title: "ValueType";
+            readonly description: "The JSON shape of `value`, declared so that a consumer can render and compare without guessing. The maintainer validates that `value` agrees with this member and does nothing further: it does NOT validate a phone number against a phone-number grammar. That is a producer's affordance, and a store that grows opinions about the contents of its records eventually blocks its consumer's release.";
+            readonly type: "string";
+            readonly enum: readonly ["string", "number", "boolean", "date", "object"];
+        };
+        readonly ClaimType: {
+            readonly title: "ClaimType";
+            readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/persona/profile/compose/1.0";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/persona/profile/compose/1.0";
+        readonly title: "Persona Profile Compose — payload";
+        readonly description: "Compose a face for one context, where it is needed, from values typed now and attributes already held — and optionally wear it there in the same act. Local by default: a value typed here stays in this context unless the holder says it should be reusable. Where the face lives follows from what it carries, so there is no scope parameter to get wrong.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["contextId", "name", "claims"];
+        readonly properties: {
+            readonly contextId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "The context the face is composed for. A face whose every claim is local lives in this context and nowhere else; a face carrying any pool claim lives above contexts, and is bound into this one when `personaDid` is given.";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The holder's name for the face. Never disclosed; what a context may call the face is `label`.";
+            };
+            readonly claims: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 64;
+                readonly items: {
+                    readonly $ref: "#/$defs/ComposeClaim";
+                };
+                readonly description: "Ordered; the order is display order.";
+            };
+            readonly personaDid: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 2048;
+                readonly description: "Wear the new face as this persona in `contextId`, in the same act. Omit to compose without wearing it.";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "What the context may call the face, as on persona/binding/set. Meaningful only with `personaDid`; a maintainer MUST refuse it without one rather than drop it.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly ComposeClaim: {
+                readonly title: "ComposeClaim";
+                readonly description: "One claim of the face being composed: a value typed now, or an attribute the holder already keeps.";
+                readonly oneOf: readonly [{
+                    readonly $ref: "#/$defs/NewClaim";
+                }, {
+                    readonly $ref: "#/$defs/HeldClaim";
+                }];
+            };
+            readonly NewClaim: {
+                readonly title: "NewClaim";
+                readonly description: "A value the holder types now. Self-asserted: a value typed at this step has no issuer behind it, and a claim that could carry a provenance here would let a typed value present as attested.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "valueType", "value"];
+                readonly properties: {
+                    readonly type: {
+                        readonly $ref: "#/$defs/ClaimType";
+                    };
+                    readonly valueType: {
+                        readonly $ref: "#/$defs/ValueType";
+                    };
+                    readonly value: {};
+                    readonly label: {
+                        readonly type: "string";
+                        readonly maxLength: 128;
+                        readonly description: "The holder's note to self for this value. Never disclosed.";
+                    };
+                    readonly slot: {
+                        readonly $ref: "#/$defs/Slot";
+                    };
+                    readonly share: {
+                        readonly type: "string";
+                        readonly enum: readonly ["local", "pool"];
+                        readonly default: "local";
+                        readonly description: "`local` (the default) keeps the value in this face alone: it is carried inline and enters no pool, so no other face can come to present it by accident. `pool` makes it reusable — the maintainer references a self-asserted pool attribute holding exactly this type and value, creating one when none exists.";
+                    };
+                };
+            };
+            readonly HeldClaim: {
+                readonly title: "HeldClaim";
+                readonly description: "An attribute already in the holder's pool, presented live.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["attributeId"];
+                readonly properties: {
+                    readonly attributeId: {
+                        readonly $ref: "#/$defs/Ulid";
+                    };
+                    readonly slot: {
+                        readonly $ref: "#/$defs/Slot";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Persona Profile Compose — response payload";
+                readonly description: "Success response to persona/profile/compose. Type https://trusttasks.org/spec/persona/profile/compose/1.0#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["profileId", "scope", "version"];
+                readonly properties: {
+                    readonly profileId: {
+                        readonly $ref: "#/$defs/Ulid";
+                    };
+                    readonly scope: {
+                        readonly type: "string";
+                        readonly enum: readonly ["local", "pool"];
+                        readonly description: "Where the face lives. `local`: in `contextId` only, readable through persona/local/profile/get. `pool`: above contexts, readable through persona/profile/get, and able to be worn in other contexts later.";
+                    };
+                    readonly version: {
+                        readonly $ref: "#/$defs/Version";
+                    };
+                    readonly pooled: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly description: "For each `share: pool` claim, in request order, the pool attribute the face now references and whether this compose created it. `created: false` means the holder already kept exactly this value, and the face now shares it with whatever else presents it. Absent when no claim was pooled.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["attributeId", "created"];
+                            readonly properties: {
+                                readonly attributeId: {
+                                    readonly $ref: "#/$defs/Ulid";
+                                };
+                                readonly created: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                        };
+                    };
+                    readonly binding: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["personaDid", "version"];
+                        readonly description: "Present when `personaDid` was given: the face is now worn there.";
+                        readonly properties: {
+                            readonly personaDid: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly version: {
+                                readonly $ref: "#/$defs/Version";
+                            };
+                            readonly alsoBoundPersonaCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                                readonly description: "How many other personas in this context wear this face. Always zero for a face this task just created; present for parity with persona/binding/set.";
+                            };
+                        };
+                    };
+                    readonly correlation: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["severity"];
+                        readonly description: "Advisory, as on persona/profile/put: how many of the face's claims present a value another face also presents. A count; identifiers come from persona/correlation/analyze. The write has applied.";
+                        readonly properties: {
+                            readonly severity: {
+                                readonly type: "string";
+                                readonly enum: readonly ["none", "low", "high"];
+                            };
+                            readonly sharedAttributeCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                        };
+                    };
+                    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 Version: {
+                readonly title: "Version";
+                readonly description: "A value of the store's monotonic write counter. Server-assigned; a producer never chooses one.";
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            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}$";
+            };
+            readonly Slot: {
+                readonly title: "Slot";
+                readonly type: "string";
+                readonly pattern: "^[a-z][A-Za-z0-9]{0,31}$";
+                readonly description: "A role a profile entry plays within its profile, so a consumer can find it without guessing from its claim type. A profile MAY hold several entries of one type — a legal name and a display name, two phone numbers — and only a slot says which answers a given question. Unique within a profile.\n\nWell-known slots:\n\n- `displayName` — what this face calls itself. The entry a consumer renders as the face's name to anyone it is shown to. Distinct from the profile's own `name`, which is the holder's private label and never disclosed.\n- `primaryEmail`, `primaryPhone`, `primaryAddress` — the entry to use where a counterparty asks for one of a kind and the profile holds several.\n- `avatar` — the image this face presents.\n\nOther values are the holder's or the producer's own and carry no meaning a maintainer interprets.";
+            };
+            readonly ValueType: {
+                readonly title: "ValueType";
+                readonly description: "The JSON shape of `value`, declared so that a consumer can render and compare without guessing. The maintainer validates that `value` agrees with this member and does nothing further: it does NOT validate a phone number against a phone-number grammar. That is a producer's affordance, and a store that grows opinions about the contents of its records eventually blocks its consumer's release.";
+                readonly type: "string";
+                readonly enum: readonly ["string", "number", "boolean", "date", "object"];
+            };
+            readonly ClaimType: {
+                readonly title: "ClaimType";
+                readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/persona/profile/compose/1.0#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly ComposeClaim: {
+                readonly title: "ComposeClaim";
+                readonly description: "One claim of the face being composed: a value typed now, or an attribute the holder already keeps.";
+                readonly oneOf: readonly [{
+                    readonly $ref: "#/$defs/NewClaim";
+                }, {
+                    readonly $ref: "#/$defs/HeldClaim";
+                }];
+            };
+            readonly NewClaim: {
+                readonly title: "NewClaim";
+                readonly description: "A value the holder types now. Self-asserted: a value typed at this step has no issuer behind it, and a claim that could carry a provenance here would let a typed value present as attested.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["type", "valueType", "value"];
+                readonly properties: {
+                    readonly type: {
+                        readonly $ref: "#/$defs/ClaimType";
+                    };
+                    readonly valueType: {
+                        readonly $ref: "#/$defs/ValueType";
+                    };
+                    readonly value: {};
+                    readonly label: {
+                        readonly type: "string";
+                        readonly maxLength: 128;
+                        readonly description: "The holder's note to self for this value. Never disclosed.";
+                    };
+                    readonly slot: {
+                        readonly $ref: "#/$defs/Slot";
+                    };
+                    readonly share: {
+                        readonly type: "string";
+                        readonly enum: readonly ["local", "pool"];
+                        readonly default: "local";
+                        readonly description: "`local` (the default) keeps the value in this face alone: it is carried inline and enters no pool, so no other face can come to present it by accident. `pool` makes it reusable — the maintainer references a self-asserted pool attribute holding exactly this type and value, creating one when none exists.";
+                    };
+                };
+            };
+            readonly HeldClaim: {
+                readonly title: "HeldClaim";
+                readonly description: "An attribute already in the holder's pool, presented live.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["attributeId"];
+                readonly properties: {
+                    readonly attributeId: {
+                        readonly $ref: "#/$defs/Ulid";
+                    };
+                    readonly slot: {
+                        readonly $ref: "#/$defs/Slot";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Persona Profile Compose — response payload";
+                readonly description: "Success response to persona/profile/compose. Type https://trusttasks.org/spec/persona/profile/compose/1.0#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["profileId", "scope", "version"];
+                readonly properties: {
+                    readonly profileId: {
+                        readonly $ref: "#/$defs/Ulid";
+                    };
+                    readonly scope: {
+                        readonly type: "string";
+                        readonly enum: readonly ["local", "pool"];
+                        readonly description: "Where the face lives. `local`: in `contextId` only, readable through persona/local/profile/get. `pool`: above contexts, readable through persona/profile/get, and able to be worn in other contexts later.";
+                    };
+                    readonly version: {
+                        readonly $ref: "#/$defs/Version";
+                    };
+                    readonly pooled: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly description: "For each `share: pool` claim, in request order, the pool attribute the face now references and whether this compose created it. `created: false` means the holder already kept exactly this value, and the face now shares it with whatever else presents it. Absent when no claim was pooled.";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly additionalProperties: false;
+                            readonly required: readonly ["attributeId", "created"];
+                            readonly properties: {
+                                readonly attributeId: {
+                                    readonly $ref: "#/$defs/Ulid";
+                                };
+                                readonly created: {
+                                    readonly type: "boolean";
+                                };
+                            };
+                        };
+                    };
+                    readonly binding: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["personaDid", "version"];
+                        readonly description: "Present when `personaDid` was given: the face is now worn there.";
+                        readonly properties: {
+                            readonly personaDid: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly version: {
+                                readonly $ref: "#/$defs/Version";
+                            };
+                            readonly alsoBoundPersonaCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                                readonly description: "How many other personas in this context wear this face. Always zero for a face this task just created; present for parity with persona/binding/set.";
+                            };
+                        };
+                    };
+                    readonly correlation: {
+                        readonly type: "object";
+                        readonly additionalProperties: false;
+                        readonly required: readonly ["severity"];
+                        readonly description: "Advisory, as on persona/profile/put: how many of the face's claims present a value another face also presents. A count; identifiers come from persona/correlation/analyze. The write has applied.";
+                        readonly properties: {
+                            readonly severity: {
+                                readonly type: "string";
+                                readonly enum: readonly ["none", "low", "high"];
+                            };
+                            readonly sharedAttributeCount: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                        };
+                    };
+                    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 Version: {
+                readonly title: "Version";
+                readonly description: "A value of the store's monotonic write counter. Server-assigned; a producer never chooses one.";
+                readonly type: "integer";
+                readonly minimum: 1;
+            };
+            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}$";
+            };
+            readonly Slot: {
+                readonly title: "Slot";
+                readonly type: "string";
+                readonly pattern: "^[a-z][A-Za-z0-9]{0,31}$";
+                readonly description: "A role a profile entry plays within its profile, so a consumer can find it without guessing from its claim type. A profile MAY hold several entries of one type — a legal name and a display name, two phone numbers — and only a slot says which answers a given question. Unique within a profile.\n\nWell-known slots:\n\n- `displayName` — what this face calls itself. The entry a consumer renders as the face's name to anyone it is shown to. Distinct from the profile's own `name`, which is the holder's private label and never disclosed.\n- `primaryEmail`, `primaryPhone`, `primaryAddress` — the entry to use where a counterparty asks for one of a kind and the profile holds several.\n- `avatar` — the image this face presents.\n\nOther values are the holder's or the producer's own and carry no meaning a maintainer interprets.";
+            };
+            readonly ValueType: {
+                readonly title: "ValueType";
+                readonly description: "The JSON shape of `value`, declared so that a consumer can render and compare without guessing. The maintainer validates that `value` agrees with this member and does nothing further: it does NOT validate a phone number against a phone-number grammar. That is a producer's affordance, and a store that grows opinions about the contents of its records eventually blocks its consumer's release.";
+                readonly type: "string";
+                readonly enum: readonly ["string", "number", "boolean", "date", "object"];
+            };
+            readonly ClaimType: {
+                readonly title: "ClaimType";
+                readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map