@breign/client 1.0.157 → 1.0.159

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.",
@@ -11545,10 +11751,10 @@
         "tags" : [ "tools" ]
       }
     },
-    "/tools/{toolId}/connection-status" : {
-      "get" : {
-        "description" : "For organization-scoped tools, returns whether the shared connection is set up.\nFor user-scoped tools, returns whether the caller has connected their own account.\n",
-        "operationId" : "getToolConnectionStatus",
+    "/tools/{toolId}/mcp/logs" : {
+      "delete" : {
+        "description" : "Drops every trace of this tool. The way out when payload capture was left on and recorded\nsomething it should not have.\n",
+        "operationId" : "deleteMcpCallLogs",
         "parameters" : [ {
           "description" : "Tool identifier",
           "in" : "path",
@@ -11563,11 +11769,11 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/ToolConnectionStatusResponse"
+                  "$ref" : "#/components/schemas/McpCallLogsDeletedResponse"
                 }
               }
             },
-            "description" : "Connection status"
+            "description" : "Traces erased"
           },
           "403" : {
             "description" : "Forbidden"
@@ -11576,99 +11782,261 @@
             "description" : "Tool not found"
           }
         },
-        "summary" : "Get the current user's connection status for a tool",
+        "summary" : "Erase the MCP traces of a tool",
         "tags" : [ "tools" ]
-      }
-    },
-    "/skills" : {
+      },
       "get" : {
-        "description" : "Returns a paginated list of skills scoped to an organization",
-        "operationId" : "listSkills",
+        "description" : "Traces of the exchanges with the MCP server of this tool, most recent first: connections,\ntoken refreshes, tool calls, and the configuration changes an administrator made.\nReserved to administrators of the organisation owning the tool — a trace names the methods\ncalled and, when payload capture is on, carries an excerpt of the exchange.\n\nPaging walks backwards through time with a composite cursor. Both halves of `nextCursor`\nmust be sent back together: a date alone cannot separate two traces written in the same\nmillisecond.\n",
+        "operationId" : "listMcpCallLogs",
         "parameters" : [ {
-          "description" : "Organization ID",
-          "in" : "query",
-          "name" : "organizationId",
+          "description" : "Tool identifier",
+          "in" : "path",
+          "name" : "toolId",
           "required" : true,
           "schema" : {
             "type" : "string"
           }
         }, {
-          "description" : "Page number",
+          "description" : "Keeps only the traces of that kind.",
           "in" : "query",
-          "name" : "page",
+          "name" : "event",
+          "required" : false,
           "schema" : {
-            "type" : "integer"
+            "$ref" : "#/components/schemas/McpCallLogEvent"
           }
         }, {
-          "description" : "Maximum number of skills to return",
+          "description" : "Keeps only the traces that succeeded, or only those that failed.",
+          "in" : "query",
+          "name" : "status",
+          "required" : false,
+          "schema" : {
+            "$ref" : "#/components/schemas/McpCallLogStatus"
+          }
+        }, {
+          "description" : "Page size, clamped server-side.",
           "in" : "query",
           "name" : "limit",
+          "required" : false,
           "schema" : {
-            "default" : 20,
-            "maximum" : 100,
+            "default" : 50,
+            "maximum" : 200,
+            "minimum" : 1,
             "type" : "integer"
           }
+        }, {
+          "description" : "Date half of the cursor, sent back from `nextCursor` along with `beforeId`.",
+          "in" : "query",
+          "name" : "beforeCreatedAt",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Identifier half of the cursor, sent back from `nextCursor` along with `beforeCreatedAt`.",
+          "in" : "query",
+          "name" : "beforeId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
         } ],
         "responses" : {
           "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "items" : {
-                    "$ref" : "#/components/schemas/Skill"
-                  },
-                  "type" : "array"
+                  "$ref" : "#/components/schemas/McpCallLogsResponse"
                 }
               }
             },
-            "description" : "Paginated list of skills",
-            "headers" : {
-              "X-Total-Count" : {
-                "description" : "Total number of skills in the organization",
-                "schema" : {
-                  "type" : "integer"
-                }
-              },
-              "X-Page" : {
-                "description" : "Current page number",
-                "schema" : {
-                  "type" : "integer"
-                }
-              },
-              "X-Limit" : {
-                "description" : "Maximum number of items per page",
-                "schema" : {
-                  "type" : "integer"
-                }
-              },
-              "X-Total-Pages" : {
-                "description" : "Total number of pages",
-                "schema" : {
-                  "type" : "integer"
-                }
-              }
-            }
+            "description" : "A page of traces"
           },
           "400" : {
-            "description" : "MISSING_ORG_ID"
-          },
-          "401" : {
-            "description" : "Unauthorized"
+            "description" : "Unknown event or status filter"
           },
           "403" : {
             "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Tool not found"
           }
         },
-        "summary" : "List skills in an organization",
-        "tags" : [ "skills" ]
-      },
-      "post" : {
-        "description" : "Creates a new skill in an organization",
-        "operationId" : "createSkill",
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
+        "summary" : "Read the MCP traces of a tool",
+        "tags" : [ "tools" ]
+      }
+    },
+    "/tools/{toolId}/mcp/logs/settings" : {
+      "put" : {
+        "description" : "Whether the arguments and responses of the calls to this tool are kept in its traces.\n\nOff by default, and deliberately its own endpoint rather than a field of the tool: the\narguments of an MCP call carry whatever the user asked for, so switching capture on is a\ndebugging act an administrator takes knowingly, and the tool edit form can never reset it\nby accident.\n",
+        "operationId" : "updateMcpLogsSettings",
+        "parameters" : [ {
+          "description" : "Tool identifier",
+          "in" : "path",
+          "name" : "toolId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/McpLogsSettingsRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/McpLogsSettingsResponse"
+                }
+              }
+            },
+            "description" : "Capture setting applied"
+          },
+          "400" : {
+            "description" : "Invalid body"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Tool not found"
+          }
+        },
+        "summary" : "Turn MCP payload capture on or off for a tool",
+        "tags" : [ "tools" ]
+      }
+    },
+    "/tools/{toolId}/connection-status" : {
+      "get" : {
+        "description" : "For organization-scoped tools, returns whether the shared connection is set up.\nFor user-scoped tools, returns whether the caller has connected their own account.\n",
+        "operationId" : "getToolConnectionStatus",
+        "parameters" : [ {
+          "description" : "Tool identifier",
+          "in" : "path",
+          "name" : "toolId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ToolConnectionStatusResponse"
+                }
+              }
+            },
+            "description" : "Connection status"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Tool not found"
+          }
+        },
+        "summary" : "Get the current user's connection status for a tool",
+        "tags" : [ "tools" ]
+      }
+    },
+    "/skills" : {
+      "get" : {
+        "description" : "Returns a paginated list of skills scoped to an organization",
+        "operationId" : "listSkills",
+        "parameters" : [ {
+          "description" : "Organization ID",
+          "in" : "query",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Page number",
+          "in" : "query",
+          "name" : "page",
+          "schema" : {
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Maximum number of skills to return",
+          "in" : "query",
+          "name" : "limit",
+          "schema" : {
+            "default" : 20,
+            "maximum" : 100,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/Skill"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Paginated list of skills",
+            "headers" : {
+              "X-Total-Count" : {
+                "description" : "Total number of skills in the organization",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Page" : {
+                "description" : "Current page number",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Limit" : {
+                "description" : "Maximum number of items per page",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Total-Pages" : {
+                "description" : "Total number of pages",
+                "schema" : {
+                  "type" : "integer"
+                }
+              }
+            }
+          },
+          "400" : {
+            "description" : "MISSING_ORG_ID"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          }
+        },
+        "summary" : "List skills in an organization",
+        "tags" : [ "skills" ]
+      },
+      "post" : {
+        "description" : "Creates a new skill in an organization",
+        "operationId" : "createSkill",
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
                 "$ref" : "#/components/schemas/SkillCreateRequest"
               }
             }
@@ -16485,6 +16853,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"
@@ -16715,6 +17095,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" : {
@@ -16917,6 +17331,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"
@@ -17940,6 +18366,9 @@
             },
             "type" : "array"
           },
+          "humanRequest" : {
+            "$ref" : "#/components/schemas/ConversationHumanRequest"
+          },
           "suggestions" : {
             "items" : {
               "$ref" : "#/components/schemas/Suggestion"
@@ -18090,6 +18519,57 @@
         "title" : "ConversationMessageApproval",
         "type" : "object"
       },
+      "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" : {
+          "callId" : {
+            "description" : "The pending tool call the answer resolves.",
+            "type" : "string"
+          },
+          "taskConversationId" : {
+            "type" : "string"
+          },
+          "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" : {
@@ -19807,24 +20287,265 @@
           "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"
       },
-      "MarkConversationReadRequest" : {
+      "HumanRequestSummary" : {
+        "description" : "Une question en attente de réponse de l'utilisateur courant.",
         "properties" : {
-          "readAt" : {
-            "description" : "Position de lecture ; par défaut l'instant courant",
-            "format" : "date-time",
+          "callId" : {
             "type" : "string"
-          }
-        },
-        "type" : "object"
-      },
-      "ConversationSummary" : {
-        "properties" : {
-          "id" : {
+          },
+          "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" : {
+            "description" : "Position de lecture ; par défaut l'instant courant",
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
+      "ConversationSummary" : {
+        "properties" : {
+          "id" : {
             "type" : "string"
           },
           "title" : {
@@ -21912,6 +22633,197 @@
         "title" : "ToolAllowedToolsResponse",
         "type" : "object"
       },
+      "McpCallLogEvent" : {
+        "description" : "Which moment of the exchange the trace covers. Three are network — opening the connection, renewing the tokens, calling the tool — and the fourth is an administrator changing the configuration, without which \"it worked yesterday\" stays unverifiable.",
+        "enum" : [ "connect", "auth_refresh", "tool_call", "config_change" ],
+        "title" : "McpCallLogEvent",
+        "type" : "string"
+      },
+      "McpCallLogStatus" : {
+        "enum" : [ "ok", "error" ],
+        "title" : "McpCallLogStatus",
+        "type" : "string"
+      },
+      "McpCallLogsResponse" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "logs" : {
+            "items" : {
+              "$ref" : "#/components/schemas/McpCallLog"
+            },
+            "type" : "array"
+          },
+          "nextCursor" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/McpCallLogCursor"
+            } ],
+            "description" : "Null once the last page has been served.",
+            "nullable" : true
+          },
+          "payloadLogging" : {
+            "description" : "Whether this tool is currently capturing arguments and responses.",
+            "type" : "boolean"
+          },
+          "verboseLogging" : {
+            "description" : "Whether this tool records all of its activity. Off by default: only failures and configuration changes are kept, which is what an investigation actually reads.",
+            "type" : "boolean"
+          },
+          "retentionDays" : {
+            "description" : "How long traces are kept before the nightly purge drops them.",
+            "type" : "integer"
+          }
+        },
+        "required" : [ "logs", "nextCursor", "payloadLogging", "retentionDays", "verboseLogging" ],
+        "title" : "McpCallLogsResponse",
+        "type" : "object"
+      },
+      "McpCallLog" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "orgId" : {
+            "type" : "string"
+          },
+          "toolId" : {
+            "type" : "string"
+          },
+          "toolName" : {
+            "description" : "Name of the tool when the call happened; it survives a later rename.",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "event" : {
+            "$ref" : "#/components/schemas/McpCallLogEvent"
+          },
+          "method" : {
+            "description" : "MCP method called, or the configuration action for a `config_change`.",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/McpCallLogStatus"
+          },
+          "durationMs" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "serverUrl" : {
+            "description" : "Server URL without its query string, which can carry a token.",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "scope" : {
+            "enum" : [ "organization", "user" ],
+            "type" : "string"
+          },
+          "authType" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "userId" : {
+            "description" : "Whoever the exchange was made for — the owner of the credentials used. On a `config_change` it is the author of the change instead.",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "agentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "conversationId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "httpStatus" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "errorCode" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "errorMessage" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "retried" : {
+            "description" : "The call was replayed on a fresh connection after a first failure.",
+            "type" : "boolean"
+          },
+          "requestPreview" : {
+            "description" : "Captured only while payload capture is on, secrets redacted and size bounded.",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "responsePreview" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "createdAt", "event", "id", "orgId", "retried", "scope", "status", "toolId" ],
+        "title" : "McpCallLog",
+        "type" : "object"
+      },
+      "McpCallLogCursor" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "createdAt" : {
+            "type" : "string"
+          },
+          "id" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "createdAt", "id" ],
+        "title" : "McpCallLogCursor",
+        "type" : "object"
+      },
+      "McpCallLogsDeletedResponse" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "deleted" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "deleted" ],
+        "title" : "McpCallLogsDeletedResponse",
+        "type" : "object"
+      },
+      "McpLogsSettingsRequest" : {
+        "additionalProperties" : false,
+        "description" : "At least one switch. Whichever is omitted keeps its current value, so the screen can flip one without resetting the other.",
+        "minProperties" : 1,
+        "properties" : {
+          "payloads" : {
+            "description" : "Keep the arguments and responses of the calls that get recorded.",
+            "type" : "boolean"
+          },
+          "verbose" : {
+            "description" : "Record all activity, not only failures and configuration changes.",
+            "type" : "boolean"
+          }
+        },
+        "title" : "McpLogsSettingsRequest",
+        "type" : "object"
+      },
+      "McpLogsSettingsResponse" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "payloads" : {
+            "type" : "boolean"
+          },
+          "verbose" : {
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "payloads", "verbose" ],
+        "title" : "McpLogsSettingsResponse",
+        "type" : "object"
+      },
       "ToolConnectionStatusResponse" : {
         "additionalProperties" : false,
         "properties" : {
@@ -25378,6 +26290,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" : {
@@ -25887,6 +26813,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" : {