@breign/client 1.0.175 → 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",
@@ -4678,6 +4735,181 @@
         "tags" : [ "auth" ]
       }
     },
+    "/auth/authorize" : {
+      "get" : {
+        "description" : "Entry point of the browser authorization of a desktop application (OAuth2 authorization code with PKCE, loopback redirect per RFC 8252). The request is checked, then the browser is redirected to the consent page of Breign App, which issues the code through `POST /auth/authorizations`.\n",
+        "operationId" : "authorizeApplication",
+        "parameters" : [ {
+          "in" : "query",
+          "name" : "response_type",
+          "required" : true,
+          "schema" : {
+            "enum" : [ "code" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "client_id",
+          "required" : true,
+          "schema" : {
+            "maxLength" : 100,
+            "type" : "string"
+          }
+        }, {
+          "description" : "Loopback HTTP address with a port, e.g. `http://127.0.0.1:53682/callback`.",
+          "in" : "query",
+          "name" : "redirect_uri",
+          "required" : true,
+          "schema" : {
+            "maxLength" : 200,
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "code_challenge",
+          "required" : true,
+          "schema" : {
+            "maxLength" : 128,
+            "minLength" : 43,
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "code_challenge_method",
+          "required" : true,
+          "schema" : {
+            "enum" : [ "S256" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "state",
+          "required" : false,
+          "schema" : {
+            "maxLength" : 200,
+            "type" : "string"
+          }
+        }, {
+          "description" : "Name of the machine, shown on the consent page and in the API key name.",
+          "in" : "query",
+          "name" : "device_name",
+          "required" : false,
+          "schema" : {
+            "maxLength" : 100,
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "302" : {
+            "description" : "Redirect to the consent page of Breign App"
+          },
+          "400" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationTokenError"
+                }
+              }
+            },
+            "description" : "Invalid authorization request (`invalid_request`), never redirected"
+          }
+        },
+        "security" : [ ],
+        "summary" : "Start an application authorization",
+        "tags" : [ "auth" ]
+      }
+    },
+    "/auth/authorizations" : {
+      "post" : {
+        "description" : "Called on behalf of the signed-in user once they consented to the application. Returns a single-use code, valid 5 minutes, bound to the redirect address and the PKCE challenge.\n",
+        "operationId" : "createApplicationAuthorization",
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/ApplicationAuthorizationRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationAuthorizationResponse"
+                }
+              }
+            },
+            "description" : "Authorization code"
+          },
+          "400" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationAuthorizationError"
+                }
+              }
+            },
+            "description" : "Invalid authorization request"
+          },
+          "403" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationAuthorizationError"
+                }
+              }
+            },
+            "description" : "No user account behind the call"
+          }
+        },
+        "summary" : "Issue an application authorization code",
+        "tags" : [ "auth" ]
+      }
+    },
+    "/auth/token" : {
+      "post" : {
+        "description" : "Exchanges the code issued by `POST /auth/authorizations` for an API key of the user, after checking the PKCE verifier, the client and the redirect address. The code is single use. Errors follow RFC 6749 section 5.2.\n",
+        "operationId" : "exchangeApplicationAuthorizationCode",
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/ApplicationTokenRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationTokenResponse"
+                }
+              }
+            },
+            "description" : "API key of the user"
+          },
+          "400" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ApplicationTokenError"
+                }
+              }
+            },
+            "description" : "OAuth error (`invalid_request`, `invalid_grant`, `unsupported_grant_type`)"
+          }
+        },
+        "security" : [ ],
+        "summary" : "Exchange an application authorization code",
+        "tags" : [ "auth" ]
+      }
+    },
     "/.well-known/jwks.json" : {
       "get" : {
         "description" : "Returns the JSON Web Key Set for JWT verification",
@@ -19068,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.",
@@ -22563,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"
@@ -22665,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,
@@ -22678,6 +23496,9 @@
           "schedule" : {
             "$ref" : "#/components/schemas/TaskSchedule"
           },
+          "trigger" : {
+            "$ref" : "#/components/schemas/TaskTrigger"
+          },
           "name" : {
             "type" : "string"
           },
@@ -22693,7 +23514,7 @@
             "type" : "string"
           }
         },
-        "required" : [ "message", "mode", "schedule" ],
+        "required" : [ "message", "mode" ],
         "type" : "object"
       },
       "ScheduledTaskStatusToggle" : {
@@ -22790,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"
@@ -22823,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" : {
@@ -23717,6 +24616,117 @@
         "required" : [ "message" ],
         "type" : "object"
       },
+      "ApplicationTokenError" : {
+        "properties" : {
+          "error" : {
+            "type" : "string"
+          },
+          "error_description" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "error" ],
+        "type" : "object"
+      },
+      "ApplicationAuthorizationRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "clientId" : {
+            "maxLength" : 100,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "redirectUri" : {
+            "description" : "Loopback HTTP address with a port, e.g. `http://127.0.0.1:53682/callback`.",
+            "maxLength" : 200,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "codeChallenge" : {
+            "maxLength" : 128,
+            "minLength" : 43,
+            "type" : "string"
+          },
+          "codeChallengeMethod" : {
+            "enum" : [ "S256" ],
+            "type" : "string"
+          },
+          "deviceName" : {
+            "maxLength" : 100,
+            "type" : "string"
+          }
+        },
+        "required" : [ "clientId", "codeChallenge", "codeChallengeMethod", "redirectUri" ],
+        "type" : "object"
+      },
+      "ApplicationAuthorizationResponse" : {
+        "properties" : {
+          "code" : {
+            "type" : "string"
+          },
+          "expiresIn" : {
+            "description" : "Lifetime of the code, in seconds.",
+            "type" : "integer"
+          }
+        },
+        "required" : [ "code", "expiresIn" ],
+        "type" : "object"
+      },
+      "ApplicationAuthorizationError" : {
+        "properties" : {
+          "message" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "message" ],
+        "type" : "object"
+      },
+      "ApplicationTokenRequest" : {
+        "properties" : {
+          "grant_type" : {
+            "enum" : [ "authorization_code" ],
+            "type" : "string"
+          },
+          "code" : {
+            "type" : "string"
+          },
+          "code_verifier" : {
+            "type" : "string"
+          },
+          "redirect_uri" : {
+            "type" : "string"
+          },
+          "client_id" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "client_id", "code", "code_verifier", "grant_type", "redirect_uri" ],
+        "type" : "object"
+      },
+      "ApplicationTokenResponse" : {
+        "properties" : {
+          "access_token" : {
+            "description" : "API key, to send in the `x-api-key` header.",
+            "type" : "string"
+          },
+          "token_type" : {
+            "enum" : [ "api_key" ],
+            "type" : "string"
+          },
+          "key_id" : {
+            "type" : "string"
+          },
+          "key_name" : {
+            "type" : "string"
+          },
+          "email" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "access_token", "key_id", "key_name", "token_type" ],
+        "type" : "object"
+      },
       "Chunk" : {
         "properties" : {
           "id" : {
@@ -30588,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" : {
@@ -32358,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" : {
@@ -33492,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" : {