@vellumai/assistant 0.4.43 → 0.4.45

package/src/config/bundled-skills/influencer/scripts/influencer.ts

@@ -1,267 +0,0 @@
-#!/usr/bin/env bun
-import { parseArgs } from "node:util";
-
-import {
-  compareInfluencers,
-  getInfluencerProfile,
-  type InfluencerSearchCriteria,
-  searchInfluencers,
-} from "./client.js";
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-const isJson = process.argv.includes("--json");
-
-function output(data: unknown): void {
-  process.stdout.write(
-    isJson ? JSON.stringify(data) + "\n" : JSON.stringify(data, null, 2) + "\n",
-  );
-}
-
-function outputError(message: string, code = 1): void {
-  output({ ok: false, error: message });
-  process.exitCode = code;
-}
-
-async function run(fn: () => Promise<unknown>): Promise<void> {
-  try {
-    const result = await fn();
-    output({ ok: true, ...(result as Record<string, unknown>) });
-  } catch (err) {
-    outputError(err instanceof Error ? err.message : String(err));
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Utilities
-// ---------------------------------------------------------------------------
-
-/**
- * Parse human-friendly numbers like "10k", "1.5m", "100000" into integers.
- */
-function parseHumanNumber(text: string): number {
-  const cleaned = text.toLowerCase().replace(/,/g, "").trim();
-  const match = cleaned.match(/^([\d.]+)\s*([kmbt]?)$/);
-  if (!match) return parseInt(text, 10) || 0;
-
-  const num = parseFloat(match[1]);
-  const suffix = match[2];
-  const multipliers: Record<string, number> = {
-    "": 1,
-    k: 1_000,
-    m: 1_000_000,
-    b: 1_000_000_000,
-    t: 1_000_000_000_000,
-  };
-
-  return Math.round(num * (multipliers[suffix] || 1));
-}
-
-// ---------------------------------------------------------------------------
-// Help
-// ---------------------------------------------------------------------------
-
-const USAGE = `influencer — Research influencers on Instagram, TikTok, and X/Twitter
-
-Uses the Chrome extension relay to browse each platform. Requires the user to
-be logged in on each platform in Chrome.
-
-USAGE
-  influencer <subcommand> [options]
-
-SUBCOMMANDS
-  search <query>                Search for influencers matching criteria
-  profile <username>            Get detailed profile data for one influencer
-  compare <platform:user ...>   Compare multiple influencers side by side
-
-GLOBAL OPTIONS
-  --json        Machine-readable JSON output (compact, one line)
-  --help, -h    Show this help message
-
-SEARCH OPTIONS
-  --platforms <list>       Comma-separated platforms (default: instagram,tiktok,twitter)
-  --min-followers <n>      Minimum follower count (e.g. 10k, 1.5m, 50000)
-  --max-followers <n>      Maximum follower count
-  --limit <n>              Max results per platform (default: 10)
-  --verified               Only return verified accounts
-
-PROFILE OPTIONS
-  --platform <name>        Platform to look up (default: instagram)
-
-EXAMPLES
-  influencer search "fitness coach" --platforms instagram,tiktok
-  influencer search "vegan food" --min-followers 10k --max-followers 1m --json
-  influencer profile natgeo --platform instagram
-  influencer compare instagram:nike twitter:nike tiktok:nike
-`;
-
-if (process.argv.includes("--help") || process.argv.includes("-h")) {
-  process.stdout.write(USAGE);
-  process.exit(0);
-}
-
-// ---------------------------------------------------------------------------
-// Subcommand routing
-// ---------------------------------------------------------------------------
-
-const subcommand = process.argv[2];
-
-switch (subcommand) {
-  case "search": {
-    // Strip the subcommand and --json from argv for parseArgs
-    const filteredArgs = process.argv.slice(3).filter((a) => a !== "--json");
-
-    const { values, positionals } = parseArgs({
-      args: filteredArgs,
-      options: {
-        platforms: { type: "string", default: "instagram,tiktok,twitter" },
-        "min-followers": { type: "string" },
-        "max-followers": { type: "string" },
-        limit: { type: "string", default: "10" },
-        verified: { type: "boolean", default: false },
-      },
-      allowPositionals: true,
-    });
-
-    const query = positionals[0];
-    if (!query) {
-      outputError("Missing required argument: <query>");
-      break;
-    }
-
-    const platforms = (values.platforms as string)
-      .split(",")
-      .map((p) => p.trim().toLowerCase())
-      .filter((p): p is "instagram" | "tiktok" | "twitter" =>
-        ["instagram", "tiktok", "twitter"].includes(p),
-      );
-
-    const criteria: InfluencerSearchCriteria = {
-      query,
-      platforms,
-      minFollowers: values["min-followers"]
-        ? parseHumanNumber(values["min-followers"] as string)
-        : undefined,
-      maxFollowers: values["max-followers"]
-        ? parseHumanNumber(values["max-followers"] as string)
-        : undefined,
-      limit: parseInt(values.limit as string, 10),
-      verifiedOnly: values.verified as boolean,
-    };
-
-    await run(async () => {
-      const results = await searchInfluencers(criteria);
-      const totalProfiles = results.reduce((sum, r) => sum + r.count, 0);
-      return {
-        results,
-        totalProfiles,
-        platforms: platforms.length,
-        query,
-      };
-    });
-
-    break;
-  }
-
-  case "profile": {
-    const filteredArgs = process.argv.slice(3).filter((a) => a !== "--json");
-
-    const { values, positionals } = parseArgs({
-      args: filteredArgs,
-      options: {
-        platform: { type: "string", default: "instagram" },
-      },
-      allowPositionals: true,
-    });
-
-    const username = positionals[0];
-    if (!username) {
-      outputError("Missing required argument: <username>");
-      break;
-    }
-
-    const platform = (values.platform as string).toLowerCase() as
-      | "instagram"
-      | "tiktok"
-      | "twitter";
-    if (!["instagram", "tiktok", "twitter"].includes(platform)) {
-      outputError(
-        `Invalid platform: ${values.platform}. Use instagram, tiktok, or twitter.`,
-      );
-      break;
-    }
-
-    const cleanUsername = username.replace(/^@/, "");
-
-    await run(async () => {
-      const profile = await getInfluencerProfile(platform, cleanUsername);
-      if (!profile) {
-        throw new Error(
-          `Could not find profile @${cleanUsername} on ${platform}`,
-        );
-      }
-      return { profile };
-    });
-
-    break;
-  }
-
-  case "compare": {
-    const filteredArgs = process.argv.slice(3).filter((a) => a !== "--json");
-
-    const { positionals } = parseArgs({
-      args: filteredArgs,
-      options: {},
-      allowPositionals: true,
-    });
-
-    if (positionals.length === 0) {
-      outputError("Missing required arguments: <platform:username ...>");
-      break;
-    }
-
-    const parsed = positionals.map((inf) => {
-      const [platform, username] = inf.includes(":")
-        ? inf.split(":", 2)
-        : ["instagram", inf];
-
-      const cleanPlatform = platform.toLowerCase() as
-        | "instagram"
-        | "tiktok"
-        | "twitter";
-      if (!["instagram", "tiktok", "twitter"].includes(cleanPlatform)) {
-        throw new Error(
-          `Invalid platform "${platform}" in "${inf}". Use instagram, tiktok, or twitter.`,
-        );
-      }
-
-      return {
-        platform: cleanPlatform,
-        username: username.replace(/^@/, ""),
-      };
-    });
-
-    await run(async () => {
-      const profiles = await compareInfluencers(parsed);
-      return {
-        profiles,
-        count: profiles.length,
-        requested: parsed.length,
-      };
-    });
-
-    break;
-  }
-
-  default: {
-    process.stderr.write(
-      subcommand
-        ? `Unknown subcommand: ${subcommand}\n\n`
-        : "No subcommand provided.\n\n",
-    );
-    process.stderr.write(USAGE);
-    process.exitCode = 1;
-  }
-}

package/src/config/bundled-skills/macos-automation/SKILL.md

@@ -1,65 +0,0 @@
----
-name: macos-automation
-description: Automate native macOS apps and system interactions via osascript (AppleScript)
-compatibility: "Designed for Vellum personal assistants"
-metadata: {"emoji":"🍎","vellum":{"display-name":"macOS Automation","user-invocable":false,"os":["darwin"]}}
----
-
-Use this skill to interact with native macOS apps and system-level features via `osascript` (AppleScript) through `host_bash`. Always prefer osascript over browser automation or computer-use for anything involving a native macOS app.
-
-## Supported Apps
-
-**Communication:** Messages, Mail, Microsoft Outlook, FaceTime
-**Contacts & Calendar:** Contacts, Calendar, Reminders
-**Notes & Writing:** Notes, TextEdit, Pages, BBEdit, CotEditor
-**Files:** Finder, Path Finder
-**Browsers:** Safari, Google Chrome
-**Music & Media:** Music (iTunes), Spotify, VLC, Podcasts, TV
-**Productivity:** OmniFocus, Things 3, OmniOutliner, OmniPlan, OmniGraffle
-**Office:** Microsoft Word, Microsoft Excel, Numbers, Keynote
-**Developer tools:** Xcode, Terminal, iTerm2, Script Editor
-**System:** System Events (UI scripting for any app), System Settings
-**Automation:** Keyboard Maestro, Alfred, Automator
-**Creative:** Adobe Photoshop, Final Cut Pro
-
-For any unlisted app, check scriptability first:
-```bash
-osascript -e 'tell application "AppName" to get name'
-```
-
-## Examples
-
-```bash
-# Send an iMessage
-osascript -e 'tell application "Messages" to send "Hello!" to buddy "user@example.com"'
-
-# Look up a contact
-osascript -e 'tell application "Contacts" to get {name, phones} of every person whose name contains "Marina"'
-
-# Read upcoming calendar events
-osascript -e 'tell application "Calendar" to get summary of every event of calendar "Home" whose start date > (current date)'
-
-# Create a reminder
-osascript -e 'tell application "Reminders" to make new reminder with properties {name:"Buy milk", due date:((current date) + 1 * hours)}'
-
-# Send an email
-osascript -e 'tell application "Mail" to send (make new outgoing message with properties {subject:"Hi", content:"Hello", visible:true})'
-
-# Create a note
-osascript -e 'tell application "Notes" to make new note at folder "Notes" with properties {body:"My note"}'
-
-# Open a URL in Safari
-osascript -e 'tell application "Safari" to open location "https://example.com"'
-
-# Play/pause Music
-osascript -e 'tell application "Music" to playpause'
-
-# Display a system notification
-osascript -e 'display notification "Done!" with title "Vellum"'
-```
-
-## Tips
-
-- For multi-line scripts, write them to a `.applescript` file and run with `osascript path/to/script.applescript`
-- Use `System Events` for UI scripting apps that don't have their own AppleScript dictionary
-- AppleScript permissions are gated by macOS TCC — if a command fails with a permission error, use `request_system_permission` to prompt the user

package/src/config/bundled-skills/macos-automation/icon.svg

@@ -1,12 +0,0 @@
-<svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg">
-<rect x="2" y="2" width="12" height="11" fill="#e8e8e8" stroke="#333" stroke-width="1"/>
-<rect x="3" y="3" width="10" height="9" fill="#f5f5f5"/>
-<circle cx="8" cy="7" r="2" fill="#0071e3"/>
-<rect x="5" y="5" width="1" height="1" fill="#333"/>
-<rect x="10" y="5" width="1" height="1" fill="#333"/>
-<rect x="5" y="9" width="1" height="1" fill="#333"/>
-<rect x="10" y="9" width="1" height="1" fill="#333"/>
-<path d="M 8 4 L 8 6 M 6 7 L 8 7 M 8 8 L 8 10 M 8 7 L 10 7" stroke="#0071e3" stroke-width="1" fill="none"/>
-<rect x="3" y="13" width="10" height="1" fill="#333"/>
-<rect x="4" y="14" width="8" height="1" fill="#0071e3"/>
-</svg>

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

@@ -1,75 +0,0 @@
----
-name: mcp-setup
-description: Add, authenticate, list, and remove MCP (Model Context Protocol) servers
-compatibility: "Designed for Vellum personal assistants"
-metadata: {"emoji":"🔌","vellum":{"display-name":"MCP Setup","user-invocable":false}}
----
-
-Help users configure MCP servers so external tools (e.g. Linear, GitHub, Notion) become available in conversations.
-
-## CLI Commands
-
-All commands use `assistant mcp`. Run them via `host_bash`.
-
-### List servers
-
-```
-assistant mcp list
-```
-
-Shows all configured servers with connection status, transport type, and URL.
-
-### Add a server
-
-```
-assistant mcp add <name> -t <transport-type> -u <url> [-r <risk>] [--disabled]
-```
-
-- `<name>` — unique identifier (e.g. `linear`, `github`)
-- `-t` — transport type: `stdio`, `sse`, or `streamable-http`
-- `-u` — server URL (required for `sse`/`streamable-http`)
-- `-c` — command (required for `stdio`), `-a` for args
-- `-r` — risk level: `low`, `medium`, or `high` (default: `high`)
-
-Examples:
-
-```
-assistant mcp add linear -t streamable-http -u https://mcp.linear.app/mcp
-assistant mcp add context7 -t streamable-http -u https://mcp.context7.com/mcp -r low
-assistant mcp add local-db -t stdio -c npx -a -y @my/mcp-server
-```
-
-### Authenticate (OAuth)
-
-```
-assistant mcp auth <name>
-```
-
-Opens the user's browser for OAuth authorization. Only works for `sse`/`streamable-http` servers that require authentication. After the user completes login in the browser, tokens are saved automatically.
-
-Use this when:
-
-- A server shows `! Needs authentication` in `assistant mcp list`
-- An MCP tool call fails with an auth/token error
-- Setting up a new OAuth-protected server for the first time
-
-### Remove a server
-
-```
-assistant mcp remove <name>
-```
-
-Removes the server config and cleans up any stored OAuth credentials.
-
-## After Changes
-
-After adding, removing, or authenticating a server, the user must **quit and relaunch the Vellum app** for changes to take effect. The app runs its own assistant process — `assistant daemon restart` only restarts the CLI assistant, which is a separate process.
-
-Tell the user: "Please quit and relaunch the Vellum app, then start a new conversation."
-
-## When to Use
-
-- User asks to connect/set up an external service via MCP
-- User asks "what MCP servers do I have?"
-- An MCP tool returns an auth error — offer to run `assistant mcp auth <name>`
-- User wants to remove an MCP integration

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

@@ -1,184 +0,0 @@
-/**
- * Media diagnostics tool.
- *
- * Surfaces processing stats, per-stage timing, failure reasons,
- * and cost estimation for a media asset.
- * All metrics are generic media-processing infrastructure.
- */
-
-import { readFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-
-import {
-  getKeyframesForAsset,
-  getMediaAssetById,
-  getProcessingStagesForAsset,
-  type ProcessingStage,
-} from "../../../../memory/media-store.js";
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import type { PreprocessManifest } from "../services/preprocess.js";
-import type { ReduceCostData } from "../services/reduce.js";
-// ---------------------------------------------------------------------------
-// Cost estimation constants (Gemini 2.5 Flash pricing)
-// ---------------------------------------------------------------------------
-
-/** Estimated cost per segment Map call (Gemini 2.5 Flash with ~10 frames). */
-const ESTIMATED_COST_PER_SEGMENT_USD = 0.001;
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-interface StageDiagnostic {
-  stage: string;
-  status: string;
-  progress: number;
-  durationMs: number | null;
-  lastError: string | null;
-}
-
-interface DiagnosticReport {
-  assetId: string;
-  assetTitle: string;
-  assetStatus: string;
-  mediaType: string;
-  durationSeconds: number | null;
-  processingStats: {
-    totalKeyframes: number;
-  };
-  stages: StageDiagnostic[];
-  costEstimate: {
-    mapPhase: {
-      keyframeCount: number;
-      estimatedSegments: number;
-      estimatedCostPerSegment: number;
-      estimatedMapCost: number;
-    };
-    reduceCost: ReduceCostData | null;
-    estimatedTotalCost: number;
-    currency: string;
-    note: string;
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function computeStageDuration(stage: ProcessingStage): number | null {
-  if (stage.startedAt == null) return null;
-  if (stage.completedAt != null) return stage.completedAt - stage.startedAt;
-  // Only use Date.now() as a fallback for currently running stages
-  if (stage.status === "running") return Date.now() - stage.startedAt;
-  // For failed/pending stages without completedAt, duration is unknown
-  return null;
-}
-
-// ---------------------------------------------------------------------------
-// Main entry point
-// ---------------------------------------------------------------------------
-
-export async function run(
-  input: Record<string, unknown>,
-  _context: ToolContext,
-): Promise<ToolExecutionResult> {
-  const assetId = input.asset_id as string | undefined;
-  if (!assetId) {
-    return { content: "asset_id is required.", isError: true };
-  }
-
-  const asset = getMediaAssetById(assetId);
-  if (!asset) {
-    return { content: `Media asset not found: ${assetId}`, isError: true };
-  }
-
-  // Gather processing stats
-  const keyframes = getKeyframesForAsset(assetId);
-
-  // Per-stage diagnostics (new pipeline: preprocess, map, reduce)
-  const stages = getProcessingStagesForAsset(assetId);
-  const stageDiagnostics: StageDiagnostic[] = stages.map((s) => ({
-    stage: s.stage,
-    status: s.status,
-    progress: s.progress,
-    durationMs: computeStageDuration(s),
-    lastError: s.lastError,
-  }));
-
-  // Cost estimation: Gemini 2.5 Flash is ~$0.001 per segment (~10 frames each)
-  const keyframeCount = keyframes.length;
-
-  // Prefer actual segment count from preprocess manifest when available
-  let estimatedSegments: number;
-  const manifestPath = join(
-    dirname(asset.filePath),
-    "pipeline",
-    asset.id,
-    "manifest.json",
-  );
-  try {
-    const raw = await readFile(manifestPath, "utf-8");
-    const manifest: PreprocessManifest = JSON.parse(raw);
-    estimatedSegments = manifest.segments.length;
-  } catch {
-    // Manifest doesn't exist yet (preprocess hasn't run) — fall back to estimation
-    estimatedSegments = Math.ceil(keyframeCount / 10);
-  }
-
-  const estimatedMapCost = estimatedSegments * ESTIMATED_COST_PER_SEGMENT_USD;
-
-  // Load reduce cost data if available
-  const reduceCostPath = join(
-    dirname(asset.filePath),
-    "pipeline",
-    asset.id,
-    "reduce-cost.json",
-  );
-  let reduceCost: ReduceCostData | null = null;
-  try {
-    const raw = await readFile(reduceCostPath, "utf-8");
-    reduceCost = JSON.parse(raw) as ReduceCostData;
-  } catch {
-    // No reduce cost data yet
-  }
-
-  // Combine map + reduce costs for the total estimate
-  // Reduce cost is token-based; use a rough estimate of $3/M input + $15/M output (Claude Sonnet-class)
-  const reduceEstimatedCost = reduceCost
-    ? (reduceCost.totalInputTokens * 3 + reduceCost.totalOutputTokens * 15) /
-      1_000_000
-    : 0;
-  const estimatedTotalCost = estimatedMapCost + reduceEstimatedCost;
-
-  const report: DiagnosticReport = {
-    assetId: asset.id,
-    assetTitle: asset.title,
-    assetStatus: asset.status,
-    mediaType: asset.mediaType,
-    durationSeconds: asset.durationSeconds,
-    processingStats: {
-      totalKeyframes: keyframeCount,
-    },
-    stages: stageDiagnostics,
-    costEstimate: {
-      mapPhase: {
-        keyframeCount,
-        estimatedSegments,
-        estimatedCostPerSegment: ESTIMATED_COST_PER_SEGMENT_USD,
-        estimatedMapCost: Math.round(estimatedMapCost * 1000) / 1000,
-      },
-      reduceCost,
-      estimatedTotalCost: Math.round(estimatedTotalCost * 1000000) / 1000000,
-      currency: "USD",
-      note: "Map: Gemini 2.5 Flash per segment. Reduce: Claude token-based ($3/M input, $15/M output).",
-    },
-  };
-
-  return {
-    content: JSON.stringify(report, null, 2),
-    isError: false,
-  };
-}

package/src/config/bundled-skills/messaging/tools/gmail-archive-by-query.ts

@@ -1,80 +0,0 @@
-import {
-  batchModifyMessages,
-  listMessages,
-} from "../../../../messaging/providers/gmail/client.js";
-import { getMessagingProvider } from "../../../../messaging/registry.js";
-import { withValidToken } from "../../../../security/token-manager.js";
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import { err, ok } from "./shared.js";
-
-const BATCH_MODIFY_LIMIT = 1000;
-const MAX_MESSAGES = 5000;
-
-export async function run(
-  input: Record<string, unknown>,
-  context: ToolContext,
-): Promise<ToolExecutionResult> {
-  if (!context.triggeredBySurfaceAction) {
-    return err(
-      "This tool requires user confirmation via a surface action. Present results in a selection table with action buttons and wait for the user to click before proceeding.",
-    );
-  }
-
-  const query = input.query as string;
-
-  if (!query) {
-    return err("query is required.");
-  }
-
-  try {
-    const provider = getMessagingProvider("gmail");
-    return withValidToken(provider.credentialService, async (token) => {
-      // Paginate through matching messages, capped to prevent unbounded API/memory usage
-      const allMessageIds: string[] = [];
-      let pageToken: string | undefined;
-      let truncated = false;
-
-      while (allMessageIds.length < MAX_MESSAGES) {
-        const listResp = await listMessages(
-          token,
-          query,
-          Math.min(500, MAX_MESSAGES - allMessageIds.length),
-          pageToken,
-        );
-        const ids = (listResp.messages ?? []).map((m) => m.id);
-        if (ids.length === 0) break;
-        allMessageIds.push(...ids);
-        pageToken = listResp.nextPageToken ?? undefined;
-        if (!pageToken) break;
-      }
-
-      // If we stopped because we hit the cap while more pages existed, flag truncation
-      if (allMessageIds.length >= MAX_MESSAGES && pageToken) {
-        truncated = true;
-      }
-
-      if (allMessageIds.length === 0) {
-        return ok("No messages matched the query. Nothing archived.");
-      }
-
-      // Archive in chunks of BATCH_MODIFY_LIMIT (Gmail's per-call limit)
-      for (let i = 0; i < allMessageIds.length; i += BATCH_MODIFY_LIMIT) {
-        const chunk = allMessageIds.slice(i, i + BATCH_MODIFY_LIMIT);
-        await batchModifyMessages(token, chunk, { removeLabelIds: ["INBOX"] });
-      }
-
-      const summary = `Archived ${allMessageIds.length} message(s) matching query: ${query}`;
-      if (truncated) {
-        return ok(
-          `${summary}\n\nNote: this operation was capped at ${MAX_MESSAGES} messages. Additional messages matching the query may remain in the inbox. Run the command again to archive more.`,
-        );
-      }
-      return ok(summary);
-    });
-  } catch (e) {
-    return err(e instanceof Error ? e.message : String(e));
-  }
-}