@openvtc/trust-tasks 0.2.55 → 0.2.57

package/src/push/wake/0.1/payload.ts

@@ -35,9 +35,22 @@ export interface PushWakePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushWakeResponsePayload {
+  /**
+   * Outcome of the wake: `delivered` (push service accepted) or `token-unregistered` (dead token; handle dropped — see push/wake:token_unregistered).
+   */
+  status: "delivered" | "token-unregistered";
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/wake/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushWakePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/wake/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushWakeResponsePayload;

package/src/push/wake/0.2/payload.ts

@@ -35,9 +35,22 @@ export interface PushWakePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushWakeResponsePayload {
+  /**
+   * Outcome of the wake: `delivered` (push service accepted) or `tokenUnregistered` (dead token; handle dropped — see push/wake:token_unregistered).
+   */
+  status: "delivered" | "tokenUnregistered";
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/wake/0.2" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushWakePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/wake/0.2#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushWakeResponsePayload;

package/src/registry/authorization/0.1/payload.ts

@@ -46,9 +46,39 @@ export interface QueryContext {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryAuthorizationResponsePayload {
+  entity_id: string;
+  authority_id: string;
+  action: string;
+  resource: string;
+  /**
+   * True if the action+resource authorization has been confirmed, false otherwise.
+   */
+  authorized: boolean;
+  /**
+   * Server time the query was evaluated at, per the endpoint clock.
+   */
+  time_evaluated: string;
+  /**
+   * The requested server time, echoed from the request `context.time` when supplied.
+   */
+  time_requested?: string;
+  /**
+   * Additional human-readable detail about the authorization response.
+   */
+  message?: string;
+  context?: QueryContext;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/authorization/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RegistryAuthorizationPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/authorization/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryAuthorizationResponsePayload;

package/src/registry/did/rotate/0.1/payload.ts

@@ -23,9 +23,30 @@ export interface RegistryDIDRotatePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryDIDRotateResponsePayload {
+  /**
+   * The DID whose keys were rotated.
+   */
+  did: string;
+  /**
+   * The DID's SCID after rotation.
+   */
+  new_scid: string;
+  /**
+   * The did:webvh log's new versionId after rotation.
+   */
+  new_version_id: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/did/rotate/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RegistryDIDRotatePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/did/rotate/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryDIDRotateResponsePayload;

package/src/registry/recognition/0.1/payload.ts

@@ -46,9 +46,39 @@ export interface QueryContext {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecognitionResponsePayload {
+  entity_id: string;
+  authority_id: string;
+  action: string;
+  resource: string;
+  /**
+   * True if the action+resource has been recognised, false otherwise.
+   */
+  recognized: boolean;
+  /**
+   * Server time the query was evaluated at, per the endpoint clock.
+   */
+  time_evaluated: string;
+  /**
+   * The requested server time, echoed from the request `context.time` when supplied.
+   */
+  time_requested?: string;
+  /**
+   * Additional human-readable detail about the recognition response.
+   */
+  message?: string;
+  context?: QueryContext;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/recognition/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RegistryRecognitionPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/recognition/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecognitionResponsePayload;

package/src/registry/record/create/0.1/payload.ts

@@ -42,9 +42,26 @@ export interface TrustRecord {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordCreateResponsePayload {
+  /**
+   * Whether the record was created.
+   */
+  ok: boolean;
+  /**
+   * Optional human-readable detail.
+   */
+  message?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/create/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/create/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordCreateResponsePayload;

package/src/registry/record/delete/0.1/payload.ts

@@ -19,9 +19,26 @@ export interface RegistryRecordDeletePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordDeleteResponsePayload {
+  /**
+   * Whether the record was deleted.
+   */
+  ok: boolean;
+  /**
+   * Optional human-readable detail.
+   */
+  message?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/delete/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RegistryRecordDeletePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/delete/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordDeleteResponsePayload;

package/src/registry/record/list/0.1/payload.ts

@@ -3,6 +3,11 @@
  * Source: specs/registry/record/list/0.1/payload.schema.json
  */
 
+/**
+ * Whether the record asserts an authorization or a recognition relationship.
+ */
+export type RecordType = "authorization" | "recognition";
+
 /**
  * An administrator lists all trust records held by the registry.
  */
@@ -15,9 +20,43 @@ export interface RegistryRecordListPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordListResponsePayload {
+  /**
+   * All trust records held by the registry.
+   */
+  records: TrustRecord[];
+  ext?: Ext;
+}
+export interface TrustRecord {
+  entity_id: string;
+  authority_id: string;
+  action: string;
+  resource: string;
+  /**
+   * Present on recognition records: whether the action+resource is recognised.
+   */
+  recognized?: boolean;
+  /**
+   * Present on authorization records: whether the action+resource authorization is confirmed.
+   */
+  authorized?: boolean;
+  /**
+   * Opaque governance context attached to the record.
+   */
+  context?: {
+    [k: string]: unknown | undefined;
+  };
+  record_type: RecordType;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/list/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/list/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordListResponsePayload;

package/src/registry/record/put/0.1/payload.ts

@@ -46,9 +46,30 @@ export interface TrustRecord {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordPutResponsePayload {
+  /**
+   * Whether the record was stored.
+   */
+  ok: boolean;
+  /**
+   * True when the put created a new record, false when it replaced an existing one.
+   */
+  created: boolean;
+  /**
+   * Optional human-readable detail.
+   */
+  message?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/put/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/put/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordPutResponsePayload;

package/src/registry/record/query/0.1/payload.ts

@@ -3,6 +3,11 @@
  * Source: specs/registry/record/query/0.1/payload.schema.json
  */
 
+/**
+ * Whether the record asserts an authorization or a recognition relationship.
+ */
+export type RecordType = "authorization" | "recognition";
+
 /**
  * An administrator queries a trust registry's stored records by an optional four-part key. All four parts supplied: an exact fetch of one record (notFound on a miss). Fewer parts: a filtered, cursor-paginated enumeration — fixing the pagination gap the superseded registry/record/list conceded. Key field names are verbatim TRQP (snake_case), matching the registry/* family.
  */
@@ -39,9 +44,47 @@ export interface RegistryRecordQueryPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordQueryResponsePayload {
+  /**
+   * The matching trust records. Exactly one entry on a fully keyed fetch; zero or more per page on an enumeration.
+   */
+  records: TrustRecord[];
+  /**
+   * Continuation token for the next page, or null/absent when this is the last.
+   */
+  nextCursor?: string | null;
+  ext?: Ext;
+}
+export interface TrustRecord {
+  entity_id: string;
+  authority_id: string;
+  action: string;
+  resource: string;
+  /**
+   * Present on recognition records: whether the action+resource is recognised.
+   */
+  recognized?: boolean;
+  /**
+   * Present on authorization records: whether the action+resource authorization is confirmed.
+   */
+  authorized?: boolean;
+  /**
+   * Opaque governance context attached to the record.
+   */
+  context?: {
+    [k: string]: unknown | undefined;
+  };
+  record_type: RecordType;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/query/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/query/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordQueryResponsePayload;

package/src/registry/record/read/0.1/payload.ts

@@ -3,6 +3,11 @@
  * Source: specs/registry/record/read/0.1/payload.schema.json
  */
 
+/**
+ * Whether the record asserts an authorization or a recognition relationship.
+ */
+export type RecordType = "authorization" | "recognition";
+
 /**
  * An administrator reads the full trust record identified by the four TRQP identifiers (both the recognized and authorized facets, unlike the filtered TRQP query responses).
  */
@@ -19,9 +24,27 @@ export interface RegistryRecordReadPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordReadResponsePayloadATrustRecord {
+  entity_id: string;
+  authority_id: string;
+  action: string;
+  resource: string;
+  recognized?: boolean;
+  authorized?: boolean;
+  context?: {
+    [k: string]: unknown | undefined;
+  };
+  record_type: RecordType;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/read/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/read/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordReadResponsePayloadATrustRecord;

package/src/registry/record/update/0.1/payload.ts

@@ -42,9 +42,26 @@ export interface TrustRecord {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface RegistryRecordUpdateResponsePayload {
+  /**
+   * Whether the record was updated.
+   */
+  ok: boolean;
+  /**
+   * Optional human-readable detail.
+   */
+  message?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/registry/record/update/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = RecordType;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/registry/record/update/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = RegistryRecordUpdateResponsePayload;

package/src/sync/event/0.1/payload.ts

@@ -215,5 +215,5 @@ export interface Ext1 {
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/sync/event/0.1" as const;
 
-/** Trust Task response type URI (request type URI + "#response"). */
-export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/sync/event/0.1#response" as const;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = SyncEvent;

package/src/sync/event/0.2/payload.ts

@@ -215,5 +215,5 @@ export interface Ext1 {
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/sync/event/0.2" as const;
 
-/** Trust Task response type URI (request type URI + "#response"). */
-export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/sync/event/0.2#response" as const;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = SyncEvent;

package/src/task-consent/decision/0.1/payload.ts

@@ -33,9 +33,37 @@ export interface TaskConsentDecisionPayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+/**
+ * Acknowledgement of the recorded decision, and whether the approval threshold is now met.
+ */
+export interface TaskConsentDecisionResponsePayload {
+  /**
+   * `granted` = the threshold is met and the requester's re-submit will now execute. `pending` = the approval was recorded but more are needed. `denied` = the request was aborted.
+   */
+  status: "granted" | "pending" | "denied";
+  /**
+   * The digest this decision concerned.
+   */
+  payloadDigest: string;
+  /**
+   * Distinct approvals recorded so far.
+   */
+  approvals?: number;
+  /**
+   * Distinct approvals required. Present when status is `pending`.
+   */
+  needed?: number;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/task-consent/decision/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = Decision;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/task-consent/decision/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = TaskConsentDecisionResponsePayload;

package/src/task-consent/granted/0.1/payload.ts

@@ -31,5 +31,5 @@ export interface Ext {
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/task-consent/granted/0.1" as const;
 
-/** Trust Task response type URI (request type URI + "#response"). */
-export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/task-consent/granted/0.1#response" as const;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = TaskConsentGrantedPayload;

package/src/task-consent/request/0.1/payload.ts

@@ -138,9 +138,29 @@ export interface StatePin {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+/**
+ * Synchronous acknowledgement from the approver device that a prompt was raised. The decision itself arrives separately as a task-consent/decision — a human is in the loop, so it cannot be a synchronous reply.
+ */
+export interface TaskConsentRequestResponsePayload {
+  /**
+   * `prompted` = the request was verified and an approval prompt raised. `refused` = the device will not prompt; `reason` MUST be set.
+   */
+  status: "prompted" | "refused";
+  /**
+   * REQUIRED when status is `refused`.
+   */
+  reason?: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/task-consent/request/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = TaskConsentRequestPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/task-consent/request/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = TaskConsentRequestResponsePayload;

package/src/trust-task-discovery/0.1/payload.ts

@@ -12,9 +12,42 @@ export interface TrustTaskDiscoveryPayload {
    */
   patterns?: string[];
 }
+/**
+ * List of bare Type URIs the responding party supports. Carried in a Trust Task document whose type is https://trusttasks.org/spec/trust-task-discovery/0.1#response.
+ */
+export interface TrustTaskDiscoveryResponsePayload {
+  /**
+   * Each entry's Type URI MUST match at least one of the request's patterns (if any were supplied). Order is not significant. Duplicates by Type URI are not permitted, regardless of whether the entry is in shorthand or expanded form.
+   */
+  supportedTypes: (
+    | string
+    | {
+        /**
+         * A bare Type URI (no #request or #response fragment). The responder supports both request and response variants of every entry it lists.
+         */
+        type: string;
+        /**
+         * Reverse-DNS `ext` namespaces this responder requires on inbound documents of this Type URI as a matter of local policy (SPEC.md §4.5.1, §7.2). A producer that does not populate every listed namespace will receive a `malformed_request` rejection. Optional; reserved-but-recognized in 0.1, RECOMMENDED in future revisions for responders that enforce such policies.
+         *
+         * @minItems 1
+         */
+        requiredExt?: [string, ...string[]];
+      }
+  )[];
+  /**
+   * MAJOR.MINOR version of the Trust Tasks framework specification (SPEC.md) the responder targets. Lets a discoverer at framework version X reason about forward-minor compatibility (SPEC.md §5.2). Optional in 0.1; RECOMMENDED in future revisions.
+   */
+  frameworkVersion?: string;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/trust-task-discovery/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = TrustTaskDiscoveryPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/trust-task-discovery/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = TrustTaskDiscoveryResponsePayload;

package/src/trust-task-error/0.1/payload.ts

@@ -51,5 +51,5 @@ export interface TrustTaskErrorPayload {
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/trust-task-error/0.1" as const;
 
-/** Trust Task response type URI (request type URI + "#response"). */
-export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/trust-task-error/0.1#response" as const;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = TrustTaskErrorPayload;

package/src/trust-task-error/0.2/payload.ts

@@ -51,5 +51,5 @@ export interface TrustTaskErrorPayload {
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/trust-task-error/0.2" as const;
 
-/** Trust Task response type URI (request type URI + "#response"). */
-export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/trust-task-error/0.2#response" as const;
+/** Stable alias for this specification's request payload shape. */
+export type Payload = TrustTaskErrorPayload;

package/src/vault/delete/0.1/payload.ts

@@ -28,9 +28,24 @@ export interface VaultDeletePayload {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface VaultDeleteResponsePayload {
+  id: string;
+  deletedAt: string;
+  /**
+   * Time after which the maintainer MAY garbage-collect the tombstone. Late-syncing consumers that connect before this time MUST receive the tombstone via vault/sync and wipe their cache; consumers that connect after this time will simply see the entry as absent.
+   */
+  graceUntil: string;
+  ext?: Ext;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vault/delete/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VaultDeletePayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vault/delete/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VaultDeleteResponsePayload;