@vellumai/assistant 0.8.6 → 0.8.7

package/openapi.yaml

@@ -1,9 +1,9 @@
 # Auto-generated by scripts/generate-openapi.ts — DO NOT EDIT
 # Regenerate: cd assistant && bun run generate:openapi
-openapi: 3.0.0
+openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.8.6
+  version: 0.8.7
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -1947,6 +1947,41 @@ paths:
           schema:
             type: string
           description: '"path" or "base64"'
+  /v1/avatar/image:
+    post:
+      operationId: avatar_image_post
+      summary: Upload avatar image
+      description: Upload a base64-encoded image as the avatar; writes the PNG and clears character traits atomically.
+      tags:
+        - avatar
+      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:
+                content:
+                  type: string
+                encoding:
+                  type: string
+                  const: base64
+              required:
+                - content
+              additionalProperties: false
   /v1/avatar/notify-updated:
     post:
       operationId: avatar_notifyupdated_post
@@ -2060,6 +2095,70 @@ paths:
               required:
                 - imagePath
               additionalProperties: false
+  /v1/avatar/state:
+    get:
+      operationId: avatar_state_get
+      summary: Get avatar state
+      description: Return the authoritative avatar render mode (character, image, or none).
+      tags:
+        - avatar
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  kind:
+                    type: string
+                    enum:
+                      - character
+                      - image
+                      - none
+                  traits:
+                    anyOf:
+                      - type: object
+                        properties:
+                          bodyShape:
+                            type: string
+                          eyeStyle:
+                            type: string
+                          color:
+                            type: string
+                        required:
+                          - bodyShape
+                          - eyeStyle
+                          - color
+                        additionalProperties: false
+                      - type: "null"
+                  source:
+                    anyOf:
+                      - type: string
+                        enum:
+                          - builder
+                          - upload
+                          - ai
+                      - type: "null"
+                  image:
+                    anyOf:
+                      - type: object
+                        properties:
+                          updatedAt:
+                            type: string
+                          etag:
+                            type: string
+                        required:
+                          - updatedAt
+                          - etag
+                        additionalProperties: false
+                      - type: "null"
+                required:
+                  - kind
+                  - traits
+                  - source
+                  - image
+                additionalProperties: false
   /v1/background-tools:
     get:
       operationId: backgroundtools_get
@@ -3790,7 +3889,69 @@ paths:
                     type: boolean
                   snapshots:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        channel:
+                          type: string
+                        ready:
+                          type: boolean
+                        setupStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        checkedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        stale:
+                          type: boolean
+                        reasons:
+                          type: array
+                          items:
+                            type: string
+                        localChecks:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              name:
+                                type: string
+                              passed:
+                                type: boolean
+                              message:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                            required:
+                              - name
+                              - passed
+                            additionalProperties: false
+                        remoteChecks:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              name:
+                                type: string
+                              passed:
+                                type: boolean
+                              message:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                            required:
+                              - name
+                              - passed
+                            additionalProperties: false
+                        channelHandle:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - channel
+                        - ready
+                      additionalProperties: false
                     description: Channel readiness snapshots
                 required:
                   - success
@@ -3828,7 +3989,69 @@ paths:
                     type: boolean
                   snapshots:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        channel:
+                          type: string
+                        ready:
+                          type: boolean
+                        setupStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        checkedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        stale:
+                          type: boolean
+                        reasons:
+                          type: array
+                          items:
+                            type: string
+                        localChecks:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              name:
+                                type: string
+                              passed:
+                                type: boolean
+                              message:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                            required:
+                              - name
+                              - passed
+                            additionalProperties: false
+                        remoteChecks:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              name:
+                                type: string
+                              passed:
+                                type: boolean
+                              message:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                            required:
+                              - name
+                              - passed
+                            additionalProperties: false
+                        channelHandle:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - channel
+                        - ready
+                      additionalProperties: false
                     description: Refreshed readiness snapshots
                 required:
                   - success
@@ -4002,6 +4225,49 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  domains:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        displayName:
+                          type: string
+                      required:
+                        - id
+                        - displayName
+                      additionalProperties: false
+                  callSites:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        displayName:
+                          type: string
+                        description:
+                          type: string
+                        domain:
+                          type: string
+                        defaultProfile:
+                          type: string
+                      required:
+                        - id
+                        - displayName
+                        - description
+                        - domain
+                      additionalProperties: false
+                required:
+                  - domains
+                  - callSites
+                additionalProperties: false
   /v1/config/llm/profiles:
     get:
       operationId: config_llm_profiles_get
@@ -4015,6 +4281,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  profiles:
+                    type: array
+                    items:
+                      type: string
+                  activeProfile:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - profiles
+                  - activeProfile
+                additionalProperties: false
   /v1/config/llm/profiles/{name}:
     put:
       operationId: config_llm_profiles_by_name_put
@@ -4326,63 +4609,245 @@ paths:
                   ok:
                     type: boolean
                   contact:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
                     description: Updated contact (if applicable)
-                required:
-                  - ok
-                  - contact
-                additionalProperties: false
-      parameters:
-        - name: contactChannelId
-          in: path
-          required: true
-          schema:
-            type: string
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                status:
-                  type: string
-                  description: Channel status
-                policy:
-                  type: string
-                  description: Channel policy
-                reason:
-                  type: string
-                  description: Reason for the change
-              required:
-                - status
-                - policy
-                - reason
-              additionalProperties: false
-  /v1/contacts:
-    get:
-      operationId: contacts_get
-      summary: List contacts
-      description: Return all contacts, optionally filtered by type or channel status.
-      tags:
-        - contacts
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                  contacts:
-                    type: array
-                    items: {}
-                    description: Contact objects with channels and metadata
-                required:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      displayName:
+                        type: string
+                      role:
+                        type: string
+                      notes:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      contactType:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      lastInteraction:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      interactionCount:
+                        type: number
+                      channels:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            contactId:
+                              type: string
+                            type:
+                              type: string
+                            address:
+                              type: string
+                            isPrimary:
+                              type: boolean
+                            externalUserId:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            status:
+                              type: string
+                            policy:
+                              type: string
+                            verifiedAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            verifiedVia:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            lastSeenAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            interactionCount:
+                              type: number
+                            lastInteraction:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            revokedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            blockedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                          required:
+                            - id
+                            - contactId
+                            - type
+                            - address
+                            - isPrimary
+                            - externalUserId
+                            - status
+                            - policy
+                            - verifiedAt
+                            - verifiedVia
+                            - lastSeenAt
+                            - interactionCount
+                            - lastInteraction
+                            - revokedReason
+                            - blockedReason
+                          additionalProperties: false
+                    required:
+                      - id
+                      - displayName
+                      - role
+                      - interactionCount
+                      - channels
+                    additionalProperties: false
+                required:
+                  - ok
+                additionalProperties: false
+      parameters:
+        - name: contactChannelId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                status:
+                  description: Channel status
+                  type: string
+                policy:
+                  description: Channel policy
+                  type: string
+                reason:
+                  description: Reason for the change
+                  type: string
+              additionalProperties: false
+  /v1/contacts:
+    get:
+      operationId: contacts_get
+      summary: List contacts
+      description: Return all contacts, optionally filtered by type or channel status.
+      tags:
+        - contacts
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  contacts:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        displayName:
+                          type: string
+                        role:
+                          type: string
+                        notes:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        contactType:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        lastInteraction:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        interactionCount:
+                          type: number
+                        channels:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: string
+                              contactId:
+                                type: string
+                              type:
+                                type: string
+                              address:
+                                type: string
+                              isPrimary:
+                                type: boolean
+                              externalUserId:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              status:
+                                type: string
+                              policy:
+                                type: string
+                              verifiedAt:
+                                anyOf:
+                                  - type: number
+                                  - type: "null"
+                              verifiedVia:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              lastSeenAt:
+                                anyOf:
+                                  - type: number
+                                  - type: "null"
+                              interactionCount:
+                                type: number
+                              lastInteraction:
+                                anyOf:
+                                  - type: number
+                                  - type: "null"
+                              revokedReason:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              blockedReason:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                            required:
+                              - id
+                              - contactId
+                              - type
+                              - address
+                              - isPrimary
+                              - externalUserId
+                              - status
+                              - policy
+                              - verifiedAt
+                              - verifiedVia
+                              - lastSeenAt
+                              - interactionCount
+                              - lastInteraction
+                              - revokedReason
+                              - blockedReason
+                            additionalProperties: false
+                      required:
+                        - id
+                        - displayName
+                        - role
+                        - interactionCount
+                        - channels
+                      additionalProperties: false
+                    description: Contact objects with channels and metadata
+                required:
                   - ok
                   - contacts
                 additionalProperties: false
@@ -4442,18 +4907,122 @@ paths:
                     type: boolean
                   contact:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
-                    description: Contact details
+                    properties:
+                      id:
+                        type: string
+                      displayName:
+                        type: string
+                      role:
+                        type: string
+                      notes:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      contactType:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      lastInteraction:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      interactionCount:
+                        type: number
+                      channels:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            contactId:
+                              type: string
+                            type:
+                              type: string
+                            address:
+                              type: string
+                            isPrimary:
+                              type: boolean
+                            externalUserId:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            status:
+                              type: string
+                            policy:
+                              type: string
+                            verifiedAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            verifiedVia:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            lastSeenAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            interactionCount:
+                              type: number
+                            lastInteraction:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            revokedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            blockedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                          required:
+                            - id
+                            - contactId
+                            - type
+                            - address
+                            - isPrimary
+                            - externalUserId
+                            - status
+                            - policy
+                            - verifiedAt
+                            - verifiedVia
+                            - lastSeenAt
+                            - interactionCount
+                            - lastInteraction
+                            - revokedReason
+                            - blockedReason
+                          additionalProperties: false
+                    required:
+                      - id
+                      - displayName
+                      - role
+                      - interactionCount
+                      - channels
+                    additionalProperties: false
                   assistantMetadata:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
                     description: Assistant-side metadata
+                    type: object
+                    properties:
+                      contactId:
+                        type: string
+                      species:
+                        type: string
+                      metadata:
+                        anyOf:
+                          - type: object
+                            properties: {}
+                            additionalProperties: {}
+                          - type: "null"
+                    required:
+                      - contactId
+                      - species
+                      - metadata
+                    additionalProperties: false
                 required:
                   - ok
                   - contact
-                  - assistantMetadata
                 additionalProperties: false
       parameters:
         - name: id
@@ -4705,45 +5274,137 @@ paths:
                     type: boolean
                   contact:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
-                    description: Merged contact
-                required:
-                  - ok
-                  - contact
-                additionalProperties: false
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                keepId:
-                  type: string
-                  description: ID of the contact to keep
-                mergeId:
-                  type: string
-                  description: ID of the contact to merge into the kept one
-              required:
-                - keepId
-                - mergeId
-              additionalProperties: false
-  /v1/contacts/prompt:
-    post:
-      operationId: contacts_prompt_post
-      summary: Prompt user to register a contact channel
-      description:
-        Broadcasts a contact_request to connected clients, waits for the user to submit an address via the gateway.
-        The gateway owns the contact write and notifies the daemon via resolve_contact_prompt IPC.
-      tags:
-        - contacts
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
+                    properties:
+                      id:
+                        type: string
+                      displayName:
+                        type: string
+                      role:
+                        type: string
+                      notes:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      contactType:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      lastInteraction:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      interactionCount:
+                        type: number
+                      channels:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            contactId:
+                              type: string
+                            type:
+                              type: string
+                            address:
+                              type: string
+                            isPrimary:
+                              type: boolean
+                            externalUserId:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            status:
+                              type: string
+                            policy:
+                              type: string
+                            verifiedAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            verifiedVia:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            lastSeenAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            interactionCount:
+                              type: number
+                            lastInteraction:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            revokedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            blockedReason:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                          required:
+                            - id
+                            - contactId
+                            - type
+                            - address
+                            - isPrimary
+                            - externalUserId
+                            - status
+                            - policy
+                            - verifiedAt
+                            - verifiedVia
+                            - lastSeenAt
+                            - interactionCount
+                            - lastInteraction
+                            - revokedReason
+                            - blockedReason
+                          additionalProperties: false
+                    required:
+                      - id
+                      - displayName
+                      - role
+                      - interactionCount
+                      - channels
+                    additionalProperties: false
+                    description: Merged contact
+                required:
+                  - ok
+                  - contact
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                keepId:
+                  type: string
+                  description: ID of the contact to keep
+                mergeId:
+                  type: string
+                  description: ID of the contact to merge into the kept one
+              required:
+                - keepId
+                - mergeId
+              additionalProperties: false
+  /v1/contacts/prompt:
+    post:
+      operationId: contacts_prompt_post
+      summary: Prompt user to register a contact channel
+      description:
+        Broadcasts a contact_request to connected clients, waits for the user to submit an address via the gateway.
+        The gateway owns the contact write and notifies the daemon via resolve_contact_prompt IPC.
+      tags:
+        - contacts
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
                 type: object
                 properties:
                   ok:
@@ -4805,8 +5466,100 @@ paths:
                 type: array
                 items:
                   type: object
-                  properties: {}
-                  additionalProperties: {}
+                  properties:
+                    id:
+                      type: string
+                    displayName:
+                      type: string
+                    role:
+                      type: string
+                    notes:
+                      anyOf:
+                        - type: string
+                        - type: "null"
+                    contactType:
+                      anyOf:
+                        - type: string
+                        - type: "null"
+                    lastInteraction:
+                      anyOf:
+                        - type: number
+                        - type: "null"
+                    interactionCount:
+                      type: number
+                    channels:
+                      type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: string
+                          contactId:
+                            type: string
+                          type:
+                            type: string
+                          address:
+                            type: string
+                          isPrimary:
+                            type: boolean
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          status:
+                            type: string
+                          policy:
+                            type: string
+                          verifiedAt:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          verifiedVia:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          lastSeenAt:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          interactionCount:
+                            type: number
+                          lastInteraction:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          revokedReason:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          blockedReason:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                        required:
+                          - id
+                          - contactId
+                          - type
+                          - address
+                          - isPrimary
+                          - externalUserId
+                          - status
+                          - policy
+                          - verifiedAt
+                          - verifiedVia
+                          - lastSeenAt
+                          - interactionCount
+                          - lastInteraction
+                          - revokedReason
+                          - blockedReason
+                        additionalProperties: false
+                  required:
+                    - id
+                    - displayName
+                    - role
+                    - interactionCount
+                    - channels
+                  additionalProperties: false
       requestBody:
         required: true
         content:
@@ -4861,7 +5614,30 @@ paths:
                 properties:
                   starters:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        label:
+                          type: string
+                        prompt:
+                          type: string
+                        category:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        batch:
+                          type: integer
+                          minimum: -9007199254740991
+                          maximum: 9007199254740991
+                      required:
+                        - id
+                        - label
+                        - prompt
+                        - category
+                        - batch
+                      additionalProperties: false
                     description: Ordered list of starter chips
                   total:
                     type: integer
@@ -5118,6 +5894,8 @@ paths:
                           type: number
                         inferenceProfile:
                           type: string
+                        isProcessing:
+                          type: boolean
                       required:
                         - id
                         - title
@@ -5127,6 +5905,7 @@ paths:
                         - conversationType
                         - source
                         - groupId
+                        - isProcessing
                       additionalProperties: false
                   nextOffset:
                     type: number
@@ -5176,7 +5955,22 @@ paths:
             type: string
             enum:
               - background
-          description: Filter by conversation type. Pass "background" to list only background/scheduled conversations.
+              - scheduled
+          description:
+            Filter by conversation type. Pass "background" to list background and scheduled conversations together (the
+            back-compat umbrella), or "scheduled" to list only scheduled conversations.
+        - name: archiveStatus
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - active
+              - archived
+              - all
+          description:
+            Filter by archive state. Defaults to "active" (non-archived rows only). Pass "archived" to list only
+            archived rows (for the Archive page) or "all" to include both.
     post:
       operationId: conversations_post
       summary: Create a conversation
@@ -5461,6 +6255,8 @@ paths:
                         type: number
                       inferenceProfile:
                         type: string
+                      isProcessing:
+                        type: boolean
                     required:
                       - id
                       - title
@@ -5470,6 +6266,7 @@ paths:
                       - conversationType
                       - source
                       - groupId
+                      - isProcessing
                     additionalProperties: false
                 required:
                   - conversation
@@ -5656,6 +6453,8 @@ paths:
                         type: number
                       inferenceProfile:
                         type: string
+                      isProcessing:
+                        type: boolean
                     required:
                       - id
                       - title
@@ -5665,6 +6464,7 @@ paths:
                       - conversationType
                       - source
                       - groupId
+                      - isProcessing
                     additionalProperties: false
                 required:
                   - conversation
@@ -5741,10 +6541,11 @@ paths:
       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.
+        Return the chronological list of compaction events that ran in the same agent turn as the call identified
+        by `callId`. Turn bounds are walked from the `messages` table (real user messages — tool-result user messages
+        are not boundaries). Projected from `llm_request_logs` rows where `call_site = "compactionAgent"`. When the
+        conversation has no other messages around the selected call, every compaction strictly before the call's
+        `createdAt` is in scope. Drives the Inspector's Compaction tab.
       tags:
         - conversations
       responses:
@@ -6220,8 +7021,8 @@ paths:
       operationId: conversations_cli_clear_post
       summary: Clear all conversations (CLI)
       description:
-        Tear down all active conversations and clear the database. The confirmation prompt is handled client-side
-        by the CLI.
+        "Tear down all active conversations and clear the database. Requires X-Confirm-Destructive:
+        clear-all-conversations."
       tags:
         - conversations
       responses:
@@ -6363,10 +7164,13 @@ paths:
                             - type: "null"
                         updatedAt:
                           type: number
+                        isProcessing:
+                          type: boolean
                       required:
                         - id
                         - title
                         - updatedAt
+                        - isProcessing
                       additionalProperties: false
                 required:
                   - conversations
@@ -6612,6 +7416,8 @@ paths:
                         type: number
                       inferenceProfile:
                         type: string
+                      isProcessing:
+                        type: boolean
                     required:
                       - id
                       - title
@@ -6621,6 +7427,7 @@ paths:
                       - conversationType
                       - source
                       - groupId
+                      - isProcessing
                     additionalProperties: false
                 required:
                   - conversation
@@ -6953,6 +7760,10 @@ paths:
               schema:
                 type: object
                 properties:
+                  messageId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   conversationKey:
                     anyOf:
                       - type: string
@@ -6963,34 +7774,419 @@ paths:
                       - type: "null"
                   conversationKind:
                     type: string
-                    enum:
-                      - user
-                      - background
-                      - background_memory_consolidation
-                      - scheduled
                   conversationTotalEstimatedCostUsd:
                     anyOf:
                       - type: number
                       - type: "null"
                   logs:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        createdAt:
+                          type: number
+                        requestPayload:
+                          type: "null"
+                        responsePayload:
+                          type: "null"
+                        provider:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        summary:
+                          anyOf:
+                            - type: object
+                              properties:
+                                provider:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                model:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                status:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                inputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                outputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                cacheCreationInputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                cacheReadInputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                stopReason:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                requestMessageCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                requestToolCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responseMessageCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responseToolCallCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responsePreview:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                toolCallNames:
+                                  anyOf:
+                                    - type: array
+                                      items:
+                                        type: string
+                                    - type: "null"
+                                estimatedCostUsd:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                durationMs:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                              additionalProperties: false
+                            - type: "null"
+                        requestSections:
+                          anyOf:
+                            - type: array
+                              items:
+                                type: object
+                                properties:
+                                  kind:
+                                    type: string
+                                  label:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  role:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  text:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  toolName:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  data: {}
+                                  language:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                required:
+                                  - kind
+                                additionalProperties: false
+                            - type: "null"
+                        responseSections:
+                          anyOf:
+                            - type: array
+                              items:
+                                type: object
+                                properties:
+                                  kind:
+                                    type: string
+                                  label:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  role:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  text:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  toolName:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  data: {}
+                                  language:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                required:
+                                  - kind
+                                additionalProperties: false
+                            - type: "null"
+                        agentLoopExitReason:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        callSite:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - id
+                        - createdAt
+                        - requestPayload
+                        - responsePayload
+                      additionalProperties: false
                   memoryRecall:
                     anyOf:
                       - type: object
-                        properties: {}
-                        additionalProperties: {}
-                      - type: "null"
-                  memoryV2Activation:
-                    anyOf:
-                      - type: object
-                        properties: {}
-                        additionalProperties: {}
+                        properties:
+                          enabled:
+                            type: boolean
+                          degraded:
+                            type: boolean
+                          provider:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          model:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          degradation:
+                            anyOf:
+                              - type: object
+                                properties:
+                                  reason:
+                                    type: string
+                                  semanticUnavailable:
+                                    type: boolean
+                                  fallbackSources:
+                                    type: array
+                                    items:
+                                      type: string
+                                required:
+                                  - reason
+                                  - semanticUnavailable
+                                  - fallbackSources
+                                additionalProperties: false
+                              - type: "null"
+                          semanticHits:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          mergedCount:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          selectedCount:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          tier1Count:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          tier2Count:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          hybridSearchLatencyMs:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          sparseVectorUsed:
+                            anyOf:
+                              - type: boolean
+                              - type: "null"
+                          injectedTokens:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          latencyMs:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          topCandidates:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                nodeId:
+                                  type: string
+                                score:
+                                  type: number
+                                semanticSimilarity:
+                                  type: number
+                                recencyBoost:
+                                  type: number
+                                type:
+                                  type: string
+                              required:
+                                - nodeId
+                                - score
+                                - semanticSimilarity
+                                - recencyBoost
+                              additionalProperties: false
+                          injectedText:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          reason:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          queryContext:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                        required:
+                          - enabled
+                          - degraded
+                          - provider
+                          - model
+                          - degradation
+                          - topCandidates
+                          - injectedText
+                          - reason
+                          - queryContext
+                        additionalProperties: false
+                      - type: "null"
+                  memoryV2Activation:
+                    anyOf:
+                      - type: object
+                        properties:
+                          turn:
+                            type: number
+                          mode:
+                            type: string
+                          concepts:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                slug:
+                                  type: string
+                                finalActivation:
+                                  type: number
+                                ownActivation:
+                                  type: number
+                                priorActivation:
+                                  type: number
+                                simUser:
+                                  type: number
+                                simAssistant:
+                                  type: number
+                                simNow:
+                                  type: number
+                                simUserRerankBoost:
+                                  type: number
+                                simAssistantRerankBoost:
+                                  type: number
+                                inRerankPool:
+                                  type: boolean
+                                spreadContribution:
+                                  type: number
+                                source:
+                                  type: string
+                                status:
+                                  type: string
+                              required:
+                                - slug
+                                - finalActivation
+                                - ownActivation
+                                - priorActivation
+                                - simUser
+                                - simAssistant
+                                - simNow
+                                - spreadContribution
+                                - source
+                                - status
+                              additionalProperties: false
+                          config:
+                            type: object
+                            properties:
+                              d:
+                                type: number
+                              c_user:
+                                type: number
+                              c_assistant:
+                                type: number
+                              c_now:
+                                type: number
+                              k:
+                                type: number
+                              hops:
+                                type: number
+                              top_k:
+                                type: number
+                              epsilon:
+                                type: number
+                            required:
+                              - d
+                              - c_user
+                              - c_assistant
+                              - c_now
+                              - k
+                              - hops
+                              - top_k
+                              - epsilon
+                            additionalProperties: false
+                        required:
+                          - turn
+                          - mode
+                          - concepts
+                          - config
+                        additionalProperties: false
+                      - type: "null"
+                  memoryV3Selection:
+                    anyOf:
+                      - type: object
+                        properties:
+                          turn:
+                            type: number
+                          live:
+                            type: boolean
+                          shadow:
+                            type: boolean
+                          selections:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                slug:
+                                  type: string
+                                source:
+                                  type: string
+                                pinned:
+                                  type: boolean
+                              required:
+                                - slug
+                                - source
+                                - pinned
+                              additionalProperties: false
+                          injectedText:
+                            type: string
+                        required:
+                          - turn
+                          - live
+                          - shadow
+                          - selections
+                          - injectedText
+                        additionalProperties: false
                       - type: "null"
                 required:
-                  - conversationId
                   - conversationKind
-                  - conversationTotalEstimatedCostUsd
                   - logs
                   - memoryRecall
                   - memoryV2Activation
@@ -7940,8 +9136,8 @@ paths:
                     type: string
                     description: "Detected mode: dictation, command, or action"
                   actionPlan:
-                    type: string
                     description: Action plan (only when mode is action)
+                    type: string
                   resolvedProfileId:
                     type: string
                     description: Resolved dictation profile ID
@@ -7951,7 +9147,6 @@ paths:
                 required:
                   - text
                   - mode
-                  - actionPlan
                   - resolvedProfileId
                   - profileSource
                 additionalProperties: false
@@ -7967,7 +9162,10 @@ paths:
                   description: Raw speech transcription
                 context:
                   type: object
-                  properties: {}
+                  properties:
+                    cursorInTextField:
+                      description: Whether the cursor is in an editable text field when dictation started
+                      type: boolean
                   additionalProperties: {}
                   description: Dictation context (app name, window title, bundle ID, cursor state, selected text)
                 profileId:
@@ -8415,7 +9613,68 @@ paths:
                 properties:
                   comments:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        surfaceId:
+                          type: string
+                        conversationId:
+                          type: string
+                        author:
+                          type: string
+                        content:
+                          type: string
+                        anchorStart:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        anchorEnd:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        anchorText:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        parentCommentId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        status:
+                          type: string
+                          enum:
+                            - open
+                            - resolved
+                        resolvedBy:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        resolvedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
+                      required:
+                        - id
+                        - surfaceId
+                        - conversationId
+                        - author
+                        - content
+                        - anchorStart
+                        - anchorEnd
+                        - anchorText
+                        - parentCommentId
+                        - status
+                        - resolvedBy
+                        - resolvedAt
+                        - createdAt
+                        - updatedAt
+                      additionalProperties: false
                     description: Comment records
                 required:
                   - comments
@@ -8460,8 +9719,35 @@ paths:
                     type: string
                   content:
                     type: string
+                  anchorStart:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  anchorEnd:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  anchorText:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  parentCommentId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   status:
                     type: string
+                    enum:
+                      - open
+                      - resolved
+                  resolvedBy:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  resolvedAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
                   createdAt:
                     type: number
                   updatedAt:
@@ -8472,7 +9758,13 @@ paths:
                   - conversationId
                   - author
                   - content
+                  - anchorStart
+                  - anchorEnd
+                  - anchorText
+                  - parentCommentId
                   - status
+                  - resolvedBy
+                  - resolvedAt
                   - createdAt
                   - updatedAt
                 additionalProperties: false
@@ -8575,17 +9867,59 @@ paths:
                     type: string
                   surfaceId:
                     type: string
+                  conversationId:
+                    type: string
+                  author:
+                    type: string
                   content:
                     type: string
+                  anchorStart:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  anchorEnd:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  anchorText:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  parentCommentId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   status:
                     type: string
+                    enum:
+                      - open
+                      - resolved
+                  resolvedBy:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  resolvedAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  createdAt:
+                    type: number
                   updatedAt:
                     type: number
                 required:
                   - id
                   - surfaceId
+                  - conversationId
+                  - author
                   - content
+                  - anchorStart
+                  - anchorEnd
+                  - anchorText
+                  - parentCommentId
                   - status
+                  - resolvedBy
+                  - resolvedAt
+                  - createdAt
                   - updatedAt
                 additionalProperties: false
       parameters:
@@ -9038,6 +10372,17 @@ paths:
           description:
             Scope to a single conversation by an external key (non-vellum channels) or the web idempotency key.
             Materializes a row on first use. Ignored when conversationId is also provided.
+        - name: lastSeenSeq
+          in: query
+          required: false
+          schema:
+            type: string
+          description:
+            "Optional reconnect cursor: the highest per-conversation event seq the client has already applied. When set
+            together with a conversation scope, the daemon replays any buffered events with seq > lastSeenSeq before
+            going live. If the cursor is older than the ring buffer's oldest entry the connection simply goes live; the
+            client is expected to detect the gap from the next event's seq and refetch via the messages API. Must be a
+            non-negative integer."
   /v1/events/emit:
     post:
       operationId: events_emit_post
@@ -11059,6 +12404,12 @@ paths:
                 imageData:
                   type: string
                   description: Optional base64-encoded image bytes for successful image reads
+                audioData:
+                  type: string
+                  description: Optional base64-encoded audio bytes for successful audio reads
+                audioMimeType:
+                  type: string
+                  description: MIME type for audioData (e.g. audio/mpeg)
               required:
                 - requestId
               additionalProperties: false
@@ -11143,7 +12494,6 @@ paths:
                   - emoji
                   - home
                   - version
-                  - createdAt
                 additionalProperties: false
   /v1/identity/intro:
     get:
@@ -12128,6 +13478,26 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  inviteId:
+                    type: string
+                  token:
+                    type: string
+                  expiresAt:
+                    type: number
+                  senderGatewayUrl:
+                    type: string
+                  error:
+                    type: string
+                required:
+                  - success
+                additionalProperties: false
   /v1/integrations/a2a/invite/accept:
     post:
       operationId: integrations_a2a_invite_accept_post
@@ -12269,6 +13639,23 @@ paths:
       responses:
         "200":
           description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                botToken:
+                  type: string
+                  description: Slack bot token
+                appToken:
+                  type: string
+                  description: Slack app-level token
+              required:
+                - botToken
+                - appToken
+              additionalProperties: false
   /v1/integrations/telegram/commands:
     post:
       operationId: integrations_telegram_commands_post
@@ -12307,8 +13694,21 @@ paths:
       responses:
         "200":
           description: Successful response
-  /v1/integrations/telegram/setup:
-    post:
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                botToken:
+                  type: string
+                  description: Telegram bot token
+              required:
+                - botToken
+              additionalProperties: false
+  /v1/integrations/telegram/setup:
+    post:
       operationId: integrations_telegram_setup_post
       summary: Setup Telegram
       description: "Composite: set config + register commands."
@@ -12346,6 +13746,23 @@ paths:
       responses:
         "200":
           description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                accountSid:
+                  type: string
+                  description: Twilio account SID
+                authToken:
+                  type: string
+                  description: Twilio auth token
+              required:
+                - accountSid
+                - authToken
+              additionalProperties: false
   /v1/integrations/twilio/numbers:
     get:
       operationId: integrations_twilio_numbers_get
@@ -13162,6 +14579,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  nowText:
+                    type: string
+                required:
+                  - nowText
+                additionalProperties: false
   /v1/memory/v2/reembed-skills:
     post:
       operationId: memory_v2_reembedskills_post
@@ -13193,6 +14620,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  template:
+                    type: string
+                required:
+                  - template
+                additionalProperties: false
   /v1/memory/v2/simulate-router:
     post:
       operationId: memory_v2_simulaterouter_post
@@ -13207,6 +14644,89 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  selectedSlugs:
+                    type: array
+                    items:
+                      type: string
+                  sourceBySlug:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: string
+                  scores:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: number
+                  failureReason:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  effectiveConfig:
+                    type: object
+                    properties:
+                      tier1_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      tier2_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      batch_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      max_page_ids:
+                        type: number
+                    required:
+                      - tier1_size
+                      - tier2_size
+                      - batch_size
+                      - max_page_ids
+                    additionalProperties: false
+                  overrides:
+                    type: object
+                    properties:
+                      tier1_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      tier2_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      batch_size:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                    additionalProperties: false
+                  totalCandidatePages:
+                    type: number
+                  profileOverride:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  routerPromptOverridden:
+                    type: boolean
+                required:
+                  - selectedSlugs
+                  - sourceBySlug
+                  - scores
+                  - failureReason
+                  - effectiveConfig
+                  - overrides
+                  - totalCandidatePages
+                  - profileOverride
+                  - routerPromptOverridden
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -13281,167 +14801,42 @@ 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:
+  /v1/memory/v3/health:
     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.
+      operationId: memory_v3_health_post
+      summary: Print the v3 structural health report (read-only)
       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:
+  /v1/memory/v3/rebuild-index:
     post:
-      operationId: memory_v3_simulate_post
-      summary: Dry-run the v3 retrieval loop against an ad-hoc query (read-only)
-      description:
-        Runs the v3 multi-lane bounded-descent retrieval loop read-only against a single synthetic turn built from
-        the supplied query plus the live (or supplied) NOW context. Returns the selected page slugs, per-lane
-        provenance, the full multi-pass descent trace, and accumulated cost. Optional passCap / lane-allowlist overrides
-        apply on top of live config. Invoked directly (not gated by memory.v3.enabled/shadow) so operators can probe v3
-        retrieval before flipping the flags; writes nothing (co-activation persistence is forced off), though each pass
-        still spends the loop's filter + gate LLM calls.
+      operationId: memory_v3_rebuildindex_post
+      summary: Invalidate the v3 lanes so the next turn rebuilds
       tags:
         - memory
       responses:
         "200":
           description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                query:
-                  type: string
-                  minLength: 1
-                nowText:
-                  type: string
-                passCap:
-                  type: integer
-                  exclusiveMinimum: 0
-                  maximum: 9007199254740991
-                lanes:
-                  minItems: 1
-                  type: array
-                  items:
-                    type: string
-                    enum:
-                      - hot
-                      - sparse
-                      - dense
-                      - tree
-                      - edges
-              required:
-                - query
-              additionalProperties: false
-  /v1/memory/v3/tree:
+  /v1/memory/v3/reconcile:
     post:
-      operationId: memory_v3_tree_post
-      summary: Return a serializable view of the memory v3 tree DAG (read-only)
-      description:
-        Returns the v3 tree root id plus every node and its ordered child refs (page:/node:) as a JSON-serializable
-        projection of the in-memory TreeIndex. Read-only; the CLI uses it to print an indented tree with shared-DAG
-        re-entries marked.
+      operationId: memory_v3_reconcile_post
+      summary: v1 convergence/prune pass over page+core refs (no rename detection without a prior snapshot)
       tags:
         - memory
       responses:
         "200":
           description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties: {}
-              additionalProperties: false
-  /v1/memory/v3/validate:
+  /v1/memory/v3/set-core:
     post:
-      operationId: memory_v3_validate_post
-      summary: Validate the memory v3 tree structure (read-only)
-      description:
-        Read-only structural validation of the hand-authored v3 tree DAG. Reports dangling child refs, orphan
-        pages, cycles, stale compositional indexes, and unknown edge targets. Writes nothing and runs no LLM — operators
-        dry-run it while the v2 → v3 migration is in flight.
+      operationId: memory_v3_setcore_post
+      summary: Add/remove always-on core leaves (validates + previews cost)
       tags:
         - memory
       responses:
         "200":
           description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties: {}
-              additionalProperties: false
   /v1/messages:
     get:
       operationId: messages_get
@@ -13562,44 +14957,439 @@ paths:
                 type: object
                 properties:
                   messageId:
-                    type: string
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  conversationKey:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  conversationId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   conversationKind:
                     type: string
-                    enum:
-                      - user
-                      - background
-                      - background_memory_consolidation
-                      - scheduled
                   conversationTotalEstimatedCostUsd:
                     anyOf:
                       - type: number
                       - type: "null"
                   logs:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        createdAt:
+                          type: number
+                        requestPayload:
+                          type: "null"
+                        responsePayload:
+                          type: "null"
+                        provider:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        summary:
+                          anyOf:
+                            - type: object
+                              properties:
+                                provider:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                model:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                status:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                inputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                outputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                cacheCreationInputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                cacheReadInputTokens:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                stopReason:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                requestMessageCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                requestToolCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responseMessageCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responseToolCallCount:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                responsePreview:
+                                  anyOf:
+                                    - type: string
+                                    - type: "null"
+                                toolCallNames:
+                                  anyOf:
+                                    - type: array
+                                      items:
+                                        type: string
+                                    - type: "null"
+                                estimatedCostUsd:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                                durationMs:
+                                  anyOf:
+                                    - type: number
+                                    - type: "null"
+                              additionalProperties: false
+                            - type: "null"
+                        requestSections:
+                          anyOf:
+                            - type: array
+                              items:
+                                type: object
+                                properties:
+                                  kind:
+                                    type: string
+                                  label:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  role:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  text:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  toolName:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  data: {}
+                                  language:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                required:
+                                  - kind
+                                additionalProperties: false
+                            - type: "null"
+                        responseSections:
+                          anyOf:
+                            - type: array
+                              items:
+                                type: object
+                                properties:
+                                  kind:
+                                    type: string
+                                  label:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  role:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  text:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  toolName:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                  data: {}
+                                  language:
+                                    anyOf:
+                                      - type: string
+                                      - type: "null"
+                                required:
+                                  - kind
+                                additionalProperties: false
+                            - type: "null"
+                        agentLoopExitReason:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        callSite:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - id
+                        - createdAt
+                        - requestPayload
+                        - responsePayload
+                      additionalProperties: false
                   memoryRecall:
                     anyOf:
                       - type: object
-                        properties: {}
-                        additionalProperties: {}
-                      - type: "null"
-                  memoryV2Activation:
-                    anyOf:
-                      - type: object
-                        properties: {}
-                        additionalProperties: {}
-                      - type: "null"
-                required:
-                  - messageId
-                  - conversationKind
-                  - conversationTotalEstimatedCostUsd
-                  - logs
-                  - memoryRecall
-                  - memoryV2Activation
-                additionalProperties: false
-      parameters:
-        - name: id
-          in: path
+                        properties:
+                          enabled:
+                            type: boolean
+                          degraded:
+                            type: boolean
+                          provider:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          model:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          degradation:
+                            anyOf:
+                              - type: object
+                                properties:
+                                  reason:
+                                    type: string
+                                  semanticUnavailable:
+                                    type: boolean
+                                  fallbackSources:
+                                    type: array
+                                    items:
+                                      type: string
+                                required:
+                                  - reason
+                                  - semanticUnavailable
+                                  - fallbackSources
+                                additionalProperties: false
+                              - type: "null"
+                          semanticHits:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          mergedCount:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          selectedCount:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          tier1Count:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          tier2Count:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          hybridSearchLatencyMs:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          sparseVectorUsed:
+                            anyOf:
+                              - type: boolean
+                              - type: "null"
+                          injectedTokens:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          latencyMs:
+                            anyOf:
+                              - type: number
+                              - type: "null"
+                          topCandidates:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                nodeId:
+                                  type: string
+                                score:
+                                  type: number
+                                semanticSimilarity:
+                                  type: number
+                                recencyBoost:
+                                  type: number
+                                type:
+                                  type: string
+                              required:
+                                - nodeId
+                                - score
+                                - semanticSimilarity
+                                - recencyBoost
+                              additionalProperties: false
+                          injectedText:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          reason:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          queryContext:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                        required:
+                          - enabled
+                          - degraded
+                          - provider
+                          - model
+                          - degradation
+                          - topCandidates
+                          - injectedText
+                          - reason
+                          - queryContext
+                        additionalProperties: false
+                      - type: "null"
+                  memoryV2Activation:
+                    anyOf:
+                      - type: object
+                        properties:
+                          turn:
+                            type: number
+                          mode:
+                            type: string
+                          concepts:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                slug:
+                                  type: string
+                                finalActivation:
+                                  type: number
+                                ownActivation:
+                                  type: number
+                                priorActivation:
+                                  type: number
+                                simUser:
+                                  type: number
+                                simAssistant:
+                                  type: number
+                                simNow:
+                                  type: number
+                                simUserRerankBoost:
+                                  type: number
+                                simAssistantRerankBoost:
+                                  type: number
+                                inRerankPool:
+                                  type: boolean
+                                spreadContribution:
+                                  type: number
+                                source:
+                                  type: string
+                                status:
+                                  type: string
+                              required:
+                                - slug
+                                - finalActivation
+                                - ownActivation
+                                - priorActivation
+                                - simUser
+                                - simAssistant
+                                - simNow
+                                - spreadContribution
+                                - source
+                                - status
+                              additionalProperties: false
+                          config:
+                            type: object
+                            properties:
+                              d:
+                                type: number
+                              c_user:
+                                type: number
+                              c_assistant:
+                                type: number
+                              c_now:
+                                type: number
+                              k:
+                                type: number
+                              hops:
+                                type: number
+                              top_k:
+                                type: number
+                              epsilon:
+                                type: number
+                            required:
+                              - d
+                              - c_user
+                              - c_assistant
+                              - c_now
+                              - k
+                              - hops
+                              - top_k
+                              - epsilon
+                            additionalProperties: false
+                        required:
+                          - turn
+                          - mode
+                          - concepts
+                          - config
+                        additionalProperties: false
+                      - type: "null"
+                  memoryV3Selection:
+                    anyOf:
+                      - type: object
+                        properties:
+                          turn:
+                            type: number
+                          live:
+                            type: boolean
+                          shadow:
+                            type: boolean
+                          selections:
+                            type: array
+                            items:
+                              type: object
+                              properties:
+                                slug:
+                                  type: string
+                                source:
+                                  type: string
+                                pinned:
+                                  type: boolean
+                              required:
+                                - slug
+                                - source
+                                - pinned
+                              additionalProperties: false
+                          injectedText:
+                            type: string
+                        required:
+                          - turn
+                          - live
+                          - shadow
+                          - selections
+                          - injectedText
+                        additionalProperties: false
+                      - type: "null"
+                required:
+                  - conversationKind
+                  - logs
+                  - memoryRecall
+                  - memoryV2Activation
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
           required: true
           schema:
             type: string
@@ -15650,7 +17440,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Schedule objects
                 required:
                   - schedules
@@ -15678,7 +17576,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Updated schedule list
                 required:
                   - schedules
@@ -15732,8 +17738,116 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
-                    description: Updated schedule list
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
+                    description: Updated schedule list
                 required:
                   - schedules
                 additionalProperties: false
@@ -15759,7 +17873,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Updated schedule list
                 required:
                   - schedules
@@ -15806,18 +18028,11 @@ paths:
                 retryBackoffMs:
                   type: number
                   description: Retry backoff in milliseconds
-              required:
-                - name
-                - expression
-                - timezone
-                - message
-                - script
-                - mode
-                - routingIntent
-                - quiet
-                - reuseConversation
-                - maxRetries
-                - retryBackoffMs
+                timeoutMs:
+                  anyOf:
+                    - type: number
+                    - type: "null"
+                  description: Script-mode execution timeout in ms; null = use default
               additionalProperties: false
   /v1/schedules/{id}/cancel:
     post:
@@ -15836,7 +18051,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Updated schedule list
                 required:
                   - schedules
@@ -15864,7 +18187,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Updated schedule list
                 required:
                   - schedules
@@ -15892,7 +18323,51 @@ paths:
                 properties:
                   runs:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        jobId:
+                          type: string
+                        status:
+                          type: string
+                        startedAt:
+                          type: number
+                        finishedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        durationMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        output:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        error:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        conversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdAt:
+                          type: number
+                      required:
+                        - id
+                        - jobId
+                        - status
+                        - startedAt
+                        - finishedAt
+                        - durationMs
+                        - output
+                        - error
+                        - conversationId
+                        - createdAt
+                      additionalProperties: false
                     description: Schedule run objects
                 required:
                   - runs
@@ -15926,7 +18401,115 @@ paths:
                 properties:
                   schedules:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        enabled:
+                          type: boolean
+                        syntax:
+                          type: string
+                          enum:
+                            - cron
+                            - rrule
+                        expression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        cronExpression:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        timezone:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        message:
+                          type: string
+                        script:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        nextRunAt:
+                          type: number
+                        lastRunAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        lastStatus:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        retryCount:
+                          type: number
+                        maxRetries:
+                          type: number
+                        retryBackoffMs:
+                          type: number
+                        timeoutMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        mode:
+                          type: string
+                          enum:
+                            - notify
+                            - execute
+                            - script
+                            - wake
+                        status:
+                          type: string
+                          enum:
+                            - active
+                            - firing
+                            - fired
+                            - cancelled
+                        routingIntent:
+                          type: string
+                          enum:
+                            - single_channel
+                            - multi_channel
+                            - all_channels
+                        reuseConversation:
+                          type: boolean
+                        wakeConversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        isOneShot:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - enabled
+                        - syntax
+                        - expression
+                        - cronExpression
+                        - timezone
+                        - message
+                        - script
+                        - nextRunAt
+                        - lastRunAt
+                        - lastStatus
+                        - retryCount
+                        - maxRetries
+                        - retryBackoffMs
+                        - timeoutMs
+                        - description
+                        - mode
+                        - status
+                        - routingIntent
+                        - reuseConversation
+                        - wakeConversationId
+                        - isOneShot
+                      additionalProperties: false
                     description: Updated schedule list
                 required:
                   - schedules
@@ -15993,9 +18576,124 @@ paths:
                     type: string
                   results:
                     type: object
-                    properties: {}
-                    additionalProperties: {}
-                    description: Results grouped by category
+                    properties:
+                      conversations:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            title:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            updatedAt:
+                              type: number
+                            excerpt:
+                              type: string
+                            matchCount:
+                              type: integer
+                              minimum: -9007199254740991
+                              maximum: 9007199254740991
+                          required:
+                            - id
+                            - title
+                            - updatedAt
+                            - excerpt
+                            - matchCount
+                          additionalProperties: false
+                      memories:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            kind:
+                              type: string
+                            text:
+                              type: string
+                            subject:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            confidence:
+                              type: number
+                            updatedAt:
+                              type: number
+                            source:
+                              type: string
+                              enum:
+                                - lexical
+                                - semantic
+                          required:
+                            - id
+                            - kind
+                            - text
+                            - subject
+                            - confidence
+                            - updatedAt
+                            - source
+                          additionalProperties: false
+                      schedules:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            expression:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            message:
+                              type: string
+                            enabled:
+                              type: boolean
+                            nextRunAt:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                          required:
+                            - id
+                            - name
+                            - expression
+                            - message
+                            - enabled
+                            - nextRunAt
+                          additionalProperties: false
+                      contacts:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            displayName:
+                              type: string
+                            notes:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            lastInteraction:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                          required:
+                            - id
+                            - displayName
+                            - notes
+                            - lastInteraction
+                          additionalProperties: false
+                    required:
+                      - conversations
+                      - memories
+                      - schedules
+                      - contacts
+                    additionalProperties: false
                 required:
                   - query
                   - results
@@ -16508,6 +19206,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: vellum
@@ -16517,6 +19226,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                           additionalProperties: false
                         - type: object
@@ -16541,6 +19251,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: clawhub
@@ -16564,6 +19285,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                             - slug
                             - author
@@ -16594,6 +19316,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: skillssh
@@ -16635,6 +19368,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                             - slug
                             - sourceRepo
@@ -16662,6 +19396,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: custom
@@ -16671,6 +19416,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                           additionalProperties: false
                     description: Skill objects
@@ -16814,6 +19560,17 @@ paths:
                               - enabled
                               - disabled
                               - available
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
                           origin:
                             type: string
                             const: vellum
@@ -16823,6 +19580,7 @@ paths:
                           - description
                           - kind
                           - status
+                          - category
                           - origin
                         additionalProperties: false
                       - type: object
@@ -16847,6 +19605,17 @@ paths:
                               - enabled
                               - disabled
                               - available
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
                           origin:
                             type: string
                             const: clawhub
@@ -16924,6 +19693,7 @@ paths:
                           - description
                           - kind
                           - status
+                          - category
                           - origin
                           - slug
                           - author
@@ -16954,6 +19724,17 @@ paths:
                               - enabled
                               - disabled
                               - available
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
                           origin:
                             type: string
                             const: skillssh
@@ -16995,6 +19776,7 @@ paths:
                           - description
                           - kind
                           - status
+                          - category
                           - origin
                           - slug
                           - sourceRepo
@@ -17022,6 +19804,17 @@ paths:
                               - enabled
                               - disabled
                               - available
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
                           origin:
                             type: string
                             const: custom
@@ -17031,6 +19824,7 @@ paths:
                           - description
                           - kind
                           - status
+                          - category
                           - origin
                         additionalProperties: false
                     description: Skill detail object
@@ -17137,7 +19931,300 @@ paths:
                   ok:
                     type: boolean
                 required:
-                  - ok
+                  - ok
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/skills/{id}/files:
+    get:
+      operationId: skills_by_id_files_get
+      summary: Get skill files
+      description: Return skill metadata and directory contents.
+      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
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
+                          origin:
+                            type: string
+                            const: vellum
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - 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
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
+                          origin:
+                            type: string
+                            const: clawhub
+                          slug:
+                            type: string
+                          author:
+                            type: string
+                          stars:
+                            type: number
+                          installs:
+                            type: number
+                          reports:
+                            type: number
+                          publishedAt:
+                            type: string
+                          version:
+                            type: string
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - origin
+                          - slug
+                          - author
+                          - stars
+                          - installs
+                          - reports
+                          - version
+                        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
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
+                          origin:
+                            type: string
+                            const: skillssh
+                          slug:
+                            type: string
+                          sourceRepo:
+                            type: string
+                          installs:
+                            type: number
+                          audit:
+                            type: object
+                            propertyNames:
+                              type: string
+                            additionalProperties:
+                              type: object
+                              properties:
+                                risk:
+                                  type: string
+                                  enum:
+                                    - safe
+                                    - low
+                                    - medium
+                                    - high
+                                    - critical
+                                    - unknown
+                                alerts:
+                                  type: number
+                                score:
+                                  type: number
+                                analyzedAt:
+                                  type: string
+                              required:
+                                - risk
+                                - analyzedAt
+                              additionalProperties: false
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - 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
+                          category:
+                            type: string
+                            enum:
+                              - communication
+                              - productivity
+                              - development
+                              - media
+                              - automation
+                              - webSocial
+                              - knowledge
+                              - integration
+                          origin:
+                            type: string
+                            const: custom
+                        required:
+                          - id
+                          - name
+                          - description
+                          - kind
+                          - status
+                          - category
+                          - origin
+                        additionalProperties: false
+                    description: Skill metadata
+                  files:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        path:
+                          type: string
+                        name:
+                          type: string
+                        size:
+                          type: integer
+                          minimum: -9007199254740991
+                          maximum: 9007199254740991
+                        mimeType:
+                          type: string
+                        isBinary:
+                          type: boolean
+                        content:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - path
+                        - name
+                        - size
+                        - mimeType
+                        - isBinary
+                        - content
+                      additionalProperties: false
+                    description: Directory contents
+                required:
+                  - skill
+                  - files
                 additionalProperties: false
       parameters:
         - name: id
@@ -17145,22 +20232,6 @@ paths:
           required: true
           schema:
             type: string
-  /v1/skills/{id}/files:
-    get:
-      operationId: skills_by_id_files_get
-      summary: Get skill files
-      description: Return skill metadata and directory contents.
-      tags:
-        - skills
-      responses:
-        "200":
-          description: Successful response
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
   /v1/skills/{id}/files/content:
     get:
       operationId: skills_by_id_files_content_get
@@ -17419,6 +20490,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: vellum
@@ -17428,6 +20510,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                           additionalProperties: false
                         - type: object
@@ -17452,6 +20535,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: clawhub
@@ -17475,6 +20569,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                             - slug
                             - author
@@ -17505,6 +20600,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: skillssh
@@ -17546,6 +20652,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                             - slug
                             - sourceRepo
@@ -17573,6 +20680,17 @@ paths:
                                 - enabled
                                 - disabled
                                 - available
+                            category:
+                              type: string
+                              enum:
+                                - communication
+                                - productivity
+                                - development
+                                - media
+                                - automation
+                                - webSocial
+                                - knowledge
+                                - integration
                             origin:
                               type: string
                               const: custom
@@ -17582,6 +20700,7 @@ paths:
                             - description
                             - kind
                             - status
+                            - category
                             - origin
                           additionalProperties: false
                     description: Skill objects matching the search query
@@ -17769,6 +20888,15 @@ paths:
                     type: string
                   objective:
                     type: string
+                  status:
+                    type: string
+                    enum:
+                      - pending
+                      - running
+                      - awaiting_input
+                      - completed
+                      - failed
+                      - aborted
                   usage:
                     type: object
                     properties:
@@ -17785,11 +20913,25 @@ paths:
                     additionalProperties: false
                   events:
                     type: array
-                    items: {}
-                    description: Subagent event objects
+                    items:
+                      type: object
+                      properties:
+                        type:
+                          type: string
+                        content:
+                          type: string
+                        toolName:
+                          type: string
+                        isError:
+                          type: boolean
+                        messageId:
+                          type: string
+                      required:
+                        - type
+                        - content
+                      additionalProperties: false
                 required:
                   - subagentId
-                  - objective
                   - events
                 additionalProperties: false
       parameters:
@@ -18086,7 +21228,9 @@ paths:
                   surfaceType:
                     type: string
                   title:
-                    type: string
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   data:
                     type: object
                     properties: {}
@@ -18622,7 +21766,65 @@ paths:
                 properties:
                   events:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        eventId:
+                          type: string
+                        conversationId:
+                          type: string
+                        requestId:
+                          type: string
+                        timestampMs:
+                          type: number
+                        sequence:
+                          type: number
+                        kind:
+                          type: string
+                          enum:
+                            - request_received
+                            - request_queued
+                            - request_dequeued
+                            - llm_call_started
+                            - llm_call_finished
+                            - assistant_message
+                            - tool_started
+                            - tool_permission_requested
+                            - tool_permission_decided
+                            - tool_finished
+                            - tool_failed
+                            - generation_handoff
+                            - message_complete
+                            - generation_cancelled
+                            - request_error
+                            - tool_profiling_summary
+                        status:
+                          type: string
+                          enum:
+                            - info
+                            - success
+                            - warning
+                            - error
+                        summary:
+                          type: string
+                        attributes:
+                          type: object
+                          propertyNames:
+                            type: string
+                          additionalProperties:
+                            anyOf:
+                              - type: string
+                              - type: number
+                              - type: boolean
+                              - type: "null"
+                      required:
+                        - eventId
+                        - conversationId
+                        - timestampMs
+                        - sequence
+                        - kind
+                        - summary
+                      additionalProperties: false
                     description: Trace event objects
                 required:
                   - events
@@ -19012,7 +22214,41 @@ paths:
                 properties:
                   breakdown:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        group:
+                          type: string
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        groupKey:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        totalInputTokens:
+                          type: number
+                        totalOutputTokens:
+                          type: number
+                        totalCacheCreationTokens:
+                          type: number
+                        totalCacheReadTokens:
+                          type: number
+                        totalEstimatedCostUsd:
+                          type: number
+                        eventCount:
+                          type: number
+                      required:
+                        - group
+                        - groupId
+                        - totalInputTokens
+                        - totalOutputTokens
+                        - totalCacheCreationTokens
+                        - totalCacheReadTokens
+                        - totalEstimatedCostUsd
+                        - eventCount
+                      additionalProperties: false
                     description: Grouped usage entries
                 required:
                   - breakdown
@@ -19053,7 +22289,31 @@ paths:
                 properties:
                   buckets:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        bucketId:
+                          type: string
+                        date:
+                          type: string
+                        displayLabel:
+                          type: string
+                        totalInputTokens:
+                          type: number
+                        totalOutputTokens:
+                          type: number
+                        totalEstimatedCostUsd:
+                          type: number
+                        eventCount:
+                          type: number
+                      required:
+                        - bucketId
+                        - date
+                        - totalInputTokens
+                        - totalOutputTokens
+                        - totalEstimatedCostUsd
+                        - eventCount
+                      additionalProperties: false
                     description: Usage bucket objects
                 required:
                   - buckets
@@ -19105,7 +22365,61 @@ paths:
                 properties:
                   buckets:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        bucketId:
+                          type: string
+                        date:
+                          type: string
+                        displayLabel:
+                          type: string
+                        totalInputTokens:
+                          type: number
+                        totalOutputTokens:
+                          type: number
+                        totalEstimatedCostUsd:
+                          type: number
+                        eventCount:
+                          type: number
+                        groups:
+                          type: object
+                          propertyNames:
+                            type: string
+                          additionalProperties:
+                            type: object
+                            properties:
+                              group:
+                                type: string
+                              groupKey:
+                                anyOf:
+                                  - type: string
+                                  - type: "null"
+                              totalInputTokens:
+                                type: number
+                              totalOutputTokens:
+                                type: number
+                              totalEstimatedCostUsd:
+                                type: number
+                              eventCount:
+                                type: number
+                            required:
+                              - group
+                              - groupKey
+                              - totalInputTokens
+                              - totalOutputTokens
+                              - totalEstimatedCostUsd
+                              - eventCount
+                            additionalProperties: false
+                      required:
+                        - bucketId
+                        - date
+                        - totalInputTokens
+                        - totalOutputTokens
+                        - totalEstimatedCostUsd
+                        - eventCount
+                        - groups
+                      additionalProperties: false
                     description: Grouped usage bucket objects
                 required:
                   - buckets
@@ -19156,6 +22470,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  totalInputTokens:
+                    type: number
+                  totalOutputTokens:
+                    type: number
+                  totalCacheCreationTokens:
+                    type: number
+                  totalCacheReadTokens:
+                    type: number
+                  totalEstimatedCostUsd:
+                    type: number
+                  eventCount:
+                    type: number
+                  pricedEventCount:
+                    type: number
+                  unpricedEventCount:
+                    type: number
+                required:
+                  - totalInputTokens
+                  - totalOutputTokens
+                  - totalCacheCreationTokens
+                  - totalCacheReadTokens
+                  - totalEstimatedCostUsd
+                  - eventCount
+                  - pricedEventCount
+                  - unpricedEventCount
+                additionalProperties: false
       parameters:
         - name: from
           in: query
@@ -19904,7 +23249,36 @@ paths:
                     type: string
                   entries:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                        path:
+                          type: string
+                        type:
+                          type: string
+                          enum:
+                            - file
+                            - directory
+                        size:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        mimeType:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        modifiedAt:
+                          type: string
+                      required:
+                        - name
+                        - path
+                        - type
+                        - size
+                        - mimeType
+                        - modifiedAt
+                      additionalProperties: false
                     description: Directory entry objects
                 required:
                   - path
@@ -19923,6 +23297,14 @@ paths:
           schema:
             type: string
           description: Include dotfiles (true/false)
+        - name: includeDirSizes
+          in: query
+          required: false
+          schema:
+            type: string
+          description:
+            "Compute recursive byte size for each directory entry (true/false). Budget-bounded — large subtrees may
+            return size: null."
   /v1/workspace/write:
     post:
       operationId: workspace_write_post