@openvtc/trust-tasks 0.16.6 → 0.16.8

package/dist/rooms/records/list/0.1/payload.d.ts

@@ -0,0 +1,618 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/rooms/records/list/0.1/payload.schema.json
+ */
+import type { AuthorityPresentation, Ext, RecordMetadata } from "../../../../_shared/components.js";
+export interface RoomsRecordsListPayload {
+    /**
+     * The room's identifier.
+     */
+    roomId: string;
+    /**
+     * Must confer the `read` action at this room's scope.
+     */
+    presentation: AuthorityPresentation;
+    /**
+     * Return only records whose key starts with this. On an `attributed` or `private` room keys are opaque, so a prefix is only useful where the client assigned structure to them.
+     */
+    prefix?: string;
+    /**
+     * Return only records changed after this version — the watermark that makes incremental sync possible. Tombstones are returned too: without them a puller learns of every create and update and never of a delete, so deleted records resurrect on the next full rebuild.
+     */
+    sinceVersion?: number;
+    /**
+     * Opaque continuation token from a previous response. A host MUST NOT accept a cursor it did not issue.
+     */
+    cursor?: string;
+    /**
+     * Maximum records to return. A host MAY return fewer.
+     */
+    limit?: number;
+    /**
+     * Ecosystem-defined extension members per SPEC.md §4.5.1.
+     */
+    ext?: Ext;
+}
+/**
+ * Success response to rooms/records/list. Type https://trusttasks.org/spec/rooms/records/list/0.1#response. Returns METADATA, never bodies: a reader fetches the handful it wants with rooms/records/get.
+ */
+export interface RoomsRecordsListResponsePayload {
+    records: RecordMetadata[];
+    /**
+     * Present when more records remain.
+     */
+    cursor?: string;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { AuthorityPresentation, Ext, RecordMetadata };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/rooms/records/list/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RoomsRecordsListPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/rooms/records/list/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RoomsRecordsListResponsePayload;
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/rooms/records/list/0.1";
+    readonly title: "Rooms Records List — payload";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["roomId", "presentation"];
+    readonly properties: {
+        readonly roomId: {
+            readonly type: "string";
+            readonly description: "The room's identifier.";
+        };
+        readonly presentation: {
+            readonly $ref: "#/$defs/AuthorityPresentation";
+            readonly description: "Must confer the `read` action at this room's scope.";
+        };
+        readonly prefix: {
+            readonly type: "string";
+            readonly maxLength: 512;
+            readonly description: "Return only records whose key starts with this. On an `attributed` or `private` room keys are opaque, so a prefix is only useful where the client assigned structure to them.";
+        };
+        readonly sinceVersion: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly description: "Return only records changed after this version — the watermark that makes incremental sync possible. Tombstones are returned too: without them a puller learns of every create and update and never of a delete, so deleted records resurrect on the next full rebuild.";
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly maxLength: 4096;
+            readonly description: "Opaque continuation token from a previous response. A host MUST NOT accept a cursor it did not issue.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 500;
+            readonly description: "Maximum records to return. A host MAY return fewer.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+            readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Rooms Records List — response payload";
+            readonly description: "Success response to rooms/records/list. Type https://trusttasks.org/spec/rooms/records/list/0.1#response. Returns METADATA, never bodies: a reader fetches the handful it wants with rooms/records/get.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["records"];
+            readonly properties: {
+                readonly records: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/RecordMetadata";
+                    };
+                };
+                readonly cursor: {
+                    readonly type: "string";
+                    readonly maxLength: 4096;
+                    readonly description: "Present when more records remain.";
+                };
+                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 RecordMetadata: {
+            readonly title: "RecordMetadata";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["key", "version", "updatedAt"];
+            readonly description: "What `rooms/records/list` returns. Never the body: ranking happens on the client, and a host that returned every body would make the caller pay for the whole room on every listing.";
+            readonly properties: {
+                readonly key: {
+                    readonly type: "string";
+                    readonly description: "The record's key within the room. On `attributed` and `private` rooms this MUST be opaque — a random identifier, never a descriptive slug. A key reading `decision/acquire-northwind` defeats the encryption sitting beside it; structured naming belongs inside the sealed body.";
+                };
+                readonly version: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "Server-assigned, monotonic per room.";
+                };
+                readonly epoch: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "The epoch the record was sealed under. Absent on an `open` room.";
+                };
+                readonly status: {
+                    readonly type: "string";
+                    readonly enum: readonly ["active", "deprecated", "retracted"];
+                    readonly description: "Curation state. `retracted` is a tombstone: the body is gone, the key and version remain so incremental sync converges and the audit chain stays intact.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly title: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                };
+                readonly description: {
+                    readonly type: "string";
+                    readonly maxLength: 2048;
+                    readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                };
+                readonly author: {
+                    readonly type: "string";
+                    readonly description: "The member who wrote it. Present on `open` and `attributed`; on `private` the author is inside the sealed body, where only members can read it.";
+                };
+            };
+        };
+        readonly AuthorityPresentation: {
+            readonly title: "AuthorityPresentation";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["membership", "authority"];
+            readonly description: "What a party presents to act on a room. Carries the whole authority chain: a host MUST NOT dereference an authority credential's `parent` to fetch a link it was not given. Resolving over the network would make verification depend on availability, turn every identifier into a request the host can be induced to make against an address the holder chooses, and signal credential use to whoever hosts the identifier.";
+            readonly properties: {
+                readonly membership: {
+                    readonly type: "string";
+                    readonly description: "The presenter's membership credential for this room, or — on a `private` room — a zero-knowledge presentation of it. Serialized per the governing profile.";
+                };
+                readonly authority: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 8;
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "The authority chain, LEAF FIRST: the first element is the credential being relied on and the last MUST be one issued by the room itself. Every link the presenter relies on is present, because the host will not fetch one. Capped at 8: verification is linear in chain length and runs on every operation, so an unbounded chain is a denial-of-service surface against the host. The known uses need 2 to 3 — a person attenuating to an agent, and that agent to a sub-agent.";
+                };
+                readonly subjectBinding: {
+                    readonly type: "string";
+                    readonly description: "REQUIRED on a `private` room, where the subject identifier is withheld: a proof that the membership credential and the authority chain's leaf describe the SAME subject. Without it two parties pool credentials — one contributes membership, the other authority — and the combination verifies as a single party holding both. A host MUST refuse a private-room presentation that omits this.";
+                };
+            };
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Rooms Records List — response payload";
+            readonly description: "Success response to rooms/records/list. Type https://trusttasks.org/spec/rooms/records/list/0.1#response. Returns METADATA, never bodies: a reader fetches the handful it wants with rooms/records/get.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["records"];
+            readonly properties: {
+                readonly records: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly $ref: "#/$defs/RecordMetadata";
+                    };
+                };
+                readonly cursor: {
+                    readonly type: "string";
+                    readonly maxLength: 4096;
+                    readonly description: "Present when more records remain.";
+                };
+                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 RecordMetadata: {
+            readonly title: "RecordMetadata";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["key", "version", "updatedAt"];
+            readonly description: "What `rooms/records/list` returns. Never the body: ranking happens on the client, and a host that returned every body would make the caller pay for the whole room on every listing.";
+            readonly properties: {
+                readonly key: {
+                    readonly type: "string";
+                    readonly description: "The record's key within the room. On `attributed` and `private` rooms this MUST be opaque — a random identifier, never a descriptive slug. A key reading `decision/acquire-northwind` defeats the encryption sitting beside it; structured naming belongs inside the sealed body.";
+                };
+                readonly version: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "Server-assigned, monotonic per room.";
+                };
+                readonly epoch: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly description: "The epoch the record was sealed under. Absent on an `open` room.";
+                };
+                readonly status: {
+                    readonly type: "string";
+                    readonly enum: readonly ["active", "deprecated", "retracted"];
+                    readonly description: "Curation state. `retracted` is a tombstone: the body is gone, the key and version remain so incremental sync converges and the audit chain stays intact.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly title: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                };
+                readonly description: {
+                    readonly type: "string";
+                    readonly maxLength: 2048;
+                    readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                };
+                readonly author: {
+                    readonly type: "string";
+                    readonly description: "The member who wrote it. Present on `open` and `attributed`; on `private` the author is inside the sealed body, where only members can read it.";
+                };
+            };
+        };
+        readonly AuthorityPresentation: {
+            readonly title: "AuthorityPresentation";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["membership", "authority"];
+            readonly description: "What a party presents to act on a room. Carries the whole authority chain: a host MUST NOT dereference an authority credential's `parent` to fetch a link it was not given. Resolving over the network would make verification depend on availability, turn every identifier into a request the host can be induced to make against an address the holder chooses, and signal credential use to whoever hosts the identifier.";
+            readonly properties: {
+                readonly membership: {
+                    readonly type: "string";
+                    readonly description: "The presenter's membership credential for this room, or — on a `private` room — a zero-knowledge presentation of it. Serialized per the governing profile.";
+                };
+                readonly authority: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 8;
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "The authority chain, LEAF FIRST: the first element is the credential being relied on and the last MUST be one issued by the room itself. Every link the presenter relies on is present, because the host will not fetch one. Capped at 8: verification is linear in chain length and runs on every operation, so an unbounded chain is a denial-of-service surface against the host. The known uses need 2 to 3 — a person attenuating to an agent, and that agent to a sub-agent.";
+                };
+                readonly subjectBinding: {
+                    readonly type: "string";
+                    readonly description: "REQUIRED on a `private` room, where the subject identifier is withheld: a proof that the membership credential and the authority chain's leaf describe the SAME subject. Without it two parties pool credentials — one contributes membership, the other authority — and the combination verifies as a single party holding both. A host MUST refuse a private-room presentation that omits this.";
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/rooms/records/list/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/rooms/records/list/0.1";
+        readonly title: "Rooms Records List — payload";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["roomId", "presentation"];
+        readonly properties: {
+            readonly roomId: {
+                readonly type: "string";
+                readonly description: "The room's identifier.";
+            };
+            readonly presentation: {
+                readonly $ref: "#/$defs/AuthorityPresentation";
+                readonly description: "Must confer the `read` action at this room's scope.";
+            };
+            readonly prefix: {
+                readonly type: "string";
+                readonly maxLength: 512;
+                readonly description: "Return only records whose key starts with this. On an `attributed` or `private` room keys are opaque, so a prefix is only useful where the client assigned structure to them.";
+            };
+            readonly sinceVersion: {
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly description: "Return only records changed after this version — the watermark that makes incremental sync possible. Tombstones are returned too: without them a puller learns of every create and update and never of a delete, so deleted records resurrect on the next full rebuild.";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly maxLength: 4096;
+                readonly description: "Opaque continuation token from a previous response. A host MUST NOT accept a cursor it did not issue.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+                readonly description: "Maximum records to return. A host MAY return fewer.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+                readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Rooms Records List — response payload";
+                readonly description: "Success response to rooms/records/list. Type https://trusttasks.org/spec/rooms/records/list/0.1#response. Returns METADATA, never bodies: a reader fetches the handful it wants with rooms/records/get.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["records"];
+                readonly properties: {
+                    readonly records: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/RecordMetadata";
+                        };
+                    };
+                    readonly cursor: {
+                        readonly type: "string";
+                        readonly maxLength: 4096;
+                        readonly description: "Present when more records remain.";
+                    };
+                    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 RecordMetadata: {
+                readonly title: "RecordMetadata";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["key", "version", "updatedAt"];
+                readonly description: "What `rooms/records/list` returns. Never the body: ranking happens on the client, and a host that returned every body would make the caller pay for the whole room on every listing.";
+                readonly properties: {
+                    readonly key: {
+                        readonly type: "string";
+                        readonly description: "The record's key within the room. On `attributed` and `private` rooms this MUST be opaque — a random identifier, never a descriptive slug. A key reading `decision/acquire-northwind` defeats the encryption sitting beside it; structured naming belongs inside the sealed body.";
+                    };
+                    readonly version: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "Server-assigned, monotonic per room.";
+                    };
+                    readonly epoch: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "The epoch the record was sealed under. Absent on an `open` room.";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["active", "deprecated", "retracted"];
+                        readonly description: "Curation state. `retracted` is a tombstone: the body is gone, the key and version remain so incremental sync converges and the audit chain stays intact.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly maxLength: 512;
+                        readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                        readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                    };
+                    readonly author: {
+                        readonly type: "string";
+                        readonly description: "The member who wrote it. Present on `open` and `attributed`; on `private` the author is inside the sealed body, where only members can read it.";
+                    };
+                };
+            };
+            readonly AuthorityPresentation: {
+                readonly title: "AuthorityPresentation";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["membership", "authority"];
+                readonly description: "What a party presents to act on a room. Carries the whole authority chain: a host MUST NOT dereference an authority credential's `parent` to fetch a link it was not given. Resolving over the network would make verification depend on availability, turn every identifier into a request the host can be induced to make against an address the holder chooses, and signal credential use to whoever hosts the identifier.";
+                readonly properties: {
+                    readonly membership: {
+                        readonly type: "string";
+                        readonly description: "The presenter's membership credential for this room, or — on a `private` room — a zero-knowledge presentation of it. Serialized per the governing profile.";
+                    };
+                    readonly authority: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 8;
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "The authority chain, LEAF FIRST: the first element is the credential being relied on and the last MUST be one issued by the room itself. Every link the presenter relies on is present, because the host will not fetch one. Capped at 8: verification is linear in chain length and runs on every operation, so an unbounded chain is a denial-of-service surface against the host. The known uses need 2 to 3 — a person attenuating to an agent, and that agent to a sub-agent.";
+                    };
+                    readonly subjectBinding: {
+                        readonly type: "string";
+                        readonly description: "REQUIRED on a `private` room, where the subject identifier is withheld: a proof that the membership credential and the authority chain's leaf describe the SAME subject. Without it two parties pool credentials — one contributes membership, the other authority — and the combination verifies as a single party holding both. A host MUST refuse a private-room presentation that omits this.";
+                    };
+                };
+            };
+        };
+    };
+};
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/rooms/records/list/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Rooms Records List — response payload";
+                readonly description: "Success response to rooms/records/list. Type https://trusttasks.org/spec/rooms/records/list/0.1#response. Returns METADATA, never bodies: a reader fetches the handful it wants with rooms/records/get.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["records"];
+                readonly properties: {
+                    readonly records: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly $ref: "#/$defs/RecordMetadata";
+                        };
+                    };
+                    readonly cursor: {
+                        readonly type: "string";
+                        readonly maxLength: 4096;
+                        readonly description: "Present when more records remain.";
+                    };
+                    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 RecordMetadata: {
+                readonly title: "RecordMetadata";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["key", "version", "updatedAt"];
+                readonly description: "What `rooms/records/list` returns. Never the body: ranking happens on the client, and a host that returned every body would make the caller pay for the whole room on every listing.";
+                readonly properties: {
+                    readonly key: {
+                        readonly type: "string";
+                        readonly description: "The record's key within the room. On `attributed` and `private` rooms this MUST be opaque — a random identifier, never a descriptive slug. A key reading `decision/acquire-northwind` defeats the encryption sitting beside it; structured naming belongs inside the sealed body.";
+                    };
+                    readonly version: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "Server-assigned, monotonic per room.";
+                    };
+                    readonly epoch: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly description: "The epoch the record was sealed under. Absent on an `open` room.";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["active", "deprecated", "retracted"];
+                        readonly description: "Curation state. `retracted` is a tombstone: the body is gone, the key and version remain so incremental sync converges and the audit chain stays intact.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly maxLength: 512;
+                        readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly maxLength: 2048;
+                        readonly description: "Present only on an `open` room; sealed with the body otherwise.";
+                    };
+                    readonly author: {
+                        readonly type: "string";
+                        readonly description: "The member who wrote it. Present on `open` and `attributed`; on `private` the author is inside the sealed body, where only members can read it.";
+                    };
+                };
+            };
+            readonly AuthorityPresentation: {
+                readonly title: "AuthorityPresentation";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["membership", "authority"];
+                readonly description: "What a party presents to act on a room. Carries the whole authority chain: a host MUST NOT dereference an authority credential's `parent` to fetch a link it was not given. Resolving over the network would make verification depend on availability, turn every identifier into a request the host can be induced to make against an address the holder chooses, and signal credential use to whoever hosts the identifier.";
+                readonly properties: {
+                    readonly membership: {
+                        readonly type: "string";
+                        readonly description: "The presenter's membership credential for this room, or — on a `private` room — a zero-knowledge presentation of it. Serialized per the governing profile.";
+                    };
+                    readonly authority: {
+                        readonly type: "array";
+                        readonly minItems: 1;
+                        readonly maxItems: 8;
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "The authority chain, LEAF FIRST: the first element is the credential being relied on and the last MUST be one issued by the room itself. Every link the presenter relies on is present, because the host will not fetch one. Capped at 8: verification is linear in chain length and runs on every operation, so an unbounded chain is a denial-of-service surface against the host. The known uses need 2 to 3 — a person attenuating to an agent, and that agent to a sub-agent.";
+                    };
+                    readonly subjectBinding: {
+                        readonly type: "string";
+                        readonly description: "REQUIRED on a `private` room, where the subject identifier is withheld: a proof that the membership credential and the authority chain's leaf describe the SAME subject. Without it two parties pool credentials — one contributes membership, the other authority — and the combination verifies as a single party holding both. A host MUST refuse a private-room presentation that omits this.";
+                    };
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/rooms/records/list/0.1/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../src/rooms/records/list/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAGpG,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,YAAY,EAAE,qBAAqB,CAAC;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AACD;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,kHAAkH;AAClH,YAAY,EAAE,qBAAqB,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;AAE3D,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAG,oDAA6D,CAAC;AAEtF,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,uBAAuB,CAAC;AAE9C,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAG,6DAAsE,CAAC;AAExG,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsKjB,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4H1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOP,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOhB,CAAC"}