@vellumai/assistant 0.8.5 → 0.8.6

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.8.5
+  version: 0.8.6
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -460,8 +460,30 @@ paths:
                 properties:
                   apps:
                     type: array
-                    items: {}
-                    description: Array of app summary objects
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        description:
+                          type: string
+                        icon:
+                          type: string
+                        createdAt:
+                          type: number
+                        version:
+                          type: string
+                        contentId:
+                          type: string
+                      required:
+                        - id
+                        - name
+                        - createdAt
+                        - version
+                        - contentId
+                      additionalProperties: false
                 required:
                   - apps
                 additionalProperties: false
@@ -540,6 +562,18 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result: {}
+                required:
+                  - success
+                  - result
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -560,6 +594,18 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result: {}
+                required:
+                  - success
+                  - result
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -597,6 +643,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
+                  - success
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -613,6 +669,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  appId:
+                    type: string
+                  diff:
+                    type: string
+                required:
+                  - appId
+                  - diff
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -648,7 +717,20 @@ paths:
                     type: string
                   versions:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        commitHash:
+                          type: string
+                        message:
+                          type: string
+                        timestamp:
+                          type: number
+                      required:
+                        - commitHash
+                        - message
+                        - timestamp
+                      additionalProperties: false
                 required:
                   - appId
                   - versions
@@ -709,6 +791,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  appId:
+                    type: string
+                  preview:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - appId
+                  - preview
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -724,6 +821,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  appId:
+                    type: string
+                required:
+                  - success
+                  - appId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -819,6 +929,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
+                  - success
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -907,6 +1027,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                  appId:
+                    type: string
+                  name:
+                    type: string
+                required:
+                  - success
+                  - appId
+                  - name
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -936,9 +1073,61 @@ paths:
                 type: object
                 properties:
                   gallery:
-                    type: array
-                    items: {}
-                    description: Gallery app entries
+                    type: object
+                    properties:
+                      version:
+                        type: number
+                      updatedAt:
+                        type: string
+                      categories:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            icon:
+                              type: string
+                          required:
+                            - id
+                            - name
+                            - icon
+                          additionalProperties: false
+                      apps:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            icon:
+                              type: string
+                            category:
+                              type: string
+                            version:
+                              type: string
+                            featured:
+                              type: boolean
+                          required:
+                            - id
+                            - name
+                            - description
+                            - icon
+                            - category
+                            - version
+                          additionalProperties: false
+                    required:
+                      - version
+                      - updatedAt
+                      - categories
+                      - apps
+                    additionalProperties: false
                 required:
                   - gallery
                 additionalProperties: false
@@ -952,6 +1141,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                  appId:
+                    type: string
+                  name:
+                    type: string
+                required:
+                  - success
+                  - appId
+                  - name
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1034,6 +1240,55 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  manifest:
+                    type: object
+                    properties: {}
+                    additionalProperties: {}
+                  scanResult:
+                    type: object
+                    properties:
+                      passed:
+                        type: boolean
+                      blocked:
+                        type: array
+                        items:
+                          type: string
+                      warnings:
+                        type: array
+                        items:
+                          type: string
+                    required:
+                      - passed
+                      - blocked
+                      - warnings
+                    additionalProperties: false
+                  signatureResult:
+                    type: object
+                    properties:
+                      trustTier:
+                        type: string
+                      signerKeyId:
+                        type: string
+                      signerDisplayName:
+                        type: string
+                      signerAccount:
+                        type: string
+                    required:
+                      - trustTier
+                    additionalProperties: false
+                  bundleSizeBytes:
+                    type: number
+                required:
+                  - manifest
+                  - scanResult
+                  - signatureResult
+                  - bundleSizeBytes
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1090,27 +1345,62 @@ paths:
                 properties:
                   apps:
                     type: array
-                    items: {}
-                    description: Array of shared app objects
-                required:
-                  - apps
-                additionalProperties: false
-  /v1/apps/shared/{token}:
-    delete:
-      operationId: apps_shared_by_token_delete
-      summary: Delete shared app
-      description: Remove a shared app link.
-      tags:
-        - apps
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success:
+                    items:
+                      type: object
+                      properties:
+                        uuid:
+                          type: string
+                        name:
+                          type: string
+                        description:
+                          type: string
+                        icon:
+                          type: string
+                        preview:
+                          type: string
+                        entry:
+                          type: string
+                        trustTier:
+                          type: string
+                        signerDisplayName:
+                          type: string
+                        bundleSizeBytes:
+                          type: number
+                        installedAt:
+                          type: string
+                        version:
+                          type: string
+                        contentId:
+                          type: string
+                        updateAvailable:
+                          type: boolean
+                      required:
+                        - uuid
+                        - name
+                        - entry
+                        - trustTier
+                        - bundleSizeBytes
+                        - installedAt
+                      additionalProperties: false
+                required:
+                  - apps
+                additionalProperties: false
+  /v1/apps/shared/{token}:
+    delete:
+      operationId: apps_shared_by_token_delete
+      summary: Delete shared app
+      description: Remove a shared app link.
+      tags:
+        - apps
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
                     type: boolean
                 required:
                   - success
@@ -1181,6 +1471,22 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  signed:
+                    type: boolean
+                  signatureJson:
+                    type: object
+                    properties: {}
+                    additionalProperties: {}
+                  payload:
+                    type: string
+                  message:
+                    type: string
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1210,6 +1516,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                required:
+                  - message
+                additionalProperties: false
   /v1/attachments:
     delete:
       operationId: attachments_delete
@@ -1838,6 +2154,8 @@ paths:
               schema:
                 type: object
                 properties:
+                  accepted:
+                    type: boolean
                   leaseId:
                     type: string
                   reason:
@@ -1848,60 +2166,13 @@ paths:
                     type: number
                   deadlineAt:
                     type: number
-                  counts:
-                    type: object
-                    properties:
-                      heartbeat:
-                        type: number
-                      scheduler:
-                        type: number
-                      total:
-                        type: number
-                    required:
-                      - heartbeat
-                      - scheduler
-                      - total
-                    additionalProperties: false
-                  nextIntent:
-                    anyOf:
-                      - type: object
-                        properties:
-                          nextWakeAt:
-                            type: number
-                          actualNextDueAt:
-                            type: number
-                          reason:
-                            type: string
-                            enum:
-                              - heartbeat
-                              - schedule
-                              - mixed
-                          sourceGeneration:
-                            type: string
-                          computedAt:
-                            type: number
-                          sourcePayload:
-                            type: object
-                            propertyNames:
-                              type: string
-                            additionalProperties: {}
-                        required:
-                          - nextWakeAt
-                          - actualNextDueAt
-                          - reason
-                          - sourceGeneration
-                          - computedAt
-                          - sourcePayload
-                        additionalProperties: false
-                      - type: "null"
                 required:
+                  - accepted
                   - leaseId
                   - reason
                   - sourceGeneration
                   - startedAt
                   - deadlineAt
-                  - counts
-                  - nextIntent
                 additionalProperties: false
       requestBody:
         required: true
@@ -4679,6 +4950,233 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        title:
+                          type: string
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
+                        lastMessageAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        conversationType:
+                          type: string
+                          enum:
+                            - standard
+                            - background
+                            - scheduled
+                        source:
+                          type: string
+                        scheduleJobId:
+                          type: string
+                        channelBinding:
+                          type: object
+                          properties:
+                            sourceChannel:
+                              type: string
+                            externalChatId:
+                              type: string
+                            externalChatName:
+                              type: string
+                            externalThreadId:
+                              type: string
+                            externalUserId:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            displayName:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            username:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            slackThread:
+                              type: object
+                              properties:
+                                channelId:
+                                  type: string
+                                threadTs:
+                                  type: string
+                                link:
+                                  type: object
+                                  properties:
+                                    appUrl:
+                                      type: string
+                                    webUrl:
+                                      type: string
+                                  additionalProperties: false
+                              required:
+                                - channelId
+                                - threadTs
+                              additionalProperties: false
+                            slackChannel:
+                              type: object
+                              properties:
+                                channelId:
+                                  type: string
+                                name:
+                                  type: string
+                                link:
+                                  type: object
+                                  properties:
+                                    webUrl:
+                                      type: string
+                                  required:
+                                    - webUrl
+                                  additionalProperties: false
+                              required:
+                                - channelId
+                              additionalProperties: false
+                          required:
+                            - sourceChannel
+                            - externalChatId
+                            - externalUserId
+                            - displayName
+                            - username
+                          additionalProperties: false
+                        conversationOriginChannel:
+                          anyOf:
+                            - type: string
+                              enum:
+                                - telegram
+                                - phone
+                                - vellum
+                                - whatsapp
+                                - slack
+                                - email
+                                - platform
+                                - a2a
+                            - type: "null"
+                        assistantAttention:
+                          type: object
+                          properties:
+                            hasUnseenLatestAssistantMessage:
+                              type: boolean
+                            latestAssistantMessageAt:
+                              type: number
+                            lastSeenAssistantMessageAt:
+                              type: number
+                            lastSeenConfidence:
+                              type: string
+                              enum:
+                                - explicit
+                                - inferred
+                            lastSeenSignalType:
+                              type: string
+                              enum:
+                                - macos_notification_view
+                                - macos_conversation_opened
+                                - ios_conversation_opened
+                                - telegram_inbound_message
+                                - telegram_callback
+                                - slack_inbound_message
+                                - slack_callback
+                          required:
+                            - hasUnseenLatestAssistantMessage
+                          additionalProperties: false
+                        isPinned:
+                          type: boolean
+                          const: true
+                        displayOrder:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        forkParent:
+                          type: object
+                          properties:
+                            conversationId:
+                              type: string
+                            messageId:
+                              type: string
+                            title:
+                              type: string
+                          required:
+                            - conversationId
+                            - messageId
+                            - title
+                          additionalProperties: false
+                        archivedAt:
+                          type: number
+                        inferenceProfile:
+                          type: string
+                      required:
+                        - id
+                        - title
+                        - createdAt
+                        - updatedAt
+                        - lastMessageAt
+                        - conversationType
+                        - source
+                        - groupId
+                      additionalProperties: false
+                  nextOffset:
+                    type: number
+                  hasMore:
+                    type: boolean
+                  groups:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        sortPosition:
+                          type: number
+                        isSystemGroup:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - sortPosition
+                        - isSystemGroup
+                      additionalProperties: false
+                required:
+                  - conversations
+                  - nextOffset
+                  - hasMore
+                additionalProperties: false
+      parameters:
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Maximum number of conversations to return (default 50).
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Number of conversations to skip (default 0).
+        - name: conversationType
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - background
+          description: Filter by conversation type. Pass "background" to list only background/scheduled conversations.
     post:
       operationId: conversations_post
       summary: Create a conversation
@@ -4797,6 +5295,185 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -4813,6 +5490,185 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -4829,6 +5685,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  conversationId:
+                    type: string
+                required:
+                  - ok
+                  - conversationId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -4857,16 +5726,115 @@ paths:
                   conversationId:
                     type: string
                 required:
-                  - ok
-                  - cancelled
+                  - ok
+                  - cancelled
+                  - conversationId
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/conversations/{id}/compaction:
+    get:
+      operationId: conversations_by_id_compaction_get
+      summary: Get the compaction trail leading up to an LLM call
+      description:
+        Return the chronological list of compaction events that ran in this conversation in the open window between
+        the previous non-`compactionAgent` LLM call and the call identified by `callId`. Projected from
+        `llm_request_logs` rows where `call_site = "compactionAgent"`. When the selected call is the first real call in
+        the conversation, every preceding compaction is in scope. Drives the Inspector's Compaction tab.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversationId:
+                    type: string
+                  events:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        createdAt:
+                          type: number
+                        model:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        provider:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        inputTokens:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        outputTokens:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        durationMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        responsePreview:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        requestMessageCount:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        stopReason:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        estimatedCostUsd:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                      required:
+                        - id
+                        - createdAt
+                        - model
+                        - provider
+                        - inputTokens
+                        - outputTokens
+                        - durationMs
+                        - responsePreview
+                        - requestMessageCount
+                        - stopReason
+                        - estimatedCostUsd
+                      additionalProperties: false
+                required:
                   - conversationId
+                  - events
                 additionalProperties: false
+        "400":
+          description: Returned when the callId is missing or refers to a call in a different conversation.
+        "404":
+          description: Returned when the conversation or the referenced LLM call does not exist.
       parameters:
         - name: id
           in: path
           required: true
           schema:
             type: string
+        - name: callId
+          in: query
+          required: true
+          schema:
+            type: string
+          description: ID of the selected LLM call from the rail. Defines the chronological cutoff for the trail.
   /v1/conversations/{id}/inference-profile:
     put:
       operationId: conversations_by_id_inferenceprofile_put
@@ -4970,6 +5938,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -5090,6 +6068,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  conversationId:
+                    type: string
+                required:
+                  - ok
+                  - conversationId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -5455,6 +6446,185 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -5875,6 +7045,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -5884,8 +7064,22 @@ paths:
               properties:
                 updates:
                   type: array
-                  items: {}
-                  description: Array of { conversationId, displayOrder?, isPinned? } objects
+                  items:
+                    type: object
+                    properties:
+                      conversationId:
+                        type: string
+                      displayOrder:
+                        type: number
+                      isPinned:
+                        type: boolean
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                    required:
+                      - conversationId
+                    additionalProperties: false
               required:
                 - updates
               additionalProperties: false
@@ -5942,6 +7136,48 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                sourceChannel:
+                  type: string
+                signalType:
+                  type: string
+                confidence:
+                  type: string
+                  enum:
+                    - explicit
+                    - inferred
+                source:
+                  type: string
+                evidenceText:
+                  type: string
+                metadata:
+                  type: object
+                  propertyNames:
+                    type: string
+                  additionalProperties: {}
+                observedAt:
+                  type: number
+              required:
+                - conversationId
+              additionalProperties: false
   /v1/conversations/switch:
     post:
       operationId: conversations_switch_post
@@ -5995,6 +7231,28 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+              required:
+                - conversationId
+              additionalProperties: false
   /v1/conversations/wake:
     post:
       operationId: conversations_wake_post
@@ -7008,8 +8266,29 @@ paths:
                 properties:
                   documents:
                     type: array
-                    items: {}
-                    description: Document summary objects
+                    items:
+                      type: object
+                      properties:
+                        surfaceId:
+                          type: string
+                        conversationId:
+                          type: string
+                        title:
+                          type: string
+                        wordCount:
+                          type: number
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
+                      required:
+                        - surfaceId
+                        - conversationId
+                        - title
+                        - wordCount
+                        - createdAt
+                        - updatedAt
+                      additionalProperties: false
                 required:
                   - documents
                 additionalProperties: false
@@ -7934,6 +9213,33 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  groups:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        sortPosition:
+                          type: number
+                        isSystemGroup:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - sortPosition
+                        - isSystemGroup
+                      additionalProperties: false
+                required:
+                  - groups
+                additionalProperties: false
     post:
       operationId: groups_post
       summary: Create group
@@ -7943,6 +9249,25 @@ paths:
       responses:
         "201":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                  sortPosition:
+                    type: number
+                  isSystemGroup:
+                    type: boolean
+                required:
+                  - id
+                  - name
+                  - sortPosition
+                  - isSystemGroup
+                additionalProperties: false
         "400":
           description: Missing or invalid name, or sort_position ceiling reached
       requestBody:
@@ -7987,6 +9312,25 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                  sortPosition:
+                    type: number
+                  isSystemGroup:
+                    type: boolean
+                required:
+                  - id
+                  - name
+                  - sortPosition
+                  - isSystemGroup
+                additionalProperties: false
         "403":
           description: System group sort position cannot be changed
         "404":
@@ -8019,6 +9363,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
         "403":
           description: Cannot reorder system groups
       requestBody:
@@ -8986,51 +10340,242 @@ paths:
               properties:
                 status:
                   type: string
-                  enum:
-                    - new
-                    - seen
-                    - acted_on
-                    - dismissed
-              required:
-                - status
+                  enum:
+                    - new
+                    - seen
+                    - acted_on
+                    - dismissed
+              required:
+                - status
+              additionalProperties: false
+  /v1/home/feed/{id}/actions/{actionId}:
+    post:
+      operationId: home_feed_by_id_actions_by_actionId_post
+      summary: Trigger home feed action
+      description:
+        Create a new conversation pre-seeded with the action's prompt as the first user message. Returns the new
+        `conversationId`.
+      tags:
+        - home
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversationId:
+                    type: string
+                required:
+                  - conversationId
+                additionalProperties: false
+        "404":
+          description: Feed item or action not found
+        "500":
+          description: Failed to create conversation
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: actionId
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/home/feed/query:
+    post:
+      operationId: home_feed_query_post
+      summary: List home feed items with filters
+      description:
+        Return home feed items filtered by status, urgency, category, conversation, and date range. Defaults to
+        excluding dismissed items. Used by the assistant CLI to inspect what notifications have been surfaced to the
+        user.
+      tags:
+        - home
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        type:
+                          type: string
+                          const: notification
+                        priority:
+                          type: integer
+                          minimum: 0
+                          maximum: 100
+                        title:
+                          type: string
+                        summary:
+                          type: string
+                        timestamp:
+                          type: string
+                        status:
+                          default: new
+                          type: string
+                          enum:
+                            - new
+                            - seen
+                            - acted_on
+                            - dismissed
+                        expiresAt:
+                          type: string
+                        actions:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: string
+                              label:
+                                type: string
+                              prompt:
+                                type: string
+                            required:
+                              - id
+                              - label
+                              - prompt
+                            additionalProperties: false
+                        urgency:
+                          type: string
+                          enum:
+                            - low
+                            - medium
+                            - high
+                            - critical
+                        conversationId:
+                          type: string
+                        detailPanel:
+                          type: object
+                          properties:
+                            kind:
+                              type: string
+                              enum:
+                                - emailDraft
+                                - documentPreview
+                                - permissionChat
+                                - paymentAuth
+                                - toolPermission
+                                - updatesList
+                          required:
+                            - kind
+                          additionalProperties: false
+                        category:
+                          type: string
+                          enum:
+                            - security
+                            - scheduling
+                            - background
+                            - email
+                            - system
+                        noteworthy:
+                          type: boolean
+                        fromAssistant:
+                          type: boolean
+                        metadata:
+                          type: object
+                          propertyNames:
+                            type: string
+                          additionalProperties: {}
+                        createdAt:
+                          type: string
+                      required:
+                        - id
+                        - type
+                        - priority
+                        - summary
+                        - timestamp
+                        - status
+                        - createdAt
+                      additionalProperties: false
+                  total:
+                    type: integer
+                    minimum: 0
+                    maximum: 9007199254740991
+                  returned:
+                    type: integer
+                    minimum: 0
+                    maximum: 9007199254740991
+                  hasMore:
+                    type: boolean
+                  updatedAt:
+                    type: string
+                required:
+                  - items
+                  - total
+                  - returned
+                  - hasMore
+                  - updatedAt
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                includeDismissed:
+                  type: boolean
+                statuses:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - new
+                      - seen
+                      - acted_on
+                      - dismissed
+                before:
+                  type: string
+                after:
+                  type: string
+                urgencies:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - low
+                      - medium
+                      - high
+                      - critical
+                categories:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - security
+                      - scheduling
+                      - background
+                      - email
+                      - system
+                conversationId:
+                  type: string
+                fromAssistant:
+                  type: boolean
+                noteworthy:
+                  type: boolean
+                limit:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 200
+                offset:
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
               additionalProperties: false
-  /v1/home/feed/{id}/actions/{actionId}:
-    post:
-      operationId: home_feed_by_id_actions_by_actionId_post
-      summary: Trigger home feed action
-      description:
-        Create a new conversation pre-seeded with the action's prompt as the first user message. Returns the new
-        `conversationId`.
-      tags:
-        - home
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  conversationId:
-                    type: string
-                required:
-                  - conversationId
-                additionalProperties: false
-        "404":
-          description: Feed item or action not found
-        "500":
-          description: Failed to create conversation
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: actionId
-          in: path
-          required: true
-          schema:
-            type: string
   /v1/home/state:
     get:
       operationId: home_state_get
@@ -9603,10 +11148,8 @@ paths:
   /v1/identity/intro:
     get:
       operationId: identity_intro_get
-      summary: Get identity intro text
-      description:
-        Returns a deterministic greeting derived from the assistant name in IDENTITY.md, falling back to
-        LLM-generated cache.
+      summary: Get identity greetings
+      description: Returns an array of greetings sourced from SOUL.md, LLM cache, or static fallbacks.
       tags:
         - identity
       responses:
@@ -9617,9 +11160,14 @@ paths:
               schema:
                 type: object
                 properties:
+                  greetings:
+                    type: array
+                    items:
+                      type: string
                   text:
                     type: string
                 required:
+                  - greetings
                   - text
                 additionalProperties: false
   /v1/image-generation/generate:
@@ -9782,11 +11330,6 @@ paths:
                                 - type
                                 - credential
                               additionalProperties: false
-                        status:
-                          type: string
-                          enum:
-                            - active
-                            - disabled
                         label:
                           anyOf:
                             - type: string
@@ -9827,7 +11370,6 @@ paths:
                         - name
                         - provider
                         - auth
-                        - status
                         - label
                         - baseUrl
                         - models
@@ -9929,11 +11471,6 @@ paths:
                           - type
                           - credential
                         additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
                   label:
                     anyOf:
                       - type: string
@@ -9974,7 +11511,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -10064,11 +11600,6 @@ paths:
                 label:
                   type: string
                   minLength: 1
-                status:
-                  type: string
-                  enum:
-                    - active
-                    - disabled
                 base_url:
                   anyOf:
                     - type: string
@@ -10213,11 +11744,6 @@ paths:
                           - type
                           - credential
                         additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
                   label:
                     anyOf:
                       - type: string
@@ -10258,7 +11784,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -10279,8 +11804,7 @@ paths:
       summary: Update a provider connection
       description:
         Update an existing connection. Cannot rename or change the provider. For managed connections
-        (anthropic-managed, openai-managed, gemini-managed) the auth is locked to platform; label and status remain
-        editable.
+        (anthropic-managed, openai-managed, gemini-managed) the auth is locked to platform; label remains editable.
       tags:
         - inference
       responses:
@@ -10359,11 +11883,6 @@ paths:
                           - type
                           - credential
                         additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
                   label:
                     anyOf:
                       - type: string
@@ -10404,7 +11923,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -10483,11 +12001,6 @@ paths:
                         - type
                         - credential
                       additionalProperties: false
-                status:
-                  type: string
-                  enum:
-                    - active
-                    - disabled
                 label:
                   anyOf:
                     - type: string
@@ -10883,6 +12396,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
     get:
       operationId: integrations_vercel_config_get
       summary: Get Vercel config
@@ -10892,6 +12420,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
     post:
       operationId: integrations_vercel_config_post
       summary: Set or delete Vercel config
@@ -10901,6 +12444,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                action:
+                  type: string
+                  enum:
+                    - get
+                    - set
+                    - delete
+                apiToken:
+                  type: string
+              additionalProperties: false
   /v1/internal/mcp/add:
     post:
       operationId: internal_mcp_add_post
@@ -11707,6 +13281,79 @@ paths:
               type: object
               properties: {}
               additionalProperties: false
+  /v1/memory/v3/seed-edges:
+    post:
+      operationId: memory_v3_seededges_post
+      summary: Seed the learned co-retrieval edge graph from v2 router history
+      description:
+        Builds an NPMI-scored co-retrieval graph from the v2 router's per-turn selections
+        (memory_v2_activation_logs, status='injected') and persists it into memory_v3_auto_edges, warm-starting the
+        learned edge graph that the v3 edge-expansion lane merges with curated edges when
+        memory.v3.edges.learnedAdjacencyThreshold > 0. NPMI plus a min co-occurrence floor and an always-on frequency
+        ceiling keep the neighborhoods associative rather than base-rate noise. Idempotent (upserts to a flat seed
+        weight). Runs no LLM; the only write among the v3 routes.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                minCount:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                topK:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                maxNeighborFreqRatio:
+                  type: number
+                  exclusiveMinimum: 0
+                  maximum: 1
+                seedWeight:
+                  type: number
+                  exclusiveMinimum: 0
+              additionalProperties: false
+  /v1/memory/v3/shadow-diff:
+    post:
+      operationId: memory_v3_shadowdiff_post
+      summary: Diff v3 shadow selections against live v2 router selections (read-only)
+      description:
+        Compares the v3 shadow-mode selections against the live v2 router selections turn-for-turn, from the memory
+        activation log. Pairs each v3_shadow row with the nearest v2 router row in the same conversation (by timestamp,
+        within a tolerance — the turn columns use different counters), then reports per-turn and aggregate overlap, what
+        v3 surfaced that v2 did not, and what v2 had that v3 dropped, broken down by v3 provenance lane. The v2
+        comparand is the router's fresh per-turn pick (status='injected'), not its accumulated in-context set. Requires
+        that v3 shadow mode has been running so v3_shadow rows exist; the route runs no LLM and writes nothing.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                sinceDays:
+                  type: number
+                  exclusiveMinimum: 0
+                toleranceSec:
+                  type: number
+                  exclusiveMinimum: 0
+                limit:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+              additionalProperties: false
   /v1/memory/v3/simulate:
     post:
       operationId: memory_v3_simulate_post
@@ -11740,6 +13387,7 @@ paths:
                   exclusiveMinimum: 0
                   maximum: 9007199254740991
                 lanes:
+                  minItems: 1
                   type: array
                   items:
                     type: string
@@ -12424,6 +14072,92 @@ paths:
               required:
                 - deliveryId
               additionalProperties: false
+  /v1/notifications/edit:
+    post:
+      operationId: notifications_edit_post
+      summary: Edit an already-sent notification
+      description:
+        Patch the home-feed entry for a notification and, where supported (Slack today), update the delivered
+        message in place.
+      tags:
+        - notifications
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  feedItem:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties: {}
+                  channels:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        channel:
+                          type: string
+                        deliveryId:
+                          type: string
+                        outcome:
+                          type: string
+                          enum:
+                            - updated
+                            - unsupported
+                            - skipped
+                            - failed
+                        reason:
+                          type: string
+                      required:
+                        - channel
+                        - deliveryId
+                        - outcome
+                      additionalProperties: false
+                required:
+                  - ok
+                  - feedItem
+                  - channels
+                additionalProperties: false
+        "404":
+          description: No notification found for the supplied id
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                id:
+                  type: string
+                  minLength: 1
+                  description: Feed item id (notif:<uuid>) or bare uuid
+                title:
+                  type: string
+                body:
+                  type: string
+                urgency:
+                  type: string
+                  enum:
+                    - low
+                    - medium
+                    - high
+                    - critical
+                status:
+                  type: string
+                  enum:
+                    - new
+                    - seen
+                    - acted_on
+                    - dismissed
+              required:
+                - id
+              additionalProperties: false
   /v1/notifications/emit:
     post:
       operationId: notifications_emit_post