@vellumai/assistant 0.6.4 → 0.6.6

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

@@ -1,47 +0,0 @@
-/**
- * Shared utilities for gmail skill tools.
- */
-
-import {
-  request as httpsRequest,
-  type RequestOptions as HttpsRequestOptions,
-} from "node:https";
-
-import type { ToolExecutionResult } from "../../../../tools/types.js";
-
-export function ok(content: string): ToolExecutionResult {
-  return { content, isError: false };
-}
-
-export function err(message: string): ToolExecutionResult {
-  return { content: message, isError: true };
-}
-
-/** Make an HTTPS request pinned to a specific resolved IP to prevent DNS rebinding. */
-export function pinnedHttpsRequest(
-  target: URL,
-  resolvedAddress: string,
-  options?: {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string;
-  },
-): Promise<number> {
-  return new Promise((resolve, reject) => {
-    const reqOpts: HttpsRequestOptions = {
-      method: options?.method ?? "GET",
-      hostname: resolvedAddress,
-      port: target.port ? Number(target.port) : undefined,
-      path: `${target.pathname}${target.search}`,
-      headers: { host: target.host, ...options?.headers },
-      servername: target.hostname,
-    };
-    const req = httpsRequest(reqOpts, (res) => {
-      res.resume();
-      resolve(res.statusCode ?? 0);
-    });
-    req.once("error", reject);
-    if (options?.body) req.write(options.body);
-    req.end();
-  });
-}

package/src/config/bundled-skills/google-calendar/SKILL.md

@@ -1,51 +0,0 @@
----
-name: google-calendar
-description: View, create, and manage Google Calendar events and check availability
-compatibility: "Designed for Vellum personal assistants"
-metadata:
-  emoji: "📅"
-  vellum:
-    display-name: "Google Calendar"
----
-
-You are a Google Calendar assistant with full access to the user's calendar. Use the Calendar tools to help them view, create, and manage events.
-
-## Connection Setup
-
-Before using any Calendar tool, verify that Google Calendar is connected by attempting a lightweight call (e.g., `calendar_list_events` with a narrow date range). If the call fails with a token/authorization error:
-
-1. **Try connecting directly first.** Run `assistant oauth status google`. This will show whether or not the user had previously connected their google account. If so, they are ready to go.
-2. **If no connections are found:** Call `skill_load` with `skill: "vellum-oauth-integrations"`. The skill will evaluate whether managed or your-own mode is appropriate and guide the user accordingly.
-
-## Capabilities
-
-- **List Events**: View upcoming events from any calendar within a date range.
-- **Get Event**: Read full details of a specific calendar event.
-- **Create Event**: Create new events with attendees, location, and description.
-- **Check Availability**: Find free/busy times across calendars to identify open slots for scheduling.
-- **RSVP**: Respond to event invitations (accepted, declined, tentative).
-
-## Scheduling Playbook
-
-When the user wants to schedule something:
-
-1. **Always check availability first** before proposing times. Use `calendar_check_availability` to find free slots.
-2. Propose 2-3 available time options to the user.
-3. Once the user picks a time, create the event with `calendar_create_event`.
-4. If adding other attendees, mention that they'll receive an invitation email.
-
-## Date & Time Handling
-
-- Always ask the user for their timezone if it's not already known from context or their profile.
-- Use ISO 8601 format for dates and times (e.g., `2024-01-15T09:00:00-05:00`).
-- For all-day events, use date-only format (e.g., `2024-01-15`).
-- When listing events, display times in the user's local timezone.
-
-## Confidence Scores
-
-Medium-risk tools (create event, RSVP) require a confidence score between 0 and 1. Set this based on how certain you are the action matches the user's intent:
-
-- **0.9-1.0**: User explicitly requested this exact action
-- **0.7-0.8**: Action is strongly implied by context
-- **0.5-0.6**: Reasonable inference but some ambiguity
-- **Below 0.5**: Ask the user to confirm before proceeding

package/src/config/bundled-skills/google-calendar/TOOLS.json

@@ -1,226 +0,0 @@
-{
-  "version": 1,
-  "tools": [
-    {
-      "name": "calendar_list_events",
-      "description": "List upcoming calendar events within a date range. Returns event summaries, times, and metadata.",
-      "category": "calendar",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "calendar_id": {
-            "type": "string",
-            "description": "Calendar ID to query (default \"primary\")"
-          },
-          "time_min": {
-            "type": "string",
-            "description": "Start of time range in ISO 8601 format (e.g. \"2024-01-15T00:00:00Z\"). Defaults to now."
-          },
-          "time_max": {
-            "type": "string",
-            "description": "End of time range in ISO 8601 format (e.g. \"2024-01-22T00:00:00Z\"). Defaults to 7 days from now."
-          },
-          "max_results": {
-            "type": "number",
-            "description": "Maximum number of events to return (default 25, max 250)"
-          },
-          "query": {
-            "type": "string",
-            "description": "Free text search terms to filter events"
-          },
-          "single_events": {
-            "type": "boolean",
-            "description": "Whether to expand recurring events into individual instances (default true)"
-          },
-          "order_by": {
-            "type": "string",
-            "enum": ["startTime", "updated"],
-            "description": "Sort order (default \"startTime\"). Only valid when single_events is true."
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
-          "account": {
-            "type": "string",
-            "description": "Email address of the Google account to use. Required when multiple Google accounts are connected. If omitted, uses the most recently connected account."
-          }
-        }
-      },
-      "executor": "tools/calendar-list-events.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "calendar_get_event",
-      "description": "Get the full details of a single calendar event by its ID.",
-      "category": "calendar",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "event_id": {
-            "type": "string",
-            "description": "The calendar event ID"
-          },
-          "calendar_id": {
-            "type": "string",
-            "description": "Calendar ID (default \"primary\")"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
-          "account": {
-            "type": "string",
-            "description": "Email address of the Google account to use. Required when multiple Google accounts are connected. If omitted, uses the most recently connected account."
-          }
-        },
-        "required": ["event_id"]
-      },
-      "executor": "tools/calendar-get-event.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "calendar_create_event",
-      "description": "Create a new calendar event. Include a confidence score (0-1) indicating how certain you are this action is correct.",
-      "category": "calendar",
-      "risk": "medium",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "summary": {
-            "type": "string",
-            "description": "Event title"
-          },
-          "start": {
-            "type": "string",
-            "description": "Start time in ISO 8601 format (e.g. \"2024-01-15T09:00:00-05:00\") or date for all-day events (\"2024-01-15\")"
-          },
-          "end": {
-            "type": "string",
-            "description": "End time in ISO 8601 format or date for all-day events"
-          },
-          "description": {
-            "type": "string",
-            "description": "Event description or notes"
-          },
-          "location": {
-            "type": "string",
-            "description": "Event location"
-          },
-          "attendees": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Email addresses of attendees to invite"
-          },
-          "timezone": {
-            "type": "string",
-            "description": "IANA timezone (e.g. \"America/New_York\"). Required when start/end don't include timezone offset."
-          },
-          "calendar_id": {
-            "type": "string",
-            "description": "Calendar ID (default \"primary\")"
-          },
-          "confidence": {
-            "type": "number",
-            "description": "Confidence score (0-1) for this action"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
-          "account": {
-            "type": "string",
-            "description": "Email address of the Google account to use. Required when multiple Google accounts are connected. If omitted, uses the most recently connected account."
-          }
-        },
-        "required": ["summary", "start", "end", "confidence"]
-      },
-      "executor": "tools/calendar-create-event.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "calendar_check_availability",
-      "description": "Check free/busy status across one or more calendars to find available time slots.",
-      "category": "calendar",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "time_min": {
-            "type": "string",
-            "description": "Start of time range in ISO 8601 format"
-          },
-          "time_max": {
-            "type": "string",
-            "description": "End of time range in ISO 8601 format"
-          },
-          "calendar_ids": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Calendar IDs to check (default [\"primary\"])"
-          },
-          "timezone": {
-            "type": "string",
-            "description": "IANA timezone for interpreting results (e.g. \"America/New_York\")"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
-          "account": {
-            "type": "string",
-            "description": "Email address of the Google account to use. Required when multiple Google accounts are connected. If omitted, uses the most recently connected account."
-          }
-        },
-        "required": ["time_min", "time_max"]
-      },
-      "executor": "tools/calendar-check-availability.ts",
-      "execution_target": "host"
-    },
-    {
-      "name": "calendar_rsvp",
-      "description": "Respond to a calendar event invitation (accept, decline, or tentative). Include a confidence score (0-1).",
-      "category": "calendar",
-      "risk": "medium",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "event_id": {
-            "type": "string",
-            "description": "The calendar event ID"
-          },
-          "response": {
-            "type": "string",
-            "enum": ["accepted", "declined", "tentative"],
-            "description": "RSVP response"
-          },
-          "calendar_id": {
-            "type": "string",
-            "description": "Calendar ID (default \"primary\")"
-          },
-          "confidence": {
-            "type": "number",
-            "description": "Confidence score (0-1) for this action"
-          },
-          "activity": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          },
-          "account": {
-            "type": "string",
-            "description": "Email address of the Google account to use. Required when multiple Google accounts are connected. If omitted, uses the most recently connected account."
-          }
-        },
-        "required": ["event_id", "response", "confidence"]
-      },
-      "executor": "tools/calendar-rsvp.ts",
-      "execution_target": "host"
-    }
-  ]
-}

package/src/config/bundled-skills/google-calendar/calendar-client.ts

@@ -1,223 +0,0 @@
-import type { OAuthConnection } from "../../../oauth/connection.js";
-
-const GOOGLE_CALENDAR_BASE_URL = "https://www.googleapis.com/calendar/v3";
-import type {
-  CalendarEvent,
-  CalendarEventsListResponse,
-  CalendarListResponse,
-  FreeBusyRequest,
-  FreeBusyResponse,
-} from "./types.js";
-
-export class CalendarApiError extends Error {
-  constructor(
-    public readonly status: number,
-    public readonly statusText: string,
-    message: string,
-  ) {
-    super(message);
-    this.name = "CalendarApiError";
-  }
-}
-
-async function request<T>(
-  connection: OAuthConnection,
-  path: string,
-  options?: RequestInit,
-  query?: Record<string, string | string[]>,
-): Promise<T> {
-  const method = (options?.method ?? "GET").toUpperCase();
-
-  // Extract non-auth headers
-  let extraHeaders: Record<string, string> | undefined;
-  if (options?.headers) {
-    const raw = options.headers;
-    const result: Record<string, string> = {};
-    if (raw instanceof Headers) {
-      raw.forEach((v, k) => {
-        if (k.toLowerCase() !== "authorization") result[k] = v;
-      });
-    } else if (Array.isArray(raw)) {
-      for (const [k, v] of raw) {
-        if (k.toLowerCase() !== "authorization") result[k] = v;
-      }
-    } else {
-      for (const [k, v] of Object.entries(raw)) {
-        if (k.toLowerCase() !== "authorization" && v !== undefined)
-          result[k] = v;
-      }
-    }
-    if (Object.keys(result).length > 0) extraHeaders = result;
-  }
-
-  // Extract body
-  let reqBody: unknown | undefined;
-  if (options?.body) {
-    if (typeof options.body === "string") {
-      try {
-        reqBody = JSON.parse(options.body);
-      } catch {
-        reqBody = options.body;
-      }
-    } else {
-      reqBody = options.body;
-    }
-  }
-
-  const resp = await connection.request({
-    method,
-    path,
-    query,
-    baseUrl: GOOGLE_CALENDAR_BASE_URL,
-    headers: {
-      "Content-Type": "application/json",
-      ...extraHeaders,
-    },
-    body: reqBody,
-  });
-
-  if (resp.status < 200 || resp.status >= 300) {
-    const bodyStr =
-      typeof resp.body === "string"
-        ? resp.body
-        : JSON.stringify(resp.body ?? "");
-    throw new CalendarApiError(
-      resp.status,
-      "",
-      `Calendar API ${resp.status}: ${bodyStr}`,
-    );
-  }
-
-  if (resp.status === 204 || resp.body === undefined) {
-    return undefined as T;
-  }
-  return resp.body as T;
-}
-
-/** List events from a calendar. */
-export async function listEvents(
-  connection: OAuthConnection,
-  calendarId = "primary",
-  options?: {
-    timeMin?: string;
-    timeMax?: string;
-    maxResults?: number;
-    query?: string;
-    singleEvents?: boolean;
-    orderBy?: "startTime" | "updated";
-    pageToken?: string;
-    syncToken?: string;
-  },
-): Promise<CalendarEventsListResponse> {
-  const query: Record<string, string> = {};
-
-  if (options?.timeMin) query.timeMin = options.timeMin;
-  if (options?.timeMax) query.timeMax = options.timeMax;
-  query.maxResults = String(options?.maxResults ?? 25);
-  if (options?.query) query.q = options.query;
-
-  // Default to expanding recurring events into instances
-  const singleEvents = options?.singleEvents ?? true;
-  query.singleEvents = String(singleEvents);
-
-  if (singleEvents && options?.orderBy) {
-    query.orderBy = options.orderBy;
-  } else if (singleEvents) {
-    query.orderBy = "startTime";
-  }
-
-  if (options?.pageToken) query.pageToken = options.pageToken;
-  if (options?.syncToken) query.syncToken = options.syncToken;
-
-  return request<CalendarEventsListResponse>(
-    connection,
-    `/calendars/${encodeURIComponent(calendarId)}/events`,
-    undefined,
-    query,
-  );
-}
-
-/** Get a single event by ID. */
-export async function getEvent(
-  connection: OAuthConnection,
-  eventId: string,
-  calendarId = "primary",
-): Promise<CalendarEvent> {
-  return request<CalendarEvent>(
-    connection,
-    `/calendars/${encodeURIComponent(calendarId)}/events/${encodeURIComponent(
-      eventId,
-    )}`,
-  );
-}
-
-/** Create a new event. */
-export async function createEvent(
-  connection: OAuthConnection,
-  event: {
-    summary: string;
-    start: { dateTime?: string; date?: string; timeZone?: string };
-    end: { dateTime?: string; date?: string; timeZone?: string };
-    description?: string;
-    location?: string;
-    attendees?: Array<{ email: string }>;
-  },
-  calendarId = "primary",
-  sendUpdates: "all" | "externalOnly" | "none" = "all",
-): Promise<CalendarEvent> {
-  return request<CalendarEvent>(
-    connection,
-    `/calendars/${encodeURIComponent(calendarId)}/events`,
-    {
-      method: "POST",
-      body: JSON.stringify(event),
-    },
-    { sendUpdates },
-  );
-}
-
-/** Update an event (patch). */
-export async function patchEvent(
-  connection: OAuthConnection,
-  eventId: string,
-  updates: Partial<{
-    summary: string;
-    description: string;
-    location: string;
-    start: { dateTime?: string; date?: string; timeZone?: string };
-    end: { dateTime?: string; date?: string; timeZone?: string };
-    attendees: Array<{ email: string; responseStatus?: string }>;
-  }>,
-  calendarId = "primary",
-  sendUpdates: "all" | "externalOnly" | "none" = "all",
-): Promise<CalendarEvent> {
-  return request<CalendarEvent>(
-    connection,
-    `/calendars/${encodeURIComponent(calendarId)}/events/${encodeURIComponent(
-      eventId,
-    )}`,
-    {
-      method: "PATCH",
-      body: JSON.stringify(updates),
-    },
-    { sendUpdates },
-  );
-}
-
-/** Query free/busy information. */
-export async function freeBusy(
-  connection: OAuthConnection,
-  query: FreeBusyRequest,
-): Promise<FreeBusyResponse> {
-  return request<FreeBusyResponse>(connection, "/freeBusy", {
-    method: "POST",
-    body: JSON.stringify(query),
-  });
-}
-
-/** List calendars the user has access to. */
-export async function listCalendars(
-  connection: OAuthConnection,
-): Promise<CalendarListResponse> {
-  return request<CalendarListResponse>(connection, "/users/me/calendarList");
-}

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

@@ -1,27 +0,0 @@
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import * as calendar from "../calendar-client.js";
-import { getCalendarConnection, ok } from "./shared.js";
-
-export async function run(
-  input: Record<string, unknown>,
-  _context: ToolContext,
-): Promise<ToolExecutionResult> {
-  const account = input.account as string | undefined;
-  const timeMin = input.time_min as string;
-  const timeMax = input.time_max as string;
-  const calendarIds = (input.calendar_ids as string[]) ?? ["primary"];
-  const timezone = input.timezone as string | undefined;
-
-  const connection = await getCalendarConnection(account);
-  const result = await calendar.freeBusy(connection, {
-    timeMin,
-    timeMax,
-    timeZone: timezone,
-    items: calendarIds.map((id) => ({ id })),
-  });
-
-  return ok(JSON.stringify(result, null, 2));
-}

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

@@ -1,48 +0,0 @@
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import * as calendar from "../calendar-client.js";
-import { getCalendarConnection, ok } from "./shared.js";
-
-export async function run(
-  input: Record<string, unknown>,
-  _context: ToolContext,
-): Promise<ToolExecutionResult> {
-  const account = input.account as string | undefined;
-  const summary = input.summary as string;
-  const startRaw = input.start as string;
-  const endRaw = input.end as string;
-  const description = input.description as string | undefined;
-  const location = input.location as string | undefined;
-  const attendees = input.attendees as string[] | undefined;
-  const timezone = input.timezone as string | undefined;
-  const calendarId = (input.calendar_id as string) ?? "primary";
-
-  // Determine if these are all-day events (date-only) or timed events
-  const isAllDay = !startRaw.includes("T");
-
-  const start = isAllDay
-    ? { date: startRaw }
-    : { dateTime: startRaw, timeZone: timezone };
-  const end = isAllDay
-    ? { date: endRaw }
-    : { dateTime: endRaw, timeZone: timezone };
-
-  const eventBody: Parameters<typeof calendar.createEvent>[1] = {
-    summary,
-    start,
-    end,
-  };
-
-  if (description) eventBody.description = description;
-  if (location) eventBody.location = location;
-  if (attendees?.length) {
-    eventBody.attendees = attendees.map((email) => ({ email }));
-  }
-
-  const connection = await getCalendarConnection(account);
-  const event = await calendar.createEvent(connection, eventBody, calendarId);
-  const link = event.htmlLink ? ` View it here: ${event.htmlLink}` : "";
-  return ok(`Event created (ID: ${event.id}).${link}`);
-}

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

@@ -1,19 +0,0 @@
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import * as calendar from "../calendar-client.js";
-import { getCalendarConnection, ok } from "./shared.js";
-
-export async function run(
-  input: Record<string, unknown>,
-  _context: ToolContext,
-): Promise<ToolExecutionResult> {
-  const account = input.account as string | undefined;
-  const eventId = input.event_id as string;
-  const calendarId = (input.calendar_id as string) ?? "primary";
-
-  const connection = await getCalendarConnection(account);
-  const event = await calendar.getEvent(connection, eventId, calendarId);
-  return ok(JSON.stringify(event, null, 2));
-}

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

@@ -1,36 +0,0 @@
-import type {
-  ToolContext,
-  ToolExecutionResult,
-} from "../../../../tools/types.js";
-import * as calendar from "../calendar-client.js";
-import { getCalendarConnection, ok } from "./shared.js";
-
-export async function run(
-  input: Record<string, unknown>,
-  _context: ToolContext,
-): Promise<ToolExecutionResult> {
-  const account = input.account as string | undefined;
-  const calendarId = (input.calendar_id as string) ?? "primary";
-  const timeMin = (input.time_min as string) ?? new Date().toISOString();
-  const timeMax = input.time_max as string | undefined;
-  const maxResults = Math.min((input.max_results as number) ?? 25, 250);
-  const query = input.query as string | undefined;
-  const singleEvents = (input.single_events as boolean) ?? true;
-  const orderBy = input.order_by as "startTime" | "updated" | undefined;
-
-  const connection = await getCalendarConnection(account);
-  const result = await calendar.listEvents(connection, calendarId, {
-    timeMin,
-    timeMax,
-    maxResults,
-    query,
-    singleEvents,
-    orderBy,
-  });
-
-  if (!result.items?.length) {
-    return ok("No events found in the specified time range.");
-  }
-
-  return ok(JSON.stringify(result, null, 2));
-}