@vellumai/assistant 0.4.55 → 0.4.57

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

@@ -6,30 +6,31 @@ metadata:
   emoji: "🌐"
   vellum:
     display-name: "Browser"
-    user-invocable: true
     feature-flag: "browser"
+    activation-hints:
+      - "Load first if you need browser_* tools (navigating, clicking, extracting web content)"
 ---
 
 Use this skill to browse the web. After loading this skill, the following browser tools become available:
 
-- `browser_navigate` — Navigate to a URL
-- `browser_snapshot` — List interactive elements on the current page
-- `browser_screenshot` — Take a visual screenshot
-- `browser_close` — Close the browser page
-- `browser_click` — Click an element
-- `browser_type` — Type text into an input
-- `browser_press_key` — Press a keyboard key
-- `browser_scroll` — Scroll the page or a specific element
-- `browser_select_option` — Select an option from a native `<select>` element
-- `browser_hover` — Hover over an element to reveal menus/tooltips
-- `browser_wait_for` — Wait for a condition
-- `browser_extract` — Extract page text content
-- `browser_wait_for_download` — Wait for a file download to complete
-- `browser_fill_credential` — Fill a stored credential into a form field
+- `browser_navigate` - Navigate to a URL
+- `browser_snapshot` - List interactive elements on the current page
+- `browser_screenshot` - Take a visual screenshot
+- `browser_close` - Close the browser page
+- `browser_click` - Click an element
+- `browser_type` - Type text into an input
+- `browser_press_key` - Press a keyboard key
+- `browser_scroll` - Scroll the page or a specific element
+- `browser_select_option` - Select an option from a native `<select>` element
+- `browser_hover` - Hover over an element to reveal menus/tooltips
+- `browser_wait_for` - Wait for a condition
+- `browser_extract` - Extract page text content
+- `browser_wait_for_download` - Wait for a file download to complete
+- `browser_fill_credential` - Fill a stored credential into a form field
 
 ## Capabilities
 
-This browser runs **full Chromium with JavaScript enabled**. It can handle SPAs, React/Vue/Angular apps, dynamic content, date pickers, booking systems, reservation flows, and any JavaScript-heavy interactive site. Never tell the user you "can't handle interactive JavaScript" — you can.
+This browser runs **full Chromium with JavaScript enabled**. It can handle SPAs, React/Vue/Angular apps, dynamic content, date pickers, booking systems, reservation flows, and any JavaScript-heavy interactive site. Never tell the user you "can't handle interactive JavaScript" - you can.
 
 ## Typical Workflow
 

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

@@ -17,7 +17,7 @@
             "type": "boolean",
             "description": "If true, allows navigation to localhost/private-network hosts. Disabled by default for SSRF safety."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -35,7 +35,7 @@
       "input_schema": {
         "type": "object",
         "properties": {
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -56,7 +56,7 @@
             "type": "boolean",
             "description": "Capture the full scrollable page instead of just the viewport."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -67,7 +67,7 @@
     },
     {
       "name": "browser_close",
-      "description": "Close the browser page for the current session, or all pages if close_all_pages is true.",
+      "description": "Close the browser page for the current conversation, or all pages if close_all_pages is true.",
       "category": "browser",
       "risk": "low",
       "input_schema": {
@@ -75,9 +75,9 @@
         "properties": {
           "close_all_pages": {
             "type": "boolean",
-            "description": "If true, close all browser pages and the browser context. Default: false (close only the current session page)."
+            "description": "If true, close all browser pages and the browser context. Default: false (close only the current conversation page)."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -102,7 +102,7 @@
             "type": "string",
             "description": "A CSS selector to target. Used as fallback when element_id is not available."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -139,7 +139,7 @@
             "type": "boolean",
             "description": "If true, press Enter after typing the text."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -169,7 +169,7 @@
             "type": "string",
             "description": "Optional CSS selector to target."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -204,7 +204,7 @@
             "type": "string",
             "description": "Optional CSS selector of element to scroll within."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -242,7 +242,7 @@
             "type": "number",
             "description": "The zero-based index of the <option> to select."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -267,7 +267,7 @@
             "type": "string",
             "description": "A CSS selector to target. Used as fallback when element_id is not available."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -300,7 +300,7 @@
             "type": "number",
             "description": "Maximum wait time in milliseconds (default and max: 30000)."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -321,7 +321,7 @@
             "type": "boolean",
             "description": "If true, include a list of links found on the page (up to 200)."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -342,7 +342,7 @@
             "type": "number",
             "description": "Maximum wait time in milliseconds (default: 30000, max: 120000)."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -379,7 +379,7 @@
             "type": "boolean",
             "description": "Press Enter after filling"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }

package/src/config/bundled-skills/browser/tools/browser-wait-for-download.ts

@@ -15,7 +15,7 @@ export async function run(
 
   try {
     const download = await browserManager.waitForDownload(
-      context.sessionId,
+      context.conversationId,
       timeout,
     );
     return {

package/src/config/bundled-skills/chatgpt-import/SKILL.md

@@ -6,7 +6,6 @@ metadata:
   emoji: "📥"
   vellum:
     display-name: "ChatGPT Import"
-    user-invocable: true
 ---
 
 Import ChatGPT conversation history into Vellum so users can keep their conversation context and memory when switching from ChatGPT.
@@ -17,12 +16,12 @@ When a user wants to import their ChatGPT conversations:
 
 1. **Tell the user how to export.** They need to go to ChatGPT → Settings → Data controls → Export data. ChatGPT will email them a ZIP file.
 2. **Ask the user to upload the ZIP file.** Use whatever file upload tools or skills are available to receive the ZIP.
-3. **Run the import.** Once you have the ZIP file path, call `chatgpt_import` with the file path. Report the results — how many conversations and messages were imported, and any skipped duplicates.
+3. **Run the import.** Once you have the ZIP file path, call `chatgpt_import` with the file path. Report the results - how many conversations and messages were imported, and any skipped duplicates.
 
 ## Notes
 
 - Only ZIP files are accepted (the full export archive from ChatGPT).
-- Conversations are deduplicated — re-importing the same file will skip already-imported conversations.
+- Conversations are deduplicated - re-importing the same file will skip already-imported conversations.
 - Only user and assistant messages are imported (system prompts and tool calls are filtered out).
 - Original timestamps from ChatGPT are preserved.
 - Imported conversations are automatically indexed for memory search.

package/src/config/bundled-skills/chatgpt-import/TOOLS.json

@@ -13,7 +13,7 @@
             "type": "string",
             "description": "Absolute path to the ChatGPT export ZIP file"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }

package/src/config/bundled-skills/chatgpt-import/tools/chatgpt-import.ts

@@ -175,7 +175,7 @@ export async function run(
           memoryConfig,
         );
       } catch (err) {
-        // Indexing failure is non-fatal — the message is already persisted,
+        // Indexing failure is non-fatal - the message is already persisted,
         // and failing here would abort the loop before conversationKeys is
         // written, causing duplicate imports on retry.
         log.warn(

package/src/config/bundled-skills/claude-code/SKILL.md

@@ -1,12 +1,11 @@
 ---
 name: claude-code
-description: Delegate coding tasks to Claude Code, an AI-powered coding agent
+description: Delegate coding tasks to Claude Code
 compatibility: "Designed for Vellum personal assistants"
 metadata:
   emoji: "💻"
   vellum:
     display-name: "Claude Code"
-    user-invocable: true
 ---
 
 You are delegating a coding task to Claude Code, an autonomous AI coding agent. Use this skill when the user needs hands-on software engineering work done.
@@ -40,15 +39,15 @@ Do NOT delegate when:
 - Claude Code runs in a sandboxed environment with approval flows for destructive actions
 - File writes, edits, and shell commands that modify state require user confirmation (unless auto-approved by trust rules)
 - Read-only operations (file reads, searches, web fetches) are auto-approved
-- The working directory defaults to the current session's working directory but can be overridden
+- The working directory defaults to the current conversation's working directory but can be overridden
 
 ## Worker Profiles
 
 Claude Code supports scoped worker profiles that restrict tool access:
 
-- **general** (default) — Full access to all tools.
-- **researcher** — Read-only access. Can search, read files, and browse the web but cannot write or execute commands.
-- **coder** — Full read/write/execute access optimized for implementation tasks.
-- **reviewer** — Read-only access tailored for code review, with emphasis on analysis and feedback.
+- **general** (default) - Full access to all tools.
+- **researcher** - Read-only access. Can search, read files, and browse the web but cannot write or execute commands.
+- **coder** - Full read/write/execute access optimized for implementation tasks.
+- **reviewer** - Read-only access tailored for code review, with emphasis on analysis and feedback.
 
 Select the profile that best matches the task to enforce least-privilege access.

package/src/config/bundled-skills/claude-code/TOOLS.json

@@ -23,7 +23,7 @@
           },
           "working_dir": {
             "type": "string",
-            "description": "Working directory for Claude Code (defaults to session working directory)"
+            "description": "Working directory for Claude Code (defaults to conversation working directory)"
           },
           "resume": {
             "type": "string",

package/src/config/bundled-skills/computer-use/SKILL.md

@@ -1,19 +1,17 @@
 ---
 name: computer-use
-description: Computer-use action tools for controlling the macOS desktop via accessibility and screen capture.
+description: Control the macOS desktop
 compatibility: "Designed for Vellum personal assistants"
 metadata:
   emoji: "🖥️"
   vellum:
     display-name: "Computer Use"
-    user-invocable: false
-    disable-model-invocation: true
 ---
 
 This skill provides the computer_use_* action tools for controlling
 the macOS desktop. CU tools run through the main agent loop via HostCuProxy.
 
-The skill is internally preactivated for sessions with a connected desktop client.
+The skill is internally preactivated for conversations with a connected desktop client.
 
-Tools in this skill are proxy tools — execution is forwarded to the connected
+Tools in this skill are proxy tools - execution is forwarded to the connected
 macOS client, never handled locally by the assistant.

package/src/config/bundled-skills/computer-use/TOOLS.json

@@ -3,18 +3,18 @@
   "tools": [
     {
       "name": "computer_use_observe",
-      "description": "Capture the current screen state. Returns the accessibility tree with [ID] element references and optionally a screenshot.\n\nThe accessibility tree shows interactive elements like [3] AXButton 'Save' or [17] AXTextField 'Search'. Use element_id to target these elements in subsequent actions — this is much more reliable than pixel coordinates.\n\nCall this before your first computer use action, or to check screen state without acting.",
+      "description": "Capture the current screen state. Returns the accessibility tree with [ID] element references and optionally a screenshot.\n\nThe accessibility tree shows interactive elements like [3] AXButton 'Save' or [17] AXTextField 'Search'. Use element_id to target these elements in subsequent actions - this is much more reliable than pixel coordinates.\n\nCall this before your first computer use action, or to check screen state without acting.",
       "category": "computer-use",
       "risk": "low",
       "input_schema": {
         "type": "object",
         "properties": {
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": ["reason"]
+        "required": ["activity"]
       },
       "executor": "tools/computer-use-observe.ts",
       "execution_target": "host"
@@ -48,7 +48,7 @@
             "type": "string",
             "description": "Explanation of what you see and why you are clicking here"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -74,7 +74,7 @@
             "type": "string",
             "description": "Explanation of what you are typing and why"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -100,7 +100,7 @@
             "type": "string",
             "description": "Explanation of why you are pressing this key"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -143,7 +143,7 @@
             "type": "string",
             "description": "Explanation of why you are scrolling"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -189,7 +189,7 @@
             "type": "string",
             "description": "Explanation of what you are dragging and why"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -215,7 +215,7 @@
             "type": "string",
             "description": "Explanation of what you are waiting for"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -227,7 +227,7 @@
     },
     {
       "name": "computer_use_open_app",
-      "description": "Open or switch to a macOS application by name. Preferred over cmd+tab for switching apps \u2014 more reliable and explicit.",
+      "description": "Open or switch to a macOS application by name. Preferred over cmd+tab for switching apps - more reliable and explicit.",
       "category": "computer-use",
       "risk": "low",
       "input_schema": {
@@ -241,7 +241,7 @@
             "type": "string",
             "description": "Explanation of why you need to open or switch to this app"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -253,7 +253,7 @@
     },
     {
       "name": "computer_use_run_applescript",
-      "description": "Run an AppleScript command. Prefer this over click/type when possible \u2014 it doesn't move the cursor or interrupt the user. Never use 'do shell script' inside AppleScript (blocked for security).",
+      "description": "Run an AppleScript command. Prefer this over click/type when possible - it doesn't move the cursor or interrupt the user. Never use 'do shell script' inside AppleScript (blocked for security).",
       "category": "computer-use",
       "risk": "low",
       "input_schema": {
@@ -267,7 +267,7 @@
             "type": "string",
             "description": "Explanation of what this script does and why AppleScript is better than UI interaction for this step"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -289,7 +289,7 @@
             "type": "string",
             "description": "Human-readable summary of what was accomplished"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -315,7 +315,7 @@
             "type": "string",
             "description": "Explanation of how you determined the answer"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }

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

@@ -6,7 +6,6 @@ metadata:
   emoji: "👥"
   vellum:
     display-name: "Contacts"
-    user-invocable: true
     feature-flag: "contacts"
 ---
 
@@ -292,7 +291,7 @@ If the user provides a phone number without the `+` country code prefix, ask the
 
 ### Create an email invite
 
-Use this when the guardian wants to invite someone to message the assistant via email. Email invites use a 6-digit code — the invitee sends the code to the assistant's email address to redeem access.
+Use this when the guardian wants to invite someone to message the assistant via email. Email invites use a 6-digit code - the invitee sends the code to the assistant's email address to redeem access.
 
 ```bash
 assistant contacts invites create --source-channel email --contact-id "<contact_id>" --contact-name "<invitee_name>" --max-uses 1 --note "<optional note, e.g. the person it is for>" --json
@@ -323,7 +322,7 @@ If the assistant's email address is not available (AgentMail not configured), te
 
 ### Create a WhatsApp invite
 
-Use this when the guardian wants to invite someone to message the assistant on WhatsApp. WhatsApp invites use a 6-digit code — the invitee sends the code to the assistant's WhatsApp number to redeem access.
+Use this when the guardian wants to invite someone to message the assistant on WhatsApp. WhatsApp invites use a 6-digit code - the invitee sends the code to the assistant's WhatsApp number to redeem access.
 
 ```bash
 assistant contacts invites create --source-channel whatsapp --contact-id "<contact_id>" --contact-name "<invitee_name>" --max-uses 1 --note "<optional note, e.g. the person it is for>" --json
@@ -444,7 +443,7 @@ Replace `<invite_id>` with the invite's `id` from the list response. The same re
 
 ## Google Contacts
 
-Use `google_contacts` to list or search the user's Google Contacts by name or email. Returns name, email, phone, and organization. Requires the `contacts.readonly` OAuth scope — users may need to re-authorize Gmail to grant this additional permission.
+Use `google_contacts` to list or search the user's Google Contacts by name or email. Returns name, email, phone, and organization. Requires the `contacts.readonly` OAuth scope - users may need to re-authorize Gmail to grant this additional permission.
 
 ## Contact Fields
 

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

@@ -52,7 +52,7 @@
               "required": ["type", "address"]
             }
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -86,7 +86,7 @@
             "type": "number",
             "description": "Maximum results to return (default 20, max 100)"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -112,7 +112,7 @@
             "type": "string",
             "description": "ID of the contact to merge into the kept contact (will be deleted)"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -147,9 +147,13 @@
             "type": "string",
             "description": "Pagination token (for list)"
           },
-          "reason": {
+          "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."
           }
         },
         "required": ["action"]

package/src/config/bundled-skills/contacts/tools/google-contacts.ts

@@ -36,6 +36,7 @@ export async function run(
   input: Record<string, unknown>,
   _context: ToolContext,
 ): Promise<ToolExecutionResult> {
+  const account = input.account as string | undefined;
   const action = input.action as string;
 
   if (!action) {
@@ -43,7 +44,10 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection("integration:google");
+    const connection = await resolveOAuthConnection(
+      "integration:google",
+      account,
+    );
     switch (action) {
       case "list": {
         const pageSize = (input.page_size as number) ?? 50;

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

@@ -1,6 +1,6 @@
 ---
 name: document
-description: Write, draft, or compose long-form text (blog posts, articles, essays, reports, guides). Use when the user says write, draft, compose, or create a blog/article/essay.
+description: Write, draft, or compose long-form text (blog posts, articles, essays, reports, guides)
 compatibility: "Designed for Vellum personal assistants"
 metadata:
   emoji: "📄"
@@ -12,14 +12,14 @@ Create and edit long-form documents using the built-in rich text editor. Documen
 
 ## Tools
 
-- **document_create** — Opens a new document editor with an optional title and initial Markdown content. Returns a `surface_id` for subsequent updates.
-- **document_update** — Updates content in an open document editor by `surface_id`. Supports `replace` (overwrite) and `append` (add to end) modes.
+- **document_create** - Opens a new document editor with an optional title and initial Markdown content. Returns a `surface_id` for subsequent updates.
+- **document_update** - Updates content in an open document editor by `surface_id`. Supports `replace` (overwrite) and `append` (add to end) modes.
 
 ## Workflow
 
 1. **Create the document**: Call `document_create` with a title (inferred from the request). Call the tool immediately, not after conversational preamble.
 2. **Write content in Markdown**: Use proper structure (`#` for titles, `##` for sections), **bold**, *italic*, code blocks, tables, lists, blockquotes as appropriate.
-3. **CRITICAL — Stream content in chunks**: Call `document_update` MULTIPLE times, not just once. Break content into logical chunks (paragraphs, sections, or every 200-300 words). Call `document_update` with `mode: "append"` for EACH chunk separately. The user experiences real-time content appearing as you write.
+3. **CRITICAL - Stream content in chunks**: Call `document_update` MULTIPLE times, not just once. Break content into logical chunks (paragraphs, sections, or every 200-300 words). Call `document_update` with `mode: "append"` for EACH chunk separately. The user experiences real-time content appearing as you write.
 4. **Respond to edits**: When the user requests changes via the docked chat, use `document_update` with `replace` for full rewrites or `append` for additions.
 
 ## Usage Notes

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

@@ -17,7 +17,7 @@
             "type": "string",
             "description": "Initial Markdown content to populate the editor (optional)"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -47,7 +47,7 @@
             "enum": ["replace", "append"],
             "description": "Whether to replace all content or append to the end. Defaults to append."
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }

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

@@ -27,7 +27,7 @@ When `expected_response_hours` is set, the follow-up automatically becomes overd
 
 Follow-ups can be resolved in two ways:
 1. **By ID** -- resolve a specific follow-up directly
-2. **By thread** -- provide channel + thread_id to auto-resolve all matching pending follow-ups (useful when a response arrives on a thread)
+2. **By conversation** -- provide channel + conversation_id to auto-resolve all matching pending follow-ups (useful when a response arrives on a conversation)
 
 ## Tips
 

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

@@ -13,9 +13,9 @@
             "type": "string",
             "description": "Communication channel (e.g. email, slack, whatsapp)"
           },
-          "thread_id": {
+          "conversation_id": {
             "type": "string",
-            "description": "External thread or conversation identifier on that channel"
+            "description": "External conversation identifier on that channel"
           },
           "contact_id": {
             "type": "string",
@@ -29,12 +29,12 @@
             "type": "string",
             "description": "Optional recurrence schedule ID to fire a reminder when overdue"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
         },
-        "required": ["channel", "thread_id"]
+        "required": ["channel", "conversation_id"]
       },
       "executor": "tools/followup-create.ts",
       "execution_target": "host"
@@ -64,7 +64,7 @@
             "type": "boolean",
             "description": "When true, return only pending follow-ups past their expected response deadline"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }
@@ -76,7 +76,7 @@
     },
     {
       "name": "followup_resolve",
-      "description": "Manually resolve a follow-up by ID, or auto-resolve by channel + thread ID when a response is received.",
+      "description": "Manually resolve a follow-up by ID, or auto-resolve by channel + conversation ID when a response is received.",
       "category": "followups",
       "risk": "low",
       "input_schema": {
@@ -88,13 +88,13 @@
           },
           "channel": {
             "type": "string",
-            "description": "Channel to match (used with thread_id for auto-resolution)"
+            "description": "Channel to match (used with conversation_id for auto-resolution)"
           },
-          "thread_id": {
+          "conversation_id": {
             "type": "string",
-            "description": "Thread ID to match (used with channel for auto-resolution)"
+            "description": "Conversation ID to match (used with channel for auto-resolution)"
           },
-          "reason": {
+          "activity": {
             "type": "string",
             "description": "Brief non-technical explanation of why this tool is being called"
           }