@openvtc/trust-tasks 0.2.54 → 0.2.56

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

@@ -29,9 +29,29 @@ export interface WakeTriggerPolicy {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushProvisionResponsePayload {
+  handle: string;
+  policy: WakeTriggerPolicy1;
+  ext?: Ext;
+}
+/**
+ * The effective allowlist the gateway recorded.
+ */
+export interface WakeTriggerPolicy1 {
+  /**
+   * DIDs authorized to trigger a wake for this handle. An empty array means no party may wake the device (push effectively disabled while the handle exists). The gateway authenticates the trigger's DID before checking membership.
+   */
+  allowedTriggers: string[];
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/provision/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushProvisionPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/provision/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushProvisionResponsePayload;

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

@@ -29,9 +29,29 @@ export interface WakeTriggerPolicy {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushProvisionResponsePayload {
+  handle: string;
+  policy: WakeTriggerPolicy1;
+  ext?: Ext;
+}
+/**
+ * The effective allowlist the gateway recorded.
+ */
+export interface WakeTriggerPolicy1 {
+  /**
+   * DIDs authorized to trigger a wake for this handle. An empty array means no party may wake the device (push effectively disabled while the handle exists). The gateway authenticates the trigger's DID before checking membership.
+   */
+  allowedTriggers: string[];
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/provision/0.2" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushProvisionPayload;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/provision/0.2#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushProvisionResponsePayload;

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

@@ -67,9 +67,32 @@ export interface WebPush {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushRegisterResponsePayload {
+  wakeHandle: WakeHandle;
+  ext?: Ext;
+}
+/**
+ * The opaque gateway-issued handle (gateway address + handle). Conveyed onward; reveals no token.
+ */
+export interface WakeHandle {
+  /**
+   * The push gateway that issued this handle and acts on it — a DID (DIDComm-reachable gateway) or an https URL (REST gateway). A trigger sends its contentless wake request here.
+   */
+  gateway: string;
+  /**
+   * Opaque gateway-issued identifier for the device's push channel. Reveals no platform token. Rotates whenever the device re-registers a new platform token with the gateway; the device then re-conveys the fresh handle via device/set-wake.
+   */
+  handle: string;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/register/0.1" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushRegistration;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/register/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushRegisterResponsePayload;

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

@@ -67,9 +67,32 @@ export interface WebPush {
 export interface Ext {
   [k: string]: unknown | undefined;
 }
+export interface PushRegisterResponsePayload {
+  wakeHandle: WakeHandle;
+  ext?: Ext;
+}
+/**
+ * The opaque gateway-issued handle (gateway address + handle). Conveyed onward; reveals no token.
+ */
+export interface WakeHandle {
+  /**
+   * The push gateway that issued this handle and acts on it — a DID (DIDComm-reachable gateway) or an https URL (REST gateway). A trigger sends its contentless wake request here.
+   */
+  gateway: string;
+  /**
+   * Opaque gateway-issued identifier for the device's push channel. Reveals no platform token. Rotates whenever the device re-registers a new platform token with the gateway; the device then re-conveys the fresh handle via device/set-wake.
+   */
+  handle: string;
+}
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/push/register/0.2" as const;
 
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PushRegistration;
+
 /** Trust Task response type URI (request type URI + "#response"). */
 export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/push/register/0.2#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PushRegisterResponsePayload;

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;