@openvtc/trust-tasks 0.23.8 → 0.23.9

package/dist/rooms/usage/0.1/payload.d.ts

@@ -0,0 +1,795 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/rooms/usage/0.1/payload.schema.json
+ */
+import type { AuthorityPresentation, Ext, ScopeLimits, Usage } from "../../../_shared/components.js";
+/**
+ * A room's owner reads how much each member who has added files is using, against their allowance. Authorized by the room's own credentials: a chain conferring `admin` at the room's scope.
+ */
+export interface RoomsUsagePayload {
+    /**
+     * The room's identifier. The host verifies the presentation against credentials issued by this identifier.
+     */
+    roomId: string;
+    /**
+     * Must confer the `admin` action at this room's scope.
+     */
+    presentation: AuthorityPresentation;
+    /**
+     * Opaque continuation from a previous response's `nextCursor`. Omit for the first page.
+     */
+    cursor?: string;
+    /**
+     * Most entries to return. The host chooses when omitted, and may return fewer.
+     */
+    limit?: number;
+    /**
+     * Ecosystem-defined extension members per SPEC.md §4.5.1.
+     */
+    ext?: Ext;
+}
+/**
+ * Success response to rooms/usage. Type https://trusttasks.org/spec/rooms/usage/0.1#response.
+ */
+export interface RoomsUsageResponsePayload {
+    /**
+     * The room this describes.
+     */
+    roomId: string;
+    /**
+     * One entry per member who holds or has reserved storage in the room, or holds an override. Not a roster: a member who has never added a file does not appear, because the host has never been told about them.
+     *
+     * @maxItems 500
+     */
+    members: MemberUsage[];
+    /**
+     * Present exactly when more entries remain.
+     */
+    nextCursor?: string;
+    ext?: Ext;
+}
+export interface MemberUsage {
+    /**
+     * The member's DID: the subject at the room end of the chains they presented when uploading. Uploads by a member's agents are counted here, under the member.
+     */
+    member: string;
+    usage: Usage;
+    /**
+     * The limits that apply to this member in this room: their override if one is set, else the room's per-member default.
+     */
+    limits: ScopeLimits;
+    /**
+     * True when `limits` is an override set for this member rather than the room's default.
+     */
+    overridden?: boolean;
+    /**
+     * When this member last committed a blob in the room.
+     */
+    lastUploadAt?: string;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { AuthorityPresentation, Ext, ScopeLimits, Usage };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/rooms/usage/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RoomsUsagePayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/rooms/usage/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RoomsUsageResponsePayload;
+/**
+ * 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/usage/0.1";
+    readonly title: "Rooms Usage — payload";
+    readonly description: "A room's owner reads how much each member who has added files is using, against their allowance. Authorized by the room's own credentials: a chain conferring `admin` at the room's scope.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["roomId", "presentation"];
+    readonly properties: {
+        readonly roomId: {
+            readonly type: "string";
+            readonly description: "The room's identifier. The host verifies the presentation against credentials issued by this identifier.";
+        };
+        readonly presentation: {
+            readonly $ref: "#/$defs/AuthorityPresentation";
+            readonly description: "Must confer the `admin` action at this room's scope.";
+        };
+        readonly cursor: {
+            readonly type: "string";
+            readonly maxLength: 512;
+            readonly description: "Opaque continuation from a previous response's `nextCursor`. Omit for the first page.";
+        };
+        readonly limit: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 500;
+            readonly description: "Most entries to return. The host chooses when omitted, and may return fewer.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+            readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+        };
+    };
+    readonly $defs: {
+        readonly MemberUsage: {
+            readonly title: "MemberUsage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["member", "usage", "limits"];
+            readonly properties: {
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:[a-z0-9]+:.+$";
+                    readonly maxLength: 2048;
+                    readonly description: "The member's DID: the subject at the room end of the chains they presented when uploading. Uploads by a member's agents are counted here, under the member.";
+                };
+                readonly usage: {
+                    readonly $ref: "#/$defs/Usage";
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "The limits that apply to this member in this room: their override if one is set, else the room's per-member default.";
+                };
+                readonly overridden: {
+                    readonly type: "boolean";
+                    readonly description: "True when `limits` is an override set for this member rather than the room's default.";
+                };
+                readonly lastUploadAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When this member last committed a blob in the room.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Rooms Usage — response payload";
+            readonly description: "Success response to rooms/usage. Type https://trusttasks.org/spec/rooms/usage/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "members"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly description: "The room this describes.";
+                };
+                readonly members: {
+                    readonly type: "array";
+                    readonly maxItems: 500;
+                    readonly items: {
+                        readonly $ref: "#/$defs/MemberUsage";
+                    };
+                    readonly description: "One entry per member who holds or has reserved storage in the room, or holds an override. Not a roster: a member who has never added a file does not appear, because the host has never been told about them.";
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly description: "Present exactly when more entries 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 ScopeLimits: {
+            readonly title: "ScopeLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+            readonly properties: {
+                readonly maxFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                };
+                readonly maxFileBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                };
+                readonly maxBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                };
+            };
+        };
+        readonly Usage: {
+            readonly title: "Usage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["files", "bytes", "reservedBytes"];
+            readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+            readonly properties: {
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Committed blobs that are not orphaned.";
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                };
+                readonly reservedFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                };
+            };
+        };
+        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. A host MUST bind the presenter to the chain's leaf. A chain that verifies is evidence that authority was conferred on somebody; it is not evidence that the party presenting it is that somebody. The leaf's subject MUST equal the party the host authenticated for this request — an identity the transport established or a document `proof` proved, never one named in a payload. A host that omits this check authorizes every captured presentation, and the omission is silent, because the chain still verifies.";
+            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 MemberUsage: {
+            readonly title: "MemberUsage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["member", "usage", "limits"];
+            readonly properties: {
+                readonly member: {
+                    readonly type: "string";
+                    readonly pattern: "^did:[a-z0-9]+:.+$";
+                    readonly maxLength: 2048;
+                    readonly description: "The member's DID: the subject at the room end of the chains they presented when uploading. Uploads by a member's agents are counted here, under the member.";
+                };
+                readonly usage: {
+                    readonly $ref: "#/$defs/Usage";
+                };
+                readonly limits: {
+                    readonly $ref: "#/$defs/ScopeLimits";
+                    readonly description: "The limits that apply to this member in this room: their override if one is set, else the room's per-member default.";
+                };
+                readonly overridden: {
+                    readonly type: "boolean";
+                    readonly description: "True when `limits` is an override set for this member rather than the room's default.";
+                };
+                readonly lastUploadAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When this member last committed a blob in the room.";
+                };
+            };
+        };
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Rooms Usage — response payload";
+            readonly description: "Success response to rooms/usage. Type https://trusttasks.org/spec/rooms/usage/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["roomId", "members"];
+            readonly properties: {
+                readonly roomId: {
+                    readonly type: "string";
+                    readonly description: "The room this describes.";
+                };
+                readonly members: {
+                    readonly type: "array";
+                    readonly maxItems: 500;
+                    readonly items: {
+                        readonly $ref: "#/$defs/MemberUsage";
+                    };
+                    readonly description: "One entry per member who holds or has reserved storage in the room, or holds an override. Not a roster: a member who has never added a file does not appear, because the host has never been told about them.";
+                };
+                readonly nextCursor: {
+                    readonly type: "string";
+                    readonly maxLength: 512;
+                    readonly description: "Present exactly when more entries 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 ScopeLimits: {
+            readonly title: "ScopeLimits";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+            readonly properties: {
+                readonly maxFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                };
+                readonly maxFileBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly maximum: 1073741824;
+                    readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                };
+                readonly maxBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                };
+            };
+        };
+        readonly Usage: {
+            readonly title: "Usage";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["files", "bytes", "reservedBytes"];
+            readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+            readonly properties: {
+                readonly files: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Committed blobs that are not orphaned.";
+                };
+                readonly bytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                };
+                readonly reservedBytes: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                };
+                readonly reservedFiles: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                };
+            };
+        };
+        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. A host MUST bind the presenter to the chain's leaf. A chain that verifies is evidence that authority was conferred on somebody; it is not evidence that the party presenting it is that somebody. The leaf's subject MUST equal the party the host authenticated for this request — an identity the transport established or a document `proof` proved, never one named in a payload. A host that omits this check authorizes every captured presentation, and the omission is silent, because the chain still verifies.";
+            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/usage/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/rooms/usage/0.1";
+        readonly title: "Rooms Usage — payload";
+        readonly description: "A room's owner reads how much each member who has added files is using, against their allowance. Authorized by the room's own credentials: a chain conferring `admin` at the room's scope.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["roomId", "presentation"];
+        readonly properties: {
+            readonly roomId: {
+                readonly type: "string";
+                readonly description: "The room's identifier. The host verifies the presentation against credentials issued by this identifier.";
+            };
+            readonly presentation: {
+                readonly $ref: "#/$defs/AuthorityPresentation";
+                readonly description: "Must confer the `admin` action at this room's scope.";
+            };
+            readonly cursor: {
+                readonly type: "string";
+                readonly maxLength: 512;
+                readonly description: "Opaque continuation from a previous response's `nextCursor`. Omit for the first page.";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 500;
+                readonly description: "Most entries to return. The host chooses when omitted, and may return fewer.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+                readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1.";
+            };
+        };
+        readonly $defs: {
+            readonly MemberUsage: {
+                readonly title: "MemberUsage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["member", "usage", "limits"];
+                readonly properties: {
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:[a-z0-9]+:.+$";
+                        readonly maxLength: 2048;
+                        readonly description: "The member's DID: the subject at the room end of the chains they presented when uploading. Uploads by a member's agents are counted here, under the member.";
+                    };
+                    readonly usage: {
+                        readonly $ref: "#/$defs/Usage";
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "The limits that apply to this member in this room: their override if one is set, else the room's per-member default.";
+                    };
+                    readonly overridden: {
+                        readonly type: "boolean";
+                        readonly description: "True when `limits` is an override set for this member rather than the room's default.";
+                    };
+                    readonly lastUploadAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When this member last committed a blob in the room.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Rooms Usage — response payload";
+                readonly description: "Success response to rooms/usage. Type https://trusttasks.org/spec/rooms/usage/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "members"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly description: "The room this describes.";
+                    };
+                    readonly members: {
+                        readonly type: "array";
+                        readonly maxItems: 500;
+                        readonly items: {
+                            readonly $ref: "#/$defs/MemberUsage";
+                        };
+                        readonly description: "One entry per member who holds or has reserved storage in the room, or holds an override. Not a roster: a member who has never added a file does not appear, because the host has never been told about them.";
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 512;
+                        readonly description: "Present exactly when more entries 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 ScopeLimits: {
+                readonly title: "ScopeLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+                readonly properties: {
+                    readonly maxFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                    };
+                    readonly maxFileBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                    };
+                    readonly maxBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                    };
+                };
+            };
+            readonly Usage: {
+                readonly title: "Usage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["files", "bytes", "reservedBytes"];
+                readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+                readonly properties: {
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Committed blobs that are not orphaned.";
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                    };
+                    readonly reservedFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                    };
+                };
+            };
+            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. A host MUST bind the presenter to the chain's leaf. A chain that verifies is evidence that authority was conferred on somebody; it is not evidence that the party presenting it is that somebody. The leaf's subject MUST equal the party the host authenticated for this request — an identity the transport established or a document `proof` proved, never one named in a payload. A host that omits this check authorizes every captured presentation, and the omission is silent, because the chain still verifies.";
+                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/usage/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly MemberUsage: {
+                readonly title: "MemberUsage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["member", "usage", "limits"];
+                readonly properties: {
+                    readonly member: {
+                        readonly type: "string";
+                        readonly pattern: "^did:[a-z0-9]+:.+$";
+                        readonly maxLength: 2048;
+                        readonly description: "The member's DID: the subject at the room end of the chains they presented when uploading. Uploads by a member's agents are counted here, under the member.";
+                    };
+                    readonly usage: {
+                        readonly $ref: "#/$defs/Usage";
+                    };
+                    readonly limits: {
+                        readonly $ref: "#/$defs/ScopeLimits";
+                        readonly description: "The limits that apply to this member in this room: their override if one is set, else the room's per-member default.";
+                    };
+                    readonly overridden: {
+                        readonly type: "boolean";
+                        readonly description: "True when `limits` is an override set for this member rather than the room's default.";
+                    };
+                    readonly lastUploadAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When this member last committed a blob in the room.";
+                    };
+                };
+            };
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Rooms Usage — response payload";
+                readonly description: "Success response to rooms/usage. Type https://trusttasks.org/spec/rooms/usage/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["roomId", "members"];
+                readonly properties: {
+                    readonly roomId: {
+                        readonly type: "string";
+                        readonly description: "The room this describes.";
+                    };
+                    readonly members: {
+                        readonly type: "array";
+                        readonly maxItems: 500;
+                        readonly items: {
+                            readonly $ref: "#/$defs/MemberUsage";
+                        };
+                        readonly description: "One entry per member who holds or has reserved storage in the room, or holds an override. Not a roster: a member who has never added a file does not appear, because the host has never been told about them.";
+                    };
+                    readonly nextCursor: {
+                        readonly type: "string";
+                        readonly maxLength: 512;
+                        readonly description: "Present exactly when more entries 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 ScopeLimits: {
+                readonly title: "ScopeLimits";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Limits at one scope. Every member is optional: an absent member means the scope sets no limit of that kind, and the next wider scope's limit, or the host's ceiling, governs. All sizes are ciphertext bytes.";
+                readonly properties: {
+                    readonly maxFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The number of committed blobs the scope may hold. 0 refuses every upload at this scope.";
+                    };
+                    readonly maxFileBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly maximum: 1073741824;
+                        readonly description: "The largest single blob the scope accepts. Never above 1 GiB, the transfer ceiling (BlobManifest).";
+                    };
+                    readonly maxBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "The total size of the committed and reserved blobs the scope may hold.";
+                    };
+                };
+            };
+            readonly Usage: {
+                readonly title: "Usage";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["files", "bytes", "reservedBytes"];
+                readonly description: "What one scope holds now. Ciphertext bytes throughout.";
+                readonly properties: {
+                    readonly files: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Committed blobs that are not orphaned.";
+                    };
+                    readonly bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Their total size. A blob stops counting the moment it is orphaned (its last record dropped it or was retracted), not when the host finally deletes it, so a member who deletes a file has the room back at once.";
+                    };
+                    readonly reservedBytes: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Bytes reserved by uploads begun and not yet committed, aborted or expired. Counted against `maxBytes`, so two concurrent uploads cannot both fit under a limit only one of them fits.";
+                    };
+                    readonly reservedFiles: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Uploads begun and not yet committed, aborted or expired. Counted against `maxFiles`.";
+                    };
+                };
+            };
+            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. A host MUST bind the presenter to the chain's leaf. A chain that verifies is evidence that authority was conferred on somebody; it is not evidence that the party presenting it is that somebody. The leaf's subject MUST equal the party the host authenticated for this request — an identity the transport established or a document `proof` proved, never one named in a payload. A host that omits this check authorizes every captured presentation, and the omission is silent, because the chain still verifies.";
+                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