@vellumai/assistant 0.5.16 → 0.6.0

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.5.15
+  version: 0.6.0
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -3131,6 +3131,115 @@ paths:
                   description: Upper bound epoch ms
                   type: number
               additionalProperties: false
+  /v1/groups:
+    get:
+      operationId: groups_get
+      summary: List groups
+      description: Return all conversation groups.
+      tags:
+        - groups
+      responses:
+        "200":
+          description: Successful response
+    post:
+      operationId: groups_post
+      summary: Create group
+      description: Create a new custom conversation group. Server assigns sort_position.
+      tags:
+        - groups
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                  description: Group name
+              required:
+                - name
+              additionalProperties: false
+  /v1/groups/{groupId}:
+    delete:
+      operationId: groups_by_groupId_delete
+      summary: Delete group
+      description: Delete a custom conversation group.
+      tags:
+        - groups
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+    patch:
+      operationId: groups_by_groupId_patch
+      summary: Update group
+      description: Update a conversation group's name or sort position.
+      tags:
+        - groups
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: groupId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                sortPosition:
+                  type: number
+              additionalProperties: false
+  /v1/groups/reorder:
+    post:
+      operationId: groups_reorder_post
+      summary: Reorder groups
+      description: Batch-update sort positions for conversation groups.
+      tags:
+        - groups
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                updates:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      groupId:
+                        type: string
+                      sortPosition:
+                        type: number
+                    required:
+                      - groupId
+                      - sortPosition
+                    additionalProperties: false
+                  description: Array of { groupId, sortPosition } objects
+              required:
+                - updates
+              additionalProperties: false
   /v1/guardian-actions/decision:
     post:
       operationId: guardianactions_decision_post
@@ -4071,7 +4180,7 @@ paths:
     post:
       operationId: memoryitems_post
       summary: Create a memory item
-      description: Create a new memory item and enqueue embedding.
+      description: Create a new memory graph node and enqueue embedding.
       tags:
         - memory
       responses:
@@ -4099,10 +4208,10 @@ paths:
               properties:
                 kind:
                   type: string
-                  description: Memory kind (identity, preference, project, etc.)
+                  description: Memory type (episodic, semantic, procedural, etc.)
                 subject:
                   type: string
-                  description: Subject line
+                  description: Subject line (first line of content)
                 statement:
                   type: string
                   description: Statement content
@@ -4111,14 +4220,13 @@ paths:
                   description: Importance score (default 0.8)
               required:
                 - kind
-                - subject
                 - statement
               additionalProperties: false
   /v1/memory-items/{id}:
     delete:
       operationId: memoryitems_by_id_delete
       summary: Delete a memory item
-      description: Delete a memory item and its embeddings.
+      description: Delete a memory graph node and its embeddings.
       tags:
         - memory
       responses:
@@ -4143,7 +4251,7 @@ paths:
     get:
       operationId: memoryitems_by_id_get
       summary: Get a memory item
-      description: Return a single memory item by ID with supersession metadata.
+      description: Return a single memory item by ID with graph metadata.
       tags:
         - memory
       responses:
@@ -4158,7 +4266,7 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
-                    description: Memory item with scopeLabel and supersession info
+                    description: Memory item with scopeLabel and graph metadata
                 required:
                   - item
                 additionalProperties: false
@@ -4171,7 +4279,7 @@ paths:
     patch:
       operationId: memoryitems_by_id_patch
       summary: Update a memory item
-      description: Partially update fields on an existing memory item.
+      description: Partially update fields on an existing memory graph node.
       tags:
         - memory
       responses:
@@ -4213,18 +4321,6 @@ paths:
                   type: string
                 importance:
                   type: number
-                sourceType:
-                  type: string
-                verificationState:
-                  type: string
-              required:
-                - subject
-                - statement
-                - kind
-                - status
-                - importance
-                - sourceType
-                - verificationState
               additionalProperties: false
   /v1/messages:
     get:
@@ -5601,68 +5697,165 @@ paths:
                   skills:
                     type: array
                     items:
-                      type: object
-                      properties:
-                        id:
-                          type: string
-                        name:
-                          type: string
-                        description:
-                          type: string
-                        emoji:
-                          type: string
-                        homepage:
-                          type: string
-                        source:
-                          type: string
-                          enum:
-                            - bundled
-                            - managed
-                            - workspace
-                            - clawhub
-                            - extra
-                            - catalog
-                        state:
-                          type: string
-                          enum:
-                            - enabled
-                            - disabled
-                        installStatus:
-                          type: string
-                          enum:
-                            - bundled
-                            - installed
-                            - available
-                        updateAvailable:
-                          type: boolean
-                        provenance:
-                          type: object
+                      oneOf:
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: vellum
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                          additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: clawhub
+                            slug:
+                              type: string
+                            author:
+                              type: string
+                            stars:
+                              type: number
+                            installs:
+                              type: number
+                            reports:
+                              type: number
+                            publishedAt:
+                              type: string
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                            - slug
+                            - author
+                            - stars
+                            - installs
+                            - reports
+                          additionalProperties: false
+                        - type: object
                           properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
                             kind:
                               type: string
                               enum:
-                                - first-party
-                                - third-party
-                                - local
-                            provider:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
                               type: string
-                            originId:
+                              const: skillssh
+                            slug:
                               type: string
-                            sourceUrl:
+                            sourceRepo:
                               type: string
+                            installs:
+                              type: number
                           required:
+                            - id
+                            - name
+                            - description
                             - kind
+                            - status
+                            - origin
+                            - slug
+                            - sourceRepo
+                            - installs
+                          additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: custom
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
                           additionalProperties: false
-                      required:
-                        - id
-                        - name
-                        - description
-                        - source
-                        - state
-                        - installStatus
-                        - updateAvailable
-                        - provenance
-                      additionalProperties: false
                     description: Skill objects
                 required:
                   - skills
@@ -5735,12 +5928,235 @@ paths:
     get:
       operationId: skills_by_id_get
       summary: Get skill
-      description: Return a single skill by ID.
+      description: Return a single skill by ID with enriched detail fields.
       tags:
         - skills
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  skill:
+                    oneOf:
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          origin:
+                            type: string
+                            const: vellum
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - origin
+                        additionalProperties: false
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          origin:
+                            type: string
+                            const: clawhub
+                          slug:
+                            type: string
+                          author:
+                            type: string
+                          stars:
+                            type: number
+                          installs:
+                            type: number
+                          reports:
+                            type: number
+                          publishedAt:
+                            type: string
+                          owner:
+                            anyOf:
+                              - type: object
+                                properties:
+                                  handle:
+                                    type: string
+                                  displayName:
+                                    type: string
+                                  image:
+                                    type: string
+                                required:
+                                  - handle
+                                  - displayName
+                                additionalProperties: false
+                              - type: "null"
+                          stats:
+                            anyOf:
+                              - type: object
+                                properties:
+                                  stars:
+                                    type: number
+                                  installs:
+                                    type: number
+                                  downloads:
+                                    type: number
+                                  versions:
+                                    type: number
+                                required:
+                                  - stars
+                                  - installs
+                                  - downloads
+                                  - versions
+                                additionalProperties: false
+                              - type: "null"
+                          latestVersion:
+                            anyOf:
+                              - type: object
+                                properties:
+                                  version:
+                                    type: string
+                                  changelog:
+                                    type: string
+                                required:
+                                  - version
+                                additionalProperties: false
+                              - type: "null"
+                          createdAt:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          updatedAt:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - origin
+                          - slug
+                          - author
+                          - stars
+                          - installs
+                          - reports
+                        additionalProperties: false
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          origin:
+                            type: string
+                            const: skillssh
+                          slug:
+                            type: string
+                          sourceRepo:
+                            type: string
+                          installs:
+                            type: number
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - origin
+                          - slug
+                          - sourceRepo
+                          - installs
+                        additionalProperties: false
+                      - type: object
+                        properties:
+                          id:
+                            type: string
+                          name:
+                            type: string
+                          description:
+                            type: string
+                          emoji:
+                            type: string
+                          kind:
+                            type: string
+                            enum:
+                              - bundled
+                              - installed
+                              - catalog
+                          status:
+                            type: string
+                            enum:
+                              - enabled
+                              - disabled
+                              - available
+                          origin:
+                            type: string
+                            const: custom
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - origin
+                        additionalProperties: false
+                    description: Skill detail object
+                required:
+                  - skill
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -5991,6 +6407,12 @@ paths:
                   description: Skill spec
                 version:
                   type: string
+                origin:
+                  description: Which registry to install from. When omitted, the install flow auto-detects based on slug format.
+                  type: string
+                  enum:
+                    - clawhub
+                    - skillssh
               required:
                 - slug
                 - url
@@ -6012,13 +6434,171 @@ paths:
               schema:
                 type: object
                 properties:
-                  data:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
-                    description: Search results
+                  skills:
+                    type: array
+                    items:
+                      oneOf:
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: vellum
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                          additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: clawhub
+                            slug:
+                              type: string
+                            author:
+                              type: string
+                            stars:
+                              type: number
+                            installs:
+                              type: number
+                            reports:
+                              type: number
+                            publishedAt:
+                              type: string
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                            - slug
+                            - author
+                            - stars
+                            - installs
+                            - reports
+                          additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: skillssh
+                            slug:
+                              type: string
+                            sourceRepo:
+                              type: string
+                            installs:
+                              type: number
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                            - slug
+                            - sourceRepo
+                            - installs
+                          additionalProperties: false
+                        - type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            emoji:
+                              type: string
+                            kind:
+                              type: string
+                              enum:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
+                              type: string
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: custom
+                          required:
+                            - id
+                            - name
+                            - description
+                            - kind
+                            - status
+                            - origin
+                          additionalProperties: false
+                    description: Skill objects matching the search query
                 required:
-                  - data
+                  - skills
                 additionalProperties: false
       parameters:
         - name: q