@openvtc/trust-tasks 0.28.17 → 0.28.19

package/src/_shared/components.ts

@@ -419,12 +419,48 @@ export type AuthModel =
  * An explicit authority scope — used for both the act scope and the approve scope of an entry. Exactly one of three shapes, discriminated by `scope`: `all`, `none`, or `contexts` with a NON-EMPTY list. The empty list is not a fourth shape: it is invalid, so a serializer that drops or empties the list produces a document that fails validation rather than one that silently means something else.
  */
 export type AuthorityScope = AuthorityScopeAll | AuthorityScopeNone | AuthorityScopeContexts;
+/**
+ * Opaque identifier of one giving of a badge to one member: `awd_` followed by 16 to 64 base64url characters. Random and unique within the community.
+ */
+export type AwardId = string;
+/**
+ * What the award is for, from the giver, shown to the recipient and written as the award's evidence narrative where the badge carries a credential. Plain text; erased with its author (VTI-BDG-090).
+ */
+export type AwardNote = string;
+/**
+ * `offered`: waiting for the recipient. `accepted`: the recipient took it; for a community badge the credential was issued and the membership recorded. `declined`: the recipient declined; nothing was recorded in the group and nothing issued. `withdrawn`: the giver withdrew the offer before a decision. `expired`: the offer lapsed unanswered. `revoked`: taken back after acceptance (VTI-BDG-023).
+ */
+export type AwardState = "offered" | "accepted" | "declined" | "withdrawn" | "expired" | "revoked";
 export type AwsArn = string;
 export type AwsRegion = string;
 /**
  * The ARN of an AWS IAM role, in any AWS partition (`arn:aws:`, `arn:aws-cn:`, `arn:aws-us-gov:`). Validated here because the community passes it to STS AssumeRole and derives the partition of the session policy's resources from it; it must never carry anything but a role ARN.
  */
 export type AwsRoleArn = string;
+/**
+ * How the badge is earned, shown to members and written into the credential's Achievement as its criteria narrative. Plain text.
+ */
+export type BadgeCriteria = string;
+/**
+ * What the badge is for. Plain text; a reader MUST NOT treat it as instructions.
+ */
+export type BadgeDescription = string;
+/**
+ * Opaque identifier of a badge: `bdg_` followed by 16 to 64 base64url characters. Random, community-scoped, never reused (VTI-BDG-001).
+ */
+export type BadgeId = string;
+/**
+ * `community`: defined by holders of `vtc.badges.admin`, given by its owners (its badge group's managers), may carry a credential. `kudos`: made by a member the community's badge settings admit, given by any active member to any other, never a credential. Fixed for the badge's life; a kudos badge becomes a community badge only by promotion (vtc/badges/promote).
+ */
+export type BadgeKind = "community" | "kudos";
+/**
+ * The badge's name, shown on the wall and written into the credential's Achievement. Plain text; a reader MUST NOT treat it as instructions.
+ */
+export type BadgeName = string;
+/**
+ * `active`: may be given and shown. `retired`: kept for its holders' own history, never given, never shown to members who do not hold it (VTI-BDG-005).
+ */
+export type BadgeState = "active" | "retired";
 export type BindingId = string;
 export type BindingSpec = RoomBindingSpec | GrantsBindingSpec | RoleBindingSpec;
 /**
@@ -1274,7 +1310,7 @@ export type NamespaceId = string;
  */
 export type NodeKind = "network" | "community";
 /**
- * Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, the VTA's operator has not enabled collection by default (VTI-NTF-093), so the VTA collects for no identifier a client has not claimed.
+ * Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, collection by default is disabled for the identifier's trust context — by the context's own setting, or because the VTA's operator has suspended it for every context — so the VTA collects for no identifier there that a client has not claimed (VTI-NTF-097, VTI-NTF-098); vta/collection/settings/show says which.
  */
 export type NotCollectedReason = "limit" | "conflict" | "disabled";
 /**
@@ -2513,6 +2549,10 @@ export type Vid = string;
  * How much of a room its host can see, fixed at creation and immutable thereafter. `open`: records are cleartext, searchable and fully audited. `attributed`: record content is sealed, and the host still learns which member acted. `private`: content is sealed and membership is presented in zero knowledge, so the host verifies that a member acted without learning which. Immutable because a downgrade cannot un-see cleartext and an upgrade would protect only what came after while presenting as though it protected everything.
  */
 export type Visibility = "open" | "attributed" | "private";
+/**
+ * Who sees a member's badges, the member's own setting (VTI-BDG-031). `members`: every active member the directory shows their card to. `nobody`: no one but the member. Never wider than the directory shows the card.
+ */
+export type WallVisibility = "members" | "nobody";
 /**
  * A file's content hash: the lowercase hex SHA-256 of its bytes — the `etag` vtc/website/files/list reports, and the `ETag` a direct read of the path returns, without the HTTP quotes.
  */
@@ -5916,6 +5956,31 @@ export interface AutoGrantSweep {
    */
   errors: number;
 }
+/**
+ * One giving of a badge to one member. `givenBy` is the giver's directory entry, absent for an award a dynamic badge group's rule made. `note` is shown to the recipient, the giver, the badge's owners and administrators, never to other members. `credentialId` is present on an accepted award of a community badge: the badge credential that evidences it, renewed or re-issued as the badge's regime requires.
+ */
+export interface Award {
+  awardId: AwardId;
+  badgeId: BadgeId;
+  /**
+   * The recipient.
+   */
+  entryId: EntryId;
+  givenBy?: EntryId;
+  note?: AwardNote;
+  state: AwardState;
+  offeredAt: string;
+  /**
+   * When the recipient accepted or declined, the giver withdrew, the offer expired, or the award was revoked.
+   */
+  decidedAt?: string;
+  /**
+   * When an unanswered offer lapses, where the community expires offers.
+   */
+  expiresAt?: string;
+  credentialId?: GroupCredentialId;
+  ext?: Ext;
+}
 /**
  * Unencrypted metadata plus the encrypted payload. The KDF and cipher parameters travel in the clear so a reader can decrypt without knowing this specification's defaults.
  */
@@ -5951,6 +6016,108 @@ export interface BackupEnvelope {
    */
   ciphertext: string;
 }
+/**
+ * A badge as a caller who may see it sees it. `groupId` is present exactly when `kind` is `community`. `holderCount` only to callers who may see the badge's holders, counted over holders who have not hidden it (VTI-BDG-030, VTI-BDG-033). `createdBy` is the directory entry of the administrator or member who made it, where they have one.
+ */
+export interface Badge {
+  badgeId: BadgeId;
+  kind: BadgeKind;
+  name: BadgeName;
+  description: BadgeDescription;
+  criteria?: BadgeCriteria;
+  /**
+   * The badge's picture, re-encoded and stored by the community (vtc/badges/images/upload), read with vtc/badges/images/get. `url` and `urlExpiresAt` MAY appear in a projection as for a card picture; for a badge whose holders may show it outside, `url` MAY be the picture's stable public location.
+   */
+  image: CardBlobRef;
+  /**
+   * Whether one member may hold the badge more than once, each giving an award of its own (VTI-BDG-022). Always true for a kudos badge.
+   */
+  repeatable: boolean;
+  /**
+   * Community badges only. Whether a member may ask for it: a request to join its badge group, decided by its owners (VTI-BDG-014). Absent reads as false.
+   */
+  requestable?: boolean;
+  /**
+   * Whether members who do not hold the badge see it in the community's badge list. An unlisted badge is seen by its holders, its owners and administrators.
+   */
+  listed: boolean;
+  /**
+   * Community badges only. Whether its holders may show it outside the community, which decides the credential's regime: short-lived and renewed with no status when false, long-lived with a status in the community's own status set when true (VTI-BDG-061, VTI-BDG-062). Absent reads as false.
+   */
+  shareableOutside?: boolean;
+  /**
+   * The badge group that backs a community badge: its managers are the badge's owners, its members the holders, its DID the credential's issuer.
+   */
+  groupId?: GroupId;
+  state: BadgeState;
+  /**
+   * Holders who show the badge. Only to callers who may see the holders.
+   */
+  holderCount?: number;
+  createdAt: string;
+  createdBy?: EntryId;
+  updatedAt?: string;
+  retiredAt?: string;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry authority.
+   */
+  ext?: Ext;
+}
+/**
+ * The community's bounds (VTI-BDG-032, VTI-BDG-040). Each has a default a community that states none applies.
+ */
+export interface BadgeLimits {
+  /**
+   * Kudos one member may give in a day. Default 10.
+   */
+  kudosPerGiverPerDay?: number;
+  /**
+   * How often the same member may give a kudos badge to the same member: at most once a day, once a week, or without bound. Default `day`.
+   */
+  sameGiverSameMember?: "day" | "week" | "unbounded";
+  /**
+   * Days of membership before a member may give kudos or make a kudos badge. Default 7.
+   */
+  minTenureDays?: number;
+  /**
+   * Kudos badges one member may make in a calendar month. Default 5.
+   */
+  kudosBadgesPerMakerPerMonth?: number;
+  /**
+   * Badges a member may pin beside their name. Default 2.
+   */
+  maxPinned?: number;
+  /**
+   * Days an unanswered offer stands before it expires. Absent: offers do not expire.
+   */
+  offerExpiresAfterDays?: number;
+}
+/**
+ * The community's badge settings (VTI-BDG-004). `enabled` false hides every badge surface and keeps every record; nothing is given or issued while it is false.
+ */
+export interface BadgeSettings {
+  enabled: boolean;
+  kudosMakers: KudosMakers;
+  limits?: BadgeLimits;
+  /**
+   * Whether a member's kudos total is shown on their card (VTI-BDG-043).
+   */
+  showKudosTotals: boolean;
+  /**
+   * Whether dynamic badge groups are computed (VTI-BDG-013). False: a community badge may not be created on a dynamic group, and existing ones are not recomputed.
+   */
+  automaticBadges: boolean;
+  /**
+   * Whether any community badge may be marked `requestable`. False: every badge group is closed.
+   */
+  membersMayRequest: boolean;
+  /**
+   * Validity of a badge credential its holders may show outside (VTI-BDG-062). Default 730.
+   */
+  credentialValidDays?: number;
+  updatedAt?: string;
+  ext?: Ext;
+}
 /**
  * An open ballot: one answer per question of the manifest, in any order. The bytes a cast's proof binds are the RFC 8785 (JCS) canonicalization of this object as received.
  */
@@ -6735,6 +6902,31 @@ export interface CollectionEntry {
   claim?: Claim;
   notCollectedReason?: NotCollectedReason;
 }
+/**
+ * Whether the VTA collects by default for the identifiers of one trust context that no client has claimed (VTI-NTF-094 – VTI-NTF-098), and who last changed that. The VTA collects for them exactly when `collectByDefault` is true and `suspendedByOperator` is false. `changedBy` and `changedAt` are present together, and both absent while the setting has never been changed.
+ */
+export interface CollectionSetting {
+  /**
+   * The trust context the setting belongs to. It applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094).
+   */
+  contextId: ContextId_VtaCollectionV0_1;
+  /**
+   * The context's own setting: true unless a party with administrative authority over the context has disabled it (VTI-NTF-094, VTI-NTF-095). The VTA keeps it across restarts.
+   */
+  collectByDefault: boolean;
+  /**
+   * Whether the VTA's operator has suspended collection by default for every context (VTI-NTF-098). While true, the VTA collects for no unclaimed identifier here whatever `collectByDefault` says, and does not change it; once lifted, `collectByDefault` applies again. Always false at a VTA that offers its operator no suspension.
+   */
+  suspendedByOperator: boolean;
+  /**
+   * The subject of the access control entry that last changed `collectByDefault` (VTI-NTF-096).
+   */
+  changedBy?: Did_NotificationsV0_1;
+  /**
+   * When `collectByDefault` was last changed.
+   */
+  changedAt?: string;
+}
 /**
  * OPTIONAL. How the community asks to be shown to a prospective applicant: a name, an accent colour and a logo. Presentation only, self-asserted and unverified — `communityDid` identifies the community, never `branding`. Not part of any criterion, so not covered by a `requirementsDigest`. Every member is optional.
  */
@@ -9798,6 +9990,10 @@ export interface Group {
    * `true` while the group has a `grants` or `role` binding. Such a group is `static` and `closed` for as long as it does.
    */
   carriesAuthority: boolean;
+  /**
+   * Present exactly when the group backs a community badge (vtc/badges/*): its managers are the badge's owners, its members the badge's holders, and its DID issues the badge credential in place of a membership credential. A badge group never carries authority, is not counted among the groups two members share, and is listed among the community's groups only to a caller who asks for badge groups (VTI-BDG-010 – VTI-BDG-012).
+   */
+  badgeId?: BadgeId;
   /**
    * Active members. Only to callers who may see the member list.
    */
@@ -10817,6 +11013,24 @@ export interface KeyScopeListed {
 export interface KeyScopeNone {
   scope: "none";
 }
+/**
+ * Who may make a kudos badge (VTI-BDG-004). `nobody`: no kudos badges. `roles`: holders of any of `roles`, or members of any of `groups`. `members`: every active member.
+ */
+export interface KudosMakers {
+  policy: "nobody" | "roles" | "members";
+  /**
+   * Community role names. Read exactly when `policy` is `roles`.
+   *
+   * @maxItems 32
+   */
+  roles?: string[];
+  /**
+   * Read exactly when `policy` is `roles`.
+   *
+   * @maxItems 32
+   */
+  groups?: GroupId[];
+}
 /**
  * Which limits an override applies to. `room`: the room as a whole. `memberDefault`: every member of the room who has no override of their own. `member`: one named member — `member` is REQUIRED with this kind and forbidden with the others, a rule this schema does not express; a community refuses a violation with `malformedRequest`.
  */
@@ -11473,6 +11687,26 @@ export interface MonitorFilter {
    */
   failuresOnly?: boolean;
 }
+/**
+ * A badge as its holder sees it in their own list: the wall entry plus what only the holder knows — whether they hid it, their position for it, and the credential that evidences it.
+ */
+export interface MyBadge {
+  badge: Badge;
+  count: number;
+  since: string;
+  latestAt?: string;
+  pinned: boolean;
+  /**
+   * The holder hid it: off their wall, out of the badge's holder list for members, out of its count; the awards, the membership and the credential stand (VTI-BDG-030).
+   */
+  hidden: boolean;
+  /**
+   * The holder's order on their wall, lowest first.
+   */
+  position?: number;
+  credentialId?: GroupCredentialId;
+  credentialValidUntil?: string;
+}
 export interface NetworkMembership {
   /**
    * The network's DID.
@@ -16399,6 +16633,25 @@ export interface WakeTriggerPolicy {
    */
   allowedTriggers: string[];
 }
+/**
+ * One badge on a member's wall as a viewer sees it: the badge, how many times the member holds it, since when, and whether the member pinned it. Hidden badges are never wall entries (VTI-BDG-030).
+ */
+export interface WallEntry {
+  badge: Badge;
+  /**
+   * Accepted awards of this badge the member holds.
+   */
+  count: number;
+  /**
+   * When the member first accepted this badge.
+   */
+  since: string;
+  /**
+   * When the member last accepted an award of this badge.
+   */
+  latestAt?: string;
+  pinned: boolean;
+}
 export interface WalrusSettings {
   kind: "walrus";
   /**

package/src/index.ts

@@ -2394,6 +2394,12 @@ export import VtaCollectionList_v0_1 = _VtaCollectionList_v0_1;
 import * as _VtaCollectionRelease_v0_1 from "./vta/collection/release/0.1/payload.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import VtaCollectionRelease_v0_1 = _VtaCollectionRelease_v0_1;
+import * as _VtaCollectionSettingsSet_v0_1 from "./vta/collection/settings/set/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtaCollectionSettingsSet_v0_1 = _VtaCollectionSettingsSet_v0_1;
+import * as _VtaCollectionSettingsShow_v0_1 from "./vta/collection/settings/show/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtaCollectionSettingsShow_v0_1 = _VtaCollectionSettingsShow_v0_1;
 import * as _VtaContextsCreate_v1_0 from "./vta/contexts/create/1.0/payload.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import VtaContextsCreate_v1_0 = _VtaContextsCreate_v1_0;
@@ -3198,6 +3204,81 @@ export import VtcBackupExport_v0_1 = _VtcBackupExport_v0_1;
 import * as _VtcBackupImport_v0_1 from "./vtc/backup/import/0.1/payload.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import VtcBackupImport_v0_1 = _VtcBackupImport_v0_1;
+import * as _BadgeShared_v0_1 from "./vtc/badges/_shared/0.1/badge.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import BadgeShared_v0_1 = _BadgeShared_v0_1;
+import * as _VtcBadgesAwardsList_v0_1 from "./vtc/badges/awards/list/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesAwardsList_v0_1 = _VtcBadgesAwardsList_v0_1;
+import * as _VtcBadgesAwardsOffer_v0_1 from "./vtc/badges/awards/offer/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesAwardsOffer_v0_1 = _VtcBadgesAwardsOffer_v0_1;
+import * as _VtcBadgesAwardsRevoke_v0_1 from "./vtc/badges/awards/revoke/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesAwardsRevoke_v0_1 = _VtcBadgesAwardsRevoke_v0_1;
+import * as _VtcBadgesAwardsWithdraw_v0_1 from "./vtc/badges/awards/withdraw/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesAwardsWithdraw_v0_1 = _VtcBadgesAwardsWithdraw_v0_1;
+import * as _VtcBadgesCreate_v0_1 from "./vtc/badges/create/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesCreate_v0_1 = _VtcBadgesCreate_v0_1;
+import * as _VtcBadgesHoldersList_v0_1 from "./vtc/badges/holders/list/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesHoldersList_v0_1 = _VtcBadgesHoldersList_v0_1;
+import * as _VtcBadgesImagesGet_v0_1 from "./vtc/badges/images/get/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesImagesGet_v0_1 = _VtcBadgesImagesGet_v0_1;
+import * as _VtcBadgesImagesUpload_v0_1 from "./vtc/badges/images/upload/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesImagesUpload_v0_1 = _VtcBadgesImagesUpload_v0_1;
+import * as _VtcBadgesKudosGive_v0_1 from "./vtc/badges/kudos/give/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesKudosGive_v0_1 = _VtcBadgesKudosGive_v0_1;
+import * as _VtcBadgesKudosList_v0_1 from "./vtc/badges/kudos/list/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesKudosList_v0_1 = _VtcBadgesKudosList_v0_1;
+import * as _VtcBadgesList_v0_1 from "./vtc/badges/list/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesList_v0_1 = _VtcBadgesList_v0_1;
+import * as _VtcBadgesMineAccept_v0_1 from "./vtc/badges/mine/accept/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineAccept_v0_1 = _VtcBadgesMineAccept_v0_1;
+import * as _VtcBadgesMineArrange_v0_1 from "./vtc/badges/mine/arrange/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineArrange_v0_1 = _VtcBadgesMineArrange_v0_1;
+import * as _VtcBadgesMineDecline_v0_1 from "./vtc/badges/mine/decline/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineDecline_v0_1 = _VtcBadgesMineDecline_v0_1;
+import * as _VtcBadgesMineHide_v0_1 from "./vtc/badges/mine/hide/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineHide_v0_1 = _VtcBadgesMineHide_v0_1;
+import * as _VtcBadgesMineList_v0_1 from "./vtc/badges/mine/list/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineList_v0_1 = _VtcBadgesMineList_v0_1;
+import * as _VtcBadgesMineShow_v0_1 from "./vtc/badges/mine/show/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesMineShow_v0_1 = _VtcBadgesMineShow_v0_1;
+import * as _VtcBadgesPromote_v0_1 from "./vtc/badges/promote/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesPromote_v0_1 = _VtcBadgesPromote_v0_1;
+import * as _VtcBadgesRetire_v0_1 from "./vtc/badges/retire/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesRetire_v0_1 = _VtcBadgesRetire_v0_1;
+import * as _VtcBadgesSettingsShow_v0_1 from "./vtc/badges/settings/show/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesSettingsShow_v0_1 = _VtcBadgesSettingsShow_v0_1;
+import * as _VtcBadgesSettingsUpdate_v0_1 from "./vtc/badges/settings/update/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesSettingsUpdate_v0_1 = _VtcBadgesSettingsUpdate_v0_1;
+import * as _VtcBadgesShow_v0_1 from "./vtc/badges/show/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesShow_v0_1 = _VtcBadgesShow_v0_1;
+import * as _VtcBadgesUpdate_v0_1 from "./vtc/badges/update/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesUpdate_v0_1 = _VtcBadgesUpdate_v0_1;
+import * as _VtcBadgesWallShow_v0_1 from "./vtc/badges/wall/show/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtcBadgesWallShow_v0_1 = _VtcBadgesWallShow_v0_1;
 import * as _BoardShared_v0_1 from "./vtc/boards/_shared/0.1/board.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import BoardShared_v0_1 = _BoardShared_v0_1;
@@ -4317,6 +4398,12 @@ export import VtnOutboxList_v0_1 = _VtnOutboxList_v0_1;
 import * as _VtnOutboxRetry_v0_1 from "./vtn/outbox/retry/0.1/payload.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import VtnOutboxRetry_v0_1 = _VtnOutboxRetry_v0_1;
+import * as _VtnRegistryCheck_v0_1 from "./vtn/registry/check/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtnRegistryCheck_v0_1 = _VtnRegistryCheck_v0_1;
+import * as _VtnRegistryStatus_v0_1 from "./vtn/registry/status/0.1/payload.js";
+/** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
+export import VtnRegistryStatus_v0_1 = _VtnRegistryStatus_v0_1;
 import * as _VtnRelayDeliver_v0_1 from "./vtn/relay/deliver/0.1/payload.js";
 /** @deprecated The prebuilt specification modules will be removed: pin the tasks you use with the `trust-tasks` CLI, generate them with `@openvtc/trust-tasks-gen`, and import the runtime from `@openvtc/trust-tasks/runtime` (GETTING-STARTED.md). */
 export import VtnRelayDeliver_v0_1 = _VtnRelayDeliver_v0_1;

package/src/vta/collection/_shared/0.1/collection.ts

@@ -4,7 +4,7 @@
  */
 
 /**
- * Shared shapes for the collection of messages for a principal's identifiers. A VTA collects, from the mediator each identifier's DID document advertises, the messages queued for every identifier whose messaging keys it holds in one of the principal's trust contexts — its personas — unless a client of the principal holds a collection claim for it: a lease, granted by vta/collection/claim and ended by vta/collection/release or at its end, under which that client is the identifier's one collector. The mediator permits one connection per identifier, so at most one party collects for an identifier at a time (VTI-NTF-080 – VTI-NTF-092).
+ * Shared shapes for the collection of messages for a principal's identifiers. A VTA collects, from the mediator each identifier's DID document advertises, the messages queued for every identifier whose messaging keys it holds in one of the principal's trust contexts — its personas — unless a client of the principal holds a collection claim for it: a lease, granted by vta/collection/claim and ended by vta/collection/release or at its end, under which that client is the identifier's one collector. The mediator permits one connection per identifier, so at most one party collects for an identifier at a time (VTI-NTF-080 – VTI-NTF-092). Whether the VTA collects by default for the unclaimed identifiers of a trust context is that context's own setting, enabled unless a context administrator disables it with vta/collection/settings/set (VTI-NTF-094 – VTI-NTF-098).
  */
 export interface VTACollectionSharedDefinitions {
   [k: string]: unknown | undefined;
@@ -14,4 +14,4 @@ export interface VTACollectionSharedDefinitions {
  * The definitions this shared schema publishes, hoisted to one declaration each.
  * See "../../../../_shared/components.js".
  */
-export type { Claim, CollectionEntry, Collector, ContextId_VtaCollectionV0_1 as ContextId, Did_NotificationsV0_1 as Did, NotCollectedReason } from "../../../../_shared/components.js";
+export type { Claim, CollectionEntry, CollectionSetting, Collector, ContextId_VtaCollectionV0_1 as ContextId, Did_NotificationsV0_1 as Did, NotCollectedReason } from "../../../../_shared/components.js";

package/src/vta/collection/list/0.1/payload.ts

@@ -220,7 +220,7 @@ export const PAYLOAD_SCHEMA = {
     },
     "NotCollectedReason": {
       "title": "NotCollectedReason",
-      "description": "Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, the VTA's operator has not enabled collection by default (VTI-NTF-093), so the VTA collects for no identifier a client has not claimed.",
+      "description": "Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, collection by default is disabled for the identifier's trust context — by the context's own setting, or because the VTA's operator has suspended it for every context — so the VTA collects for no identifier there that a client has not claimed (VTI-NTF-097, VTI-NTF-098); vta/collection/settings/show says which.",
       "type": "string",
       "enum": [
         "limit",
@@ -398,7 +398,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
     },
     "NotCollectedReason": {
       "title": "NotCollectedReason",
-      "description": "Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, the VTA's operator has not enabled collection by default (VTI-NTF-093), so the VTA collects for no identifier a client has not claimed.",
+      "description": "Why nobody collects for an identifier the VTA would otherwise collect for: `limit`, the VTA is at the bound it states on the number of identifiers it collects for (VTI-NTF-088); `conflict`, another connection for the identifier kept closing the VTA's, and the VTA stopped after the bound it states until the conflict is resolved (VTI-NTF-085). `disabled`, collection by default is disabled for the identifier's trust context — by the context's own setting, or because the VTA's operator has suspended it for every context — so the VTA collects for no identifier there that a client has not claimed (VTI-NTF-097, VTI-NTF-098); vta/collection/settings/show says which.",
       "type": "string",
       "enum": [
         "limit",