@breign/client 1.0.194 → 1.0.195

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,353 @@
         "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" ]
+      }
+    },
     "/organizations/{organizationId}/support-settings" : {
       "get" : {
         "description" : "Lisibles par les membres de l'organisation, pour afficher la page Support.",
@@ -21013,7 +21363,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",
@@ -23091,6 +23441,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",
@@ -34481,6 +34841,245 @@
         "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"
+        } ]
+      },
       "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 +36024,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 +36057,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 +36100,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"
@@ -37090,6 +37720,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 +40025,21 @@
         "required" : [ "callId", "question" ],
         "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" : {
@@ -39630,6 +40311,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" : {