@vellumai/assistant 0.12.0-staging.1 → 0.12.0

package/openapi.yaml

@@ -571,6 +571,359 @@ paths:
                   - protocolSessionId
                   - agent
                 additionalProperties: false
+  /v1/activation/dismiss:
+    post:
+      operationId: activation_dismiss_post
+      summary: Dismiss an activation surface
+      description: Record that the welcome modal or the celebration modal was dismissed.
+      tags:
+        - activation
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                kind:
+                  type: string
+                  enum:
+                    - modal
+                    - all-done
+                  description: Which surface was dismissed
+                listId:
+                  description: List the surface showed, stored only while no list is frozen
+                  type: string
+                  pattern: ^[a-z0-9-]{1,64}$
+              required:
+                - kind
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  version:
+                    type: number
+                    const: 1
+                    description: Schema version
+                  listId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: Task list frozen on the first write, null before then
+                  modalDismissedAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the welcome modal was dismissed
+                  allDoneShownAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the celebration modal was dismissed
+                  tasks:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: object
+                      properties:
+                        status:
+                          type: string
+                          enum:
+                            - started
+                            - done
+                          description: "`started` while the linked conversation is working the task"
+                        conversationId:
+                          type: string
+                          maxLength: 128
+                          description: Conversation the task was launched into
+                        startedAt:
+                          type: string
+                          description: ISO timestamp of the launch
+                        completedAt:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                          description: ISO timestamp of the completing turn, null while started
+                        stepCount:
+                          anyOf:
+                            - type: integer
+                              minimum: -9007199254740991
+                              maximum: 9007199254740991
+                            - type: "null"
+                          description: Tool calls observed in the linked conversation so far
+                        artifacts:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              workspacePath:
+                                type: string
+                                description: Path of the produced file, as the assistant attached it
+                              displayName:
+                                type: string
+                                description: Human-readable file name for the card
+                            required:
+                              - workspacePath
+                              - displayName
+                            additionalProperties: false
+                          description: Files the completing turn attached
+                      required:
+                        - status
+                        - conversationId
+                        - startedAt
+                        - completedAt
+                        - stepCount
+                        - artifacts
+                      additionalProperties: false
+                    description: Progress keyed by task id
+                required:
+                  - version
+                  - listId
+                  - modalDismissedAt
+                  - allDoneShownAt
+                  - tasks
+                additionalProperties: false
+        "400":
+          description: Malformed dismiss kind or list id
+        "409":
+          description: Stored progress was written by a newer build; the dismissal was not recorded
+        "503":
+          description: Stored progress is locked by another process; the dismissal was not recorded
+  /v1/activation/progress:
+    get:
+      operationId: activation_progress_get
+      summary: Get activation progress
+      description: "Return the activation checklist progress: the frozen list, dismissed surfaces, and per-task state."
+      tags:
+        - activation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  version:
+                    type: number
+                    const: 1
+                    description: Schema version
+                  listId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: Task list frozen on the first write, null before then
+                  modalDismissedAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the welcome modal was dismissed
+                  allDoneShownAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the celebration modal was dismissed
+                  tasks:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: object
+                      properties:
+                        status:
+                          type: string
+                          enum:
+                            - started
+                            - done
+                          description: "`started` while the linked conversation is working the task"
+                        conversationId:
+                          type: string
+                          maxLength: 128
+                          description: Conversation the task was launched into
+                        startedAt:
+                          type: string
+                          description: ISO timestamp of the launch
+                        completedAt:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                          description: ISO timestamp of the completing turn, null while started
+                        stepCount:
+                          anyOf:
+                            - type: integer
+                              minimum: -9007199254740991
+                              maximum: 9007199254740991
+                            - type: "null"
+                          description: Tool calls observed in the linked conversation so far
+                        artifacts:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              workspacePath:
+                                type: string
+                                description: Path of the produced file, as the assistant attached it
+                              displayName:
+                                type: string
+                                description: Human-readable file name for the card
+                            required:
+                              - workspacePath
+                              - displayName
+                            additionalProperties: false
+                          description: Files the completing turn attached
+                      required:
+                        - status
+                        - conversationId
+                        - startedAt
+                        - completedAt
+                        - stepCount
+                        - artifacts
+                      additionalProperties: false
+                    description: Progress keyed by task id
+                required:
+                  - version
+                  - listId
+                  - modalDismissedAt
+                  - allDoneShownAt
+                  - tasks
+                additionalProperties: false
+  /v1/activation/tasks/{taskId}/start:
+    post:
+      operationId: activation_tasks_by_taskId_start_post
+      summary: Start an activation task
+      description:
+        Link an activation task to the conversation its prompt was sent to. Idempotent per task; a different
+        conversation replaces the link only while the task is not done.
+      tags:
+        - activation
+      parameters:
+        - name: taskId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                  minLength: 1
+                  maxLength: 128
+                  description: Conversation the task prompt was sent to
+                listId:
+                  description: List the task came from, stored only while no list is frozen
+                  type: string
+                  pattern: ^[a-z0-9-]{1,64}$
+              required:
+                - conversationId
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  version:
+                    type: number
+                    const: 1
+                    description: Schema version
+                  listId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: Task list frozen on the first write, null before then
+                  modalDismissedAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the welcome modal was dismissed
+                  allDoneShownAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                    description: ISO timestamp the celebration modal was dismissed
+                  tasks:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: object
+                      properties:
+                        status:
+                          type: string
+                          enum:
+                            - started
+                            - done
+                          description: "`started` while the linked conversation is working the task"
+                        conversationId:
+                          type: string
+                          maxLength: 128
+                          description: Conversation the task was launched into
+                        startedAt:
+                          type: string
+                          description: ISO timestamp of the launch
+                        completedAt:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                          description: ISO timestamp of the completing turn, null while started
+                        stepCount:
+                          anyOf:
+                            - type: integer
+                              minimum: -9007199254740991
+                              maximum: 9007199254740991
+                            - type: "null"
+                          description: Tool calls observed in the linked conversation so far
+                        artifacts:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              workspacePath:
+                                type: string
+                                description: Path of the produced file, as the assistant attached it
+                              displayName:
+                                type: string
+                                description: Human-readable file name for the card
+                            required:
+                              - workspacePath
+                              - displayName
+                            additionalProperties: false
+                          description: Files the completing turn attached
+                      required:
+                        - status
+                        - conversationId
+                        - startedAt
+                        - completedAt
+                        - stepCount
+                        - artifacts
+                      additionalProperties: false
+                    description: Progress keyed by task id
+                required:
+                  - version
+                  - listId
+                  - modalDismissedAt
+                  - allDoneShownAt
+                  - tasks
+                additionalProperties: false
+        "400":
+          description: Malformed task id, list id, or conversation id
+        "404":
+          description: No such conversation; the link was not recorded
+        "409":
+          description: Stored progress was written by a newer build; the link was not recorded
+        "503":
+          description: Stored progress is locked by another process; the link was not recorded
   /v1/admin/rollback-migrations:
     post:
       operationId: admin_rollbackmigrations_post
@@ -36648,6 +37001,281 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/x/plugins/{plugin}/notices:
+    delete:
+      operationId: x_plugins_by_plugin_notices_delete
+      summary: Gateway DELETE notice to a plugin (namespace root)
+      description:
+        "Dispatches DELETE requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    get:
+      operationId: x_plugins_by_plugin_notices_get
+      summary: Gateway GET notice to a plugin (namespace root)
+      description:
+        "Dispatches GET requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    head:
+      operationId: x_plugins_by_plugin_notices_head
+      summary: Gateway HEAD notice to a plugin (namespace root)
+      description:
+        "Dispatches HEAD requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    options:
+      operationId: x_plugins_by_plugin_notices_options
+      summary: Gateway OPTIONS notice to a plugin (namespace root)
+      description:
+        "Dispatches OPTIONS requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    patch:
+      operationId: x_plugins_by_plugin_notices_patch
+      summary: Gateway PATCH notice to a plugin (namespace root)
+      description:
+        "Dispatches PATCH requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    post:
+      operationId: x_plugins_by_plugin_notices_post
+      summary: Gateway POST notice to a plugin (namespace root)
+      description:
+        "Dispatches POST requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    put:
+      operationId: x_plugins_by_plugin_notices_put
+      summary: Gateway PUT notice to a plugin (namespace root)
+      description:
+        "Dispatches PUT requests to the root handler of a plugin's reserved notices/ namespace. Served to the
+        gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+  /v1/x/plugins/{plugin}/notices/{path}:
+    delete:
+      operationId: x_plugins_by_plugin_notices_by_path_delete
+      summary: Gateway DELETE notice to a plugin
+      description:
+        "Dispatches DELETE requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    get:
+      operationId: x_plugins_by_plugin_notices_by_path_get
+      summary: Gateway GET notice to a plugin
+      description:
+        "Dispatches GET requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    head:
+      operationId: x_plugins_by_plugin_notices_by_path_head
+      summary: Gateway HEAD notice to a plugin
+      description:
+        "Dispatches HEAD requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    options:
+      operationId: x_plugins_by_plugin_notices_by_path_options
+      summary: Gateway OPTIONS notice to a plugin
+      description:
+        "Dispatches OPTIONS requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    patch:
+      operationId: x_plugins_by_plugin_notices_by_path_patch
+      summary: Gateway PATCH notice to a plugin
+      description:
+        "Dispatches PATCH requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    post:
+      operationId: x_plugins_by_plugin_notices_by_path_post
+      summary: Gateway POST notice to a plugin
+      description:
+        "Dispatches POST requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+    put:
+      operationId: x_plugins_by_plugin_notices_by_path_put
+      summary: Gateway PUT notice to a plugin
+      description:
+        "Dispatches PUT requests under a plugin's reserved notices/ namespace to that plugin's handler files.
+        Served to the gateway's service principal only: a notice is the gateway's own decision, never a client's."
+      tags:
+        - user-routes
+      parameters:
+        - name: plugin
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
 components:
   schemas:
     ConfigPatchRequest:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.12.0-staging.1",
+  "version": "0.12.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -44,6 +44,7 @@
     "@qdrant/js-client-rest": "1.17.0",
     "@resvg/resvg-js": "2.6.2",
     "@slack/types": "2.22.0",
+    "@vellumai/app-icons": "file:../packages/app-icons",
     "@vellumai/avatar-catalog": "file:../packages/avatar-catalog",
     "@vellumai/avatar-manifest": "file:../packages/avatar-manifest",
     "@vellumai/ces-client": "file:../packages/ces-client",
@@ -89,6 +90,7 @@
     "node": ">=20.12.0"
   },
   "bundledDependencies": [
+    "@vellumai/app-icons",
     "@vellumai/avatar-catalog",
     "@vellumai/avatar-manifest",
     "@vellumai/ces-client",

package/scripts/smoke-container-workspace-dependencies.ts

@@ -0,0 +1,19 @@
+type PackageManifest = {
+  dependencies?: Record<string, string>;
+};
+
+const manifest = (await Bun.file(
+  new URL("../package.json", import.meta.url),
+).json()) as PackageManifest;
+
+const workspaceDependencies = Object.entries(manifest.dependencies ?? {})
+  .filter(([, version]) => version.startsWith("workspace:"))
+  .map(([name]) => name)
+  .sort();
+
+for (const dependency of workspaceDependencies) {
+  const resolvedPath = Bun.resolveSync(dependency, import.meta.dir);
+  console.log(`${dependency}: ${resolvedPath}`);
+}
+
+console.log(`Resolved ${workspaceDependencies.length} workspace dependencies.`);