@vellumai/assistant 0.12.5 → 0.12.6-dev.202609292019.a6f6d85

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.12.5
+  version: 0.12.6
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -6025,6 +6025,7 @@ paths:
                     - minimax
                     - atlascloud
                     - baseten
+                    - ionet
                     - poolside
                 connectionName:
                   type: string
@@ -8042,8 +8043,9 @@ paths:
             Filter by conversation type. Pass "background" to list background and scheduled conversations together (the
             back-compat umbrella), "scheduled" to list only scheduled conversations, or "all" for the union of the
             standard listing and that umbrella, so one paginated cursor spans every type. Combine "all" with
-            archiveStatus=all for a whole-history read; rows are recency-ordered (COALESCE(last_message_at, updated_at)
-            descending) like every other list read, and pinned rows are never appended to it.
+            archiveStatus=all for a whole-history read; rows are ordered by last activity (the later of the last message
+            and the time the row was marked done, descending) like every other list read, and pinned rows are never
+            appended to it.
         - name: archiveStatus
           in: query
           required: false
@@ -8083,8 +8085,9 @@ paths:
           description:
             Filter to a single group, so each sidebar section can load independently of the paginated list. Pass
             "system:all" for conversations in no group, "system:pinned" for the Pinned section, or a custom group id. A
-            group-scoped request is recency-ordered like every list read (COALESCE(last_message_at, updated_at)
-            descending) and never has pinned rows appended to it. Omit to span every group.
+            group-scoped request is ordered by last activity like every list read (the later of the last message and the
+            time the row was marked done, descending) and never has pinned rows appended to it. Omit to span every
+            group.
         - name: needsAttention
           in: query
           required: false
@@ -8340,10 +8343,14 @@ paths:
                         - sortPosition
                         - isSystemGroup
                       additionalProperties: false
+                  orderedBy:
+                    type: string
+                    const: lastActivity
                 required:
                   - conversations
                   - nextOffset
                   - hasMore
+                  - orderedBy
                 additionalProperties: false
     post:
       operationId: conversations_post
@@ -12482,6 +12489,9 @@ paths:
                           type: number
                         updatedAt:
                           type: number
+                        revision:
+                          description: Bumped by one on every write. Absent from assistants that predate document revisions.
+                          type: number
                       required:
                         - surfaceId
                         - conversationId
@@ -12496,7 +12506,10 @@ paths:
     post:
       operationId: documents_post
       summary: Save a document
-      description: Create or upsert a document (by surfaceId).
+      description:
+        Create or upsert a document (by surfaceId). With `baseRevision`, an existing document is only overwritten
+        while its revision still equals `baseRevision`; otherwise the save is rejected with 409 CONFLICT and
+        `error.details` carries the current `revision`, `title`, and `content`.
       tags:
         - documents
       requestBody:
@@ -12521,6 +12534,13 @@ paths:
                 wordCount:
                   type: number
                   description: Word count
+                baseRevision:
+                  description:
+                    The revision this save was edited from. When set and the stored revision differs, nothing is written and
+                    the request fails with 409. Omit for an unconditional write.
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
               required:
                 - surfaceId
                 - conversationId
@@ -12540,6 +12560,9 @@ paths:
                     const: true
                   surfaceId:
                     type: string
+                  revision:
+                    description: The document's revision after the save. Absent from assistants that predate document revisions.
+                    type: number
                 required:
                   - success
                   - surfaceId
@@ -12581,6 +12604,9 @@ paths:
                     type: number
                   updatedAt:
                     type: number
+                  revision:
+                    description: Bumped by one on every write. Absent from assistants that predate document revisions.
+                    type: number
                 required:
                   - success
                   - surfaceId
@@ -13007,6 +13033,157 @@ paths:
               schema:
                 type: string
                 format: binary
+  /v1/documents/{id}/revisions:
+    get:
+      operationId: documents_by_id_revisions_get
+      summary: List a document's revisions
+      description: Return the document's history snapshots, newest first, without their content.
+      tags:
+        - documents
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  revisions:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        revision:
+                          type: number
+                          description: The document revision this snapshot holds
+                        author:
+                          type: string
+                          enum:
+                            - user
+                            - assistant
+                          description: Who made the edit that replaced this state
+                        createdAt:
+                          type: number
+                          description: When the snapshot was taken
+                        wordCount:
+                          type: number
+                        title:
+                          type: string
+                      required:
+                        - revision
+                        - author
+                        - createdAt
+                        - wordCount
+                        - title
+                      additionalProperties: false
+                required:
+                  - revisions
+                additionalProperties: false
+  /v1/documents/{id}/revisions/{revision}:
+    get:
+      operationId: documents_by_id_revisions_by_revision_get
+      summary: Get a document revision
+      description: Return one history snapshot with its content.
+      tags:
+        - documents
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: revision
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  revision:
+                    type: number
+                    description: The document revision this snapshot holds
+                  author:
+                    type: string
+                    enum:
+                      - user
+                      - assistant
+                    description: Who made the edit that replaced this state
+                  createdAt:
+                    type: number
+                    description: When the snapshot was taken
+                  wordCount:
+                    type: number
+                  title:
+                    type: string
+                  content:
+                    type: string
+                required:
+                  - revision
+                  - author
+                  - createdAt
+                  - wordCount
+                  - title
+                  - content
+                additionalProperties: false
+  /v1/documents/{id}/revisions/{revision}/restore:
+    post:
+      operationId: documents_by_id_revisions_by_revision_restore_post
+      summary: Restore a document revision
+      description:
+        Write a snapshot's title and content back as a new revision. The current state is snapshotted first, so the
+        restore can itself be undone.
+      tags:
+        - documents
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: revision
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                  surfaceId:
+                    type: string
+                  revision:
+                    type: number
+                    description: The document's revision after the restore
+                  title:
+                    type: string
+                  content:
+                    type: string
+                required:
+                  - success
+                  - surfaceId
+                  - revision
+                  - title
+                  - content
+                additionalProperties: false
   /v1/documents/create:
     post:
       operationId: documents_create_post
@@ -13053,6 +13230,9 @@ paths:
                     type: number
                   updatedAt:
                     type: number
+                  revision:
+                    description: Bumped by one on every write. Absent from assistants that predate document revisions.
+                    type: number
                 required:
                   - success
                   - surfaceId
@@ -14289,6 +14469,8 @@ paths:
                         type: boolean
                       appPins:
                         type: boolean
+                      chatsSettings:
+                        type: boolean
                     required:
                       - memoryOptOut
                       - retryLastTurn
@@ -14523,6 +14705,8 @@ paths:
                         type: boolean
                       appPins:
                         type: boolean
+                      chatsSettings:
+                        type: boolean
                     required:
                       - memoryOptOut
                       - retryLastTurn
@@ -16790,8 +16974,8 @@ paths:
             type: string
           description:
             "Filter by provider id. One of: anthropic, openai, gemini, ollama, fireworks, together, openrouter,
-            vercel-ai-gateway, litellm, opencode, openai-compatible, minimax, atlascloud, baseten, poolside, typesafe,
-            vellum"
+            vercel-ai-gateway, litellm, opencode, openai-compatible, minimax, atlascloud, baseten, ionet, poolside,
+            typesafe, vellum"
       responses:
         "200":
           description: Successful response
@@ -17063,8 +17247,8 @@ paths:
             type: string
           description:
             "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, together, openrouter,
-            vercel-ai-gateway, litellm, opencode, openai-compatible, minimax, atlascloud, baseten, poolside, typesafe,
-            vellum, chatgpt"
+            vercel-ai-gateway, litellm, opencode, openai-compatible, minimax, atlascloud, baseten, ionet, poolside,
+            typesafe, vellum, chatgpt"
       responses:
         "200":
           description: Successful response
@@ -21395,6 +21579,7 @@ paths:
                                           - searxng
                                           - tinyfish
                                           - exa
+                                          - serply
                                       resultCount:
                                         type: number
                                       durationMs:
@@ -22014,6 +22199,7 @@ paths:
                                                   - searxng
                                                   - tinyfish
                                                   - exa
+                                                  - serply
                                               resultCount:
                                                 type: number
                                               durationMs:
@@ -38554,6 +38740,41 @@ components:
     ConfigPatchRequest:
       type: object
       properties:
+        conversations:
+          anyOf:
+            - type: object
+              properties:
+                autoArchive:
+                  anyOf:
+                    - type: object
+                      properties:
+                        enabled:
+                          anyOf:
+                            - type: boolean
+                            - type: "null"
+                        afterDays:
+                          anyOf:
+                            - type: number
+                              enum:
+                                - 1
+                                - 7
+                                - 14
+                                - 30
+                            - type: "null"
+                      additionalProperties: {}
+                    - type: "null"
+              additionalProperties: {}
+            - type: "null"
+        notifications:
+          anyOf:
+            - type: object
+              properties:
+                newMessageEnabled:
+                  anyOf:
+                    - type: boolean
+                    - type: "null"
+              additionalProperties: {}
+            - type: "null"
         llm:
           type: object
           properties:
@@ -39205,6 +39426,7 @@ components:
         - minimax
         - atlascloud
         - baseten
+        - ionet
         - poolside
         - typesafe
         - vellum
@@ -39287,6 +39509,42 @@ components:
     ConfigGetResponse:
       type: object
       properties:
+        conversations:
+          type: object
+          properties:
+            autoArchive:
+              type: object
+              properties:
+                enabled:
+                  default: false
+                  description: Automatically mark eligible inactive chats Done.
+                  type: boolean
+                afterDays:
+                  default: 7
+                  description: Elapsed days of inactivity before a chat is eligible for Done.
+                  type: number
+                  enum:
+                    - 1
+                    - 7
+                    - 14
+                    - 30
+              required:
+                - enabled
+                - afterDays
+              additionalProperties: {}
+          required:
+            - autoArchive
+          additionalProperties: {}
+        notifications:
+          type: object
+          properties:
+            newMessageEnabled:
+              default: true
+              description: Allow ordinary chat-reply alerts. Does not change unread state or action-required alerts.
+              type: boolean
+          required:
+            - newMessageEnabled
+          additionalProperties: {}
         llm:
           type: object
           properties:
@@ -39433,6 +39691,7 @@ components:
                     - minimax
                     - atlascloud
                     - baseten
+                    - ionet
                     - poolside
                 connectionName:
                   type: string
@@ -39821,6 +40080,7 @@ components:
                 - minimax
                 - atlascloud
                 - baseten
+                - ionet
                 - poolside
             - type: "null"
         connectionName:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.12.5",
+  "version": "0.12.6-dev.202609292019.a6f6d85",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/agent-loop.test.ts

@@ -181,6 +181,82 @@ describe("AgentLoop", () => {
     expect(calls[1].options?.config?.overrideProfile).toBe("quality-optimized");
   });
 
+  test("the auto origin follows the routed override and drops once a switch replaces it", async () => {
+    const toolCallId = "tool-1";
+    const { provider, calls } = createMockProvider([
+      toolUseResponse(toolCallId, "read_file", { path: "/tmp/test.txt" }),
+      textResponse("done"),
+    ]);
+    let overrideProfile = "quality-optimized";
+    const loop = new AgentLoop({
+      provider: provider,
+      systemPrompt: "system",
+      conversationId: "test-conversation",
+      tools: dummyTools,
+      toolExecutor: async () => {
+        // A confirmed profile session mid-turn: the user's pick, not Auto's.
+        overrideProfile = "cost-optimized";
+        return { content: "ok", isError: false };
+      },
+    });
+
+    await loop.run({
+      messages: [userMessage],
+      onEvent: collectEvents([]),
+      trust: { sourceChannel: "vellum", trustClass: "unknown" },
+      requestId: "req-1",
+      callSite: "mainAgent",
+      overrideProfile: "quality-optimized",
+      overrideProfileOrigin: "auto",
+      resolveOverrideProfile: () => overrideProfile,
+    });
+
+    expect(calls).toHaveLength(2);
+    expect(calls[0].options?.config?.overrideProfile).toBe("quality-optimized");
+    expect(calls[0].options?.config?.overrideProfileOrigin).toBe("auto");
+    expect(calls[1].options?.config?.overrideProfile).toBe("cost-optimized");
+    expect(calls[1].options?.config?.overrideProfileOrigin).toBeUndefined();
+  });
+
+  test("a pre-model-call hook keeps the auto origin unless it changes the profile", async () => {
+    let hookProfile: string | null | undefined;
+    registerPlugin({
+      manifest: { name: "profile-hook", version: "0.0.1" },
+      hooks: {
+        "pre-model-call": async (ctx) =>
+          hookProfile === undefined
+            ? ctx
+            : { ...ctx, modelProfile: hookProfile },
+      },
+    });
+    const run = async () => {
+      const { provider, calls } = createMockProvider([textResponse("ok")]);
+      const loop = new AgentLoop({
+        provider: provider,
+        systemPrompt: "system",
+        conversationId: "test-conversation",
+        tools: dummyTools,
+      });
+      await loop.run({
+        messages: [userMessage],
+        onEvent: collectEvents([]),
+        trust: { sourceChannel: "vellum", trustClass: "unknown" },
+        requestId: "req-1",
+        callSite: "mainAgent",
+        overrideProfile: "quality-optimized",
+        overrideProfileOrigin: "auto",
+      });
+      return calls[0].options?.config;
+    };
+
+    hookProfile = undefined;
+    expect((await run())?.overrideProfileOrigin).toBe("auto");
+    hookProfile = "cost-optimized";
+    expect((await run())?.overrideProfileOrigin).toBeUndefined();
+    hookProfile = null;
+    expect((await run())?.overrideProfileOrigin).toBeUndefined();
+  });
+
   test("re-resolves max input tokens before truncating tool results", async () => {
     const toolCallId = "tool-1";
     const toolOutput = "x".repeat(2_500);

package/src/__tests__/anthropic-provider.test.ts

@@ -3653,6 +3653,8 @@ describe("AnthropicProvider — deprecated sampling params (temperature / top_p
     "claude-opus-4-7",
     "claude-sonnet-5",
     "anthropic/claude-sonnet-5",
+    "claude-sonnet-5-5",
+    "anthropic/claude-sonnet-5.5",
     "claude-fable-5",
     "claude-fable-5-1",
     "anthropic/claude-fable-5.1",

package/src/__tests__/byok-default-profile-ensure.test.ts

@@ -302,6 +302,13 @@ describe("ensureByokDefaultProfiles", () => {
       "cost-optimized",
       "accounts/fireworks/models/deepseek-v4-flash",
     ],
+    [
+      "fireworks",
+      "cost-optimized",
+      "accounts/fireworks/models/deepseek-v4-flash-0731",
+    ],
+    ["fireworks", "balanced", "accounts/fireworks/models/deepseek-v4p1-flash"],
+    ["fireworks", "quality-optimized", "accounts/fireworks/models/kimi-k2p6"],
   ] as const)(
     "a historical intent-era copy converts (%s %s pinned to %s)",
     (provider, key, model) => {

package/src/__tests__/config-get-vision-flag.test.ts

@@ -40,7 +40,7 @@ describe("GET /v1/config profile vision enrichment", () => {
     seedProfiles({
       "test-no-vision": {
         provider: "fireworks",
-        model: "accounts/fireworks/models/glm-5p2",
+        model: "accounts/fireworks/models/glm-5p3",
       },
     });
 

package/src/__tests__/config-loader-validation-reset-notice.test.ts

@@ -171,7 +171,7 @@ describe("config-validation-reset notice sentinel", () => {
             profiles: {
               "glm-default": {
                 provider: "vellum",
-                model: "accounts/fireworks/models/glm-5p2",
+                model: "accounts/fireworks/models/glm-5p3",
               },
             },
             activeProfile: "glm-default",
@@ -193,7 +193,7 @@ describe("config-validation-reset notice sentinel", () => {
     expect(config.llm.activeProfile).toBe("glm-default");
     expect(config.llm.callSites.mainAgent?.profile).toBe("glm-default");
     expect(config.llm.profiles["glm-default"]?.model).toBe(
-      "accounts/fireworks/models/glm-5p2",
+      "accounts/fireworks/models/glm-5p3",
     );
   });