@vellumai/assistant 0.12.0 → 0.12.1-staging.1

package/src/cli/commands/credentials.help.ts

@@ -45,8 +45,12 @@ Examples:
         },
       ],
       helpText: `
-Lists all credentials in the vault. Each entry includes the same fields as
-"inspect" — scrubbed value, timestamps, policy, and metadata.
+Lists credentials from the live credential vault. Each entry includes the same
+fields as inspect: scrubbed value, timestamps, policy, and metadata.
+
+Fails immediately with an error if the credential vault is unreachable. An
+empty list means the vault answered and has no matching credentials, not that
+the store is down.
 
 The --search flag filters results by case-insensitive substring match against
 the credential's service name, field name, label, or description. For example, --search

package/src/cli/commands/credentials.ts

@@ -343,8 +343,8 @@ export function registerCredentialsCommand(program: Command): void {
           } else {
             printCredentialHuman(output);
             if (output.brokerUnreachable) {
-              log.info(
-                "    ⚠ Credential store is unreachable — ensure the assistant is running",
+              log.warn(
+                "    Credential store is unreachable. Retry in a moment, or check that the credential vault is running.",
               );
             }
           }

package/src/cli/commands/mcp.help.ts

@@ -7,8 +7,8 @@ export const mcpHelp: CliCommandHelp = {
   description: "Manage MCP (Model Context Protocol) servers",
   helpText: `
 MCP servers extend the assistant's capabilities with external tools. Servers
-are configured in the assistant's config.json under the mcp.servers key, or
-declared by an installed plugin in its root mcp.json. Each
+are configured in the assistant's mcp.json, or declared by an installed
+plugin in its root mcp.json. Each
 server uses one of three transport types:
 
   stdio             Local process communicating over stdin/stdout
@@ -30,8 +30,8 @@ Examples:
       options: [{ flags: "--json", description: "Output as JSON" }],
       helpText: `
 Shows each MCP server with its current status and configuration. Servers come
-from two places: the mcp.servers key in config.json, and the root mcp.json of
-any installed plugin that declares one.
+from two places: the workspace mcp.json, and the root mcp.json of any
+installed plugin that declares one.
 
   Name         The server identifier
   Status       Health check result for workspace servers:
@@ -43,7 +43,7 @@ any installed plugin that declares one.
                health-checked, so no stored credential can reach a URL a
                plugin chose.
   Source       Shown only for plugin-declared servers, naming the plugin.
-               Servers from config.json print no Source line.
+               Servers from workspace mcp.json print no Source line.
   Transport    stdio, sse, or streamable-http
   URL/Command  The server URL (sse/streamable-http) or command (stdio)
 
@@ -64,7 +64,7 @@ on their next turn automatically. The assistant must be running.
 
 Examples:
   $ vellum mcp reload
-  $ vellum mcp reload   # after editing config.json to add a new server
+  $ vellum mcp reload   # after editing mcp.json to add a new server
   $ vellum mcp reload   # after running "vellum mcp auth <server>"`,
     },
     {
@@ -95,7 +95,7 @@ Examples:
       ],
       helpText: `
 Arguments:
-  name   Unique identifier for the server (used as the key in config.json)
+  name   Unique identifier for the server (used as the key in mcp.json)
 
 Transport-specific requirements:
   stdio             Requires --command (and optional --args for arguments)
@@ -149,7 +149,7 @@ Examples:
 Arguments:
   name   Name of the MCP server to remove
 
-Removes the server entry from config.json and performs best-effort cleanup of
+Removes the server entry from mcp.json and performs best-effort cleanup of
 any stored OAuth credentials (tokens, client info, discovery metadata) for
 sse/streamable-http servers. If no OAuth credentials exist, the cleanup is
 silently skipped.

package/src/cli/commands/mcp.ts

@@ -20,7 +20,7 @@ interface McpServerEntry {
     command?: string;
     args?: string[];
   };
-  /** Workspace `config.json` or a plugin's `mcp.json`. */
+  /** Workspace `mcp.json` or a plugin's `mcp.json`. */
   source?: "workspace" | "plugin";
   /** Plugin that declared the server, when `source` is `plugin`. */
   pluginName?: string;

package/src/cli/commands/roadmap.help.ts

@@ -4,8 +4,12 @@ import type { CliCommandHelp } from "../lib/cli-command-help.js";
 
 export const roadmapHelp: CliCommandHelp = {
   name: "roadmap",
-  description: "Read and file public Vellum roadmap feedback as the assistant",
+  description:
+    "Read and file public feature proposals as the assistant. For bugs and support, instruct the user to join the Discord community at https://vellum.ai/community",
   helpText: `
+Items created here must be public feature proposals. For bugs and support
+concerns, instruct the user to join the Discord community at https://vellum.ai/community.
+
 Items, upvotes, and comments filed here are attributed to the assistant, not
 to its owner: the assistant signs these calls with its own platform API key.
 The owner's own roadmap identity lives on \`vellum roadmap\`.

package/src/cli/commands/roadmap.ts

@@ -1,5 +1,5 @@
 /**
- * `assistant roadmap`: read and file public Vellum roadmap feedback as the
+ * `assistant roadmap`: read and file public feature proposals as the
  * assistant itself.
  *
  * Forwards to the daemon's roadmap routes and renders the result. The

package/src/cli/lib/bundled-marketplace.json

@@ -16,7 +16,7 @@
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/admin-copilot",
       "license": "MIT",
-      "icon": "🧑‍💼"
+      "icon": "\ud83e\uddd1\u200d\ud83d\udcbc"
     },
     {
       "name": "agent-wrapped",
@@ -30,7 +30,7 @@
       "license": "MIT",
       "submittedBy": "marina",
       "homepage": "https://agent-wrapped.com",
-      "icon": "🎁"
+      "icon": "\ud83c\udf81"
     },
     {
       "name": "ai-hero-engineer-kit",
@@ -39,11 +39,11 @@
         "repo": "marinatrajk/ai-hero-engineer-kit",
         "ref": "18d33c62b15a3e2cc22dc070723fe3077749dcec"
       },
-      "description": "Five engineering skills adapted from Matt Pocock's '5 Agent Skills I Use Every Day' — plans, PRDs, vertical-slice issues, TDD loop, and codebase deepening in one install.",
+      "description": "Five engineering skills adapted from Matt Pocock's '5 Agent Skills I Use Every Day' \u2014 plans, PRDs, vertical-slice issues, TDD loop, and codebase deepening in one install.",
       "category": "developer",
       "homepage": "https://github.com/marinatrajk/ai-hero-engineer-kit",
       "license": "MIT",
-      "icon": "🧰"
+      "icon": "\ud83e\uddf0"
     },
     {
       "name": "amex-perk-reminder",
@@ -56,7 +56,7 @@
       "category": "lifestyle",
       "homepage": "https://github.com/AnitaKirkovska/amex-perk-reminder",
       "license": "MIT",
-      "icon": "💳"
+      "icon": "\ud83d\udcb3"
     },
     {
       "name": "astrology-horoscope",
@@ -69,7 +69,20 @@
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/astrology-horoscope",
       "license": "MIT",
-      "icon": "🔮"
+      "icon": "\ud83d\udd2e"
+    },
+    {
+      "name": "battleship",
+      "source": {
+        "source": "github",
+        "repo": "vellum-ai/battleship",
+        "ref": "32391ea3af71597b7507bb710bd29ab8308a4604"
+      },
+      "description": "Play Battleship against your assistant. Fire shots, track hits and misses, and sink the fleet before the assistant sinks yours.",
+      "category": "hobby",
+      "homepage": "https://github.com/vellum-ai/battleship",
+      "license": "MIT",
+      "icon": "\u2693"
     },
     {
       "name": "caveman",
@@ -82,7 +95,7 @@
       "category": "productivity",
       "homepage": "https://github.com/JuliusBrussee/caveman",
       "license": "MIT",
-      "icon": "🦴"
+      "icon": "\ud83e\uddb4"
     },
     {
       "name": "coffee-aficionado",
@@ -107,7 +120,7 @@
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/cofounder",
       "license": "MIT",
-      "icon": "🤝"
+      "icon": "\ud83e\udd1d"
     },
     {
       "name": "cognee",
@@ -120,7 +133,7 @@
       "description": "Cognee knowledge graph memory for Vellum Assistant: session-aware storage, auto-routing recall, and persistent learning across sessions. Supports local mode and Cognee Cloud.",
       "category": "memory",
       "homepage": "https://github.com/topoteretes/cognee-integrations/tree/main/integrations/vellum-assistant",
-      "icon": "🕸️"
+      "icon": "\ud83d\udd78\ufe0f"
     },
     {
       "name": "creatorland",
@@ -134,7 +147,7 @@
       "category": "marketing",
       "homepage": "https://github.com/creatorland/creatorland-mcp-skills/tree/main/plugins/creatorland-data",
       "license": "MIT",
-      "icon": "🎨"
+      "icon": "\ud83c\udfa8"
     },
     {
       "name": "dynamic-notch",
@@ -147,7 +160,7 @@
       "category": "interface",
       "homepage": "https://github.com/AnitaKirkovska/dynamic-notch",
       "license": "MIT",
-      "icon": "💻"
+      "icon": "\ud83d\udcbb"
     },
     {
       "name": "family-briefing",
@@ -160,7 +173,7 @@
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/family-briefing",
       "license": "MIT",
-      "icon": "👨‍👩‍👧‍👦"
+      "icon": "\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d\udc66"
     },
     {
       "name": "fitness-companion",
@@ -173,7 +186,7 @@
       "category": "health",
       "homepage": "https://github.com/vellum-ai/fitness-companion",
       "license": "MIT",
-      "icon": "💪"
+      "icon": "\ud83d\udcaa"
     },
     {
       "name": "git-workflow",
@@ -186,7 +199,7 @@
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/git-workflow",
       "license": "MIT",
-      "icon": "🔀"
+      "icon": "\ud83d\udd00"
     },
     {
       "name": "google-drive-search",
@@ -199,20 +212,7 @@
       "category": "productivity",
       "homepage": "https://github.com/ZeebBoyBlue/google-drive-search",
       "license": "Apache-2.0",
-      "icon": "🔍"
-    },
-    {
-      "name": "influencer-marketing",
-      "source": {
-        "source": "github",
-        "repo": "ZeebBoyBlue/influencer",
-        "ref": "8629b0dcfdacf62246122af2dcd7320baa6db04e"
-      },
-      "description": "Find and research influencers on Instagram, TikTok, and X/Twitter. Includes a strategy builder that walks from campaign brief to research criteria, a research skill that discovers real profiles via browser automation, scores candidates, and exports ranked shortlists, and a dashboard skill that turns the shortlist into an interactive outreach tracker.",
-      "category": "marketing",
-      "homepage": "https://github.com/ZeebBoyBlue/influencer",
-      "license": "MIT",
-      "icon": "📣"
+      "icon": "\ud83d\udd0d"
     },
     {
       "name": "imessage",
@@ -225,7 +225,20 @@
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/imessage",
       "license": "MIT",
-      "icon": "📲"
+      "icon": "\ud83d\udcf2"
+    },
+    {
+      "name": "influencer-marketing",
+      "source": {
+        "source": "github",
+        "repo": "ZeebBoyBlue/influencer",
+        "ref": "8629b0dcfdacf62246122af2dcd7320baa6db04e"
+      },
+      "description": "Find and research influencers on Instagram, TikTok, and X/Twitter. Includes a strategy builder that walks from campaign brief to research criteria, a research skill that discovers real profiles via browser automation, scores candidates, and exports ranked shortlists, and a dashboard skill that turns the shortlist into an interactive outreach tracker.",
+      "category": "marketing",
+      "homepage": "https://github.com/ZeebBoyBlue/influencer",
+      "license": "MIT",
+      "icon": "\ud83d\udce3"
     },
     {
       "name": "kitchen-companion",
@@ -238,7 +251,20 @@
       "category": "lifestyle",
       "homepage": "https://github.com/vellum-ai/kitchen-companion",
       "license": "MIT",
-      "icon": "🍳"
+      "icon": "\ud83c\udf73"
+    },
+    {
+      "name": "ledger",
+      "source": {
+        "source": "github",
+        "repo": "simensgreen/ledger",
+        "ref": "7fc04fd77b20ad4b27ccd51be22c101274b370f6"
+      },
+      "description": "Structured storage for Vellum agents: tables via JSON Schema, query/aggregate via JSON, named saved queries.",
+      "category": "developer",
+      "homepage": "https://github.com/simensgreen/ledger",
+      "license": "MIT",
+      "icon": "\ud83d\uddc4\ufe0f"
     },
     {
       "name": "level-up",
@@ -251,7 +277,7 @@
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/level-up",
       "license": "MIT",
-      "icon": "🆙"
+      "icon": "\ud83c\udd99"
     },
     {
       "name": "marketing-expert",
@@ -264,7 +290,7 @@
       "category": "marketing",
       "homepage": "https://github.com/vellum-ai/marketing-expert",
       "license": "MIT",
-      "icon": "📈"
+      "icon": "\ud83d\udcc8"
     },
     {
       "name": "markitdown-vellum",
@@ -273,11 +299,11 @@
         "repo": "simensgreen/markitdown-vellum",
         "ref": "5e5a4ecfd6c60d613778106442003a1ed302fc3c"
       },
-      "description": "Convert workspace documents (PDF, DOCX, PPTX, XLSX, images, MSG, …) to markdown via @cognipeer/to-markdown, with Vellum vision OCR or Tesseract.",
+      "description": "Convert workspace documents (PDF, DOCX, PPTX, XLSX, images, MSG, \u2026) to markdown via @cognipeer/to-markdown, with Vellum vision OCR or Tesseract.",
       "category": "productivity",
       "homepage": "https://github.com/simensgreen/markitdown-vellum",
       "license": "MIT",
-      "icon": "📄"
+      "icon": "\ud83d\udcc4"
     },
     {
       "name": "model-router",
@@ -290,7 +316,7 @@
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/model-router",
       "license": "MIT",
-      "icon": "🚦"
+      "icon": "\ud83d\udea6"
     },
     {
       "name": "motion-design",
@@ -303,7 +329,7 @@
       "category": "creative",
       "homepage": "https://github.com/vellum-ai/motion-design",
       "license": "MIT",
-      "icon": "🎬"
+      "icon": "\ud83c\udfac"
     },
     {
       "name": "natural",
@@ -316,7 +342,19 @@
       "category": "finance",
       "homepage": "https://www.natural.com",
       "license": "MIT",
-      "icon": "💳"
+      "icon": "\ud83d\udcb3"
+    },
+    {
+      "name": "octolens",
+      "source": {
+        "source": "github",
+        "repo": "vellum-ai/octolens",
+        "ref": "d9117f5c6b97b3bff75dec1a04bedc32571c6538"
+      },
+      "description": "Social listening plugin for Octolens. Monitor brand mentions, competitor activity, and industry conversations across 13+ platforms. Query mentions, run analytics, manage keywords and feeds via REST API tools, or connect the Octolens MCP server for natural-language workflows.",
+      "category": "growth",
+      "homepage": "https://github.com/vellum-ai/octolens",
+      "license": "MIT"
     },
     {
       "name": "openseo",
@@ -330,7 +368,7 @@
       "category": "marketing",
       "homepage": "https://openseo.so",
       "license": "MIT",
-      "icon": "🔎"
+      "icon": "\ud83d\udd0e"
     },
     {
       "name": "originkit",
@@ -343,7 +381,7 @@
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/originkit",
       "license": "MIT",
-      "icon": "🧱"
+      "icon": "\ud83e\uddf1"
     },
     {
       "name": "personal-finance",
@@ -356,7 +394,7 @@
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/personal-finance",
       "license": "MIT",
-      "icon": "💰"
+      "icon": "\ud83d\udcb0"
     },
     {
       "name": "plant-doctor",
@@ -369,7 +407,7 @@
       "category": "lifestyle",
       "homepage": "https://github.com/vellum-ai/plant-doctor",
       "license": "MIT",
-      "icon": "🪴"
+      "icon": "\ud83e\udeb4"
     },
     {
       "name": "polyglot",
@@ -382,7 +420,7 @@
       "category": "education",
       "homepage": "https://github.com/vellum-ai/polyglot",
       "license": "MIT",
-      "icon": "🗣️"
+      "icon": "\ud83d\udde3\ufe0f"
     },
     {
       "name": "proactive-slacks",
@@ -395,7 +433,7 @@
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/proactive-slacks",
       "license": "MIT",
-      "icon": "💬"
+      "icon": "\ud83d\udcac"
     },
     {
       "name": "reading-pal",
@@ -408,7 +446,20 @@
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/reading-pal",
       "license": "MIT",
-      "icon": "📚"
+      "icon": "\ud83d\udcda"
+    },
+    {
+      "name": "restaurant-invoice-auditor",
+      "description": "Audits restaurant food delivery slips in 14 seconds, flags silent price hikes and pack-size shrinkage, and stages approved bills in QuickBooks.",
+      "category": "commerce",
+      "icon": "\ud83e\uddfe",
+      "license": "MIT",
+      "homepage": "https://github.com/ZeebBoyBlue/restaurant-invoice-auditor",
+      "source": {
+        "source": "github",
+        "repo": "ZeebBoyBlue/restaurant-invoice-auditor",
+        "ref": "f1905e639941e98172c5032b6d722f668882d75d"
+      }
     },
     {
       "name": "simple-memory",
@@ -421,7 +472,7 @@
       "category": "memory",
       "homepage": "https://github.com/vellum-ai/simple-memory",
       "license": "MIT",
-      "icon": "🧠"
+      "icon": "\ud83e\udde0"
     },
     {
       "name": "smb-inbox-brief",
@@ -434,7 +485,7 @@
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/smb-inbox-brief",
       "license": "MIT",
-      "icon": "📧"
+      "icon": "\ud83d\udce7"
     },
     {
       "name": "tennis-companion",
@@ -447,7 +498,7 @@
       "category": "health",
       "homepage": "https://github.com/vellum-ai/tennis-companion",
       "license": "MIT",
-      "icon": "🎾"
+      "icon": "\ud83c\udfbe"
     },
     {
       "name": "travel-planner",
@@ -460,7 +511,7 @@
       "category": "lifestyle",
       "homepage": "https://github.com/AnitaKirkovska/travel-planner",
       "license": "MIT",
-      "icon": "✈️"
+      "icon": "\u2708\ufe0f"
     },
     {
       "name": "unabyss",
@@ -473,7 +524,7 @@
       "category": "memory",
       "homepage": "https://unabyss.com",
       "license": "MIT",
-      "icon": "🌊"
+      "icon": "\ud83c\udf0a"
     },
     {
       "name": "vellum-client-qa",
@@ -486,20 +537,7 @@
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/vellum-client-qa",
       "license": "MIT",
-      "icon": "🧪"
-    },
-    {
-      "name": "ledger",
-      "source": {
-        "source": "github",
-        "repo": "simensgreen/ledger",
-        "ref": "7fc04fd77b20ad4b27ccd51be22c101274b370f6"
-      },
-      "description": "Structured storage for Vellum agents: tables via JSON Schema, query/aggregate via JSON, named saved queries.",
-      "category": "developer",
-      "homepage": "https://github.com/simensgreen/ledger",
-      "license": "MIT",
-      "icon": "🗄️"
+      "icon": "\ud83e\uddea"
     },
     {
       "name": "virlo",
@@ -513,7 +551,7 @@
       "category": "marketing",
       "homepage": "https://github.com/Virlo-AI/virlo-integrations/tree/main/integrations/vellum",
       "license": "MIT",
-      "icon": "📱"
+      "icon": "\ud83d\udcf1"
     },
     {
       "name": "writing-coach",
@@ -526,32 +564,7 @@
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/writing-coach",
       "license": "MIT",
-      "icon": "✍️"
-    },
-    {
-      "name": "battleship",
-      "source": {
-        "source": "github",
-        "repo": "vellum-ai/battleship",
-        "ref": "32391ea3af71597b7507bb710bd29ab8308a4604"
-      },
-      "description": "Play Battleship against your assistant. Fire shots, track hits and misses, and sink the fleet before the assistant sinks yours.",
-      "category": "hobby",
-      "homepage": "https://github.com/vellum-ai/battleship",
-      "license": "MIT",
-      "icon": "⚓"
-    },
-    {
-      "name": "octolens",
-      "source": {
-        "source": "github",
-        "repo": "vellum-ai/octolens",
-        "ref": "d9117f5c6b97b3bff75dec1a04bedc32571c6538"
-      },
-      "description": "Social listening plugin for Octolens. Monitor brand mentions, competitor activity, and industry conversations across 13+ platforms. Query mentions, run analytics, manage keywords and feeds via REST API tools, or connect the Octolens MCP server for natural-language workflows.",
-      "category": "growth",
-      "homepage": "https://github.com/vellum-ai/octolens",
-      "license": "MIT"
+      "icon": "\u270d\ufe0f"
     }
   ]
 }

package/src/config/__tests__/default-profile-catalog.test.ts

@@ -540,6 +540,28 @@ describe("resolveDefaultProfileForProvider", () => {
     expect(entry).toBe(workspace.balanced);
   });
 
+  // Google limits gemini-2.5-flash-lite to grandfathered accounts (other API
+  // keys get HTTP 404 "no longer available to new users"), so a default
+  // profile resolving to it lists as available and fails every request on a
+  // fresh BYOK key.
+  test("gemini BYOK defaults never resolve to a model Google refuses new keys", () => {
+    const budget = resolveDefaultProfileForProvider(
+      managedStubs(),
+      "cost-optimized",
+      dp("gemini"),
+    );
+    expect(budget?.provider).toBe("gemini");
+    expect(budget?.model).toBe("gemini-3.1-flash-lite");
+    for (const key of DEFAULT_PROFILE_KEYS) {
+      const entry = resolveDefaultProfileForProvider(
+        managedStubs(),
+        key,
+        dp("gemini"),
+      );
+      expect(entry?.model).not.toBe("gemini-2.5-flash-lite");
+    }
+  });
+
   test("a managed-source stub contributes only label/status/topP over the provider-resolved body", () => {
     const workspace: Record<string, ProfileEntry> = {
       balanced: {

package/src/config/__tests__/memory-retrospective-schema.test.ts

@@ -12,9 +12,10 @@ import { describe, expect, test } from "bun:test";
 import { MemoryRetrospectiveConfigSchema } from "../schemas/memory-retrospective.js";
 
 describe("memory.retrospective config schema", () => {
-  test("an empty block leaves retrospectives on", () => {
+  test("an empty block leaves retrospectives and skill improvement on", () => {
     const parsed = MemoryRetrospectiveConfigSchema.parse({});
     expect(parsed.enabled).toBe(true);
+    expect(parsed.skillImprovement).toBe(true);
     expect(parsed).not.toHaveProperty("forkStrategy");
   });
 
@@ -27,6 +28,19 @@ describe("memory.retrospective config schema", () => {
     ).toBe(false);
   });
 
+  test("skillImprovement is an independent boolean-only authoring switch", () => {
+    const parsed = MemoryRetrospectiveConfigSchema.parse({
+      skillImprovement: false,
+    });
+    expect(parsed.enabled).toBe(true);
+    expect(parsed.skillImprovement).toBe(false);
+    expect(
+      MemoryRetrospectiveConfigSchema.safeParse({
+        skillImprovement: "false",
+      }).success,
+    ).toBe(false);
+  });
+
   test("a leftover forkStrategy key is ignored", () => {
     const parsed = MemoryRetrospectiveConfigSchema.parse({
       forkStrategy: "cloning",