@vellumai/assistant 0.4.26 → 0.4.30

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

@@ -2,7 +2,7 @@
 name: "X"
 description: "Read and post on X (formerly Twitter) via OAuth or browser session"
 user-invocable: true
-metadata: {"vellum": {"emoji": "𝕏"}}
+metadata: { "vellum": { "emoji": "𝕏" } }
 ---
 
 You are an X (formerly Twitter) assistant. Use the `execute_bash` tool to run `vellum x` CLI commands.
@@ -39,9 +39,11 @@ When the strategy is `auto` (the default), the router tries OAuth first for supp
 When the user triggers a Twitter operation and no strategy has been configured yet, follow these steps:
 
 1. **Check current status:**
+
    ```bash
    vellum x status --json
    ```
+
    Look at `oauthConnected`, `browserSessionActive`, `preferredStrategy`, and `strategyConfigured` in the response. If `strategyConfigured` is `false`, the user has not yet chosen a strategy and should be guided through setup.
 
 2. **Present both options with trade-offs:**
@@ -84,7 +86,7 @@ When a Twitter operation fails, follow these steps:
    - `OAuth is not configured` — the user chose OAuth but credentials are not set up.
    - `Twitter API error (401)` — OAuth token may be expired or revoked.
    - `UnsupportedOAuthOperationError` — the requested write operation is not available via OAuth.
-   - `Cannot connect to daemon` — the Vellum daemon is not running.
+   - `Cannot connect to assistant` — the Vellum assistant is not running.
 
 2. **Explain the likely cause clearly** to the user.
 
@@ -94,6 +96,7 @@ When a Twitter operation fails, follow these steps:
    - If the operation is unsupported via OAuth: explain that this write operation is not yet supported via OAuth, and suggest using the browser path with `vellum x strategy set browser`.
 
 4. **Offer concrete steps to switch:**
+
    ```bash
    # Switch to the other strategy
    vellum x strategy set <oauth|browser|auto>
@@ -140,54 +143,68 @@ Like `post`, the `reply` command routes through the strategy router and returns
 Read-only operations always use the browser path directly, regardless of the strategy setting. They work the same whether the strategy is `oauth`, `browser`, or `auto` — the strategy only affects `post` and `reply` commands.
 
 ### User timeline
+
 ```bash
 vellum x timeline <screenName> [--count N]
 ```
+
 Returns `user` and `tweets` array.
 
 ### Single tweet + replies
+
 ```bash
 vellum x tweet <tweetIdOrUrl>
 ```
+
 Returns the focal tweet and its reply thread.
 
 ### Search
+
 ```bash
 vellum x search "query" [--count N] [--product Top|Latest|People|Media]
 ```
 
 ### Home timeline
+
 ```bash
 vellum x home [--count N]
 ```
 
 ### Bookmarks
+
 ```bash
 vellum x bookmarks [--count N]
 ```
 
 ### Notifications
+
 ```bash
 vellum x notifications [--count N]
 ```
+
 Returns `notifications` array with `id`, `message`, `timestamp`, `url`.
 
 ### Likes
+
 ```bash
 vellum x likes <screenName> [--count N]
 ```
 
 ### Followers / Following
+
 ```bash
 vellum x followers <screenName> [--count N]
 vellum x following <screenName> [--count N]
 ```
+
 Returns `user` and `followers`/`following` array (userId, screenName, name).
 
 ### Media
+
 ```bash
 vellum x media <screenName> [--count N]
 ```
+
 Returns tweets that contain media from the user's profile.
 
 ## Workflows

package/src/config/bundled-skills/voice-setup/SKILL.md

@@ -73,10 +73,10 @@ After storing the API key, let the user pick their preferred voice. The shared c
 Check the current voice:
 
 ```bash
-vellum config get elevenlabs.voiceId
+vellum integrations voice config --json
 ```
 
-Ask the user if they want to change their TTS voice. If yes, use `voice_config_update` with `setting: "tts_voice_id"` and the chosen voice ID. This writes to both the config file (`elevenlabs.voiceId`) and pushes to the macOS app via IPC in one call.
+Use `voiceId` from the response as the current selection (and `usesDefaultVoice` to know if Rachel is still in use by default). Ask the user if they want to change their TTS voice. If yes, use `voice_config_update` with `setting: "tts_voice_id"` and the chosen voice ID. This writes to both the config file (`elevenlabs.voiceId`) and pushes to the macOS app via IPC in one call.
 
 Common choices from the curated ElevenLabs list:
 - **Rachel** (`21m00Tcm4TlvDq8ikWAM`) — Calm, warm, conversational (default)
@@ -92,13 +92,13 @@ If the user wants to browse more voices, they can search at https://elevenlabs.i
 After setting the voice, check whether phone calls are configured:
 
 ```bash
-vellum config get calls.enabled
+vellum integrations voice config --json
 ```
 
-**If phone calls are enabled** (`calls.enabled` is `true`):
+**If phone calls are enabled** (`callsEnabled` is `true`):
 - Tell the user their phone calls will automatically use the same voice they just chose, since both in-app TTS and phone calls read from `elevenlabs.voiceId`.
 
-**If phone calls are not yet configured** (`calls.enabled` is `false` or not set):
+**If phone calls are not yet configured** (`callsEnabled` is `false`):
 - Tell the user: "When you set up phone calls later, they'll automatically use the same voice for a consistent experience."
 
 ### 5. Verification

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

@@ -32,6 +32,10 @@
           "config": {
             "type": "object",
             "description": "Provider-specific configuration (e.g. filter criteria)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["name", "provider", "action_prompt"]
@@ -54,6 +58,10 @@
           "enabled_only": {
             "type": "boolean",
             "description": "When true, only show enabled watchers. Defaults to false."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -92,6 +100,10 @@
           "config": {
             "type": "object",
             "description": "New provider-specific configuration"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["watcher_id"]
@@ -110,6 +122,10 @@
           "watcher_id": {
             "type": "string",
             "description": "The ID of the watcher to delete"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["watcher_id"]
@@ -136,6 +152,10 @@
           "limit": {
             "type": "number",
             "description": "Maximum number of events to return. Defaults to 50."
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []

package/src/config/bundled-skills/watcher/tools/watcher-create.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeWatcherCreate } from '../../../../tools/watcher/create.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeWatcherCreate } from "../../../../tools/watcher/create.js";
 
 export async function run(
   input: Record<string, unknown>,

package/src/config/bundled-skills/watcher/tools/watcher-delete.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeWatcherDelete } from '../../../../tools/watcher/delete.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeWatcherDelete } from "../../../../tools/watcher/delete.js";
 
 export async function run(
   input: Record<string, unknown>,

package/src/config/bundled-skills/watcher/tools/watcher-digest.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeWatcherDigest } from '../../../../tools/watcher/digest.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeWatcherDigest } from "../../../../tools/watcher/digest.js";
 
 export async function run(
   input: Record<string, unknown>,

package/src/config/bundled-skills/watcher/tools/watcher-list.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeWatcherList } from '../../../../tools/watcher/list.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeWatcherList } from "../../../../tools/watcher/list.js";
 
 export async function run(
   input: Record<string, unknown>,

package/src/config/bundled-skills/watcher/tools/watcher-update.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeWatcherUpdate } from '../../../../tools/watcher/update.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeWatcherUpdate } from "../../../../tools/watcher/update.js";
 
 export async function run(
   input: Record<string, unknown>,

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

@@ -21,6 +21,10 @@
           "days": {
             "type": "number",
             "description": "Number of forecast days to return (1-16, default: 10)"
+          },
+          "reason": {
+            "type": "string",
+            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["location"]

package/src/config/bundled-skills/weather/tools/get-weather.ts

@@ -1,5 +1,8 @@
-import type { ToolContext, ToolExecutionResult } from '../../../../tools/types.js';
-import { executeGetWeather } from '../../../../tools/weather/service.js';
+import type {
+  ToolContext,
+  ToolExecutionResult,
+} from "../../../../tools/types.js";
+import { executeGetWeather } from "../../../../tools/weather/service.js";
 
 export async function run(
   input: Record<string, unknown>,

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

@@ -146,6 +146,7 @@ import * as scheduleUpdate from "./bundled-skills/schedule/tools/schedule-update
 // ── slack ────────────────────────────────────────────────────────────────────
 import * as slackAddReaction from "./bundled-skills/slack/tools/slack-add-reaction.js";
 import * as slackChannelDetails from "./bundled-skills/slack/tools/slack-channel-details.js";
+import * as slackChannelPermissions from "./bundled-skills/slack/tools/slack-channel-permissions.js";
 import * as slackConfigureChannels from "./bundled-skills/slack/tools/slack-configure-channels.js";
 import * as slackDeleteMessage from "./bundled-skills/slack/tools/slack-delete-message.js";
 import * as slackLeaveChannel from "./bundled-skills/slack/tools/slack-leave-channel.js";
@@ -345,6 +346,7 @@ export const bundledToolRegistry = new Map<string, SkillToolScript>([
   ["slack:tools/slack-add-reaction.ts", slackAddReaction],
   ["slack:tools/slack-delete-message.ts", slackDeleteMessage],
   ["slack:tools/slack-leave-channel.ts", slackLeaveChannel],
+  ["slack:tools/slack-channel-permissions.ts", slackChannelPermissions],
 
   // subagent
   ["subagent:tools/subagent-spawn.ts", subagentSpawn],

package/src/config/calls-schema.ts

@@ -1,125 +1,168 @@
-import { z } from 'zod';
+import { z } from "zod";
 
-const VALID_CALL_PROVIDERS = ['twilio'] as const;
-export const VALID_CALLER_IDENTITY_MODES = ['assistant_number', 'user_number'] as const;
-const VALID_CALL_TRANSCRIPTION_PROVIDERS = ['Deepgram', 'Google'] as const;
+const VALID_CALL_PROVIDERS = ["twilio"] as const;
+export const VALID_CALLER_IDENTITY_MODES = [
+  "assistant_number",
+  "user_number",
+] as const;
+const VALID_CALL_TRANSCRIPTION_PROVIDERS = ["Deepgram", "Google"] as const;
 
 export const CallsDisclosureConfigSchema = z.object({
   enabled: z
-    .boolean({ error: 'calls.disclosure.enabled must be a boolean' })
+    .boolean({ error: "calls.disclosure.enabled must be a boolean" })
     .default(true),
   text: z
-    .string({ error: 'calls.disclosure.text must be a string' })
-    .default('At the very beginning of the call, introduce yourself as an assistant calling on behalf of the person you represent. Do not say "AI assistant".'),
+    .string({ error: "calls.disclosure.text must be a string" })
+    .default(
+      'At the very beginning of the call, introduce yourself as an assistant calling on behalf of the person you represent. Do not say "AI assistant".',
+    ),
 });
 
 export const CallsSafetyConfigSchema = z.object({
   denyCategories: z
-    .array(z.string({ error: 'calls.safety.denyCategories values must be strings' }))
+    .array(
+      z.string({ error: "calls.safety.denyCategories values must be strings" }),
+    )
     .default([]),
 });
 
 export const CallsVoiceConfigSchema = z.object({
   language: z
-    .string({ error: 'calls.voice.language must be a string' })
-    .default('en-US'),
+    .string({ error: "calls.voice.language must be a string" })
+    .default("en-US"),
   transcriptionProvider: z
     .enum(VALID_CALL_TRANSCRIPTION_PROVIDERS, {
-      error: `calls.voice.transcriptionProvider must be one of: ${VALID_CALL_TRANSCRIPTION_PROVIDERS.join(', ')}`,
+      error: `calls.voice.transcriptionProvider must be one of: ${VALID_CALL_TRANSCRIPTION_PROVIDERS.join(
+        ", ",
+      )}`,
     })
-    .default('Deepgram'),
+    .default("Deepgram"),
 });
 
 export const CallerIdentityConfigSchema = z.object({
   allowPerCallOverride: z
-    .boolean({ error: 'calls.callerIdentity.allowPerCallOverride must be a boolean' })
+    .boolean({
+      error: "calls.callerIdentity.allowPerCallOverride must be a boolean",
+    })
     .default(true),
   userNumber: z
-    .string({ error: 'calls.callerIdentity.userNumber must be a string' })
+    .string({ error: "calls.callerIdentity.userNumber must be a string" })
     .optional(),
 });
 
 export const CallsVerificationConfigSchema = z.object({
   enabled: z
-    .boolean({ error: 'calls.verification.enabled must be a boolean' })
+    .boolean({ error: "calls.verification.enabled must be a boolean" })
     .default(false),
   maxAttempts: z
-    .number({ error: 'calls.verification.maxAttempts must be a number' })
-    .int('calls.verification.maxAttempts must be an integer')
-    .positive('calls.verification.maxAttempts must be a positive integer')
+    .number({ error: "calls.verification.maxAttempts must be a number" })
+    .int("calls.verification.maxAttempts must be an integer")
+    .positive("calls.verification.maxAttempts must be a positive integer")
     .default(3),
   codeLength: z
-    .number({ error: 'calls.verification.codeLength must be a number' })
-    .int('calls.verification.codeLength must be an integer')
-    .positive('calls.verification.codeLength must be a positive integer')
+    .number({ error: "calls.verification.codeLength must be a number" })
+    .int("calls.verification.codeLength must be an integer")
+    .positive("calls.verification.codeLength must be a positive integer")
     .default(6),
 });
 
 export const CallsConfigSchema = z.object({
   enabled: z
-    .boolean({ error: 'calls.enabled must be a boolean' })
+    .boolean({ error: "calls.enabled must be a boolean" })
     .default(true),
   provider: z
     .enum(VALID_CALL_PROVIDERS, {
-      error: `calls.provider must be one of: ${VALID_CALL_PROVIDERS.join(', ')}`,
+      error: `calls.provider must be one of: ${VALID_CALL_PROVIDERS.join(
+        ", ",
+      )}`,
     })
-    .default('twilio'),
+    .default("twilio"),
   maxDurationSeconds: z
-    .number({ error: 'calls.maxDurationSeconds must be a number' })
-    .int('calls.maxDurationSeconds must be an integer')
-    .positive('calls.maxDurationSeconds must be a positive integer')
-    .max(2_147_483, 'calls.maxDurationSeconds must be at most 2147483 (setTimeout-safe limit)')
+    .number({ error: "calls.maxDurationSeconds must be a number" })
+    .int("calls.maxDurationSeconds must be an integer")
+    .positive("calls.maxDurationSeconds must be a positive integer")
+    .max(
+      2_147_483,
+      "calls.maxDurationSeconds must be at most 2147483 (setTimeout-safe limit)",
+    )
     .default(3600),
   userConsultTimeoutSeconds: z
-    .number({ error: 'calls.userConsultTimeoutSeconds must be a number' })
-    .int('calls.userConsultTimeoutSeconds must be an integer')
-    .positive('calls.userConsultTimeoutSeconds must be a positive integer')
-    .max(2_147_483, 'calls.userConsultTimeoutSeconds must be at most 2147483 (setTimeout-safe limit)')
+    .number({ error: "calls.userConsultTimeoutSeconds must be a number" })
+    .int("calls.userConsultTimeoutSeconds must be an integer")
+    .positive("calls.userConsultTimeoutSeconds must be a positive integer")
+    .max(
+      2_147_483,
+      "calls.userConsultTimeoutSeconds must be at most 2147483 (setTimeout-safe limit)",
+    )
     .default(120),
   ttsPlaybackDelayMs: z
-    .number({ error: 'calls.ttsPlaybackDelayMs must be a number' })
-    .int('calls.ttsPlaybackDelayMs must be an integer')
-    .min(0, 'calls.ttsPlaybackDelayMs must be >= 0')
-    .max(10_000, 'calls.ttsPlaybackDelayMs must be at most 10000')
+    .number({ error: "calls.ttsPlaybackDelayMs must be a number" })
+    .int("calls.ttsPlaybackDelayMs must be an integer")
+    .min(0, "calls.ttsPlaybackDelayMs must be >= 0")
+    .max(10_000, "calls.ttsPlaybackDelayMs must be at most 10000")
     .default(3000),
   accessRequestPollIntervalMs: z
-    .number({ error: 'calls.accessRequestPollIntervalMs must be a number' })
-    .int('calls.accessRequestPollIntervalMs must be an integer')
-    .min(50, 'calls.accessRequestPollIntervalMs must be >= 50')
-    .max(10_000, 'calls.accessRequestPollIntervalMs must be at most 10000')
+    .number({ error: "calls.accessRequestPollIntervalMs must be a number" })
+    .int("calls.accessRequestPollIntervalMs must be an integer")
+    .min(50, "calls.accessRequestPollIntervalMs must be >= 50")
+    .max(10_000, "calls.accessRequestPollIntervalMs must be at most 10000")
     .default(500),
   guardianWaitUpdateInitialIntervalMs: z
-    .number({ error: 'calls.guardianWaitUpdateInitialIntervalMs must be a number' })
-    .int('calls.guardianWaitUpdateInitialIntervalMs must be an integer')
-    .min(1000, 'calls.guardianWaitUpdateInitialIntervalMs must be >= 1000')
-    .max(60_000, 'calls.guardianWaitUpdateInitialIntervalMs must be at most 60000')
+    .number({
+      error: "calls.guardianWaitUpdateInitialIntervalMs must be a number",
+    })
+    .int("calls.guardianWaitUpdateInitialIntervalMs must be an integer")
+    .min(1000, "calls.guardianWaitUpdateInitialIntervalMs must be >= 1000")
+    .max(
+      60_000,
+      "calls.guardianWaitUpdateInitialIntervalMs must be at most 60000",
+    )
     .default(15_000),
   guardianWaitUpdateInitialWindowMs: z
-    .number({ error: 'calls.guardianWaitUpdateInitialWindowMs must be a number' })
-    .int('calls.guardianWaitUpdateInitialWindowMs must be an integer')
-    .min(1000, 'calls.guardianWaitUpdateInitialWindowMs must be >= 1000')
-    .max(60_000, 'calls.guardianWaitUpdateInitialWindowMs must be at most 60000')
+    .number({
+      error: "calls.guardianWaitUpdateInitialWindowMs must be a number",
+    })
+    .int("calls.guardianWaitUpdateInitialWindowMs must be an integer")
+    .min(1000, "calls.guardianWaitUpdateInitialWindowMs must be >= 1000")
+    .max(
+      60_000,
+      "calls.guardianWaitUpdateInitialWindowMs must be at most 60000",
+    )
     .default(30_000),
   guardianWaitUpdateSteadyMinIntervalMs: z
-    .number({ error: 'calls.guardianWaitUpdateSteadyMinIntervalMs must be a number' })
-    .int('calls.guardianWaitUpdateSteadyMinIntervalMs must be an integer')
-    .min(1000, 'calls.guardianWaitUpdateSteadyMinIntervalMs must be >= 1000')
-    .max(60_000, 'calls.guardianWaitUpdateSteadyMinIntervalMs must be at most 60000')
+    .number({
+      error: "calls.guardianWaitUpdateSteadyMinIntervalMs must be a number",
+    })
+    .int("calls.guardianWaitUpdateSteadyMinIntervalMs must be an integer")
+    .min(1000, "calls.guardianWaitUpdateSteadyMinIntervalMs must be >= 1000")
+    .max(
+      60_000,
+      "calls.guardianWaitUpdateSteadyMinIntervalMs must be at most 60000",
+    )
     .default(20_000),
   guardianWaitUpdateSteadyMaxIntervalMs: z
-    .number({ error: 'calls.guardianWaitUpdateSteadyMaxIntervalMs must be a number' })
-    .int('calls.guardianWaitUpdateSteadyMaxIntervalMs must be an integer')
-    .min(1000, 'calls.guardianWaitUpdateSteadyMaxIntervalMs must be >= 1000')
-    .max(60_000, 'calls.guardianWaitUpdateSteadyMaxIntervalMs must be at most 60000')
+    .number({
+      error: "calls.guardianWaitUpdateSteadyMaxIntervalMs must be a number",
+    })
+    .int("calls.guardianWaitUpdateSteadyMaxIntervalMs must be an integer")
+    .min(1000, "calls.guardianWaitUpdateSteadyMaxIntervalMs must be >= 1000")
+    .max(
+      60_000,
+      "calls.guardianWaitUpdateSteadyMaxIntervalMs must be at most 60000",
+    )
     .default(30_000),
-  disclosure: CallsDisclosureConfigSchema.default(CallsDisclosureConfigSchema.parse({})),
+  disclosure: CallsDisclosureConfigSchema.default(
+    CallsDisclosureConfigSchema.parse({}),
+  ),
   safety: CallsSafetyConfigSchema.default(CallsSafetyConfigSchema.parse({})),
   voice: CallsVoiceConfigSchema.default(CallsVoiceConfigSchema.parse({})),
-  model: z
-    .string({ error: 'calls.model must be a string' })
-    .optional(),
-  callerIdentity: CallerIdentityConfigSchema.default(CallerIdentityConfigSchema.parse({})),
-  verification: CallsVerificationConfigSchema.default(CallsVerificationConfigSchema.parse({})),
+  model: z.string({ error: "calls.model must be a string" }).optional(),
+  callerIdentity: CallerIdentityConfigSchema.default(
+    CallerIdentityConfigSchema.parse({}),
+  ),
+  verification: CallsVerificationConfigSchema.default(
+    CallsVerificationConfigSchema.parse({}),
+  ),
 });
 
 export type CallsConfig = z.infer<typeof CallsConfigSchema>;
@@ -127,4 +170,6 @@ export type CallsDisclosureConfig = z.infer<typeof CallsDisclosureConfigSchema>;
 export type CallsSafetyConfig = z.infer<typeof CallsSafetyConfigSchema>;
 export type CallsVoiceConfig = z.infer<typeof CallsVoiceConfigSchema>;
 export type CallerIdentityConfig = z.infer<typeof CallerIdentityConfigSchema>;
-export type CallsVerificationConfig = z.infer<typeof CallsVerificationConfigSchema>;
+export type CallsVerificationConfig = z.infer<
+  typeof CallsVerificationConfigSchema
+>;