@breign/client 1.0.133 → 1.0.135

package/dist/openapi.json

@@ -5103,6 +5103,140 @@
         "tags" : [ "conversations" ]
       }
     },
+    "/organizations/{organizationId}/chat/preferences" : {
+      "get" : {
+        "description" : "Agents épinglés, état du rail et conversation en cours avec chaque agent de l'organisation, pour l'utilisateur courant.",
+        "operationId" : "getUserChatPreferences",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/UserChatPreferences"
+                }
+              }
+            },
+            "description" : "Preferences retrieved successfully"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — the caller is not part of the organization"
+          }
+        },
+        "summary" : "Get the user's chat preferences",
+        "tags" : [ "conversations" ]
+      },
+      "put" : {
+        "description" : "Mise à jour partielle — une propriété absente reste inchangée.",
+        "operationId" : "updateUserChatPreferences",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/UpdateUserChatPreferencesRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/UserChatPreferences"
+                }
+              }
+            },
+            "description" : "Updated preferences"
+          },
+          "400" : {
+            "description" : "Invalid payload"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — the caller is not part of the organization"
+          }
+        },
+        "summary" : "Update the user's chat preferences",
+        "tags" : [ "conversations" ]
+      }
+    },
+    "/organizations/{organizationId}/chat/agents/{agentId}/conversation" : {
+      "put" : {
+        "description" : "Mémorise la conversation que l'utilisateur a en cours avec cet agent. Elle prime ensuite sur la conversation la plus récente dans l'aperçu du chat.",
+        "operationId" : "setUserAgentConversation",
+        "parameters" : [ {
+          "description" : "ID of the organization",
+          "in" : "path",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/SetUserAgentConversationRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "204" : {
+            "description" : "Conversation pointer updated"
+          },
+          "400" : {
+            "description" : "conversationId is required"
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "CONVERSATION_NOT_FOUND — unknown"
+          }
+        },
+        "summary" : "Set the conversation in progress with an agent",
+        "tags" : [ "conversations" ]
+      }
+    },
     "/organizations/{organizationId}/chat/overview" : {
       "get" : {
         "description" : "Pour chaque agent de l'organisation avec lequel l'utilisateur a une conversation, renvoie sa conversation la plus récente, le nombre de messages non lus et l'indication d'une réponse en cours de génération.",
@@ -11630,6 +11764,132 @@
         "tags" : [ "prompts" ]
       }
     },
+    "/conversations/{conversationId}/messages/{messageId}/tool-calls" : {
+      "get" : {
+        "description" : "Returns the tool calls issued by one assistant message, newest first. Use pending=true while waiting: it keeps only the calls that still need a result. Without the filter, calls already answered are returned too, so a client can replay what it sent.",
+        "operationId" : "listMessageToolCalls",
+        "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"
+          }
+        }, {
+          "description" : "When true, only the calls still awaiting a result.",
+          "in" : "query",
+          "name" : "pending",
+          "schema" : {
+            "type" : "boolean"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ToolCallsResponse"
+                }
+              }
+            },
+            "description" : "Tool calls of the message"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Conversation not found, or not visible to the caller"
+          }
+        },
+        "summary" : "List the tool calls of a message",
+        "tags" : [ "conversations" ]
+      }
+    },
+    "/conversations/{conversationId}/messages/{messageId}/tool-calls/{callId}" : {
+      "post" : {
+        "description" : "Submits the result of one tool call, which releases the suspended conversation turn. Works for any tool: output becomes the tool result handed to the model, and attachments are stored, added to the conversation context and to the last user message. A call can only be answered once — answering an already resolved or expired call returns 409. A message may carry several calls, each answered independently and in any order.",
+        "operationId" : "submitMessageToolCallResult",
+        "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"
+          }
+        }, {
+          "description" : "Identifier of the tool call, as returned by the listing.",
+          "in" : "path",
+          "name" : "callId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/ToolCallResultRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/ToolCallResultResponse"
+                }
+              }
+            },
+            "description" : "Tool call resolved and the conversation turn released"
+          },
+          "400" : {
+            "description" : "Missing or invalid status, or an attachment carrying neither url nor inlineDataUrl, an invalid data URL, or a payload that could not be read."
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "Conversation not found, or no such tool call on this message"
+          },
+          "409" : {
+            "description" : "Tool call already resolved or expired"
+          },
+          "503" : {
+            "description" : "Deferred tool calls are not configured on this deployment"
+          }
+        },
+        "summary" : "Post the result of a tool call",
+        "tags" : [ "conversations" ]
+      }
+    },
     "/conversations/{conversationId}/messages/{messageId}/reaction" : {
       "patch" : {
         "description" : "Set or clear user reaction (thumb up/down) on a conversation message.",
@@ -14420,6 +14680,12 @@
             } ],
             "nullable" : true
           },
+          "pendingToolsConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentPendingToolsConfiguration"
+            } ],
+            "nullable" : true
+          },
           "creator" : {
             "$ref" : "#/components/schemas/Agent_creator"
           },
@@ -14608,6 +14874,24 @@
         },
         "type" : "object"
       },
+      "AgentPendingToolsConfiguration" : {
+        "description" : "Per-agent activation of deferred tools: those that suspend the chat turn until a client answers. Opt-in, because an agent whose client never answers would hang its turns. A tool is available only when the general switch is on AND the tool is listed.",
+        "properties" : {
+          "enabled" : {
+            "description" : "General switch for deferred tools on this agent.",
+            "type" : "boolean"
+          },
+          "tools" : {
+            "description" : "Names of the allowed deferred tools, for instance take_screenshot. Listing tools here is what makes them available, so a new deferred tool needs no schema change.",
+            "items" : {
+              "type" : "string"
+            },
+            "maxItems" : 50,
+            "type" : "array"
+          }
+        },
+        "type" : "object"
+      },
       "AgentTool" : {
         "properties" : {
           "id" : {
@@ -14779,6 +15063,12 @@
               "$ref" : "#/components/schemas/AgentSandboxConfiguration"
             } ],
             "nullable" : true
+          },
+          "pendingToolsConfiguration" : {
+            "allOf" : [ {
+              "$ref" : "#/components/schemas/AgentPendingToolsConfiguration"
+            } ],
+            "nullable" : true
           }
         },
         "type" : "object"
@@ -17475,6 +17765,70 @@
           "$ref" : "#/components/schemas/AudioFile"
         } ]
       },
+      "UserChatPreferences" : {
+        "properties" : {
+          "pinnedAgentIds" : {
+            "description" : "Liste ordonnée des agents épinglés dans le rail",
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "railOpen" : {
+            "type" : "boolean"
+          },
+          "agentConversations" : {
+            "description" : "Conversation en cours avec chaque agent de l'organisation",
+            "items" : {
+              "$ref" : "#/components/schemas/UserAgentConversation"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "agentConversations", "pinnedAgentIds", "railOpen" ],
+        "type" : "object"
+      },
+      "UserAgentConversation" : {
+        "properties" : {
+          "agentId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "conversationId" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        },
+        "required" : [ "agentId", "conversationId" ],
+        "type" : "object"
+      },
+      "UpdateUserChatPreferencesRequest" : {
+        "description" : "Mise à jour partielle — une propriété absente reste inchangée.",
+        "properties" : {
+          "pinnedAgentIds" : {
+            "items" : {
+              "format" : "uuid",
+              "type" : "string"
+            },
+            "type" : "array"
+          },
+          "railOpen" : {
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "SetUserAgentConversationRequest" : {
+        "properties" : {
+          "conversationId" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        },
+        "required" : [ "conversationId" ],
+        "type" : "object"
+      },
       "AgentChatOverviewEntry" : {
         "description" : "État de la conversation d'un agent pour l'utilisateur courant. Le nombre de non-lus est dérivé des messages postérieurs à sa marque de lecture.",
         "properties" : {
@@ -19826,6 +20180,162 @@
         "required" : [ "status" ],
         "type" : "object"
       },
+      "ToolCallsResponse" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "toolCalls" : {
+            "items" : {
+              "$ref" : "#/components/schemas/ToolCall"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "toolCalls" ],
+        "title" : "ToolCallsResponse",
+        "type" : "object"
+      },
+      "ToolCall" : {
+        "additionalProperties" : false,
+        "description" : "A tool call whose result does not come from the server. The conversation turn stays suspended until a client posts the result, or until expiresAt passes.",
+        "properties" : {
+          "callId" : {
+            "description" : "Identifier to post the result to.",
+            "type" : "string"
+          },
+          "tool" : {
+            "description" : "Name of the tool the model called.",
+            "type" : "string"
+          },
+          "status" : {
+            "description" : "pending and expired are set by the server; the others come from the client.",
+            "enum" : [ "pending", "completed", "failed", "refused", "expired" ],
+            "type" : "string"
+          },
+          "conversationId" : {
+            "type" : "string"
+          },
+          "messageId" : {
+            "description" : "Assistant message of the turn that issued the call.",
+            "type" : "string"
+          },
+          "deviceId" : {
+            "description" : "Target device, informative only. Authorization goes through the conversation.",
+            "type" : "string"
+          },
+          "arguments" : {
+            "additionalProperties" : true,
+            "description" : "Arguments the model passed to the tool.",
+            "type" : "object"
+          },
+          "createdAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "expiresAt" : {
+            "description" : "Past this point the call is expired and the conversation turn is released.",
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "required" : [ "callId", "expiresAt", "status", "tool" ],
+        "title" : "ToolCall",
+        "type" : "object"
+      },
+      "ToolCallResultRequest" : {
+        "additionalProperties" : false,
+        "description" : "Result of a tool call, whatever the tool. output is handed to the model as the tool result; attachments are stored and added to the conversation context so the model can see them.",
+        "properties" : {
+          "status" : {
+            "enum" : [ "completed", "failed", "refused" ],
+            "type" : "string"
+          },
+          "output" : {
+            "description" : "Text handed to the model. A default sentence is used when omitted.",
+            "type" : "string"
+          },
+          "attachments" : {
+            "description" : "Only read when status is completed.",
+            "items" : {
+              "$ref" : "#/components/schemas/ToolCallAttachment"
+            },
+            "maxItems" : 10,
+            "type" : "array"
+          },
+          "error" : {
+            "description" : "Failure detail, surfaced to the model when status is failed.",
+            "type" : "string"
+          }
+        },
+        "required" : [ "status" ],
+        "title" : "ToolCallResultRequest",
+        "type" : "object"
+      },
+      "ToolCallAttachment" : {
+        "additionalProperties" : false,
+        "description" : "A file produced by a tool. Either url or inlineDataUrl is required; every other field is derived server-side when omitted.",
+        "properties" : {
+          "type" : {
+            "enum" : [ "image" ],
+            "type" : "string"
+          },
+          "id" : {
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "mimeType" : {
+            "description" : "Defaults to image/png.",
+            "type" : "string"
+          },
+          "ext" : {
+            "description" : "Defaults to the mimeType subtype.",
+            "type" : "string"
+          },
+          "size" : {
+            "description" : "Defaults to the decoded payload length.",
+            "type" : "number"
+          },
+          "key" : {
+            "description" : "Storage key. Defaults to conversations/{conversationId}/attachments/{id}.{ext}.",
+            "type" : "string"
+          },
+          "url" : {
+            "description" : "Downloadable URL, fetched server-side. Used when inlineDataUrl is absent.",
+            "type" : "string"
+          },
+          "inlineDataUrl" : {
+            "description" : "Base64 data URL: data:<mimeType>;base64,<data>",
+            "type" : "string"
+          }
+        },
+        "title" : "ToolCallAttachment",
+        "type" : "object"
+      },
+      "ToolCallResultResponse" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "callId" : {
+            "type" : "string"
+          },
+          "tool" : {
+            "type" : "string"
+          },
+          "status" : {
+            "enum" : [ "completed", "failed", "refused" ],
+            "type" : "string"
+          },
+          "conversationId" : {
+            "type" : "string"
+          },
+          "messageId" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "callId", "conversationId", "messageId", "status", "tool" ],
+        "title" : "ToolCallResultResponse",
+        "type" : "object"
+      },
       "FillersArray" : {
         "items" : {
           "$ref" : "#/components/schemas/FillersArray_inner"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breign/client",
-  "version": "1.0.133",
+  "version": "1.0.135",
   "main": "dist/index.js",
   "exports": {
     ".": "./dist/index.js",