@openvtc/trust-tasks 0.2.54 → 0.2.56

package/src/vtc/members/rotate/0.1/payload.ts

@@ -26,9 +26,28 @@ export interface VTCMembersRotatePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersRotateResponsePayload {
+  newDid: string;
+  method: "did:key" | "did:webvh";
+  /**
+   * Membership credential re-issued to the new DID (opaque here).
+   */
+  vmc: {};
+  /**
+   * Role credential re-issued to the new DID (opaque here).
+   */
+  roleVec: {};
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/rotate/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersRotatePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/rotate/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersRotateResponsePayload;

package/src/vtc/members/rotate-challenge/0.1/payload.ts

@@ -16,9 +16,31 @@ export interface VTCMembersRotateChallengePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersRotateChallengeResponsePayload {
+  /**
+   * A UUID identifying this rotation ceremony.
+   */
+  rotationId: string;
+  expiresAt: string;
+  /**
+   * Hex bytes the member signs with both the old and new keys to prove control of each.
+   */
+  signingPayloadHex: string;
+  /**
+   * The canonical rotation template the signatures cover (opaque here).
+   */
+  canonicalTemplate: {};
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/rotate-challenge/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersRotateChallengePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/rotate-challenge/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersRotateChallengeResponsePayload;

package/src/vtc/members/self-remove/0.1/payload.ts

@@ -16,9 +16,27 @@ export interface VTCMembersSelfRemovePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersSelfRemoveResponsePayload {
+  /**
+   * The removed member (the caller).
+   */
+  did: string;
+  /**
+   * The disposition actually applied (policydefault resolved to a concrete one).
+   */
+  disposition: "purge" | "tombstone" | "historical";
+  removed: boolean;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/self-remove/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersSelfRemovePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/self-remove/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersSelfRemoveResponsePayload;

package/src/vtc/members/self-remove-receipt/0.1/payload.ts

@@ -24,9 +24,22 @@ export interface VTCMembersSelfRemoveReceiptPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersSelfRemoveReceiptResponsePayload {
+  /**
+   * The member received the receipt.
+   */
+  acknowledged: boolean;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/self-remove-receipt/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersSelfRemoveReceiptPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/self-remove-receipt/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersSelfRemoveReceiptResponsePayload;

package/src/vtc/members/show/0.1/payload.ts

@@ -16,9 +16,61 @@ export interface VTCMembersShowPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersShowResponsePayload {
+  member: MemberResponse;
+  ext?: Ext;
+}
+/**
+ * One community member as the maintainer sees it: the membership record joined with its ACL role.
+ */
+export interface MemberResponse {
+  /**
+   * The member's DID.
+   */
+  did: string;
+  /**
+   * The member's role in wire form (e.g. `admin`, `moderator`, `custom:editor`).
+   */
+  role: string;
+  /**
+   * Optional human-readable label.
+   */
+  label?: string | null;
+  joinedAt: string;
+  /**
+   * Whether the member consented to being published in the community directory.
+   */
+  publishConsent: boolean;
+  /**
+   * How the member's record is handled on departure.
+   */
+  departurePreference: "purge" | "tombstone" | "historical" | "policydefault";
+  /**
+   * The member's slot on the community's membership status list, when allocated.
+   */
+  statusListIndex?: number | null;
+  /**
+   * Id of the member's current Verifiable Membership Credential, if issued.
+   */
+  currentVmcId?: string | null;
+  /**
+   * Id of the member's current role Verifiable Endorsement Credential, if issued.
+   */
+  currentRoleVecId?: string | null;
+  /**
+   * Opaque community-defined extension bag. Keys are maintainer-defined; the maintainer caps its size (16 KiB in the reference implementation).
+   */
+  extensions: {};
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/show/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersShowPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/show/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersShowResponsePayload;

package/src/vtc/members/solicit-vmc/0.1/payload.ts

@@ -20,9 +20,30 @@ export interface VTCMembersSolicitVMCPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersSolicitVMCResponsePayload {
+  /**
+   * The member the request was dispatched to.
+   */
+  memberDid: string;
+  /**
+   * The request was DISPATCHED. Not a delivery or reply receipt.
+   */
+  requested: boolean;
+  /**
+   * Correlates the member's eventual vtc/members/vmc delivery with this solicitation.
+   */
+  threadId: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/solicit-vmc/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersSolicitVMCPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/solicit-vmc/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersSolicitVMCResponsePayload;

package/src/vtc/members/update/0.1/payload.ts

@@ -29,9 +29,61 @@ export interface VTCMembersUpdatePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersUpdateResponsePayload {
+  member: MemberResponse;
+  ext?: Ext;
+}
+/**
+ * One community member as the maintainer sees it: the membership record joined with its ACL role.
+ */
+export interface MemberResponse {
+  /**
+   * The member's DID.
+   */
+  did: string;
+  /**
+   * The member's role in wire form (e.g. `admin`, `moderator`, `custom:editor`).
+   */
+  role: string;
+  /**
+   * Optional human-readable label.
+   */
+  label?: string | null;
+  joinedAt: string;
+  /**
+   * Whether the member consented to being published in the community directory.
+   */
+  publishConsent: boolean;
+  /**
+   * How the member's record is handled on departure.
+   */
+  departurePreference: "purge" | "tombstone" | "historical" | "policydefault";
+  /**
+   * The member's slot on the community's membership status list, when allocated.
+   */
+  statusListIndex?: number | null;
+  /**
+   * Id of the member's current Verifiable Membership Credential, if issued.
+   */
+  currentVmcId?: string | null;
+  /**
+   * Id of the member's current role Verifiable Endorsement Credential, if issued.
+   */
+  currentRoleVecId?: string | null;
+  /**
+   * Opaque community-defined extension bag. Keys are maintainer-defined; the maintainer caps its size (16 KiB in the reference implementation).
+   */
+  extensions: {};
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/update/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersUpdatePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/update/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersUpdateResponsePayload;

package/src/vtc/members/vmc/0.1/payload.ts

@@ -20,9 +20,34 @@ export interface VTCMembersDeliverVMCPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCMembersDeliverVMCReceiptPayload {
+  /**
+   * The delivering member, as proven by the transport.
+   */
+  memberDid: string;
+  /**
+   * Identifier of the stored credential.
+   */
+  vmcId: string;
+  /**
+   * Terminal state of the delivery.
+   */
+  status: "stored";
+  /**
+   * Echoed when the delivery also closed a join request (the request payload carried `requestId`).
+   */
+  requestId?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/vmc/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersDeliverVMCPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/members/vmc/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCMembersDeliverVMCReceiptPayload;

package/src/vtc/policies/test/0.1/payload.ts

@@ -26,9 +26,36 @@ export interface VTCPoliciesTestPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCPoliciesTestResponsePayload {
+  /**
+   * The evaluated module's identifier.
+   */
+  id: string;
+  /**
+   * Governance purpose the module is classified under.
+   */
+  purpose: string;
+  /**
+   * Digest of the evaluated module, so a caller can confirm which bytes ran.
+   */
+  sha256: string;
+  /**
+   * Raw result of the queried rule, uninterpreted. May be any JSON value, including absent-as-null.
+   */
+  result: {
+    [k: string]: unknown | undefined;
+  };
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/policies/test/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCPoliciesTestPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/policies/test/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCPoliciesTestResponsePayload;

package/src/vtc/recognition/check/0.1/payload.ts

@@ -16,9 +16,34 @@ export interface VTCRecognitionCheckPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRecognitionCheckResponsePayload {
+  /**
+   * The probed DID, echoed.
+   */
+  did: string;
+  /**
+   * Whether the community recognises this DID. Meaningless unless registryConfigured is true.
+   */
+  recognised: boolean;
+  /**
+   * Whether a trust registry backs the answer. False makes `recognised` indeterminate, not negative.
+   */
+  registryConfigured: boolean;
+  /**
+   * Lookup failure detail — a configured but unreachable registry, distinct from an unconfigured one.
+   */
+  error?: string | null;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/recognition/check/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRecognitionCheckPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/recognition/check/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRecognitionCheckResponsePayload;

package/src/vtc/registry/diagnostics/0.1/payload.ts

@@ -12,9 +12,44 @@ export interface VTCRegistryDiagnosticsPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRegistryDiagnosticsResponsePayload {
+  /**
+   * Trust-registry reachability.
+   */
+  registryStatus: "active" | "degraded";
+  /**
+   * Pending + in-flight sync jobs.
+   */
+  queueDepth: number;
+  /**
+   * Pending jobs parked behind the RTBF batch window.
+   */
+  rtbfBatchedCount: number;
+  /**
+   * Terminal-failure rows awaiting operator triage.
+   */
+  failedCount: number;
+  /**
+   * Seconds since the oldest dispatchable pending job; null when the queue is empty.
+   */
+  oldestPendingAgeSeconds?: number | null;
+  lastSuccessAt?: string | null;
+  lastFailureAt?: string | null;
+  /**
+   * Error from the last registry failure. May include upstream URLs/codes — treat as potentially sensitive.
+   */
+  lastError?: string | null;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/registry/diagnostics/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRegistryDiagnosticsPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/registry/diagnostics/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRegistryDiagnosticsResponsePayload;

package/src/vtc/relationships/graph/0.1/payload.ts

@@ -12,9 +12,50 @@ export interface VTCRelationshipsGraphPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRelationshipsGraphResponsePayload {
+  /**
+   * One per distinct DID appearing in a live edge. No isolated nodes.
+   */
+  nodes: GraphNode[];
+  /**
+   * One per unrevoked relationship credential, directed issuer -> subject.
+   */
+  edges: GraphEdge[];
+  ext?: Ext;
+}
+export interface GraphNode {
+  /**
+   * A DID participating in at least one live relationship.
+   */
+  did: string;
+}
+export interface GraphEdge {
+  /**
+   * Relationship credential identifier.
+   */
+  id: string;
+  /**
+   * The vouching party.
+   */
+  issuerDid: string;
+  /**
+   * The vouched-for party.
+   */
+  subjectDid: string;
+  /**
+   * When the relationship was published.
+   */
+  createdAt: string;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/graph/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRelationshipsGraphPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/graph/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRelationshipsGraphResponsePayload;

package/src/vtc/relationships/list/0.1/payload.ts

@@ -18,9 +18,31 @@ export interface VTCRelationshipsListPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRelationshipsListResponsePayload {
+  items: {
+    id: string;
+    issuerDid: string;
+    subjectDid: string;
+    /**
+     * The relationship credential as JSON-LD (opaque here).
+     */
+    vrcJsonld: {};
+    vrcSha256: string;
+    createdAt: string;
+  }[];
+  nextCursor?: string | null;
+  totalEstimate?: number | null;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/list/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRelationshipsListPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/list/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRelationshipsListResponsePayload;

package/src/vtc/relationships/publish/0.1/payload.ts

@@ -16,9 +16,28 @@ export interface VTCRelationshipsPublishPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRelationshipsPublishResponsePayload {
+  /**
+   * Id assigned to the stored relationship (a UUID).
+   */
+  id: string;
+  issuerDid: string;
+  subjectDid: string;
+  /**
+   * SHA-256 of the stored VRC, for out-of-band integrity checks.
+   */
+  vrcSha256: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/publish/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRelationshipsPublishPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/publish/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRelationshipsPublishResponsePayload;

package/src/vtc/relationships/revoke/0.1/payload.ts

@@ -16,9 +16,19 @@ export interface VTCRelationshipsRevokePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCRelationshipsRevokeResponsePayload {
+  id: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/revoke/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCRelationshipsRevokePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/relationships/revoke/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCRelationshipsRevokeResponsePayload;

package/src/vtc/website/files/delete/0.1/payload.ts

@@ -16,9 +16,20 @@ export interface VTCWebsiteFilesDeletePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCWebsiteFilesDeleteResponsePayload {
+  path: string;
+  deleted: boolean;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/website/files/delete/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCWebsiteFilesDeletePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/website/files/delete/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCWebsiteFilesDeleteResponsePayload;

package/src/vtc/website/files/list/0.1/payload.ts

@@ -20,9 +20,33 @@ export interface VTCWebsiteFilesListPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCWebsiteFilesListResponsePayload {
+  /**
+   * Files under the site root, excluding hidden files and blocklisted extensions.
+   */
+  items: {
+    /**
+     * Path relative to the site root.
+     */
+    path: string;
+    /**
+     * File size in bytes.
+     */
+    size: number;
+    modifiedAt?: string;
+  }[];
+  nextCursor?: string | null;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/website/files/list/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCWebsiteFilesListPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/website/files/list/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCWebsiteFilesListResponsePayload;

package/src/vtc/website/generations/list/0.1/payload.ts

@@ -12,9 +12,28 @@ export interface VTCWebsiteGenerationsListPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCWebsiteGenerationsListResponsePayload {
+  generations: {
+    /**
+     * Generation label (e.g. gen-5).
+     */
+    generation: string;
+    /**
+     * True for the generation current resolves to.
+     */
+    current: boolean;
+  }[];
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/website/generations/list/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCWebsiteGenerationsListPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/website/generations/list/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCWebsiteGenerationsListResponsePayload;

package/src/vtc/website/rollback/0.1/payload.ts

@@ -16,9 +16,27 @@ export interface VTCWebsiteRollbackPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VTCWebsiteRollbackResponsePayload {
+  generation: string;
+  /**
+   * True once this generation is the active one.
+   */
+  current: boolean;
+  /**
+   * True when the requested generation was already current — nothing changed.
+   */
+  noop: boolean;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vtc/website/rollback/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCWebsiteRollbackPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vtc/website/rollback/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCWebsiteRollbackResponsePayload;