@vellumai/assistant 0.6.4 → 0.6.6

package/src/config/bundled-skills/schedule/references/SCRIPT_MODE_PATTERNS.md

@@ -0,0 +1,59 @@
+# Script Mode Patterns
+
+Script mode runs shell commands without LLM involvement, but scripts can escalate to the assistant or notify the user via CLI commands when conditions are met. This makes script mode a building block for conditional automation — fast, deterministic checks that only invoke heavier machinery when needed.
+
+## Script → LLM Escalation
+
+Use `assistant conversations wake` to hand off to the assistant when a script detects something that needs LLM reasoning. The wake command injects a hint into an existing conversation without creating a user-visible message.
+
+Example: poll an API and wake the assistant only when results change.
+
+```sh
+LAST="/workspace/data/api-status-last.txt"
+CURRENT=$(curl -sf https://api.example.com/status)
+[ "$CURRENT" = "$(cat "$LAST" 2>/dev/null)" ] && exit 0
+echo "$CURRENT" > "$LAST"
+assistant conversations wake CONVERSATION_ID --hint "API status changed: $CURRENT" --source scheduled-poll
+```
+
+Example: check disk usage and escalate to the assistant when it's high.
+
+```sh
+USAGE=$(df /workspace --output=pcent | tail -1 | tr -d ' %')
+[ "$USAGE" -lt 90 ] && exit 0
+assistant conversations wake CONVERSATION_ID --hint "Disk usage at ${USAGE}% — investigate and clean up" --source disk-monitor
+```
+
+## Script → Notification
+
+Use `assistant notifications send` to alert the user directly when a script detects something noteworthy. No LLM is involved — the notification goes straight to the user's connected channels.
+
+Example: check if a service is down and notify the user.
+
+```sh
+if ! curl -sf --max-time 5 https://myapp.example.com/health > /dev/null; then
+  assistant notifications send \
+    --source-channel scheduler \
+    --source-event-name schedule.notify \
+    --message "myapp.example.com health check failed" \
+    --urgency high \
+    --dedupe-key "myapp-health-$(date +%Y%m%d)"
+fi
+```
+
+Example: notify when a long-running background job finishes.
+
+```sh
+if [ -f /workspace/data/export-complete.flag ]; then
+  assistant notifications send \
+    --source-channel scheduler \
+    --source-event-name schedule.notify \
+    --message "Data export finished — file ready at /workspace/data/export.csv" \
+    --no-requires-action
+  rm /workspace/data/export-complete.flag
+fi
+```
+
+## Tips
+
+Both patterns keep scheduled runs fast and cheap — the script exits immediately when nothing interesting happens, and only reaches for the assistant or notification system when there's something to act on. Use `quiet: true` on the schedule to suppress the per-run completion noise.

package/src/config/bundled-skills/settings/TOOLS.json

@@ -3,7 +3,7 @@
   "tools": [
     {
       "name": "voice_config_update",
-      "description": "Update a voice configuration setting. Use tts_provider to switch the global TTS provider (valid providers: elevenlabs, fish-audio, deepgram — defined by the provider catalog). Use tts_voice_id to set the ElevenLabs voice ID, fish_audio_reference_id for Fish Audio voice reference. Deepgram uses the same API key as speech-to-text and requires no additional voice config. Changes persist to services.tts config and take effect immediately.",
+      "description": "Update a voice configuration setting. Use tts_provider to switch the global TTS provider (valid providers: elevenlabs, fish-audio, deepgram, xai — defined by the provider catalog). Use tts_voice_id to set the ElevenLabs voice ID, fish_audio_reference_id for Fish Audio voice reference. Deepgram uses the same API key as speech-to-text and requires no additional voice config. Changes persist to services.tts config and take effect immediately.",
       "category": "system",
       "risk": "low",
       "input_schema": {
@@ -18,10 +18,10 @@
               "tts_provider",
               "tts_voice_id"
             ],
-            "description": "The voice setting to change. tts_provider selects the global TTS provider from the provider catalog (elevenlabs, fish-audio, deepgram). tts_voice_id sets the ElevenLabs voice. fish_audio_reference_id sets the Fish Audio voice reference. Deepgram uses its default model and shares the STT API key."
+            "description": "The voice setting to change. tts_provider selects the global TTS provider from the provider catalog (valid providers: elevenlabs, fish-audio, deepgram, xai). tts_voice_id sets the ElevenLabs voice. fish_audio_reference_id sets the Fish Audio voice reference. Deepgram uses its default model and shares the STT API key."
           },
           "value": {
-            "description": "The new value for the setting. For tts_provider: a valid provider ID from the provider catalog (elevenlabs, fish-audio, deepgram). For tts_voice_id: an alphanumeric ElevenLabs voice ID. For fish_audio_reference_id: a Fish Audio voice reference ID. For conversation_timeout: seconds (5, 10, 15, 30, or 60). For activation_key: key identifier string."
+            "description": "The new value for the setting. For tts_provider: one of elevenlabs, fish-audio, deepgram, xai. For tts_voice_id: an alphanumeric ElevenLabs voice ID. For fish_audio_reference_id: a Fish Audio voice reference ID. For conversation_timeout: seconds (5, 10, 15, 30, or 60). For activation_key: key identifier string."
           },
           "activity": {
             "type": "string",

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

@@ -22,26 +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 browserAttach from "./bundled-skills/browser/tools/browser-attach.js";
-import * as browserClick from "./bundled-skills/browser/tools/browser-click.js";
-import * as browserClose from "./bundled-skills/browser/tools/browser-close.js";
-import * as browserDetach from "./bundled-skills/browser/tools/browser-detach.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 browserStatus from "./bundled-skills/browser/tools/browser-status.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";
@@ -59,8 +39,6 @@ import * as contactMerge from "./bundled-skills/contacts/tools/contact-merge.js"
 import * as contactSearch from "./bundled-skills/contacts/tools/contact-search.js";
 import * as contactUpsert from "./bundled-skills/contacts/tools/contact-upsert.js";
 import * as googleContacts from "./bundled-skills/contacts/tools/google-contacts.js";
-// ── conversations ──────────────────────────────────────────────────────────────
-import * as renameConversation from "./bundled-skills/conversations/tools/rename-conversation.js";
 // ── document ───────────────────────────────────────────────────────────────────
 import * as documentCreate from "./bundled-skills/document/tools/document-create.js";
 import * as documentUpdate from "./bundled-skills/document/tools/document-update.js";
@@ -68,27 +46,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 gmailPreferencesTool from "./bundled-skills/gmail/tools/gmail-preferences-tool.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 ───────────────────────────────────────────────────────────
@@ -109,27 +66,6 @@ import * as messagingRead from "./bundled-skills/messaging/tools/messaging-read.
 import * as messagingSearch from "./bundled-skills/messaging/tools/messaging-search.js";
 import * as messagingSend from "./bundled-skills/messaging/tools/messaging-send.js";
 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";
@@ -144,8 +80,6 @@ import * as scheduleCreate from "./bundled-skills/schedule/tools/schedule-create
 import * as scheduleDelete from "./bundled-skills/schedule/tools/schedule-delete.js";
 import * as scheduleList from "./bundled-skills/schedule/tools/schedule-list.js";
 import * as scheduleUpdate from "./bundled-skills/schedule/tools/schedule-update.js";
-// ── screen-watch ───────────────────────────────────────────────────────────────
-import * as startScreenWatch from "./bundled-skills/screen-watch/tools/start-screen-watch.js";
 // ── sequences ──────────────────────────────────────────────────────────────────
 import * as sequenceAnalytics from "./bundled-skills/sequences/tools/sequence-analytics.js";
 import * as sequenceCreate from "./bundled-skills/sequences/tools/sequence-create.js";
@@ -172,24 +106,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 ────────────────────────────────────────────────────────────────
 
@@ -206,28 +124,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-attach.ts", browserAttach],
-  ["browser:tools/browser-detach.ts", browserDetach],
-  ["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],
-  ["browser:tools/browser-status.ts", browserStatus],
-
-  // 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],
@@ -250,9 +146,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["contacts:tools/contact-merge.ts", contactMerge],
   ["contacts:tools/google-contacts.ts", googleContacts],
 
-  // conversations
-  ["conversations:tools/rename-conversation.ts", renameConversation],
-
   // document
   ["document:tools/document-create.ts", documentCreate],
   ["document:tools/document-update.ts", documentUpdate],
@@ -262,32 +155,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],
-  ["gmail:tools/gmail-preferences-tool.ts", gmailPreferencesTool],
-
-  // 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],
 
@@ -314,42 +181,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["messaging:tools/messaging-sender-digest.ts", messagingSenderDigest],
   ["messaging:tools/messaging-archive-by-sender.ts", messagingArchiveBySender],
 
-  // 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],
@@ -367,9 +198,6 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["schedule:tools/schedule-update.ts", scheduleUpdate],
   ["schedule:tools/schedule-delete.ts", scheduleDelete],
 
-  // screen-watch
-  ["screen-watch:tools/start-screen-watch.ts", startScreenWatch],
-
   // sequences
   ["sequences:tools/sequence-create.ts", sequenceCreate],
   ["sequences:tools/sequence-list.ts", sequenceList],
@@ -400,24 +228,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.ts

@@ -153,14 +153,19 @@ export function getPlatformBaseUrl(): string {
     // Config not yet available (early bootstrap) — fall through
   }
   // Resolve the default platform URL from VELLUM_ENVIRONMENT.
-  // Default to dev-platform for safety; only production and staging
-  // opt into their respective platforms explicitly.
+  // `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";
   }

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

@@ -38,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
     },
     {
@@ -321,21 +321,13 @@
       "description": "Show the 'Fork from here' option in message overflow menus",
       "defaultEnabled": false
     },
-    {
-      "id": "managed-x-oauth-integration",
-      "scope": "assistant",
-      "key": "managed-x-oauth-integration",
-      "label": "Managed X/Twitter OAuth",
-      "description": "Enable platform-managed X/Twitter OAuth integration in Models & Services settings",
-      "defaultEnabled": false
-    },
     {
       "id": "onboarding-pre-chat",
       "scope": "macos",
       "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
+      "defaultEnabled": true
     },
     {
       "id": "home-tab",
@@ -360,6 +352,46 @@
       "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
+    },
+    {
+      "id": "permission-controls-v3",
+      "scope": "assistant",
+      "key": "permission-controls-v3",
+      "label": "Permission Controls v3",
+      "description": "Enables permission controls v3: gateway-backed auto-approve thresholds, risk badges on tool results, simplified Allow/Deny permission prompt, and rule editor modal.",
+      "defaultEnabled": false
+    },
+    {
+      "id": "compaction-playground",
+      "scope": "assistant",
+      "key": "compaction-playground",
+      "label": "Compaction Playground",
+      "description": "Expose the developer-only Compaction Playground tab in macOS Settings and enable the /playground/* HTTP endpoints for exercising compaction conditions. Dev-only; default off.",
+      "defaultEnabled": false
     }
   ]
 }

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>;
+}