@breign/client 1.0.156 → 1.0.158

package/dist/openapi.json

@@ -81,6 +81,9 @@
   }, {
     "description" : "Super-admin only endpoints",
     "name" : "admin"
+  }, {
+    "description" : "MCP server for local agents (Claude Code, Pi, Hermes…)",
+    "name" : "mcp"
   } ],
   "paths" : {
     "/health" : {
@@ -5429,6 +5432,209 @@
         "tags" : [ "conversations" ]
       }
     },
+    "/organizations/{organizationId}/chat/human-requests" : {
+      "get" : {
+        "description" : "Questions posées par des agents (outil Human_ask) depuis des conversations de tâche et qui attendent une réponse de l'utilisateur courant. Les questions échues sont expirées au passage et n'apparaissent pas.",
+        "operationId" : "listPendingHumanRequests",
+        "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/HumanRequestSummary"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Pending questions"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — the caller is not part of the organization"
+          }
+        },
+        "summary" : "List the questions waiting for the current user",
+        "tags" : [ "conversations" ]
+      }
+    },
+    "/human-requests/{callId}/answer" : {
+      "post" : {
+        "description" : "Répond (ou décline) une question posée par un agent via Human_ask. Termine l'appel différé et relance le tour de la tâche en arrière-plan. Seul l'humain à qui la question a été adressée peut y répondre.",
+        "operationId" : "answerHumanRequest",
+        "parameters" : [ {
+          "in" : "path",
+          "name" : "callId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/HumanRequestAnswer"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "202" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/HumanRequestAnswerResult"
+                }
+              }
+            },
+            "description" : "Answer recorded, the task resumes"
+          },
+          "400" : {
+            "description" : "Neither an answer nor a decline"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "404" : {
+            "description" : "No such question for this user"
+          },
+          "409" : {
+            "description" : "Already answered"
+          },
+          "410" : {
+            "description" : "Expired"
+          }
+        },
+        "summary" : "Answer a question asked by an agent",
+        "tags" : [ "conversations" ]
+      }
+    },
+    "/organizations/{organizationId}/mcp" : {
+      "delete" : {
+        "description" : "Aucune session à clore : le transport est sans état.",
+        "operationId" : "deleteMcpSession",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "405" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/McpJsonRpcResponse"
+                }
+              }
+            },
+            "description" : "Method not allowed"
+          }
+        },
+        "summary" : "Not supported (stateless MCP server)",
+        "tags" : [ "mcp" ]
+      },
+      "get" : {
+        "description" : "Pas de flux SSE côté serveur : le transport est sans état.",
+        "operationId" : "getMcpStream",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "405" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/McpJsonRpcResponse"
+                }
+              }
+            },
+            "description" : "Method not allowed"
+          }
+        },
+        "summary" : "Not supported (stateless MCP server)",
+        "tags" : [ "mcp" ]
+      },
+      "post" : {
+        "description" : "Serveur MCP (Model Context Protocol, transport Streamable HTTP, sans état) par lequel les agents locaux — Claude Code, Pi, Hermes… — interrogent les agents Breign de l'organisation.\n\nAuthentification par clé API personnelle (`x-api-key` ou `Authorization: Bearer ai-…`) ; les credentials d'app et la clé maître sans `x-user-id` sont refusés. Seuls les agents dont `mcpExposureConfiguration.enabled` est vrai sont joignables.\n\nOutils exposés :\n- `list_agents` — agents joignables, avec leur rôle et leur description.\n- `ask_agent` `{ agentId, message, conversationId?, waitSeconds? }` — pose une question ;\n  attend la réponse jusqu'à `waitSeconds` (25 s par défaut, 50 s max), sinon rend un ticket.\n\n- `wait_for_reply` `{ ticket, timeoutSeconds? }` — attend la réponse d'un ticket (45 s par\n  défaut, 50 s max).\n\n\nChaque question vit dans une conversation de tâche au nom du propriétaire de la clé. L'agent interrogé peut consulter d'autres agents ou poser une question à un humain (outil Human_ask) : le statut vaut alors `waiting_human`, parfois pendant des heures.\n\nConfiguration d'un client, par exemple Claude Code : `claude mcp add --transport http breign https://<api>/organizations/<organizationId>/mcp --header \"Authorization: Bearer ai-…\"`. Le client doit accepter `application/json` et `text/event-stream` (header `Accept`).",
+        "operationId" : "handleMcpRequest",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/McpJsonRpcRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/McpJsonRpcResponse"
+                }
+              }
+            },
+            "description" : "Réponse JSON-RPC"
+          },
+          "202" : {
+            "description" : "Notification acceptée, sans corps"
+          },
+          "401" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/McpJsonRpcResponse"
+                }
+              }
+            },
+            "description" : "Clé API personnelle requise"
+          },
+          "403" : {
+            "description" : "Forbidden — the caller is not part of the organization"
+          },
+          "404" : {
+            "description" : "Serveur MCP désactivé sur ce déploiement"
+          }
+        },
+        "summary" : "MCP server for local agents",
+        "tags" : [ "mcp" ]
+      }
+    },
     "/conversations/{conversationId}/read" : {
       "post" : {
         "description" : "Positionne la marque de lecture de l'utilisateur sur la conversation.",
@@ -7293,6 +7499,58 @@
         "tags" : [ "metrics" ]
       }
     },
+    "/metrics/organizations/{organizationId}/model-consumption" : {
+      "get" : {
+        "description" : "Tokens consumed by model and provider, split between agents, organization costs without an agent, direct AI Gateway calls, and users. Restricted to organization administrators.",
+        "operationId" : "getMetricsOrganizationModelConsumption",
+        "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" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "End date for metrics (ISO format)",
+          "in" : "query",
+          "name" : "endDate",
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/OrganizationModelConsumption"
+                }
+              }
+            },
+            "description" : "Model consumption retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "500" : {
+            "description" : "Server error"
+          }
+        },
+        "summary" : "Get model consumption for an organization",
+        "tags" : [ "metrics" ]
+      }
+    },
     "/agents/{agentId}/guardians" : {
       "get" : {
         "operationId" : "getGuardiansForAgent",
@@ -16433,6 +16691,18 @@
             } ],
             "nullable" : true
           },
+          "mcpExposureConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentMcpExposureConfiguration"
+            } ],
+            "nullable" : true
+          },
+          "humanEscalationConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentHumanEscalationConfiguration"
+            } ],
+            "nullable" : true
+          },
           "codeModeConfiguration" : {
             "allOf" : [ {
               "$ref" : "#/components/schemas/AgentCodeModeConfiguration"
@@ -16663,6 +16933,40 @@
         },
         "type" : "object"
       },
+      "AgentMcpExposureConfiguration" : {
+        "description" : "Reachability from local agents (Claude Code, Pi, Hermes…) through Breign's MCP server. Opt-in: an agent nobody exposed is invisible to list_agents and refuses ask_agent.",
+        "properties" : {
+          "enabled" : {
+            "description" : "Makes this agent reachable from local agents.",
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "AgentHumanEscalationConfiguration" : {
+        "description" : "Per-agent activation of the Human_ask tool, offered only in task conversations (a local agent or another agent asking). The question goes to the first valid referent; without one, to the user who owns the task — the person who connected the local agent.",
+        "properties" : {
+          "enabled" : {
+            "description" : "Enables the Human_ask tool for this agent.",
+            "type" : "boolean"
+          },
+          "referentUserIds" : {
+            "description" : "Organisation members who answer this agent's questions, in order of preference.",
+            "items" : {
+              "type" : "string"
+            },
+            "maxItems" : 5,
+            "type" : "array"
+          },
+          "questionTtlHours" : {
+            "description" : "How long a question stays answerable. Past it, the agent resumes on its own assumption.",
+            "maximum" : 168,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        },
+        "type" : "object"
+      },
       "AgentCodeModeConfiguration" : {
         "description" : "Per-agent activation of code mode: the model writes a JavaScript/TypeScript program that calls the agent's tools inside a sandbox, instead of one tool call per round trip. Opt-in, and narrower than it looks — only the tools declared code-mode callable server-side are reachable from a program. The server configuration can only narrow this.",
         "properties" : {
@@ -16865,6 +17169,18 @@
             } ],
             "nullable" : true
           },
+          "mcpExposureConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentMcpExposureConfiguration"
+            } ],
+            "nullable" : true
+          },
+          "humanEscalationConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentHumanEscalationConfiguration"
+            } ],
+            "nullable" : true
+          },
           "codeModeConfiguration" : {
             "allOf" : [ {
               "$ref" : "#/components/schemas/AgentCodeModeConfiguration"
@@ -17888,6 +18204,9 @@
             },
             "type" : "array"
           },
+          "humanRequest" : {
+            "$ref" : "#/components/schemas/ConversationHumanRequest"
+          },
           "suggestions" : {
             "items" : {
               "$ref" : "#/components/schemas/Suggestion"
@@ -18038,20 +18357,71 @@
         "title" : "ConversationMessageApproval",
         "type" : "object"
       },
-      "Suggestion" : {
+      "ConversationHumanRequest" : {
+        "description" : "A question an agent asks a human from a task conversation (Human_ask tool). Carried by a mirror message in the human's chat conversation with that agent, which is where they see and answer it. The task stays suspended on the pending call callId until the answer resumes it.",
         "properties" : {
-          "id" : {
+          "callId" : {
+            "description" : "The pending tool call the answer resolves.",
             "type" : "string"
           },
-          "text" : {
+          "taskConversationId" : {
             "type" : "string"
-          }
-        },
-        "required" : [ "id", "text" ],
-        "type" : "object"
-      },
-      "FileAttachment" : {
-        "properties" : {
+          },
+          "taskMessageId" : {
+            "type" : "string"
+          },
+          "question" : {
+            "type" : "string"
+          },
+          "options" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "context" : {
+            "description" : "What is blocked and why, as the agent put it.",
+            "type" : "string"
+          },
+          "requestedBy" : {
+            "$ref" : "#/components/schemas/ConversationHumanRequest_requestedBy"
+          },
+          "status" : {
+            "enum" : [ "pending", "answered", "declined", "expired" ],
+            "type" : "string"
+          },
+          "answer" : {
+            "type" : "string"
+          },
+          "answeredBy" : {
+            "description" : "Name or email of the person who answered, as it stood when they answered.",
+            "type" : "string"
+          },
+          "answeredAt" : {
+            "type" : "string"
+          },
+          "expiresAt" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "callId", "question", "requestedBy", "status", "taskConversationId", "taskMessageId" ],
+        "title" : "ConversationHumanRequest",
+        "type" : "object"
+      },
+      "Suggestion" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "text" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "text" ],
+        "type" : "object"
+      },
+      "FileAttachment" : {
+        "properties" : {
           "type" : {
             "$ref" : "#/components/schemas/AttachmentType"
           },
@@ -19755,11 +20125,252 @@
           "isGenerating" : {
             "description" : "Vrai tant qu'une réponse est en cours de génération",
             "type" : "boolean"
+          },
+          "pendingHumanRequests" : {
+            "description" : "Questions de cet agent qui attendent une réponse de l'utilisateur courant (outil Human_ask), toutes tâches confondues.",
+            "type" : "integer"
           }
         },
         "required" : [ "agentId", "conversationId", "isGenerating", "unreadCount" ],
         "type" : "object"
       },
+      "HumanRequestSummary" : {
+        "description" : "Une question en attente de réponse de l'utilisateur courant.",
+        "properties" : {
+          "callId" : {
+            "type" : "string"
+          },
+          "agentId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "humanConversationId" : {
+            "description" : "Conversation de l'utilisateur avec l'agent, où la question est affichée.",
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "humanMessageId" : {
+            "type" : "string"
+          },
+          "taskConversationId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "taskMessageId" : {
+            "type" : "string"
+          },
+          "question" : {
+            "type" : "string"
+          },
+          "options" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "requestedBy" : {
+            "$ref" : "#/components/schemas/HumanRequestSummary_requestedBy"
+          },
+          "expiresAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "callId", "humanConversationId", "question", "taskConversationId", "taskMessageId" ],
+        "type" : "object"
+      },
+      "HumanRequestAnswer" : {
+        "description" : "Réponse à une question. Soit une réponse non vide, soit decline à vrai : l'agent repart alors sur sa meilleure hypothèse.",
+        "properties" : {
+          "answer" : {
+            "type" : "string"
+          },
+          "decline" : {
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "HumanRequestAnswerResult" : {
+        "properties" : {
+          "status" : {
+            "enum" : [ "answered", "declined" ],
+            "type" : "string"
+          }
+        },
+        "required" : [ "status" ],
+        "type" : "object"
+      },
+      "McpJsonRpcResponse" : {
+        "description" : "Réponse JSON-RPC 2.0 ; `result` ou `error`, jamais les deux.",
+        "properties" : {
+          "jsonrpc" : {
+            "enum" : [ "2.0" ],
+            "type" : "string"
+          },
+          "id" : {
+            "$ref" : "#/components/schemas/McpJsonRpcResponse_id"
+          },
+          "result" : {
+            "$ref" : "#/components/schemas/McpCallToolResult"
+          },
+          "error" : {
+            "$ref" : "#/components/schemas/McpJsonRpcError"
+          }
+        },
+        "required" : [ "jsonrpc" ],
+        "type" : "object"
+      },
+      "McpCallToolResult" : {
+        "additionalProperties" : true,
+        "description" : "Résultat d'un tools/call (CallToolResult MCP). Les autres méthodes (initialize, tools/list) rendent leur propre résultat, conforme à la spécification MCP.",
+        "properties" : {
+          "content" : {
+            "description" : "Texte destiné au modèle, consigne suivante comprise.",
+            "items" : {
+              "$ref" : "#/components/schemas/McpTextContent"
+            },
+            "type" : "array"
+          },
+          "structuredContent" : {
+            "$ref" : "#/components/schemas/McpCallToolResult_structuredContent"
+          },
+          "isError" : {
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "McpTextContent" : {
+        "properties" : {
+          "type" : {
+            "enum" : [ "text" ],
+            "type" : "string"
+          },
+          "text" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "text", "type" ],
+        "type" : "object"
+      },
+      "McpTicketView" : {
+        "description" : "Contenu structuré rendu par les outils ask_agent et wait_for_reply. Tant que le statut est pending ou waiting_human, l'agent local rappelle wait_for_reply avec le ticket.",
+        "properties" : {
+          "status" : {
+            "enum" : [ "pending", "waiting_human", "completed", "failed" ],
+            "type" : "string"
+          },
+          "ticket" : {
+            "description" : "`<conversationId>/<messageId>` du message qui portera la réponse.",
+            "type" : "string"
+          },
+          "conversationId" : {
+            "description" : "Fil à passer à ask_agent pour poursuivre dans la même conversation.",
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "messageId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "agentName" : {
+            "type" : "string"
+          },
+          "reply" : {
+            "description" : "Présent quand status vaut completed.",
+            "type" : "string"
+          },
+          "activity" : {
+            "description" : "Ce que fait l'agent quand status vaut pending.",
+            "type" : "string"
+          },
+          "question" : {
+            "description" : "Question posée à un humain quand status vaut waiting_human.",
+            "type" : "string"
+          },
+          "options" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "human" : {
+            "description" : "Nom ou e-mail de l'humain attendu.",
+            "type" : "string"
+          },
+          "askingAgentName" : {
+            "description" : "Agent qui pose la question, quand ce n'est pas l'agent interrogé (escalade en chaîne).",
+            "type" : "string"
+          },
+          "expiresAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "error" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "conversationId", "messageId", "status", "ticket" ],
+        "type" : "object"
+      },
+      "McpAgentList" : {
+        "properties" : {
+          "agents" : {
+            "items" : {
+              "$ref" : "#/components/schemas/McpAgentList_agents_inner"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "agents" ],
+        "type" : "object"
+      },
+      "McpJsonRpcError" : {
+        "properties" : {
+          "code" : {
+            "description" : "-32000 méthode HTTP non supportée, -32001 clé API personnelle requise, -32603 erreur interne ; les codes JSON-RPC standards pour les requêtes mal formées.",
+            "type" : "integer"
+          },
+          "message" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "code", "message" ],
+        "type" : "object"
+      },
+      "McpJsonRpcRequest" : {
+        "description" : "Message JSON-RPC 2.0 du Model Context Protocol (transport Streamable HTTP). Les méthodes utiles sont initialize, notifications/initialized, tools/list et tools/call. Un lot (tableau de messages) est aussi accepté par le transport.",
+        "properties" : {
+          "jsonrpc" : {
+            "enum" : [ "2.0" ],
+            "type" : "string"
+          },
+          "id" : {
+            "$ref" : "#/components/schemas/McpJsonRpcRequest_id"
+          },
+          "method" : {
+            "example" : "tools/call",
+            "type" : "string"
+          },
+          "params" : {
+            "additionalProperties" : true,
+            "example" : {
+              "name" : "ask_agent",
+              "arguments" : {
+                "agentId" : "Product Owner",
+                "message" : "Quels sont les critères d'acceptation de la fonctionnalité X ?"
+              }
+            },
+            "type" : "object"
+          }
+        },
+        "required" : [ "jsonrpc", "method" ],
+        "type" : "object"
+      },
       "MarkConversationReadRequest" : {
         "properties" : {
           "readAt" : {
@@ -20440,6 +21051,92 @@
         },
         "type" : "array"
       },
+      "OrganizationModelConsumption" : {
+        "properties" : {
+          "total" : {
+            "$ref" : "#/components/schemas/OrganizationModelConsumption_total"
+          },
+          "byModel" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ModelConsumptionItem"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "byModel", "total" ],
+        "type" : "object"
+      },
+      "ModelConsumptionItem" : {
+        "properties" : {
+          "provider" : {
+            "description" : "Identifiant stable du moteur. Les lignes historiques d'agent portent encore le type (openai, mistral).",
+            "type" : "string"
+          },
+          "providerName" : {
+            "description" : "Nom du moteur écrit au moment de l'appel. Repli sur l'identifiant lorsqu'aucun nom n'est connu.",
+            "type" : "string"
+          },
+          "model" : {
+            "type" : "string"
+          },
+          "requests" : {
+            "type" : "number"
+          },
+          "inputTokens" : {
+            "type" : "number"
+          },
+          "outputTokens" : {
+            "type" : "number"
+          },
+          "totalTokens" : {
+            "type" : "number"
+          },
+          "sources" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ModelConsumptionSlice"
+            },
+            "type" : "array"
+          },
+          "users" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ModelConsumptionSlice"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "inputTokens", "model", "outputTokens", "provider", "providerName", "requests", "sources", "totalTokens", "users" ],
+        "type" : "object"
+      },
+      "ModelConsumptionSlice" : {
+        "description" : "Part de consommation sur une source (agent, gateway, organisation) ou un utilisateur.",
+        "properties" : {
+          "key" : {
+            "type" : "string"
+          },
+          "kind" : {
+            "enum" : [ "agent", "gateway", "organization", "user" ],
+            "type" : "string"
+          },
+          "label" : {
+            "description" : "Nom d'agent ou email. Vide pour une consommation non attribuée à un utilisateur.",
+            "type" : "string"
+          },
+          "requests" : {
+            "type" : "number"
+          },
+          "inputTokens" : {
+            "type" : "number"
+          },
+          "outputTokens" : {
+            "type" : "number"
+          },
+          "totalTokens" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "inputTokens", "key", "kind", "label", "outputTokens", "requests", "totalTokens" ],
+        "type" : "object"
+      },
       "Guardian" : {
         "properties" : {
           "id" : {
@@ -25240,6 +25937,20 @@
         "required" : [ "tool" ],
         "type" : "object"
       },
+      "ConversationHumanRequest_requestedBy" : {
+        "properties" : {
+          "kind" : {
+            "enum" : [ "local_agent", "agent" ],
+            "type" : "string"
+          },
+          "label" : {
+            "description" : "Local client name (e.g. claude-code) or the calling agent's name.",
+            "type" : "string"
+          }
+        },
+        "required" : [ "kind" ],
+        "type" : "object"
+      },
       "FileAttachment_processed_oneOf" : {
         "properties" : {
           "type" : {
@@ -25749,6 +26460,61 @@
         "required" : [ "contentType", "ext", "size" ],
         "type" : "object"
       },
+      "HumanRequestSummary_requestedBy" : {
+        "properties" : {
+          "kind" : {
+            "enum" : [ "local_agent", "agent" ],
+            "type" : "string"
+          },
+          "label" : {
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "McpJsonRpcResponse_id" : {
+        "nullable" : true,
+        "oneOf" : [ {
+          "type" : "string"
+        }, {
+          "type" : "integer"
+        } ]
+      },
+      "McpCallToolResult_structuredContent" : {
+        "description" : "McpTicketView pour ask_agent et wait_for_reply, McpAgentList pour list_agents.",
+        "oneOf" : [ {
+          "$ref" : "#/components/schemas/McpTicketView"
+        }, {
+          "$ref" : "#/components/schemas/McpAgentList"
+        } ]
+      },
+      "McpAgentList_agents_inner" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "role" : {
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
+      "McpJsonRpcRequest_id" : {
+        "description" : "Absent sur une notification.",
+        "oneOf" : [ {
+          "type" : "string"
+        }, {
+          "type" : "integer"
+        } ]
+      },
       "ConversationSummary_agent_engine_provider" : {
         "properties" : {
           "name" : {
@@ -25926,6 +26692,27 @@
         "required" : [ "agentId", "agentName", "usage" ],
         "type" : "object"
       },
+      "OrganizationModelConsumption_total" : {
+        "properties" : {
+          "requests" : {
+            "type" : "number"
+          },
+          "inputTokens" : {
+            "type" : "number"
+          },
+          "outputTokens" : {
+            "type" : "number"
+          },
+          "totalTokens" : {
+            "type" : "number"
+          },
+          "uniqueUsers" : {
+            "type" : "number"
+          }
+        },
+        "required" : [ "inputTokens", "outputTokens", "requests", "totalTokens", "uniqueUsers" ],
+        "type" : "object"
+      },
       "OrganizationMember_user" : {
         "properties" : {
           "email" : {