@mendable/firecrawl-js 4.45.0 → 4.47.0

package/dist/index.js

@@ -1,21 +1,13 @@
 import {
-  require_package
-} from "./chunk-LKCOCWYW.js";
+  version
+} from "./chunk-H75FJ6LW.js";
 
 // src/v2/utils/httpClient.ts
 import axios from "axios";
 
 // src/v2/utils/getVersion.ts
 function getVersion() {
-  try {
-    if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
-      return process.env.npm_package_version;
-    }
-    const pkg = require_package();
-    return pkg?.version || "3.x.x";
-  } catch {
-    return "3.x.x";
-  }
+  return version;
 }
 
 // src/utils/apiOrigin.ts
@@ -69,7 +61,7 @@ var HttpClient = class {
     return this.instance.defaults.timeout ?? 3e5;
   }
   async request(config) {
-    const version = getVersion();
+    const version2 = getVersion();
     config.headers = {
       ...config.headers || {}
     };
@@ -84,7 +76,7 @@ var HttpClient = class {
           const data = cfg.data ?? {};
           cfg.data = {
             ...data,
-            origin: typeof data.origin === "string" && data.origin.includes("mcp") ? data.origin : `js-sdk@${version}`
+            origin: typeof data.origin === "string" && data.origin.includes("mcp") ? data.origin : `js-sdk@${version2}`
           };
         }
         if (isFormDataBody) {
@@ -323,6 +315,30 @@ function ensureValidFormats(formats) {
     }
   }
 }
+var V1_SCRAPE_OPTION_REPLACEMENTS = {
+  pageOptions: "use scrapeOptions",
+  includeLinks: "add 'links' to scrapeOptions.formats",
+  parsePDF: "use scrapeOptions.parsers"
+};
+var V1_OPTION_REPLACEMENTS = {
+  crawl: {
+    crawlerOptions: "move its fields to the top level",
+    maxDepth: "use maxDiscoveryDepth",
+    allowBackwardLinks: "use crawlEntireDomain",
+    ignoreSitemap: "use sitemap: 'skip'",
+    ...V1_SCRAPE_OPTION_REPLACEMENTS
+  },
+  search: V1_SCRAPE_OPTION_REPLACEMENTS
+};
+function ensureNoV1Options(options, method) {
+  if (!options) return;
+  const replacements = V1_OPTION_REPLACEMENTS[method];
+  const found = Object.keys(replacements).filter((key) => options[key] != null);
+  if (found.length === 0) return;
+  throw new Error(
+    `${method}: ${found.map((key) => `${key} is a v1 option, ${replacements[key]}`).join("; ")}`
+  );
+}
 function ensureValidScrapeOptions(options) {
   if (!options) return;
   if (options.timeout != null && options.timeout <= 0) {
@@ -436,12 +452,28 @@ function ensureValidParseOptions(options) {
 
 // src/v2/utils/errorHandler.ts
 import "axios";
+function describeValidationIssues(details) {
+  if (!Array.isArray(details)) return void 0;
+  const parts = details.slice(0, 3).flatMap((issue) => {
+    if (!issue || typeof issue !== "object") return [];
+    const { path, message, keys } = issue;
+    const what = Array.isArray(keys) && keys.length > 0 ? `unrecognized key(s) ${keys.join(", ")}` : typeof message === "string" ? message : void 0;
+    if (!what) return [];
+    return Array.isArray(path) && path.length > 0 ? [`${path.join(".")}: ${what}`] : [what];
+  });
+  return parts.length > 0 ? parts.join("; ") : void 0;
+}
+function withIssues(message, details) {
+  const text = typeof message === "string" ? message : JSON.stringify(message);
+  const issues = describeValidationIssues(details);
+  return issues && !text.includes(issues) ? `${text} (${issues})` : text;
+}
 function throwForBadResponse(resp, action) {
   const status = resp.status;
   const body = resp.data || {};
   const msg = body?.error || body?.message || `Request failed (${status}) while trying to ${action}`;
   throw Object.assign(new SdkError(
-    msg,
+    withIssues(msg, body?.details),
     status,
     body?.code,
     body?.details,
@@ -456,7 +488,7 @@ function normalizeAxiosError(err, action) {
   const message = body?.error || err.message || `Request failed${status ? ` (${status})` : ""} while trying to ${action}`;
   const code = body?.code || err.code;
   throw Object.assign(new SdkError(
-    message,
+    withIssues(message, body?.details),
     status,
     code,
     body?.details ?? body,
@@ -627,10 +659,10 @@ async function parse(http, file, options) {
     throw new Error("file data cannot be empty");
   }
   if (options) ensureValidParseOptions(options);
-  const version = getVersion();
+  const version2 = getVersion();
   const normalizedOptions = {
     ...options ?? {},
-    origin: typeof options?.origin === "string" && options.origin.includes("mcp") ? options.origin : options?.origin ?? `js-sdk@${version}`
+    origin: typeof options?.origin === "string" && options.origin.includes("mcp") ? options.origin : options?.origin ?? `js-sdk@${version2}`
   };
   const formData = new FormData();
   formData.append("options", JSON.stringify(normalizedOptions));
@@ -668,6 +700,7 @@ async function getParseFormats(http) {
 // src/v2/methods/search.ts
 function prepareSearchPayload(req) {
   if (!req.query || !req.query.trim()) throw new Error("Query cannot be empty");
+  ensureNoV1Options(req, "search");
   if (req.limit != null && req.limit <= 0)
     throw new Error("limit must be positive");
   if (req.timeout != null && req.timeout <= 0)
@@ -1035,7 +1068,9 @@ async function fetchAllPages(http, nextUrl, initial, pagination) {
       docs.push(d);
     }
     if (maxResults != null && docs.length >= maxResults) break;
-    current = payload.next ?? (Array.isArray(payload.data) ? null : payload.data?.next) ?? null;
+    const next = payload.next ?? (Array.isArray(payload.data) ? null : payload.data?.next) ?? null;
+    if (next === current) break;
+    current = next;
     pageCount += 1;
   }
   return docs;
@@ -1044,6 +1079,7 @@ async function fetchAllPages(http, nextUrl, initial, pagination) {
 // src/v2/methods/crawl.ts
 function prepareCrawlPayload(request) {
   if (!request.url || !request.url.trim()) throw new Error("URL cannot be empty");
+  ensureNoV1Options(request, "crawl");
   const data = { url: request.url.trim() };
   if (request.prompt) data.prompt = request.prompt;
   if (request.excludePaths) data.excludePaths = request.excludePaths;
@@ -1595,6 +1631,7 @@ async function browser(http, args = {}) {
   if (args.streamWebView != null) body.streamWebView = args.streamWebView;
   if (args.blockAds != null) body.blockAds = args.blockAds;
   if (args.profile != null) body.profile = args.profile;
+  if (args.location != null) body.location = args.location;
   if (args.integration != null) body.integration = args.integration;
   if (args.origin) body.origin = args.origin;
   try {
@@ -2661,7 +2698,7 @@ var FirecrawlClient = class {
   // Browser
   /**
    * Create a new browser session.
-   * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile).
+   * @param args Session options (ttl, activityTtl, streamWebView, blockAds, profile, location).
    * @returns Session id, CDP URL, live view URL, and expiration time.
    */
   async browser(args = {}) {
@@ -2800,10 +2837,10 @@ var FirecrawlApp = class {
       if (typeof process !== "undefined" && process.env && process.env.npm_package_version) {
         return process.env.npm_package_version;
       }
-      const packageJson = await import("./package-C6PK3CK7.js");
+      const packageJson = await import("./package-NZI5TDUV.js");
       return packageJson.default.version;
     } catch (error) {
-      const isTest = typeof process !== "undefined" && (process.env.JEST_WORKER_ID != null || false);
+      const isTest = typeof process !== "undefined" && false;
       if (!isTest) {
         console.error("Error getting version:", error);
       }

package/dist/package-NZI5TDUV.js

@@ -0,0 +1,40 @@
+import {
+  author,
+  bugs,
+  dependencies,
+  description,
+  devDependencies,
+  engines,
+  exports,
+  homepage,
+  keywords,
+  license,
+  main,
+  name,
+  package_default,
+  repository,
+  scripts,
+  type,
+  types,
+  version
+} from "./chunk-H75FJ6LW.js";
+export {
+  author,
+  bugs,
+  package_default as default,
+  dependencies,
+  description,
+  devDependencies,
+  engines,
+  exports,
+  homepage,
+  keywords,
+  license,
+  main,
+  name,
+  repository,
+  scripts,
+  type,
+  types,
+  version
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mendable/firecrawl-js",
-  "version": "4.45.0",
+  "version": "4.47.0",
   "description": "JavaScript SDK for the Firecrawl API: web scraping, crawling, web search, and scientific literature search over a research paper index of PubMed, bioRxiv, medRxiv and arXiv abstracts",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,18 +30,14 @@
   },
   "homepage": "https://github.com/firecrawl/firecrawl#readme",
   "devDependencies": {
-    "@jest/globals": "^30.2.0",
     "@types/dotenv": "^8.2.0",
-    "@types/jest": "^30.0.0",
-    "@types/mocha": "^10.0.6",
     "@types/node": "^20.12.12",
     "@types/uuid": "^9.0.8",
     "dotenv": "^16.4.5",
-    "jest": "^30.2.0",
-    "ts-jest": "^29.4.5",
     "tsup": "^8.5.0",
     "typescript": "^5.4.5",
-    "uuid": "^14.0.0"
+    "uuid": "^14.0.0",
+    "vitest": "^4.1.11"
   },
   "keywords": [
     "firecrawl",
@@ -73,7 +69,7 @@
     "build": "tsup",
     "build-and-publish": "pnpm run build && pnpm publish --access public",
     "publish-beta": "pnpm run build && pnpm publish --access public --tag beta",
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest --verbose src/__tests__/e2e/v2/*.test.ts --detectOpenHandles",
-    "test:unit": "NODE_OPTIONS=--experimental-vm-modules jest --verbose src/__tests__/unit"
+    "test": "vitest run --reporter=verbose src/__tests__/e2e/v2",
+    "test:unit": "vitest run --reporter=verbose src/__tests__/unit"
   }
 }

package/pnpm-workspace.yaml

@@ -1,17 +1,13 @@
 allowBuilds:
   esbuild: true
-  unrs-resolver: true
 overrides:
   "@isaacs/brace-expansion@<=5.0.0": ">=5.0.1"
   "minimatch@<10.2.3": ">=10.2.3"
   "rollup@<4.59.0": ">=4.59.0"
   "picomatch@<4.0.4": ">=4.0.4"
-  handlebars: ">=4.7.9"
   # GHSA-q2hr-2g5m-vwhr / GHSA-qhr7-859c-m2p7 / GHSA-6j4f-fj2g-mc7p:
   # pin the 5.x line only. Exact 5.0.12 cannot resolve to 6.x.
   "brace-expansion@>=5.0.0 <5.0.12": "5.0.12"
-  "js-yaml@>=3.0.0 <3.15.2": "3.15.2"
-  "js-yaml@>=4.0.0 <4.3.2": "4.3.2"
   # GHSA-vh66-26gq-q6x8 / GHSA-9fr6-4gfg-395g / GHSA-c29m-xwm3-cm6r /
   # GHSA-mghh-pgcx-3jjj / GHSA-x97p-jq2g-jp4f / GHSA-3pq3-5fj3-cg6v /
   # GHSA-542g-h47m-68v8 / GHSA-j8rh-479h-cp32 / GHSA-4hqw-qxg8-jxx2 /
@@ -20,6 +16,4 @@ overrides:
   "axios@>=1.0.0 <1.20.0": "1.20.0"
   "follow-redirects@<1.16.0": ">=1.16.0 <2.0.0"
   "form-data@>=4.0.0 <4.0.6": "4.0.6"
-  "@babel/core@>=7.0.0 <7.29.6": "7.29.7"
   "esbuild@>=0.17.0 <0.28.1": "0.28.1"
-  "browserslist@<=4.28.6": ">=4.28.7 <5.0.0"

package/src/__tests__/e2e/v1/index.test.ts

@@ -1,7 +1,7 @@
 import FirecrawlApp, { type CrawlParams, type CrawlResponse, type CrawlStatusResponse, type MapResponse, type ScrapeResponse } from '../../../index';
 import { v4 as uuidv4 } from 'uuid';
 import dotenv from 'dotenv';
-import { describe, test, expect } from '@jest/globals';
+import { describe, test, expect } from 'vitest';
 
 dotenv.config();
 

package/src/__tests__/e2e/v2/batch.test.ts

@@ -5,7 +5,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, waitForJob, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/crawl.test.ts

@@ -5,7 +5,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, waitForJob, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/extract.test.ts

@@ -5,7 +5,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, waitForJob, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 import { z } from "zod";
 
 config();

package/src/__tests__/e2e/v2/map.test.ts

@@ -5,7 +5,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/parse.test.ts

@@ -2,7 +2,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 import { SdkError } from "../../../v2/types";
 
 config();

package/src/__tests__/e2e/v2/scrape.test.ts

@@ -6,7 +6,7 @@ import { z } from "zod";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/search.test.ts

@@ -6,7 +6,7 @@ import type { Document, SearchResultWeb, SearchResultNews, SearchResultImages }
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/usage.test.ts

@@ -5,7 +5,7 @@ import Firecrawl from "../../../index";
 import { config } from "dotenv";
 import { getIdentity, getApiUrl } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 
 config();
 

package/src/__tests__/e2e/v2/utils/rateLimit.ts

@@ -52,7 +52,7 @@ export const RETRY_BUDGET_MS = (MAX_ATTEMPTS - 1) * MAX_WAIT_MS;
  *
  * Every caller now passes its own timeout, sized to the work it waits for.
  * This value is only a backstop for a new caller that forgets one. Without a
- * bound the poll loop runs until the jest timeout, which hides the reason.
+ * bound the poll loop runs until the test timeout, which hides the reason.
  *
  * The value stays short because it cannot know the work. It fits the smallest
  * base any suite passes to testTimeoutMs, which is 60_000 ms:
@@ -69,7 +69,7 @@ export const RETRY_BUDGET_MS = (MAX_ATTEMPTS - 1) * MAX_WAIT_MS;
 export const DEFAULT_JOB_TIMEOUT_MS = 45_000;
 
 /**
- * Jest timeout for a test that calls a wrapped client.
+ * Vitest timeout for a test that calls a wrapped client.
  *
  * Pass the base: the time the test needs when the API answers at once. The
  * result adds one retry budget on top, so a test whose single call hits the

package/src/__tests__/e2e/v2/watcher.test.ts

@@ -1,6 +1,6 @@
 import Firecrawl from "../../../index";
 import { config } from "dotenv";
-import { describe, test, expect, beforeAll } from "@jest/globals";
+import { describe, test, expect, beforeAll } from "vitest";
 import { getIdentity } from "./utils/idmux";
 import { testTimeoutMs, withRateLimitRetry } from "./utils/rateLimit";
 

package/src/__tests__/unit/v1/batch-scrape-poll.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect, jest, afterEach, beforeEach } from "@jest/globals";
+import { describe, test, expect, vi, afterEach, beforeEach } from "vitest";
 import axios from "axios";
 import FirecrawlApp from "../../../v1";
 
@@ -20,7 +20,7 @@ const lastPage = () => ({ success: true, status: "completed", data: [{ markdown:
 function mockPoll(path: string, nextOrigin = API_URL) {
   const sent: string[] = [];
   let polls = 0;
-  jest.spyOn(axios, "get").mockImplementation(async (url: string) => {
+  vi.spyOn(axios, "get").mockImplementation(async (url: string) => {
     sent.push(url);
     if (new URL(url).searchParams.has("skip")) return { status: 200, data: lastPage() };
     polls++;
@@ -33,18 +33,18 @@ describe("v1 batch scrape waits on the batch scrape status endpoint", () => {
   const app = new FirecrawlApp({ apiKey: API_KEY, apiUrl: API_URL });
 
   beforeEach(() => {
-    jest.spyOn(global, "setTimeout").mockImplementation(((fn: () => void) => {
+    vi.spyOn(global, "setTimeout").mockImplementation(((fn: () => void) => {
       fn();
       return 0;
     }) as any);
   });
 
   afterEach(() => {
-    jest.restoreAllMocks();
+    vi.restoreAllMocks();
   });
 
   test("batchScrapeUrls polls /v1/batch/scrape/{id} and follows pinned next pages", async () => {
-    const post = jest.spyOn(axios, "post").mockResolvedValue({ status: 200, data: { success: true, id: "abc" } });
+    const post = vi.spyOn(axios, "post").mockResolvedValue({ status: 200, data: { success: true, id: "abc" } });
     const path = "/v1/batch/scrape/abc";
     const sent = mockPoll(path, "https://evil.example");
 
@@ -58,9 +58,9 @@ describe("v1 batch scrape waits on the batch scrape status endpoint", () => {
   });
 
   test("batchScrapeUrls reports batch scrape failures as batch scrape errors", async () => {
-    jest.spyOn(axios, "post").mockResolvedValue({ status: 200, data: { success: true, id: "abc" } });
+    vi.spyOn(axios, "post").mockResolvedValue({ status: 200, data: { success: true, id: "abc" } });
     const sent: string[] = [];
-    jest.spyOn(axios, "get").mockImplementation(async (url: string) => {
+    vi.spyOn(axios, "get").mockImplementation(async (url: string) => {
       sent.push(url);
       return { status: 200, data: { success: true, status: "failed", data: [] } };
     });

package/src/__tests__/unit/v1/monitor-job-status-retry.test.ts

@@ -1,5 +1,5 @@
 import FirecrawlApp from '../../../v1';
-import { describe, test, expect, jest, beforeEach, afterEach } from '@jest/globals';
+import { describe, test, expect, vi, beforeEach, afterEach } from 'vitest';
 
 const successResponse = {
   status: 200,
@@ -21,17 +21,17 @@ describe('monitorJobStatus retry logic', () => {
   beforeEach(() => {
     app = new FirecrawlApp({ apiKey: 'test-key', apiUrl: 'https://test.com' });
     delays = [];
-    jest.useFakeTimers();
+    vi.useFakeTimers();
     const fakeSetTimeout = globalThis.setTimeout;
-    jest.spyOn(globalThis, 'setTimeout').mockImplementation(((fn: () => void, ms?: number) => {
+    vi.spyOn(globalThis, 'setTimeout').mockImplementation(((fn: () => void, ms?: number) => {
       delays.push(ms ?? 0);
       return fakeSetTimeout(fn, ms);
     }) as any);
   });
 
   afterEach(() => {
-    jest.restoreAllMocks();
-    jest.useRealTimers();
+    vi.restoreAllMocks();
+    vi.useRealTimers();
   });
 
   function failFirst(n: number, error: Error, statuses: string[] = []) {
@@ -48,7 +48,7 @@ describe('monitorJobStatus retry logic', () => {
   async function monitor() {
     const result = app.monitorJobStatus('test-id', {} as any, 1);
     result.catch(() => {});
-    await jest.runAllTimersAsync();
+    await vi.runAllTimersAsync();
     return result;
   }
 

package/src/__tests__/unit/v1/next-url-pinning.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect, jest, afterEach } from "@jest/globals";
+import { describe, test, expect, vi, afterEach } from "vitest";
 import axios from "axios";
 import FirecrawlApp from "../../../v1";
 
@@ -16,7 +16,7 @@ const origins: Array<[string, string]> = [
 
 function mockGet(respond: (url: URL) => unknown) {
   const sent: Array<{ url: string; authorization: unknown }> = [];
-  jest.spyOn(axios, "get").mockImplementation(async (url: string, config?: any) => {
+  vi.spyOn(axios, "get").mockImplementation(async (url: string, config?: any) => {
     sent.push({ url, authorization: config?.headers?.Authorization });
     return { status: 200, data: respond(new URL(url)) };
   });
@@ -45,7 +45,7 @@ const lastPage = () => ({ success: true, status: "completed", data: [{ markdown:
 
 describe("v1 pins next URLs to the api_url origin", () => {
   afterEach(() => {
-    jest.restoreAllMocks();
+    vi.restoreAllMocks();
   });
 
   describe.each(origins)("%s next", (_label, origin) => {

package/src/__tests__/unit/v1/optional-params.test.ts

@@ -1,4 +1,4 @@
-import { describe, test, expect, jest, beforeEach, afterEach } from "@jest/globals";
+import { describe, test, expect, vi, beforeEach, afterEach } from "vitest";
 import axios from "axios";
 import FirecrawlApp from "../../../v1";
 
@@ -20,11 +20,11 @@ describe("v1 methods work without params", () => {
   beforeEach(() => {
     app = new FirecrawlApp({ apiKey: "fc-test", apiUrl: API_URL });
     posts = [];
-    jest.spyOn(axios, "post").mockImplementation(async (url: string, data?: any) => {
+    vi.spyOn(axios, "post").mockImplementation(async (url: string, data?: any) => {
       posts.push({ url, data });
       return { status: 200, data: { success: true, id: "job-1", data: [], links: [] } };
     });
-    jest.spyOn(axios, "get").mockImplementation(async () => ({
+    vi.spyOn(axios, "get").mockImplementation(async () => ({
       status: 200,
       data: { success: true, status: "completed", data: [{ markdown: "ok" }] },
     }));
@@ -32,7 +32,7 @@ describe("v1 methods work without params", () => {
   });
 
   afterEach(() => {
-    jest.restoreAllMocks();
+    vi.restoreAllMocks();
     (globalThis as any).WebSocket = originalWebSocket;
   });
 

package/src/__tests__/unit/v2/agent-effort-trace.unit.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, jest, test } from "@jest/globals";
+import { describe, expect, vi, test } from "vitest";
 import {
   startAgent,
   getAgentTrace,
@@ -8,7 +8,7 @@ import type { AgentTraceEvent } from "../../../v2/types";
 
 describe("v2.agent unit", () => {
   test("startAgent forwards effort in request payload", async () => {
-    const post = jest.fn().mockResolvedValue({
+    const post = vi.fn().mockResolvedValue({
       status: 200,
       data: { success: true, id: "agent-job" },
     });
@@ -25,7 +25,7 @@ describe("v2.agent unit", () => {
   });
 
   test("startAgent omits effort when unset", async () => {
-    const post = jest.fn().mockResolvedValue({
+    const post = vi.fn().mockResolvedValue({
       status: 200,
       data: { success: true, id: "agent-job" },
     });
@@ -70,7 +70,7 @@ describe("v2.agent unit", () => {
         change: "partial",
       },
     };
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: {
         success: true,
@@ -95,7 +95,7 @@ describe("v2.agent unit", () => {
   });
 
   test("getAgentTrace appends liveView query param when requested", async () => {
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: {
         success: true,
@@ -122,7 +122,7 @@ describe("v2.agent unit", () => {
   });
 
   test("getAgentSnapshot hits the snapshot endpoint", async () => {
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: {
         success: true,

package/src/__tests__/unit/v2/agent-hints.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, it, jest } from "@jest/globals";
+import { describe, expect, it, vi } from "vitest";
 import { search } from "../../../v2/methods/search";
 import { scrape } from "../../../v2/methods/scrape";
 import { parse } from "../../../v2/methods/parse";
@@ -14,8 +14,8 @@ const hints = [
 ];
 function httpFor(body: object) {
   return {
-    post: jest.fn<any>().mockResolvedValue({ status: 200, data: body }),
-    postMultipart: jest
+    post: vi.fn<any>().mockResolvedValue({ status: 200, data: body }),
+    postMultipart: vi
       .fn<any>()
       .mockResolvedValue({ status: 200, data: body }),
   } as any;

package/src/__tests__/unit/v2/agent-list.unit.test.ts

@@ -1,4 +1,4 @@
-import { describe, expect, jest, test } from "@jest/globals";
+import { describe, expect, vi, test } from "vitest";
 import { listAgents } from "../../../v2/methods/agent";
 
 describe("v2.agent listAgents unit", () => {
@@ -17,7 +17,7 @@ describe("v2.agent listAgents unit", () => {
   };
 
   test("hits GET /v2/agent without query by default", async () => {
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: { success: true, agents: [sampleAgent] },
     });
@@ -33,7 +33,7 @@ describe("v2.agent listAgents unit", () => {
   });
 
   test("passes before as a query param", async () => {
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: {
         success: true,
@@ -51,7 +51,7 @@ describe("v2.agent listAgents unit", () => {
   });
 
   test("does not auto-paginate when next is present", async () => {
-    const get = jest.fn().mockResolvedValue({
+    const get = vi.fn().mockResolvedValue({
       status: 200,
       data: {
         success: true,