@breign/client 1.0.162 → 1.0.164

package/dist/openapi.json

@@ -1781,6 +1781,64 @@
         "tags" : [ "agent" ]
       }
     },
+    "/agents/{agentId}/prompt-init/generate" : {
+      "post" : {
+        "description" : "Writes a ready-to-use initialization prompt from a short brief, using the AI model configured on the agent (or, failing that, on its organisation). The result is returned only — it is never persisted on the agent, which is updated through PATCH /agents/{agentId}.\n",
+        "operationId" : "generateAgentPromptInit",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/AgentPromptInitGenerationRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/AgentPromptInitGenerationResponse"
+                }
+              }
+            },
+            "description" : "Instructions generated successfully"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden - User doesn't have access to this agent"
+          },
+          "404" : {
+            "description" : "Agent not found"
+          },
+          "409" : {
+            "description" : "No AI model is configured for this agent or its organisation"
+          },
+          "502" : {
+            "description" : "The model failed to produce usable instructions"
+          }
+        },
+        "summary" : "Generate initialization instructions for an agent",
+        "tags" : [ "agent" ]
+      }
+    },
     "/agents/{agentId}/tools/{toolId}" : {
       "delete" : {
         "description" : "Unlinks an organization tool from the specified agent",
@@ -5449,9 +5507,109 @@
         "tags" : [ "conversations" ]
       }
     },
+    "/organizations/{organizationId}/chat/agents/{agentId}/conversations" : {
+      "get" : {
+        "description" : "Sessions de chat de l'utilisateur courant avec cet agent, de la plus récemment active à la plus ancienne. Chaque session porte son nombre de non-lus, un aperçu du dernier message et l'indication qu'elle est la conversation principale (celle mémorisée par setUserAgentConversation).",
+        "operationId" : "listUserAgentConversations",
+        "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"
+          }
+        }, {
+          "description" : "Page number (1-based). Must be used together with limit.",
+          "in" : "query",
+          "name" : "page",
+          "required" : false,
+          "schema" : {
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Number of sessions per page. Must be used together with page.",
+          "in" : "query",
+          "name" : "limit",
+          "required" : false,
+          "schema" : {
+            "maximum" : 100,
+            "minimum" : 1,
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Ne renvoie que les sessions ayant des non-lus",
+          "in" : "query",
+          "name" : "unreadOnly",
+          "required" : false,
+          "schema" : {
+            "type" : "boolean"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/ChatSessionSummary"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "Sessions retrieved successfully",
+            "headers" : {
+              "X-Total-Count" : {
+                "description" : "Total number of sessions matching the filters",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Page" : {
+                "description" : "Current page number",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Limit" : {
+                "description" : "Number of items per page",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Total-Pages" : {
+                "description" : "Total number of pages",
+                "schema" : {
+                  "type" : "integer"
+                }
+              }
+            }
+          },
+          "401" : {
+            "description" : "Unauthenticated"
+          },
+          "403" : {
+            "description" : "Forbidden — the caller is not part of the organization or cannot use this agent"
+          }
+        },
+        "summary" : "List the current user's sessions 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.",
+        "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, ainsi que les totaux sur l'ensemble de ses sessions et ses sessions les plus récentes.",
         "operationId" : "getAgentChatOverview",
         "parameters" : [ {
           "description" : "ID of the organization",
@@ -5461,6 +5619,16 @@
           "schema" : {
             "type" : "string"
           }
+        }, {
+          "description" : "Nombre de sessions récentes renvoyées par agent (recentSessions), 5 par défaut",
+          "in" : "query",
+          "name" : "recent",
+          "required" : false,
+          "schema" : {
+            "maximum" : 20,
+            "minimum" : 0,
+            "type" : "integer"
+          }
         } ],
         "responses" : {
           "200" : {
@@ -18554,6 +18722,80 @@
         "required" : [ "transcription" ],
         "type" : "object"
       },
+      "AgentPromptInitGenerationRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "mission" : {
+            "description" : "What the agent is for, in the user's own words.",
+            "maxLength" : 600,
+            "minLength" : 10,
+            "type" : "string"
+          },
+          "audiences" : {
+            "description" : "Who the agent talks to. Several may apply at once; duplicates are rejected. Omit it when `notes.audience` is given — a free-text note replaces the presets. Defaults to `employees` when neither is given. Not declared as `uniqueItems` because the TypeScript generator would turn the field into a `Set`, which does not survive a server-action boundary — the server-side schema enforces uniqueness.\n",
+            "items" : {
+              "enum" : [ "general_public", "customers", "employees", "experts" ],
+              "type" : "string"
+            },
+            "maxItems" : 4,
+            "minItems" : 1,
+            "type" : "array"
+          },
+          "answerStyle" : {
+            "default" : "concise",
+            "description" : "Omit it when `notes.answerStyle` is given. Defaults to `concise`.",
+            "enum" : [ "concise", "detailed", "step_by_step" ],
+            "type" : "string"
+          },
+          "sourcePolicy" : {
+            "default" : "provided_only",
+            "description" : "Omit it when `notes.sourcePolicy` is given. Defaults to `provided_only`.",
+            "enum" : [ "provided_only", "provided_and_general" ],
+            "type" : "string"
+          },
+          "notes" : {
+            "$ref" : "#/components/schemas/AgentPromptInitGenerationRequest_notes"
+          },
+          "constraints" : {
+            "description" : "What the agent must never do.",
+            "maxLength" : 600,
+            "type" : "string"
+          },
+          "lang" : {
+            "description" : "Language the instructions are written in. Defaults to the agent's.",
+            "pattern" : "^[a-z]{2}$",
+            "type" : "string"
+          },
+          "providerId" : {
+            "description" : "Engine to write with, instead of the agent's. Must belong to the agent's organisation. Only honoured together with `model`.\n",
+            "type" : "string"
+          },
+          "model" : {
+            "description" : "Model id within `providerId`.",
+            "type" : "string"
+          }
+        },
+        "required" : [ "mission" ],
+        "type" : "object"
+      },
+      "AgentPromptInitGenerationResponse" : {
+        "properties" : {
+          "promptInit" : {
+            "maxLength" : 50000,
+            "minLength" : 50,
+            "type" : "string"
+          },
+          "warnings" : {
+            "description" : "Adjustments applied to the model's output, for information only.",
+            "items" : {
+              "type" : "string"
+            },
+            "type" : "array"
+          }
+        },
+        "required" : [ "promptInit" ],
+        "type" : "object"
+      },
       "AgentToolAllowedMethodsRequest" : {
         "properties" : {
           "allowedMethods" : {
@@ -20598,6 +20840,52 @@
         "required" : [ "conversationId" ],
         "type" : "object"
       },
+      "ChatSessionSummary" : {
+        "description" : "Une session de chat de l'utilisateur courant avec un agent.",
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "agentId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "title" : {
+            "description" : "Titre de la session ; à défaut, le premier message tronqué",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "type" : "string"
+          },
+          "lastMessageAt" : {
+            "description" : "Horodatage du dernier message, null si la session est vide",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "lastMessagePreview" : {
+            "$ref" : "#/components/schemas/ChatSessionSummary_lastMessagePreview"
+          },
+          "unreadCount" : {
+            "description" : "Même définition que AgentChatOverviewEntry.unreadCount",
+            "type" : "integer"
+          },
+          "isGenerating" : {
+            "type" : "boolean"
+          },
+          "isMain" : {
+            "description" : "Vrai si c'est la conversation principale de l'utilisateur avec cet agent",
+            "type" : "boolean"
+          },
+          "pendingHumanRequests" : {
+            "description" : "Questions Human_ask en attente dans cette session",
+            "type" : "integer"
+          }
+        },
+        "required" : [ "agentId", "createdAt", "id", "isGenerating", "isMain", "lastMessageAt", "pendingHumanRequests", "title", "unreadCount" ],
+        "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" : {
@@ -20615,7 +20903,7 @@
             "type" : "string"
           },
           "unreadCount" : {
-            "description" : "Messages non lus, hors messages de l'utilisateur lui-même",
+            "description" : "Non-lus de cette conversation : messages de l'agent postérieurs à la marque de lecture, et interactions qui attendent l'utilisateur (question Human_ask, validation d'outil) tant qu'elles ne sont pas traitées.",
             "type" : "integer"
           },
           "isGenerating" : {
@@ -20625,6 +20913,21 @@
           "pendingHumanRequests" : {
             "description" : "Questions de cet agent qui attendent une réponse de l'utilisateur courant (outil Human_ask), toutes tâches confondues.",
             "type" : "integer"
+          },
+          "totalUnreadCount" : {
+            "description" : "Somme des non-lus sur toutes les sessions de l'utilisateur avec cet agent",
+            "type" : "integer"
+          },
+          "sessionCount" : {
+            "description" : "Nombre de sessions de l'utilisateur avec cet agent",
+            "type" : "integer"
+          },
+          "recentSessions" : {
+            "description" : "Sessions les plus récemment actives, conversation principale comprise",
+            "items" : {
+              "$ref" : "#/components/schemas/ChatSessionSummary"
+            },
+            "type" : "array"
           }
         },
         "required" : [ "agentId", "conversationId", "isGenerating", "unreadCount" ],
@@ -26744,6 +27047,25 @@
         "required" : [ "x", "y" ],
         "type" : "object"
       },
+      "AgentPromptInitGenerationRequest_notes" : {
+        "additionalProperties" : false,
+        "description" : "What the user wrote themselves when no preset fitted, per question. A note REPLACES the presets of its own question rather than adding to them.\n",
+        "properties" : {
+          "audience" : {
+            "maxLength" : 300,
+            "type" : "string"
+          },
+          "answerStyle" : {
+            "maxLength" : 300,
+            "type" : "string"
+          },
+          "sourcePolicy" : {
+            "maxLength" : 300,
+            "type" : "string"
+          }
+        },
+        "type" : "object"
+      },
       "ChatMessage_audio_inner" : {
         "properties" : {
           "sequence" : {
@@ -27313,6 +27635,21 @@
         "required" : [ "contentType", "ext", "size" ],
         "type" : "object"
       },
+      "ChatSessionSummary_lastMessagePreview" : {
+        "nullable" : true,
+        "properties" : {
+          "role" : {
+            "enum" : [ "USER", "ASSISTANT" ],
+            "type" : "string"
+          },
+          "content" : {
+            "description" : "Début du dernier message, tronqué",
+            "type" : "string"
+          }
+        },
+        "required" : [ "content", "role" ],
+        "type" : "object"
+      },
       "HumanRequestSummary_requestedBy" : {
         "properties" : {
           "kind" : {

package/package.json

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