@breign/client 1.0.176 → 1.0.177

package/dist/openapi.json

@@ -72,6 +72,9 @@
   }, {
     "description" : "Scheduled task management endpoints",
     "name" : "scheduled-tasks"
+  }, {
+    "description" : "GitLab integrations whose mentions trigger automations",
+    "name" : "integrations"
   }, {
     "description" : "User management endpoints",
     "name" : "users"
@@ -3010,6 +3013,60 @@
         "tags" : [ "scheduledTasks" ]
       }
     },
+    "/agents/{agentId}/scheduled-tasks/{taskId}/runs/{runId}/trigger" : {
+      "get" : {
+        "operationId" : "getScheduledTaskRunTrigger",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task",
+          "in" : "path",
+          "name" : "taskId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the scheduled task run",
+          "in" : "path",
+          "name" : "runId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ScheduledTaskRunTrigger"
+                }
+              }
+            },
+            "description" : "The GitLab mention behind the run"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Run not found, or not triggered by an event"
+          }
+        },
+        "summary" : "The external event that triggered a run (« Déclenché par »)",
+        "tags" : [ "scheduledTasks" ]
+      }
+    },
     "/agents/{agentId}/apps" : {
       "get" : {
         "description" : "Get apps for agent id",
@@ -19243,6 +19300,547 @@
         "tags" : [ "tickets" ]
       }
     },
+    "/organizations/{organizationId}/integrations/gitlab" : {
+      "get" : {
+        "operationId" : "listGitlabIntegrations",
+        "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/GitlabIntegration"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "The integrations"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          }
+        },
+        "summary" : "List the GitLab integrations of an organization",
+        "tags" : [ "integrations" ]
+      },
+      "post" : {
+        "description" : "A webhook secret is generated; it is returned with the integration.",
+        "operationId" : "createGitlabIntegration",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/GitlabIntegrationCreate"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabIntegrationDetail"
+                }
+              }
+            },
+            "description" : "Integration created"
+          },
+          "400" : {
+            "description" : "Invalid body"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "422" : {
+            "description" : "Invalid base URL, or GITLAB_HOST_NOT_ALLOWED (private or reserved network)"
+          }
+        },
+        "summary" : "Link a GitLab instance to the organization",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}" : {
+      "delete" : {
+        "operationId" : "deleteGitlabIntegration",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "Deleted"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          }
+        },
+        "summary" : "Delete a GitLab integration, its bot accounts and its events",
+        "tags" : [ "integrations" ]
+      },
+      "get" : {
+        "operationId" : "getGitlabIntegration",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabIntegrationDetail"
+                }
+              }
+            },
+            "description" : "The integration"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          }
+        },
+        "summary" : "Get a GitLab integration, its webhook secret and its bot accounts",
+        "tags" : [ "integrations" ]
+      },
+      "patch" : {
+        "description" : "Changing `baseUrl` wipes the token of every bot account (status token_invalid, lastError BASE_URL_CHANGED): a token is never sent to another host than the one it was given for.",
+        "operationId" : "updateGitlabIntegration",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/GitlabIntegrationUpdate"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabIntegrationDetail"
+                }
+              }
+            },
+            "description" : "The updated integration"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          },
+          "422" : {
+            "description" : "Invalid base URL, or GITLAB_HOST_NOT_ALLOWED (private or reserved network)"
+          }
+        },
+        "summary" : "Update a GitLab integration",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}/events" : {
+      "get" : {
+        "operationId" : "listGitlabIntegrationEvents",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/ExternalEvent"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "The 20 latest events, most recent first"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          }
+        },
+        "summary" : "The latest mentions received by a GitLab integration",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}/test-connection" : {
+      "post" : {
+        "description" : "An accepted token puts its account back in service; a rejected one marks it token_invalid.",
+        "operationId" : "testGitlabConnection",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/GitlabConnectionTestResult"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "One result per bot account"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          }
+        },
+        "summary" : "Test the connection of every bot account (GET /user with its token)",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}/test-routing" : {
+      "post" : {
+        "operationId" : "testGitlabRouting",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/GitlabRoutingTest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabRoutingTestResult"
+                }
+              }
+            },
+            "description" : "The account, agent, instruction and automations the comment would reach"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          }
+        },
+        "summary" : "Preview what a GitLab comment would trigger",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}/bot-accounts" : {
+      "post" : {
+        "description" : "The token is checked against GitLab (GET /user). The service user must be a member of the organization, the named agents must belong to it, and no two callable agents may share a name once normalized (409 DUPLICATE_AGENT_NAMES, with the duplicates).",
+        "operationId" : "createGitlabBotAccount",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/GitlabBotAccountCreate"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabBotAccount"
+                }
+              }
+            },
+            "description" : "Bot account created"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration not found"
+          },
+          "409" : {
+            "description" : "Duplicate callable agent names, or this GitLab account is already configured"
+          },
+          "422" : {
+            "description" : "Token rejected by GitLab, GitLab unreachable, service user not a member, or unknown agents"
+          }
+        },
+        "summary" : "Add a bot account to a GitLab integration",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/integrations/gitlab/{integrationId}/bot-accounts/{accountId}" : {
+      "delete" : {
+        "operationId" : "deleteGitlabBotAccount",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "accountId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "Deleted"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration or bot account not found"
+          }
+        },
+        "summary" : "Remove a bot account",
+        "tags" : [ "integrations" ]
+      },
+      "patch" : {
+        "operationId" : "updateGitlabBotAccount",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "integrationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "path",
+          "name" : "accountId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/GitlabBotAccountUpdate"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/GitlabBotAccount"
+                }
+              }
+            },
+            "description" : "The updated bot account"
+          },
+          "403" : {
+            "description" : "Not an admin of the organization"
+          },
+          "404" : {
+            "description" : "Integration or bot account not found"
+          },
+          "409" : {
+            "description" : "Duplicate callable agent names"
+          },
+          "422" : {
+            "description" : "Token rejected by GitLab, service user not a member, or unknown agents"
+          }
+        },
+        "summary" : "Update a bot account (agents, service user, token, status)",
+        "tags" : [ "integrations" ]
+      }
+    },
+    "/organizations/{organizationId}/gitlab-bot-accounts" : {
+      "get" : {
+        "operationId" : "listOrganizationGitlabBotAccounts",
+        "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/GitlabBotAccountSummary"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "The bot accounts, without secrets"
+          },
+          "403" : {
+            "description" : "Not a member of the organization"
+          }
+        },
+        "summary" : "The GitLab bot accounts of the organization, to pick one in an automation",
+        "tags" : [ "integrations" ]
+      }
+    },
     "/organizations/{organizationId}/inbox" : {
       "get" : {
         "description" : "todo : actions en attente (questions, propositions, relectures, feux verts), les plus anciennes d'abord ; mentions : mentions non traitées ; done : éléments traités, les plus récents d'abord.",
@@ -22738,7 +23336,14 @@
             "type" : "string"
           },
           "schedule" : {
-            "$ref" : "#/components/schemas/TaskSchedule"
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/TaskSchedule"
+            } ],
+            "description" : "null for an automation triggered by an event.",
+            "nullable" : true
+          },
+          "trigger" : {
+            "$ref" : "#/components/schemas/TaskTrigger"
           },
           "cronExpression" : {
             "type" : "string"
@@ -22840,7 +23445,45 @@
         } ],
         "type" : "object"
       },
+      "TaskTrigger" : {
+        "description" : "What starts the automation. `schedule` (default): its schedule. `event`: a mention of one of the bot accounts in GitLab, in the given kinds of objects and projects (empty: all projects; `groupe/projet` or `groupe/*`).",
+        "properties" : {
+          "type" : {
+            "enum" : [ "schedule", "event" ],
+            "type" : "string"
+          },
+          "source" : {
+            "enum" : [ "gitlab_mention" ],
+            "type" : "string"
+          },
+          "botAccountIds" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "kinds" : {
+            "items" : {
+              "enum" : [ "merge_request", "issue", "work_item", "commit" ],
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "projects" : {
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "reply" : {
+            "$ref" : "#/components/schemas/TaskTrigger_reply"
+          }
+        },
+        "required" : [ "type" ],
+        "type" : "object"
+      },
       "ScheduledTaskCreate" : {
+        "description" : "`schedule` is required unless `trigger.type` is `event` (then `mode` must be `recurring`).",
         "properties" : {
           "message" : {
             "minLength" : 1,
@@ -22853,6 +23496,9 @@
           "schedule" : {
             "$ref" : "#/components/schemas/TaskSchedule"
           },
+          "trigger" : {
+            "$ref" : "#/components/schemas/TaskTrigger"
+          },
           "name" : {
             "type" : "string"
           },
@@ -22868,7 +23514,7 @@
             "type" : "string"
           }
         },
-        "required" : [ "message", "mode", "schedule" ],
+        "required" : [ "message", "mode" ],
         "type" : "object"
       },
       "ScheduledTaskStatusToggle" : {
@@ -22965,6 +23611,15 @@
             },
             "type" : "array"
           },
+          "triggerEventId" : {
+            "description" : "The external event (GitLab mention) that triggered the run.",
+            "type" : "string"
+          },
+          "executor" : {
+            "description" : "internal — run by brain-api itself (event-triggered runs); the external executor of scheduled runs must ignore them. Absent means external.",
+            "enum" : [ "internal", "external" ],
+            "type" : "string"
+          },
           "createdAt" : {
             "format" : "date-time",
             "type" : "string"
@@ -22998,6 +23653,75 @@
         "required" : [ "at", "type" ],
         "type" : "object"
       },
+      "ScheduledTaskRunTrigger" : {
+        "description" : "The GitLab mention that triggered a run.",
+        "properties" : {
+          "eventId" : {
+            "type" : "string"
+          },
+          "source" : {
+            "enum" : [ "gitlab" ],
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/ExternalEventStatus"
+          },
+          "receivedAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "projectPath" : {
+            "type" : "string"
+          },
+          "targetType" : {
+            "enum" : [ "merge_request", "issue", "work_item", "commit" ],
+            "type" : "string"
+          },
+          "targetIid" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "targetTitle" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "targetUrl" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "noteUrl" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "author" : {
+            "$ref" : "#/components/schemas/ScheduledTaskRunTrigger_author"
+          },
+          "body" : {
+            "description" : "The comment text (untrusted user content).",
+            "type" : "string"
+          },
+          "botUsername" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "routing" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/ExternalEventRouting"
+            } ],
+            "nullable" : true
+          },
+          "replyUrl" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "conversationId" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "author", "body", "botUsername", "conversationId", "eventId", "noteUrl", "projectPath", "receivedAt", "replyUrl", "routing", "source", "status", "targetIid", "targetTitle", "targetType", "targetUrl" ],
+        "type" : "object"
+      },
       "AppLight" : {
         "properties" : {
           "id" : {
@@ -30874,77 +31598,511 @@
         },
         "type" : "object"
       },
-      "ConversationTicketProposal" : {
-        "description" : "Proposition de ticket portée par un message d'agent.",
+      "ConversationTicketProposal" : {
+        "description" : "Proposition de ticket portée par un message d'agent.",
+        "properties" : {
+          "proposalId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/TicketProposalStatus"
+          },
+          "mode" : {
+            "$ref" : "#/components/schemas/AgentTicketCreation"
+          },
+          "projectId" : {
+            "description" : "Projet proposé par l'agent ; null = l'humain doit en choisir un",
+            "format" : "uuid",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "payload" : {
+            "$ref" : "#/components/schemas/TicketProposalPayload"
+          },
+          "ticketId" : {
+            "format" : "uuid",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "ticketKey" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "mode", "payload", "projectId", "proposalId", "status", "ticketId", "ticketKey" ],
+        "type" : "object"
+      },
+      "TicketProposalPayload" : {
+        "properties" : {
+          "title" : {
+            "type" : "string"
+          },
+          "description" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "assignees" : {
+            "items" : {
+              "$ref" : "#/components/schemas/TicketAssigneeInput"
+            },
+            "type" : "array"
+          },
+          "reviewer" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/MemberRef"
+            } ],
+            "nullable" : true
+          },
+          "priority" : {
+            "$ref" : "#/components/schemas/TicketPriority"
+          },
+          "startMode" : {
+            "$ref" : "#/components/schemas/TicketStartMode"
+          },
+          "workspacePaths" : {
+            "description" : "Fichiers du workspace de la session à joindre comme artefacts",
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "assignees", "description", "priority", "reviewer", "startMode", "title", "workspacePaths" ],
+        "type" : "object"
+      },
+      "GitlabIntegration" : {
+        "description" : "A GitLab instance linked to an organization. Its projects send webhooks to `webhookUrl`.",
         "properties" : {
-          "proposalId" : {
-            "format" : "uuid",
+          "id" : {
+            "type" : "string"
+          },
+          "organizationId" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "baseUrl" : {
+            "description" : "The instance URL, without a trailing slash.",
             "type" : "string"
           },
+          "minAccessLevel" : {
+            "$ref" : "#/components/schemas/GitlabAccessLevel"
+          },
           "status" : {
-            "$ref" : "#/components/schemas/TicketProposalStatus"
+            "enum" : [ "active", "disabled" ],
+            "type" : "string"
           },
-          "mode" : {
-            "$ref" : "#/components/schemas/AgentTicketCreation"
+          "webhookUrl" : {
+            "description" : "The URL to declare in GitLab, Settings › Webhooks.",
+            "type" : "string"
           },
-          "projectId" : {
-            "description" : "Projet proposé par l'agent ; null = l'humain doit en choisir un",
-            "format" : "uuid",
+          "lastEventAt" : {
+            "format" : "date-time",
             "nullable" : true,
             "type" : "string"
           },
-          "payload" : {
-            "$ref" : "#/components/schemas/TicketProposalPayload"
+          "botAccountCount" : {
+            "type" : "integer"
           },
-          "ticketId" : {
-            "format" : "uuid",
-            "nullable" : true,
+          "handledLast7Days" : {
+            "description" : "Mentions answered over the last 7 days.",
+            "type" : "integer"
+          },
+          "createdAt" : {
+            "format" : "date-time",
             "type" : "string"
           },
-          "ticketKey" : {
-            "nullable" : true,
+          "updatedAt" : {
+            "format" : "date-time",
             "type" : "string"
           }
         },
-        "required" : [ "mode", "payload", "projectId", "proposalId", "status", "ticketId", "ticketKey" ],
+        "required" : [ "baseUrl", "botAccountCount", "createdAt", "handledLast7Days", "id", "lastEventAt", "minAccessLevel", "name", "organizationId", "status", "updatedAt", "webhookUrl" ],
         "type" : "object"
       },
-      "TicketProposalPayload" : {
+      "GitlabAccessLevel" : {
+        "description" : "GitLab access level — Guest (10), Reporter (20), Developer (30), Maintainer (40), Owner (50).",
+        "enum" : [ 10, 20, 30, 40, 50 ],
+        "type" : "integer"
+      },
+      "GitlabIntegrationCreate" : {
+        "additionalProperties" : false,
         "properties" : {
-          "title" : {
+          "name" : {
+            "maxLength" : 120,
+            "minLength" : 1,
             "type" : "string"
           },
-          "description" : {
+          "baseUrl" : {
+            "maxLength" : 500,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "minAccessLevel" : {
+            "$ref" : "#/components/schemas/GitlabAccessLevel"
+          }
+        },
+        "required" : [ "baseUrl", "name" ],
+        "type" : "object"
+      },
+      "GitlabIntegrationDetail" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/GitlabIntegration"
+        }, {
+          "properties" : {
+            "webhookSecret" : {
+              "description" : "The webhook \"Secret token\" to copy into GitLab. Only organization admins read it.",
+              "type" : "string"
+            },
+            "botAccounts" : {
+              "items" : {
+                "$ref" : "#/components/schemas/GitlabBotAccount"
+              },
+              "type" : "array"
+            }
+          },
+          "required" : [ "botAccounts", "webhookSecret" ],
+          "type" : "object"
+        } ]
+      },
+      "GitlabBotAccount" : {
+        "description" : "A GitLab account mentioned to wake an agent. `@bot Agent …` wakes the named agent when it is callable; otherwise the whole text goes to the default agent.",
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "integrationId" : {
+            "type" : "string"
+          },
+          "organizationId" : {
+            "type" : "string"
+          },
+          "gitlabUserId" : {
             "nullable" : true,
+            "type" : "integer"
+          },
+          "username" : {
+            "description" : "Without the `@`.",
             "type" : "string"
           },
-          "assignees" : {
+          "tokenHint" : {
+            "description" : "The end of the token (`glpat-…7f2a`); the token itself is never returned.",
+            "type" : "string"
+          },
+          "tokenExpiresAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "defaultAgentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "callableAgentIds" : {
+            "description" : "null — every (non personal) agent of the organization is callable by its name.",
             "items" : {
-              "$ref" : "#/components/schemas/TicketAssigneeInput"
+              "type" : "string"
             },
+            "nullable" : true,
             "type" : "array"
           },
-          "reviewer" : {
+          "runAsUserId" : {
+            "description" : "The organization member the conversations run as (user-scoped MCP tools, quotas).",
+            "type" : "string"
+          },
+          "runAsUserName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "active", "token_invalid", "disabled" ],
+            "type" : "string"
+          },
+          "lastError" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "type" : "string"
+          },
+          "updatedAt" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "callableAgentIds", "createdAt", "defaultAgentId", "gitlabUserId", "id", "integrationId", "lastError", "organizationId", "runAsUserId", "runAsUserName", "status", "tokenExpiresAt", "tokenHint", "updatedAt", "username" ],
+        "type" : "object"
+      },
+      "GitlabIntegrationUpdate" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "name" : {
+            "maxLength" : 120,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "baseUrl" : {
+            "maxLength" : 500,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "minAccessLevel" : {
+            "$ref" : "#/components/schemas/GitlabAccessLevel"
+          },
+          "status" : {
+            "enum" : [ "active", "disabled" ],
+            "type" : "string"
+          },
+          "regenerateSecret" : {
+            "description" : "Generate a new webhook secret; GitLab must then be given the new one.",
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "ExternalEvent" : {
+        "description" : "A mention received from GitLab and its way through the queue.",
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "status" : {
+            "$ref" : "#/components/schemas/ExternalEventStatus"
+          },
+          "receivedAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "ref" : {
+            "description" : "groupe/projet!142, groupe/projet#88…",
+            "type" : "string"
+          },
+          "targetType" : {
+            "enum" : [ "merge_request", "issue", "work_item", "commit" ],
+            "type" : "string"
+          },
+          "targetTitle" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "url" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "author" : {
+            "$ref" : "#/components/schemas/ScheduledTaskRunTrigger_author"
+          },
+          "botAccountId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "agentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "taskId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "runId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "routing" : {
             "allOf" : [ {
-              "$ref" : "#/components/schemas/MemberRef"
+              "$ref" : "#/components/schemas/ExternalEventRouting"
             } ],
             "nullable" : true
           },
-          "priority" : {
-            "$ref" : "#/components/schemas/TicketPriority"
+          "lastError" : {
+            "nullable" : true,
+            "type" : "string"
           },
-          "startMode" : {
-            "$ref" : "#/components/schemas/TicketStartMode"
+          "replyUrl" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "author", "botAccountId", "id", "lastError", "receivedAt", "ref", "replyUrl", "routing", "runId", "status", "targetTitle", "targetType", "taskId", "url" ],
+        "type" : "object"
+      },
+      "ExternalEventStatus" : {
+        "enum" : [ "received", "queued", "running", "replying", "done", "ignored", "no_automation", "expired", "dead", "dropped_overload" ],
+        "type" : "string"
+      },
+      "ExternalEventRouting" : {
+        "properties" : {
+          "mode" : {
+            "description" : "named — the first word was a callable agent; default — the whole text went to the default agent.",
+            "enum" : [ "named", "default", "help" ],
+            "type" : "string"
           },
-          "workspacePaths" : {
-            "description" : "Fichiers du workspace de la session à joindre comme artefacts",
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "instruction" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentName", "instruction", "mode" ],
+        "type" : "object"
+      },
+      "GitlabConnectionTestResult" : {
+        "properties" : {
+          "botAccountId" : {
+            "type" : "string"
+          },
+          "username" : {
+            "type" : "string"
+          },
+          "ok" : {
+            "type" : "boolean"
+          },
+          "error" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "botAccountId", "error", "ok", "username" ],
+        "type" : "object"
+      },
+      "GitlabRoutingTest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "text" : {
+            "maxLength" : 20000,
+            "minLength" : 1,
+            "type" : "string"
+          }
+        },
+        "required" : [ "text" ],
+        "type" : "object"
+      },
+      "GitlabRoutingTestResult" : {
+        "description" : "What a comment would trigger, without running anything.",
+        "properties" : {
+          "outcome" : {
+            "enum" : [ "routed", "help", "no_bot_mention", "no_automation" ],
+            "type" : "string"
+          },
+          "botAccount" : {
+            "$ref" : "#/components/schemas/GitlabRoutingTestResult_botAccount"
+          },
+          "agent" : {
+            "$ref" : "#/components/schemas/GitlabRoutingTestResult_agent"
+          },
+          "routing" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/ExternalEventRouting"
+            } ],
+            "nullable" : true
+          },
+          "runAsUser" : {
+            "$ref" : "#/components/schemas/GitlabRoutingTestResult_runAsUser"
+          },
+          "automations" : {
+            "items" : {
+              "$ref" : "#/components/schemas/GitlabRoutingTestResult_automations_inner"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "agent", "automations", "botAccount", "outcome", "routing", "runAsUser" ],
+        "type" : "object"
+      },
+      "GitlabBotAccountCreate" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "token" : {
+            "description" : "A personal access token of the bot account (scope `api`). Checked against GitLab.",
+            "maxLength" : 500,
+            "minLength" : 8,
+            "type" : "string"
+          },
+          "defaultAgentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "callableAgentIds" : {
             "items" : {
               "type" : "string"
             },
+            "nullable" : true,
             "type" : "array"
+          },
+          "runAsUserId" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "runAsUserId", "token" ],
+        "type" : "object"
+      },
+      "GitlabBotAccountUpdate" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "token" : {
+            "maxLength" : 500,
+            "minLength" : 8,
+            "type" : "string"
+          },
+          "defaultAgentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "callableAgentIds" : {
+            "items" : {
+              "type" : "string"
+            },
+            "nullable" : true,
+            "type" : "array"
+          },
+          "runAsUserId" : {
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "active", "disabled" ],
+            "type" : "string"
           }
         },
-        "required" : [ "assignees", "description", "priority", "reviewer", "startMode", "title", "workspacePaths" ],
+        "type" : "object"
+      },
+      "GitlabBotAccountSummary" : {
+        "description" : "A bot account as members see it, to pick one in an automation. No secret.",
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "username" : {
+            "type" : "string"
+          },
+          "integrationId" : {
+            "type" : "string"
+          },
+          "integrationName" : {
+            "type" : "string"
+          },
+          "defaultAgentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "callableAgentIds" : {
+            "items" : {
+              "type" : "string"
+            },
+            "nullable" : true,
+            "type" : "array"
+          },
+          "status" : {
+            "enum" : [ "active", "token_invalid", "disabled" ],
+            "type" : "string"
+          }
+        },
+        "required" : [ "callableAgentIds", "defaultAgentId", "id", "integrationId", "integrationName", "status", "username" ],
         "type" : "object"
       },
       "InboxTab" : {
@@ -32644,6 +33802,33 @@
         "required" : [ "date", "type" ],
         "type" : "object"
       },
+      "TaskTrigger_reply" : {
+        "properties" : {
+          "thread" : {
+            "description" : "Post the agent answer in the GitLab thread.",
+            "type" : "boolean"
+          },
+          "ack" : {
+            "description" : "React with \"eyes\" as soon as the mention is taken.",
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "ack", "thread" ],
+        "type" : "object"
+      },
+      "ScheduledTaskRunTrigger_author" : {
+        "properties" : {
+          "username" : {
+            "type" : "string"
+          },
+          "name" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "name", "username" ],
+        "type" : "object"
+      },
       "AppCreateRequest_ephemeralInstances" : {
         "additionalProperties" : false,
         "properties" : {
@@ -33778,6 +34963,59 @@
         "required" : [ "connected", "id", "name", "ownedByMe" ],
         "type" : "object"
       },
+      "GitlabRoutingTestResult_botAccount" : {
+        "nullable" : true,
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "username" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "username" ],
+        "type" : "object"
+      },
+      "GitlabRoutingTestResult_agent" : {
+        "nullable" : true,
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
+      "GitlabRoutingTestResult_runAsUser" : {
+        "nullable" : true,
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
+      "GitlabRoutingTestResult_automations_inner" : {
+        "properties" : {
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
       "InboxItem_project" : {
         "nullable" : true,
         "properties" : {