@openvtc/trust-tasks 0.19.20 → 0.19.22

package/src/messaging/account/change-type/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/change-type/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 MessagingChangeAccountTypePayload {
@@ -35,7 +35,7 @@ export interface MessagingChangeAccountTypeResponsePayload {
 }
 
 /** 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-type/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."
         }
       }
     },

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

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/get/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 MessagingGetAccountPayload {
@@ -11,6 +11,14 @@ export interface MessagingGetAccountPayload {
    * The DID of the account to fetch.
    */
   did: Vid;
+  /**
+   * When true, the mediator includes each returned account's `lastReceivedAt` and `lastAuthenticatedAt`, where recorded. Omitted or false = neither is returned.
+   */
+  includeActivity?: boolean;
+  /**
+   * When true, the mediator includes each returned account's `stats` — its lifetime counters — where it keeps them. Omitted or false = no stats are returned.
+   */
+  includeStats?: boolean;
   /**
    * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
@@ -31,7 +39,7 @@ export interface MessagingGetAccountResponsePayload {
 }
 
 /** 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/get/0.1" as const;
@@ -68,6 +76,14 @@ export const PAYLOAD_SCHEMA = {
       "$ref": "#/$defs/Vid",
       "description": "The DID of the account to fetch."
     },
+    "includeActivity": {
+      "type": "boolean",
+      "description": "When true, the mediator includes each returned account's `lastReceivedAt` and `lastAuthenticatedAt`, where recorded. Omitted or false = neither is returned."
+    },
+    "includeStats": {
+      "type": "boolean",
+      "description": "When true, the mediator includes each returned account's `stats` — its lifetime counters — where it keeps them. Omitted or false = no stats are returned."
+    },
     "ext": {
       "$ref": "#/$defs/Ext",
       "description": "Ecosystem-defined extension members per SPEC.md §4.5.1."
@@ -152,6 +168,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."
         }
       }
     },
@@ -344,6 +438,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/list/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/list/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 MessagingListAccountsPayload {
@@ -19,6 +19,14 @@ export interface MessagingListAccountsPayload {
    * Maximum number of accounts to return in this page. The mediator chooses a default when omitted.
    */
   limit?: number;
+  /**
+   * When true, the mediator includes each returned account's `lastReceivedAt` and `lastAuthenticatedAt`, where recorded. Omitted or false = neither is returned.
+   */
+  includeActivity?: boolean;
+  /**
+   * When true, the mediator includes each returned account's `stats` — its lifetime counters — where it keeps them. Omitted or false = no stats are returned.
+   */
+  includeStats?: boolean;
   /**
    * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
@@ -43,7 +51,7 @@ export interface MessagingListAccountsResponsePayload {
 }
 
 /** 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/list/0.1" as const;
@@ -88,6 +96,14 @@ export const PAYLOAD_SCHEMA = {
       "maximum": 1000,
       "description": "Maximum number of accounts to return in this page. The mediator chooses a default when omitted."
     },
+    "includeActivity": {
+      "type": "boolean",
+      "description": "When true, the mediator includes each returned account's `lastReceivedAt` and `lastAuthenticatedAt`, where recorded. Omitted or false = neither is returned."
+    },
+    "includeStats": {
+      "type": "boolean",
+      "description": "When true, the mediator includes each returned account's `stats` — its lifetime counters — where it keeps them. Omitted or false = no stats are returned."
+    },
     "ext": {
       "$ref": "#/$defs/Ext",
       "description": "Ecosystem-defined extension members per SPEC.md §4.5.1."
@@ -180,6 +196,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."
         }
       }
     },
@@ -380,6 +474,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."
         }
       }
     },