@breign/client 1.0.194 → 1.0.196

package/dist/openapi.json

@@ -96,6 +96,9 @@
   }, {
     "description" : "Breign Mate execution nodes, the agents that run on them and their turns",
     "name" : "execution-nodes"
+  }, {
+    "description" : "Groups of execution nodes of an organization, like runners",
+    "name" : "node-groups"
   }, {
     "description" : "Actions and mentions waiting for the current user",
     "name" : "inbox"
@@ -19960,6 +19963,873 @@
         "tags" : [ "execution-nodes" ]
       }
     },
+    "/organizations/{organizationId}/node-groups" : {
+      "get" : {
+        "description" : "Les groupes de nœuds de l'organisation, avec leurs nœuds (en ligne ou non), leurs emplacements et le nombre d'agents rattachés. Demande `nodeGroup.read`.",
+        "operationId" : "listNodeGroups",
+        "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/NodeGroupSummary"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          }
+        },
+        "summary" : "List the node groups of an organization",
+        "tags" : [ "node-groups" ]
+      },
+      "post" : {
+        "description" : "Crée un groupe vide ; les délais absents prennent les valeurs par défaut (attente du nœud de l'environnement 10 min, libération après 24 h, expiration de la file après 24 h). Demande `nodeGroup.create`.",
+        "operationId" : "createNodeGroup",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/CreateNodeGroupRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupDetail"
+                }
+              }
+            },
+            "description" : "Created"
+          },
+          "400" : {
+            "description" : "Invalid name or delays"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.create"
+          },
+          "409" : {
+            "description" : "A group of this name already exists (NODE_GROUP_NAME_TAKEN)"
+          }
+        },
+        "summary" : "Create a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/organizations/{organizationId}/node-group-candidates" : {
+      "get" : {
+        "description" : "Les nœuds associés à l'organisation, avec ce qui empêche chacun d'entrer dans un groupe (un nœud doit parler le contrat v2 : Breign Mate ou Breign CLI à jour). Demande `nodeGroup.read`.",
+        "operationId" : "listNodeGroupCandidates",
+        "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/NodeGroupCandidate"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          }
+        },
+        "summary" : "List the nodes that can join a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}" : {
+      "delete" : {
+        "description" : "Supprime le groupe et ses membres. Refusé tant qu'un agent y est rattaché. Demande `nodeGroup.delete`.",
+        "operationId" : "deleteNodeGroup",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "Deleted"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.delete"
+          },
+          "404" : {
+            "description" : "Group not found"
+          },
+          "409" : {
+            "description" : "Agents are still bound to the group (NODE_GROUP_IN_USE)"
+          }
+        },
+        "summary" : "Delete a node group",
+        "tags" : [ "node-groups" ]
+      },
+      "get" : {
+        "description" : "Le groupe, ses nœuds et les agents qui y sont rattachés. Demande `nodeGroup.read`.",
+        "operationId" : "getNodeGroup",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupDetail"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read in the organization of the group"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "Get a node group",
+        "tags" : [ "node-groups" ]
+      },
+      "patch" : {
+        "description" : "Renomme le groupe ou change ses délais. Demande `nodeGroup.update`.",
+        "operationId" : "updateNodeGroup",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/UpdateNodeGroupRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupDetail"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "400" : {
+            "description" : "Invalid name or delays"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.update"
+          },
+          "404" : {
+            "description" : "Group not found"
+          },
+          "409" : {
+            "description" : "A group of this name already exists (NODE_GROUP_NAME_TAKEN)"
+          }
+        },
+        "summary" : "Update a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/nodes/{nodeId}" : {
+      "delete" : {
+        "description" : "Retire le nœud du groupe. Demande `nodeGroup.update`.",
+        "operationId" : "removeNodeGroupNode",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the Breign Mate execution node",
+          "in" : "path",
+          "name" : "nodeId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupDetail"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.update"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "Remove a node from a node group",
+        "tags" : [ "node-groups" ]
+      },
+      "put" : {
+        "description" : "Ajoute un nœud associé à l'organisation du groupe et parlant le contrat v2 ; sans effet s'il y est déjà. Demande `nodeGroup.update`.",
+        "operationId" : "addNodeGroupNode",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the Breign Mate execution node",
+          "in" : "path",
+          "name" : "nodeId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupDetail"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.update"
+          },
+          "404" : {
+            "description" : "Group not found"
+          },
+          "409" : {
+            "description" : "The node cannot join the group (NODE_NOT_ELIGIBLE)"
+          }
+        },
+        "summary" : "Add a node to a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/summary" : {
+      "get" : {
+        "description" : "Les compteurs de la file (en attente, en cours, attente médiane, causes d'attente), la file par agent, l'occupation des nœuds et les environnements conservés. Demande `nodeGroup.read`.",
+        "operationId" : "getNodeGroupSummary",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupQueueSummary"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "Get the queue summary of a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/executions" : {
+      "get" : {
+        "description" : "En attente (avec leur place dans la file), en cours, ou terminées sur 24 h. Seules les exécutions des agents que l'appelant peut lire sont listées. Demande `nodeGroup.read`.",
+        "operationId" : "listNodeGroupExecutions",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "status",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "pending", "running", "done" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "q",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Agents",
+          "in" : "query",
+          "name" : "agentId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "origin",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "conversation", "ticket", "agent", "task" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "waitingFor",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "free", "env_busy", "env_offline" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "nodeId",
+          "required" : false,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "runtime",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "result",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "finished", "failed", "interrupted" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "sort",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "oldest", "newest", "agent" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "page",
+          "required" : false,
+          "schema" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupExecutionPage"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "400" : {
+            "description" : "Unknown filter value"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "List the executions of a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/executions/cancel" : {
+      "post" : {
+        "description" : "Annule ces exécutions (en attente ou en cours). Demande `nodeGroup.execution.manage`, sauf pour les exécutions des conversations de l'appelant.",
+        "operationId" : "cancelNodeGroupExecutions",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/NodeGroupBulkIds"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupBulkResult"
+                }
+              }
+            },
+            "description" : "Le résultat de chaque exécution"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.execution.manage"
+          },
+          "404" : {
+            "description" : "Group or execution not found"
+          }
+        },
+        "summary" : "Cancel executions of a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/executions/start-elsewhere" : {
+      "post" : {
+        "description" : "Ces exécutions n'attendent plus le nœud de leur environnement : le premier nœud libre du groupe les prend. Demande `nodeGroup.execution.manage`, sauf pour les exécutions des conversations de l'appelant.",
+        "operationId" : "startNodeGroupExecutionsElsewhere",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/NodeGroupBulkIds"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupBulkResult"
+                }
+              }
+            },
+            "description" : "Le résultat de chaque exécution"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.execution.manage"
+          },
+          "404" : {
+            "description" : "Group or execution not found"
+          }
+        },
+        "summary" : "Start executions elsewhere",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/nodes" : {
+      "get" : {
+        "description" : "Les nœuds du groupe, leurs emplacements pris, ce qui y tourne, leurs environnements et leurs autres groupes. Demande `nodeGroup.read`.",
+        "operationId" : "listNodeGroupNodes",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "q",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "status",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "online", "offline" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "load",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "full", "free" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "runtime",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "ownerUserId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "sort",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "load", "name", "environments", "lastSeen" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "page",
+          "required" : false,
+          "schema" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupNodePage"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "List the nodes of a node group with their load",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/environments" : {
+      "get" : {
+        "description" : "Les environnements que les nœuds du groupe gardent pour des conversations, avec leurs compteurs par état. Demande `nodeGroup.read`.",
+        "operationId" : "listNodeGroupEnvironments",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "state",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "running", "waiting", "idle", "releasing" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "q",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "nodeId",
+          "required" : false,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "agentId",
+          "required" : false,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "idleBefore",
+          "required" : false,
+          "schema" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "sort",
+          "required" : false,
+          "schema" : {
+            "enum" : [ "idle", "recent" ],
+            "type" : "string"
+          }
+        }, {
+          "in" : "query",
+          "name" : "page",
+          "required" : false,
+          "schema" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupEnvironmentPage"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.read"
+          },
+          "404" : {
+            "description" : "Group not found"
+          }
+        },
+        "summary" : "List the environments kept by the nodes of a group",
+        "tags" : [ "node-groups" ]
+      }
+    },
+    "/node-groups/{groupId}/environments/release" : {
+      "post" : {
+        "description" : "Demande aux nœuds de supprimer ces environnements (ou tous les inactifs). Un environnement qu'une exécution utilise n'est pas libéré. Demande `nodeGroup.environment.release`.",
+        "operationId" : "releaseNodeGroupEnvironments",
+        "parameters" : [ {
+          "description" : "ID of the node group",
+          "in" : "path",
+          "name" : "groupId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/NodeGroupEnvironmentRelease"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeGroupBulkResult"
+                }
+              }
+            },
+            "description" : "Le résultat de chaque environnement"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — missing nodeGroup.environment.release"
+          },
+          "404" : {
+            "description" : "Group or environment not found"
+          }
+        },
+        "summary" : "Release environments of a node group",
+        "tags" : [ "node-groups" ]
+      }
+    },
     "/organizations/{organizationId}/support-settings" : {
       "get" : {
         "description" : "Lisibles par les membres de l'organisation, pour afficher la page Support.",
@@ -21013,7 +21883,7 @@
         "tags" : [ "execution-nodes" ]
       },
       "put" : {
-        "description" : "Ramène l'agent sur le serveur Breign, ou le fait tourner sur un runtime d'un nœud. Seul le propriétaire du nœud peut le choisir, sur un runtime et un alias que le nœud a déclarés ; pour un agent partagé, il faut aussi être admin de l'organisation (ou créateur d'un agent personnel).",
+        "description" : "Ramène l'agent sur le serveur Breign, ou le fait tourner sur un runtime d'un nœud. Seul le propriétaire du nœud peut le choisir, sur un runtime et un alias que le nœud a déclarés ; pour un agent partagé, il faut aussi `agent.update` (ou être créateur d'un agent personnel). Un groupe de nœuds demande `agent.update` et `nodeGroup.read`.",
         "operationId" : "setAgentExecution",
         "parameters" : [ {
           "description" : "ID of the agent",
@@ -21063,6 +21933,95 @@
         "tags" : [ "execution-nodes" ]
       }
     },
+    "/conversations/{conversationId}/messages/{messageId}/node-turn" : {
+      "get" : {
+        "description" : "Où en est le tour qui complète ce message : dans la file (ce qu'il attend, sa place), pris par un nœud, ou terminé. Alimente la carte d'attente du chat.",
+        "operationId" : "getMessageNodeTurn",
+        "parameters" : [ {
+          "description" : "The ID of the conversation",
+          "in" : "path",
+          "name" : "conversationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "The ID of the message",
+          "in" : "path",
+          "name" : "messageId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeQueueTurn"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "404" : {
+            "description" : "Conversation or node turn not found"
+          }
+        },
+        "summary" : "Get the node turn of a message",
+        "tags" : [ "execution-nodes" ]
+      }
+    },
+    "/conversations/{conversationId}/messages/{messageId}/node-turn/start-elsewhere" : {
+      "post" : {
+        "description" : "« Démarrer ailleurs maintenant » : le tour n'attend plus le nœud de l'environnement de la conversation ; le premier nœud libre du groupe le prend, avec l'historique et sans les fichiers.",
+        "operationId" : "startMessageNodeTurnElsewhere",
+        "parameters" : [ {
+          "description" : "The ID of the conversation",
+          "in" : "path",
+          "name" : "conversationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "The ID of the message",
+          "in" : "path",
+          "name" : "messageId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/NodeQueueTurn"
+                }
+              }
+            },
+            "description" : "OK"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "404" : {
+            "description" : "Conversation or node turn not found"
+          },
+          "409" : {
+            "description" : "The turn does not wait for a specific node of a group"
+          }
+        },
+        "summary" : "Start the node turn of a message elsewhere",
+        "tags" : [ "execution-nodes" ]
+      }
+    },
     "/conversations/{conversationId}/messages/{messageId}/node-turn/cancel" : {
       "post" : {
         "description" : "Depuis la conversation, pour un agent qui tourne sur un nœud Breign Mate.",
@@ -23091,6 +24050,16 @@
           "type" : "string"
         }
       },
+      "nodeGroupIdPath" : {
+        "description" : "ID of the node group",
+        "in" : "path",
+        "name" : "groupId",
+        "required" : true,
+        "schema" : {
+          "format" : "uuid",
+          "type" : "string"
+        }
+      },
       "fleetInstallationIdPath" : {
         "description" : "ID of the fleet installation",
         "in" : "path",
@@ -34311,7 +35280,7 @@
             "$ref" : "#/components/schemas/NodeSessionState"
           },
           "reason" : {
-            "description" : "Motif d'un tour interrompu ou en échec : cancelled, host_restart, unpaired, runtime_missing, runtime_failed, workdir_refused, invalid_task, node_unreachable, lost_on_node, node_dissociated (nœud retiré de l'organisation du tour)…",
+            "description" : "Motif d'un tour interrompu ou en échec : cancelled, host_restart, unpaired, runtime_missing, runtime_failed, workdir_refused, invalid_task, node_unreachable, lost_on_node, node_dissociated (nœud retiré de l'organisation du tour), queue_expired (aucun nœud ne l'a pris à temps)…",
             "nullable" : true,
             "type" : "string"
           },
@@ -34345,8 +35314,8 @@
         "type" : "object"
       },
       "NodeSessionState" : {
-        "description" : "`dispatching` : écrit pour le nœud, pas encore acquitté. Les autres suivent le nœud.",
-        "enum" : [ "dispatching", "queued", "running", "interrupted", "finished", "failed" ],
+        "description" : "`pending` : dans la file de la plateforme, pas encore pris par un nœud. `dispatching` : pris par un nœud, pas encore acquitté. Les autres suivent le nœud.",
+        "enum" : [ "pending", "dispatching", "queued", "running", "interrupted", "finished", "failed" ],
         "type" : "string"
       },
       "NodeSessionMetrics" : {
@@ -34481,6 +35450,650 @@
         "enum" : [ "members", "admins", "none" ],
         "type" : "string"
       },
+      "NodeGroupSummary" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroup"
+        }, {
+          "properties" : {
+            "nodeCount" : {
+              "type" : "integer"
+            },
+            "onlineNodeCount" : {
+              "type" : "integer"
+            },
+            "slots" : {
+              "description" : "Emplacements de tous les nœuds du groupe",
+              "type" : "integer"
+            },
+            "onlineSlots" : {
+              "description" : "Emplacements des nœuds en ligne",
+              "type" : "integer"
+            },
+            "agentCount" : {
+              "type" : "integer"
+            }
+          },
+          "required" : [ "agentCount", "nodeCount", "onlineNodeCount", "onlineSlots", "slots" ],
+          "type" : "object"
+        } ]
+      },
+      "NodeGroup" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroupDelays"
+        }, {
+          "properties" : {
+            "id" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "organizationId" : {
+              "type" : "string"
+            },
+            "name" : {
+              "type" : "string"
+            },
+            "description" : {
+              "type" : "string"
+            },
+            "createdByUserId" : {
+              "type" : "string"
+            },
+            "createdAt" : {
+              "type" : "string"
+            },
+            "updatedAt" : {
+              "type" : "string"
+            }
+          },
+          "required" : [ "createdAt", "createdByUserId", "description", "envIdleTtlMs", "envWaitMs", "id", "name", "organizationId", "queueExpiryMs", "updatedAt" ],
+          "type" : "object"
+        } ]
+      },
+      "NodeGroupDelays" : {
+        "properties" : {
+          "envWaitMs" : {
+            "description" : "Attente du nœud qui garde l'environnement d'une conversation, en millisecondes, avant d'en prendre un autre ; `null` : sans limite ; 0 : aucune attente.",
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "envIdleTtlMs" : {
+            "description" : "Libération d'un environnement après ce temps sans activité ; `null` : jamais.",
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "queueExpiryMs" : {
+            "description" : "Une exécution qu'aucun nœud ne prend dans ce délai échoue.",
+            "type" : "integer"
+          }
+        },
+        "type" : "object"
+      },
+      "CreateNodeGroupRequest" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroupDelays"
+        }, {
+          "properties" : {
+            "name" : {
+              "maxLength" : 80,
+              "type" : "string"
+            },
+            "description" : {
+              "maxLength" : 500,
+              "type" : "string"
+            }
+          },
+          "required" : [ "name" ],
+          "type" : "object"
+        } ]
+      },
+      "NodeGroupDetail" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroup"
+        }, {
+          "properties" : {
+            "nodes" : {
+              "items" : {
+                "$ref" : "#/components/schemas/NodeGroupMemberNode"
+              },
+              "type" : "array"
+            },
+            "agents" : {
+              "items" : {
+                "$ref" : "#/components/schemas/NodeGroupAgent"
+              },
+              "type" : "array"
+            }
+          },
+          "required" : [ "agents", "nodes" ],
+          "type" : "object"
+        } ]
+      },
+      "NodeGroupMemberNode" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroupNode"
+        }, {
+          "properties" : {
+            "addedByUserId" : {
+              "type" : "string"
+            },
+            "addedAt" : {
+              "type" : "string"
+            }
+          },
+          "required" : [ "addedAt", "addedByUserId" ],
+          "type" : "object"
+        } ]
+      },
+      "NodeGroupNode" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "os" : {
+            "enum" : [ "macos", "windows", "linux" ],
+            "type" : "string"
+          },
+          "appVersion" : {
+            "type" : "string"
+          },
+          "connected" : {
+            "type" : "boolean"
+          },
+          "revoked" : {
+            "type" : "boolean"
+          },
+          "lastSeenAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "slots" : {
+            "description" : "Exécutions que le nœud mène en même temps",
+            "type" : "integer"
+          },
+          "contractVersion" : {
+            "description" : "Version du contrat parlée par le nœud ; un nœud v1 n'entre dans aucun groupe.",
+            "type" : "integer"
+          },
+          "runtimes" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ExecutionNodeRuntime"
+            },
+            "type" : "array"
+          },
+          "workspaces" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ExecutionNodeWorkspace"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "appVersion", "connected", "contractVersion", "id", "lastSeenAt", "name", "os", "revoked", "runtimes", "slots", "workspaces" ],
+        "type" : "object"
+      },
+      "NodeGroupAgent" : {
+        "properties" : {
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "runtime" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          },
+          "workspaceAlias" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "runtime", "workspaceAlias" ],
+        "type" : "object"
+      },
+      "NodeGroupCandidate" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroupNode"
+        }, {
+          "properties" : {
+            "eligible" : {
+              "type" : "boolean"
+            },
+            "ineligibleReason" : {
+              "description" : "Pourquoi le nœud ne peut pas entrer dans un groupe (mise à jour à faire…)",
+              "nullable" : true,
+              "type" : "string"
+            }
+          },
+          "required" : [ "eligible", "ineligibleReason" ],
+          "type" : "object"
+        } ]
+      },
+      "UpdateNodeGroupRequest" : {
+        "allOf" : [ {
+          "$ref" : "#/components/schemas/NodeGroupDelays"
+        }, {
+          "properties" : {
+            "name" : {
+              "maxLength" : 80,
+              "type" : "string"
+            },
+            "description" : {
+              "maxLength" : 500,
+              "type" : "string"
+            }
+          },
+          "type" : "object"
+        } ]
+      },
+      "NodeGroupQueueSummary" : {
+        "properties" : {
+          "pendingCount" : {
+            "type" : "integer"
+          },
+          "runningCount" : {
+            "type" : "integer"
+          },
+          "oldestQueuedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "nodeCount" : {
+            "type" : "integer"
+          },
+          "onlineNodeCount" : {
+            "type" : "integer"
+          },
+          "slots" : {
+            "type" : "integer"
+          },
+          "onlineSlots" : {
+            "type" : "integer"
+          },
+          "medianWaitMs" : {
+            "$ref" : "#/components/schemas/NodeGroupQueueSummary_medianWaitMs"
+          },
+          "claimedLastDay" : {
+            "type" : "integer"
+          },
+          "waitingFor" : {
+            "$ref" : "#/components/schemas/NodeGroupQueueSummary_waitingFor"
+          },
+          "pendingByAgent" : {
+            "description" : "Les agents lisibles par l'appelant, du plus en attente au moins",
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupQueueSummary_pendingByAgent_inner"
+            },
+            "type" : "array"
+          },
+          "hiddenPendingCount" : {
+            "description" : "Les tours en attente d'agents que l'appelant ne peut pas lire",
+            "type" : "integer"
+          },
+          "nodes" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupQueueSummary_nodes_inner"
+            },
+            "type" : "array"
+          },
+          "environments" : {
+            "$ref" : "#/components/schemas/NodeGroupQueueSummary_environments"
+          }
+        },
+        "required" : [ "claimedLastDay", "environments", "hiddenPendingCount", "medianWaitMs", "nodeCount", "nodes", "oldestQueuedAt", "onlineNodeCount", "onlineSlots", "pendingByAgent", "pendingCount", "runningCount", "slots", "waitingFor" ],
+        "type" : "object"
+      },
+      "NodeGroupExecutionPage" : {
+        "properties" : {
+          "items" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupExecution"
+            },
+            "type" : "array"
+          },
+          "total" : {
+            "type" : "integer"
+          },
+          "hiddenCount" : {
+            "description" : "Les exécutions d'agents que l'appelant ne peut pas lire",
+            "type" : "integer"
+          }
+        },
+        "required" : [ "hiddenCount", "items", "total" ],
+        "type" : "object"
+      },
+      "NodeGroupExecution" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "state" : {
+            "$ref" : "#/components/schemas/NodeSessionState"
+          },
+          "reason" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "conversationId" : {
+            "type" : "string"
+          },
+          "responseMessageId" : {
+            "type" : "string"
+          },
+          "originType" : {
+            "enum" : [ "conversation", "ticket", "agent", "task", null ],
+            "nullable" : true,
+            "type" : "string"
+          },
+          "originTitle" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "runtime" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          },
+          "workspaceAlias" : {
+            "type" : "string"
+          },
+          "node" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeRef"
+            } ],
+            "nullable" : true
+          },
+          "target" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeRef"
+            } ],
+            "nullable" : true
+          },
+          "targetUntil" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "waitingFor" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/WaitingFor"
+            } ],
+            "nullable" : true
+          },
+          "position" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "progress" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeSessionProgress"
+            } ],
+            "nullable" : true
+          },
+          "queuedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "claimedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "expiresAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "type" : "string"
+          },
+          "updatedAt" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "claimedAt", "conversationId", "createdAt", "expiresAt", "id", "node", "originTitle", "originType", "position", "progress", "queuedAt", "reason", "responseMessageId", "runtime", "state", "target", "targetUntil", "updatedAt", "waitingFor", "workspaceAlias" ],
+        "type" : "object"
+      },
+      "NodeRef" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "connected" : {
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "connected", "id", "name" ],
+        "type" : "object"
+      },
+      "WaitingFor" : {
+        "description" : "Ce qu'attend un tour de la file : `free` le premier nœud libre, `env_busy` le nœud qui garde l'environnement de la conversation (occupé), `env_offline` ce nœud, hors ligne.",
+        "enum" : [ "free", "env_busy", "env_offline" ],
+        "type" : "string"
+      },
+      "NodeGroupBulkIds" : {
+        "properties" : {
+          "ids" : {
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "maxItems" : 100,
+            "minItems" : 1,
+            "type" : "array"
+          }
+        },
+        "required" : [ "ids" ],
+        "type" : "object"
+      },
+      "NodeGroupBulkResult" : {
+        "properties" : {
+          "results" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupBulkResult_results_inner"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "results" ],
+        "type" : "object"
+      },
+      "NodeGroupNodePage" : {
+        "properties" : {
+          "items" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupNodeOverview"
+            },
+            "type" : "array"
+          },
+          "total" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "items", "total" ],
+        "type" : "object"
+      },
+      "NodeGroupNodeOverview" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "os" : {
+            "enum" : [ "macos", "windows", "linux" ],
+            "type" : "string"
+          },
+          "appVersion" : {
+            "type" : "string"
+          },
+          "ownerUserId" : {
+            "type" : "string"
+          },
+          "connected" : {
+            "type" : "boolean"
+          },
+          "lastSeenAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "slots" : {
+            "type" : "integer"
+          },
+          "usedSlots" : {
+            "type" : "integer"
+          },
+          "runtimes" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ExecutionNodeRuntime"
+            },
+            "type" : "array"
+          },
+          "workspaces" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ExecutionNodeWorkspace"
+            },
+            "type" : "array"
+          },
+          "running" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupNodeOverview_running_inner"
+            },
+            "type" : "array"
+          },
+          "environmentCount" : {
+            "type" : "integer"
+          },
+          "idleEnvironmentCount" : {
+            "type" : "integer"
+          },
+          "releasePendingCount" : {
+            "type" : "integer"
+          },
+          "otherGroups" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupNodeOverview_otherGroups_inner"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "appVersion", "connected", "environmentCount", "id", "idleEnvironmentCount", "lastSeenAt", "name", "os", "otherGroups", "ownerUserId", "releasePendingCount", "running", "runtimes", "slots", "usedSlots", "workspaces" ],
+        "type" : "object"
+      },
+      "NodeGroupEnvironmentPage" : {
+        "properties" : {
+          "counts" : {
+            "$ref" : "#/components/schemas/NodeGroupEnvironmentPage_counts"
+          },
+          "hiddenCount" : {
+            "type" : "integer"
+          },
+          "total" : {
+            "type" : "integer"
+          },
+          "items" : {
+            "items" : {
+              "$ref" : "#/components/schemas/NodeGroupEnvironment"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "counts", "hiddenCount", "items", "total" ],
+        "type" : "object"
+      },
+      "NodeGroupEnvironment" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "state" : {
+            "description" : "`running` une exécution l'utilise, `waiting` une exécution l'attend, `idle` inactif, `releasing` libération demandée au nœud.",
+            "enum" : [ "running", "waiting", "idle", "releasing" ],
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "conversationId" : {
+            "type" : "string"
+          },
+          "originType" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "originTitle" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "node" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeRef"
+            } ],
+            "nullable" : true
+          },
+          "runtime" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          },
+          "workspaceAlias" : {
+            "type" : "string"
+          },
+          "lastUsedAt" : {
+            "type" : "string"
+          },
+          "releaseAfter" : {
+            "description" : "Libération automatique ; nul pendant une exécution ou si le groupe ne libère jamais",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "releaseRequestedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "releaseReason" : {
+            "enum" : [ "idle", "manual", "moved", "node", "dissociated", null ],
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "conversationId", "id", "lastUsedAt", "node", "originTitle", "originType", "releaseAfter", "releaseReason", "releaseRequestedAt", "runtime", "state", "workspaceAlias" ],
+        "type" : "object"
+      },
+      "NodeGroupEnvironmentRelease" : {
+        "description" : "`{ ids }` libère ces environnements ; `{ filter: { state: idle, idleBefore? } }` libère tous les environnements inactifs (sans exécution) du groupe, inactifs depuis `idleBefore` si donné.",
+        "properties" : {
+          "ids" : {
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "maxItems" : 500,
+            "type" : "array"
+          },
+          "filter" : {
+            "$ref" : "#/components/schemas/NodeGroupEnvironmentRelease_filter"
+          }
+        },
+        "type" : "object"
+      },
       "SupportSettings" : {
         "description" : "La page Support d'une organisation. Réglée par les superadmins ; lue par les membres pour afficher la page.",
         "properties" : {
@@ -35425,9 +37038,21 @@
       "AgentExecution" : {
         "properties" : {
           "mode" : {
-            "enum" : [ "server", "node" ],
+            "enum" : [ "server", "node", "group" ],
             "type" : "string"
           },
+          "group" : {
+            "$ref" : "#/components/schemas/AgentExecution_group"
+          },
+          "keepEnvironment" : {
+            "description" : "Mode group — les messages suivants d'une conversation repartent sur le nœud qui en garde l'environnement.",
+            "type" : "boolean"
+          },
+          "envWaitMs" : {
+            "description" : "Mode group — attente du nœud de l'environnement ; `null` celle du groupe, -1 sans limite.",
+            "nullable" : true,
+            "type" : "integer"
+          },
           "node" : {
             "$ref" : "#/components/schemas/AgentExecution_node"
           },
@@ -35446,9 +37071,17 @@
               "$ref" : "#/components/schemas/AgentExecutionNodeChoice"
             },
             "type" : "array"
+          },
+          "availableGroups" : {
+            "description" : "Nul quand les groupes de nœuds sont éteints ou que l'utilisateur n'a pas `nodeGroup.read`.",
+            "items" : {
+              "$ref" : "#/components/schemas/AgentExecutionGroupChoice"
+            },
+            "nullable" : true,
+            "type" : "array"
           }
         },
-        "required" : [ "availableNodes", "mode" ],
+        "required" : [ "availableGroups", "availableNodes", "mode" ],
         "type" : "object"
       },
       "AgentExecutionNodeChoice" : {
@@ -35481,16 +37114,27 @@
         "type" : "object"
       },
       "SetAgentExecutionRequest" : {
-        "description" : "`{ mode: server }` ramène l'agent sur le serveur Breign. `{ mode: node, … }` le fait tourner sur un nœud ; seul son propriétaire peut le choisir, sur un runtime et un alias déclarés.",
+        "description" : "`{ mode: server }` ramène l'agent sur le serveur Breign. `{ mode: node, … }` le fait tourner sur un nœud ; seul son propriétaire peut le choisir, sur un runtime et un alias déclarés. `{ mode: group, … }` le rattache à un groupe de nœuds de son organisation (`nodeGroup.read`).",
         "properties" : {
           "mode" : {
-            "enum" : [ "server", "node" ],
+            "enum" : [ "server", "node", "group" ],
             "type" : "string"
           },
           "nodeId" : {
             "format" : "uuid",
             "type" : "string"
           },
+          "groupId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "keepEnvironment" : {
+            "type" : "boolean"
+          },
+          "envWaitMs" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
           "runtime" : {
             "enum" : [ "claude", "opencode" ],
             "type" : "string"
@@ -35505,6 +37149,76 @@
         "required" : [ "mode" ],
         "type" : "object"
       },
+      "NodeQueueTurn" : {
+        "description" : "La carte d'attente du chat — où en est le tour qui complète un message.",
+        "properties" : {
+          "sessionId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "state" : {
+            "$ref" : "#/components/schemas/NodeSessionState"
+          },
+          "reason" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "group" : {
+            "$ref" : "#/components/schemas/NodeQueueTurn_group"
+          },
+          "waitingFor" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/WaitingFor"
+            } ],
+            "nullable" : true
+          },
+          "target" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeRef"
+            } ],
+            "description" : "Le nœud attendu (rattachement direct, ou celui de l'environnement)",
+            "nullable" : true
+          },
+          "targetUntil" : {
+            "description" : "Fin de l'attente du nœud de l'environnement ; ensuite, un autre nœud du groupe",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "node" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/NodeRef"
+            } ],
+            "description" : "Le nœud qui a pris le tour",
+            "nullable" : true
+          },
+          "position" : {
+            "description" : "La place dans sa file (1 = le prochain)",
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "queuedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "claimedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "expiresAt" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "environmentId" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "canStartElsewhere" : {
+            "type" : "boolean"
+          }
+        },
+        "required" : [ "canStartElsewhere", "claimedAt", "environmentId", "expiresAt", "group", "node", "position", "queuedAt", "reason", "sessionId", "state", "target", "targetUntil", "waitingFor" ],
+        "type" : "object"
+      },
       "NodeTurnCancelResult" : {
         "properties" : {
           "cancelled" : {
@@ -37090,6 +38804,42 @@
         "enum" : [ "uploading", "ready" ],
         "type" : "string"
       },
+      "AgentExecutionGroupChoice" : {
+        "description" : "Un groupe que l'utilisateur peut choisir pour l'agent, avec ce que ses nœuds portent.",
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "nodeCount" : {
+            "type" : "integer"
+          },
+          "onlineNodeCount" : {
+            "type" : "integer"
+          },
+          "envWaitMs" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "runtimes" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentExecutionGroupChoice_runtimes_inner"
+            },
+            "type" : "array"
+          },
+          "workspaces" : {
+            "items" : {
+              "$ref" : "#/components/schemas/AgentExecutionGroupChoice_workspaces_inner"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "envWaitMs", "id", "name", "nodeCount", "onlineNodeCount", "runtimes", "workspaces" ],
+        "type" : "object"
+      },
       "TicketProposalStatus" : {
         "enum" : [ "pending", "accepted", "rejected", "cancelled" ],
         "type" : "string"
@@ -39359,6 +41109,200 @@
         "required" : [ "callId", "question" ],
         "type" : "object"
       },
+      "NodeGroupQueueSummary_medianWaitMs" : {
+        "properties" : {
+          "lastHour" : {
+            "nullable" : true,
+            "type" : "integer"
+          },
+          "lastDay" : {
+            "nullable" : true,
+            "type" : "integer"
+          }
+        },
+        "required" : [ "lastDay", "lastHour" ],
+        "type" : "object"
+      },
+      "NodeGroupQueueSummary_waitingFor" : {
+        "properties" : {
+          "free" : {
+            "type" : "integer"
+          },
+          "env_busy" : {
+            "type" : "integer"
+          },
+          "env_offline" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "env_busy", "env_offline", "free" ],
+        "type" : "object"
+      },
+      "NodeGroupQueueSummary_pendingByAgent_inner" : {
+        "properties" : {
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "count" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "agentId", "agentName", "count" ],
+        "type" : "object"
+      },
+      "NodeGroupQueueSummary_nodes_inner" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "connected" : {
+            "type" : "boolean"
+          },
+          "slots" : {
+            "type" : "integer"
+          },
+          "usedSlots" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "connected", "id", "name", "slots", "usedSlots" ],
+        "type" : "object"
+      },
+      "NodeGroupQueueSummary_environments" : {
+        "properties" : {
+          "total" : {
+            "type" : "integer"
+          },
+          "idleOver12h" : {
+            "type" : "integer"
+          },
+          "releasePending" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "idleOver12h", "releasePending", "total" ],
+        "type" : "object"
+      },
+      "NodeGroupBulkResult_results_inner" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "ok" : {
+            "type" : "boolean"
+          },
+          "state" : {
+            "type" : "string"
+          },
+          "error" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "ok" ],
+        "type" : "object"
+      },
+      "NodeGroupNodeOverview_running_inner" : {
+        "properties" : {
+          "sessionId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "agentId" : {
+            "type" : "string"
+          },
+          "agentName" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "originType" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "originTitle" : {
+            "nullable" : true,
+            "type" : "string"
+          },
+          "claimedAt" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "agentName", "claimedAt", "originTitle", "originType", "sessionId" ],
+        "type" : "object"
+      },
+      "NodeGroupNodeOverview_otherGroups_inner" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
+      "NodeGroupEnvironmentPage_counts" : {
+        "description" : "Par état, sur tout le groupe",
+        "properties" : {
+          "all" : {
+            "type" : "integer"
+          },
+          "running" : {
+            "type" : "integer"
+          },
+          "waiting" : {
+            "type" : "integer"
+          },
+          "idle" : {
+            "type" : "integer"
+          },
+          "releasing" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "all", "idle", "releasing", "running", "waiting" ],
+        "type" : "object"
+      },
+      "NodeGroupEnvironmentRelease_filter" : {
+        "properties" : {
+          "state" : {
+            "enum" : [ "idle" ],
+            "type" : "string"
+          },
+          "idleBefore" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "required" : [ "state" ],
+        "type" : "object"
+      },
+      "AgentExecution_group" : {
+        "description" : "Présent en mode group ; `name` est nul si l'utilisateur ne voit pas les groupes.",
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "nullable" : true,
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
       "AgentExecution_node" : {
         "description" : "Présent en mode node",
         "properties" : {
@@ -39379,6 +41323,20 @@
         "required" : [ "connected", "id", "name", "ownedByMe" ],
         "type" : "object"
       },
+      "NodeQueueTurn_group" : {
+        "nullable" : true,
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "id", "name" ],
+        "type" : "object"
+      },
       "GitlabRoutingTestResult_botAccount" : {
         "nullable" : true,
         "properties" : {
@@ -39630,6 +41588,34 @@
         },
         "required" : [ "status" ],
         "type" : "object"
+      },
+      "AgentExecutionGroupChoice_runtimes_inner" : {
+        "properties" : {
+          "id" : {
+            "enum" : [ "claude", "opencode" ],
+            "type" : "string"
+          },
+          "nodeCount" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "id", "nodeCount" ],
+        "type" : "object"
+      },
+      "AgentExecutionGroupChoice_workspaces_inner" : {
+        "properties" : {
+          "alias" : {
+            "type" : "string"
+          },
+          "label" : {
+            "type" : "string"
+          },
+          "nodeCount" : {
+            "type" : "integer"
+          }
+        },
+        "required" : [ "alias", "label", "nodeCount" ],
+        "type" : "object"
       }
     },
     "securitySchemes" : {