exa-js 1.8.26 → 1.9.0

package/dist/index.d.ts

@@ -46,7 +46,7 @@ declare class WebsetsBaseClient {
      * @returns The response JSON
      * @throws ExaError with API error details if the request fails
      */
-    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody$1, params?: QueryParams$1): Promise<T>;
+    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody$1, params?: QueryParams$1, headers?: Record<string, string>): Promise<T>;
     /**
      * Helper to build pagination parameters
      * @param pagination The pagination parameters
@@ -2023,37 +2023,6 @@ declare class WebsetMonitorsClient extends WebsetsBaseClient {
     delete(id: string): Promise<Monitor>;
 }
 
-/**
- * Client for managing Webset Searches
- */
-
-/**
- * Client for managing Webset Searches
- */
-declare class WebsetSearchesClient extends WebsetsBaseClient {
-    /**
-     * Create a new Search for the Webset
-     * @param websetId The ID of the Webset
-     * @param params The search parameters
-     * @returns The created Webset Search
-     */
-    create(websetId: string, params: CreateWebsetSearchParameters): Promise<WebsetSearch>;
-    /**
-     * Get a Search by ID
-     * @param websetId The ID of the Webset
-     * @param id The ID of the Search
-     * @returns The Webset Search
-     */
-    get(websetId: string, id: string): Promise<WebsetSearch>;
-    /**
-     * Cancel a running Search
-     * @param websetId The ID of the Webset
-     * @param id The ID of the Search
-     * @returns The canceled Webset Search
-     */
-    cancel(websetId: string, id: string): Promise<WebsetSearch>;
-}
-
 /**
  * Client for managing Webset Webhooks
  */
@@ -2146,6 +2115,47 @@ declare class WebsetWebhooksClient extends WebsetsBaseClient {
     getAllAttempts(id: string, options?: ListWebhookAttemptsOptions): Promise<WebhookAttempt[]>;
 }
 
+/**
+ * Websets API client
+ */
+
+type WebsetHeadersLike = {
+    "x-exa-websets-priority"?: "low" | "medium" | "high";
+} & Record<string, string>;
+
+/**
+ * Client for managing Webset Searches
+ */
+
+/**
+ * Client for managing Webset Searches
+ */
+declare class WebsetSearchesClient extends WebsetsBaseClient {
+    /**
+     * Create a new Search for the Webset
+     * @param websetId The ID of the Webset
+     * @param params The search parameters
+     * @returns The created Webset Search
+     */
+    create(websetId: string, params: CreateWebsetSearchParameters, options?: {
+        headers?: WebsetHeadersLike;
+    }): Promise<WebsetSearch>;
+    /**
+     * Get a Search by ID
+     * @param websetId The ID of the Webset
+     * @param id The ID of the Search
+     * @returns The Webset Search
+     */
+    get(websetId: string, id: string): Promise<WebsetSearch>;
+    /**
+     * Cancel a running Search
+     * @param websetId The ID of the Webset
+     * @param id The ID of the Search
+     * @returns The canceled Webset Search
+     */
+    cancel(websetId: string, id: string): Promise<WebsetSearch>;
+}
+
 /**
  * Main client for Websets API
  */
@@ -2197,7 +2207,9 @@ declare class WebsetsClient extends WebsetsBaseClient {
      * @param params The Webset creation parameters
      * @returns The created Webset
      */
-    create(params: CreateWebsetParameters): Promise<Webset>;
+    create(params: CreateWebsetParameters, options?: {
+        headers?: WebsetHeadersLike;
+    }): Promise<Webset>;
     /**
      * Preview a webset
      * @param params The preview parameters
@@ -2262,439 +2274,1544 @@ declare class WebsetsClient extends WebsetsBaseClient {
     } | number): Promise<Webset>;
 }
 
-type QueryParams = Record<string, string | number | boolean | string[] | undefined>;
-interface RequestBody {
-    [key: string]: unknown;
-}
-/**
- * Base client class for all Research-related API clients
- */
-declare class ResearchBaseClient {
-    protected client: Exa;
-    /**
-     * Initialize a new Research base client
-     * @param client The Exa client instance
-     */
-    constructor(client: Exa);
-    /**
-     * Make a request to the Research API (prefixes all paths with `/research`).
-     * @param endpoint The endpoint path, beginning with a slash (e.g. "/tasks").
-     * @param method The HTTP method. Defaults to "POST".
-     * @param data Optional request body
-     * @param params Optional query parameters
-     * @returns The parsed JSON response
-     */
-    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody, params?: QueryParams): Promise<T>;
-    /**
-     * Make a request to the Research API (prefixes all paths with `/research`).
-     * @param endpoint The endpoint path, beginning with a slash (e.g. "/tasks").
-     * @param method The HTTP method. Defaults to "POST".
-     * @param data Optional request body
-     * @param params Optional query parameters
-     * @returns The parsed JSON response
-     */
-    protected rawRequest(endpoint: string, method?: string, data?: RequestBody, params?: QueryParams): Promise<Response>;
-    /**
-     * Helper to build pagination parameters.
-     * @param pagination The pagination parameters
-     * @returns QueryParams object with pagination parameters
-     */
-    protected buildPaginationParams(pagination?: SchemaListResearchTasksRequestDto): QueryParams;
-}
-
-/**
- * Client for interacting with the Research Tasks API.
- */
-declare class ResearchClient extends ResearchBaseClient {
-    constructor(client: Exa);
-    /**
-     * Create a new research task with Zod schema for strongly typed output
-     */
-    createTask<T>(params: ResearchCreateTaskParamsTyped<ZodSchema<T>>): Promise<SchemaResearchCreateTaskResponseDto>;
-    /**
-     * Create a new research task.
-     *
-     * @param params Object containing:
-     *   - model: The research model to use (e.g., ResearchModel.ExaResearch).
-     *   - instructions: High-level guidance for the research agent.
-     *   - output: An object with a `schema` property (JSONSchema) that defines the expected output structure.
-     *
-     * @returns An object containing the unique ID of the created research task.
-     */
-    createTask(params: {
-        instructions: string;
-        model?: "exa-research" | "exa-research-pro";
-        output?: {
-            inferSchema?: boolean;
-            schema?: JSONSchema;
-        };
-    }): Promise<SchemaResearchCreateTaskResponseDto>;
-    /**
-     * Retrieve a research task by ID.
-     *
-     * Overloads:
-     *   - getTask(id)
-     *   - getTask(id, {stream: false})
-     *     => Promise<ResearchTask>
-     *   - getTask(id, {stream: true})
-     *     => AsyncGenerator<ResearchTaskEvent>
-     */
-    getTask(id: string): Promise<SchemaResearchTaskDto>;
-    getTask(id: string, options: {
-        stream?: false;
-    }): Promise<SchemaResearchTaskDto>;
-    getTask(id: string, options: {
-        stream: true;
-    }): Promise<AsyncGenerator<ResearchTaskEvent, any, any>>;
-    /**
-     * @deprecated This method is deprecated and may be removed in a future release.
-     * @see getTask(id, {stream: true})
-     * Poll a research task until completion or failure.
-     * Polls every 1 second with a maximum timeout of 10 minutes.
-     * Resilient to up to 10 consecutive polling failures.
-     */
-    pollTask(id: string): Promise<SchemaResearchTaskDto>;
-    /**
-     * List research tasks
-     * @param options Pagination options
-     * @returns The paginated list of research tasks
-     */
-    listTasks(options?: SchemaListResearchTasksRequestDto): Promise<SchemaListResearchTasksResponseDto>;
-}
-
 interface components {
     schemas: {
-        ListResearchTasksRequestDto: {
-            /** @description The cursor to paginate through the results */
-            cursor?: string;
-            /**
-             * @description The number of results to return
-             * @default 10
-             */
-            limit: number;
-        };
-        ListResearchTasksResponseDto: {
-            /** @description The list of research tasks */
-            data: components["schemas"]["ResearchTaskDto"][];
+        ListResearchResponseDto: {
+            /** @description The list of research requests */
+            data: ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @description The instructions given to this research request */
+                instructions: string;
+                /**
+                 * @description The model used for the research request
+                 * @default exa-research
+                 * @enum {string}
+                 */
+                model: "exa-research" | "exa-research-pro";
+                /** @description The unique identifier for the research request */
+                researchId: string;
+                /** @enum {string} */
+                status: "pending";
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                events?: (({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-definition";
+                    instructions: string;
+                    outputSchema?: {
+                        [key: string]: unknown;
+                    };
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-output";
+                    output: {
+                        content: string;
+                        costDollars: {
+                            numPages: number;
+                            numSearches: number;
+                            reasoningTokens: number;
+                            total: number;
+                        };
+                        /** @enum {string} */
+                        outputType: "completed";
+                        parsed?: {
+                            [key: string]: unknown;
+                        };
+                    } | {
+                        error: string;
+                        /** @enum {string} */
+                        outputType: "failed";
+                    };
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-definition";
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "plan-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-output";
+                    output: {
+                        /** @enum {string} */
+                        outputType: "tasks";
+                        reasoning: string;
+                        tasksInstructions: string[];
+                    } | {
+                        /** @enum {string} */
+                        outputType: "stop";
+                        reasoning: string;
+                    };
+                    planId: string;
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-definition";
+                    instructions: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "task-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-output";
+                    output: {
+                        content: string;
+                        /** @enum {string} */
+                        outputType: "completed";
+                    };
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                }))[];
+                /** @description The instructions given to this research request */
+                instructions: string;
+                /**
+                 * @description The model used for the research request
+                 * @default exa-research
+                 * @enum {string}
+                 */
+                model: "exa-research" | "exa-research-pro";
+                /** @description The unique identifier for the research request */
+                researchId: string;
+                /** @enum {string} */
+                status: "running";
+            } | {
+                costDollars: {
+                    numPages: number;
+                    numSearches: number;
+                    reasoningTokens: number;
+                    total: number;
+                };
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                events?: (({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-definition";
+                    instructions: string;
+                    outputSchema?: {
+                        [key: string]: unknown;
+                    };
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-output";
+                    output: {
+                        content: string;
+                        costDollars: {
+                            numPages: number;
+                            numSearches: number;
+                            reasoningTokens: number;
+                            total: number;
+                        };
+                        /** @enum {string} */
+                        outputType: "completed";
+                        parsed?: {
+                            [key: string]: unknown;
+                        };
+                    } | {
+                        error: string;
+                        /** @enum {string} */
+                        outputType: "failed";
+                    };
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-definition";
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "plan-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-output";
+                    output: {
+                        /** @enum {string} */
+                        outputType: "tasks";
+                        reasoning: string;
+                        tasksInstructions: string[];
+                    } | {
+                        /** @enum {string} */
+                        outputType: "stop";
+                        reasoning: string;
+                    };
+                    planId: string;
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-definition";
+                    instructions: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "task-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-output";
+                    output: {
+                        content: string;
+                        /** @enum {string} */
+                        outputType: "completed";
+                    };
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                }))[];
+                /** @description The instructions given to this research request */
+                instructions: string;
+                /**
+                 * @description The model used for the research request
+                 * @default exa-research
+                 * @enum {string}
+                 */
+                model: "exa-research" | "exa-research-pro";
+                output: {
+                    content: string;
+                    parsed?: {
+                        [key: string]: unknown;
+                    };
+                };
+                /** @description The unique identifier for the research request */
+                researchId: string;
+                /** @enum {string} */
+                status: "completed";
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                events?: (({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-definition";
+                    instructions: string;
+                    outputSchema?: {
+                        [key: string]: unknown;
+                    };
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-output";
+                    output: {
+                        content: string;
+                        costDollars: {
+                            numPages: number;
+                            numSearches: number;
+                            reasoningTokens: number;
+                            total: number;
+                        };
+                        /** @enum {string} */
+                        outputType: "completed";
+                        parsed?: {
+                            [key: string]: unknown;
+                        };
+                    } | {
+                        error: string;
+                        /** @enum {string} */
+                        outputType: "failed";
+                    };
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-definition";
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "plan-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-output";
+                    output: {
+                        /** @enum {string} */
+                        outputType: "tasks";
+                        reasoning: string;
+                        tasksInstructions: string[];
+                    } | {
+                        /** @enum {string} */
+                        outputType: "stop";
+                        reasoning: string;
+                    };
+                    planId: string;
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-definition";
+                    instructions: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "task-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-output";
+                    output: {
+                        content: string;
+                        /** @enum {string} */
+                        outputType: "completed";
+                    };
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                }))[];
+                /** @description The instructions given to this research request */
+                instructions: string;
+                /**
+                 * @description The model used for the research request
+                 * @default exa-research
+                 * @enum {string}
+                 */
+                model: "exa-research" | "exa-research-pro";
+                /** @description The unique identifier for the research request */
+                researchId: string;
+                /** @enum {string} */
+                status: "canceled";
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @description A message indicating why the request failed */
+                error: string;
+                events?: (({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-definition";
+                    instructions: string;
+                    outputSchema?: {
+                        [key: string]: unknown;
+                    };
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "research-output";
+                    output: {
+                        content: string;
+                        costDollars: {
+                            numPages: number;
+                            numSearches: number;
+                            reasoningTokens: number;
+                            total: number;
+                        };
+                        /** @enum {string} */
+                        outputType: "completed";
+                        parsed?: {
+                            [key: string]: unknown;
+                        };
+                    } | {
+                        error: string;
+                        /** @enum {string} */
+                        outputType: "failed";
+                    };
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-definition";
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "plan-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "plan-output";
+                    output: {
+                        /** @enum {string} */
+                        outputType: "tasks";
+                        reasoning: string;
+                        tasksInstructions: string[];
+                    } | {
+                        /** @enum {string} */
+                        outputType: "stop";
+                        reasoning: string;
+                    };
+                    planId: string;
+                    researchId: string;
+                }) | ({
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-definition";
+                    instructions: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    data: {
+                        content: string;
+                        /** @enum {string} */
+                        type: "think";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        query: string;
+                        results: {
+                            url: string;
+                        }[];
+                        /** @enum {string} */
+                        searchType: "neural" | "keyword" | "auto" | "fast";
+                        /** @enum {string} */
+                        type: "search";
+                    } | {
+                        goal?: string;
+                        pageTokens: number;
+                        result: {
+                            url: string;
+                        };
+                        /** @enum {string} */
+                        type: "crawl";
+                    };
+                    /** @enum {string} */
+                    eventType: "task-operation";
+                    operationId: string;
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                } | {
+                    /** @description Milliseconds since epoch time */
+                    createdAt: number;
+                    /** @enum {string} */
+                    eventType: "task-output";
+                    output: {
+                        content: string;
+                        /** @enum {string} */
+                        outputType: "completed";
+                    };
+                    planId: string;
+                    researchId: string;
+                    taskId: string;
+                }))[];
+                /** @description The instructions given to this research request */
+                instructions: string;
+                /**
+                 * @description The model used for the research request
+                 * @default exa-research
+                 * @enum {string}
+                 */
+                model: "exa-research" | "exa-research-pro";
+                /** @description The unique identifier for the research request */
+                researchId: string;
+                /** @enum {string} */
+                status: "failed";
+            })[];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
             nextCursor: string | null;
         };
-        ResearchCreateOpenAIResponseDto: {
-            input: string;
-            instructions?: string;
-            /** @enum {string} */
+        ResearchCreateRequestDtoClass: {
+            /** @description Instructions for what research should be conducted */
+            instructions: string;
+            /**
+             * @default exa-research
+             * @enum {string}
+             */
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
+            };
+        };
+        ResearchDtoClass: {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @description The instructions given to this research request */
+            instructions: string;
+            /**
+             * @description The model used for the research request
+             * @default exa-research
+             * @enum {string}
+             */
+            model: "exa-research" | "exa-research-pro";
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "pending";
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            events?: (({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-definition";
+                instructions: string;
+                outputSchema?: {
+                    [key: string]: unknown;
+                };
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-output";
+                output: {
+                    content: string;
+                    costDollars: {
+                        numPages: number;
+                        numSearches: number;
+                        reasoningTokens: number;
+                        total: number;
+                    };
+                    /** @enum {string} */
+                    outputType: "completed";
+                    parsed?: {
+                        [key: string]: unknown;
+                    };
+                } | {
+                    error: string;
+                    /** @enum {string} */
+                    outputType: "failed";
+                };
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-definition";
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "plan-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-output";
+                output: {
+                    /** @enum {string} */
+                    outputType: "tasks";
+                    reasoning: string;
+                    tasksInstructions: string[];
+                } | {
+                    /** @enum {string} */
+                    outputType: "stop";
+                    reasoning: string;
+                };
+                planId: string;
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-definition";
+                instructions: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "task-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-output";
+                output: {
+                    content: string;
+                    /** @enum {string} */
+                    outputType: "completed";
+                };
+                planId: string;
+                researchId: string;
+                taskId: string;
+            }))[];
+            /** @description The instructions given to this research request */
+            instructions: string;
+            /**
+             * @description The model used for the research request
+             * @default exa-research
+             * @enum {string}
+             */
+            model: "exa-research" | "exa-research-pro";
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "running";
+        } | {
+            costDollars: {
+                numPages: number;
+                numSearches: number;
+                reasoningTokens: number;
+                total: number;
+            };
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            events?: (({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-definition";
+                instructions: string;
+                outputSchema?: {
+                    [key: string]: unknown;
+                };
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-output";
+                output: {
+                    content: string;
+                    costDollars: {
+                        numPages: number;
+                        numSearches: number;
+                        reasoningTokens: number;
+                        total: number;
+                    };
+                    /** @enum {string} */
+                    outputType: "completed";
+                    parsed?: {
+                        [key: string]: unknown;
+                    };
+                } | {
+                    error: string;
+                    /** @enum {string} */
+                    outputType: "failed";
+                };
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-definition";
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "plan-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-output";
+                output: {
+                    /** @enum {string} */
+                    outputType: "tasks";
+                    reasoning: string;
+                    tasksInstructions: string[];
+                } | {
+                    /** @enum {string} */
+                    outputType: "stop";
+                    reasoning: string;
+                };
+                planId: string;
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-definition";
+                instructions: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "task-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-output";
+                output: {
+                    content: string;
+                    /** @enum {string} */
+                    outputType: "completed";
+                };
+                planId: string;
+                researchId: string;
+                taskId: string;
+            }))[];
+            /** @description The instructions given to this research request */
+            instructions: string;
+            /**
+             * @description The model used for the research request
+             * @default exa-research
+             * @enum {string}
+             */
+            model: "exa-research" | "exa-research-pro";
+            output: {
+                content: string;
+                parsed?: {
+                    [key: string]: unknown;
+                };
+            };
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "completed";
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            events?: (({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-definition";
+                instructions: string;
+                outputSchema?: {
+                    [key: string]: unknown;
+                };
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-output";
+                output: {
+                    content: string;
+                    costDollars: {
+                        numPages: number;
+                        numSearches: number;
+                        reasoningTokens: number;
+                        total: number;
+                    };
+                    /** @enum {string} */
+                    outputType: "completed";
+                    parsed?: {
+                        [key: string]: unknown;
+                    };
+                } | {
+                    error: string;
+                    /** @enum {string} */
+                    outputType: "failed";
+                };
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-definition";
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "plan-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-output";
+                output: {
+                    /** @enum {string} */
+                    outputType: "tasks";
+                    reasoning: string;
+                    tasksInstructions: string[];
+                } | {
+                    /** @enum {string} */
+                    outputType: "stop";
+                    reasoning: string;
+                };
+                planId: string;
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-definition";
+                instructions: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "task-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-output";
+                output: {
+                    content: string;
+                    /** @enum {string} */
+                    outputType: "completed";
+                };
+                planId: string;
+                researchId: string;
+                taskId: string;
+            }))[];
+            /** @description The instructions given to this research request */
+            instructions: string;
+            /**
+             * @description The model used for the research request
+             * @default exa-research
+             * @enum {string}
+             */
             model: "exa-research" | "exa-research-pro";
-            stream?: boolean;
-            text?: {
-                format?: {
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "canceled";
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @description A message indicating why the request failed */
+            error: string;
+            events?: (({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-definition";
+                instructions: string;
+                outputSchema?: {
+                    [key: string]: unknown;
+                };
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "research-output";
+                output: {
+                    content: string;
+                    costDollars: {
+                        numPages: number;
+                        numSearches: number;
+                        reasoningTokens: number;
+                        total: number;
+                    };
                     /** @enum {string} */
-                    type: "text";
-                } | {
-                    description?: string;
-                    name?: string;
-                    schema: {
+                    outputType: "completed";
+                    parsed?: {
                         [key: string]: unknown;
                     };
-                    strict?: boolean;
+                } | {
+                    error: string;
                     /** @enum {string} */
-                    type: "json_schema";
+                    outputType: "failed";
                 };
-            };
-        };
-        ResearchCreateTaskRequestDto: {
-            input?: {
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-definition";
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "plan-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "plan-output";
+                output: {
+                    /** @enum {string} */
+                    outputType: "tasks";
+                    reasoning: string;
+                    tasksInstructions: string[];
+                } | {
+                    /** @enum {string} */
+                    outputType: "stop";
+                    reasoning: string;
+                };
+                planId: string;
+                researchId: string;
+            }) | ({
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-definition";
                 instructions: string;
-            };
-            /** @description Instructions for what the research task should accomplish */
-            instructions?: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                data: {
+                    content: string;
+                    /** @enum {string} */
+                    type: "think";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    query: string;
+                    results: {
+                        url: string;
+                    }[];
+                    /** @enum {string} */
+                    searchType: "neural" | "keyword" | "auto" | "fast";
+                    /** @enum {string} */
+                    type: "search";
+                } | {
+                    goal?: string;
+                    pageTokens: number;
+                    result: {
+                        url: string;
+                    };
+                    /** @enum {string} */
+                    type: "crawl";
+                };
+                /** @enum {string} */
+                eventType: "task-operation";
+                operationId: string;
+                planId: string;
+                researchId: string;
+                taskId: string;
+            } | {
+                /** @description Milliseconds since epoch time */
+                createdAt: number;
+                /** @enum {string} */
+                eventType: "task-output";
+                output: {
+                    content: string;
+                    /** @enum {string} */
+                    outputType: "completed";
+                };
+                planId: string;
+                researchId: string;
+                taskId: string;
+            }))[];
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
+             * @description The model used for the research request
              * @default exa-research
              * @enum {string}
              */
             model: "exa-research" | "exa-research-pro";
-            output?: {
-                /**
-                 * @description When true and an output schema is omitted, an output schema will be intelligently generated. Otherwise, if this is false and there is no output schema, a generic markdown report will be generated.
-                 * @default true
-                 */
-                inferSchema: boolean;
-                /** @description A JsonSchema specification of the desired output. See https://json-schema.org/draft-07. */
-                schema?: unknown;
-            };
-        };
-        ResearchCreateTaskResponseDto: {
-            /** @description The unique identifier for the research task */
-            id: string;
-            outputSchema: {
-                [key: string]: unknown;
-            };
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "failed";
         };
-        ResearchTaskDto: {
-            /** @description Citations grouped by the root field they were used in */
-            citations?: {
-                [key: string]: {
-                    id: string;
-                    snippet: string;
-                    title?: string;
-                    url: string;
-                }[];
-            };
-            costDollars?: {
-                research: {
-                    pages: number;
-                    reasoningTokens: number;
-                    searches: number;
-                };
-                total: number;
-            };
-            /** @description The creation time of the research task in milliseconds since the Unix epoch */
+        ResearchEventDtoClass: ({
+            /** @description Milliseconds since epoch time */
             createdAt: number;
-            /** @description The research results data conforming to the specified schema */
-            data?: {
+            /** @enum {string} */
+            eventType: "research-definition";
+            instructions: string;
+            outputSchema?: {
                 [key: string]: unknown;
             };
-            /** @description The unique identifier for the research task */
-            id: string;
-            /** @description The instructions or query for the research task */
-            instructions: string;
+            researchId: string;
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
             /** @enum {string} */
-            model?: "exa-research" | "exa-research-pro";
-            operations: ({
-                stepId: string;
-                /** @description Agent generated plan or reasoning for upcoming actions. */
-                text: string;
+            eventType: "research-output";
+            output: {
+                content: string;
+                costDollars: {
+                    numPages: number;
+                    numSearches: number;
+                    reasoningTokens: number;
+                    total: number;
+                };
                 /** @enum {string} */
-                type: "step-plan";
-            } | {
-                /** @description A completed subfield */
-                data: {
+                outputType: "completed";
+                parsed?: {
                     [key: string]: unknown;
                 };
-                stepId: string;
+            } | {
+                error: string;
+                /** @enum {string} */
+                outputType: "failed";
+            };
+            researchId: string;
+        }) | ({
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @enum {string} */
+            eventType: "plan-definition";
+            planId: string;
+            researchId: string;
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            data: {
+                content: string;
                 /** @enum {string} */
-                type: "step-data";
+                type: "think";
             } | {
-                /** @description What the agent hopes to find with this search query */
                 goal?: string;
-                /** @description Search query used */
+                pageTokens: number;
                 query: string;
-                results?: {
-                    id: string;
-                    snippet: string;
-                    title?: string;
+                results: {
                     url: string;
-                    /** @enum {number} */
-                    version: 1;
                 }[];
-                stepId: string;
+                /** @enum {string} */
+                searchType: "neural" | "keyword" | "auto" | "fast";
                 /** @enum {string} */
                 type: "search";
             } | {
-                /** @description What the agent hopes to find with this crawl */
                 goal?: string;
-                stepId: string;
+                pageTokens: number;
+                result: {
+                    url: string;
+                };
                 /** @enum {string} */
                 type: "crawl";
-                url: string;
-            } | {
-                stepId: string;
-                /** @description Intermediate chain-of-thought style reasoning output */
-                thought: string;
-                /** @enum {string} */
-                type: "think";
-            })[];
-            /** @description The JSON schema specification for the expected output format */
-            schema?: {
-                [key: string]: unknown;
             };
-            /**
-             * @description The current status of the research task
-             * @enum {string}
-             */
-            status: "running" | "completed" | "failed";
-            timeMs?: number;
-        };
-        ResearchTaskEventDto: {
-            operation: {
-                stepId: string;
-                /** @description Agent generated plan or reasoning for upcoming actions. */
-                text: string;
+            /** @enum {string} */
+            eventType: "plan-operation";
+            operationId: string;
+            planId: string;
+            researchId: string;
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @enum {string} */
+            eventType: "plan-output";
+            output: {
                 /** @enum {string} */
-                type: "step-plan";
+                outputType: "tasks";
+                reasoning: string;
+                tasksInstructions: string[];
             } | {
-                /** @description A completed subfield */
-                data: {
-                    [key: string]: unknown;
-                };
-                stepId: string;
                 /** @enum {string} */
-                type: "step-data";
+                outputType: "stop";
+                reasoning: string;
+            };
+            planId: string;
+            researchId: string;
+        }) | ({
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @enum {string} */
+            eventType: "task-definition";
+            instructions: string;
+            planId: string;
+            researchId: string;
+            taskId: string;
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            data: {
+                content: string;
+                /** @enum {string} */
+                type: "think";
             } | {
-                /** @description What the agent hopes to find with this search query */
                 goal?: string;
-                /** @description Search query used */
+                pageTokens: number;
                 query: string;
-                results?: {
-                    id: string;
-                    snippet: string;
-                    title?: string;
+                results: {
                     url: string;
-                    /** @enum {number} */
-                    version: 1;
                 }[];
-                stepId: string;
+                /** @enum {string} */
+                searchType: "neural" | "keyword" | "auto" | "fast";
                 /** @enum {string} */
                 type: "search";
             } | {
-                /** @description What the agent hopes to find with this crawl */
                 goal?: string;
-                stepId: string;
+                pageTokens: number;
+                result: {
+                    url: string;
+                };
                 /** @enum {string} */
                 type: "crawl";
-                url: string;
-            } | {
-                stepId: string;
-                /** @description Intermediate chain-of-thought style reasoning output */
-                thought: string;
-                /** @enum {string} */
-                type: "think";
             };
             /** @enum {string} */
-            type: "operation";
+            eventType: "task-operation";
+            operationId: string;
+            planId: string;
+            researchId: string;
+            taskId: string;
         } | {
-            task: {
-                /** @description Citations grouped by the root field they were used in */
-                citations?: {
-                    [key: string]: {
-                        id: string;
-                        snippet: string;
-                        title?: string;
-                        url: string;
-                    }[];
-                };
-                costDollars?: {
-                    research: {
-                        pages: number;
-                        reasoningTokens: number;
-                        searches: number;
-                    };
-                    total: number;
-                };
-                /** @description The creation time of the research task in milliseconds since the Unix epoch */
-                createdAt: number;
-                /** @description The research results data conforming to the specified schema */
-                data?: {
-                    [key: string]: unknown;
-                };
-                /** @description The unique identifier for the research task */
-                id: string;
-                /** @description The instructions or query for the research task */
-                instructions: string;
-                /** @enum {string} */
-                model?: "exa-research" | "exa-research-pro";
-                operations: ({
-                    stepId: string;
-                    /** @description Agent generated plan or reasoning for upcoming actions. */
-                    text: string;
-                    /** @enum {string} */
-                    type: "step-plan";
-                } | {
-                    /** @description A completed subfield */
-                    data: {
-                        [key: string]: unknown;
-                    };
-                    stepId: string;
-                    /** @enum {string} */
-                    type: "step-data";
-                } | {
-                    /** @description What the agent hopes to find with this search query */
-                    goal?: string;
-                    /** @description Search query used */
-                    query: string;
-                    results?: {
-                        id: string;
-                        snippet: string;
-                        title?: string;
-                        url: string;
-                        /** @enum {number} */
-                        version: 1;
-                    }[];
-                    stepId: string;
-                    /** @enum {string} */
-                    type: "search";
-                } | {
-                    /** @description What the agent hopes to find with this crawl */
-                    goal?: string;
-                    stepId: string;
-                    /** @enum {string} */
-                    type: "crawl";
-                    url: string;
-                } | {
-                    stepId: string;
-                    /** @description Intermediate chain-of-thought style reasoning output */
-                    thought: string;
-                    /** @enum {string} */
-                    type: "think";
-                })[];
-                /** @description The JSON schema specification for the expected output format */
-                schema?: {
-                    [key: string]: unknown;
-                };
-                /**
-                 * @description The current status of the research task
-                 * @enum {string}
-                 */
-                status: "running" | "completed" | "failed";
-                timeMs?: number;
-            };
-            /** @enum {string} */
-            type: "completed";
-        };
-        ResearchTaskOperationDto: {
-            stepId: string;
-            /** @description Agent generated plan or reasoning for upcoming actions. */
-            text: string;
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
             /** @enum {string} */
-            type: "step-plan";
-        } | {
-            /** @description A completed subfield */
-            data: {
-                [key: string]: unknown;
+            eventType: "task-output";
+            output: {
+                content: string;
+                /** @enum {string} */
+                outputType: "completed";
             };
-            stepId: string;
+            planId: string;
+            researchId: string;
+            taskId: string;
+        });
+        ResearchOperationDtoClass: {
+            content: string;
             /** @enum {string} */
-            type: "step-data";
+            type: "think";
         } | {
-            /** @description What the agent hopes to find with this search query */
             goal?: string;
-            /** @description Search query used */
+            pageTokens: number;
             query: string;
-            results?: {
-                id: string;
-                snippet: string;
-                title?: string;
+            results: {
                 url: string;
-                /** @enum {number} */
-                version: 1;
             }[];
-            stepId: string;
+            /** @enum {string} */
+            searchType: "neural" | "keyword" | "auto" | "fast";
             /** @enum {string} */
             type: "search";
         } | {
-            /** @description What the agent hopes to find with this crawl */
             goal?: string;
-            stepId: string;
+            pageTokens: number;
+            result: {
+                url: string;
+            };
             /** @enum {string} */
             type: "crawl";
-            url: string;
-        } | {
-            stepId: string;
-            /** @description Intermediate chain-of-thought style reasoning output */
-            thought: string;
-            /** @enum {string} */
-            type: "think";
         };
     };
     responses: never;
@@ -2703,14 +3820,117 @@ interface components {
     headers: never;
     pathItems: never;
 }
-type SchemaListResearchTasksRequestDto = components["schemas"]["ListResearchTasksRequestDto"];
-type SchemaListResearchTasksResponseDto = components["schemas"]["ListResearchTasksResponseDto"];
-type SchemaResearchCreateTaskRequestDto = components["schemas"]["ResearchCreateTaskRequestDto"];
-type SchemaResearchCreateTaskResponseDto = components["schemas"]["ResearchCreateTaskResponseDto"];
-type SchemaResearchTaskDto = components["schemas"]["ResearchTaskDto"];
 
-type ResearchTaskEvent = components["schemas"]["ResearchTaskEventDto"];
-type ResearchTaskOperation = SchemaResearchTaskDto["operations"][0];
+type Research = components["schemas"]["ResearchDtoClass"];
+type ResearchStatus = Research["status"];
+type ResearchEvent = components["schemas"]["ResearchEventDtoClass"];
+type ResearchOperation = components["schemas"]["ResearchOperationDtoClass"];
+type DeepReplaceParsed<T, TData> = T extends {
+    parsed?: Record<string, unknown>;
+} ? Omit<T, "parsed"> & {
+    parsed: TData;
+} : T extends object ? {
+    [K in keyof T]: DeepReplaceParsed<T[K], TData>;
+} : T;
+type ResearchTyped<T> = DeepReplaceParsed<Research, T>;
+type ResearchStreamEventTyped<T> = DeepReplaceParsed<ResearchStreamEvent, T>;
+type ListResearchRequest = {
+    cursor?: string;
+    limit?: number;
+};
+type ListResearchResponse = components["schemas"]["ListResearchResponseDto"];
+type ResearchCreateRequest = components["schemas"]["ResearchCreateRequestDtoClass"];
+type ResearchCreateResponse = Research;
+type ResearchStreamEvent = ResearchEvent;
+/**
+ * Enhanced research creation params with zod schema support
+ */
+type ResearchCreateParamsTyped<T> = {
+    instructions: string;
+    model?: "exa-research" | "exa-research-pro";
+    outputSchema?: T;
+};
+type ResearchDefinitionEvent = Extract<ResearchEvent, {
+    eventType: "research-definition";
+}>;
+type ResearchOutputEvent = Extract<ResearchEvent, {
+    eventType: "research-output";
+}>;
+type ResearchPlanDefinitionEvent = Extract<ResearchEvent, {
+    eventType: "plan-definition";
+}>;
+type ResearchPlanOperationEvent = Extract<ResearchEvent, {
+    eventType: "plan-operation";
+}>;
+type ResearchPlanOutputEvent = Extract<ResearchEvent, {
+    eventType: "plan-output";
+}>;
+type ResearchTaskDefinitionEvent = Extract<ResearchEvent, {
+    eventType: "task-definition";
+}>;
+type ResearchTaskOperationEvent = Extract<ResearchEvent, {
+    eventType: "task-operation";
+}>;
+type ResearchTaskOutputEvent = Extract<ResearchEvent, {
+    eventType: "task-output";
+}>;
+
+type QueryParams = Record<string, string | number | boolean | string[] | undefined>;
+interface RequestBody {
+    [key: string]: unknown;
+}
+declare class ResearchBaseClient {
+    protected client: Exa;
+    constructor(client: Exa);
+    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody, params?: QueryParams): Promise<T>;
+    protected rawRequest(endpoint: string, method?: string, data?: RequestBody, params?: QueryParams): Promise<Response>;
+    protected buildPaginationParams(pagination?: ListResearchRequest): QueryParams;
+}
+
+declare class ResearchClient extends ResearchBaseClient {
+    constructor(client: Exa);
+    create<T>(params: ResearchCreateParamsTyped<ZodSchema<T>>): Promise<ResearchCreateResponse>;
+    create(params: {
+        instructions: string;
+        model?: "exa-research" | "exa-research-pro";
+        outputSchema?: Record<string, unknown>;
+    }): Promise<ResearchCreateResponse>;
+    get(researchId: string): Promise<Research>;
+    get(researchId: string, options: {
+        stream?: false;
+        events?: boolean;
+    }): Promise<Research>;
+    get<T>(researchId: string, options: {
+        stream?: false;
+        events?: boolean;
+        outputSchema: ZodSchema<T>;
+    }): Promise<ResearchTyped<T>>;
+    get(researchId: string, options: {
+        stream: true;
+        events?: boolean;
+    }): Promise<AsyncGenerator<ResearchStreamEvent, any, any>>;
+    get<T>(researchId: string, options: {
+        stream: true;
+        events?: boolean;
+        outputSchema?: ZodSchema<T>;
+    }): Promise<AsyncGenerator<ResearchStreamEvent, any, any>>;
+    list(options?: ListResearchRequest): Promise<ListResearchResponse>;
+    pollUntilFinished(researchId: string, options?: {
+        pollInterval?: number;
+        timeoutMs?: number;
+        events?: boolean;
+    }): Promise<Research & {
+        status: "completed" | "failed" | "canceled";
+    }>;
+    pollUntilFinished<T>(researchId: string, options?: {
+        pollInterval?: number;
+        timeoutMs?: number;
+        events?: boolean;
+        outputSchema: ZodSchema<T>;
+    }): Promise<ResearchTyped<T> & {
+        status: "completed" | "failed" | "canceled";
+    }>;
+}
 
 /**
  * HTTP status codes
@@ -3087,21 +4307,6 @@ type AnswerResponseTyped<T> = Omit<AnswerResponse, "answer"> & {
 type SummaryContentsOptionsTyped<T> = Omit<SummaryContentsOptions, "schema"> & {
     schema: T;
 };
-/**
- * Enhanced research task output options that accepts either JSON schema or Zod schema
- */
-type ResearchTaskOutputTyped<T> = {
-    inferSchema?: boolean;
-    schema: T;
-};
-/**
- * Enhanced research task creation params with zod schema support
- */
-type ResearchCreateTaskParamsTyped<T> = {
-    instructions: string;
-    model?: "exa-research" | "exa-research-pro";
-    output?: ResearchTaskOutputTyped<T>;
-};
 /**
  * The Exa class encapsulates the API's endpoints.
  */
@@ -3135,7 +4340,7 @@ declare class Exa {
      * @returns {Promise<any>} The response from the API.
      * @throws {ExaError} When any API request fails with structured error information
      */
-    request<T = unknown>(endpoint: string, method: string, body?: any, params?: Record<string, any>): Promise<T>;
+    request<T = unknown>(endpoint: string, method: string, body?: any, params?: Record<string, any>, headers?: Record<string, string>): Promise<T>;
     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.
@@ -3240,4 +4445,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, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, CreateWebsetSearchParametersScopeSource, 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 SchemaListResearchTasksRequestDto as ListResearchTasksRequest, type SchemaListResearchTasksResponseDto as ListResearchTasksResponse, 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, PreviewWebsetResponseEnrichmentsFormat, type RegularSearchOptions, ResearchClient, type ResearchCreateTaskParamsTyped, type SchemaResearchCreateTaskRequestDto as ResearchCreateTaskRequest, type SchemaResearchCreateTaskResponseDto as ResearchCreateTaskResponse, type ResearchPaperEntity, type SchemaResearchTaskDto as ResearchTask, type ResearchTaskEvent, type ResearchTaskOperation, type ResearchTaskOutputTyped, ScopeSourceType, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, 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, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, CreateWebsetSearchParametersScopeSource, 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, PreviewWebsetResponseEnrichmentsFormat, 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, ScopeSourceType, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetHeadersLike, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };