@openvtc/trust-tasks 0.19.21 → 0.19.22

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 {
@@ -15,6 +15,10 @@ export interface MessagingGetAccountPayload {
    * 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.
    */
@@ -35,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;
@@ -76,6 +80,10 @@ export const PAYLOAD_SCHEMA = {
       "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."
@@ -170,6 +178,74 @@ export const PAYLOAD_SCHEMA = {
           "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."
         }
       }
     },
@@ -372,6 +448,74 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "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 {
@@ -23,6 +23,10 @@ export interface MessagingListAccountsPayload {
    * 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.
    */
@@ -47,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;
@@ -96,6 +100,10 @@ export const PAYLOAD_SCHEMA = {
       "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."
@@ -198,6 +206,74 @@ export const PAYLOAD_SCHEMA = {
           "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."
         }
       }
     },
@@ -408,6 +484,74 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "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/update/0.1/payload.ts

@@ -3,7 +3,7 @@
  * Source: specs/messaging/account/update/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 MessagingUpdateAccountPayload {
@@ -43,7 +43,7 @@ export interface MessagingUpdateAccountResponsePayload {
 }
 
 /** 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/update/0.1" as const;
@@ -186,6 +186,74 @@ export const PAYLOAD_SCHEMA = {
           "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."
         }
       }
     },
@@ -388,6 +456,74 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "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."
         }
       }
     },