@vellumai/assistant 0.4.26 → 0.4.30

package/src/config/bundled-skills/messaging/tools/sequence-resume.ts

@@ -1,18 +1,26 @@
-import { getSequence,updateSequence } from '../../../../sequence/store.js';
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { err,ok } from './shared.js';
+import { getSequence, updateSequence } from "../../../../sequence/store.js";
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { err, ok } from "./shared.js";
 
-export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+export async function run(
+  input: Record<string, unknown>,
+  _context: ToolContext,
+): Promise<ToolExecutionResult> {
   const sequenceId = input.sequence_id as string;
-  if (!sequenceId) return err('sequence_id is required.');
+  if (!sequenceId) return err("sequence_id is required.");
 
   try {
     const seq = getSequence(sequenceId);
     if (!seq) return err(`Sequence not found: ${sequenceId}`);
-    if (seq.status === 'active') return ok('Sequence is already active.');
+    if (seq.status === "active") return ok("Sequence is already active.");
 
-    updateSequence(sequenceId, { status: 'active' });
-    return ok(`Sequence "${seq.name}" resumed. Active enrollments will be processed on the next scheduler tick.`);
+    updateSequence(sequenceId, { status: "active" });
+    return ok(
+      `Sequence "${seq.name}" resumed. Active enrollments will be processed on the next scheduler tick.`,
+    );
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }

package/src/config/bundled-skills/messaging/tools/sequence-update.ts

@@ -1,11 +1,20 @@
-import { updateSequence } from '../../../../sequence/store.js';
-import type { SequenceStatus,SequenceStep } from '../../../../sequence/types.js';
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { err,ok } from './shared.js';
+import { updateSequence } from "../../../../sequence/store.js";
+import type {
+  SequenceStatus,
+  SequenceStep,
+} from "../../../../sequence/types.js";
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { err, ok } from "./shared.js";
 
-export async function run(input: Record<string, unknown>, _context: ToolContext): Promise<ToolExecutionResult> {
+export async function run(
+  input: Record<string, unknown>,
+  _context: ToolContext,
+): Promise<ToolExecutionResult> {
   const id = input.id as string;
-  if (!id) return err('id is required.');
+  if (!id) return err("id is required.");
 
   const name = input.name as string | undefined;
   const description = input.description as string | undefined;
@@ -14,20 +23,30 @@ export async function run(input: Record<string, unknown>, _context: ToolContext)
   const stepsRaw = input.steps as Array<Record<string, unknown>> | undefined;
 
   try {
-    const steps = stepsRaw?.map((s, i): SequenceStep => ({
-      index: i,
-      delaySeconds: (s.delay_seconds as number) ?? 0,
-      subjectTemplate: (s.subject as string) ?? `Step ${i + 1}`,
-      bodyPrompt: (s.body_prompt as string) ?? '',
-      replyToThread: (s.reply_to_thread as boolean) ?? (i > 0),
-      requireApproval: (s.require_approval as boolean) ?? false,
-    }));
+    const steps = stepsRaw?.map(
+      (s, i): SequenceStep => ({
+        index: i,
+        delaySeconds: (s.delay_seconds as number) ?? 0,
+        subjectTemplate: (s.subject as string) ?? `Step ${i + 1}`,
+        bodyPrompt: (s.body_prompt as string) ?? "",
+        replyToThread: (s.reply_to_thread as boolean) ?? i > 0,
+        requireApproval: (s.require_approval as boolean) ?? false,
+      }),
+    );
 
     if (steps !== undefined && steps.length === 0) {
-      return err('steps must not be empty. A sequence requires at least one step.');
+      return err(
+        "steps must not be empty. A sequence requires at least one step.",
+      );
     }
 
-    const updated = updateSequence(id, { name, description, status, exitOnReply, steps });
+    const updated = updateSequence(id, {
+      name,
+      description,
+      status,
+      exitOnReply,
+      steps,
+    });
     if (!updated) return err(`Sequence not found: ${id}`);
 
     return ok(`Sequence updated: ${updated.name} (${updated.status})`);

package/src/config/bundled-skills/messaging/tools/shared.ts

@@ -2,12 +2,18 @@
  * Shared utilities for messaging skill tools.
  */
 
-import { request as httpsRequest, type RequestOptions as HttpsRequestOptions } from 'node:https';
+import {
+  request as httpsRequest,
+  type RequestOptions as HttpsRequestOptions,
+} from "node:https";
 
-import type { MessagingProvider } from '../../../../messaging/provider.js';
-import { getConnectedProviders,getMessagingProvider } from '../../../../messaging/registry.js';
-import { withValidToken } from '../../../../security/token-manager.js';
-import type { ToolExecutionResult } from '../../../../tools/types.js';
+import type { MessagingProvider } from "../../../../messaging/provider.js";
+import {
+  getConnectedProviders,
+  getMessagingProvider,
+} from "../../../../messaging/registry.js";
+import { withValidToken } from "../../../../security/token-manager.js";
+import type { ToolExecutionResult } from "../../../../tools/types.js";
 
 export function ok(content: string): ToolExecutionResult {
   return { content, isError: false };
@@ -29,11 +35,15 @@ export function resolveProvider(platformInput?: string): MessagingProvider {
   const connected = getConnectedProviders();
   if (connected.length === 1) return connected[0];
   if (connected.length === 0) {
-    throw new Error('No messaging platforms are connected. Use messaging_auth_test to check connection status, then set up a platform.');
+    throw new Error(
+      "No messaging platforms are connected. Use messaging_auth_test to check connection status, then set up a platform.",
+    );
   }
 
-  const names = connected.map((p) => `"${p.id}"`).join(', ');
-  throw new Error(`Multiple platforms connected (${names}). Specify platform parameter.`);
+  const names = connected.map((p) => `"${p.id}"`).join(", ");
+  throw new Error(
+    `Multiple platforms connected (${names}). Specify platform parameter.`,
+  );
 }
 
 /**
@@ -46,7 +56,7 @@ export async function withProviderToken<T>(
   fn: (token: string) => Promise<T>,
 ): Promise<T> {
   if (provider.isConnected?.()) {
-    return fn('');
+    return fn("");
   }
   return withValidToken(provider.credentialService, fn);
 }
@@ -55,11 +65,15 @@ export async function withProviderToken<T>(
 export function pinnedHttpsRequest(
   target: URL,
   resolvedAddress: string,
-  options?: { method?: string; headers?: Record<string, string>; body?: string },
+  options?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+  },
 ): Promise<number> {
   return new Promise((resolve, reject) => {
     const reqOpts: HttpsRequestOptions = {
-      method: options?.method ?? 'GET',
+      method: options?.method ?? "GET",
       hostname: resolvedAddress,
       port: target.port ? Number(target.port) : undefined,
       path: `${target.pathname}${target.search}`,
@@ -70,7 +84,7 @@ export function pinnedHttpsRequest(
       res.resume();
       resolve(res.statusCode ?? 0);
     });
-    req.once('error', reject);
+    req.once("error", reject);
     if (options?.body) req.write(options.body);
     req.end();
   });

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

@@ -2,7 +2,7 @@
 name: "Notifications"
 description: "Send notifications through the unified notification router"
 user-invocable: true
-metadata: {"vellum": {"emoji": "\ud83d\udd14"}}
+metadata: { "vellum": { "emoji": "\ud83d\udd14" } }
 ---
 
 Use `send_notification` for user-facing alerts and notifications. This tool routes through the unified notification pipeline, which handles channel selection, delivery, deduplication, and audit logging.
@@ -27,10 +27,11 @@ Thread grouping is handled by the LLM-powered decision engine, not by any parame
 **`source_event_name` is the primary grouping signal.** Use a stable event name for notifications that belong to the same logical stream (e.g. `dog.news.thread.reply` for all replies in a thread). Use a distinct event name when the notification represents a genuinely different kind of event.
 
 **Practical constraints:**
+
 - Thread candidates are scoped to the **last 24 hours** (max 5 per channel). You cannot reuse an old thread from days ago.
 - The engine will only reuse conversations originally created by the notification system (`source === 'notification'`). It will never append to a user-initiated conversation, even if it looks related.
 
 ## Important
 
 - Do **NOT** use AppleScript `display notification` or other OS-level notification commands for assistant-managed alerts. Always use `send_notification`.
-- For sending messages into a specific chat, email, or SMS destination, use the messaging skill's `messaging_send` instead.
+- For sending rich content (digests, summaries, reports) to a specific chat, email, or SMS destination, use the messaging skill's `messaging_send` instead. The decision engine rewrites `send_notification` content into short alerts, which strips rich formatting.

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

@@ -19,11 +19,7 @@
           },
           "urgency": {
             "type": "string",
-            "enum": [
-              "low",
-              "medium",
-              "high"
-            ],
+            "enum": ["low", "medium", "high"],
             "description": "Urgency hint (default: \"medium\")"
           },
           "requires_action": {
@@ -46,10 +42,7 @@
             "type": "array",
             "items": {
               "type": "string",
-              "enum": [
-                "vellum",
-                "telegram"
-              ]
+              "enum": ["vellum", "telegram", "slack"]
             },
             "description": "Optional routing hints for preferred channels (not deterministic)"
           },
@@ -72,12 +65,13 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": [
-          "message",
-          "confidence"
-        ]
+        "required": ["message", "confidence"]
       },
       "executor": "tools/send-notification.ts",
       "execution_target": "host"

package/src/config/bundled-skills/notifications/tools/send-notification.ts

@@ -1,48 +1,66 @@
-import { getDeliverableChannels } from '../../../../channels/config.js';
-import { emitNotificationSignal } from '../../../../notifications/emit-signal.js';
-import type { AttentionHints } from '../../../../notifications/signal.js';
-import type { NotificationChannel } from '../../../../notifications/types.js';
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { err, ok } from './shared.js';
-
-const INVALID = Symbol('invalid');
-
-const VALID_URGENCY = new Set<AttentionHints['urgency']>(['low', 'medium', 'high']);
-const VALID_CHANNEL_HINTS = new Set<NotificationChannel>(getDeliverableChannels() as NotificationChannel[]);
+import { getDeliverableChannels } from "../../../../channels/config.js";
+import { emitNotificationSignal } from "../../../../notifications/emit-signal.js";
+import type { AttentionHints } from "../../../../notifications/signal.js";
+import type { NotificationChannel } from "../../../../notifications/types.js";
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { err, ok } from "./shared.js";
+
+const INVALID = Symbol("invalid");
+
+const VALID_URGENCY = new Set<AttentionHints["urgency"]>([
+  "low",
+  "medium",
+  "high",
+]);
+const VALID_CHANNEL_HINTS = new Set<NotificationChannel>(
+  getDeliverableChannels() as NotificationChannel[],
+);
 
 function asNonEmptyString(value: unknown): string | undefined {
-  if (typeof value !== 'string') return undefined;
+  if (typeof value !== "string") return undefined;
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : undefined;
 }
 
 function parseBool(value: unknown, defaultValue: boolean): boolean {
-  return typeof value === 'boolean' ? value : defaultValue;
+  return typeof value === "boolean" ? value : defaultValue;
 }
 
 function parseDeadlineAt(value: unknown): number | undefined | typeof INVALID {
   if (value == null) return undefined;
-  if (typeof value === 'number' && Number.isFinite(value)) return Math.trunc(value);
-  if (typeof value === 'string') {
+  if (typeof value === "number" && Number.isFinite(value))
+    return Math.trunc(value);
+  if (typeof value === "string") {
     const parsed = Number(value);
     if (Number.isFinite(parsed)) return Math.trunc(parsed);
   }
   return INVALID;
 }
 
-function parseObject(value: unknown): Record<string, unknown> | undefined | typeof INVALID {
+function parseObject(
+  value: unknown,
+): Record<string, unknown> | undefined | typeof INVALID {
   if (value === undefined) return undefined;
-  if (!value || typeof value !== 'object' || Array.isArray(value)) return INVALID;
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return INVALID;
   return value as Record<string, unknown>;
 }
 
-function parsePreferredChannels(value: unknown): NotificationChannel[] | undefined | typeof INVALID {
+function parsePreferredChannels(
+  value: unknown,
+): NotificationChannel[] | undefined | typeof INVALID {
   if (value === undefined) return undefined;
   if (!Array.isArray(value)) return INVALID;
 
   const channels: NotificationChannel[] = [];
   for (const item of value) {
-    if (typeof item !== 'string' || !VALID_CHANNEL_HINTS.has(item as NotificationChannel)) {
+    if (
+      typeof item !== "string" ||
+      !VALID_CHANNEL_HINTS.has(item as NotificationChannel)
+    ) {
       return INVALID;
     }
     channels.push(item as NotificationChannel);
@@ -50,53 +68,68 @@ function parsePreferredChannels(value: unknown): NotificationChannel[] | undefin
   return [...new Set(channels)];
 }
 
-export async function run(input: Record<string, unknown>, context: ToolContext): Promise<ToolExecutionResult> {
+export async function run(
+  input: Record<string, unknown>,
+  context: ToolContext,
+): Promise<ToolExecutionResult> {
   const message = asNonEmptyString(input.message);
   if (!message) {
-    return err('message is required.');
+    return err("message is required.");
   }
 
   const urgencyInput = asNonEmptyString(input.urgency)?.toLowerCase();
-  if (urgencyInput && !VALID_URGENCY.has(urgencyInput as AttentionHints['urgency'])) {
-    return err('urgency must be one of: low, medium, high.');
+  if (
+    urgencyInput &&
+    !VALID_URGENCY.has(urgencyInput as AttentionHints["urgency"])
+  ) {
+    return err("urgency must be one of: low, medium, high.");
   }
-  const urgency = (urgencyInput as AttentionHints['urgency'] | undefined) ?? 'medium';
+  const urgency =
+    (urgencyInput as AttentionHints["urgency"] | undefined) ?? "medium";
 
   const deadlineAt = parseDeadlineAt(input.deadline_at);
   if (deadlineAt === INVALID) {
-    return err('deadline_at must be a valid epoch timestamp (milliseconds).');
+    return err("deadline_at must be a valid epoch timestamp (milliseconds).");
   }
 
   const deepLinkMetadata = parseObject(input.deep_link_metadata);
   if (deepLinkMetadata === INVALID) {
-    return err('deep_link_metadata must be an object.');
+    return err("deep_link_metadata must be an object.");
   }
 
   const preferredChannels = parsePreferredChannels(input.preferred_channels);
   if (preferredChannels === INVALID) {
-    return err(`preferred_channels must be an array containing only: ${[...VALID_CHANNEL_HINTS].join(', ')}.`);
+    return err(
+      `preferred_channels must be an array containing only: ${[
+        ...VALID_CHANNEL_HINTS,
+      ].join(", ")}.`,
+    );
   }
 
-  const sourceEventName = asNonEmptyString(input.source_event_name) ?? 'user.send_notification';
-  const requestedConversationId = asNonEmptyString(input.conversation_id) ?? context.conversationId;
+  const sourceEventName =
+    asNonEmptyString(input.source_event_name) ?? "user.send_notification";
+  const requestedConversationId =
+    asNonEmptyString(input.conversation_id) ?? context.conversationId;
   const sourceSessionId = requestedConversationId ?? context.sessionId;
   const title = asNonEmptyString(input.title);
   const dedupeKey = asNonEmptyString(input.dedupe_key);
 
   const contextPayload: Record<string, unknown> = {
     requestedMessage: message,
-    requestedByTool: 'send_notification',
+    requestedByTool: "send_notification",
     requestedBySessionId: context.sessionId,
   };
   if (title) contextPayload.requestedTitle = title;
-  if (requestedConversationId) contextPayload.requestedByConversationId = requestedConversationId;
-  if (preferredChannels && preferredChannels.length > 0) contextPayload.preferredChannels = preferredChannels;
+  if (requestedConversationId)
+    contextPayload.requestedByConversationId = requestedConversationId;
+  if (preferredChannels && preferredChannels.length > 0)
+    contextPayload.preferredChannels = preferredChannels;
   if (deepLinkMetadata) contextPayload.deepLinkMetadata = deepLinkMetadata;
 
   try {
     await emitNotificationSignal({
       sourceEventName,
-      sourceChannel: 'assistant_tool',
+      sourceChannel: "assistant_tool",
       sourceSessionId,
       assistantId: context.assistantId,
       attentionHints: {
@@ -111,7 +144,9 @@ export async function run(input: Record<string, unknown>, context: ToolContext):
       throwOnError: true,
     });
 
-    return ok('Notification request queued. Channel selection and delivery are handled by the notification router.');
+    return ok(
+      "Notification request queued. Channel selection and delivery are handled by the notification router.",
+    );
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
   }

package/src/config/bundled-skills/notifications/tools/shared.ts

@@ -2,7 +2,7 @@
  * Shared utilities for notifications skill tools.
  */
 
-import type { ToolExecutionResult } from '../../../../tools/types.js';
+import type { ToolExecutionResult } from "../../../../tools/types.js";
 
 export function ok(content: string): ToolExecutionResult {
   return { content, isError: false };

package/src/config/bundled-skills/phone-calls/SKILL.md

@@ -41,8 +41,7 @@ The user's assistant gets its own personal phone number through Twilio. All impl
 Check whether Twilio credentials, phone number, and public ingress are already configured:
 
 ```bash
-curl -s "$INTERNAL_GATEWAY_BASE_URL/v1/integrations/twilio/config" \
-  -H "Authorization: Bearer $GATEWAY_AUTH_TOKEN"
+vellum integrations twilio config --json
 ```
 
 ```bash
@@ -103,28 +102,28 @@ Present these voices grouped by category:
 
 #### Female voices
 
-| Voice     | Style                          | Voice ID                       |
-| --------- | ------------------------------ | ------------------------------ |
-| Rachel    | Calm, warm, conversational     | `21m00Tcm4TlvDq8ikWAM`        |
-| Sarah     | Soft, young, approachable      | `EXAVITQu4vr4xnSDxMaL`        |
-| Charlotte | Warm, Swedish-accented         | `XB0fDUnXU5powFXDhCwa`        |
-| Alice     | Confident, British             | `Xb7hH8MSUJpSbSDYk0k2`        |
-| Matilda   | Warm, friendly, young          | `XrExE9yKIg1WjnnlVkGX`        |
-| Lily      | Warm, British                  | `pFZP5JQG7iQjIQuC4Bku`        |
+| Voice     | Style                      | Voice ID               |
+| --------- | -------------------------- | ---------------------- |
+| Rachel    | Calm, warm, conversational | `21m00Tcm4TlvDq8ikWAM` |
+| Sarah     | Soft, young, approachable  | `EXAVITQu4vr4xnSDxMaL` |
+| Charlotte | Warm, Swedish-accented     | `XB0fDUnXU5powFXDhCwa` |
+| Alice     | Confident, British         | `Xb7hH8MSUJpSbSDYk0k2` |
+| Matilda   | Warm, friendly, young      | `XrExE9yKIg1WjnnlVkGX` |
+| Lily      | Warm, British              | `pFZP5JQG7iQjIQuC4Bku` |
 
 #### Male voices
 
-| Voice   | Style                            | Voice ID                       |
-| ------- | -------------------------------- | ------------------------------ |
-| Antoni  | Warm, well-rounded               | `ErXwobaYiN019PkySvjV`        |
-| Josh    | Deep, young, clear               | `TxGEqnHWrfWFTfGW9XjX`       |
-| Arnold  | Crisp, narrative                  | `VR6AewLTigWG4xSOukaG`        |
-| Adam    | Deep, middle-aged, professional  | `pNInz6obpgDQGcFmaJgB`        |
-| Bill    | Trustworthy, American            | `pqHfZKP75CvOlQylNhV4`        |
-| George  | Warm, British, distinguished     | `JBFqnCBsd6RMkjVDRZzb`        |
-| Daniel  | Authoritative, British           | `onwK4e9ZLuTAKqWW03F9`        |
-| Charlie | Casual, Australian               | `IKne3meq5aSn9XLyUdCD`        |
-| Liam    | Young, articulate                | `TX3LPaxmHKxFdv7VOQHJ`        |
+| Voice   | Style                           | Voice ID               |
+| ------- | ------------------------------- | ---------------------- |
+| Antoni  | Warm, well-rounded              | `ErXwobaYiN019PkySvjV` |
+| Josh    | Deep, young, clear              | `TxGEqnHWrfWFTfGW9XjX` |
+| Arnold  | Crisp, narrative                | `VR6AewLTigWG4xSOukaG` |
+| Adam    | Deep, middle-aged, professional | `pNInz6obpgDQGcFmaJgB` |
+| Bill    | Trustworthy, American           | `pqHfZKP75CvOlQylNhV4` |
+| George  | Warm, British, distinguished    | `JBFqnCBsd6RMkjVDRZzb` |
+| Daniel  | Authoritative, British          | `onwK4e9ZLuTAKqWW03F9` |
+| Charlie | Casual, Australian              | `IKne3meq5aSn9XLyUdCD` |
+| Liam    | Young, articulate               | `TX3LPaxmHKxFdv7VOQHJ` |
 
 After the user picks a voice, use `voice_config_update` to set the shared voice ID. This writes to the config file (`elevenlabs.voiceId`) for phone calls **and** pushes to the macOS app via IPC (`ttsVoiceId`) for in-app TTS in one call:
 
@@ -138,7 +137,7 @@ voice_config_update setting="tts_voice_id" value="<selected-voice-id>"
 
 Before making real calls, offer a quick verification:
 
-1. Confirm credentials are stored: check the Twilio config endpoint for `hasCredentials: true` and `phoneNumber`
+1. Confirm credentials are stored: run `vellum integrations twilio config --json` and verify `hasCredentials: true` plus `phoneNumber`
 2. Confirm ingress is running: `ingress.publicBaseUrl` must be set and the tunnel active
 3. Confirm calls are enabled: `calls.enabled` must be `true`
 4. Confirm voice is configured: `elevenlabs.voiceId` should be set
@@ -479,13 +478,13 @@ sqlite3 ~/.vellum/workspace/data/db/assistant.db \
 
 ### Key paths
 
-| Resource                                   | Path                                       |
-| ------------------------------------------ | ------------------------------------------ |
-| Daemon logs (caller-side transcripts only) | `~/.vellum/workspace/data/logs/vellum.log` |
-| Full conversation database                 | `~/.vellum/workspace/data/db/assistant.db` |
-| Messages table                             | `messages` (keyed by `conversation_id`)    |
-| Call sessions table                        | `call_sessions`                            |
-| Call events table                          | `call_events`                              |
+| Resource                                      | Path                                       |
+| --------------------------------------------- | ------------------------------------------ |
+| Assistant logs (caller-side transcripts only) | `~/.vellum/workspace/data/logs/vellum.log` |
+| Full conversation database                    | `~/.vellum/workspace/data/db/assistant.db` |
+| Messages table                                | `messages` (keyed by `conversation_id`)    |
+| Call sessions table                           | `call_sessions`                            |
+| Call events table                             | `call_events`                              |
 
 ### Important
 
@@ -540,24 +539,24 @@ The `context` field is powerful — use it to give the agent background that hel
 
 All call-related settings can be managed via `vellum config`:
 
-| Setting                                     | Description                                                                                                | Default                                                                                                  |
-| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
-| `calls.enabled`                             | Master switch for the calling feature                                                                      | `false`                                                                                                  |
-| `calls.provider`                            | Voice provider (currently only `twilio`)                                                                   | `twilio`                                                                                                 |
-| `calls.maxDurationSeconds`                  | Maximum call length in seconds                                                                             | `3600` (1 hour)                                                                                          |
-| `calls.userConsultTimeoutSeconds`           | How long to wait for user answers                                                                          | `120` (2 min)                                                                                            |
-| `calls.disclosure.enabled`                  | Whether the AI announces itself at call start                                                              | `true`                                                                                                   |
-| `calls.disclosure.text`                     | The disclosure message spoken at call start                                                                | `"At the very beginning of the call, introduce yourself as an assistant calling on behalf of my human."` |
-| `calls.model`                               | Override LLM model for call orchestration                                                                  | _(uses default model)_                                                                                   |
-| `calls.callerIdentity.allowPerCallOverride` | Allow per-call caller identity selection                                                                   | `true`                                                                                                   |
-| `calls.callerIdentity.userNumber`           | E.164 phone number for user-number mode                                                                    | _(empty)_                                                                                                |
-| `calls.voice.language`                      | Language code for TTS and transcription                                                                    | `en-US`                                                                                                  |
-| `calls.voice.transcriptionProvider`         | Speech-to-text provider (`Deepgram`, `Google`)                                                             | `Deepgram`                                                                                               |
-| `elevenlabs.voiceId`                        | ElevenLabs voice ID used by both in-app TTS and phone calls. Set during setup from the curated voice list. Defaults to Rachel  | `21m00Tcm4TlvDq8ikWAM`                                                                                  |
-| `elevenlabs.voiceModelId`                   | Optional Twilio ConversationRelay model suffix. Leave empty to send bare `voiceId`                         | _(empty)_                                                                                                |
-| `elevenlabs.speed`                          | Playback speed (`0.7` – `1.2`)                                                                             | `1.0`                                                                                                    |
-| `elevenlabs.stability`                      | Voice stability (`0.0` – `1.0`)                                                                            | `0.5`                                                                                                    |
-| `elevenlabs.similarityBoost`                | Voice similarity boost (`0.0` – `1.0`)                                                                     | `0.75`                                                                                                   |
+| Setting                                     | Description                                                                                                                   | Default                                                                                                  |
+| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `calls.enabled`                             | Master switch for the calling feature                                                                                         | `false`                                                                                                  |
+| `calls.provider`                            | Voice provider (currently only `twilio`)                                                                                      | `twilio`                                                                                                 |
+| `calls.maxDurationSeconds`                  | Maximum call length in seconds                                                                                                | `3600` (1 hour)                                                                                          |
+| `calls.userConsultTimeoutSeconds`           | How long to wait for user answers                                                                                             | `120` (2 min)                                                                                            |
+| `calls.disclosure.enabled`                  | Whether the AI announces itself at call start                                                                                 | `true`                                                                                                   |
+| `calls.disclosure.text`                     | The disclosure message spoken at call start                                                                                   | `"At the very beginning of the call, introduce yourself as an assistant calling on behalf of my human."` |
+| `calls.model`                               | Override LLM model for call orchestration                                                                                     | _(uses default model)_                                                                                   |
+| `calls.callerIdentity.allowPerCallOverride` | Allow per-call caller identity selection                                                                                      | `true`                                                                                                   |
+| `calls.callerIdentity.userNumber`           | E.164 phone number for user-number mode                                                                                       | _(empty)_                                                                                                |
+| `calls.voice.language`                      | Language code for TTS and transcription                                                                                       | `en-US`                                                                                                  |
+| `calls.voice.transcriptionProvider`         | Speech-to-text provider (`Deepgram`, `Google`)                                                                                | `Deepgram`                                                                                               |
+| `elevenlabs.voiceId`                        | ElevenLabs voice ID used by both in-app TTS and phone calls. Set during setup from the curated voice list. Defaults to Rachel | `21m00Tcm4TlvDq8ikWAM`                                                                                   |
+| `elevenlabs.voiceModelId`                   | Optional Twilio ConversationRelay model suffix. Leave empty to send bare `voiceId`                                            | _(empty)_                                                                                                |
+| `elevenlabs.speed`                          | Playback speed (`0.7` – `1.2`)                                                                                                | `1.0`                                                                                                    |
+| `elevenlabs.stability`                      | Voice stability (`0.0` – `1.0`)                                                                                               | `0.5`                                                                                                    |
+| `elevenlabs.similarityBoost`                | Voice similarity boost (`0.0` – `1.0`)                                                                                        | `0.75`                                                                                                   |
 
 ### Adjusting settings
 
@@ -642,4 +641,3 @@ The system has a 30-second silence timeout. If nobody speaks for 30 seconds duri
 - Keep `elevenlabs.voiceModelId` empty first (bare `voiceId` mode)
 - If you set `voiceModelId`, try clearing it and retesting:
   `vellum config set elevenlabs.voiceModelId ""`
-

package/src/config/bundled-skills/phone-calls/TOOLS.json

@@ -25,6 +25,10 @@
             "type": "string",
             "enum": ["assistant_number", "user_number"],
             "description": "Which phone number to use as the caller ID. assistant_number uses the AI assistant's Twilio number; user_number uses the user's verified personal number."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["phone_number", "task"]
@@ -43,6 +47,10 @@
           "call_session_id": {
             "type": "string",
             "description": "Specific call session ID to check. If omitted, checks for an active call in the current conversation."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -62,9 +70,13 @@
             "type": "string",
             "description": "The call session ID to end"
           },
-          "reason": {
+          "end_reason": {
             "type": "string",
             "description": "Reason for ending the call"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["call_session_id"]

package/src/config/bundled-skills/phone-calls/tools/call-end.ts

@@ -1,3 +1,3 @@
-import { executeCallEnd } from '../../../../tools/calls/call-end.js';
+import { executeCallEnd } from "../../../../tools/calls/call-end.js";
 
 export { executeCallEnd as run };

package/src/config/bundled-skills/phone-calls/tools/call-start.ts

@@ -1,3 +1,3 @@
-import { executeCallStart } from '../../../../tools/calls/call-start.js';
+import { executeCallStart } from "../../../../tools/calls/call-start.js";
 
 export { executeCallStart as run };