@vellumai/assistant 0.11.0 → 0.11.1-staging.2

package/src/config/bundled-skills/app-builder/SKILL.md

@@ -284,7 +284,7 @@ return src ? <video src={src} controls /> : null;
 
 Paths are validated server-side (no traversal, no `records/`); the file is served only from this app's own directory.
 
-**Live updates — `window.vellum.subscribe({ tags }, cb)`.** Instead of polling on a timer, subscribe to your own invalidation tags and refresh when the data actually changes. After a route mutates data it publishes a `sync_changed` event (`context.assistantEventHub.publish({ …, message: { type: "sync_changed", tags: ["my-app:items"] } })`); the app subscribes to that tag and re-fetches when it fires. Returns an unsubscribe function — call it on cleanup. Only your own custom tags are delivered (host namespaces like `conversation:`/`assistant:` are never forwarded), and the payload is just the changed tags — re-fetch through `window.vellum.fetch` for the data.
+**Live updates — `window.vellum.subscribe({ tags }, cb)`.** Instead of polling on a timer, subscribe to your own invalidation tags and refresh when the data actually changes. After a route mutates data it publishes a `sync_changed` event (`import { publishEvent } from "@vellumai/plugin-api"`, then `publishEvent({ …, message: { type: "sync_changed", tags: ["my-app:items"] } })`); the app subscribes to that tag and re-fetches when it fires. Returns an unsubscribe function — call it on cleanup. Only your own custom tags are delivered (host namespaces like `conversation:`/`assistant:` are never forwarded), and the payload is just the changed tags — re-fetch through `window.vellum.fetch` for the data.
 
 ```tsx
 useEffect(() => {
@@ -295,7 +295,7 @@ useEffect(() => {
 }, []);
 ```
 
-**Writing a route handler.** Routes are `.ts`/`.js` files in `{workspaceDir}/routes/`, served at `/v1/x/<filename>` (`routes/items.ts` → `/v1/x/items`; `routes/bar/index.ts` → `/v1/x/bar`). Write them with `file_write` **before** `app_refresh`. Each exports named functions per HTTP method (`GET`/`POST`/`PUT`/`PATCH`/`DELETE`), receiving the Web `Request` and an optional `context`. Full Node API access (`fs`, `path`, `crypto`), 30s timeout, hot-reloaded on change. No `[id].ts` dynamic segments — use query params.
+**Writing a route handler.** Routes are `.ts`/`.js` files in `{workspaceDir}/routes/`, served at `/v1/x/<filename>` (`routes/items.ts` → `/v1/x/items`; `routes/bar/index.ts` → `/v1/x/bar`). Write them with `file_write` **before** `app_refresh`. Each exports named functions per HTTP method (`GET`/`POST`/`PUT`/`PATCH`/`DELETE`), receiving the Web `Request`. Full Node API access (`fs`, `path`, `crypto`), 30s timeout, hot-reloaded on change. No `[id].ts` dynamic segments — use query params.
 
 ```typescript
 // routes/items.ts
@@ -314,7 +314,7 @@ export async function POST(req: Request): Promise<Response> {
 }
 ```
 
-The optional `context` arg exposes daemon singletons — e.g. `context.assistantEventHub.publish({...})` to push real-time events to connected clients (UI updates, navigation, notifications). It's immutable. Full guide + copyable examples (Focus Timer, Habit Tracker, Expense Tracker): `{baseDir}/references/CUSTOM_ROUTES.md`, `{baseDir}/references/examples/`.
+To reach daemon capabilities, import from `@vellumai/plugin-api` — `publishEvent({...})` to push real-time events to connected clients (UI updates, navigation, notifications), or `runConversationTurn({...})` to post an inbound event into a conversation as a real assistant turn. (An older `context` second argument still works in-process but is deprecated — prefer these imports.) Full guide + copyable examples (Focus Timer, Habit Tracker, Expense Tracker): `{baseDir}/references/CUSTOM_ROUTES.md`, `{baseDir}/references/examples/`.
 
 **Persistence options:** `localStorage` for ephemeral UI state (filters, view modes, drafts); custom routes for persistent records and server-side logic.
 

package/src/config/bundled-skills/app-builder/references/CUSTOM_ROUTES.md

@@ -6,7 +6,7 @@ When the app needs server-side persistence, custom API logic, or workspace file
 
 ## Handler file convention
 
-Each handler file exports named functions for the HTTP methods it supports (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`). Handlers receive two arguments: the standard Web API `Request` and an optional `context` object with runtime singletons.
+Each handler file exports named functions for the HTTP methods it supports (`GET`, `POST`, `PUT`, `PATCH`, `DELETE`). Handlers take the standard Web API `Request`. To reach daemon capabilities (publishing events, running a conversation turn), import them from `@vellumai/plugin-api` — that is the supported way, and it works identically in-process and in the route-host subprocess.
 
 ```
 {workspaceDir}/routes/
@@ -86,27 +86,22 @@ Don't hand-declare `window.vellum` in a local `vellum.d.ts`. If the app depends
 
 Equivalently, add `"@vellumai/plugin-api/app"` to `compilerOptions.types` in `tsconfig.json`. Both are types-only — do **not** `import` from `@vellumai/plugin-api` to get the global; a runtime bare import isn't supported for sandboxed apps. If you want to name a type, use `import type { VellumAppBridge } from "@vellumai/plugin-api/app"`.
 
-## Runtime context
+## Reaching daemon capabilities (`@vellumai/plugin-api`)
 
-Every handler receives a frozen `context` object as its second argument. This provides access to daemon singletons that are otherwise unreachable from dynamically imported route modules.
-
-```typescript
-export async function POST(request: Request, context): Promise<Response> {
-  // context.assistantEventHub — publish events to connected SSE clients
-  // context.conversations     — post messages into conversations as real turns
-}
-```
+To reach a daemon capability from a handler, import it from `@vellumai/plugin-api`. These imports work the same way in-process and in the route-host subprocess.
 
 ### Publishing events to the client
 
-Use `context.assistantEventHub` to push real-time events to connected desktop/mobile clients. This is how route handlers can trigger client-side navigation, update UI, or deliver notifications.
+Use `publishEvent` to push a real-time event to connected desktop/mobile clients. This is how a route triggers client-side navigation, updates UI, or delivers a notification.
 
 ```typescript
 // routes/open-conversation.ts
-export async function POST(request: Request, context): Promise<Response> {
+import { publishEvent } from "@vellumai/plugin-api";
+
+export async function POST(request: Request): Promise<Response> {
   const { conversationId } = await request.json();
 
-  await context.assistantEventHub.publish({
+  await publishEvent({
     id: crypto.randomUUID(),
     assistantId: "self",
     conversationId,
@@ -118,38 +113,33 @@ export async function POST(request: Request, context): Promise<Response> {
 }
 ```
 
+`publishEvent` rejects daemon-to-client host-proxy control events (`host_*`); everything else — including your own `sync_changed` invalidation tags — flows to subscribed clients.
+
 ### Posting into a conversation
 
-Use `context.conversations.postMessage` to surface an inbound event as a real assistant turn — the way a webhook receiver, a scheduled job, or a device callback turns "your deploy finished" or "payment received" into a message the assistant actually responds to (not just a client-side event).
+Use `runConversationTurn` to surface an inbound event as a real assistant turn — the way a webhook receiver, a scheduled job, or a device callback turns "your deploy finished" or "payment received" into a message the assistant actually responds to (not just a client-side event).
 
 ```typescript
 // routes/deploy-webhook.ts — an external CI system POSTs here when a build finishes
-export async function POST(request: Request, context): Promise<Response> {
+import { runConversationTurn } from "@vellumai/plugin-api";
+
+export async function POST(request: Request): Promise<Response> {
   const { conversationId, status } = await request.json();
-  try {
-    await context.conversations.postMessage(
-      conversationId,
-      `Your deploy finished: ${status}.`,
-    );
-    return Response.json({ ok: true });
-  } catch (err) {
-    // err.code is "not_found" | "rate_limited" | "invalid"
-    const code = (err as { code?: string }).code;
-    const httpStatus =
-      code === "not_found" ? 404 : code === "rate_limited" ? 429 : 400;
-    return Response.json(
-      { ok: false, error: String(err) },
-      { status: httpStatus },
-    );
-  }
+
+  await runConversationTurn({
+    conversationId,
+    content: [{ type: "text", text: `Your deploy finished: ${status}.` }],
+  });
+
+  return Response.json({ ok: true });
 }
 ```
 
-The posted turn is attributed to a dedicated `route` interface — it can never impersonate a human surface — and runs under the target conversation's existing trust context, so a route cannot elevate privilege by posting. Unknown conversation ids are rejected (a route never silently creates a conversation), and posts are rate-limited per conversation to backstop runaway route→assistant→route loops.
+Omit `conversationId` to start a fresh conversation (the new id is returned). If the conversation is mid-turn the message is queued and runs when the current turn finishes.
 
-The context object is **immutable** — attempting to reassign its properties will throw in strict mode (ESM). This prevents user route handlers from accidentally corrupting shared state.
+### Deprecated: the `context` argument
 
-Legacy handlers that only accept `(request)` continue to work — the context is passed positionally but ignored if the handler doesn't declare the parameter.
+Older routes were written with a second `context` argument (`context.assistantEventHub.publish(...)`, `context.conversations.postMessage(...)`). That argument still works in-process but is **deprecated** and will be removed — it isn't available in the route-host subprocess, and its use is tracked so remaining callers can be migrated. Port these to the `@vellumai/plugin-api` imports above: `context.assistantEventHub.publish` → `publishEvent`, `context.conversations.postMessage(id, text)` → `runConversationTurn({ conversationId: id, content: [{ type: "text", text }] })`.
 
 ## Key rules
 

package/src/config/bundled-skills/app-builder/references/DESIGN_SYSTEM.md

@@ -20,7 +20,7 @@ A design system CSS is auto-injected inside a `@layer`, so your styles always ta
 | **Typography**  | `--v-font-family`, `--v-font-mono`, `--v-font-size-xs` (10px) / `-sm` (11px) / `-base` (14px) / `-lg` (17px) / `-xl` (22px) / `-2xl` (26px), `--v-line-height` |
 | **Animation**   | `--v-duration-fast` (0.15s) / `-standard` (0.25s) / `-slow` (0.4s)                                                                                             |
 | **Palettes**    | `--v-slate-{950..50}`, `--v-emerald-*`, `--v-violet-*`, `--v-indigo-*`, `--v-rose-*`, `--v-amber-*`                                                            |
-| **Constant**    | `--v-aux-white` (always `#FFFFFF` in both modes — use for text on filled/accent backgrounds)                                                                    |
+| **Constant**    | `--v-aux-white` (always `#FFFFFF` in both modes — use for text on filled/accent backgrounds)                                                                   |
 
 ---
 

package/src/config/bundled-skills/app-builder/references/SLIDES.md

@@ -14,6 +14,7 @@ Slides are a different domain from apps. Skip app-specific patterns (contextual
 ## Navigation
 
 Build slide navigation as your own component. Common patterns:
+
 - Keyboard: `ArrowLeft` / `ArrowRight` / `Space` / `Escape`
 - Click affordances at left/right edges
 - Slide counter pill in a corner (e.g. `3 / 12`)

package/src/config/bundled-skills/app-builder/references/WIDGETS.md

@@ -18,7 +18,7 @@ A CSS widget library is auto-injected alongside the design system — the `.v-*`
 | `.v-progress-bar` / `.v-progress-track` / `.v-progress-fill` | Horizontal progress                                            |
 | `.v-status-badge`                                            | Colored pill with dot (`.success`/`.error`/`.warning`/`.info`) |
 | `.v-stat-row` / `.v-stat`                                    | Horizontal label-value pairs                                   |
-| `.v-toast`                                                   | Notification banner (show/hide with your own JS)              |
+| `.v-toast`                                                   | Notification banner (show/hide with your own JS)               |
 | `.v-avatar-row`                                              | Contact/team display                                           |
 | `.v-tag-group`                                               | Wrapping tag row                                               |
 

package/src/config/bundled-skills/app-builder/tools/app-generate-icon.ts

@@ -15,7 +15,9 @@ export async function run(
   context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const appId = resolveAppId(input, context.conversationId);
-  if (!appId) return missingAppIdError();
+  if (!appId) {
+    return missingAppIdError();
+  }
   return executeAppGenerateIcon(
     { ...input, app_id: appId } as unknown as AppGenerateIconInput,
     appStore,

package/src/config/bundled-skills/app-builder/tools/app-refresh.ts

@@ -14,6 +14,8 @@ export async function run(
   context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const appId = resolveAppId(input, context.conversationId);
-  if (!appId) return missingAppIdError();
+  if (!appId) {
+    return missingAppIdError();
+  }
   return executeAppRefresh({ app_id: appId }, appStore);
 }

package/src/config/bundled-skills/app-builder/tools/app-update.ts

@@ -15,7 +15,9 @@ export async function run(
   context: ToolContext,
 ): Promise<ToolExecutionResult> {
   const appId = resolveAppId(input, context.conversationId);
-  if (!appId) return missingAppIdError();
+  if (!appId) {
+    return missingAppIdError();
+  }
   return executeAppUpdate(
     { ...input, app_id: appId } as unknown as AppUpdateInput,
     appStore,

package/src/config/bundled-skills/contacts/tools/contact-search.ts

@@ -20,16 +20,23 @@ function formatContactSummary(c: SearchContact): string {
   const displayName =
     c.role === "guardian" ? resolveGuardianName(c.displayName) : c.displayName;
   const parts = [`- **${displayName}** (ID: ${c.id})`];
-  if (c.notes) parts.push(`  Notes: ${c.notes}`);
-  if ((c.interactionCount ?? 0) > 0)
+  if (c.notes) {
+    parts.push(`  Notes: ${c.notes}`);
+  }
+  if ((c.interactionCount ?? 0) > 0) {
     parts.push(`  Interactions: ${c.interactionCount}`);
+  }
   if (c.channels.length > 0) {
     const channelList = c.channels
       .map((ch) => {
         let s = `${ch.type}:${ch.address}${ch.isPrimary ? "*" : ""}`;
         const extras: string[] = [];
-        if (ch.externalChatId) extras.push(`chatId: ${ch.externalChatId}`);
-        if (extras.length > 0) s += ` (${extras.join(", ")})`;
+        if (ch.externalChatId) {
+          extras.push(`chatId: ${ch.externalChatId}`);
+        }
+        if (extras.length > 0) {
+          s += ` (${extras.join(", ")})`;
+        }
         return s;
       })
       .join(", ");

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

@@ -59,14 +59,18 @@ export async function run(
           contacts,
           total: resp.totalPeople ?? contacts.length,
         };
-        if (resp.nextPageToken) result.nextPageToken = resp.nextPageToken;
+        if (resp.nextPageToken) {
+          result.nextPageToken = resp.nextPageToken;
+        }
 
         return ok(JSON.stringify(result, null, 2));
       }
 
       case "search": {
         const query = input.query as string;
-        if (!query) return err("query is required for search action.");
+        if (!query) {
+          return err("query is required for search action.");
+        }
 
         const resp = await searchContacts(connection, query);
         const contacts = (resp.results ?? []).map((r) =>

package/src/config/bundled-skills/media-processing/__tests__/extract-keyframes.test.ts

@@ -16,7 +16,9 @@ mock.module("../services/preprocess.js", () => ({
     options: Record<string, unknown>,
   ) => {
     lastPreprocessOptions = options;
-    if (mockPreprocessError) throw mockPreprocessError;
+    if (mockPreprocessError) {
+      throw mockPreprocessError;
+    }
     return mockManifest;
   },
 }));

package/src/config/bundled-skills/media-processing/services/preprocess.ts

@@ -110,7 +110,9 @@ export function parseDroppedFrameTimestamps(stderr: string): number[] {
   const lines = stderr.split("\n");
   for (const line of lines) {
     // mpdecimate marks dropped frames with "drop" at the end of the line
-    if (!line.includes("drop")) continue;
+    if (!line.includes("drop")) {
+      continue;
+    }
     const match = line.match(/pts_time:([\d.]+)/);
     if (match) {
       timestamps.push(parseFloat(match[1]));
@@ -130,7 +132,9 @@ export function buildDeadTimeRanges(
   gapThresholdSeconds: number = 1.0,
   minDurationSeconds: number = 5.0,
 ): TimeRange[] {
-  if (droppedTimestamps.length === 0) return [];
+  if (droppedTimestamps.length === 0) {
+    return [];
+  }
 
   const ranges: TimeRange[] = [];
   let rangeStart = droppedTimestamps[0];
@@ -316,7 +320,9 @@ async function extractDominantColors(framePath: string): Promise<string[]> {
   );
 
   // Fallback: return empty if analysis fails
-  if (result.exitCode !== 0) return [];
+  if (result.exitCode !== 0) {
+    return [];
+  }
 
   // Parse palette info from stderr - look for color hex values
   const colors: string[] = [];

package/src/config/bundled-skills/media-processing/services/processing-pipeline.ts

@@ -70,7 +70,9 @@ function findOrCreateStage(
 ): ProcessingStage {
   const stages = getProcessingStagesForAsset(assetId);
   const existing = stages.find((s) => s.stage === stageName);
-  if (existing) return existing;
+  if (existing) {
+    return existing;
+  }
   return createProcessingStage({ assetId, stage: stageName });
 }
 
@@ -84,7 +86,9 @@ function isStageCompleted(stage: ProcessingStage): boolean {
  */
 function isAssetCancelled(assetId: string): boolean {
   const asset = getMediaAssetById(assetId);
-  if (!asset) return true;
+  if (!asset) {
+    return true;
+  }
   return (asset.status as string) === "cancelled";
 }
 
@@ -234,7 +238,9 @@ export async function runPipeline(
       }
     }
 
-    if (cancelled) break;
+    if (cancelled) {
+      break;
+    }
 
     if (!succeeded) {
       failedStage = stageName;

package/src/config/bundled-skills/media-processing/services/reduce.ts

@@ -137,7 +137,9 @@ async function persistReduceCost(
   result: ReduceResult,
 ): Promise<void> {
   const asset = getMediaAssetById(assetId);
-  if (!asset) return;
+  if (!asset) {
+    return;
+  }
 
   const pipelineDir = join(dirname(asset.filePath), "pipeline", assetId);
   const costPath = join(pipelineDir, "reduce-cost.json");

package/src/config/bundled-skills/media-processing/tools/generate-clip.ts

@@ -44,7 +44,9 @@ async function getMediaDuration(filePath: string): Promise<number> {
     ],
     FFPROBE_TIMEOUT_MS,
   );
-  if (result.exitCode !== 0) return 0;
+  if (result.exitCode !== 0) {
+    return 0;
+  }
   return parseFloat(result.stdout.trim()) || 0;
 }
 

package/src/config/bundled-skills/media-processing/tools/ingest-media.ts

@@ -67,9 +67,15 @@ function detectMimeType(filePath: string): string | null {
 }
 
 function classifyMediaType(mimeType: string): MediaType | null {
-  if (mimeType.startsWith("video/")) return "video";
-  if (mimeType.startsWith("audio/")) return "audio";
-  if (mimeType.startsWith("image/")) return "image";
+  if (mimeType.startsWith("video/")) {
+    return "video";
+  }
+  if (mimeType.startsWith("audio/")) {
+    return "audio";
+  }
+  if (mimeType.startsWith("image/")) {
+    return "image";
+  }
   return null;
 }
 
@@ -92,7 +98,9 @@ async function extractDuration(filePath: string): Promise<number | null> {
       ],
       FFPROBE_TIMEOUT_MS,
     );
-    if (result.exitCode !== 0) return null;
+    if (result.exitCode !== 0) {
+      return null;
+    }
     const duration = parseFloat(result.stdout.trim());
     return Number.isFinite(duration) ? duration : null;
   } catch {

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

@@ -40,7 +40,7 @@ Before using any messaging tool, verify that the platform is connected by callin
 
 ### Public Ingress (required for Telegram)
 
-Telegram setup requires webhook routing, but it does **not** always require ngrok. Before suggesting public ingress for Telegram, check managed callback availability with `assistant platform status --json`. If that reports `isPlatform: true` with a non-empty `assistantId` and `available: true`, use the platform callback route flow and do not prompt for ngrok. Only use the **public-ingress** skill for local assistants that genuinely need a public gateway URL. Slack uses Socket Mode and does not require public ingress. Gmail/Outlook on the desktop app uses a loopback callback and does not require public ingress; the channel path (Path B in the vellum-oauth-integrations skill) handles public ingress internally when needed.
+Telegram setup requires webhook routing, but it does **not** always require ngrok. Before suggesting public ingress for Telegram, check managed callback availability with `assistant platform status --json`. If that reports `available: true` with a non-empty `assistantId`, use the platform callback route flow and do not prompt for ngrok; this applies to managed pods and platform-connected local assistants alike, so do not require `isPlatform: true`. Only use the **public-ingress** skill for local assistants that genuinely need a public gateway URL. Slack uses Socket Mode and does not require public ingress. Gmail/Outlook on the desktop app uses a loopback callback and does not require public ingress; the channel path (Path B in the vellum-oauth-integrations skill) handles public ingress internally when needed.
 
 ### Email Connection Flow
 
@@ -66,7 +66,7 @@ Slack is **not** handled by this skill. For Slack setup, load the **slack-app-se
 
 ### Telegram
 
-Telegram uses a bot token (not OAuth). Load the **telegram-setup** skill, which uses a managed platform callback route in containerized deployments and falls back to **public-ingress** locally when needed:
+Telegram uses a bot token (not OAuth). Load the **telegram-setup** skill, which uses a managed platform callback route on platform-connected assistants (managed pods and local assistants alike) and falls back to **public-ingress** for self-hosted setups when needed:
 
 - First run `assistant platform status --json`. If it shows managed callback routing is available, tell the user you will use the platform callback route and skip ngrok/public-ingress.
 - Call `skill_load` with `skill: "telegram-setup"` to load the dependency skill.

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

@@ -29,7 +29,9 @@ function upsertMemoryItem(opts: {
   importance: number;
 }): void {
   const db = getMemoryDb();
-  if (!db) return;
+  if (!db) {
+    return;
+  }
   const now = Date.now();
   const content = `${opts.subject}\n${opts.statement}`;
 
@@ -142,7 +144,9 @@ export async function run(
     }
 
     for (const contact of result.contactObservations) {
-      if (!contact.name || !contact.toneNote) continue;
+      if (!contact.name || !contact.toneNote) {
+        continue;
+      }
       const subject = `${provider.id} relationship: ${contact.name}`;
       upsertMemoryItem({
         kind: "relationship",

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

@@ -21,10 +21,15 @@ export async function run(
       const conversationId = input.conversation_id as string | undefined;
       const text = input.text as string | undefined;
 
-      if (!platform) return err("platform is required for creating a draft.");
-      if (!conversationId)
+      if (!platform) {
+        return err("platform is required for creating a draft.");
+      }
+      if (!conversationId) {
         return err("conversation_id is required for creating a draft.");
-      if (!text) return err("text is required for creating a draft.");
+      }
+      if (!text) {
+        return err("text is required for creating a draft.");
+      }
 
       const draft = createDraft({
         platform,
@@ -38,19 +43,29 @@ export async function run(
 
     case "list": {
       const platform = input.platform as string | undefined;
-      if (!platform) return err("platform is required for listing drafts.");
+      if (!platform) {
+        return err("platform is required for listing drafts.");
+      }
       const drafts = listDrafts(platform);
-      if (drafts.length === 0) return ok("No drafts found.");
+      if (drafts.length === 0) {
+        return ok("No drafts found.");
+      }
       return ok(JSON.stringify(drafts, null, 2));
     }
 
     case "delete": {
       const draftId = input.draft_id as string | undefined;
       const platform = input.platform as string | undefined;
-      if (!draftId) return err("draft_id is required for deleting a draft.");
-      if (!platform) return err("platform is required for deleting a draft.");
+      if (!draftId) {
+        return err("draft_id is required for deleting a draft.");
+      }
+      if (!platform) {
+        return err("platform is required for deleting a draft.");
+      }
       const deleted = deleteDraft(platform, draftId);
-      if (!deleted) return err("Draft not found.");
+      if (!deleted) {
+        return err("Draft not found.");
+      }
       return ok("Draft deleted.");
     }
 

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

@@ -82,10 +82,11 @@ export async function run(
 
     // Gmail: create a draft instead of sending directly
     if (provider.id === "gmail") {
-      if (!conn)
+      if (!conn) {
         return err(
           "Gmail requires an OAuth connection — is the account connected?",
         );
+      }
       const gmailConn = conn;
       // Reply mode: thread_id provided - create a threaded draft with reply-all recipients
       if (threadId) {
@@ -124,7 +125,9 @@ export async function run(
         const toAddrs = extractHeader(latestHeaders, "To");
         const ccAddrs = extractHeader(latestHeaders, "Cc");
 
-        if (fromAddr) allRecipients.add(fromAddr);
+        if (fromAddr) {
+          allRecipients.add(fromAddr);
+        }
         for (const addr of parseAddressList(toAddrs)) {
           allRecipients.add(addr);
         }

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

@@ -56,7 +56,9 @@ export function parseAddressList(header: string): string[] {
       current += ch;
     } else if (ch === "," && !inQuotes && !inAngle) {
       const trimmed = current.trim();
-      if (trimmed) addresses.push(trimmed);
+      if (trimmed) {
+        addresses.push(trimmed);
+      }
       current = "";
     } else {
       current += ch;
@@ -64,7 +66,9 @@ export function parseAddressList(header: string): string[] {
   }
 
   const trimmed = current.trim();
-  if (trimmed) addresses.push(trimmed);
+  if (trimmed) {
+    addresses.push(trimmed);
+  }
 
   return addresses;
 }
@@ -91,7 +95,9 @@ export function extractEmail(address: string): string {
   const segments = [...cleaned.matchAll(/<([^>]+)>/g)].map((m) => m[1]);
   if (segments.length > 0) {
     const emailSegment = [...segments].reverse().find((s) => s.includes("@"));
-    if (emailSegment) return emailSegment.trim().toLowerCase();
+    if (emailSegment) {
+      return emailSegment.trim().toLowerCase();
+    }
   }
   return address
     .replace(/<[^>]+>/g, "")
@@ -109,10 +115,14 @@ export function extractEmail(address: string): string {
 export async function resolveProvider(
   platformInput?: string,
 ): Promise<MessagingProvider> {
-  if (platformInput) return getMessagingProvider(platformInput);
+  if (platformInput) {
+    return getMessagingProvider(platformInput);
+  }
 
   const connected = await getConnectedProviders();
-  if (connected.length === 1) return connected[0];
+  if (connected.length === 1) {
+    return connected[0];
+  }
   if (connected.length === 0) {
     throw new Error(
       "No messaging platforms are connected. Use messaging_auth_test to check connection status, then set up a platform.",
@@ -135,8 +145,12 @@ export async function getProviderConnection(
   provider: MessagingProvider,
   account?: string,
 ): Promise<OAuthConnection | undefined> {
-  if (provider.resolveConnection) return provider.resolveConnection(account);
-  if (await provider.isConnected?.()) return undefined;
+  if (provider.resolveConnection) {
+    return provider.resolveConnection(account);
+  }
+  if (await provider.isConnected?.()) {
+    return undefined;
+  }
   return resolveOAuthConnection(provider.credentialService, {
     account,
     requiredScopes: provider.requiredScopes,

package/src/config/bundled-skills/phone-calls/references/TRANSCRIPTS.md

@@ -46,13 +46,13 @@ sqlite3 "$VELLUM_WORKSPACE_DIR/data/db/assistant.db" \
 
 ## Key paths
 
-| Resource                                      | Path                                                  |
-| --------------------------------------------- | ----------------------------------------------------- |
-| Assistant logs (caller-side transcripts only) | `$VELLUM_WORKSPACE_DIR/data/logs/assistant-*.log`     |
-| Full conversation database                    | `$VELLUM_WORKSPACE_DIR/data/db/assistant.db`          |
-| Messages table                                | `messages` (keyed by `conversation_id`)               |
-| Call sessions table                           | `call_sessions`                                       |
-| Call events table                             | `call_events`                                         |
+| Resource                                      | Path                                              |
+| --------------------------------------------- | ------------------------------------------------- |
+| Assistant logs (caller-side transcripts only) | `$VELLUM_WORKSPACE_DIR/data/logs/assistant-*.log` |
+| Full conversation database                    | `$VELLUM_WORKSPACE_DIR/data/db/assistant.db`      |
+| Messages table                                | `messages` (keyed by `conversation_id`)           |
+| Call sessions table                           | `call_sessions`                                   |
+| Call events table                             | `call_events`                                     |
 
 ## Important
 

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

@@ -51,19 +51,26 @@ export async function executePlaybookList(
     for (const row of rows) {
       // Content format: "Playbook: <trigger>\n<json statement>"
       const newlineIdx = row.content.indexOf("\n");
-      if (newlineIdx === -1) continue;
+      if (newlineIdx === -1) {
+        continue;
+      }
       const statement = row.content.slice(newlineIdx + 1);
       const playbook = parsePlaybookStatement(statement);
-      if (!playbook) continue;
+      if (!playbook) {
+        continue;
+      }
 
       // Apply filters
       if (
         channelFilter &&
         playbook.channel !== channelFilter &&
         playbook.channel !== "*"
-      )
+      ) {
+        continue;
+      }
+      if (categoryFilter && playbook.category !== categoryFilter) {
         continue;
-      if (categoryFilter && playbook.category !== categoryFilter) continue;
+      }
 
       entries.push({
         id: row.id,

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

@@ -123,6 +123,10 @@ assistant conversations wake "$id" --hint "Summarize the new items" --external-c
 
 Execute-mode runs use the default `mainAgent` model selection unless the schedule pins an `inference_profile` (a key from `llm.profiles`). Pin a profile when a recurring task should run on a specific model — e.g. a cost-optimized profile for a high-frequency digest. Pass `inference_profile: null` on update to revert to the default. The pinned profile is shown on the schedule's details page in settings.
 
+## Conversation Group
+
+Conversations created by a schedule's runs land in the sidebar's Scheduled section by default. Pass `group` (a group name or id) on create or update to file them into a custom sidebar group instead, e.g. a "Briefs" group for a morning digest. The group must already exist (create it with the conversation-groups skill); pass `group: null` on update to revert to the default. If the group is later deleted, runs fall back to the Scheduled section. Changing the group affects future runs only; move an existing conversation with `conversation_move_to_group`.
+
 ## Conversation Reuse
 
 Recurring schedules reuse the same conversation across runs by default — subsequent runs continue the conversation from the last successful run, preserving context and channel thread continuity. Set `reuse_conversation: false` explicitly if each run should start with a fresh conversation (e.g. independent reports that shouldn't accumulate prior context). One-shot schedules always create a fresh conversation.