@vellumai/assistant 0.7.1 → 0.7.3

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

@@ -51,10 +51,6 @@
               },
               "required": ["type", "address"]
             }
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["display_name"]
@@ -85,10 +81,6 @@
           "limit": {
             "type": "number",
             "description": "Maximum results to return (default 20, max 100)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -111,10 +103,6 @@
           "merge_id": {
             "type": "string",
             "description": "ID of the contact to merge into the kept contact (will be deleted)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["keep_id", "merge_id"]
@@ -147,10 +135,6 @@
             "type": "string",
             "description": "Pagination token (for list)"
           },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
           "account": {
             "type": "string",
             "description": "Email address of the Gmail account to use. Required when multiple Gmail accounts are connected. If omitted, uses the most recently connected account."

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

@@ -16,10 +16,6 @@
           "initial_content": {
             "type": "string",
             "description": "Initial Markdown content to populate the editor (optional)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -46,10 +42,6 @@
             "type": "string",
             "enum": ["replace", "append"],
             "description": "Whether to replace all content or append to the end. Defaults to append."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["surface_id", "content"]

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

@@ -28,10 +28,6 @@
           "reminder_schedule_id": {
             "type": "string",
             "description": "Optional recurrence schedule ID to fire a reminder when overdue"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["channel", "conversation_id"]
@@ -63,10 +59,6 @@
           "overdue_only": {
             "type": "boolean",
             "description": "When true, return only pending follow-ups past their expected response deadline"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -93,10 +85,6 @@
           "conversation_id": {
             "type": "string",
             "description": "Conversation ID to match (used with channel for auto-resolution)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []

package/src/config/bundled-skills/image-studio/SKILL.md

@@ -6,6 +6,10 @@ metadata:
   emoji: "🎨"
   vellum:
     display-name: "Image Studio"
+    activation-hints:
+      - "User asks to generate, draw, or create an image from a text prompt"
+      - "User wants to edit an existing image — background removal, in-painting, style change, retouching"
+      - "User wants multiple variations of a visual (logo concepts, mood boards, illustration options)"
 ---
 
 You are an image generation assistant. When the user asks you to create or edit images, use the `media_generate_image` tool.

package/src/config/bundled-skills/image-studio/TOOLS.json

@@ -37,10 +37,6 @@
           "variants": {
             "type": "number",
             "description": "Number of image variants to generate (1-4, default: 1)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["prompt"]

package/src/config/bundled-skills/media-processing/TOOLS.json

@@ -20,10 +20,6 @@
           "metadata": {
             "type": "object",
             "description": "Optional JSON metadata to attach to the asset (e.g., pipeline config, source info)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["file_path"]
@@ -51,10 +47,6 @@
             "type": "string",
             "enum": ["registered", "processing", "indexed", "failed"],
             "description": "Filter assets by processing status"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -100,10 +92,6 @@
           "include_audio": {
             "type": "boolean",
             "description": "Whether to extract and transcribe audio for each segment using the configured STT service. Default: false."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["asset_id"]
@@ -153,10 +141,6 @@
             "type": "number",
             "minimum": 0,
             "description": "Maximum retry attempts per segment on failure. Default: 3"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["asset_id", "system_prompt", "output_schema"]
@@ -187,10 +171,6 @@
           "model": {
             "type": "string",
             "description": "LLM model to use for analysis. Default: 'claude-sonnet-4-6'"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["asset_id", "query"]
@@ -234,10 +214,6 @@
           "title": {
             "type": "string",
             "description": "Short descriptive title for the clip (e.g. 'snow-dive-closeup', 'goal-celebration'). Used as the filename. If omitted, falls back to timestamp-based naming."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["asset_id", "start_time", "end_time"]

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

@@ -16,10 +16,6 @@
           "account": {
             "type": "string",
             "description": "Email address of the account to use. Required when multiple accounts are connected for the same platform. If omitted, uses the most recently connected account."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false
@@ -54,10 +50,6 @@
           "limit": {
             "type": "number",
             "description": "Maximum number of conversations to return (default 200)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false
@@ -92,10 +84,6 @@
           "limit": {
             "type": "number",
             "description": "Maximum number of messages to return (default 50)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false,
@@ -127,10 +115,6 @@
           "max_results": {
             "type": "number",
             "description": "Maximum number of results to return (default 20)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false,
@@ -185,10 +169,6 @@
           "confidence": {
             "type": "number",
             "description": "Confidence score (0-1) for this action"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false,
@@ -220,10 +200,6 @@
           "message_id": {
             "type": "string",
             "description": "Specific message ID to mark as read (optional)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false,
@@ -255,10 +231,6 @@
           "query_filter": {
             "type": "string",
             "description": "Optional search filter (e.g. 'to:alice@example.com' for Gmail)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false
@@ -302,10 +274,6 @@
           "draft_id": {
             "type": "string",
             "description": "Draft ID (for delete)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false,
@@ -345,10 +313,6 @@
           "page_token": {
             "type": "string",
             "description": "Resume token from a previous scan (rarely needed - scans now cover up to 5,000 messages in a single call)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "additionalProperties": false
@@ -380,10 +344,6 @@
             "type": "number",
             "description": "Confidence score (0-1) for this action"
           },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
           "user_approved": {
             "type": "boolean",
             "description": "Set to true ONLY when the user's most recent message contains explicit approval language for this specific action (e.g. 'archive these', 'yes do it', 'go ahead'). Do NOT set this when the user merely described what they want without confirming, or when acting on prior instructions without fresh confirmation in this turn."

package/src/config/bundled-skills/messaging/tools/messaging-analyze-style.ts

@@ -67,7 +67,8 @@ function upsertMemoryItem(opts: {
         created: now,
         lastAccessed: now,
         lastConsolidated: now,
-        emotionalCharge: '{"valence":0,"intensity":0.1,"decayCurve":"linear","decayRate":0.05,"originalIntensity":0.1}',
+        emotionalCharge:
+          '{"valence":0,"intensity":0.1,"decayCurve":"linear","decayRate":0.05,"originalIntensity":0.1}',
         fidelity: "vivid",
         confidence: 0.8,
         significance: clampUnitInterval(opts.importance),
@@ -87,7 +88,7 @@ function upsertMemoryItem(opts: {
 
 export async function run(
   input: Record<string, unknown>,
-  context: ToolContext,
+  _context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const platform = input.platform as string | undefined;
   const maxMessages = Math.min(
@@ -119,7 +120,7 @@ export async function run(
       return err("No style patterns were extracted. Try with more messages.");
     }
 
-    const scopeId = context.memoryScopeId ?? "default";
+    const scopeId = "default";
     let savedCount = 0;
 
     for (const pattern of result.stylePatterns) {

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

@@ -29,10 +29,6 @@
           "skip_disclosure": {
             "type": "boolean",
             "description": "Skip the disclosure announcement at the start of the call. Set to true when calling someone who already knows who you are (e.g. your guardian, a family member, or a close contact)."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["phone_number", "task"]
@@ -51,10 +47,6 @@
           "call_session_id": {
             "type": "string",
             "description": "Specific call session ID to check. If omitted, checks for an active call in the current conversation."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": []
@@ -77,10 +69,6 @@
           "end_reason": {
             "type": "string",
             "description": "Reason for ending the call"
-          },
-          "activity": {
-            "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/references/TROUBLESHOOTING.md

@@ -10,19 +10,25 @@ Run `assistant config set calls.enabled true`.
 
 ## "No public base URL configured"
 
-Run the **public-ingress** skill to set up ngrok and configure `ingress.publicBaseUrl`.
+First check whether this is a managed/platform assistant:
+
+```bash
+assistant platform status --json
+```
+
+If it reports an available platform assistant, do not install or start ngrok for Twilio. The gateway should use Velay, and `velayTunnel.connected` should become `true` after registration. If this is a local/self-hosted assistant without Velay, run the **public-ingress** skill to set up ngrok or another custom tunnel and configure `ingress.publicBaseUrl`.
 
 ## Call fails immediately after initiating
 
 - Check that the phone number is in E.164 format
 - Verify Twilio credentials are correct (wrong auth token causes API errors)
 - On trial accounts, ensure the destination number is verified
-- Check that the ngrok tunnel is still running (`curl -s http://127.0.0.1:4040/api/tunnels`)
+- Check that the configured tunnel is still running. For ngrok, use `curl -s http://127.0.0.1:4040/api/tunnels`. For Velay, run `assistant platform status --json` and confirm `velayTunnel.connected` is `true`, or check gateway logs for `Velay tunnel registered`.
 
 ## Call connects but no audio / one-way audio
 
-- The ConversationRelay WebSocket may not be connecting. Check that `ingress.publicBaseUrl` is correct and the tunnel is active
-- Verify the assistant runtime is running
+- The ConversationRelay WebSocket may not be connecting. If you are using ngrok or a custom tunnel, check that `ingress.publicBaseUrl` is correct and the tunnel is active. If you are using Velay, check `assistant platform status --json`; a 503 from `https://velay.../<assistant-id>/...` usually means the assistant tunnel is not connected or the gateway did not complete the WebSocket open, not that ngrok is required.
+- Verify the assistant is running
 
 ## "Number not eligible for caller identity"
 
@@ -50,6 +56,21 @@ assistant config set ingress.publicBaseUrl "<new-url>"
 
 Or re-run the public-ingress skill to auto-detect and save the new URL.
 
+Do not rotate ngrok to work around a managed Velay WebSocket failure. Fix the Velay tunnel state instead, or restart the assistant/gateway so it re-registers.
+
+## Velay tunnel is not registering
+
+- Confirm vembda passes the environment-appropriate `VELAY_BASE_URL` to the gateway container.
+- Re-hatch or restart the assistant after changing the environment.
+- Check gateway logs for `Velay tunnel connected` followed by `Velay tunnel registered`.
+- If `VELAY_BASE_URL` is not set on a local/self-hosted assistant, the gateway does not start the Velay client. Use ngrok or another custom tunnel in `ingress.publicBaseUrl`.
+
+## Local Twilio Velay smoke tests
+
+- HTTP bridge: request `${VELAY_PUBLIC_BASE_URL}/<assistant-id>/healthz` and `${VELAY_PUBLIC_BASE_URL}/<assistant-id>/schema`. When testing a JSON webhook route under active development, POST a small JSON body through the same Velay public URL and confirm the gateway receives it.
+- Synthetic WebSocket: connect a local WebSocket client to `${VELAY_PUBLIC_BASE_URL}/<assistant-id>/webhooks/twilio/relay?callSessionId=session-123&token=<edge-token>` and confirm the upgrade reaches the gateway.
+- Real Twilio call: wait for the gateway to register with Velay, then place a call and confirm Twilio fetches `/webhooks/twilio/voice` and opens the relay or media-stream WebSocket through the Velay URL.
+
 ## Call drops after 30 seconds of silence
 
 The system has a 30-second silence timeout. If nobody speaks for 30 seconds during normal conversation, the agent will ask "Are you still there?" This is expected behavior. During guardian wait states (inbound access-request wait or in-call guardian consultation wait), this generic silence nudge is suppressed - the guardian-wait heartbeat messaging is used instead.

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

@@ -33,10 +33,6 @@
           "priority": {
             "type": "number",
             "description": "Relative priority \u2014 higher numbers take precedence. Defaults to 0."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["trigger", "action"]
@@ -59,10 +55,6 @@
           "category": {
             "type": "string",
             "description": "Filter by category (e.g. \"scheduling\", \"triage\"). Omit to show all."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         }
       },
@@ -105,10 +97,6 @@
           "priority": {
             "type": "number",
             "description": "Updated priority"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["playbook_id"]
@@ -127,10 +115,6 @@
           "playbook_id": {
             "type": "string",
             "description": "ID of the playbook to delete (from playbook_list results)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
         "required": ["playbook_id"]

package/src/config/bundled-skills/playbooks/tools/playbook-create.ts

@@ -18,7 +18,7 @@ const VALID_AUTONOMY_LEVELS = new Set<string>(["auto", "draft", "notify"]);
 
 export async function executePlaybookCreate(
   input: Record<string, unknown>,
-  context: ToolContext,
+  _context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const trigger = input.trigger as string;
   const action = input.action as string;
@@ -58,7 +58,7 @@ export async function executePlaybookCreate(
   const sanitizedTrigger = trigger.replace(/[\r\n]+/g, " ");
   const subject = `Playbook: ${sanitizedTrigger}`.slice(0, 80);
   const content = `${subject}\n${statement}`;
-  const scopeId = context.memoryScopeId ?? "default";
+  const scopeId = "default";
 
   try {
     const db = getDb();

package/src/config/bundled-skills/playbooks/tools/playbook-delete.ts

@@ -7,7 +7,7 @@ import type {
 
 export async function executePlaybookDelete(
   input: Record<string, unknown>,
-  context: ToolContext,
+  _context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const playbookId = input.playbook_id as string;
   if (!playbookId || typeof playbookId !== "string") {
@@ -17,7 +17,7 @@ export async function executePlaybookDelete(
     };
   }
 
-  const scopeId = context.memoryScopeId ?? "default";
+  const scopeId = "default";
 
   try {
     const existing = getNode(playbookId);

package/src/config/bundled-skills/playbooks/tools/playbook-list.ts

@@ -10,9 +10,9 @@ import type {
 
 export async function executePlaybookList(
   input: Record<string, unknown>,
-  context: ToolContext,
+  _context: ToolContext,
 ): Promise<ToolExecutionResult> {
-  const scopeId = context.memoryScopeId ?? "default";
+  const scopeId = "default";
   const channelFilter =
     typeof input.channel === "string" ? input.channel : null;
   const categoryFilter =

package/src/config/bundled-skills/playbooks/tools/playbook-update.ts

@@ -18,7 +18,7 @@ const VALID_AUTONOMY_LEVELS = new Set<string>(["auto", "draft", "notify"]);
 
 export async function executePlaybookUpdate(
   input: Record<string, unknown>,
-  context: ToolContext,
+  _context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const playbookId = input.playbook_id as string;
   if (!playbookId || typeof playbookId !== "string") {
@@ -28,7 +28,7 @@ export async function executePlaybookUpdate(
     };
   }
 
-  const scopeId = context.memoryScopeId ?? "default";
+  const scopeId = "default";
 
   try {
     const existing = getNode(playbookId);

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"]