@vellumai/assistant 0.4.37 → 0.4.41

package/src/cli/amazon.ts

@@ -1,12 +1,10 @@
 /**
- * CLI command group: `vellum amazon`
+ * CLI command group: `assistant amazon`
  *
  * Shop on Amazon and Amazon Fresh via the command line.
  * All commands output JSON to stdout. Use --json for machine-readable output.
  */
 
-import * as net from "node:net";
-
 import { Command } from "commander";
 
 import {
@@ -16,22 +14,19 @@ import {
   getPaymentMethods,
   getProductDetails,
   placeOrder,
+  refreshSessionFromExtension,
   removeFromCart,
   search,
   selectFreshDeliverySlot,
   SessionExpiredError,
   viewCart,
 } from "../amazon/client.js";
-import { extractRequests, saveRequests } from "../amazon/request-extractor.js";
 import {
   clearSession,
   importFromRecording,
   loadSession,
   saveSession,
 } from "../amazon/session.js";
-import { createMessageParser, serialize } from "../daemon/ipc-protocol.js";
-import { loadRecording } from "../tools/browser/recording-store.js";
-import { getSocketPath, readSessionToken } from "../util/platform.js";
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -115,11 +110,11 @@ WARNING: "order place" is IRREVERSIBLE — it charges the user's payment method
 places a real Amazon order. Always confirm with the user before running it.
 
 Examples:
-  $ vellum amazon status
-  $ vellum amazon refresh
-  $ vellum amazon search "AA batteries" --limit 5
-  $ vellum amazon cart add --asin B07XXXXX --quantity 2
-  $ vellum amazon order place --payment-method-id pm_abc123`,
+  $ assistant amazon status
+  $ assistant amazon refresh
+  $ assistant amazon search "AA batteries" --limit 5
+  $ assistant amazon cart add --asin B07XXXXX --quantity 2
+  $ assistant amazon order place --payment-method-id pm_abc123`,
   );
 
   // =========================================================================
@@ -138,8 +133,8 @@ session. Typically used to restore a session from a saved recording rather than
 re-authenticating via "refresh".
 
 Examples:
-  $ vellum amazon login --recording /path/to/recording.json
-  $ vellum amazon login --recording ~/recordings/amazon-2024-01-15.json`,
+  $ assistant amazon login --recording /path/to/recording.json
+  $ assistant amazon login --recording ~/recordings/amazon-2024-01-15.json`,
     )
     .action(async (opts: { recording: string }, cmd: Command) => {
       await run(cmd, async () => {
@@ -166,7 +161,7 @@ all shopping commands will fail until a new session is established via
 "refresh", "refresh-headless", or "login".
 
 Examples:
-  $ vellum amazon logout`,
+  $ assistant amazon logout`,
     )
     .action((_opts: unknown, cmd: Command) => {
       clearSession();
@@ -174,94 +169,41 @@ Examples:
     });
 
   // =========================================================================
-  // refresh — start Ride Shotgun learn to capture fresh cookies
+  // refresh — grab Amazon cookies from Chrome via browser extension
   // =========================================================================
   amz
     .command("refresh")
     .description(
-      "Start a Ride Shotgun learn session to capture fresh Amazon cookies. " +
-        "Opens amazon.com in a separate Chrome window — sign in when prompted. " +
-        "Your existing Chrome and tabs are not affected.",
+      "Refresh Amazon session by grabbing cookies from Chrome via the browser extension. " +
+        "Requires the Vellum Chrome extension to be loaded and connected.",
     )
-    .option("--duration <seconds>", "Recording duration in seconds", "180")
     .addHelpText(
       "after",
       `
-Opens amazon.com in a separate Chrome window via Ride Shotgun and starts a
-learn session to capture session cookies. The user must sign into Amazon when
-prompted. The existing Chrome profile and open tabs are not affected — a
-separate Chrome instance is launched.
-
-The recording runs for --duration seconds (default: 180). After completion,
-captured cookies are automatically imported as the active session. Request
-templates are also extracted for self-healing capabilities.
+Grabs Amazon session cookies directly from Chrome via the browser extension
+relay. Much faster than the old Ride Shotgun approach — no separate Chrome
+instance is launched. Requires the Vellum Chrome extension to be loaded
+and connected.
 
-After cookie capture, the Chrome window is minimized automatically.
+If this fails, try "refresh-headless" which reads cookies from Chrome's
+local SQLite database instead.
 
 Examples:
-  $ vellum amazon refresh
-  $ vellum amazon refresh --duration 120`,
+  $ assistant amazon refresh
+  $ assistant amazon refresh --json`,
     )
-    .action(async (opts: { duration: string }, cmd: Command) => {
+    .action(async (_opts: unknown, cmd: Command) => {
       const json = getJson(cmd);
-      const duration = parseInt(opts.duration, 10);
-
       try {
-        // Restore minimized Chrome window so user can see the login page
-        try {
-          await restoreChromeWindow();
-        } catch {
-          /* best-effort */
-        }
-
-        const result = await startLearnSession(duration);
-        if (result.recordingPath) {
-          const session = importFromRecording(result.recordingPath);
-
-          // Also extract and save captured request templates for self-healing
-          let requestsCaptured = 0;
-          try {
-            const recording = loadRecording(result.recordingId ?? "");
-            if (recording) {
-              const requests = extractRequests(recording);
-              if (requests.length > 0) {
-                saveRequests(requests);
-                requestsCaptured = requests.length;
-              }
-            }
-          } catch {
-            // Non-fatal: request extraction is best-effort
-          }
-
-          // Best-effort: minimize Chrome window after capturing session
-          try {
-            await minimizeChromeWindow();
-            process.stderr.write("[amazon] Chrome window minimized\n");
-          } catch {
-            // Non-fatal: minimizing is best-effort
-          }
-
-          output(
-            {
-              ok: true,
-              message: "Session refreshed successfully",
-              cookieCount: session.cookies.length,
-              recordingId: result.recordingId,
-              requestsCaptured,
-            },
-            json,
-          );
-        } else {
-          output(
-            {
-              ok: false,
-              error: "Recording completed but no recording path returned",
-              recordingId: result.recordingId,
-            },
-            json,
-          );
-          process.exitCode = 1;
-        }
+        const session = await refreshSessionFromExtension();
+        output(
+          {
+            ok: true,
+            message: "Session refreshed from Chrome via browser extension",
+            cookieCount: session.cookies.length,
+          },
+          json,
+        );
       } catch (err) {
         outputError(err instanceof Error ? err.message : String(err));
       }
@@ -293,8 +235,8 @@ interfering with Chrome's WAL journaling. Required cookies (session-id,
 ubid-main, and at-main or x-main) are validated after extraction.
 
 Examples:
-  $ vellum amazon refresh-headless
-  $ vellum amazon refresh-headless --json`,
+  $ assistant amazon refresh-headless
+  $ assistant amazon refresh-headless --json`,
     )
     .action(async (_opts: unknown, cmd: Command) => {
       const json = getJson(cmd);
@@ -330,8 +272,8 @@ session exists, returns loggedIn: false.
 Use this to verify session health before running shopping commands.
 
 Examples:
-  $ vellum amazon status
-  $ vellum amazon status --json`,
+  $ assistant amazon status
+  $ assistant amazon status --json`,
     )
     .action((_opts: unknown, cmd: Command) => {
       const session = loadSession();
@@ -375,9 +317,9 @@ The --fresh flag restricts results to Amazon Fresh grocery items. The
 --limit flag controls the maximum number of results returned (default: 20).
 
 Examples:
-  $ vellum amazon search "AA batteries"
-  $ vellum amazon search "whole milk" --fresh --limit 10
-  $ vellum amazon search "USB-C cable" --limit 5 --json`,
+  $ assistant amazon search "AA batteries"
+  $ assistant amazon search "whole milk" --fresh --limit 10
+  $ assistant amazon search "USB-C cable" --limit 5 --json`,
     )
     .action(
       async (
@@ -415,9 +357,9 @@ description, images, and available variations. Use --fresh if the product
 is an Amazon Fresh grocery item.
 
 Examples:
-  $ vellum amazon product B07XXXXX
-  $ vellum amazon product B08YYYYY --fresh
-  $ vellum amazon product B07XXXXX --json`,
+  $ assistant amazon product B07XXXXX
+  $ assistant amazon product B08YYYYY --fresh
+  $ assistant amazon product B07XXXXX --json`,
     )
     .action(async (asin: string, opts: { fresh?: boolean }, cmd: Command) => {
       await run(cmd, async () => {
@@ -447,8 +389,8 @@ Each variation includes dimension labels (e.g. "Size: Large", "Color: Blue")
 and its own ASIN for use with "product" or "cart add".
 
 Examples:
-  $ vellum amazon variations B07XXXXX
-  $ vellum amazon variations B07XXXXX --json`,
+  $ assistant amazon variations B07XXXXX
+  $ assistant amazon variations B07XXXXX --json`,
     )
     .action(async (asin: string, _opts: unknown, cmd: Command) => {
       await run(cmd, async () => {
@@ -477,9 +419,9 @@ The cart is shared between regular Amazon and Amazon Fresh items. Use
 --fresh when adding grocery items to route them through the Fresh workflow.
 
 Examples:
-  $ vellum amazon cart view
-  $ vellum amazon cart add --asin B07XXXXX --quantity 2
-  $ vellum amazon cart remove --cart-item-id CXYZ123`,
+  $ assistant amazon cart view
+  $ assistant amazon cart add --asin B07XXXXX --quantity 2
+  $ assistant amazon cart remove --cart-item-id CXYZ123`,
   );
 
   // cart view
@@ -494,8 +436,8 @@ price, and cart-item-id. Use the cart-item-id with "cart remove" to delete
 individual items.
 
 Examples:
-  $ vellum amazon cart view
-  $ vellum amazon cart view --json`,
+  $ assistant amazon cart view
+  $ assistant amazon cart view --json`,
     )
     .action(async (_opts: unknown, cmd: Command) => {
       await run(cmd, async () => {
@@ -526,9 +468,9 @@ Options:
                      failures. Includes raw Amazon API response data.
 
 Examples:
-  $ vellum amazon cart add --asin B07XXXXX
-  $ vellum amazon cart add --asin B08YYYYY --quantity 3 --fresh
-  $ vellum amazon cart add --asin B07XXXXX --verbose`,
+  $ assistant amazon cart add --asin B07XXXXX
+  $ assistant amazon cart add --asin B08YYYYY --quantity 3 --fresh
+  $ assistant amazon cart add --asin B07XXXXX --verbose`,
     )
     .action(
       async (
@@ -601,8 +543,8 @@ Options:
                         line-item ID.
 
 Examples:
-  $ vellum amazon cart remove --cart-item-id CXYZ123
-  $ vellum amazon cart remove --cart-item-id CXYZ123 --json`,
+  $ assistant amazon cart remove --cart-item-id CXYZ123
+  $ assistant amazon cart remove --cart-item-id CXYZ123 --json`,
     )
     .action(async (opts: { cartItemId: string }, cmd: Command) => {
       await run(cmd, async () => {
@@ -626,11 +568,11 @@ delivery slot must be selected. Use "delivery-slots" to list available time
 windows, then "select-slot" to reserve one.
 
 Fresh items must also be added to cart with the --fresh flag:
-  $ vellum amazon cart add --asin B08YYYYY --fresh
+  $ assistant amazon cart add --asin B08YYYYY --fresh
 
 Examples:
-  $ vellum amazon fresh delivery-slots
-  $ vellum amazon fresh select-slot --slot-id slot_abc123`,
+  $ assistant amazon fresh delivery-slots
+  $ assistant amazon fresh select-slot --slot-id slot_abc123`,
   );
 
   // fresh delivery-slots
@@ -648,8 +590,8 @@ Slot availability changes frequently. Re-check before placing an order if
 significant time has passed since the last query.
 
 Examples:
-  $ vellum amazon fresh delivery-slots
-  $ vellum amazon fresh delivery-slots --json`,
+  $ assistant amazon fresh delivery-slots
+  $ assistant amazon fresh delivery-slots --json`,
     )
     .action(async (_opts: unknown, cmd: Command) => {
       await run(cmd, async () => {
@@ -674,8 +616,8 @@ must be obtained from "fresh delivery-slots". A slot must be selected before
 placing an Amazon Fresh order via "order place".
 
 Examples:
-  $ vellum amazon fresh select-slot --slot-id slot_abc123
-  $ vellum amazon fresh select-slot --slot-id slot_abc123 --json`,
+  $ assistant amazon fresh select-slot --slot-id slot_abc123
+  $ assistant amazon fresh select-slot --slot-id slot_abc123 --json`,
     )
     .action(async (opts: { slotId: string }, cmd: Command) => {
       await run(cmd, async () => {
@@ -702,8 +644,8 @@ If no --payment-method-id is passed to "order place", Amazon uses the
 account's default payment method.
 
 Examples:
-  $ vellum amazon payment-methods
-  $ vellum amazon payment-methods --json`,
+  $ assistant amazon payment-methods
+  $ assistant amazon payment-methods --json`,
     )
     .action(async (_opts: unknown, cmd: Command) => {
       await run(cmd, async () => {
@@ -729,8 +671,8 @@ Use this to review the order before committing with "order place". This
 command is read-only and does not charge or modify the cart.
 
 Examples:
-  $ vellum amazon checkout
-  $ vellum amazon checkout --json`,
+  $ assistant amazon checkout
+  $ assistant amazon checkout --json`,
     )
     .action(async (_opts: unknown, cmd: Command) => {
       await run(cmd, async () => {
@@ -754,8 +696,8 @@ method and submits a real Amazon order that cannot be undone via this CLI.
 Always confirm with the user and review checkout summary first.
 
 Examples:
-  $ vellum amazon checkout
-  $ vellum amazon order place`,
+  $ assistant amazon checkout
+  $ assistant amazon order place`,
   );
 
   // order place
@@ -781,18 +723,18 @@ Options:
                              account's default payment method.
 
 For Amazon Fresh orders, select a delivery slot before placing the order:
-  $ vellum amazon fresh select-slot --slot-id slot_abc123
+  $ assistant amazon fresh select-slot --slot-id slot_abc123
 
 Recommended workflow before placing an order:
-  1. vellum amazon cart view          (verify cart contents)
-  2. vellum amazon checkout           (review totals and shipping)
+  1. assistant amazon cart view          (verify cart contents)
+  2. assistant amazon checkout           (review totals and shipping)
   3. Confirm with the user
-  4. vellum amazon order place
+  4. assistant amazon order place
 
 Examples:
-  $ vellum amazon order place
-  $ vellum amazon order place --payment-method-id pm_abc123
-  $ vellum amazon order place --json`,
+  $ assistant amazon order place
+  $ assistant amazon order place --payment-method-id pm_abc123
+  $ assistant amazon order place --json`,
     )
     .action(async (opts: { paymentMethodId?: string }, cmd: Command) => {
       await run(cmd, async () => {
@@ -805,7 +747,7 @@ Examples:
 }
 
 // ---------------------------------------------------------------------------
-// Chrome CDP helpers (delegated to shared module)
+// Headless cookie extraction from Chrome's SQLite database
 // ---------------------------------------------------------------------------
 
 import { execSync } from "node:child_process";
@@ -818,16 +760,6 @@ import {
 import { homedir, tmpdir } from "node:os";
 import { join as pathJoin } from "node:path";
 
-import {
-  ensureChromeWithCdp,
-  minimizeChromeWindow,
-  restoreChromeWindow,
-} from "../tools/browser/chrome-cdp.js";
-
-// ---------------------------------------------------------------------------
-// Headless cookie extraction from Chrome's SQLite database
-// ---------------------------------------------------------------------------
-
 const CHROME_COOKIES_DB = pathJoin(
   homedir(),
   "Library/Application Support/Google/Chrome/Default/Cookies",
@@ -991,110 +923,3 @@ async function extractSessionFromChromeCookies(): Promise<
     importedAt: new Date().toISOString(),
   };
 }
-
-// ---------------------------------------------------------------------------
-// Ride Shotgun learn session helper
-// ---------------------------------------------------------------------------
-
-interface LearnResult {
-  recordingId?: string;
-  recordingPath?: string;
-}
-
-async function startLearnSession(
-  durationSeconds: number,
-): Promise<LearnResult> {
-  await ensureChromeWithCdp({ startUrl: "https://www.amazon.com/" });
-
-  return new Promise((resolve, reject) => {
-    const socketPath = getSocketPath();
-    const sessionToken = readSessionToken();
-    const socket = net.createConnection(socketPath);
-    const parser = createMessageParser();
-
-    socket.on("error", (err) => {
-      reject(
-        new Error(
-          `Cannot connect to assistant: ${err.message}. Is the assistant running?`,
-        ),
-      );
-    });
-
-    const timeoutHandle = setTimeout(
-      () => {
-        socket.destroy();
-        reject(
-          new Error(`Learn session timed out after ${durationSeconds + 30}s`),
-        );
-      },
-      (durationSeconds + 30) * 1000,
-    );
-    timeoutHandle.unref();
-
-    let authenticated = !sessionToken;
-
-    const sendStartCommand = () => {
-      socket.write(
-        serialize({
-          type: "ride_shotgun_start",
-          durationSeconds,
-          intervalSeconds: 5,
-          mode: "learn",
-          targetDomain: "amazon.com",
-        } as unknown as import("../daemon/ipc-protocol.js").ClientMessage),
-      );
-    };
-
-    socket.on("data", (chunk) => {
-      const messages = parser.feed(chunk.toString("utf-8"));
-      for (const msg of messages) {
-        const m = msg as unknown as Record<string, unknown>;
-
-        if (!authenticated && m.type === "auth_result") {
-          if ((m as { success: boolean }).success) {
-            authenticated = true;
-            sendStartCommand();
-          } else {
-            clearTimeout(timeoutHandle);
-            socket.destroy();
-            reject(new Error("Authentication failed"));
-          }
-          continue;
-        }
-
-        if (m.type === "auth_result") {
-          continue;
-        }
-
-        if (m.type === "ride_shotgun_error") {
-          clearTimeout(timeoutHandle);
-          socket.destroy();
-          reject(new Error((m as { message: string }).message));
-          continue;
-        }
-
-        if (m.type === "ride_shotgun_result") {
-          clearTimeout(timeoutHandle);
-          socket.destroy();
-          resolve({
-            recordingId: m.recordingId as string | undefined,
-            recordingPath: m.recordingPath as string | undefined,
-          });
-        }
-      }
-    });
-
-    socket.on("connect", () => {
-      if (sessionToken) {
-        socket.write(
-          serialize({
-            type: "auth",
-            token: sessionToken,
-          } as unknown as import("../daemon/ipc-protocol.js").ClientMessage),
-        );
-      } else {
-        sendStartCommand();
-      }
-    });
-  });
-}

package/src/cli/audit.ts

@@ -26,8 +26,8 @@ Table columns:
   Duration    Wall-clock execution time (e.g. 120ms, 1.3s)
 
 Examples:
-  $ vellum audit
-  $ vellum audit --limit 50`,
+  $ assistant audit
+  $ assistant audit --limit 50`,
     )
     .action((opts: { limit: string }) => {
       const limit = parseInt(opts.limit, 10) || 20;

package/src/cli/autonomy.ts

@@ -203,9 +203,9 @@ Config is stored in <data-dir>/.vellum/workspace/autonomy.json, where
 <data-dir> is the BASE_DATA_DIR environment variable (defaults to $HOME).
 
 Examples:
-  $ vellum autonomy get
-  $ vellum autonomy set --default draft
-  $ vellum autonomy set --channel telegram --tier auto`,
+  $ assistant autonomy get
+  $ assistant autonomy set --default draft
+  $ assistant autonomy set --channel telegram --tier auto`,
   );
 
   autonomy
@@ -222,8 +222,8 @@ Pass --json (on the parent command) for machine-readable output containing
 the complete config object.
 
 Examples:
-  $ vellum autonomy get
-  $ vellum autonomy --json get`,
+  $ assistant autonomy get
+  $ assistant autonomy --json get`,
     )
     .action((_opts: Record<string, unknown>, cmd: Command) => {
       const json = getJson(cmd);
@@ -264,10 +264,10 @@ For example, setting a channel default leaves all other channel defaults,
 category overrides, and contact overrides intact.
 
 Examples:
-  $ vellum autonomy set --default draft
-  $ vellum autonomy set --channel telegram --tier auto
-  $ vellum autonomy set --category billing --tier notify
-  $ vellum autonomy set --contact c_8f3a1b2d --tier draft`,
+  $ assistant autonomy set --default draft
+  $ assistant autonomy set --channel telegram --tier auto
+  $ assistant autonomy set --category billing --tier notify
+  $ assistant autonomy set --contact c_8f3a1b2d --tier draft`,
     )
     .action(
       (

package/src/cli/channels.ts

@@ -18,9 +18,9 @@ that the assistant uses to send and receive messages.
 The assistant must be running — channel status is read from the live gateway.
 
 Examples:
-  $ vellum channels readiness
-  $ vellum channels readiness --channel telegram
-  $ vellum channels readiness --json`,
+  $ assistant channels readiness
+  $ assistant channels readiness --channel telegram
+  $ assistant channels readiness --json`,
   );
 
   channels
@@ -39,8 +39,8 @@ configured channels are returned. Common channel types include: telegram,
 voice, sms, email, slack, vellum.
 
 Examples:
-  $ vellum channels readiness
-  $ vellum channels readiness --channel telegram`,
+  $ assistant channels readiness
+  $ assistant channels readiness --channel telegram`,
     )
     .action(async (opts: { channel?: string }, cmd: Command) => {
       const query = toQueryString({ channel: opts.channel });