@breign/client 1.0.111 → 1.0.113

package/dist/openapi.json

@@ -509,7 +509,6 @@
           "in" : "query",
           "name" : "startDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         }, {
@@ -517,7 +516,6 @@
           "in" : "query",
           "name" : "endDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         } ],
@@ -552,6 +550,136 @@
         "tags" : [ "agent" ]
       }
     },
+    "/agents/{agentId}/metrics/ephemeral-instances" : {
+      "get" : {
+        "description" : "Returns ephemeral instance creation counts over time for an agent",
+        "operationId" : "getAgentMetricsEphemeralInstances",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "granularity",
+          "required" : false,
+          "schema" : {
+            "default" : "day",
+            "enum" : [ "hour", "day", "week" ],
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/EphemeralInstancesMetricsResponse"
+                }
+              }
+            },
+            "description" : "Ephemeral instances metrics retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Agent not found"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get ephemeral instances metrics for an agent",
+        "tags" : [ "agent" ]
+      }
+    },
+    "/agents/{agentId}/metrics/usage" : {
+      "get" : {
+        "description" : "Returns LLM requests and token usage over time for a specific agent",
+        "operationId" : "getAgentMetricsUsage",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "granularity",
+          "required" : false,
+          "schema" : {
+            "default" : "day",
+            "enum" : [ "hour", "day", "week" ],
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/OrgUsageMetricsResponse"
+                }
+              }
+            },
+            "description" : "Usage metrics retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Agent not found"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get usage metrics for an agent",
+        "tags" : [ "agent" ]
+      }
+    },
     "/agents/{agentId}/metrics" : {
       "get" : {
         "description" : "Retrieves detailed usage metrics for a specific agent (admin only)",
@@ -570,7 +698,6 @@
           "in" : "query",
           "name" : "startDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         }, {
@@ -578,7 +705,6 @@
           "in" : "query",
           "name" : "endDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         } ],
@@ -639,7 +765,6 @@
           "in" : "query",
           "name" : "startDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         }, {
@@ -647,7 +772,6 @@
           "in" : "query",
           "name" : "endDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         } ],
@@ -5248,11 +5372,342 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/FileWithDownloadUrl"
+                  "$ref" : "#/components/schemas/FileWithDownloadUrl"
+                }
+              }
+            },
+            "description" : "File retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "404" : {
+            "description" : "File not found"
+          }
+        },
+        "summary" : "Get a file by ID",
+        "tags" : [ "files" ]
+      }
+    },
+    "/metrics" : {
+      "get" : {
+        "description" : "Retrieves usage metrics for all agents within a date range (admin only)",
+        "operationId" : "getMetrics",
+        "parameters" : [ {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/Metric"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get usage metrics",
+        "tags" : [ "metrics" ]
+      }
+    },
+    "/metrics/agents" : {
+      "get" : {
+        "description" : "Retrieves usage metrics broken down by agent within a date range (admin only)",
+        "operationId" : "getMetricsAgents",
+        "parameters" : [ {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/MetricForAgent"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Agent metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get agent-specific metrics",
+        "tags" : [ "metrics" ]
+      }
+    },
+    "/metrics/organizations/{organizationId}/day-metrics" : {
+      "get" : {
+        "description" : "Retrieves usage metrics broken down by day within a date range (admin only)",
+        "operationId" : "getMetricsDayMetrics",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/MetricForDay"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Day metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get day-specific metrics",
+        "tags" : [ "metrics" ]
+      }
+    },
+    "/metrics/organizations/{organizationId}/users" : {
+      "get" : {
+        "description" : "Retrieves usage metrics broken down by users within a date range (admin only)",
+        "operationId" : "getMetricsUsersVisitors",
+        "parameters" : [ {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/MetricsUsersResponse"
+                }
+              }
+            },
+            "description" : "Users metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get users metrics",
+        "tags" : [ "metrics" ]
+      }
+    },
+    "/metrics/organizations/{organizationId}/top-agents/conversations" : {
+      "get" : {
+        "description" : "Retrieves usage metrics broken down by top agents within a date range (admin only)",
+        "operationId" : "getMetricsTopAgents",
+        "parameters" : [ {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Agents IDs to filter metrics",
+          "in" : "query",
+          "name" : "agentsIds",
+          "schema" : {
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "type" : "array"
+          }
+        }, {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/MetricsTopAgentsResponse"
+                }
+              }
+            },
+            "description" : "Top agents metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User is not an admin"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get top agents metrics",
+        "tags" : [ "metrics" ]
+      }
+    },
+    "/metrics/organizations/{organizationId}/top-agents/usage" : {
+      "get" : {
+        "description" : "Retrieves usage metrics broken down by top agents within a date range (admin only)",
+        "operationId" : "getMetricsTopAgentsUsage",
+        "parameters" : [ {
+          "description" : "Start date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "startDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Agents IDs to filter metrics",
+          "in" : "query",
+          "name" : "agentsIds",
+          "schema" : {
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "type" : "array"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/MetricsTopAgentsUsageResponse"
                 }
               }
             },
-            "description" : "File retrieved successfully"
+            "description" : "Top agents usage metrics retrieved successfully"
+          },
+          "400" : {
+            "description" : "Invalid date format"
           },
           "401" : {
             "description" : "Unauthorized"
@@ -5260,24 +5715,31 @@
           "403" : {
             "description" : "Forbidden - User is not an admin"
           },
-          "404" : {
-            "description" : "File not found"
+          "500" : {
+            "description" : "Server error"
           }
         },
-        "summary" : "Get a file by ID",
-        "tags" : [ "files" ]
+        "summary" : "Get top agents usage metrics",
+        "tags" : [ "metrics" ]
       }
     },
-    "/metrics" : {
+    "/metrics/organizations/{organizationId}/ephemeral-instances" : {
       "get" : {
-        "description" : "Retrieves usage metrics for all agents within a date range (admin only)",
-        "operationId" : "getMetrics",
+        "description" : "Returns ephemeral instance creation counts over time for all agents in the organization",
+        "operationId" : "getMetricsOrganizationEphemeralInstances",
         "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
           "description" : "Start date for metrics (ISO format)",
           "in" : "query",
           "name" : "startDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         }, {
@@ -5285,7 +5747,15 @@
           "in" : "query",
           "name" : "endDate",
           "schema" : {
-            "format" : "date-time",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "granularity",
+          "required" : false,
+          "schema" : {
+            "default" : "day",
+            "enum" : [ "hour", "day", "week" ],
             "type" : "string"
           }
         } ],
@@ -5294,42 +5764,43 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/Metric"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/EphemeralInstancesMetricsResponse"
                 }
               }
             },
-            "description" : "Metrics retrieved successfully"
-          },
-          "400" : {
-            "description" : "Invalid date format"
+            "description" : "Ephemeral instances metrics retrieved successfully"
           },
           "401" : {
             "description" : "Unauthorized"
           },
           "403" : {
-            "description" : "Forbidden - User is not an admin"
+            "description" : "Forbidden"
           },
           "500" : {
             "description" : "Server error"
           }
         },
-        "summary" : "Get usage metrics",
+        "summary" : "Get ephemeral instances metrics for an organization",
         "tags" : [ "metrics" ]
       }
     },
-    "/metrics/agents" : {
+    "/metrics/organizations/{organizationId}/usage" : {
       "get" : {
-        "description" : "Retrieves usage metrics broken down by agent within a date range (admin only)",
-        "operationId" : "getMetricsAgents",
+        "description" : "Returns LLM requests and token usage over time for all agents in the organization",
+        "operationId" : "getMetricsOrganizationUsage",
         "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
           "description" : "Start date for metrics (ISO format)",
           "in" : "query",
           "name" : "startDate",
           "schema" : {
-            "format" : "date-time",
             "type" : "string"
           }
         }, {
@@ -5337,7 +5808,15 @@
           "in" : "query",
           "name" : "endDate",
           "schema" : {
-            "format" : "date-time",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "granularity",
+          "required" : false,
+          "schema" : {
+            "default" : "day",
+            "enum" : [ "hour", "day", "week" ],
             "type" : "string"
           }
         } ],
@@ -5346,29 +5825,23 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/MetricForAgent"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/OrgUsageMetricsResponse"
                 }
               }
             },
-            "description" : "Agent metrics retrieved successfully"
-          },
-          "400" : {
-            "description" : "Invalid date format"
+            "description" : "Usage metrics retrieved successfully"
           },
           "401" : {
             "description" : "Unauthorized"
           },
           "403" : {
-            "description" : "Forbidden - User is not an admin"
+            "description" : "Forbidden"
           },
           "500" : {
             "description" : "Server error"
           }
         },
-        "summary" : "Get agent-specific metrics",
+        "summary" : "Get usage metrics for an organization",
         "tags" : [ "metrics" ]
       }
     },
@@ -6658,6 +7131,56 @@
         "tags" : [ "organizations" ]
       }
     },
+    "/organizations/{organizationId}/metrics/agents/{agentId}" : {
+      "get" : {
+        "description" : "Retrieves metrics for a brain agent",
+        "operationId" : "getMetricsBrainsAgent",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/MetricsBrainsAgentResponse"
+                }
+              }
+            },
+            "description" : "Metrics for a brain agent found"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User doesn't have access to the organization"
+          },
+          "404" : {
+            "description" : "Metrics for a brain agent not found"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get metrics for a brain agent",
+        "tags" : [ "metrics" ]
+      }
+    },
     "/manifests" : {
       "get" : {
         "description" : "Retrieves manifests, filtered by user ID for non-admin users",
@@ -10882,7 +11405,6 @@
         "in" : "query",
         "name" : "startDate",
         "schema" : {
-          "format" : "date-time",
           "type" : "string"
         }
       },
@@ -10891,7 +11413,6 @@
         "in" : "query",
         "name" : "endDate",
         "schema" : {
-          "format" : "date-time",
           "type" : "string"
         }
       },
@@ -11180,6 +11701,18 @@
           "type" : "string"
         }
       },
+      "agentsIds" : {
+        "description" : "Agents IDs to filter metrics",
+        "in" : "query",
+        "name" : "agentsIds",
+        "schema" : {
+          "items" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "type" : "array"
+        }
+      },
       "guardianIdPath" : {
         "description" : "ID of the guardian",
         "in" : "path",
@@ -11993,29 +12526,220 @@
           "voiceConversationCount" : {
             "type" : "number"
           },
-          "userTextMessagesCount" : {
+          "userTextMessagesCount" : {
+            "type" : "number"
+          },
+          "userVoiceMessagesCount" : {
+            "type" : "number"
+          },
+          "totalRequests" : {
+            "type" : "number"
+          },
+          "totalTokensUsed" : {
+            "type" : "number"
+          },
+          "ephemeralInstancesCreated" : {
+            "type" : "number"
+          },
+          "uniqueUsersCount" : {
+            "type" : "number"
+          },
+          "errorConversationCount" : {
+            "type" : "number"
+          },
+          "tokenBreakdown" : {
+            "$ref" : "#/components/schemas/AgentTokenBreakdown"
+          },
+          "tokenUsageByTask" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentTokenUsageByTask"
+            },
+            "type" : "array"
+          },
+          "feedback" : {
+            "$ref" : "#/components/schemas/AgentFeedbackMetrics"
+          },
+          "metricsByApp" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentMetricsByApp"
+            },
+            "type" : "array"
+          },
+          "topTools" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentToolUsageMetric"
+            },
+            "type" : "array"
+          },
+          "periodComparison" : {
+            "$ref" : "#/components/schemas/AgentMetricsPeriodComparison"
+          },
+          "tokenUsage" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentTokenUsageMetric"
+            },
+            "type" : "array"
+          },
+          "subscription" : {
+            "$ref" : "#/components/schemas/SubscriptionMetric"
+          },
+          "costs" : {
+            "$ref" : "#/components/schemas/CostMetric"
+          }
+        },
+        "required" : [ "textConversationCount", "userTextMessagesCount", "userVoiceMessagesCount", "voiceConversationCount" ],
+        "type" : "object"
+      },
+      "AgentTokenBreakdown" : {
+        "properties" : {
+          "inputTokens" : {
+            "type" : "number"
+          },
+          "outputTokens" : {
+            "type" : "number"
+          },
+          "reasoningTokens" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "inputTokens", "outputTokens", "reasoningTokens" ],
+        "type" : "object"
+      },
+      "AgentTokenUsageByTask" : {
+        "properties" : {
+          "task" : {
+            "type" : "string"
+          },
+          "total" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "task", "total" ],
+        "type" : "object"
+      },
+      "AgentFeedbackMetrics" : {
+        "properties" : {
+          "positive" : {
+            "type" : "number"
+          },
+          "negative" : {
+            "type" : "number"
+          },
+          "total" : {
+            "type" : "number"
+          },
+          "satisfactionRate" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "negative", "positive", "total" ],
+        "type" : "object"
+      },
+      "AgentMetricsByApp" : {
+        "properties" : {
+          "appId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "appName" : {
+            "type" : "string"
+          },
+          "tokens" : {
+            "type" : "number"
+          },
+          "conversations" : {
+            "type" : "number"
+          },
+          "uniqueUsers" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "appName", "conversations", "tokens", "uniqueUsers" ],
+        "type" : "object"
+      },
+      "AgentToolUsageMetric" : {
+        "properties" : {
+          "toolName" : {
+            "type" : "string"
+          },
+          "count" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "count", "toolName" ],
+        "type" : "object"
+      },
+      "AgentMetricsPeriodComparison" : {
+        "properties" : {
+          "previous" : {
+            "$ref" : "#/components/schemas/AgentMetricsPeriodSnapshot"
+          },
+          "deltaPercent" : {
+            "additionalProperties" : {
+              "nullable" : true,
+              "type" : "number"
+            },
+            "type" : "object"
+          }
+        },
+        "required" : [ "deltaPercent", "previous" ],
+        "type" : "object"
+      },
+      "AgentMetricsPeriodSnapshot" : {
+        "properties" : {
+          "totalRequests" : {
+            "type" : "number"
+          },
+          "totalTokensUsed" : {
+            "type" : "number"
+          },
+          "conversations" : {
+            "type" : "number"
+          },
+          "uniqueUsersCount" : {
+            "type" : "number"
+          },
+          "ephemeralInstancesCreated" : {
+            "type" : "number"
+          },
+          "errorConversationCount" : {
             "type" : "number"
           },
-          "userVoiceMessagesCount" : {
+          "feedbackPositive" : {
             "type" : "number"
+          }
+        },
+        "required" : [ "conversations", "ephemeralInstancesCreated", "errorConversationCount", "feedbackPositive", "totalRequests", "totalTokensUsed", "uniqueUsersCount" ],
+        "type" : "object"
+      },
+      "AgentTokenUsageMetric" : {
+        "properties" : {
+          "provider" : {
+            "type" : "string"
           },
-          "subscription" : {
-            "$ref" : "#/components/schemas/SubscriptionMetric"
+          "model" : {
+            "type" : "string"
           },
-          "costs" : {
-            "$ref" : "#/components/schemas/CostMetric"
+          "type" : {
+            "type" : "string"
+          },
+          "units" : {
+            "type" : "string"
+          },
+          "total" : {
+            "type" : "number"
           }
         },
-        "required" : [ "textConversationCount", "userTextMessagesCount", "userVoiceMessagesCount", "voiceConversationCount" ],
+        "required" : [ "model", "provider", "total", "type", "units" ],
         "type" : "object"
       },
       "SubscriptionMetric" : {
         "properties" : {
           "textInteractions" : {
-            "type" : "object"
+            "$ref" : "#/components/schemas/SubscriptionInteractionsMetric"
           },
           "voiceInteractions" : {
-            "type" : "object"
+            "$ref" : "#/components/schemas/SubscriptionInteractionsMetric"
           },
           "canGoBeyondIncluded" : {
             "type" : "boolean"
@@ -12027,6 +12751,34 @@
             "type" : "string"
           }
         },
+        "required" : [ "canGoBeyondIncluded", "textInteractions", "voiceInteractions" ],
+        "type" : "object"
+      },
+      "SubscriptionInteractionsMetric" : {
+        "properties" : {
+          "included" : {
+            "type" : "number"
+          },
+          "additional" : {
+            "$ref" : "#/components/schemas/SubscriptionAdditionalMetric"
+          }
+        },
+        "required" : [ "additional", "included" ],
+        "type" : "object"
+      },
+      "SubscriptionAdditionalMetric" : {
+        "properties" : {
+          "price" : {
+            "type" : "string"
+          },
+          "amountForPrice" : {
+            "type" : "string"
+          },
+          "currency" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "amountForPrice", "currency", "price" ],
         "type" : "object"
       },
       "CostMetric" : {
@@ -12056,6 +12808,69 @@
         "required" : [ "amount", "currency" ],
         "type" : "object"
       },
+      "EphemeralInstancesMetricsResponse" : {
+        "properties" : {
+          "total" : {
+            "type" : "number"
+          },
+          "series" : {
+            "items" : {
+              "$ref" : "#/components/schemas/EphemeralInstancesTimeSeriesPoint"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "series", "total" ],
+        "type" : "object"
+      },
+      "EphemeralInstancesTimeSeriesPoint" : {
+        "properties" : {
+          "bucket" : {
+            "type" : "string"
+          },
+          "label" : {
+            "type" : "string"
+          },
+          "count" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "bucket", "count", "label" ],
+        "type" : "object"
+      },
+      "OrgUsageMetricsResponse" : {
+        "properties" : {
+          "total" : {
+            "$ref" : "#/components/schemas/OrgUsageMetricsResponse_total"
+          },
+          "series" : {
+            "items" : {
+              "$ref" : "#/components/schemas/OrgUsageTimeSeriesPoint"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "series", "total" ],
+        "type" : "object"
+      },
+      "OrgUsageTimeSeriesPoint" : {
+        "properties" : {
+          "bucket" : {
+            "type" : "string"
+          },
+          "label" : {
+            "type" : "string"
+          },
+          "requests" : {
+            "type" : "number"
+          },
+          "tokens" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "bucket", "label", "requests", "tokens" ],
+        "type" : "object"
+      },
       "AgentUsageMetrics" : {
         "properties" : {
           "_id" : {
@@ -13228,6 +14043,9 @@
             "additionalProperties" : false,
             "maxProperties" : 100,
             "type" : "object"
+          },
+          "ephemeralInstances" : {
+            "$ref" : "#/components/schemas/AppCreateRequest_ephemeralInstances"
           }
         },
         "required" : [ "agentId", "name", "streamingEnabled" ],
@@ -13357,7 +14175,7 @@
             "type" : "object"
           },
           "ephemeralInstances" : {
-            "$ref" : "#/components/schemas/App_ephemeralInstances"
+            "$ref" : "#/components/schemas/AppCreateRequest_ephemeralInstances"
           },
           "fillers" : {
             "additionalProperties" : false,
@@ -13539,6 +14357,9 @@
             "additionalProperties" : true,
             "maxProperties" : 100,
             "type" : "object"
+          },
+          "ephemeralInstances" : {
+            "$ref" : "#/components/schemas/AppCreateRequest_ephemeralInstances"
           }
         },
         "type" : "object"
@@ -14539,6 +15360,9 @@
           },
           "count" : {
             "type" : "number"
+          },
+          "timestamp" : {
+            "type" : "string"
           }
         },
         "required" : [ "count", "identifier", "total" ],
@@ -14623,6 +15447,46 @@
         "required" : [ "model", "provider", "total", "type", "units" ],
         "type" : "object"
       },
+      "MetricForDay" : {
+        "items" : {
+          "$ref" : "#/components/schemas/MetricForDay_inner"
+        },
+        "type" : "array"
+      },
+      "MetricsUsersResponse" : {
+        "properties" : {
+          "usersToday" : {
+            "$ref" : "#/components/schemas/MetricForVisitorToday"
+          },
+          "usersByMonth" : {
+            "$ref" : "#/components/schemas/MetricForVisitorByMonth"
+          }
+        },
+        "required" : [ "usersByMonth", "usersToday" ],
+        "type" : "object"
+      },
+      "MetricForVisitorToday" : {
+        "type" : "number"
+      },
+      "MetricForVisitorByMonth" : {
+        "items" : {
+          "$ref" : "#/components/schemas/MetricForVisitorByMonth_inner"
+        },
+        "type" : "array"
+      },
+      "MetricsTopAgentsResponse" : {
+        "items" : {
+          "$ref" : "#/components/schemas/MetricsTopAgentsResponse_inner"
+        },
+        "required" : [ "agentId", "agentName", "errorConversationCount", "textConversationCount" ],
+        "type" : "array"
+      },
+      "MetricsTopAgentsUsageResponse" : {
+        "items" : {
+          "$ref" : "#/components/schemas/MetricsTopAgentsUsageResponse_inner"
+        },
+        "type" : "array"
+      },
       "Guardian" : {
         "properties" : {
           "id" : {
@@ -15081,6 +15945,44 @@
         },
         "type" : "object"
       },
+      "MetricsBrainsAgentResponse" : {
+        "properties" : {
+          "conversationCount" : {
+            "$ref" : "#/components/schemas/ConversationCount"
+          },
+          "usersCount" : {
+            "$ref" : "#/components/schemas/UsersCount"
+          },
+          "totalTokensUsedByAgent" : {
+            "$ref" : "#/components/schemas/TotalTokensUsedByAgent"
+          },
+          "totalRequests" : {
+            "$ref" : "#/components/schemas/TotalRequests"
+          }
+        },
+        "required" : [ "conversationCount", "totalRequests", "totalTokensUsedByAgent", "usersCount" ],
+        "type" : "object"
+      },
+      "ConversationCount" : {
+        "type" : "number"
+      },
+      "UsersCount" : {
+        "type" : "number"
+      },
+      "TotalTokensUsedByAgent" : {
+        "properties" : {
+          "name" : {
+            "type" : "string"
+          },
+          "totalTokens" : {
+            "type" : "number"
+          }
+        },
+        "type" : "object"
+      },
+      "TotalRequests" : {
+        "type" : "number"
+      },
       "Manifest" : {
         "additionalProperties" : true,
         "properties" : {
@@ -16230,7 +17132,7 @@
         "type" : "string"
       },
       "AgentMetricsUnitsType" : {
-        "enum" : [ "TOKENS", "CURRENCY", "MILLISECONDS", "CHARACTERS" ],
+        "enum" : [ "TOKENS", "CURRENCY", "MILLISECONDS", "CHARACTERS", "COUNT" ],
         "type" : "string"
       },
       "ChatMessageRole" : {
@@ -16934,6 +17836,18 @@
         "required" : [ "model", "providerId" ],
         "type" : "object"
       },
+      "OrgUsageMetricsResponse_total" : {
+        "properties" : {
+          "requests" : {
+            "type" : "number"
+          },
+          "tokens" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "requests", "tokens" ],
+        "type" : "object"
+      },
       "FlowContents_text" : {
         "anyOf" : [ {
           "type" : "string"
@@ -17157,6 +18071,19 @@
         "required" : [ "date", "type" ],
         "type" : "object"
       },
+      "AppCreateRequest_ephemeralInstances" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "allowed" : {
+            "type" : "boolean"
+          },
+          "maxInstances" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "allowed", "maxInstances" ],
+        "type" : "object"
+      },
       "App_commands_inner" : {
         "properties" : {
           "name" : {
@@ -17180,18 +18107,6 @@
           "$ref" : "#/components/schemas/EphemeralInstance"
         } ]
       },
-      "App_ephemeralInstances" : {
-        "additionalProperties" : false,
-        "properties" : {
-          "allowed" : {
-            "type" : "boolean"
-          },
-          "maxInstances" : {
-            "type" : "number"
-          }
-        },
-        "type" : "object"
-      },
       "Sequence_contents" : {
         "properties" : {
           "text" : {
@@ -17607,6 +18522,93 @@
         "required" : [ "id" ],
         "type" : "object"
       },
+      "MetricForDay_inner__id" : {
+        "properties" : {
+          "agentId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "type" : {
+            "type" : "string"
+          },
+          "model" : {
+            "type" : "string"
+          },
+          "provider" : {
+            "type" : "string"
+          },
+          "units" : {
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "MetricForDay_inner" : {
+        "properties" : {
+          "_id" : {
+            "$ref" : "#/components/schemas/MetricForDay_inner__id"
+          },
+          "total" : {
+            "type" : "number"
+          },
+          "count" : {
+            "type" : "number"
+          },
+          "timestamp" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "required" : [ "_id" ],
+        "type" : "object"
+      },
+      "MetricForVisitorByMonth_inner" : {
+        "properties" : {
+          "date" : {
+            "type" : "string"
+          },
+          "label" : {
+            "type" : "string"
+          },
+          "users" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "date", "label", "users" ],
+        "type" : "object"
+      },
+      "MetricsTopAgentsResponse_inner" : {
+        "properties" : {
+          "textConversationCount" : {
+            "type" : "number"
+          },
+          "errorConversationCount" : {
+            "type" : "number"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "MetricsTopAgentsUsageResponse_inner" : {
+        "properties" : {
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "type" : "string"
+          },
+          "usage" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "agentId", "agentName", "usage" ],
+        "type" : "object"
+      },
       "KnowledgeFileSummary_knowledgeBaseId" : {
         "oneOf" : [ {
           "type" : "string"