@vellumai/assistant 0.5.16 → 0.6.1

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
@@ -2521,6 +2521,22 @@ paths:
           required: true
           schema:
             type: string
+  /v1/conversations/{id}/analyze:
+    post:
+      operationId: conversations_by_id_analyze_post
+      summary: Analyze a conversation
+      description: Create a new conversation with a structured self-assessment of an existing conversation.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/conversations/{id}/cancel:
     post:
       operationId: conversations_by_id_cancel_post
@@ -3103,7 +3119,7 @@ paths:
     post:
       operationId: export_post
       summary: Export logs and audit data
-      description: Export audit records, assistant logs, workspace contents, and config as a tar.gz archive.
+      description: Export audit records, assistant logs, and config as a tar.gz archive.
       tags:
         - export
       responses:
@@ -3131,6 +3147,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
@@ -3261,6 +3386,81 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  profiler:
+                    type: object
+                    properties:
+                      enabled:
+                        type: boolean
+                      mode:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      runId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      runDir:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      totalBytes:
+                        type: number
+                      artifactCount:
+                        type: number
+                      budget:
+                        anyOf:
+                          - type: object
+                            properties:
+                              maxBytes:
+                                type: number
+                              remainingBytes:
+                                type: number
+                              minFreeMb:
+                                type: number
+                              freeMb:
+                                type: number
+                              overBudget:
+                                type: boolean
+                            required:
+                              - maxBytes
+                              - remainingBytes
+                              - minFreeMb
+                              - freeMb
+                              - overBudget
+                            additionalProperties: false
+                          - type: "null"
+                      lastCompletedRun:
+                        anyOf:
+                          - type: object
+                            properties:
+                              runId:
+                                type: string
+                              totalBytes:
+                                type: number
+                              artifactCount:
+                                type: number
+                              hasSummaries:
+                                type: boolean
+                              completedAt:
+                                type: string
+                            required:
+                              - runId
+                              - totalBytes
+                              - artifactCount
+                              - hasSummaries
+                              - completedAt
+                            additionalProperties: false
+                          - type: "null"
+                    required:
+                      - enabled
+                      - mode
+                      - runId
+                      - runDir
+                      - totalBytes
+                      - artifactCount
+                      - budget
+                      - lastCompletedRun
+                    additionalProperties: false
                 required:
                   - status
                   - timestamp
@@ -3307,6 +3507,81 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  profiler:
+                    type: object
+                    properties:
+                      enabled:
+                        type: boolean
+                      mode:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      runId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      runDir:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      totalBytes:
+                        type: number
+                      artifactCount:
+                        type: number
+                      budget:
+                        anyOf:
+                          - type: object
+                            properties:
+                              maxBytes:
+                                type: number
+                              remainingBytes:
+                                type: number
+                              minFreeMb:
+                                type: number
+                              freeMb:
+                                type: number
+                              overBudget:
+                                type: boolean
+                            required:
+                              - maxBytes
+                              - remainingBytes
+                              - minFreeMb
+                              - freeMb
+                              - overBudget
+                            additionalProperties: false
+                          - type: "null"
+                      lastCompletedRun:
+                        anyOf:
+                          - type: object
+                            properties:
+                              runId:
+                                type: string
+                              totalBytes:
+                                type: number
+                              artifactCount:
+                                type: number
+                              hasSummaries:
+                                type: boolean
+                              completedAt:
+                                type: string
+                            required:
+                              - runId
+                              - totalBytes
+                              - artifactCount
+                              - hasSummaries
+                              - completedAt
+                            additionalProperties: false
+                          - type: "null"
+                    required:
+                      - enabled
+                      - mode
+                      - runId
+                      - runDir
+                      - totalBytes
+                      - artifactCount
+                      - budget
+                      - lastCompletedRun
+                    additionalProperties: false
                 required:
                   - status
                   - timestamp
@@ -3968,11 +4243,41 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/llm-request-logs/{id}/payload:
+    get:
+      operationId: llmrequestlogs_by_id_payload_get
+      summary: Get raw payload for a single LLM request log
+      description: Return the full request and response payloads for a specific log entry.
+      tags:
+        - messages
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  requestPayload: {}
+                  responsePayload: {}
+                required:
+                  - id
+                  - requestPayload
+                  - responsePayload
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/logs/export:
     post:
       operationId: logs_export_post
       summary: Export logs and audit data (alias)
-      description: Alias for /v1/export. Export audit records, assistant logs, workspace contents, and config as a tar.gz archive.
+      description: Alias for /v1/export. Export audit records, assistant logs, and config as a tar.gz archive.
       tags:
         - export
       responses:
@@ -4071,7 +4376,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 +4404,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 +4416,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 +4447,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 +4462,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 +4475,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 +4517,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:
@@ -4287,7 +4579,6 @@ paths:
                 slashCommand:
                   type: string
               required:
-                - conversationKey
                 - content
               additionalProperties: false
   /v1/messages/{id}/content:
@@ -4818,6 +5109,237 @@ paths:
           schema:
             type: string
           description: Conversation ID
+  /v1/permission-mode:
+    get:
+      operationId: permissionmode_get
+      summary: Get permission mode
+      description: Return the current two-axis permission mode (askBeforeActing, hostAccess).
+      tags:
+        - settings
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  askBeforeActing:
+                    type: boolean
+                  hostAccess:
+                    type: boolean
+                required:
+                  - askBeforeActing
+                  - hostAccess
+                additionalProperties: false
+    put:
+      operationId: permissionmode_put
+      summary: Update permission mode
+      description: Update the two-axis permission mode. Requires the permission-controls-v2 feature flag.
+      tags:
+        - settings
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  askBeforeActing:
+                    type: boolean
+                  hostAccess:
+                    type: boolean
+                required:
+                  - askBeforeActing
+                  - hostAccess
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                askBeforeActing:
+                  type: boolean
+                hostAccess:
+                  type: boolean
+              additionalProperties: false
+  /v1/profiler/runs:
+    get:
+      operationId: profiler_runs_get
+      summary: List profiler runs
+      description: Enumerate all profiler run directories with manifest metadata, sorted newest-first.
+      tags:
+        - profiler
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  runs:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        runId:
+                          type: string
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - completed
+                        createdAt:
+                          type: string
+                        updatedAt:
+                          type: string
+                        totalBytes:
+                          type: number
+                        completedAt:
+                          type: string
+                      required:
+                        - runId
+                        - status
+                        - createdAt
+                        - updatedAt
+                        - totalBytes
+                      additionalProperties: false
+                  totalRuns:
+                    type: number
+                  activeRunId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - runs
+                  - totalRuns
+                  - activeRunId
+                additionalProperties: false
+  /v1/profiler/runs/{runId}:
+    delete:
+      operationId: profiler_runs_by_runId_delete
+      summary: Delete profiler run
+      description: Delete a completed profiler run and recalculate disk-budget state. Rejects deletion of the currently active run.
+      tags:
+        - profiler
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  deleted:
+                    type: boolean
+                  runId:
+                    type: string
+                  remainingRuns:
+                    type: number
+                  activeRunOverBudget:
+                    type: boolean
+                required:
+                  - deleted
+                  - runId
+                  - remainingRuns
+                  - activeRunOverBudget
+                additionalProperties: false
+      parameters:
+        - name: runId
+          in: path
+          required: true
+          schema:
+            type: string
+    get:
+      operationId: profiler_runs_by_runId_get
+      summary: Get profiler run detail
+      description: Return manifest metadata, Bun-generated markdown summary, and current retention state for a single profiler run.
+      tags:
+        - profiler
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  runId:
+                    type: string
+                  status:
+                    type: string
+                    enum:
+                      - active
+                      - completed
+                  createdAt:
+                    type: string
+                  updatedAt:
+                    type: string
+                  totalBytes:
+                    type: number
+                  completedAt:
+                    type: string
+                  summary:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  isActive:
+                    type: boolean
+                  budget:
+                    type: object
+                    properties:
+                      maxBytes:
+                        type: number
+                      totalBytesAllRuns:
+                        type: number
+                      remainingBytes:
+                        type: number
+                      overBudget:
+                        type: boolean
+                    required:
+                      - maxBytes
+                      - totalBytesAllRuns
+                      - remainingBytes
+                      - overBudget
+                    additionalProperties: false
+                required:
+                  - runId
+                  - status
+                  - createdAt
+                  - updatedAt
+                  - totalBytes
+                  - summary
+                  - isActive
+                  - budget
+                additionalProperties: false
+      parameters:
+        - name: runId
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/profiler/runs/{runId}/export:
+    post:
+      operationId: profiler_runs_by_runId_export_post
+      summary: Export profiler run
+      description:
+        Package a single profiler run directory as a tar.gz bundle, subject to the same archive size limits used by
+        runtime log exports.
+      tags:
+        - profiler
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: runId
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/recordings/pause:
     post:
       operationId: recordings_pause_post
@@ -5128,6 +5650,8 @@ paths:
                   description: single_channel, multi_channel, or all_channels
                 quiet:
                   type: boolean
+                reuseConversation:
+                  type: boolean
               required:
                 - name
                 - expression
@@ -5136,6 +5660,7 @@ paths:
                 - mode
                 - routingIntent
                 - quiet
+                - reuseConversation
               additionalProperties: false
   /v1/schedules/{id}/cancel:
     post:
@@ -5601,68 +6126,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:
-                                - first-party
-                                - third-party
-                                - local
-                            provider:
+                                - bundled
+                                - installed
+                                - catalog
+                            status:
                               type: string
-                            originId:
+                              enum:
+                                - enabled
+                                - disabled
+                                - available
+                            origin:
+                              type: string
+                              const: clawhub
+                            slug:
                               type: string
-                            sourceUrl:
+                            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
-                      required:
-                        - id
-                        - name
-                        - description
-                        - source
-                        - state
-                        - installStatus
-                        - updateAvailable
-                        - provenance
-                      additionalProperties: false
                     description: Skill objects
                 required:
                   - skills
@@ -5735,12 +6357,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 +6836,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 +6863,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
@@ -7279,3 +8288,109 @@ paths:
               required:
                 - path
               additionalProperties: false
+  /v1/x/{path}:
+    delete:
+      operationId: x_by_path_delete
+      summary: User-defined DELETE route
+      description: Dispatches DELETE requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    get:
+      operationId: x_by_path_get
+      summary: User-defined GET route
+      description: Dispatches GET requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    head:
+      operationId: x_by_path_head
+      summary: User-defined HEAD route
+      description: Dispatches HEAD requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    options:
+      operationId: x_by_path_options
+      summary: User-defined OPTIONS route
+      description: Dispatches OPTIONS requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    patch:
+      operationId: x_by_path_patch
+      summary: User-defined PATCH route
+      description: Dispatches PATCH requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    post:
+      operationId: x_by_path_post
+      summary: User-defined POST route
+      description: Dispatches POST requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+    put:
+      operationId: x_by_path_put
+      summary: User-defined PUT route
+      description: Dispatches PUT requests to user-defined handler files in the workspace routes directory.
+      tags:
+        - user-routes
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string