@breign/client 1.0.124 → 1.0.125

package/dist/openapi.json

@@ -99,7 +99,7 @@
         "description" : "Get all agents accessible to user",
         "operationId" : "getAgents",
         "parameters" : [ {
-          "description" : "If true, only returns agents created by the authenticated user.\n",
+          "description" : "If true, only returns agents created by the authenticated user.",
           "in" : "query",
           "name" : "isCreator",
           "required" : false,
@@ -115,6 +115,49 @@
             "enum" : [ "EXTERNAL", "INTERNAL" ],
             "type" : "string"
           }
+        }, {
+          "in" : "query",
+          "name" : "page",
+          "required" : false,
+          "schema" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "maximum" : 500,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "search",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "explode" : true,
+          "in" : "query",
+          "name" : "roleIds",
+          "required" : false,
+          "schema" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "style" : "form"
+        }, {
+          "in" : "query",
+          "name" : "personal",
+          "required" : false,
+          "schema" : {
+            "type" : "boolean"
+          }
         } ],
         "responses" : {
           "200" : {
@@ -128,7 +171,33 @@
                 }
               }
             },
-            "description" : "Agents retrieved successfully"
+            "description" : "Agents retrieved successfully",
+            "headers" : {
+              "X-Total-Count" : {
+                "description" : "Total number of agents",
+                "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"
+                }
+              }
+            }
           }
         },
         "summary" : "Get all agents",
@@ -234,7 +303,7 @@
     },
     "/agents/{agentId}" : {
       "delete" : {
-        "description" : "Deletes an agent and all its associated flows",
+        "description" : "Deletes an agent by ID",
         "operationId" : "deleteAgentById",
         "parameters" : [ {
           "description" : "ID of the agent",
@@ -327,7 +396,7 @@
             "content" : {
               "application/json" : {
                 "schema" : {
-                  "$ref" : "#/components/schemas/AgentPatch"
+                  "$ref" : "#/components/schemas/Agent"
                 }
               }
             },
@@ -411,7 +480,7 @@
           "content" : {
             "application/json" : {
               "schema" : {
-                "$ref" : "#/components/schemas/AgentModule"
+                "$ref" : "#/components/schemas/addModule_request"
               }
             }
           },
@@ -906,7 +975,7 @@
     },
     "/agents/{agentId}/flows/{flowId}" : {
       "delete" : {
-        "description" : "Deletes a specific conversation flow",
+        "description" : "Deletes an existing conversation flow",
         "operationId" : "deleteFlow",
         "parameters" : [ {
           "description" : "ID of the agent",
@@ -1645,7 +1714,7 @@
     },
     "/agents/{agentId}/tools/{toolId}" : {
       "delete" : {
-        "description" : "Removes a tool from the specified agent",
+        "description" : "Unlinks an organization tool from the specified agent",
         "operationId" : "unlinkToolFromAgent",
         "parameters" : [ {
           "description" : "ID of the agent",
@@ -1676,7 +1745,7 @@
             "description" : "Forbidden - User doesn't have access to this agent"
           },
           "404" : {
-            "description" : "Agent not found"
+            "description" : "Agent or tool not found"
           },
           "500" : {
             "description" : "Internal server error"
@@ -2706,7 +2775,7 @@
           }
         } ],
         "responses" : {
-          "200" : {
+          "206" : {
             "content" : {
               "application/json" : {
                 "schema" : {
@@ -5857,10 +5926,10 @@
         "tags" : [ "metrics" ]
       }
     },
-    "/metrics/agents" : {
+    "/metrics/brains" : {
       "get" : {
-        "description" : "Retrieves usage metrics broken down by agent within a date range (admin only)",
-        "operationId" : "getMetricsAgents",
+        "description" : "Retrieves usage metrics broken down by agent within an optional date range (admin only)",
+        "operationId" : "getBrainsMetrics",
         "parameters" : [ {
           "description" : "Start date for metrics (ISO format)",
           "in" : "query",
@@ -5888,7 +5957,7 @@
                 }
               }
             },
-            "description" : "Agent metrics retrieved successfully"
+            "description" : "Brains metrics retrieved successfully"
           },
           "400" : {
             "description" : "Invalid date format"
@@ -5903,7 +5972,7 @@
             "description" : "Server error"
           }
         },
-        "summary" : "Get agent-specific metrics",
+        "summary" : "Get brains metrics",
         "tags" : [ "metrics" ]
       }
     },
@@ -7419,92 +7488,6 @@
         "tags" : [ "organizations" ]
       }
     },
-    "/organizations/{organizationId}/users/{userId}/agents-access" : {
-      "get" : {
-        "operationId" : "getOrganizationUserAgentsAccess",
-        "parameters" : [ {
-          "description" : "ID of the organization",
-          "in" : "path",
-          "name" : "organizationId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        }, {
-          "in" : "path",
-          "name" : "userId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/UserAgentAccess"
-                }
-              }
-            },
-            "description" : "User agent access configuration"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "404" : {
-            "description" : "Organization or user not found"
-          }
-        },
-        "summary" : "Get user agent access configuration",
-        "tags" : [ "organizations" ]
-      },
-      "put" : {
-        "operationId" : "setOrganizationUserAgentsAccess",
-        "parameters" : [ {
-          "description" : "ID of the organization",
-          "in" : "path",
-          "name" : "organizationId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        }, {
-          "in" : "path",
-          "name" : "userId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/UserAgentAccessRequest"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "204" : {
-            "description" : "User agent access updated"
-          },
-          "400" : {
-            "description" : "Invalid request body"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "404" : {
-            "description" : "Organization or user not found"
-          }
-        },
-        "summary" : "Set user agent access configuration",
-        "tags" : [ "organizations" ]
-      }
-    },
     "/organizations/{organizationId}/engine" : {
       "get" : {
         "description" : "Retrieves only the engine configuration (providerId, model, options) for a given organization.",
@@ -7546,11 +7529,25 @@
         "tags" : [ "organizations" ]
       }
     },
-    "/organizations/{organizationId}/metrics/agents/{agentId}" : {
+    "/organizations/{organizationId}/agents/{agentId}" : {
       "get" : {
         "description" : "Retrieves metrics for a brain agent",
         "operationId" : "getMetricsBrainsAgent",
         "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",
@@ -7579,6 +7576,9 @@
             },
             "description" : "Metrics for a brain agent found"
           },
+          "400" : {
+            "description" : "Invalid date format"
+          },
           "401" : {
             "description" : "Unauthorized"
           },
@@ -7787,41 +7787,6 @@
         "tags" : [ "manifests" ]
       }
     },
-    "/agents/{agentId}/knowledge/resets" : {
-      "post" : {
-        "description" : "Deletes all knowledge embeddings and files associated with an agent",
-        "operationId" : "resetAgentKnowledge",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        } ],
-        "responses" : {
-          "204" : {
-            "description" : "Knowledge base reset successfully"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this agent"
-          },
-          "404" : {
-            "description" : "Agent not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Reset all knowledge for an agent",
-        "tags" : [ "knowledge" ]
-      }
-    },
     "/agents/{agentId}/knowledge-files" : {
       "get" : {
         "description" : "Returns all knowledge bases attached to the agent and their indexed files.",
@@ -7883,424 +7848,70 @@
         "tags" : [ "knowledge" ]
       }
     },
-    "/agents/{agentId}/knowledge/project-imports" : {
+    "/organizations/{organizationId}/modules" : {
       "post" : {
-        "description" : "Imports project data from a local JSON file into the agent's knowledge base",
-        "operationId" : "importProjectsToAgentKnowledge",
+        "description" : "Create a new module for an organization",
+        "operationId" : "createModuleForOrganization",
         "parameters" : [ {
-          "description" : "ID of the agent",
+          "description" : "ID of the organization",
           "in" : "path",
-          "name" : "agentId",
+          "name" : "organizationId",
           "required" : true,
           "schema" : {
-            "format" : "uuid",
             "type" : "string"
           }
         } ],
-        "responses" : {
-          "200" : {
-            "description" : "Project import started successfully"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this agent"
-          },
-          "404" : {
-            "description" : "Agent not found or ContextualKnowledgeWeaviate module not installed"
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AgentModule"
+              }
+            }
           },
-          "500" : {
-            "description" : "Server error"
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AgentModule"
+                }
+              }
+            },
+            "description" : "Module created successfully"
           }
         },
-        "summary" : "Import projects into agent knowledge",
+        "summary" : "Create a new module for an organization",
         "tags" : [ "knowledge" ]
       }
     },
-    "/agents/{agentId}/knowledge/documents" : {
-      "post" : {
-        "description" : "Adds a text document to the agent's knowledge base, splitting it into chunks if necessary",
-        "operationId" : "addDocumentToKnowledgeBase",
+    "/organizations/{organizationId}/agents/{agentId}/available-knowledge-bases" : {
+      "get" : {
+        "description" : "Returns all knowledge bases belonging to the organization that can be assigned to the specified agent…\n",
+        "operationId" : "getAvailableKnowledgeBases",
         "parameters" : [ {
-          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
           "in" : "path",
           "name" : "agentId",
           "required" : true,
           "schema" : {
-            "format" : "uuid",
             "type" : "string"
           }
         }, {
-          "description" : "Whether to disable automatic document splitting",
+          "description" : "Optional prefix used to filter knowledge bases by name (autocomplete). Case-insensitive.\n",
           "in" : "query",
-          "name" : "noSplit",
+          "name" : "searchName",
+          "required" : false,
           "schema" : {
-            "type" : "boolean"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/DocumentAddRequest"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "201" : {
-            "description" : "Document imported successfully"
-          },
-          "400" : {
-            "description" : "Invalid request body"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this brain"
-          },
-          "404" : {
-            "description" : "Brain not found or ContextualKnowledgeWeaviate module not installed"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Add a document to agent's knowledge base",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/agents/{agentId}/knowledge/file-imports" : {
-      "post" : {
-        "description" : "Processes documents like PDFs, CSVs, and text files, and adds them to the brain's knowledge base",
-        "operationId" : "importFileToAgentKnowledge",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "multipart/form-data" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/importFileToAgentKnowledge_request"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/importFileToAgentKnowledge_200_response"
-                }
-              }
-            },
-            "description" : "File imported successfully"
-          },
-          "400" : {
-            "description" : "Invalid file or parameters"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this brain"
-          },
-          "404" : {
-            "description" : "Brain not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Upload and import a file into the brain's knowledge base",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/agents/{agentId}/knowledge/files" : {
-      "post" : {
-        "description" : "Registers a file for upload to the brain's knowledge base and returns an upload URL",
-        "operationId" : "prepareFileUpload",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/FileCreationRequest"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "201" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/FileCreationResponse"
-                }
-              }
-            },
-            "description" : "File preparation successful with upload URL"
-          },
-          "400" : {
-            "description" : "Invalid file description"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this brain"
-          },
-          "404" : {
-            "description" : "Brain not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Prepare file upload for knowledge base",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/agents/{agentId}/knowledge/files/{fileId}/status" : {
-      "post" : {
-        "description" : "Updates the status of a knowledge file and triggers the indexing process if the file is uploaded",
-        "operationId" : "updateFileStatus",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        }, {
-          "description" : "The ID of the file",
-          "in" : "path",
-          "name" : "fileId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/FileStatusUpdateRequest"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/File"
-                }
-              }
-            },
-            "description" : "File status updated and indexing initiated"
-          },
-          "400" : {
-            "description" : "Invalid status update"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this agent"
-          },
-          "404" : {
-            "description" : "File not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Update file status and trigger indexing",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/agents/{agentId}/knowledge/files/{fileId}" : {
-      "delete" : {
-        "description" : "Removes a file and its associated chunks from the agent's knowledge base",
-        "operationId" : "deleteFileFromAgentKnowledge",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        }, {
-          "description" : "The ID of the file",
-          "in" : "path",
-          "name" : "fileId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "responses" : {
-          "204" : {
-            "description" : "File deleted successfully"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this agent"
-          },
-          "404" : {
-            "description" : "Agent or file not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Delete a knowledge file from an agent",
-        "tags" : [ "knowledge" ]
-      },
-      "get" : {
-        "description" : "Retrieves metadata for a file that has been imported into the agent's knowledge base",
-        "operationId" : "getFileFromAgentKnowledge",
-        "parameters" : [ {
-          "description" : "ID of the agent",
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "format" : "uuid",
-            "type" : "string"
-          }
-        }, {
-          "description" : "The ID of the file",
-          "in" : "path",
-          "name" : "fileId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "responses" : {
-          "200" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/FileWithDownloadUrl"
-                }
-              }
-            },
-            "description" : "File details retrieved successfully"
-          },
-          "401" : {
-            "description" : "Unauthorized"
-          },
-          "403" : {
-            "description" : "Forbidden - User cannot access this agent"
-          },
-          "404" : {
-            "description" : "Agent or file not found"
-          },
-          "500" : {
-            "description" : "Server error"
-          }
-        },
-        "summary" : "Get a specific knowledge file from an agent",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/organizations/{organizationId}/modules" : {
-      "post" : {
-        "description" : "Create a new module for an organization",
-        "operationId" : "createModuleForOrganization",
-        "parameters" : [ {
-          "description" : "ID of the organization",
-          "in" : "path",
-          "name" : "organizationId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        } ],
-        "requestBody" : {
-          "content" : {
-            "application/json" : {
-              "schema" : {
-                "$ref" : "#/components/schemas/AgentModule"
-              }
-            }
-          },
-          "required" : true
-        },
-        "responses" : {
-          "201" : {
-            "content" : {
-              "application/json" : {
-                "schema" : {
-                  "$ref" : "#/components/schemas/AgentModule"
-                }
-              }
-            },
-            "description" : "Module created successfully"
-          }
-        },
-        "summary" : "Create a new module for an organization",
-        "tags" : [ "knowledge" ]
-      }
-    },
-    "/organizations/{organizationId}/agents/{agentId}/available-knowledge-bases" : {
-      "get" : {
-        "description" : "Returns all knowledge bases belonging to the organization that can be assigned to the specified agent…\n",
-        "operationId" : "getAvailableKnowledgeBases",
-        "parameters" : [ {
-          "in" : "path",
-          "name" : "organizationId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        }, {
-          "in" : "path",
-          "name" : "agentId",
-          "required" : true,
-          "schema" : {
-            "type" : "string"
-          }
-        }, {
-          "description" : "Optional prefix used to filter knowledge bases by name (autocomplete). Case-insensitive.\n",
-          "in" : "query",
-          "name" : "searchName",
-          "required" : false,
-          "schema" : {
-            "type" : "string"
+            "type" : "string"
           }
         } ],
         "responses" : {
@@ -10677,6 +10288,45 @@
         "tags" : [ "skills" ]
       }
     },
+    "/skills/{skillId}/agents" : {
+      "get" : {
+        "description" : "Returns all agents that have this skill installed. La réponse est une projection minimale : les deux adaptateurs ne sélectionnent que `id` et `name` (skills-pg.adapter.ts, skills-mongodb.adapter.ts).",
+        "operationId" : "getSkillAgents",
+        "parameters" : [ {
+          "description" : "Skill identifier",
+          "in" : "path",
+          "name" : "skillId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/AgentRef"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Agents retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "404" : {
+            "description" : "Skill not found"
+          }
+        },
+        "summary" : "Get agents using a skill",
+        "tags" : [ "skills" ]
+      }
+    },
     "/agents/{agentId}/skills" : {
       "get" : {
         "operationId" : "getAgentSkills",
@@ -11085,7 +10735,7 @@
           "required" : true
         },
         "responses" : {
-          "201" : {
+          "200" : {
             "content" : {
               "application/json" : {
                 "schema" : {
@@ -11166,6 +10816,16 @@
             },
             "description" : "Prompt created successfully"
           },
+          "202" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/PromptCreateResponse"
+                }
+              }
+            },
+            "description" : "Prompt accepted (async mode). Même enveloppe que la réponse synchrone, avec `text` vide et sans suggestions ni tools puisque rien n'est encore calculé."
+          },
           "400" : {
             "description" : "Invalid request"
           },
@@ -12246,14 +11906,6 @@
           "type" : "string"
         }
       },
-      "noSplit" : {
-        "description" : "Whether to disable automatic document splitting",
-        "in" : "query",
-        "name" : "noSplit",
-        "schema" : {
-          "type" : "boolean"
-        }
-      },
       "knowledgebaseIdPath" : {
         "description" : "ID of the knowledge base to retrieve",
         "in" : "path",
@@ -12580,12 +12232,6 @@
             "additionalProperties" : true,
             "type" : "object"
           },
-          "tools" : {
-            "items" : {
-              "$ref" : "#/components/schemas/AgentTool"
-            },
-            "type" : "array"
-          },
           "knowledgeBaseIds" : {
             "items" : {
               "type" : "string"
@@ -12629,15 +12275,6 @@
           "description" : {
             "type" : "string"
           },
-          "template" : {
-            "type" : "string"
-          },
-          "color" : {
-            "type" : "string"
-          },
-          "picture" : {
-            "type" : "string"
-          },
           "createdAt" : {
             "type" : "string"
           },
@@ -12645,21 +12282,10 @@
             "type" : "string"
           },
           "isActivated" : {
-            "type" : "boolean"
-          },
-          "isTemplate" : {
-            "type" : "boolean"
-          },
-          "deleted" : {
-            "type" : "boolean"
-          },
-          "agentType" : {
-            "$ref" : "#/components/schemas/AgentType"
-          },
-          "favoriteOutfit" : {
-            "additionalProperties" : true,
-            "maxProperties" : 100,
-            "type" : "object"
+            "type" : "boolean"
+          },
+          "agentType" : {
+            "$ref" : "#/components/schemas/AgentType"
           },
           "personal" : {
             "type" : "boolean"
@@ -12700,53 +12326,16 @@
           "providerSource" : {
             "enum" : [ "EXTERNAL", "INTERNAL" ],
             "type" : "string"
-          }
-        },
-        "required" : [ "id", "modules", "name", "organisationId", "persona", "promptInit" ],
-        "type" : "object"
-      },
-      "AgentTool" : {
-        "properties" : {
-          "id" : {
-            "type" : "string"
-          },
-          "name" : {
-            "type" : "string"
-          },
-          "type" : {
-            "type" : "string"
-          },
-          "orgId" : {
-            "type" : "string"
-          },
-          "description" : {
-            "type" : "string"
-          },
-          "scope" : {
-            "description" : "Credentials scope. Defaults to organization for legacy tools.",
-            "enum" : [ "organization", "user" ],
-            "type" : "string"
-          },
-          "configuration" : {
-            "additionalProperties" : true,
-            "type" : "object"
-          },
-          "manifest" : {
-            "additionalProperties" : true,
-            "type" : "object"
-          },
-          "mcp" : {
-            "additionalProperties" : true,
-            "type" : "object"
-          },
-          "restricted" : {
-            "type" : "boolean"
           },
-          "isSetup" : {
-            "type" : "boolean"
+          "tools" : {
+            "description" : "Réhydraté en objets par GET /agents/{agentId}, le seul endpoint qui joint la table des tools de l'organisation. Les autres endpoints qui renvoient un agent (liste, création, mise à jour) omettent la propriété : en base elle ne contient que des identifiants.",
+            "items" : {
+              "$ref" : "#/components/schemas/AgentTool"
+            },
+            "type" : "array"
           }
         },
-        "required" : [ "description", "id", "name", "orgId", "type" ],
+        "required" : [ "id", "modules", "name", "organisationId", "persona", "promptInit" ],
         "type" : "object"
       },
       "Persona" : {
@@ -12869,6 +12458,50 @@
         "required" : [ "backend", "enabled", "ttlDays" ],
         "type" : "object"
       },
+      "AgentTool" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "type" : {
+            "type" : "string"
+          },
+          "orgId" : {
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "scope" : {
+            "description" : "Credentials scope. Defaults to organization for legacy tools.",
+            "enum" : [ "organization", "user" ],
+            "type" : "string"
+          },
+          "configuration" : {
+            "additionalProperties" : true,
+            "type" : "object"
+          },
+          "manifest" : {
+            "additionalProperties" : true,
+            "type" : "object"
+          },
+          "mcp" : {
+            "additionalProperties" : true,
+            "type" : "object"
+          },
+          "restricted" : {
+            "type" : "boolean"
+          },
+          "isSetup" : {
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "description", "id", "name", "orgId", "type" ],
+        "type" : "object"
+      },
       "AgentRequest" : {
         "properties" : {
           "name" : {
@@ -12877,15 +12510,9 @@
           "persona" : {
             "$ref" : "#/components/schemas/Persona"
           },
-          "engine" : {
-            "$ref" : "#/components/schemas/Engine"
-          },
           "promptInit" : {
             "$ref" : "#/components/schemas/PromptInit"
           },
-          "profilePicture" : {
-            "$ref" : "#/components/schemas/AgentRequest_profilePicture"
-          },
           "organisationId" : {
             "type" : "string"
           },
@@ -12898,32 +12525,8 @@
           "description" : {
             "type" : "string"
           },
-          "template" : {
-            "type" : "string"
-          },
-          "color" : {
-            "type" : "string"
-          },
-          "picture" : {
-            "type" : "string"
-          },
-          "createdAt" : {
-            "type" : "string"
-          },
-          "isActivated" : {
-            "type" : "boolean"
-          },
-          "modules" : {
-            "additionalProperties" : {
-              "$ref" : "#/components/schemas/AgentModule"
-            },
-            "type" : "object"
-          },
           "personal" : {
             "type" : "boolean"
-          },
-          "createdBy" : {
-            "type" : "string"
           }
         },
         "required" : [ "name", "organisationId", "persona", "promptInit" ],
@@ -12980,15 +12583,6 @@
           "description" : {
             "type" : "string"
           },
-          "template" : {
-            "type" : "string"
-          },
-          "color" : {
-            "type" : "string"
-          },
-          "picture" : {
-            "type" : "string"
-          },
           "createdAt" : {
             "type" : "string"
           },
@@ -13001,12 +12595,6 @@
             },
             "type" : "array"
           },
-          "isTemplate" : {
-            "type" : "boolean"
-          },
-          "deleted" : {
-            "type" : "boolean"
-          },
           "agentType" : {
             "$ref" : "#/components/schemas/AgentType"
           },
@@ -16526,55 +16114,6 @@
         "required" : [ "permissions" ],
         "type" : "object"
       },
-      "UserAgentAccess" : {
-        "properties" : {
-          "scoped" : {
-            "description" : "When true, only listed agents are accessible (org-wide agent.read is ignored for listing).",
-            "type" : "boolean"
-          },
-          "agentIds" : {
-            "items" : {
-              "type" : "string"
-            },
-            "type" : "array"
-          },
-          "availableAgents" : {
-            "items" : {
-              "$ref" : "#/components/schemas/UserAgentAccessAgent"
-            },
-            "type" : "array"
-          }
-        },
-        "required" : [ "agentIds", "availableAgents", "scoped" ],
-        "type" : "object"
-      },
-      "UserAgentAccessAgent" : {
-        "properties" : {
-          "id" : {
-            "type" : "string"
-          },
-          "name" : {
-            "type" : "string"
-          }
-        },
-        "required" : [ "id", "name" ],
-        "type" : "object"
-      },
-      "UserAgentAccessRequest" : {
-        "properties" : {
-          "scoped" : {
-            "type" : "boolean"
-          },
-          "agentIds" : {
-            "items" : {
-              "type" : "string"
-            },
-            "type" : "array"
-          }
-        },
-        "required" : [ "agentIds", "scoped" ],
-        "type" : "object"
-      },
       "OrganizationEngine" : {
         "additionalProperties" : false,
         "description" : "Engine configuration attached to an organization.",
@@ -16731,20 +16270,6 @@
         "required" : [ "id", "name" ],
         "type" : "object"
       },
-      "DocumentAddRequest" : {
-        "properties" : {
-          "document" : {
-            "description" : "The text document to add to the knowledge base",
-            "type" : "string"
-          },
-          "customId" : {
-            "description" : "Optional custom ID for the document",
-            "type" : "string"
-          }
-        },
-        "required" : [ "document" ],
-        "type" : "object"
-      },
       "FileStatusUpdateRequest" : {
         "properties" : {
           "status" : {
@@ -17371,6 +16896,18 @@
         },
         "type" : "object"
       },
+      "AgentRef" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
       "SkillAssignRequest" : {
         "additionalProperties" : false,
         "properties" : {
@@ -18013,6 +17550,29 @@
         },
         "type" : "object"
       },
+      "addModule_request" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "type" : {
+            "enum" : [ "ContextualKnowledgeWeaviate", "External" ],
+            "type" : "string"
+          },
+          "name" : {
+            "pattern" : "^[a-zA-Z0-9]+$",
+            "type" : "string"
+          },
+          "_configuration" : {
+            "additionalProperties" : true,
+            "type" : "object"
+          },
+          "restricted" : {
+            "nullable" : true,
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "_configuration", "name", "type" ],
+        "type" : "object"
+      },
       "deleteMessageAudio_200_response" : {
         "properties" : {
           "message" : {
@@ -18056,37 +17616,6 @@
         "required" : [ "title" ],
         "type" : "object"
       },
-      "importFileToAgentKnowledge_request" : {
-        "properties" : {
-          "file" : {
-            "description" : "The file to import (PDF, CSV, TXT supported)",
-            "format" : "binary",
-            "type" : "string"
-          }
-        },
-        "required" : [ "file" ],
-        "type" : "object"
-      },
-      "importFileToAgentKnowledge_200_response" : {
-        "properties" : {
-          "id" : {
-            "type" : "string"
-          },
-          "name" : {
-            "type" : "string"
-          },
-          "type" : {
-            "type" : "string"
-          },
-          "size" : {
-            "type" : "number"
-          },
-          "chunkCount" : {
-            "type" : "number"
-          }
-        },
-        "type" : "object"
-      },
       "patchKnowledgeBase_request" : {
         "properties" : {
           "name" : {
@@ -18493,24 +18022,6 @@
         "required" : [ "modelId", "providerId" ],
         "type" : "object"
       },
-      "AgentRequest_profilePicture" : {
-        "properties" : {
-          "hash" : {
-            "type" : "string"
-          },
-          "size" : {
-            "type" : "number"
-          },
-          "contentType" : {
-            "type" : "string"
-          },
-          "ext" : {
-            "type" : "string"
-          }
-        },
-        "required" : [ "contentType", "ext", "hash", "size" ],
-        "type" : "object"
-      },
       "AgentPatch_engine" : {
         "nullable" : true,
         "properties" : {