exa-js 1.10.1 → 2.0.0

package/dist/index.d.ts

@@ -3,228 +3,330 @@ import { ZodSchema } from 'zod';
 interface components$1 {
     schemas: {
         ListResearchResponseDto: {
-            /** @description The list of research requests */
+            /** @description Research requests ordered by creation time (newest first) */
             data: components$1["schemas"]["ResearchDtoClass"][];
-            /** @description Whether there are more results to paginate through */
+            /** @description If true, use nextCursor to fetch more results */
             hasMore: boolean;
-            /** @description The cursor to paginate through the next set of results */
+            /** @description Pass this value as the cursor parameter to fetch the next page */
             nextCursor: string | null;
         };
         ResearchCreateRequestDtoClass: {
-            /** @description Instructions for what research should be conducted */
+            /** @description Instructions for what you would like research on. A good prompt clearly defines what information you want to find, how research should be conducted, and what the output should look like. */
             instructions: string;
             /**
+             * @description Research model to use. exa-research is faster and cheaper, while exa-research-pro provides more thorough analysis and stronger reasoning.
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description JSON Schema to enforce structured output. When provided, the research output will be validated against this schema and returned as parsed JSON. */
             outputSchema?: {
                 [key: string]: unknown;
             };
         };
         ResearchDtoClass: {
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was created (Unix timestamp in milliseconds) */
             createdAt: number;
-            /** @description The instructions given to this research request */
+            /** @description The original research instructions provided */
             instructions: string;
             /**
-             * @description The model used for the research request
+             * @description The model used for this research request
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description The JSON Schema used to validate the output, if provided */
             outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research request */
+            /** @description Unique identifier for tracking and retrieving this research request */
             researchId: string;
             /** @enum {string} */
             status: "pending";
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was created (Unix timestamp in milliseconds) */
             createdAt: number;
+            /** @description Real-time log of operations as research progresses. Poll this endpoint or use ?stream=true for live updates. */
             events?: components$1["schemas"]["ResearchEventDtoClass"][];
-            /** @description The instructions given to this research request */
+            /** @description The original research instructions provided */
             instructions: string;
             /**
-             * @description The model used for the research request
+             * @description The model used for this research request
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description The JSON Schema used to validate the output, if provided */
             outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research request */
+            /** @description Unique identifier for tracking and retrieving this research request */
             researchId: string;
             /** @enum {string} */
             status: "running";
         } | {
+            /** @description Detailed cost breakdown for billing purposes */
             costDollars: {
+                /** @description Count of web pages fully crawled and processed. Only pages that were read in detail are counted. */
                 numPages: number;
+                /** @description Count of web searches performed. Each search query counts as one search. */
                 numSearches: number;
+                /** @description Total AI tokens used for reasoning, planning, and generating the final output */
                 reasoningTokens: number;
+                /** @description Total cost in USD for this research request */
                 total: number;
             };
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was created (Unix timestamp in milliseconds) */
             createdAt: number;
+            /** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
             events?: components$1["schemas"]["ResearchEventDtoClass"][];
-            /** @description Milliseconds since epoch time */
+            /** @description When the research completed (Unix timestamp in milliseconds) */
             finishedAt: number;
-            /** @description The instructions given to this research request */
+            /** @description The original research instructions provided */
             instructions: string;
             /**
-             * @description The model used for the research request
+             * @description The model used for this research request
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description The final research results, containing both raw text and parsed JSON if outputSchema was provided */
             output: {
+                /** @description The complete research output as text. If outputSchema was provided, this is a JSON string. */
                 content: string;
+                /** @description Structured JSON object matching your outputSchema. Only present when outputSchema was provided and the output successfully validated. */
                 parsed?: {
                     [key: string]: unknown;
                 };
             };
+            /** @description The JSON Schema used to validate the output, if provided */
             outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research request */
+            /** @description Unique identifier for tracking and retrieving this research request */
             researchId: string;
             /** @enum {string} */
             status: "completed";
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was created (Unix timestamp in milliseconds) */
             createdAt: number;
+            /** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
             events?: components$1["schemas"]["ResearchEventDtoClass"][];
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was canceled (Unix timestamp in milliseconds) */
             finishedAt: number;
-            /** @description The instructions given to this research request */
+            /** @description The original research instructions provided */
             instructions: string;
             /**
-             * @description The model used for the research request
+             * @description The model used for this research request
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description The JSON Schema used to validate the output, if provided */
             outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research request */
+            /** @description Unique identifier for tracking and retrieving this research request */
             researchId: string;
             /** @enum {string} */
             status: "canceled";
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When the research was created (Unix timestamp in milliseconds) */
             createdAt: number;
-            /** @description A message indicating why the request failed */
+            /** @description Human-readable error message explaining what went wrong. */
             error: string;
+            /** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
             events?: components$1["schemas"]["ResearchEventDtoClass"][];
-            /** @description Milliseconds since epoch time */
+            /** @description When the research failed (Unix timestamp in milliseconds) */
             finishedAt: number;
-            /** @description The instructions given to this research request */
+            /** @description The original research instructions provided */
             instructions: string;
             /**
-             * @description The model used for the research request
+             * @description The model used for this research request
              * @default exa-research
              * @enum {string}
              */
-            model: "exa-research" | "exa-research-pro";
+            model: "exa-research-fast" | "exa-research" | "exa-research-pro";
+            /** @description The JSON Schema used to validate the output, if provided */
             outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research request */
+            /** @description Unique identifier for tracking and retrieving this research request */
             researchId: string;
             /** @enum {string} */
             status: "failed";
         };
         ResearchEventDtoClass: ({
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "research-definition";
+            /** @description The complete research instructions as provided */
             instructions: string;
+            /** @description The JSON Schema that will validate the final output */
             outputSchema?: {
                 [key: string]: unknown;
             };
+            /** @description The research request this event belongs to */
             researchId: string;
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "research-output";
+            /** @description The final research result, either successful with data or failed with error */
             output: {
+                /** @description The complete research output as text. If outputSchema was provided, this is a JSON string. */
                 content: string;
                 costDollars: {
+                    /** @description Count of web pages fully crawled and processed. Only pages that were read in detail are counted. */
                     numPages: number;
+                    /** @description Count of web searches performed. Each search query counts as one search. */
                     numSearches: number;
+                    /** @description Total AI tokens used for reasoning, planning, and generating the final output */
                     reasoningTokens: number;
+                    /** @description Total cost in USD for this research request */
                     total: number;
                 };
                 /** @enum {string} */
                 outputType: "completed";
+                /** @description Structured JSON object matching your outputSchema. Only present when outputSchema was provided and the output successfully validated. */
                 parsed?: {
                     [key: string]: unknown;
                 };
             } | {
+                /** @description Detailed error message explaining why the research failed */
                 error: string;
                 /** @enum {string} */
                 outputType: "failed";
             };
+            /** @description The research request this event belongs to */
             researchId: string;
         }) | ({
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "plan-definition";
+            /** @description Identifier for this planning cycle */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
-            data: components$1["schemas"]["ResearchOperationDtoClass"];
+            /** @description The actual operation performed (think, search, or crawl) */
+            data: {
+                /** @description The AI's reasoning process and decision-making steps */
+                content: string;
+                /** @enum {string} */
+                type: "think";
+            } | {
+                /** @description What the AI is trying to find with this search */
+                goal?: string;
+                /** @description Token cost for processing search result snippets */
+                pageTokens: number;
+                /** @description The exact search query sent to the search engine */
+                query: string;
+                /** @description URLs returned by the search, ranked by relevance */
+                results: {
+                    url: string;
+                }[];
+                /**
+                 * @description Search algorithm used (neural for semantic search, keyword for exact matches)
+                 * @enum {string}
+                 */
+                searchType: "neural" | "keyword" | "auto" | "fast";
+                /** @enum {string} */
+                type: "search";
+            } | {
+                /** @description What information the AI expects to find on this page */
+                goal?: string;
+                /** @description Token cost for processing the full page content */
+                pageTokens: number;
+                /** @description The specific page that was crawled */
+                result: {
+                    url: string;
+                };
+                /** @enum {string} */
+                type: "crawl";
+            };
             /** @enum {string} */
             eventType: "plan-operation";
+            /** @description Unique identifier for this specific operation */
             operationId: string;
+            /** @description Which plan this operation belongs to */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "plan-output";
-            output: components$1["schemas"]["ResearchOperationDtoClass"];
+            /** @description The plan's decision: either generate tasks or stop researching */
+            output: {
+                /** @enum {string} */
+                outputType: "tasks";
+                /** @description Why these specific tasks were chosen */
+                reasoning: string;
+                /** @description List of task instructions that will be executed in parallel */
+                tasksInstructions: string[];
+            } | {
+                /** @enum {string} */
+                outputType: "stop";
+                /** @description Why the AI decided to stop researching */
+                reasoning: string;
+            };
+            /** @description Which plan is producing this output */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
         }) | ({
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "task-definition";
+            /** @description What this task should accomplish */
             instructions: string;
+            /** @description The plan that generated this task */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
+            /** @description Identifier for tracking this specific task */
             taskId: string;
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
+            /** @description The actual operation performed within this task */
             data: {
+                /** @description The AI's reasoning process and decision-making steps */
                 content: string;
                 /** @enum {string} */
                 type: "think";
             } | {
+                /** @description What the AI is trying to find with this search */
                 goal?: string;
+                /** @description Token cost for processing search result snippets */
                 pageTokens: number;
+                /** @description The exact search query sent to the search engine */
                 query: string;
+                /** @description URLs returned by the search, ranked by relevance */
                 results: {
                     url: string;
                 }[];
-                /** @enum {string} */
+                /**
+                 * @description Search algorithm used (neural for semantic search, keyword for exact matches)
+                 * @enum {string}
+                 */
                 searchType: "neural" | "keyword" | "auto" | "fast";
                 /** @enum {string} */
                 type: "search";
             } | {
+                /** @description What information the AI expects to find on this page */
                 goal?: string;
+                /** @description Token cost for processing the full page content */
                 pageTokens: number;
+                /** @description The specific page that was crawled */
                 result: {
                     url: string;
                 };
@@ -233,42 +335,62 @@ interface components$1 {
             };
             /** @enum {string} */
             eventType: "task-operation";
+            /** @description Unique identifier for this specific operation */
             operationId: string;
+            /** @description The plan that owns this task */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
+            /** @description Which task is performing this operation */
             taskId: string;
         } | {
-            /** @description Milliseconds since epoch time */
+            /** @description When this event occurred (Unix timestamp in milliseconds) */
             createdAt: number;
             /** @enum {string} */
             eventType: "task-output";
+            /** @description The successful completion result of this task */
             output: {
+                /** @description The information gathered by this task */
                 content: string;
                 /** @enum {string} */
                 outputType: "completed";
             };
+            /** @description The plan that owns this task */
             planId: string;
+            /** @description The research request this event belongs to */
             researchId: string;
+            /** @description Which task produced this output */
             taskId: string;
         });
         ResearchOperationDtoClass: {
+            /** @description The AI's reasoning process and decision-making steps */
             content: string;
             /** @enum {string} */
             type: "think";
         } | {
+            /** @description What the AI is trying to find with this search */
             goal?: string;
+            /** @description Token cost for processing search result snippets */
             pageTokens: number;
+            /** @description The exact search query sent to the search engine */
             query: string;
+            /** @description URLs returned by the search, ranked by relevance */
             results: {
                 url: string;
             }[];
-            /** @enum {string} */
+            /**
+             * @description Search algorithm used (neural for semantic search, keyword for exact matches)
+             * @enum {string}
+             */
             searchType: "neural" | "keyword" | "auto" | "fast";
             /** @enum {string} */
             type: "search";
         } | {
+            /** @description What information the AI expects to find on this page */
             goal?: string;
+            /** @description Token cost for processing the full page content */
             pageTokens: number;
+            /** @description The specific page that was crawled */
             result: {
                 url: string;
             };
@@ -309,7 +431,7 @@ type ResearchStreamEvent = ResearchEvent;
  */
 type ResearchCreateParamsTyped<T> = {
     instructions: string;
-    model?: "exa-research" | "exa-research-pro";
+    model?: ResearchCreateRequest["model"];
     outputSchema?: T;
 };
 type ResearchDefinitionEvent = Extract<ResearchEvent, {
@@ -354,7 +476,7 @@ declare class ResearchClient extends ResearchBaseClient {
     create<T>(params: ResearchCreateParamsTyped<ZodSchema<T>>): Promise<ResearchCreateResponse>;
     create(params: {
         instructions: string;
-        model?: "exa-research" | "exa-research-pro";
+        model?: ResearchCreateRequest["model"];
         outputSchema?: Record<string, unknown>;
     }): Promise<ResearchCreateResponse>;
     get(researchId: string): Promise<Research>;
@@ -2843,10 +2965,33 @@ declare class ExaError extends Error {
     constructor(message: string, statusCode: number, timestamp?: string, path?: string);
 }
 
-declare const isBeta = false;
 /**
- * Search options for performing a search query.
+ * Options for retrieving page contents
+ * @typedef {Object} ContentsOptions
+ * @property {TextContentsOptions | boolean} [text] - Options for retrieving text contents.
+ * @property {SummaryContentsOptions | boolean} [summary] - Options for retrieving summary.
+ * @property {LivecrawlOptions} [livecrawl] - Options for livecrawling contents. Default is "never" for neural/auto search, "fallback" for keyword search.
+ * @property {number} [livecrawlTimeout] - The timeout for livecrawling. Max and default is 10000ms.
+ * @property {boolean} [filterEmptyResults] - If true, filters out results with no contents. Default is true.
+ * @property {number} [subpages] - The number of subpages to return for each result, where each subpage is derived from an internal link for the result.
+ * @property {string | string[]} [subpageTarget] - Text used to match/rank subpages in the returned subpage list. You could use "about" to get *about* page for websites. Note that this is a fuzzy matcher.
+ * @property {ExtrasOptions} [extras] - Miscelleneous data derived from results
+ */
+type ContentsOptions = {
+    text?: TextContentsOptions | true;
+    summary?: SummaryContentsOptions | true;
+    livecrawl?: LivecrawlOptions;
+    context?: ContextOptions | true;
+    livecrawlTimeout?: number;
+    filterEmptyResults?: boolean;
+    subpages?: number;
+    subpageTarget?: string | string[];
+    extras?: ExtrasOptions;
+};
+/**
+ * Options for performing a search query
  * @typedef {Object} SearchOptions
+ * @property {ContentsOptions | boolean} [contents] - Options for retrieving page contents for each result returned. Default is { text: { maxCharacters: 10_000 } }.
  * @property {number} [numResults] - Number of search results to return. Default 10. Max 10 for basic plans.
  * @property {string[]} [includeDomains] - List of domains to include in the search.
  * @property {string[]} [excludeDomains] - List of domains to exclude in the search.
@@ -2861,6 +3006,7 @@ declare const isBeta = false;
  * @property {string} [userLocation] - The two-letter ISO country code of the user, e.g. US.
  */
 type BaseSearchOptions = {
+    contents?: ContentsOptions;
     numResults?: number;
     includeDomains?: string[];
     excludeDomains?: string[];
@@ -2898,31 +3044,6 @@ type ExtrasOptions = {
     links?: number;
     imageLinks?: number;
 };
-/**
- * Search options for performing a search query.
- * @typedef {Object} ContentsOptions
- * @property {TextContentsOptions | boolean} [text] - Options for retrieving text contents.
- * @property {HighlightsContentsOptions | boolean} [highlights] - Options for retrieving highlights. NOTE: For search type "deep", only "true" is allowed. "query", "numSentences" and "highlightsPerUrl" will not be respected;
- * @property {SummaryContentsOptions | boolean} [summary] - Options for retrieving summary.
- * @property {LivecrawlOptions} [livecrawl] - Options for livecrawling contents. Default is "never" for neural/auto search, "fallback" for keyword search.
- * @property {number} [livecrawlTimeout] - The timeout for livecrawling. Max and default is 10000ms.
- * @property {boolean} [filterEmptyResults] - If true, filters out results with no contents. Default is true.
- * @property {number} [subpages] - The number of subpages to return for each result, where each subpage is derived from an internal link for the result.
- * @property {string | string[]} [subpageTarget] - Text used to match/rank subpages in the returned subpage list. You could use "about" to get *about* page for websites. Note that this is a fuzzy matcher.
- * @property {ExtrasOptions} [extras] - Miscelleneous data derived from results
- */
-type ContentsOptions = {
-    text?: TextContentsOptions | true;
-    highlights?: HighlightsContentsOptions | true;
-    summary?: SummaryContentsOptions | true;
-    livecrawl?: LivecrawlOptions;
-    context?: ContextOptions | true;
-    livecrawlTimeout?: number;
-    filterEmptyResults?: boolean;
-    subpages?: number;
-    subpageTarget?: string | string[];
-    extras?: ExtrasOptions;
-} & (typeof isBeta extends true ? {} : {});
 /**
  * Options for livecrawling contents
  * @typedef {string} LivecrawlOptions
@@ -2938,20 +3059,6 @@ type TextContentsOptions = {
     maxCharacters?: number;
     includeHtmlTags?: boolean;
 };
-/**
- * Options for retrieving highlights from page.
- * NOTE: For search type "deep", these options will not be respected. Highlights will be generated with respect
- * to your initial query, and may vary in quantity and length.
- * @typedef {Object} HighlightsContentsOptions
- * @property {string} [query] - The query string to use for highlights search.
- * @property {number} [numSentences] - The number of sentences to return for each highlight.
- * @property {number} [highlightsPerUrl] - The number of highlights to return for each URL.
- */
-type HighlightsContentsOptions = {
-    query?: string;
-    numSentences?: number;
-    highlightsPerUrl?: number;
-};
 /**
  * Options for retrieving summary from page.
  * @typedef {Object} SummaryContentsOptions
@@ -2982,15 +3089,6 @@ type ContextOptions = {
 type TextResponse = {
     text: string;
 };
-/**
- * @typedef {Object} HighlightsResponse
- * @property {string[]} highlights - The highlights as an array of strings.
- * @property {number[]} highlightScores - The corresponding scores as an array of floats, 0 to 1
- */
-type HighlightsResponse = {
-    highlights: string[];
-    highlightScores: number[];
-};
 /**
  * @typedef {Object} SummaryResponse
  * @property {string} summary - The generated summary of the page content.
@@ -3019,22 +3117,20 @@ type SubpagesResponse<T extends ContentsOptions> = {
 type Default<T extends {}, U> = [keyof T] extends [never] ? U : T;
 /**
  * @typedef {Object} ContentsResultComponent
- * Depending on 'ContentsOptions', this yields a combination of 'TextResponse', 'HighlightsResponse', 'SummaryResponse', or an empty object.
+ * Depending on 'ContentsOptions', this yields a combination of 'TextResponse', 'SummaryResponse', or an empty object.
  *
  * @template T - A type extending from 'ContentsOptions'.
  */
-type ContentsResultComponent<T extends ContentsOptions> = Default<(T["text"] extends object | true ? TextResponse : {}) & (T["highlights"] extends object | true ? HighlightsResponse : {}) & (T["summary"] extends object | true ? SummaryResponse : {}) & (T["subpages"] extends number ? SubpagesResponse<T> : {}) & (T["extras"] extends object ? ExtrasResponse : {}), TextResponse>;
+type ContentsResultComponent<T extends ContentsOptions> = (T["text"] extends object | true ? TextResponse : {}) & (T["summary"] extends object | true ? SummaryResponse : {}) & (T["subpages"] extends number ? SubpagesResponse<T> : {}) & (T["extras"] extends object ? ExtrasResponse : {});
 /**
  * Represents the cost breakdown related to contents retrieval. Fields are optional because
  * only non-zero costs are included.
  * @typedef {Object} CostDollarsContents
  * @property {number} [text] - The cost in dollars for retrieving text.
- * @property {number} [highlights] - The cost in dollars for retrieving highlights.
  * @property {number} [summary] - The cost in dollars for retrieving summary.
  */
 type CostDollarsContents = {
     text?: number;
-    highlights?: number;
     summary?: number;
 };
 /**
@@ -3087,7 +3183,6 @@ type SearchResult<T extends ContentsOptions> = {
  * @typedef {Object} SearchResponse
  * @property {Result[]} results - The list of search results.
  * @property {string} [context] - The context for the search.
- * @property {string} [autopromptString] - The autoprompt string, if applicable.
  * @property {string} [autoDate] - The autoprompt date, if applicable.
  * @property {string} requestId - The request ID for the search.
  * @property {CostDollars} [costDollars] - The cost breakdown for this request.
@@ -3095,7 +3190,6 @@ type SearchResult<T extends ContentsOptions> = {
 type SearchResponse<T extends ContentsOptions> = {
     results: SearchResult<T>[];
     context?: string;
-    autopromptString?: string;
     autoDate?: string;
     requestId: string;
     statuses?: Array<Status>;
@@ -3219,13 +3313,55 @@ declare class Exa {
     rawRequest(endpoint: string, method?: string, body?: Record<string, unknown>, queryParams?: Record<string, string | number | boolean | string[] | undefined>): Promise<Response>;
     /**
      * Performs a search with an Exa prompt-engineered query.
+     * By default, returns text contents. Use contents: false to opt-out.
+     *
+     * @param {string} query - The query string.
+     * @returns {Promise<SearchResponse<{ text: { maxCharacters: 10_000 } }>>} A list of relevant search results with text contents.
+     */
+    search(query: string): Promise<SearchResponse<{
+        text: {
+            maxCharacters: 10_000;
+        };
+    }>>;
+    /**
+     * Performs a search without contents.
+     *
+     * @param {string} query - The query string.
+     * @param {RegularSearchOptions & { contents: false }} options - Search options with contents explicitly disabled
+     * @returns {Promise<SearchResponse<{}>>} A list of relevant search results without contents.
+     */
+    search(query: string, options: RegularSearchOptions & {
+        contents: false | null | undefined;
+    }): Promise<SearchResponse<{}>>;
+    /**
+     * Performs a search with specific contents.
+     *
+     * @param {string} query - The query string.
+     * @param {RegularSearchOptions & { contents: T }} options - Search options with specific contents
+     * @returns {Promise<SearchResponse<T>>} A list of relevant search results with requested contents.
+     */
+    search<T extends ContentsOptions>(query: string, options: RegularSearchOptions & {
+        contents: T;
+    }): Promise<SearchResponse<T>>;
+    /**
+     * Performs a search with an Exa prompt-engineered query.
+     * When no contents option is specified, returns text contents by default.
      *
      * @param {string} query - The query string.
-     * @param {RegularSearchOptions} [options] - Additional search options
-     * @returns {Promise<SearchResponse<{}>>} A list of relevant search results.
+     * @param {Omit<RegularSearchOptions, 'contents'>} options - Search options without contents
+     * @returns {Promise<SearchResponse<{ text: true }>>} A list of relevant search results with text contents.
      */
-    search(query: string, options?: RegularSearchOptions): Promise<SearchResponse<{}>>;
+    search(query: string, options: Omit<RegularSearchOptions, "contents">): Promise<SearchResponse<{
+        text: true;
+    }>>;
     /**
+     * @deprecated Use `search()` instead. The search method now returns text contents by default.
+     *
+     * Migration examples:
+     * - `searchAndContents(query)` → `search(query)`
+     * - `searchAndContents(query, { text: true })` → `search(query, { contents: { text: true } })`
+     * - `searchAndContents(query, { summary: true })` → `search(query, { contents: { summary: true } })`
+     *
      * Performs a search with an Exa prompt-engineered query and returns the contents of the documents.
      *
      * @param {string} query - The query string.
@@ -3235,12 +3371,55 @@ declare class Exa {
     searchAndContents<T extends ContentsOptions>(query: string, options?: RegularSearchOptions & T): Promise<SearchResponse<T>>;
     /**
      * Finds similar links to the provided URL.
+     * By default, returns text contents. Use contents: false to opt-out.
+     *
+     * @param {string} url - The URL for which to find similar links.
+     * @returns {Promise<SearchResponse<{ text: { maxCharacters: 10_000 } }>>} A list of similar search results with text contents.
+     */
+    findSimilar(url: string): Promise<SearchResponse<{
+        text: {
+            maxCharacters: 10_000;
+        };
+    }>>;
+    /**
+     * Finds similar links to the provided URL without contents.
+     *
+     * @param {string} url - The URL for which to find similar links.
+     * @param {FindSimilarOptions & { contents: false }} options - Options with contents explicitly disabled
+     * @returns {Promise<SearchResponse<{}>>} A list of similar search results without contents.
+     */
+    findSimilar(url: string, options: FindSimilarOptions & {
+        contents: false | null | undefined;
+    }): Promise<SearchResponse<{}>>;
+    /**
+     * Finds similar links to the provided URL with specific contents.
+     *
+     * @param {string} url - The URL for which to find similar links.
+     * @param {FindSimilarOptions & { contents: T }} options - Options with specific contents
+     * @returns {Promise<SearchResponse<T>>} A list of similar search results with requested contents.
+     */
+    findSimilar<T extends ContentsOptions>(url: string, options: FindSimilarOptions & {
+        contents: T;
+    }): Promise<SearchResponse<T>>;
+    /**
+     * Finds similar links to the provided URL.
+     * When no contents option is specified, returns text contents by default.
+     *
      * @param {string} url - The URL for which to find similar links.
-     * @param {FindSimilarOptions} [options] - Additional options for finding similar links.
-     * @returns {Promise<SearchResponse<{}>>} A list of similar search results.
+     * @param {Omit<FindSimilarOptions, 'contents'>} options - Options without contents
+     * @returns {Promise<SearchResponse<{ text: true }>>} A list of similar search results with text contents.
      */
-    findSimilar(url: string, options?: FindSimilarOptions): Promise<SearchResponse<{}>>;
+    findSimilar(url: string, options: Omit<FindSimilarOptions, "contents">): Promise<SearchResponse<{
+        text: true;
+    }>>;
     /**
+     * @deprecated Use `findSimilar()` instead. The findSimilar method now returns text contents by default.
+     *
+     * Migration examples:
+     * - `findSimilarAndContents(url)` → `findSimilar(url)`
+     * - `findSimilarAndContents(url, { text: true })` → `findSimilar(url, { contents: { text: true } })`
+     * - `findSimilarAndContents(url, { summary: true })` → `findSimilar(url, { contents: { summary: true } })`
+     *
      * Finds similar links to the provided URL and returns the contents of the documents.
      * @param {string} url - The URL for which to find similar links.
      * @param {FindSimilarOptions & T} [options] - Additional options for finding similar links + contents.
@@ -3320,4 +3499,4 @@ declare class Exa {
     private parseSSEStream;
 }
 
-export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, type CreateWebsetSearchParameters, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type ListResearchRequest, type ListResearchResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type PreviewWebsetParameters, type PreviewWebsetResponse, type RegularSearchOptions, type Research, type ResearchCreateParamsTyped, type ResearchCreateRequest, type ResearchCreateResponse, type ResearchDefinitionEvent, type ResearchEvent, type ResearchOperation, type ResearchOutputEvent, type ResearchPaperEntity, type ResearchPlanDefinitionEvent, type ResearchPlanOperationEvent, type ResearchPlanOutputEvent, type ResearchStatus, type ResearchStreamEvent, type ResearchStreamEventTyped, type ResearchTaskDefinitionEvent, type ResearchTaskOperationEvent, type ResearchTaskOutputEvent, type ResearchTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateEnrichmentParameters, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, WebsetExcludeSource, type WebsetHeadersLike, WebsetImportSource, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchScopeSource, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };
+export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, type CreateWebsetSearchParameters, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type ListResearchRequest, type ListResearchResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type PreviewWebsetParameters, type PreviewWebsetResponse, type RegularSearchOptions, type Research, type ResearchCreateParamsTyped, type ResearchCreateRequest, type ResearchCreateResponse, type ResearchDefinitionEvent, type ResearchEvent, type ResearchOperation, type ResearchOutputEvent, type ResearchPaperEntity, type ResearchPlanDefinitionEvent, type ResearchPlanOperationEvent, type ResearchPlanOutputEvent, type ResearchStatus, type ResearchStreamEvent, type ResearchStreamEventTyped, type ResearchTaskDefinitionEvent, type ResearchTaskOperationEvent, type ResearchTaskOutputEvent, type ResearchTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateEnrichmentParameters, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, WebsetExcludeSource, type WebsetHeadersLike, WebsetImportSource, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchScopeSource, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };