@vellumai/assistant 0.6.3 → 0.6.5

package/src/config/bundled-tool-registry.ts

@@ -22,23 +22,6 @@ import * as appCreate from "./bundled-skills/app-builder/tools/app-create.js";
 import * as appDelete from "./bundled-skills/app-builder/tools/app-delete.js";
 import * as appGenerateIcon from "./bundled-skills/app-builder/tools/app-generate-icon.js";
 import * as appRefresh from "./bundled-skills/app-builder/tools/app-refresh.js";
-// ── browser ────────────────────────────────────────────────────────────────────
-import * as browserClick from "./bundled-skills/browser/tools/browser-click.js";
-import * as browserClose from "./bundled-skills/browser/tools/browser-close.js";
-import * as browserExtract from "./bundled-skills/browser/tools/browser-extract.js";
-import * as browserFillCredential from "./bundled-skills/browser/tools/browser-fill-credential.js";
-import * as browserHover from "./bundled-skills/browser/tools/browser-hover.js";
-import * as browserNavigate from "./bundled-skills/browser/tools/browser-navigate.js";
-import * as browserPressKey from "./bundled-skills/browser/tools/browser-press-key.js";
-import * as browserScreenshot from "./bundled-skills/browser/tools/browser-screenshot.js";
-import * as browserScroll from "./bundled-skills/browser/tools/browser-scroll.js";
-import * as browserSelectOption from "./bundled-skills/browser/tools/browser-select-option.js";
-import * as browserSnapshot from "./bundled-skills/browser/tools/browser-snapshot.js";
-import * as browserType from "./bundled-skills/browser/tools/browser-type.js";
-import * as browserWaitFor from "./bundled-skills/browser/tools/browser-wait-for.js";
-import * as browserWaitForDownload from "./bundled-skills/browser/tools/browser-wait-for-download.js";
-// ── chatgpt-import ─────────────────────────────────────────────────────────────
-import * as chatgptImport from "./bundled-skills/chatgpt-import/tools/chatgpt-import.js";
 // ── computer-use ───────────────────────────────────────────────────────────────
 import * as computerUseClick from "./bundled-skills/computer-use/tools/computer-use-click.js";
 import * as computerUseDone from "./bundled-skills/computer-use/tools/computer-use-done.js";
@@ -65,26 +48,6 @@ import * as documentUpdate from "./bundled-skills/document/tools/document-update
 import * as followupCreate from "./bundled-skills/followups/tools/followup-create.js";
 import * as followupList from "./bundled-skills/followups/tools/followup-list.js";
 import * as followupResolve from "./bundled-skills/followups/tools/followup-resolve.js";
-// ── gmail ──────────────────────────────────────────────────────────────────────
-import * as gmailArchive from "./bundled-skills/gmail/tools/gmail-archive.js";
-import * as gmailAttachments from "./bundled-skills/gmail/tools/gmail-attachments.js";
-import * as gmailDraft from "./bundled-skills/gmail/tools/gmail-draft.js";
-import * as gmailFilters from "./bundled-skills/gmail/tools/gmail-filters.js";
-import * as gmailFollowUp from "./bundled-skills/gmail/tools/gmail-follow-up.js";
-import * as gmailForward from "./bundled-skills/gmail/tools/gmail-forward.js";
-import * as gmailLabel from "./bundled-skills/gmail/tools/gmail-label.js";
-import * as gmailOutreachScan from "./bundled-skills/gmail/tools/gmail-outreach-scan.js";
-import * as gmailSendDraft from "./bundled-skills/gmail/tools/gmail-send-draft.js";
-import * as gmailSenderDigest from "./bundled-skills/gmail/tools/gmail-sender-digest.js";
-import * as gmailTrash from "./bundled-skills/gmail/tools/gmail-trash.js";
-import * as gmailUnsubscribe from "./bundled-skills/gmail/tools/gmail-unsubscribe.js";
-import * as gmailVacation from "./bundled-skills/gmail/tools/gmail-vacation.js";
-// ── google-calendar ────────────────────────────────────────────────────────────
-import * as calendarCheckAvailability from "./bundled-skills/google-calendar/tools/calendar-check-availability.js";
-import * as calendarCreateEvent from "./bundled-skills/google-calendar/tools/calendar-create-event.js";
-import * as calendarGetEvent from "./bundled-skills/google-calendar/tools/calendar-get-event.js";
-import * as calendarListEvents from "./bundled-skills/google-calendar/tools/calendar-list-events.js";
-import * as calendarRsvp from "./bundled-skills/google-calendar/tools/calendar-rsvp.js";
 // ── image-studio ───────────────────────────────────────────────────────────────
 import * as mediaGenerateImage from "./bundled-skills/image-studio/tools/media-generate-image.js";
 // ── media-processing ───────────────────────────────────────────────────────────
@@ -107,25 +70,6 @@ import * as messagingSend from "./bundled-skills/messaging/tools/messaging-send.
 import * as messagingSenderDigest from "./bundled-skills/messaging/tools/messaging-sender-digest.js";
 // ── notifications ──────────────────────────────────────────────────────────────
 import * as sendNotification from "./bundled-skills/notifications/tools/send-notification.js";
-// ── outlook ────────────────────────────────────────────────────────────────────
-import * as outlookAttachments from "./bundled-skills/outlook/tools/outlook-attachments.js";
-import * as outlookCategories from "./bundled-skills/outlook/tools/outlook-categories.js";
-import * as outlookDraft from "./bundled-skills/outlook/tools/outlook-draft.js";
-import * as outlookFollowUp from "./bundled-skills/outlook/tools/outlook-follow-up.js";
-import * as outlookForward from "./bundled-skills/outlook/tools/outlook-forward.js";
-import * as outlookOutreachScan from "./bundled-skills/outlook/tools/outlook-outreach-scan.js";
-import * as outlookRules from "./bundled-skills/outlook/tools/outlook-rules.js";
-import * as outlookSendDraft from "./bundled-skills/outlook/tools/outlook-send-draft.js";
-import * as outlookSenderDigest from "./bundled-skills/outlook/tools/outlook-sender-digest.js";
-import * as outlookTrash from "./bundled-skills/outlook/tools/outlook-trash.js";
-import * as outlookUnsubscribe from "./bundled-skills/outlook/tools/outlook-unsubscribe.js";
-import * as outlookVacation from "./bundled-skills/outlook/tools/outlook-vacation.js";
-// ── outlook-calendar ───────────────────────────────────────────────────────────
-import * as outlookCalendarCheckAvailability from "./bundled-skills/outlook-calendar/tools/outlook-calendar-check-availability.js";
-import * as outlookCalendarCreateEvent from "./bundled-skills/outlook-calendar/tools/outlook-calendar-create-event.js";
-import * as outlookCalendarGetEvent from "./bundled-skills/outlook-calendar/tools/outlook-calendar-get-event.js";
-import * as outlookCalendarListEvents from "./bundled-skills/outlook-calendar/tools/outlook-calendar-list-events.js";
-import * as outlookCalendarRsvp from "./bundled-skills/outlook-calendar/tools/outlook-calendar-rsvp.js";
 // ── phone-calls ────────────────────────────────────────────────────────────────
 import * as callEnd from "./bundled-skills/phone-calls/tools/call-end.js";
 import * as callStart from "./bundled-skills/phone-calls/tools/call-start.js";
@@ -168,24 +112,8 @@ import * as subagentMessage from "./bundled-skills/subagent/tools/subagent-messa
 import * as subagentRead from "./bundled-skills/subagent/tools/subagent-read.js";
 import * as subagentSpawn from "./bundled-skills/subagent/tools/subagent-spawn.js";
 import * as subagentStatus from "./bundled-skills/subagent/tools/subagent-status.js";
-// ── tasks ──────────────────────────────────────────────────────────────────────
-import * as taskDelete from "./bundled-skills/tasks/tools/task-delete.js";
-import * as taskList from "./bundled-skills/tasks/tools/task-list.js";
-import * as taskListAdd from "./bundled-skills/tasks/tools/task-list-add.js";
-import * as taskListRemove from "./bundled-skills/tasks/tools/task-list-remove.js";
-import * as taskListShow from "./bundled-skills/tasks/tools/task-list-show.js";
-import * as taskListUpdate from "./bundled-skills/tasks/tools/task-list-update.js";
-import * as taskQueueRun from "./bundled-skills/tasks/tools/task-queue-run.js";
-import * as taskRun from "./bundled-skills/tasks/tools/task-run.js";
-import * as taskSave from "./bundled-skills/tasks/tools/task-save.js";
 // ── transcribe ─────────────────────────────────────────────────────────────────
 import * as transcribeMedia from "./bundled-skills/transcribe/tools/transcribe-media.js";
-// ── watcher ────────────────────────────────────────────────────────────────────
-import * as watcherCreate from "./bundled-skills/watcher/tools/watcher-create.js";
-import * as watcherDelete from "./bundled-skills/watcher/tools/watcher-delete.js";
-import * as watcherDigest from "./bundled-skills/watcher/tools/watcher-digest.js";
-import * as watcherList from "./bundled-skills/watcher/tools/watcher-list.js";
-import * as watcherUpdate from "./bundled-skills/watcher/tools/watcher-update.js";
 
 // ─── Registry ────────────────────────────────────────────────────────────────
 
@@ -202,25 +130,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["app-builder:tools/app-refresh.ts", appRefresh],
   ["app-builder:tools/app-generate-icon.ts", appGenerateIcon],
 
-  // browser
-  ["browser:tools/browser-navigate.ts", browserNavigate],
-  ["browser:tools/browser-snapshot.ts", browserSnapshot],
-  ["browser:tools/browser-screenshot.ts", browserScreenshot],
-  ["browser:tools/browser-close.ts", browserClose],
-  ["browser:tools/browser-click.ts", browserClick],
-  ["browser:tools/browser-type.ts", browserType],
-  ["browser:tools/browser-press-key.ts", browserPressKey],
-  ["browser:tools/browser-scroll.ts", browserScroll],
-  ["browser:tools/browser-select-option.ts", browserSelectOption],
-  ["browser:tools/browser-hover.ts", browserHover],
-  ["browser:tools/browser-wait-for.ts", browserWaitFor],
-  ["browser:tools/browser-extract.ts", browserExtract],
-  ["browser:tools/browser-wait-for-download.ts", browserWaitForDownload],
-  ["browser:tools/browser-fill-credential.ts", browserFillCredential],
-
-  // chatgpt-import
-  ["chatgpt-import:tools/chatgpt-import.ts", chatgptImport],
-
   // computer-use
   ["computer-use:tools/computer-use-observe.ts", computerUseObserve],
   ["computer-use:tools/computer-use-click.ts", computerUseClick],
@@ -255,31 +164,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["followups:tools/followup-list.ts", followupList],
   ["followups:tools/followup-resolve.ts", followupResolve],
 
-  // gmail
-  ["gmail:tools/gmail-archive.ts", gmailArchive],
-  ["gmail:tools/gmail-label.ts", gmailLabel],
-  ["gmail:tools/gmail-trash.ts", gmailTrash],
-  ["gmail:tools/gmail-unsubscribe.ts", gmailUnsubscribe],
-  ["gmail:tools/gmail-draft.ts", gmailDraft],
-  ["gmail:tools/gmail-send-draft.ts", gmailSendDraft],
-  ["gmail:tools/gmail-attachments.ts", gmailAttachments],
-  ["gmail:tools/gmail-forward.ts", gmailForward],
-  ["gmail:tools/gmail-follow-up.ts", gmailFollowUp],
-  ["gmail:tools/gmail-filters.ts", gmailFilters],
-  ["gmail:tools/gmail-vacation.ts", gmailVacation],
-  ["gmail:tools/gmail-sender-digest.ts", gmailSenderDigest],
-  ["gmail:tools/gmail-outreach-scan.ts", gmailOutreachScan],
-
-  // google-calendar
-  ["google-calendar:tools/calendar-list-events.ts", calendarListEvents],
-  ["google-calendar:tools/calendar-get-event.ts", calendarGetEvent],
-  ["google-calendar:tools/calendar-create-event.ts", calendarCreateEvent],
-  [
-    "google-calendar:tools/calendar-check-availability.ts",
-    calendarCheckAvailability,
-  ],
-  ["google-calendar:tools/calendar-rsvp.ts", calendarRsvp],
-
   // image-studio
   ["image-studio:tools/media-generate-image.ts", mediaGenerateImage],
 
@@ -309,39 +193,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   // notifications
   ["notifications:tools/send-notification.ts", sendNotification],
 
-  // outlook
-  ["outlook:tools/outlook-rules.ts", outlookRules],
-  ["outlook:tools/outlook-vacation.ts", outlookVacation],
-  ["outlook:tools/outlook-sender-digest.ts", outlookSenderDigest],
-  ["outlook:tools/outlook-outreach-scan.ts", outlookOutreachScan],
-  ["outlook:tools/outlook-draft.ts", outlookDraft],
-  ["outlook:tools/outlook-send-draft.ts", outlookSendDraft],
-  ["outlook:tools/outlook-forward.ts", outlookForward],
-  ["outlook:tools/outlook-trash.ts", outlookTrash],
-  ["outlook:tools/outlook-categories.ts", outlookCategories],
-  ["outlook:tools/outlook-follow-up.ts", outlookFollowUp],
-  ["outlook:tools/outlook-unsubscribe.ts", outlookUnsubscribe],
-  ["outlook:tools/outlook-attachments.ts", outlookAttachments],
-
-  // outlook-calendar
-  [
-    "outlook-calendar:tools/outlook-calendar-list-events.ts",
-    outlookCalendarListEvents,
-  ],
-  [
-    "outlook-calendar:tools/outlook-calendar-get-event.ts",
-    outlookCalendarGetEvent,
-  ],
-  [
-    "outlook-calendar:tools/outlook-calendar-create-event.ts",
-    outlookCalendarCreateEvent,
-  ],
-  [
-    "outlook-calendar:tools/outlook-calendar-check-availability.ts",
-    outlookCalendarCheckAvailability,
-  ],
-  ["outlook-calendar:tools/outlook-calendar-rsvp.ts", outlookCalendarRsvp],
-
   // phone-calls
   ["phone-calls:tools/call-start.ts", callStart],
   ["phone-calls:tools/call-status.ts", callStatus],
@@ -392,24 +243,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["subagent:tools/subagent-message.ts", subagentMessage],
   ["subagent:tools/subagent-read.ts", subagentRead],
 
-  // tasks
-  ["tasks:tools/task-save.ts", taskSave],
-  ["tasks:tools/task-run.ts", taskRun],
-  ["tasks:tools/task-list.ts", taskList],
-  ["tasks:tools/task-delete.ts", taskDelete],
-  ["tasks:tools/task-list-show.ts", taskListShow],
-  ["tasks:tools/task-list-add.ts", taskListAdd],
-  ["tasks:tools/task-list-update.ts", taskListUpdate],
-  ["tasks:tools/task-list-remove.ts", taskListRemove],
-  ["tasks:tools/task-queue-run.ts", taskQueueRun],
-
   // transcribe
   ["transcribe:tools/transcribe-media.ts", transcribeMedia],
-
-  // watcher
-  ["watcher:tools/watcher-create.ts", watcherCreate],
-  ["watcher:tools/watcher-list.ts", watcherList],
-  ["watcher:tools/watcher-update.ts", watcherUpdate],
-  ["watcher:tools/watcher-delete.ts", watcherDelete],
-  ["watcher:tools/watcher-digest.ts", watcherDigest],
 ]);

package/src/config/env-registry.ts

@@ -81,6 +81,25 @@ export function getWorkspaceDirOverride(): string | undefined {
   return str("VELLUM_WORKSPACE_DIR");
 }
 
+/**
+ * VELLUM_BACKUP_DIR — string, default: undefined
+ * Overrides the default backup root directory (~/.vellum/backups/).
+ * Used in containerized deployments where the backup directory must be
+ * on a persistent volume.
+ */
+export function getBackupDirOverride(): string | undefined {
+  return str("VELLUM_BACKUP_DIR");
+}
+
+/**
+ * VELLUM_BACKUP_KEY_PATH — string, default: undefined
+ * Overrides the default backup encryption key path (~/.vellum/protected/backup.key).
+ * Used in containerized deployments where the key must be on a persistent volume.
+ */
+export function getBackupKeyPathOverride(): string | undefined {
+  return str("VELLUM_BACKUP_KEY_PATH");
+}
+
 // ── Profiler env vars ───────────────────────────────────────────────────
 // These are injected by the platform when running a managed assistant in
 // profiler mode. The runtime uses them to locate, scope, and budget-limit
@@ -151,16 +170,21 @@ export function getProfilerMinFreeMb(): number | undefined {
  */
 const KNOWN_VELLUM_VARS = new Set([
   "VELLUM_ASSISTANT_NAME",
+  "VELLUM_ASSISTANT_PLATFORM_URL",
   "VELLUM_AWS_ROLE_ARN",
+  "VELLUM_BACKUP_DIR",
+  "VELLUM_BACKUP_KEY_PATH",
   "VELLUM_CLOUD",
   "VELLUM_CUSTOM_QR_CODE_PATH",
   "VELLUM_DAEMON_AUTOSTART",
   "VELLUM_DAEMON_NOAUTH",
   "VELLUM_DATA_DIR",
+  "VELLUM_DEBUG",
   "VELLUM_DESKTOP_APP",
   "VELLUM_DEV",
   "VELLUM_DOCS_BASE_URL",
   "VELLUM_ENABLE_INSECURE_LAN_PAIRING",
+  "VELLUM_ENVIRONMENT",
   "VELLUM_HATCHED_BY",
   "VELLUM_HOOK_EVENT",
   "VELLUM_HOOK_NAME",

package/src/config/env.ts

@@ -152,10 +152,23 @@ export function getPlatformBaseUrl(): string {
   } catch {
     // Config not yet available (early bootstrap) — fall through
   }
-  const defaultUrl =
-    str("VELLUM_DEV") === "1"
-      ? "https://dev-platform.vellum.ai"
-      : "https://platform.vellum.ai";
+  // Resolve the default platform URL from VELLUM_ENVIRONMENT.
+  // `production`, `staging`, and `test` map to their respective hosted
+  // platforms, `local` points at a developer's locally running platform,
+  // and everything else (including unset) falls back to dev-platform.
+  const env = str("VELLUM_ENVIRONMENT")?.trim();
+  let defaultUrl: string;
+  if (env === "production") {
+    defaultUrl = "https://platform.vellum.ai";
+  } else if (env === "staging") {
+    defaultUrl = "https://staging-platform.vellum.ai";
+  } else if (env === "test") {
+    defaultUrl = "https://test-platform.vellum.ai";
+  } else if (env === "local") {
+    defaultUrl = "http://localhost:8000";
+  } else {
+    defaultUrl = "https://dev-platform.vellum.ai";
+  }
   return (
     configUrl ||
     str("VELLUM_PLATFORM_URL") ||
@@ -167,18 +180,34 @@ export function getPlatformBaseUrl(): string {
 /**
  * Derive the assistant service domain from the platform base URL.
  *
- * - `dev-platform.vellum.ai`  → `dev.vellum.me`
- * - `platform.vellum.ai`      → `vellum.me`
- * - anything else              → `vellum.me` (safe default)
+ * Known platform URLs map directly (via regex stripping of `platform.vellum.ai`):
+ * - `dev-platform.vellum.ai`     → `dev.vellum.me`
+ * - `staging-platform.vellum.ai` → `staging.vellum.me` (derived automatically from the staging URL)
+ * - `platform.vellum.ai`         → `vellum.me`
+ *
+ * Non-vellum.ai hosts (localhost, host.docker.internal, etc.) use
+ * VELLUM_ENVIRONMENT to derive the subdomain, defaulting to `local`:
+ * - local                         → `local.vellum.me`
  */
 export function getAssistantDomain(): string {
   try {
     const url = getPlatformBaseUrl();
     const host = new URL(url).hostname;
-    const prefix = host.replace(/[-.]?platform\.vellum\.ai$/, "");
-    if (prefix) {
-      return `${prefix}.vellum.me`;
+
+    if (host.endsWith("platform.vellum.ai")) {
+      const prefix = host.replace(/[-.]?platform\.vellum\.ai$/, "");
+      if (prefix) {
+        return `${prefix}.vellum.me`;
+      }
+      return "vellum.me";
+    }
+
+    // Non-vellum.ai host (local dev, Docker, etc.) — derive from environment
+    const env = str("VELLUM_ENVIRONMENT")?.trim();
+    if (env && env !== "production") {
+      return `${env}.vellum.me`;
     }
+    return "local.vellum.me";
   } catch {
     // Fall through to default
   }

package/src/config/feature-flag-registry.json

@@ -1,6 +1,14 @@
 {
   "version": 1,
   "flags": [
+    {
+      "id": "auto-analyze",
+      "scope": "assistant",
+      "key": "auto-analyze",
+      "label": "Auto-analyze conversations",
+      "description": "Automatically trigger conversation analysis on the same cadence as memory extraction (batch threshold, idle debounce, end-of-conversation). The analysis agent has full tool access and writes back to memory and skills without user approval.",
+      "defaultEnabled": false
+    },
     {
       "id": "browser",
       "scope": "assistant",
@@ -30,7 +38,7 @@
       "scope": "assistant",
       "key": "email-channel",
       "label": "Email Channel",
-      "description": "Enable the entire email integration: email CLI commands, email channel, sequences, email readiness probes, invite adapters, and the email-setup skill",
+      "description": "Enable the entire email integration: email CLI commands, email channel, domain registration, sequences, email readiness probes, invite adapters, and the email-setup skill",
       "defaultEnabled": false
     },
     {
@@ -153,14 +161,6 @@
       "description": "Enable the Deploy to Vercel / Publish option in the app workspace header share menu",
       "defaultEnabled": false
     },
-    {
-      "id": "managed-google-oauth",
-      "scope": "assistant",
-      "key": "managed-google-oauth",
-      "label": "Managed Google OAuth",
-      "description": "Show the Google OAuth service card in Models & Services settings",
-      "defaultEnabled": true
-    },
     {
       "id": "settings-embedding-provider",
       "scope": "assistant",
@@ -262,7 +262,7 @@
       "scope": "assistant",
       "key": "fast-mode",
       "label": "Fast Mode",
-      "description": "Enable Anthropic fast mode for Opus 4.6, delivering up to 2.5x higher output tokens per second at premium pricing",
+      "description": "Enable Anthropic fast mode for Opus models (4.6, 4.7), delivering up to 2.5x higher output tokens per second at premium pricing",
       "defaultEnabled": false
     },
     {
@@ -303,7 +303,7 @@
       "key": "tool-result-truncation",
       "label": "Post-Turn Tool Result Truncation",
       "description": "Truncate large tool results after each assistant turn, persisting full content to disk for on-demand re-reads",
-      "defaultEnabled": false
+      "defaultEnabled": true
     },
     {
       "id": "managed-gemini-embeddings-enabled",
@@ -322,12 +322,60 @@
       "defaultEnabled": false
     },
     {
-      "id": "fork-from-message",
+      "id": "onboarding-pre-chat",
       "scope": "macos",
-      "key": "fork-from-message",
-      "label": "Fork from Message",
-      "description": "Show the Fork from here option in message overflow menus",
+      "key": "onboarding-pre-chat",
+      "label": "Pre-Chat Onboarding Flow",
+      "description": "Gates the 3-screen pre-chat onboarding flow (tools, tasks/tone, name exchange) shown before the first conversation",
       "defaultEnabled": false
+    },
+    {
+      "id": "home-tab",
+      "scope": "macos",
+      "key": "home-tab",
+      "label": "Home Tab",
+      "description": "Replace the knowledge graph top-level tab with a new Home page showing relationship progression, facts, and capability tiers",
+      "defaultEnabled": false
+    },
+    {
+      "id": "channel-avatar-sync",
+      "scope": "assistant",
+      "key": "channel-avatar-sync",
+      "label": "Channel Avatar Sync",
+      "description": "Automatically sync the assistant's avatar to connected channels (Slack) when the avatar changes or a new channel is connected",
+      "defaultEnabled": true
+    },
+    {
+      "id": "meet",
+      "scope": "assistant",
+      "key": "meet",
+      "label": "Google Meet",
+      "description": "Enables the Google Meet joining bot and the meet-join skill.",
+      "defaultEnabled": false
+    },
+    {
+      "id": "compaction-v2",
+      "scope": "assistant",
+      "key": "compaction-v2",
+      "label": "Compaction v2",
+      "description": "Boundary-message-based compaction pipeline with forked prompt-cache-shared summarization and microcompact pre-pass. Replaces the four-tier overflow reducer and cursor-based storage.",
+      "defaultEnabled": false
+    },
+    {
+      "id": "scroll-debug-overlay",
+      "scope": "macos",
+      "key": "scroll-debug-overlay",
+      "label": "Scroll Debug Overlay",
+      "description": "Show a live HUD in the top-right of the conversation with scroll geometry, velocity, update rate, and anchor-preserver activity. Developer diagnostic for investigating scroll jank.",
+      "defaultEnabled": false
+    },
+    {
+      "id": "message-height-cache",
+      "scope": "macos",
+      "key": "message-height-cache",
+      "label": "Message Height Cache",
+      "description": "Swap the transcript's LazyVStack for a plain VStack so scrollContentHeight is the true sum of row heights (no LazyVStack estimator drift). Row frames are not pinned — the earlier frame-pinning approach was removed because it caused overlap when rows grew past their first measurement (streaming, expanding thinking blocks). Tradeoff: eager layout — every row measures up-front, which can stall for many seconds to minutes on very long conversations.",
+      "defaultEnabled": true
     }
   ]
 }

package/src/config/llm-resolver.ts

@@ -0,0 +1,128 @@
+import { z } from "zod";
+
+import {
+  type LLMCallSite,
+  LLMConfigBase,
+  type LLMConfigFragment,
+  type LLMSchema,
+} from "./schemas/llm.js";
+
+/**
+ * Resolves a fully-specified `LLMConfigBase` for a given call site by layering
+ * the call-site override on top of an optional named profile on top of the
+ * required `llm.default`.
+ *
+ * Resolution order (highest precedence wins):
+ *   1. `llm.callSites[callSite]` fields (call-site override)
+ *   2. `llm.profiles[site.profile]` fields (named profile)
+ *   3. `llm.default` fields (required base)
+ *
+ * Nested objects (`thinking`, `contextWindow`, and
+ * `contextWindow.overflowRecovery`) are deep-merged so partial overrides at
+ * any nesting level merge into — rather than replace — the corresponding
+ * base value.
+ *
+ * Pure & synchronous: no I/O, no async work.
+ */
+export function resolveCallSiteConfig(
+  callSite: LLMCallSite,
+  llm: z.infer<typeof LLMSchema>,
+): z.infer<typeof LLMConfigBase> {
+  const site = llm.callSites?.[callSite];
+
+  // No site-level entry: deep-merge `default` against an empty fragment so
+  // every code path goes through the same merge codepath.
+  if (site == null) {
+    return finalize(deepMerge(llm.default as Mergeable, {} as Mergeable));
+  }
+
+  let profileFragment: LLMConfigFragment | undefined;
+  if (site.profile != null) {
+    profileFragment = llm.profiles?.[site.profile];
+    if (profileFragment == null) {
+      // Defensive: `LLMSchema.superRefine` already rejects unknown profile
+      // references at config load, so this branch is unreachable for any
+      // config that survived schema validation. Throw a clear error in case
+      // a hand-crafted (un-parsed) config slips through.
+      throw new Error(
+        `LLM call site "${callSite}" references undefined profile "${site.profile}"`,
+      );
+    }
+  }
+
+  // Strip the `profile` discriminator before merging — it isn't a
+  // `LLMConfigBase` field.
+  const { profile: _profile, ...siteFragment } = site;
+
+  const merged = deepMerge(
+    llm.default as Mergeable,
+    (profileFragment ?? {}) as Mergeable,
+    siteFragment as Mergeable,
+  );
+
+  return finalize(merged);
+}
+
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+
+type Mergeable = Record<string, unknown>;
+
+/**
+ * Returns true for objects we should recurse into during deep merge. We
+ * deliberately exclude arrays so that array-valued fields (e.g.
+ * `pricingOverrides` siblings) get full replacement semantics.
+ */
+function isPlainObject(value: unknown): value is Mergeable {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    !Array.isArray(value) &&
+    Object.getPrototypeOf(value) === Object.prototype
+  );
+}
+
+/**
+ * Deep-merges a sequence of fragments where each rightward source overrides
+ * the previous. For nested plain objects, recurse so partial overrides merge
+ * leaf-by-leaf rather than wholesale-replacing the nested object.
+ *
+ * `undefined` values in a source are skipped (treated as "no opinion"); this
+ * matches Zod fragment semantics where unset optional fields are absent.
+ *
+ * Plain-object values are always cloned (via recursion) rather than aliased,
+ * so the returned config is an isolated snapshot — mutating any nested object
+ * on the result cannot affect `llm.default`, named profiles, or other call
+ * sites' resolutions. Arrays and primitives are copied by reference; the
+ * resolver does not return arrays, and primitives are immutable.
+ */
+function deepMerge(...sources: Mergeable[]): Mergeable {
+  const out: Mergeable = {};
+  for (const source of sources) {
+    for (const [key, value] of Object.entries(source)) {
+      if (value === undefined) continue;
+      const existing = out[key];
+      if (isPlainObject(value)) {
+        // Recurse for any plain-object source. Using `existing` as the base
+        // when it's also a plain object preserves leaf-by-leaf merge
+        // semantics; otherwise we recurse against an empty object so the
+        // result is a freshly-allocated clone rather than an alias.
+        const base = isPlainObject(existing) ? existing : ({} as Mergeable);
+        out[key] = deepMerge(base, value);
+      } else {
+        out[key] = value;
+      }
+    }
+  }
+  return out;
+}
+
+/**
+ * Cast helper that documents the intent: after merging `llm.default` (which
+ * is `LLMConfigBase`) with optional fragments, every required field is still
+ * present, so the result satisfies `LLMConfigBase`.
+ */
+function finalize(merged: Mergeable): z.infer<typeof LLMConfigBase> {
+  return merged as unknown as z.infer<typeof LLMConfigBase>;
+}