@breign/client 1.0.81 → 1.0.83

package/dist/openapi.json

@@ -66,6 +66,9 @@
   }, {
     "description" : "Chat prompts and conversation management",
     "name" : "prompts"
+  }, {
+    "description" : "Skills management endpoints",
+    "name" : "skills"
   } ],
   "paths" : {
     "/health" : {
@@ -6693,6 +6696,368 @@
         "tags" : [ "tools" ]
       }
     },
+    "/skills" : {
+      "get" : {
+        "description" : "Returns a paginated list of skills scoped to an organization",
+        "operationId" : "listSkills",
+        "parameters" : [ {
+          "description" : "Organization ID",
+          "in" : "query",
+          "name" : "organizationId",
+          "required" : true,
+          "schema" : {
+            "type" : "string"
+          }
+        }, {
+          "description" : "Page number",
+          "in" : "query",
+          "name" : "page",
+          "schema" : {
+            "type" : "integer"
+          }
+        }, {
+          "description" : "Maximum number of skills to return",
+          "in" : "query",
+          "name" : "limit",
+          "schema" : {
+            "default" : 20,
+            "maximum" : 100,
+            "type" : "integer"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/Skill"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "List of skills",
+            "headers" : {
+              "X-Total-Count" : {
+                "description" : "Total number of skills in the organization",
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Page" : {
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Limit" : {
+                "schema" : {
+                  "type" : "integer"
+                }
+              },
+              "X-Total-Pages" : {
+                "schema" : {
+                  "type" : "integer"
+                }
+              }
+            }
+          },
+          "400" : {
+            "description" : "MISSING_ORG_ID"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          }
+        },
+        "summary" : "List skills in an organization",
+        "tags" : [ "skills" ]
+      },
+      "post" : {
+        "description" : "Creates a new skill in an organization",
+        "operationId" : "createSkill",
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/SkillCreateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "201" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Skill"
+                }
+              }
+            },
+            "description" : "Skill created successfully"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "409" : {
+            "description" : "SKILL_SLUG_ALREADY_EXISTS"
+          }
+        },
+        "summary" : "Create a skill",
+        "tags" : [ "skills" ]
+      }
+    },
+    "/skills/{skillId}" : {
+      "delete" : {
+        "operationId" : "deleteSkill",
+        "parameters" : [ {
+          "description" : "Skill identifier",
+          "in" : "path",
+          "name" : "skillId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "Skill deleted successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "SKILL_NOT_FOUND"
+          }
+        },
+        "summary" : "Delete a skill",
+        "tags" : [ "skills" ]
+      },
+      "get" : {
+        "operationId" : "getSkill",
+        "parameters" : [ {
+          "description" : "Skill identifier",
+          "in" : "path",
+          "name" : "skillId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Skill"
+                }
+              }
+            },
+            "description" : "Skill details"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "SKILL_NOT_FOUND"
+          }
+        },
+        "summary" : "Get a skill by ID",
+        "tags" : [ "skills" ]
+      },
+      "patch" : {
+        "operationId" : "updateSkill",
+        "parameters" : [ {
+          "description" : "Skill identifier",
+          "in" : "path",
+          "name" : "skillId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "requestBody" : {
+          "content" : {
+            "application/json" : {
+              "schema" : {
+                "$ref" : "#/components/schemas/SkillUpdateRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "$ref" : "#/components/schemas/Skill"
+                }
+              }
+            },
+            "description" : "Skill updated successfully"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "SKILL_NOT_FOUND"
+          },
+          "409" : {
+            "description" : "SKILL_SLUG_ALREADY_EXISTS"
+          }
+        },
+        "summary" : "Update a skill",
+        "tags" : [ "skills" ]
+      }
+    },
+    "/agents/{agentId}/skills" : {
+      "get" : {
+        "operationId" : "getAgentSkills",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "200" : {
+            "content" : {
+              "application/json" : {
+                "schema" : {
+                  "items" : {
+                    "$ref" : "#/components/schemas/Skill"
+                  },
+                  "type" : "array"
+                }
+              }
+            },
+            "description" : "List of skills assigned to the agent"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "AGENT_NOT_FOUND"
+          }
+        },
+        "summary" : "Get skills assigned to an agent",
+        "tags" : [ "skills" ]
+      },
+      "post" : {
+        "operationId" : "assignSkillToAgent",
+        "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/SkillAssignRequest"
+              }
+            }
+          },
+          "required" : true
+        },
+        "responses" : {
+          "200" : {
+            "description" : "Skill assigned (or already assigned — idempotent)"
+          },
+          "400" : {
+            "description" : "Invalid request body"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden — SKILL_ORG_MISMATCH if skill belongs to a different org"
+          },
+          "404" : {
+            "description" : "AGENT_NOT_FOUND or SKILL_NOT_FOUND"
+          }
+        },
+        "summary" : "Assign a skill to an agent",
+        "tags" : [ "skills" ]
+      }
+    },
+    "/agents/{agentId}/skills/{skillId}" : {
+      "delete" : {
+        "operationId" : "unassignSkillFromAgent",
+        "parameters" : [ {
+          "description" : "ID of the agent",
+          "in" : "path",
+          "name" : "agentId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        }, {
+          "description" : "Skill identifier",
+          "in" : "path",
+          "name" : "skillId",
+          "required" : true,
+          "schema" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        } ],
+        "responses" : {
+          "204" : {
+            "description" : "Skill unassigned successfully"
+          },
+          "401" : {
+            "description" : "Unauthorized"
+          },
+          "403" : {
+            "description" : "Forbidden"
+          },
+          "404" : {
+            "description" : "AGENT_NOT_FOUND or assignment not found"
+          }
+        },
+        "summary" : "Unassign a skill from an agent",
+        "tags" : [ "skills" ]
+      }
+    },
     "/remote/pin-requests" : {
       "post" : {
         "description" : "Creates a PIN request for remote access",
@@ -7564,6 +7929,16 @@
           "type" : "string"
         }
       },
+      "skillIdPath" : {
+        "description" : "Skill identifier",
+        "in" : "path",
+        "name" : "skillId",
+        "required" : true,
+        "schema" : {
+          "format" : "uuid",
+          "type" : "string"
+        }
+      },
       "async" : {
         "description" : "If true, run the operation in async mode (poll the ressource then).",
         "in" : "query",
@@ -9030,6 +9405,9 @@
           "name" : {
             "type" : "string"
           },
+          "description" : {
+            "type" : "string"
+          },
           "agentId" : {
             "type" : "string"
           },
@@ -9060,6 +9438,9 @@
           "name" : {
             "type" : "string"
           },
+          "description" : {
+            "type" : "string"
+          },
           "agentId" : {
             "type" : "string"
           },
@@ -9123,6 +9504,9 @@
           "name" : {
             "type" : "string"
           },
+          "description" : {
+            "type" : "string"
+          },
           "agentId" : {
             "type" : "string"
           },
@@ -9371,6 +9755,9 @@
           "name" : {
             "type" : "string"
           },
+          "description" : {
+            "type" : "string"
+          },
           "streamingEnabled" : {
             "type" : "boolean"
           },
@@ -10986,6 +11373,105 @@
         "title" : "RevealTokenResponse",
         "type" : "object"
       },
+      "Skill" : {
+        "properties" : {
+          "id" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "orgId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "type" : "string"
+          },
+          "slug" : {
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "content" : {
+            "type" : "string"
+          },
+          "isActive" : {
+            "type" : "boolean"
+          },
+          "createdBy" : {
+            "format" : "uuid",
+            "nullable" : true,
+            "type" : "string"
+          },
+          "createdAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          },
+          "updatedAt" : {
+            "format" : "date-time",
+            "type" : "string"
+          }
+        },
+        "required" : [ "content", "description", "id", "isActive", "name", "orgId", "slug" ],
+        "type" : "object"
+      },
+      "SkillCreateRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "orgId" : {
+            "format" : "uuid",
+            "type" : "string"
+          },
+          "name" : {
+            "maxLength" : 255,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "slug" : {
+            "pattern" : "^[a-z0-9]+(?:-[a-z0-9]+)*$",
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "content" : {
+            "type" : "string"
+          }
+        },
+        "required" : [ "content", "description", "name", "orgId", "slug" ],
+        "type" : "object"
+      },
+      "SkillUpdateRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "name" : {
+            "maxLength" : 255,
+            "minLength" : 1,
+            "type" : "string"
+          },
+          "description" : {
+            "type" : "string"
+          },
+          "content" : {
+            "type" : "string"
+          },
+          "isActive" : {
+            "type" : "boolean"
+          }
+        },
+        "type" : "object"
+      },
+      "SkillAssignRequest" : {
+        "additionalProperties" : false,
+        "properties" : {
+          "skill_id" : {
+            "format" : "uuid",
+            "type" : "string"
+          }
+        },
+        "required" : [ "skill_id" ],
+        "type" : "object"
+      },
       "PinRequest" : {
         "properties" : {
           "user" : {

package/package.json

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