@vellumai/assistant 0.7.1 → 0.7.2

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

@@ -64,9 +64,13 @@
             "type": "boolean",
             "description": "When true, reuse the same conversation across recurring schedule runs instead of creating a new one each time. Useful for polling-style schedules that accumulate context over time. Ignored for one-shot schedules. Defaults to false."
           },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
+          "max_retries": {
+            "type": "integer",
+            "description": "Maximum number of retries after the initial execution fails. Defaults to 3."
+          },
+          "retry_backoff_ms": {
+            "type": "integer",
+            "description": "Base backoff delay in milliseconds between retries. Exponential backoff is applied. Defaults to 60000."
           }
         },
         "required": ["name"]
@@ -89,10 +93,6 @@
           "job_id": {
             "type": "string",
             "description": "If provided, show detailed info and recent runs for this specific job."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -163,9 +163,13 @@
             "type": "boolean",
             "description": "When true, reuse the same conversation across recurring schedule runs instead of creating a new one each time. Useful for polling-style schedules that accumulate context over time. Ignored for one-shot schedules."
           },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
+          "max_retries": {
+            "type": "integer",
+            "description": "Maximum number of retries after the initial execution fails. Defaults to 3."
+          },
+          "retry_backoff_ms": {
+            "type": "integer",
+            "description": "Base backoff delay in milliseconds between retries. Exponential backoff is applied. Defaults to 60000."
           }
         },
         "required": ["job_id"]
@@ -184,10 +188,6 @@
           "job_id": {
             "type": "string",
             "description": "The ID of the schedule to delete"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["job_id"]

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

@@ -54,10 +54,6 @@
           "exit_on_reply": {
             "type": "boolean",
             "description": "Whether to stop the sequence when the contact replies (default true)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["name", "channel", "steps"]
@@ -77,10 +73,6 @@
             "type": "string",
             "enum": ["active", "paused", "archived"],
             "description": "Filter by sequence status"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -98,10 +90,6 @@
           "id": {
             "type": "string",
             "description": "Sequence ID"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["id"]
@@ -176,10 +164,6 @@
               "required": ["body_prompt"]
             },
             "description": "Replacement steps (replaces all existing steps)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "oneOf": [
@@ -201,10 +185,6 @@
           "id": {
             "type": "string",
             "description": "Sequence ID to delete"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["id"]
@@ -241,10 +221,6 @@
           "context": {
             "type": "object",
             "description": "Optional context object with personalization variables for the enrolled contacts"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["sequence_id", "emails"]
@@ -275,10 +251,6 @@
               "failed"
             ],
             "description": "Filter by enrollment status"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -304,10 +276,6 @@
           "auto_enroll": {
             "type": "boolean",
             "description": "Set to true to enroll contacts (default false = preview mode)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["file_path", "sequence_id"]
@@ -326,10 +294,6 @@
           "sequence_id": {
             "type": "string",
             "description": "Optional sequence ID for detailed step funnel view"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },

package/src/config/bundled-skills/settings/SKILL.md

@@ -6,6 +6,10 @@ metadata:
   emoji: "\u2699\uFE0F"
   vellum:
     display-name: "Settings"
+    activation-hints:
+      - "User wants to change the assistant's voice, TTS provider, or speech output"
+      - "User wants to rebind the push-to-talk key or adjust microphone / conversation timeout"
+      - "User wants to open the in-app settings tab or navigate to a specific preference"
 ---
 
 Tools for managing assistant settings: voice configuration (TTS voice, PTT activation key, conversation timeout), system settings navigation, and in-app settings tab navigation.

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

@@ -22,10 +22,6 @@
           },
           "value": {
             "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",
-            "description": "Brief non-technical explanation of what you are changing and why, shown to the user as a status update. Use simple language a non-technical person would understand."
           }
         }
       },
@@ -44,10 +40,6 @@
             "type": "string",
             "enum": ["microphone", "speech_recognition"],
             "description": "The System Settings pane to open"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of what you are opening and why, shown to the user as a status update. Use simple language a non-technical person would understand."
           }
         },
         "required": ["pane"]
@@ -77,10 +69,6 @@
               "Developer"
             ],
             "description": "The settings tab to navigate to"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of what you are navigating to and why, shown to the user as a status update. Use simple language a non-technical person would understand."
           }
         },
         "required": ["tab"]

package/src/config/bundled-skills/skill-management/SKILL.md

@@ -5,6 +5,12 @@ metadata:
   emoji: "\U0001F9E9"
   vellum:
     display-name: "Skill Management"
+    activation-hints:
+      - "User wants to scaffold a new managed skill in their workspace from a description"
+      - "User wants to delete or list the custom skills they have defined"
+      - "User wants to author or edit a SKILL.md and have it become invocable as a skill"
+    avoid-when:
+      - "User just wants to use an existing skill — that is normal skill activation, not management"
 ---
 
 Manage the lifecycle of custom managed skills in `{workspaceDir}/skills`.

package/src/config/bundled-skills/skill-management/TOOLS.json

@@ -41,10 +41,6 @@
             "type": "array",
             "items": { "type": "string" },
             "description": "Optional list of child skill IDs that this skill includes (metadata only, no auto-activation)."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of what you are creating and why, shown to the user as a status update. Use simple language a non-technical person would understand."
           }
         },
         "required": ["skill_id", "name", "description", "body_markdown"]
@@ -67,10 +63,6 @@
           "remove_from_index": {
             "type": "boolean",
             "description": "Whether to remove the skill from SKILLS.md index (default: true)."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of what you are deleting and why, shown to the user as a status update. Use simple language a non-technical person would understand."
           }
         },
         "required": ["skill_id"]

package/src/config/bundled-skills/subagent/SKILL.md

@@ -7,8 +7,12 @@ metadata:
   vellum:
     display-name: "Subagent"
     activation-hints:
-      - "Run tasks in parallel, delegate work to background agents, or do multiple things at once"
-      - "Spawn a researcher, coder, or planner agent for independent work"
+      - "Spawn a background worker that runs in parallel with the main turn"
+      - "Delegate a self-contained research or implementation task off the main thread"
+      - "Multiple agents at once, or a context-inheriting fork"
+    avoid-when:
+      - "Task is small enough to do inline (single tool call, quick lookup)"
+      - "User wants Claude Code or Codex — use the acp skill instead"
 ---
 
 Subagent orchestration -- spawn background agents to work on tasks in parallel.

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

@@ -33,10 +33,6 @@
             "type": "string",
             "enum": ["general", "researcher", "coder", "planner"],
             "description": "Agent specialization that controls tool access. 'researcher': read-only (web, files, memory). 'coder': file and bash access. 'planner': read-only analysis. 'general': full access (default). Ignored when fork: true (forks always use general)."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["label", "objective"]
@@ -59,10 +55,6 @@
           "label": {
             "type": "string",
             "description": "The label of the subagent (alternative to subagent_id). Case-insensitive."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -85,10 +77,6 @@
           "label": {
             "type": "string",
             "description": "The label of the subagent (alternative to subagent_id). Case-insensitive."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -115,10 +103,6 @@
           "content": {
             "type": "string",
             "description": "The message content to send to the subagent."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["content"]
@@ -145,10 +129,6 @@
           "last_n": {
             "type": "integer",
             "description": "Number of recent assistant messages to return. Omit to return all messages (current behavior)."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []

package/src/config/bundled-skills/transcribe/SKILL.md

@@ -6,6 +6,10 @@ metadata:
   emoji: "🎙️"
   vellum:
     display-name: "Transcribe"
+    activation-hints:
+      - "User has an audio or video file on disk they want converted to text"
+      - "User wants speech-to-text on a recording, voice memo, podcast, or meeting capture"
+      - "User asks for a transcript of a media file (mp3, wav, m4a, mp4, mov, etc.)"
 ---
 
 Transcribe audio and video files using the configured speech-to-text provider. Supports multiple STT providers including OpenAI Whisper, Deepgram, and Google Gemini — the active provider is selected in Settings under Speech-to-Text (`services.stt`).

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

@@ -12,10 +12,6 @@
           "file_path": {
             "type": "string",
             "description": "Absolute path to a local audio or video file to transcribe"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["file_path"]

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

@@ -24,6 +24,16 @@ 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";
+// ── app-control ────────────────────────────────────────────────────────────────
+import * as appControlClick from "./bundled-skills/app-control/tools/app-control-click.js";
+import * as appControlCombo from "./bundled-skills/app-control/tools/app-control-combo.js";
+import * as appControlDrag from "./bundled-skills/app-control/tools/app-control-drag.js";
+import * as appControlObserve from "./bundled-skills/app-control/tools/app-control-observe.js";
+import * as appControlPress from "./bundled-skills/app-control/tools/app-control-press.js";
+import * as appControlSequence from "./bundled-skills/app-control/tools/app-control-sequence.js";
+import * as appControlStart from "./bundled-skills/app-control/tools/app-control-start.js";
+import * as appControlStop from "./bundled-skills/app-control/tools/app-control-stop.js";
+import * as appControlType from "./bundled-skills/app-control/tools/app-control-type.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";
@@ -125,6 +135,17 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["app-builder:tools/app-refresh.ts", appRefresh],
   ["app-builder:tools/app-generate-icon.ts", appGenerateIcon],
 
+  // app-control
+  ["app-control:tools/app-control-start.ts", appControlStart],
+  ["app-control:tools/app-control-observe.ts", appControlObserve],
+  ["app-control:tools/app-control-press.ts", appControlPress],
+  ["app-control:tools/app-control-combo.ts", appControlCombo],
+  ["app-control:tools/app-control-sequence.ts", appControlSequence],
+  ["app-control:tools/app-control-type.ts", appControlType],
+  ["app-control:tools/app-control-click.ts", appControlClick],
+  ["app-control:tools/app-control-drag.ts", appControlDrag],
+  ["app-control:tools/app-control-stop.ts", appControlStop],
+
   // computer-use
   ["computer-use:tools/computer-use-observe.ts", computerUseObserve],
   ["computer-use:tools/computer-use-click.ts", computerUseClick],

package/src/config/env-registry.ts

@@ -186,14 +186,12 @@ const KNOWN_VELLUM_VARS = new Set([
   "VELLUM_BACKUP_DIR",
   "VELLUM_BACKUP_KEY_PATH",
   "VELLUM_CLOUD",
-  "VELLUM_CUSTOM_QR_CODE_PATH",
   "VELLUM_DAEMON_AUTOSTART",
   "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",

package/src/config/env.ts

@@ -163,18 +163,11 @@ export function getPlatformBaseUrl(): string {
 }
 
 /**
- * Derive the assistant service domain from the platform base URL.
- *
- * 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`
+ * Returns the environment-level apex domain (e.g. "vellum.me",
+ * "dev.vellum.me", "staging.vellum.me"). Never includes the
+ * assistant-specific subdomain.
  */
-export function getAssistantDomain(): string {
+export function getApexDomain(): string {
   try {
     const url = getPlatformBaseUrl();
     const host = new URL(url).hostname;
@@ -187,7 +180,6 @@ export function getAssistantDomain(): string {
       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`;
@@ -199,6 +191,21 @@ export function getAssistantDomain(): string {
   return "vellum.me";
 }
 
+export function getAssistantDomain(): string {
+  const subdomain = (() => {
+    try {
+      return getConfig().platform?.subdomain;
+    } catch {
+      return undefined;
+    }
+  })();
+  const apex = getApexDomain();
+  if (subdomain) {
+    return `${subdomain}.${apex}`;
+  }
+  return apex;
+}
+
 let _platformAssistantIdOverride: string | undefined;
 
 export function setPlatformAssistantId(value: string | undefined): void {