@openvtc/trust-tasks 0.19.20 → 0.19.22

package/src/_shared/components.ts

@@ -213,6 +213,16 @@ export type ExpectedVersion_VtaV0_1 = number;
  * After which the bundle is collected: staged bytes discarded, tokens and chunk requests refused. Short by design. For a chunked transfer a recipient may move it later as chunks are exchanged, never past its own ceiling — each chunk response reports the current value.
  */
 export type ExpiresAt = string;
+/**
+ * Names the `ext` namespaces a consumer MUST understand or refuse, per SPEC.md §4.5.1.
+ *
+ * Every entry MUST be an immediate key of the sibling `ext` object at the same level; an entry naming an absent namespace is non-conforming and the consumer rejects the document with `malformedRequest`. A consumer that does not recognize a namespace named here MUST NOT process the document as though the namespace were absent, and rejects it with `unsupportedExtension` — the exception to the rule that unrecognized namespaces are ignored.
+ *
+ * A producer marks a namespace only where the document's meaning depends on it. Marking one that merely carries a hint or an annotation turns every consumer that has not implemented it into a failure where it would otherwise have interoperated. JSON Schema cannot check either of those rules: that an entry names a present namespace is checkable only against the sibling `ext`, and whether a namespace is load-bearing is not a schema question at all. Both are consumer-side checks.
+ *
+ * @minItems 1
+ */
+export type ExtCritical = [string, ...string[]];
 /**
  * Where a pool face may be worn. `anywhere` is the default and what an absent member means. `only` names the contexts it may be worn in, and a maintainer MUST refuse to wear it in any other (persona/binding/set `outsideReach`).
  *
@@ -853,6 +863,47 @@ export interface Account {
    * Number of entries in the account's access list.
    */
   accessListCount?: number;
+  /**
+   * Unix epoch seconds at which the mediator last accepted a message addressed to this account. Present only when the request set `includeActivity` and the mediator has recorded such a message; MAY lag the true time by up to 60 seconds.
+   */
+  lastReceivedAt?: number;
+  /**
+   * Unix epoch seconds at which this account last completed authentication with the mediator, over any transport. Present only when the request set `includeActivity` and the mediator has recorded an authentication.
+   */
+  lastAuthenticatedAt?: number;
+  /**
+   * Lifetime counters the mediator keeps for this account. Present only when the request set `includeStats`.
+   */
+  stats?: AccountStats;
+}
+/**
+ * What an account has sent and received over its lifetime, as the mediator counted it. Every member is optional: a mediator reports what it keeps, and a counter absent from a response was not kept rather than zero. Counters survive restarts and are not reset by reading them; removing an account discards them.
+ */
+export interface AccountStats {
+  /**
+   * Messages the mediator accepted addressed to this account.
+   */
+  messagesReceived?: number;
+  /**
+   * Messages the mediator accepted from this account.
+   */
+  messagesSent?: number;
+  /**
+   * Total size of the messages counted by messagesReceived.
+   */
+  bytesReceived?: number;
+  /**
+   * Total size of the messages counted by messagesSent.
+   */
+  bytesSent?: number;
+  /**
+   * messagesReceived split by the wire protocol the message arrived in.
+   */
+  receivedByProtocol?: ProtocolCounts;
+  /**
+   * messagesSent split by the wire protocol the message was sent in.
+   */
+  sentByProtocol?: ProtocolCounts;
 }
 export interface AclChangedEvent_SyncV0_1 {
   kind: "acl.changed";
@@ -3407,6 +3458,27 @@ export interface Profile {
   createdAt?: string;
   updatedAt: string;
 }
+/**
+ * Message counts split by wire protocol. An absent member is a protocol the mediator counted nothing for. The member names match the WireProtocol values the traffic monitor reports.
+ */
+export interface ProtocolCounts {
+  /**
+   * DIDComm v2 (JWE/JWS).
+   */
+  didcomm?: number;
+  /**
+   * A DIDComm v1 envelope.
+   */
+  didcommV1?: number;
+  /**
+   * A Trust Spanning Protocol message.
+   */
+  tsp?: number;
+  /**
+   * Anything the mediator could not classify.
+   */
+  other?: number;
+}
 /**
  * Server-issued options for `navigator.credentials.create({ publicKey: ... })`. Mirrors the WebAuthn Level 2 `PublicKeyCredentialCreationOptions` dictionary; binary fields are base64url-encoded strings (rather than ArrayBuffers) so the value is JSON-safe over the wire.
  */

package/src/index.ts

@@ -13,6 +13,7 @@ export * as SharedComponents from "./_shared/components.js";
 export * as FrameworkShared_v0_1 from "./_framework/0.1/framework.js";
 export * as FrameworkShared_v0_2 from "./_framework/0.2/framework.js";
 export * as FrameworkShared_v0_3 from "./_framework/0.3/framework.js";
+export * as FrameworkShared_v0_4 from "./_framework/0.4/framework.js";
 export * as AclEntryShared_v0_1 from "./acl/_shared/0.1/acl-entry.js";
 export * as AclChangeRole_v0_1 from "./acl/change-role/0.1/payload.js";
 export * as AclGrant_v0_1 from "./acl/grant/0.1/payload.js";
@@ -543,6 +544,7 @@ export * as VtcVettingVettersGrant_v0_1 from "./vtc/vetting/vetters/grant/0.1/pa
 export * as VtcVettingVettersList_v0_1 from "./vtc/vetting/vetters/list/0.1/payload.js";
 export * as VtcVettingVettersProfile_v0_1 from "./vtc/vetting/vetters/profile/0.1/payload.js";
 export * as VtcVettingVettersResend_v0_1 from "./vtc/vetting/vetters/resend/0.1/payload.js";
+export * as VtcVettingVettersShow_v0_1 from "./vtc/vetting/vetters/show/0.1/payload.js";
 export * as VtcWebsiteFilesDelete_v0_1 from "./vtc/website/files/delete/0.1/payload.js";
 export * as VtcWebsiteFilesList_v0_1 from "./vtc/website/files/list/0.1/payload.js";
 export * as VtcWebsiteGenerationsList_v0_1 from "./vtc/website/generations/list/0.1/payload.js";

package/src/messaging/_shared/0.1/messaging.ts

@@ -14,4 +14,4 @@ export interface MessagingAdministrationSharedDefinitionsForTheMessagingSpecFami
  * The definitions this shared schema publishes, hoisted to one declaration each.
  * See "../../../_shared/components.js".
  */
-export type { Account, AccountType, AdminAccount, AuditAction, AuditEntry, MediatorAcl, QueueLimits, Vid } from "../../../_shared/components.js";
+export type { Account, AccountStats, AccountType, AdminAccount, AuditAction, AuditEntry, MediatorAcl, ProtocolCounts, QueueLimits, Vid } from "../../../_shared/components.js";

package/src/messaging/account/add/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/add/0.1/payload.schema.json
  */
 
-import type { Account, AccountType, Ext, MediatorAcl, QueueLimits, Vid } from "../../../../_shared/components.js";
+import type { Account, AccountStats, AccountType, Ext, MediatorAcl, ProtocolCounts, QueueLimits, Vid } from "../../../../_shared/components.js";
 
 
 export interface MessagingAddAccountPayload {
@@ -43,7 +43,7 @@ export interface MessagingAddAccountResponsePayload {
 }
 
 /** Shared definitions this specification references, re-exported under the names it used to declare them with. */
-export type { Account, AccountType, Ext, MediatorAcl, QueueLimits, Vid };
+export type { Account, AccountStats, AccountType, Ext, MediatorAcl, ProtocolCounts, QueueLimits, Vid };
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/messaging/account/add/0.1" as const;
@@ -177,6 +177,84 @@ export const PAYLOAD_SCHEMA = {
           "type": "integer",
           "minimum": 0,
           "description": "Number of entries in the account's access list."
+        },
+        "lastReceivedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which the mediator last accepted a message addressed to this account. Present only when the request set `includeActivity` and the mediator has recorded such a message; MAY lag the true time by up to 60 seconds."
+        },
+        "lastAuthenticatedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which this account last completed authentication with the mediator, over any transport. Present only when the request set `includeActivity` and the mediator has recorded an authentication."
+        },
+        "stats": {
+          "$ref": "#/$defs/AccountStats",
+          "description": "Lifetime counters the mediator keeps for this account. Present only when the request set `includeStats`."
+        }
+      }
+    },
+    "AccountStats": {
+      "title": "AccountStats",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "What an account has sent and received over its lifetime, as the mediator counted it. Every member is optional: a mediator reports what it keeps, and a counter absent from a response was not kept rather than zero. Counters survive restarts and are not reset by reading them; removing an account discards them.",
+      "properties": {
+        "messagesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted addressed to this account."
+        },
+        "messagesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted from this account."
+        },
+        "bytesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesReceived."
+        },
+        "bytesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesSent."
+        },
+        "receivedByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesReceived split by the wire protocol the message arrived in."
+        },
+        "sentByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesSent split by the wire protocol the message was sent in."
+        }
+      }
+    },
+    "ProtocolCounts": {
+      "title": "ProtocolCounts",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Message counts split by wire protocol. An absent member is a protocol the mediator counted nothing for. The member names match the WireProtocol values the traffic monitor reports.",
+      "properties": {
+        "didcomm": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "DIDComm v2 (JWE/JWS)."
+        },
+        "didcommV1": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A DIDComm v1 envelope."
+        },
+        "tsp": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A Trust Spanning Protocol message."
+        },
+        "other": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Anything the mediator could not classify."
         }
       }
     },
@@ -369,6 +447,84 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "integer",
           "minimum": 0,
           "description": "Number of entries in the account's access list."
+        },
+        "lastReceivedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which the mediator last accepted a message addressed to this account. Present only when the request set `includeActivity` and the mediator has recorded such a message; MAY lag the true time by up to 60 seconds."
+        },
+        "lastAuthenticatedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which this account last completed authentication with the mediator, over any transport. Present only when the request set `includeActivity` and the mediator has recorded an authentication."
+        },
+        "stats": {
+          "$ref": "#/$defs/AccountStats",
+          "description": "Lifetime counters the mediator keeps for this account. Present only when the request set `includeStats`."
+        }
+      }
+    },
+    "AccountStats": {
+      "title": "AccountStats",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "What an account has sent and received over its lifetime, as the mediator counted it. Every member is optional: a mediator reports what it keeps, and a counter absent from a response was not kept rather than zero. Counters survive restarts and are not reset by reading them; removing an account discards them.",
+      "properties": {
+        "messagesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted addressed to this account."
+        },
+        "messagesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted from this account."
+        },
+        "bytesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesReceived."
+        },
+        "bytesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesSent."
+        },
+        "receivedByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesReceived split by the wire protocol the message arrived in."
+        },
+        "sentByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesSent split by the wire protocol the message was sent in."
+        }
+      }
+    },
+    "ProtocolCounts": {
+      "title": "ProtocolCounts",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Message counts split by wire protocol. An absent member is a protocol the mediator counted nothing for. The member names match the WireProtocol values the traffic monitor reports.",
+      "properties": {
+        "didcomm": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "DIDComm v2 (JWE/JWS)."
+        },
+        "didcommV1": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A DIDComm v1 envelope."
+        },
+        "tsp": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A Trust Spanning Protocol message."
+        },
+        "other": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Anything the mediator could not classify."
         }
       }
     },

package/src/messaging/account/change-queue-limits/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/change-queue-limits/0.1/payload.schema.json
  */
 
-import type { Account, AccountType, Ext, MediatorAcl, QueueLimits, Vid } from "../../../../_shared/components.js";
+import type { Account, AccountStats, AccountType, Ext, MediatorAcl, ProtocolCounts, QueueLimits, Vid } from "../../../../_shared/components.js";
 
 
 export interface MessagingChangeAccountQueueLimitsPayload {
@@ -35,7 +35,7 @@ export interface MessagingChangeAccountQueueLimitsResponsePayload {
 }
 
 /** Shared definitions this specification references, re-exported under the names it used to declare them with. */
-export type { Account, AccountType, Ext, MediatorAcl, QueueLimits, Vid };
+export type { Account, AccountStats, AccountType, Ext, MediatorAcl, ProtocolCounts, QueueLimits, Vid };
 
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/messaging/account/change-queue-limits/0.1" as const;
@@ -161,6 +161,84 @@ export const PAYLOAD_SCHEMA = {
           "type": "integer",
           "minimum": 0,
           "description": "Number of entries in the account's access list."
+        },
+        "lastReceivedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which the mediator last accepted a message addressed to this account. Present only when the request set `includeActivity` and the mediator has recorded such a message; MAY lag the true time by up to 60 seconds."
+        },
+        "lastAuthenticatedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which this account last completed authentication with the mediator, over any transport. Present only when the request set `includeActivity` and the mediator has recorded an authentication."
+        },
+        "stats": {
+          "$ref": "#/$defs/AccountStats",
+          "description": "Lifetime counters the mediator keeps for this account. Present only when the request set `includeStats`."
+        }
+      }
+    },
+    "AccountStats": {
+      "title": "AccountStats",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "What an account has sent and received over its lifetime, as the mediator counted it. Every member is optional: a mediator reports what it keeps, and a counter absent from a response was not kept rather than zero. Counters survive restarts and are not reset by reading them; removing an account discards them.",
+      "properties": {
+        "messagesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted addressed to this account."
+        },
+        "messagesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted from this account."
+        },
+        "bytesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesReceived."
+        },
+        "bytesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesSent."
+        },
+        "receivedByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesReceived split by the wire protocol the message arrived in."
+        },
+        "sentByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesSent split by the wire protocol the message was sent in."
+        }
+      }
+    },
+    "ProtocolCounts": {
+      "title": "ProtocolCounts",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Message counts split by wire protocol. An absent member is a protocol the mediator counted nothing for. The member names match the WireProtocol values the traffic monitor reports.",
+      "properties": {
+        "didcomm": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "DIDComm v2 (JWE/JWS)."
+        },
+        "didcommV1": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A DIDComm v1 envelope."
+        },
+        "tsp": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A Trust Spanning Protocol message."
+        },
+        "other": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Anything the mediator could not classify."
         }
       }
     },
@@ -353,6 +431,84 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": "integer",
           "minimum": 0,
           "description": "Number of entries in the account's access list."
+        },
+        "lastReceivedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which the mediator last accepted a message addressed to this account. Present only when the request set `includeActivity` and the mediator has recorded such a message; MAY lag the true time by up to 60 seconds."
+        },
+        "lastAuthenticatedAt": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Unix epoch seconds at which this account last completed authentication with the mediator, over any transport. Present only when the request set `includeActivity` and the mediator has recorded an authentication."
+        },
+        "stats": {
+          "$ref": "#/$defs/AccountStats",
+          "description": "Lifetime counters the mediator keeps for this account. Present only when the request set `includeStats`."
+        }
+      }
+    },
+    "AccountStats": {
+      "title": "AccountStats",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "What an account has sent and received over its lifetime, as the mediator counted it. Every member is optional: a mediator reports what it keeps, and a counter absent from a response was not kept rather than zero. Counters survive restarts and are not reset by reading them; removing an account discards them.",
+      "properties": {
+        "messagesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted addressed to this account."
+        },
+        "messagesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Messages the mediator accepted from this account."
+        },
+        "bytesReceived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesReceived."
+        },
+        "bytesSent": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total size of the messages counted by messagesSent."
+        },
+        "receivedByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesReceived split by the wire protocol the message arrived in."
+        },
+        "sentByProtocol": {
+          "$ref": "#/$defs/ProtocolCounts",
+          "description": "messagesSent split by the wire protocol the message was sent in."
+        }
+      }
+    },
+    "ProtocolCounts": {
+      "title": "ProtocolCounts",
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Message counts split by wire protocol. An absent member is a protocol the mediator counted nothing for. The member names match the WireProtocol values the traffic monitor reports.",
+      "properties": {
+        "didcomm": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "DIDComm v2 (JWE/JWS)."
+        },
+        "didcommV1": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A DIDComm v1 envelope."
+        },
+        "tsp": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "A Trust Spanning Protocol message."
+        },
+        "other": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Anything the mediator could not classify."
         }
       }
     },