@vellumai/assistant 0.4.48 → 0.4.50

package/src/cli/commands/map.ts

@@ -1,391 +0,0 @@
-/**
- * CLI command: `assistant map <domain>`
- *
- * Launches Chrome with CDP, starts a Ride Shotgun learn session to auto-navigate
- * the given domain, then analyzes captured network traffic into a deduplicated API map.
- */
-
-import { Command } from "commander";
-import { parse as parseTld } from "tldts";
-
-import {
-  analyzeApiMap,
-  printApiMapTable,
-  saveApiMap,
-} from "../../tools/browser/api-map.js";
-import { ensureChromeWithCdp } from "../../tools/browser/chrome-cdp.js";
-import { loadRecording } from "../../tools/browser/recording-store.js";
-import { httpSend } from "../http-client.js";
-import { getCliLogger } from "../logger.js";
-
-const log = getCliLogger("cli:map");
-
-/**
- * Extract the registrable base domain from a hostname.
- * e.g. "open.spotify.com" → "spotify.com", "connect.garmin.com" → "garmin.com"
- * Falls back to the input if tldts can't parse it.
- */
-function getBaseDomain(domain: string): string {
-  const result = parseTld(domain);
-  return result.domain ?? domain;
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-function output(data: unknown, json: boolean): void {
-  process.stdout.write(
-    json ? JSON.stringify(data) + "\n" : JSON.stringify(data, null, 2) + "\n",
-  );
-}
-
-function outputError(message: string, code = 1): void {
-  output({ ok: false, error: message }, true);
-  process.exitCode = code;
-}
-
-function getJson(cmd: Command): boolean {
-  let c: Command | null = cmd;
-  while (c) {
-    if ((c.opts() as { json?: boolean }).json) return true;
-    c = c.parent;
-  }
-  return false;
-}
-
-/**
- * Bring the Chrome CDP tab to the foreground so the user sees the right window.
- * Optionally navigates to a URL first (used when Chrome was already running).
- */
-async function bringChromeToFront(
-  cdpBase: string,
-  navigateUrl?: string,
-): Promise<string | null> {
-  try {
-    const res = await fetch(`${cdpBase}/json/list`);
-    if (!res.ok) return null;
-    const targets = (await res.json()) as Array<{
-      type: string;
-      url: string;
-      webSocketDebuggerUrl: string;
-    }>;
-    const pageTarget = targets.find((t) => t.type === "page");
-    if (!pageTarget?.webSocketDebuggerUrl) return null;
-
-    const ws = new WebSocket(pageTarget.webSocketDebuggerUrl);
-    await new Promise<void>((resolve, reject) => {
-      ws.onopen = () => resolve();
-      ws.onerror = (e) => reject(new Error(`CDP WebSocket error: ${e}`));
-    });
-
-    let nextId = 1;
-    const cdpSend = (
-      method: string,
-      params?: Record<string, unknown>,
-    ): Promise<unknown> =>
-      new Promise((resolve, reject) => {
-        const id = nextId++;
-        const cleanup = () => {
-          clearTimeout(timeout);
-          ws.removeEventListener("message", handler);
-          ws.removeEventListener("close", onClose);
-          ws.removeEventListener("error", onError);
-        };
-        const timeout = setTimeout(() => {
-          cleanup();
-          reject(new Error(`CDP command ${method} timed out`));
-        }, 5000);
-        const onClose = () => {
-          cleanup();
-          reject(new Error("WebSocket closed before CDP response"));
-        };
-        const onError = (e: Event) => {
-          cleanup();
-          reject(new Error(`WebSocket error: ${e}`));
-        };
-        const handler = (event: MessageEvent) => {
-          const msg = JSON.parse(String(event.data));
-          if (msg.id === id) {
-            cleanup();
-            if (msg.error) reject(new Error(msg.error.message));
-            else resolve(msg.result);
-          }
-        };
-        ws.addEventListener("message", handler);
-        ws.addEventListener("close", onClose);
-        ws.addEventListener("error", onError);
-        ws.send(JSON.stringify({ id, method, params }));
-      });
-
-    if (navigateUrl) {
-      await cdpSend("Page.navigate", { url: navigateUrl });
-      // Brief wait for navigation to start
-      await new Promise((r) => setTimeout(r, 500));
-    }
-
-    await cdpSend("Page.bringToFront");
-    const tabUrl = navigateUrl ?? pageTarget.url;
-    ws.close();
-    return tabUrl;
-  } catch {
-    return null;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Ride Shotgun learn session helper
-// ---------------------------------------------------------------------------
-
-interface LearnResult {
-  recordingId?: string;
-  recordingPath?: string;
-}
-
-async function startLearnSession(
-  navigateDomain: string,
-  recordDomain: string,
-  durationSeconds: number,
-  autoNavigate: boolean = true,
-): Promise<LearnResult> {
-  const cdpSession = await ensureChromeWithCdp({
-    startUrl: `https://${navigateDomain}/`,
-  });
-
-  // Activate the Chrome window so the user knows which tab to watch
-  const tabUrl = await bringChromeToFront(
-    cdpSession.baseUrl,
-    `https://${navigateDomain}/`,
-  );
-  if (tabUrl) {
-    process.stderr.write(`Chrome is ready — using tab at ${tabUrl}\n`);
-  }
-
-  // Start ride shotgun via HTTP
-  const response = await httpSend("/v1/computer-use/ride-shotgun/start", {
-    method: "POST",
-    body: JSON.stringify({
-      durationSeconds,
-      intervalSeconds: 5,
-      mode: "learn",
-      targetDomain: recordDomain,
-      navigateDomain,
-      autoNavigate,
-    }),
-  });
-
-  if (!response.ok) {
-    const body = await response.text();
-    throw new Error(
-      `Failed to start learn session: ${response.status} ${body}`,
-    );
-  }
-
-  const startResult = (await response.json()) as {
-    watchId?: string;
-    sessionId?: string;
-  };
-
-  if (!startResult.watchId) {
-    throw new Error("Ride-shotgun start response missing watchId");
-  }
-
-  // Poll the status endpoint using watchId to correlate completion
-  const { watchId } = startResult;
-  const timeoutMs = (durationSeconds + 30) * 1000;
-  const pollIntervalMs = 2000;
-  const startTime = Date.now();
-
-  return new Promise<LearnResult>((resolve, reject) => {
-    const tick = async () => {
-      if (Date.now() - startTime > timeoutMs) {
-        reject(
-          new Error(`Learn session timed out after ${durationSeconds + 30}s`),
-        );
-        return;
-      }
-
-      try {
-        const statusRes = await httpSend(
-          `/v1/computer-use/ride-shotgun/status/${watchId}`,
-          { method: "GET" },
-        );
-        if (!statusRes.ok) {
-          setTimeout(tick, pollIntervalMs);
-          return;
-        }
-
-        const status = (await statusRes.json()) as {
-          status: string;
-          recordingId?: string;
-          savedRecordingPath?: string;
-          bootstrapFailureReason?: string;
-        };
-
-        if (status.bootstrapFailureReason) {
-          reject(
-            new Error(`Learn session failed: ${status.bootstrapFailureReason}`),
-          );
-          return;
-        }
-
-        if (status.status === "completed") {
-          if (status.recordingId) {
-            resolve({
-              recordingId: status.recordingId,
-              recordingPath: status.savedRecordingPath,
-            });
-          } else {
-            reject(
-              new Error("Learn session completed but no recording was saved."),
-            );
-          }
-          return;
-        }
-      } catch {
-        // Status endpoint not reachable — continue polling
-      }
-
-      setTimeout(tick, pollIntervalMs);
-    };
-
-    setTimeout(tick, pollIntervalMs);
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Command registration
-// ---------------------------------------------------------------------------
-
-export function registerMapCommand(program: Command): void {
-  program
-    .command("map")
-    .description(
-      "Auto-navigate a domain and produce a deduplicated API map. " +
-        "Launches Chrome with CDP, starts a Ride Shotgun learn session, " +
-        "then analyzes captured network traffic.",
-    )
-    .argument("<domain>", "Domain to map (e.g., example.com)")
-    .option("--duration <seconds>", "Recording duration in seconds")
-    .option(
-      "--manual",
-      "Manual mode: browse the site yourself while network traffic is recorded",
-    )
-    .option("--json", "Machine-readable JSON output")
-    .addHelpText(
-      "after",
-      `
-Arguments:
-  domain   The domain to map (e.g. example.com, open.spotify.com). Subdomains
-           are navigated directly but network traffic is recorded for the
-           entire base domain (e.g. open.spotify.com navigates that subdomain
-           but records all *.spotify.com traffic).
-
-Two modes of operation:
-  auto (default)   The assistant auto-navigates the site using Ride Shotgun,
-                   clicking links and exploring pages autonomously. Default
-                   duration: 120 seconds.
-  --manual         You browse the site yourself while network traffic is
-                   recorded in the background. Default duration: 60 seconds.
-
-How it works:
-  1. Launches Chrome with Chrome DevTools Protocol (CDP) enabled
-  2. Starts a Ride Shotgun learn session to capture network traffic
-  3. Deduplicates captured requests into unique API endpoints
-  4. Saves the API map to disk and prints a summary table
-
-The assistant must be running (the learn session is coordinated through it).
-
-Examples:
-  $ assistant map example.com
-  $ assistant map open.spotify.com --duration 180
-  $ assistant map garmin.com --manual`,
-    )
-    .action(
-      async (
-        domain: string,
-        opts: { duration?: string; manual?: boolean; json?: boolean },
-        cmd: Command,
-      ) => {
-        const json = getJson(cmd);
-        const manual = opts.manual ?? false;
-        const duration = opts.duration
-          ? parseInt(opts.duration, 10)
-          : manual
-            ? 60
-            : 120;
-
-        try {
-          // Split into navigation domain (what Chrome browses) and recording domain (network filter).
-          // e.g. "open.spotify.com" → navigate open.spotify.com, record *.spotify.com
-          const navigateDomain = domain;
-          const recordDomain = getBaseDomain(domain);
-
-          if (!json) {
-            if (manual) {
-              log.info(
-                `Starting manual API map session for ${domain} (${duration}s)...`,
-              );
-              log.info(
-                "Browse the site manually. Press Ctrl+C or wait for idle detection to stop recording.",
-              );
-            } else if (navigateDomain !== recordDomain) {
-              log.info(
-                `Starting API map session: navigating ${navigateDomain}, recording *.${recordDomain} (${duration}s)...`,
-              );
-            } else {
-              log.info(
-                `Starting API map session for ${domain} (${duration}s)...`,
-              );
-            }
-          }
-          const result = await startLearnSession(
-            navigateDomain,
-            recordDomain,
-            duration,
-            !manual,
-          );
-
-          if (!result.recordingId) {
-            outputError("Recording completed but no recording ID returned");
-            return;
-          }
-
-          // 2. Load the recording
-          const recording = loadRecording(result.recordingId);
-          if (!recording) {
-            outputError(`Failed to load recording ${result.recordingId}`);
-            return;
-          }
-
-          // 3. Analyze the API map
-          const apiMap = analyzeApiMap(recording.networkEntries, domain);
-
-          // 4. Save the API map
-          const savedPath = saveApiMap(domain, apiMap);
-
-          // 5. Display results
-          if (!json) {
-            printApiMapTable(apiMap);
-            log.info(`API map saved to: ${savedPath}`);
-          }
-
-          // 6. Output JSON result
-          output(
-            {
-              ok: true,
-              domain,
-              recordingId: result.recordingId,
-              savedPath,
-              totalRequests: apiMap.totalRequests,
-              endpointCount: apiMap.endpoints.length,
-              apiMap,
-            },
-            json,
-          );
-        } catch (err) {
-          outputError(err instanceof Error ? err.message : String(err));
-        }
-      },
-    );
-}

package/src/cli/commands/oauth.ts

@@ -1,77 +0,0 @@
-import type { Command } from "commander";
-
-import { withValidToken } from "../../security/token-manager.js";
-import { shouldOutputJson, writeOutput } from "../output.js";
-
-export function registerOAuthCommand(program: Command): void {
-  const oauth = program
-    .command("oauth")
-    .description("Manage OAuth tokens for connected integrations")
-    .option("--json", "Machine-readable compact JSON output");
-
-  oauth.addHelpText(
-    "after",
-    `
-OAuth tokens are managed automatically — the "token" command returns a
-guaranteed-valid access token, refreshing transparently if the stored token
-is expired or near-expiry. Callers never need to handle refresh themselves.
-
-The <service> argument is the short integration name (e.g. "twitter", "gmail",
-"slack"). Internally this maps to credential/integration:<service>/access_token.
-
-Examples:
-  $ assistant oauth token twitter
-  $ assistant oauth token twitter --json
-  $ TOKEN=$(assistant oauth token gmail)
-  $ curl -H "Authorization: Bearer $(assistant oauth token twitter)" https://api.x.com/2/tweets`,
-  );
-
-  // ---------------------------------------------------------------------------
-  // token — return a guaranteed-valid access token
-  // ---------------------------------------------------------------------------
-
-  oauth
-    .command("token <service>")
-    .description(
-      "Print a valid OAuth access token for a service, refreshing if expired",
-    )
-    .addHelpText(
-      "after",
-      `
-Arguments:
-  service   Integration name without the "integration:" prefix
-            (e.g. "twitter", "gmail", "slack")
-
-Returns a valid OAuth access token for the given service. If the stored token
-is expired or near-expiry, it is refreshed automatically before being returned.
-The refresh uses the stored refresh token and OAuth2 configuration from
-credential metadata — no additional input is required.
-
-In human mode, prints the bare token to stdout (suitable for shell substitution).
-In JSON mode (--json), prints {"ok": true, "token": "..."}.
-
-Exits with code 1 if no access token exists for the service, no refresh token
-is available, or the token refresh fails (e.g. revoked credentials).
-
-Examples:
-  $ assistant oauth token twitter
-  $ assistant oauth token gmail --json
-  $ export TOKEN=$(assistant oauth token twitter)`,
-    )
-    .action(async (service: string, _opts: unknown, cmd: Command) => {
-      try {
-        const qualifiedService = `integration:${service}`;
-        const token = await withValidToken(qualifiedService, async (t) => t);
-
-        if (shouldOutputJson(cmd)) {
-          writeOutput(cmd, { ok: true, token });
-        } else {
-          process.stdout.write(token + "\n");
-        }
-      } catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        writeOutput(cmd, { ok: false, error: message });
-        process.exitCode = 1;
-      }
-    });
-}

package/src/config/bundled-skills/knowledge-graph/SKILL.md

@@ -1,25 +0,0 @@
----
-name: knowledge-graph
-description: Query the entity knowledge graph to explore relationships between people, projects, tools, and other entities tracked in memory
-compatibility: "Designed for Vellum personal assistants"
-metadata:
-  emoji: "🕸️"
-  vellum:
-    display-name: "Knowledge Graph"
----
-
-# Knowledge Graph
-
-Query the entity knowledge graph to explore relationships between people, projects, tools, and other entities tracked in memory.
-
-## When to use
-
-- When the user asks about relationships between entities ("what tools does project X use?", "who works on project Y?")
-- When the user wants to explore connected entities across the knowledge graph
-- When automatic memory recall doesn't surface the right relationship-based information
-
-## Capabilities
-
-- **Neighbors**: Find entities directly connected to seed entities (optionally filtered by relation and entity type)
-- **Typed traversal**: Multi-step traversal with type constraints at each step (e.g., "me -> works_on -> projects -> uses -> tools")
-- **Intersection**: Find entities reachable from ALL given seeds (e.g., "projects both Alice and Bob work on")

package/src/config/bundled-skills/knowledge-graph/TOOLS.json

@@ -1,66 +0,0 @@
-{
-  "version": 1,
-  "tools": [
-    {
-      "name": "knowledge_graph_query",
-      "description": "Query the entity knowledge graph to find related entities and their associated memory items. Supports three query types: 'neighbors' (direct connections), 'typed_traversal' (multi-step with type filters), and 'intersection' (entities reachable from ALL seeds).",
-      "category": "memory",
-      "risk": "low",
-      "input_schema": {
-        "type": "object",
-        "properties": {
-          "query_type": {
-            "type": "string",
-            "enum": ["neighbors", "typed_traversal", "intersection"],
-            "description": "Type of graph query to execute"
-          },
-          "seeds": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            },
-            "description": "Entity names or aliases to use as starting points"
-          },
-          "steps": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "relation_types": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Relation types to follow (e.g., 'uses', 'works_on', 'depends_on')"
-                },
-                "entity_types": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Entity types to include (e.g., 'person', 'project', 'tool')"
-                }
-              }
-            },
-            "description": "Traversal steps for typed_traversal and intersection queries. Each step defines type filters for one hop."
-          },
-          "max_results": {
-            "type": "number",
-            "description": "Maximum number of entities to return (default: 20)"
-          },
-          "include_items": {
-            "type": "boolean",
-            "description": "Include associated memory items for each found entity (default: true)"
-          },
-          "reason": {
-            "type": "string",
-            "description": "Brief non-technical explanation of why this tool is being called"
-          }
-        },
-        "required": ["query_type", "seeds"]
-      },
-      "executor": "tools/graph-query.ts",
-      "execution_target": "host"
-    }
-  ]
-}