@vellumai/assistant 0.5.1 → 0.5.2

package/src/config/bundled-skills/app-builder/TOOLS.json

@@ -23,7 +23,7 @@
           },
           "html": {
             "type": "string",
-            "description": "Optional HTML definition for the main index.html page. If omitted, a minimal scaffold is created and you can write index.html later via app_file_write."
+            "description": "Optional HTML definition for the main index.html page. If omitted, a minimal scaffold is created and you can write index.html later via file_write."
           },
           "pages": {
             "type": "object",
@@ -85,90 +85,6 @@
       "executor": "tools/app-create.ts",
       "execution_target": "host"
     },
-    {
-      "name": "app_list",
-      "description": "List all persistent apps. Returns an array of {id, name, description, updatedAt}.",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        }
-      },
-      "executor": "tools/app-list.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "app_query",
-      "description": "Query all records for a persistent app. Returns an array of records.",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "app_id": {
-            "type": "string",
-            "description": "The ID of the app to query records for"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["app_id"]
-      },
-      "executor": "tools/app-query.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "app_update",
-      "description": "Update a persistent app definition. Provide the app_id and any fields to update (name, description, schema_json, html).",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "app_id": {
-            "type": "string",
-            "description": "The ID of the app to update"
-          },
-          "name": {
-            "type": "string",
-            "description": "Updated name for the app"
-          },
-          "description": {
-            "type": "string",
-            "description": "Updated description for the app"
-          },
-          "schema_json": {
-            "type": "string",
-            "description": "Updated JSON schema"
-          },
-          "html": {
-            "type": "string",
-            "description": "Updated HTML definition"
-          },
-          "pages": {
-            "type": "object",
-            "description": "Updated additional pages as a mapping of filename to HTML content.",
-            "additionalProperties": {
-              "type": "string"
-            }
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["app_id"]
-      },
-      "executor": "tools/app-update.ts",
-      "execution_target": "host"
-    },
     {
       "name": "app_delete",
       "description": "Delete a persistent app and all its records.",
@@ -192,8 +108,8 @@
       "execution_target": "host"
     },
     {
-      "name": "app_file_list",
-      "description": "List all files in an app. Returns a JSON array of file paths.",
+      "name": "app_refresh",
+      "description": "Trigger recompilation and surface refresh for an app after making file changes. Call this once after you finish editing app files with generic file tools.",
       "category": "apps",
       "risk": "low",
       "input_schema": {
@@ -201,7 +117,7 @@
         "properties": {
           "app_id": {
             "type": "string",
-            "description": "The ID of the app"
+            "description": "The ID of the app to refresh"
           },
           "activity": {
             "type": "string",
@@ -210,117 +126,7 @@
         },
         "required": ["app_id"]
       },
-      "executor": "tools/app-file-list.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "app_file_read",
-      "description": "Read the contents of a file in an app. Returns content with line numbers in cat -n format.",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "app_id": {
-            "type": "string",
-            "description": "The ID of the app"
-          },
-          "path": {
-            "type": "string",
-            "description": "Relative file path within the app"
-          },
-          "offset": {
-            "type": "number",
-            "description": "1-based line number to start reading from (default: 1)"
-          },
-          "limit": {
-            "type": "number",
-            "description": "Number of lines to return (default: all)"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["app_id", "path"]
-      },
-      "executor": "tools/app-file-read.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "app_file_edit",
-      "description": "Edit a file in an app by replacing a string. Uses exact match-and-replace.",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "app_id": {
-            "type": "string",
-            "description": "The ID of the app"
-          },
-          "path": {
-            "type": "string",
-            "description": "Relative file path within the app"
-          },
-          "old_string": {
-            "type": "string",
-            "description": "The exact string to find and replace"
-          },
-          "new_string": {
-            "type": "string",
-            "description": "The replacement string"
-          },
-          "replace_all": {
-            "type": "boolean",
-            "description": "Replace all occurrences instead of just the first (default: false)"
-          },
-          "status": {
-            "type": "string",
-            "description": "Optional short human-readable progress message shown to the user (e.g. 'adding dark mode styles')"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["app_id", "path", "old_string", "new_string"]
-      },
-      "executor": "tools/app-file-edit.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "app_file_write",
-      "description": "Write (create or overwrite) a file in an app.",
-      "category": "apps",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "app_id": {
-            "type": "string",
-            "description": "The ID of the app"
-          },
-          "path": {
-            "type": "string",
-            "description": "Relative file path within the app"
-          },
-          "content": {
-            "type": "string",
-            "description": "The content to write to the file"
-          },
-          "status": {
-            "type": "string",
-            "description": "Optional short human-readable progress message shown to the user (e.g. 'adding dark mode styles')"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["app_id", "path", "content"]
-      },
-      "executor": "tools/app-file-write.ts",
+      "executor": "tools/app-refresh.ts",
       "execution_target": "host"
     },
     {

package/src/config/bundled-skills/app-builder/tools/{app-query.ts → app-refresh.ts}

@@ -1,5 +1,5 @@
 import * as appStore from "../../../../memory/app-store.js";
-import { executeAppQuery } from "../../../../tools/apps/executors.js";
+import { executeAppRefresh } from "../../../../tools/apps/executors.js";
 import type {
   ToolContext,
   ToolExecutionResult,
@@ -9,5 +9,5 @@ export async function run(
   input: Record<string, unknown>,
   _context: ToolContext,
 ): Promise<ToolExecutionResult> {
-  return executeAppQuery({ app_id: input.app_id as string }, appStore);
+  return executeAppRefresh({ app_id: input.app_id as string }, appStore);
 }

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

@@ -44,10 +44,9 @@ 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/gmail/tools/gmail-archive.ts

@@ -35,10 +35,9 @@ export async function run(
     }
 
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       const allMessageIds: string[] = [];
       let pageToken: string | undefined;
       let truncated = false;
@@ -107,10 +106,9 @@ export async function run(
   } else if (messageId) {
     // Single message path
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       await modifyMessage(connection, messageId, { removeLabelIds: ["INBOX"] });
       return ok("Message archived.");
     } catch (e) {
@@ -128,10 +126,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     if (messageIds.length === 1) {
       await modifyMessage(connection, messageIds[0], {
         removeLabelIds: ["INBOX"],

package/src/config/bundled-skills/gmail/tools/gmail-attachments.ts

@@ -57,10 +57,9 @@ export async function run(
 
   if (action === "list") {
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       const message = await getMessage(connection, messageId, "full");
       const attachments = collectAttachments(message.payload?.parts);
 
@@ -82,10 +81,9 @@ export async function run(
     if (!filename) return err("filename is required for download.");
 
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       const attachment = await getAttachment(
         connection,
         messageId,

package/src/config/bundled-skills/gmail/tools/gmail-draft.ts

@@ -23,10 +23,9 @@ export async function run(
   if (!body) return err("body is required.");
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     const draft = await createDraft(
       connection,
       to,

package/src/config/bundled-skills/gmail/tools/gmail-filters.ts

@@ -26,10 +26,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     switch (action) {
       case "list": {
         const filters = await listFilters(connection);

package/src/config/bundled-skills/gmail/tools/gmail-follow-up.ts

@@ -38,10 +38,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     switch (action) {
       case "track": {
         const messageId = input.message_id as string;

package/src/config/bundled-skills/gmail/tools/gmail-forward.ts

@@ -76,10 +76,9 @@ export async function run(
   if (!forwardTo) return err("to is required.");
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     const message = await getMessage(connection, messageId, "full");
     const headers = message.payload?.headers ?? [];
     const originalFrom = extractHeader(headers, "From");

package/src/config/bundled-skills/gmail/tools/gmail-label.ts

@@ -21,10 +21,9 @@ export async function run(
 
   if (messageIds && messageIds.length > 0) {
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       await batchModifyMessages(connection, messageIds, {
         addLabelIds,
         removeLabelIds,
@@ -37,10 +36,9 @@ export async function run(
 
   if (messageId) {
     try {
-      const connection = await resolveOAuthConnection(
-        "integration:google",
+      const connection = await resolveOAuthConnection("integration:google", {
         account,
-      );
+      });
       await modifyMessage(connection, messageId, {
         addLabelIds,
         removeLabelIds,

package/src/config/bundled-skills/gmail/tools/gmail-outreach-scan.ts

@@ -56,10 +56,9 @@ export async function run(
   const query = `in:inbox -has:unsubscribe newer_than:${timeRange}`;
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     // Pipeline: fire metadata fetches for each page of IDs as they arrive
     const allMessageIds: string[] = [];
     const fetchPromises: Promise<GmailMessage[]>[] = [];

package/src/config/bundled-skills/gmail/tools/gmail-send-draft.ts

@@ -15,10 +15,9 @@ export async function run(
   if (!draftId) return err("draft_id is required.");
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     const msg = await sendDraft(connection, draftId);
     return ok(`Draft sent (Message ID: ${msg.id}).`);
   } catch (e) {

package/src/config/bundled-skills/gmail/tools/gmail-sender-digest.ts

@@ -58,10 +58,9 @@ export async function run(
   const inputPageToken = input.page_token as string | undefined;
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     // Pipeline: fire metadata fetches for each page of IDs as they arrive,
     // overlapping fetch latency with pagination latency
     const allMessageIds: string[] = [];

package/src/config/bundled-skills/gmail/tools/gmail-trash.ts

@@ -18,10 +18,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     await trashMessage(connection, messageId);
     return ok("Message moved to trash.");
   } catch (e) {

package/src/config/bundled-skills/gmail/tools/gmail-unsubscribe.ts

@@ -32,10 +32,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     const message = await getMessage(connection, messageId, "metadata", [
       "List-Unsubscribe",
       "List-Unsubscribe-Post",

package/src/config/bundled-skills/gmail/tools/gmail-vacation.ts

@@ -22,10 +22,9 @@ export async function run(
   }
 
   try {
-    const connection = await resolveOAuthConnection(
-      "integration:google",
+    const connection = await resolveOAuthConnection("integration:google", {
       account,
-    );
+    });
     switch (action) {
       case "get": {
         const settings = await getVacation(connection);

package/src/config/bundled-skills/google-calendar/tools/shared.ts

@@ -13,5 +13,5 @@ export function ok(content: string): ToolExecutionResult {
 export async function getCalendarConnection(
   account?: string,
 ): Promise<OAuthConnection> {
-  return resolveOAuthConnection("integration:google", account);
+  return resolveOAuthConnection("integration:google", { account });
 }

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

@@ -13,13 +13,13 @@ You are an image generation assistant. When the user asks you to create or edit
 ## Usage
 
 - **Text-to-image**: "Generate an image of a sunset over the ocean"
-- **Image editing**: "Remove the background from this image" (requires attaching an image)
+- **Image editing**: "Remove the background from this image" (requires providing source image file paths)
 - **Multiple variants**: "Generate 3 variations of a logo for a coffee shop"
 
 ## Modes
 
 - **generate** (default): Create a new image from a text prompt.
-- **edit**: Modify an existing image based on a text prompt. Requires one or more attached source images via `attachment_ids`.
+- **edit**: Modify an existing image based on a text prompt. Requires one or more source images via `source_paths` (file paths on disk).
 
 ## Models
 

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

@@ -18,12 +18,12 @@
             "enum": ["generate", "edit"],
             "description": "Whether to generate a new image or edit an existing one (default: generate)"
           },
-          "attachment_ids": {
+          "source_paths": {
             "type": "array",
             "items": {
               "type": "string"
             },
-            "description": "IDs of attached source images to edit (required for edit mode)"
+            "description": "File paths to source images in the workspace (for edit mode)"
           },
           "model": {
             "type": "string",