exa-js 1.9.1 → 1.9.2

package/dist/index.d.mts

@@ -1,585 +1,808 @@
 import { ZodSchema } from 'zod';
 
-/**
- * Base client for Websets API
- */
-
-/**
- * Type for API query parameters
- */
-type QueryParams$1 = Record<string, string | number | boolean | string[] | undefined>;
-/**
- * Type for API request body
- */
-interface RequestBody$1 {
-    [key: string]: unknown;
-}
-/**
- * Common pagination parameters
- */
-interface PaginationParams {
-    /**
-     * Cursor for pagination
-     */
-    cursor?: string;
-    /**
-     * Maximum number of items per page
-     */
-    limit?: number;
-}
-/**
- * Base client class for all Websets-related API clients
- */
-declare class WebsetsBaseClient {
-    protected client: Exa;
-    /**
-     * Initialize a new Websets base client
-     * @param client The Exa client instance
-     */
-    constructor(client: Exa);
-    /**
-     * Make a request to the Websets API
-     * @param endpoint The endpoint path
-     * @param method The HTTP method
-     * @param data Optional request body data
-     * @param params Optional query parameters
-     * @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, headers?: Record<string, string>): Promise<T>;
-    /**
-     * Helper to build pagination parameters
-     * @param pagination The pagination parameters
-     * @returns QueryParams object with pagination parameters
-     */
-    protected buildPaginationParams(pagination?: PaginationParams): QueryParams$1;
-}
-
 interface components$1 {
     schemas: {
-        /** Article */
-        ArticleEntity: {
-            /**
-             * @default article
-             * @constant
-             */
-            type: "article";
-        };
-        /** Company */
-        CompanyEntity: {
-            /**
-             * @default company
-             * @constant
-             */
-            type: "company";
-        };
-        CreateCriterionParameters: {
-            /** @description The description of the criterion */
-            description: string;
+        ListResearchResponseDto: {
+            /** @description The list of research requests */
+            data: components$1["schemas"]["ResearchDtoClass"][];
+            /** @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;
         };
-        CreateEnrichmentParameters: {
-            /** @description Provide a description of the enrichment task you want to perform to each Webset Item. */
-            description: string;
+        ResearchCreateRequestDtoClass: {
+            /** @description Instructions for what research should be conducted */
+            instructions: string;
             /**
-             * @description Format of the enrichment response.
-             *
-             *     We automatically select the best format based on the description. If you want to explicitly specify the format, you can do so here.
+             * @default exa-research
              * @enum {string}
              */
-            format?: CreateEnrichmentParametersFormat;
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata?: {
-                [key: string]: string;
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
             };
-            /** @description When the format is options, the different options for the enrichment agent to choose from. */
-            options?: {
-                /** @description The label of the option */
-                label: string;
-            }[];
         };
-        CreateImportParameters: {
-            /** @description The number of records to import */
-            count: number;
-            /** @description When format is `csv`, these are the specific import parameters. */
-            csv?: {
-                /** @description Column containing the key identifier for the entity (e.g. URL, Name, etc.). If not provided, we will try to infer it from the file. */
-                identifier?: number;
-            };
-            /** @description What type of entity the import contains (e.g. People, Companies, etc.), and thus should be attempted to be resolved as. */
-            entity: components$1["schemas"]["CompanyEntity"] | components$1["schemas"]["PersonEntity"] | components$1["schemas"]["ArticleEntity"] | components$1["schemas"]["ResearchPaperEntity"] | components$1["schemas"]["CustomEntity"];
+        ResearchDtoClass: {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
-             * @description When the import is in CSV format, we expect a column containing the key identifier for the entity - for now URL. If not provided, import will fail to be processed.
+             * @description The model used for the research request
+             * @default exa-research
              * @enum {string}
              */
-            format: CreateImportParametersFormat;
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata?: {
-                [key: string]: string;
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
             };
-            /** @description The size of the file in megabytes. Maximum size is 50 MB. */
-            size: number;
-            /** @description The title of the import */
-            title?: string;
-        };
-        /** @description The response to a successful import. Includes the upload URL and the upload valid until date. */
-        CreateImportResponse: {
-            /** @description The number of entities in the import */
-            count: number;
-            /**
-             * Format: date-time
-             * @description When the import was created
-             */
-            createdAt: string;
-            /** @description The type of entity the import contains. */
-            entity: components$1["schemas"]["Entity"];
-            /**
-             * Format: date-time
-             * @description When the import failed
-             */
-            failedAt: string | null;
-            /** @description A human readable message of the import failure */
-            failedMessage: string | null;
-            /**
-             * @description The reason the import failed
-             * @enum {string|null}
-             */
-            failedReason: CreateImportResponseFailedReason;
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "pending";
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            events?: components$1["schemas"]["ResearchEventDtoClass"][];
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
-             * @description The format of the import.
+             * @description The model used for the research request
+             * @default exa-research
              * @enum {string}
              */
-            format: CreateImportResponseFormat;
-            /** @description The unique identifier for the Import */
-            id: string;
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata: {
-                [key: string]: string;
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
+            };
+            /** @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?: components$1["schemas"]["ResearchEventDtoClass"][];
+            /** @description Milliseconds since epoch time */
+            finishedAt: number;
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
-             * @description The type of object
+             * @description The model used for the research request
+             * @default exa-research
              * @enum {string}
              */
-            object: CreateImportResponseObject;
+            model: "exa-research" | "exa-research-pro";
+            output: {
+                content: string;
+                parsed?: {
+                    [key: string]: unknown;
+                };
+            };
+            outputSchema?: {
+                [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?: components$1["schemas"]["ResearchEventDtoClass"][];
+            /** @description Milliseconds since epoch time */
+            finishedAt: number;
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
-             * @description The status of the Import
+             * @description The model used for the research request
+             * @default exa-research
              * @enum {string}
              */
-            status: CreateImportResponseStatus;
-            /** @description The title of the import */
-            title: string;
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
+            };
+            /** @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?: components$1["schemas"]["ResearchEventDtoClass"][];
+            /** @description Milliseconds since epoch time */
+            finishedAt: number;
+            /** @description The instructions given to this research request */
+            instructions: string;
             /**
-             * Format: date-time
-             * @description When the import was last updated
+             * @description The model used for the research request
+             * @default exa-research
+             * @enum {string}
              */
-            updatedAt: string;
-            /** @description The URL to upload the file to */
-            uploadUrl: string;
-            /** @description The date and time until the upload URL is valid. The upload URL will be valid for 1 hour. */
-            uploadValidUntil: string;
+            model: "exa-research" | "exa-research-pro";
+            outputSchema?: {
+                [key: string]: unknown;
+            };
+            /** @description The unique identifier for the research request */
+            researchId: string;
+            /** @enum {string} */
+            status: "failed";
         };
-        CreateMonitorParameters: {
-            /** @description Behavior to perform when monitor runs */
-            behavior: {
-                /** @description Specify the search parameters for the Monitor.
-                 *
-                 *     By default, the search parameters (query, entity and criteria) from the last search are used when no parameters are provided. */
-                config: {
-                    /**
-                     * @description The behaviour of the Search when it is added to a Webset.
-                     * @default append
-                     * @enum {string}
-                     */
-                    behavior: WebsetSearchBehavior;
-                    /** @description The maximum number of results to find */
-                    count: number;
-                    /** @description The criteria to search for. By default, the criteria from the last search is used. */
-                    criteria?: {
-                        description: string;
-                    }[];
-                    /**
-                     * Entity
-                     * @description The entity to search for. By default, the entity from the last search/import is used.
-                     */
-                    entity?: components$1["schemas"]["Entity"];
-                    /** @description The query to search for. By default, the query from the last search is used. */
-                    query?: string;
-                };
-                /**
-                 * @default search
-                 * @constant
-                 */
-                type: "search";
-            };
-            /** @description How often the monitor will run */
-            cadence: {
-                /** @description Cron expression for monitor cadence (must be a valid Unix cron with 5 fields). The schedule must trigger at most once per day. */
-                cron: string;
-                /**
-                 * @description IANA timezone (e.g., "America/New_York")
-                 * @default Etc/UTC
-                 */
-                timezone: string;
-            };
-            metadata?: {
-                [key: string]: string;
-            };
-            /** @description The id of the Webset */
-            websetId: string;
-        };
-        CreateWebhookParameters: {
-            /** @description The events to trigger the webhook */
-            events: EventType[];
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata?: {
-                [key: string]: string;
+        ResearchEventDtoClass: ({
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @enum {string} */
+            eventType: "research-definition";
+            instructions: string;
+            outputSchema?: {
+                [key: string]: unknown;
             };
-            /**
-             * Format: uri
-             * @description The URL to send the webhook to
-             */
-            url: string;
-        };
-        CreateWebsetParameters: {
-            /** @description Add enrichments to extract additional data from found items.
-             *
-             *     Enrichments automatically search for and extract specific information (like contact details, funding data, employee counts, etc.) from each item added to your Webset. */
-            enrichments?: components$1["schemas"]["CreateEnrichmentParameters"][];
-            /** @description The external identifier for the webset.
-             *
-             *     You can use this to reference the Webset by your own internal identifiers. */
-            externalId?: string;
-            /** @description Import data from existing Websets and Imports into this Webset. */
-            import?: {
-                /** @description The ID of the source to search. */
-                id: string;
+            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} */
-                source: WebsetImportSource;
-            }[];
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata?: {
-                [key: string]: string;
+                outputType: "completed";
+                parsed?: {
+                    [key: string]: unknown;
+                };
+            } | {
+                error: string;
+                /** @enum {string} */
+                outputType: "failed";
             };
-            /** @description Create initial search for the Webset. */
-            search?: {
-                /**
-                 * @description Number of Items the Webset will attempt to find.
-                 *
-                 *     The actual number of Items found may be less than this number depending on the search complexity.
-                 * @default 10
-                 */
-                count: number;
-                /** @description Criteria every item is evaluated against.
-                 *
-                 *     It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query. Only use this when you need more fine control. */
-                criteria?: components$1["schemas"]["CreateCriterionParameters"][];
-                /** @description Entity the Webset will return results for.
-                 *
-                 *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
-                entity?: components$1["schemas"]["Entity"];
-                /** @description Sources (existing imports or websets) to exclude from search results. Any results found within these sources will be omitted to prevent finding them during search. */
-                exclude?: {
-                    /** @description The ID of the source to exclude. */
-                    id: string;
-                    /** @enum {string} */
-                    source: WebsetSearchExcludeSource;
-                }[];
-                /** @description Natural language search query describing what you are looking for.
-                 *
-                 *     Be specific and descriptive about your requirements, characteristics, and any constraints that help narrow down the results.
-                 *
-                 *     Any URLs provided will be crawled and used as additional context for the search. */
+            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: components$1["schemas"]["ResearchOperationDtoClass"];
+            /** @enum {string} */
+            eventType: "plan-operation";
+            operationId: string;
+            planId: string;
+            researchId: string;
+        } | {
+            /** @description Milliseconds since epoch time */
+            createdAt: number;
+            /** @enum {string} */
+            eventType: "plan-output";
+            output: components$1["schemas"]["ResearchOperationDtoClass"];
+            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;
-                /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
-                 *     Result of the analysis will be available in the `recall` field within the search request. */
-                recall?: boolean;
-                /** @description Limit the search to specific sources (existing imports or websets). Any results found within these sources matching the search criteria will be included in the Webset. */
-                scope?: {
-                    /** @description The ID of the source to search. */
-                    id: string;
-                    relationship?: {
-                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
-                        definition: string;
-                        limit: number;
-                    };
-                    /** @enum {string} */
-                    source: WebsetSearchScopeSource;
+                results: {
+                    url: string;
                 }[];
-            };
-        };
-        CreateWebsetSearchParameters: {
-            /**
-             * @description How this search interacts with existing items in the Webset:
-             *
-             *     - **override**: Replace existing items and evaluate all items against new criteria
-             *     - **append**: Add new items to existing ones, keeping items that match the new criteria
-             * @default override
-             */
-            behavior: WebsetSearchBehavior;
-            /** @description Number of Items the Search will attempt to find.
-             *
-             *     The actual number of Items found may be less than this number depending on the query complexity. */
-            count: number;
-            /** @description Criteria every item is evaluated against.
-             *
-             *     It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query. Only use this when you need more fine control. */
-            criteria?: components$1["schemas"]["CreateCriterionParameters"][];
-            /** @description Entity the search will return results for.
-             *
-             *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
-            entity?: components$1["schemas"]["Entity"];
-            /** @description Sources (existing imports or websets) to exclude from search results. Any results found within these sources will be omitted to prevent finding them during search. */
-            exclude?: {
-                /** @description The ID of the source to exclude. */
-                id: string;
                 /** @enum {string} */
-                source: WebsetSearchExcludeSource;
-            }[];
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata?: {
-                [key: string]: string;
-            };
-            /** @description Natural language search query describing what you are looking for.
-             *
-             *     Be specific and descriptive about your requirements, characteristics, and any constraints that help narrow down the results.
-             *
-             *     Any URLs provided will be crawled and used as additional context for the search. */
-            query: string;
-            /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
-             *     Result of the analysis will be available in the `recall` field within the search request. */
-            recall?: boolean;
-            /** @description Limit the search to specific sources (existing imports). Any results found within these sources matching the search criteria will be included in the Webset. */
-            scope?: {
-                /** @description The ID of the source to search. */
-                id: string;
-                relationship?: {
-                    /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
-                    definition: string;
-                    limit: number;
+                searchType: "neural" | "keyword" | "auto" | "fast";
+                /** @enum {string} */
+                type: "search";
+            } | {
+                goal?: string;
+                pageTokens: number;
+                result: {
+                    url: string;
                 };
                 /** @enum {string} */
-                source: WebsetSearchScopeSource;
-            }[];
-        };
-        /** Custom */
-        CustomEntity: {
-            description: string;
-            /**
-             * @default custom
-             * @constant
-             */
-            type: "custom";
-        };
-        EnrichmentResult: {
-            /** @description The id of the Enrichment that generated the result */
-            enrichmentId: string;
-            format: components$1["schemas"]["WebsetEnrichmentFormat"];
-            /**
-             * @default enrichment_result
-             * @constant
-             */
-            object: "enrichment_result";
-            /** @description The reasoning for the result when an Agent is used. */
-            reasoning: string | null;
-            /** @description The references used to generate the result. */
-            references: {
-                /** @description The relevant snippet of the reference content */
-                snippet: string | null;
-                /** @description The title of the reference */
-                title: string | null;
-                /**
-                 * Format: uri
-                 * @description The URL of the reference
-                 */
+                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;
+        });
+        ResearchOperationDtoClass: {
+            content: string;
+            /** @enum {string} */
+            type: "think";
+        } | {
+            goal?: string;
+            pageTokens: number;
+            query: string;
+            results: {
                 url: string;
             }[];
-            /** @description The result of the enrichment. */
-            result: string[] | null;
-            /**
-             * @description The status of the enrichment result.
-             * @enum {string}
-             */
-            status: EnrichmentResultStatus;
+            /** @enum {string} */
+            searchType: "neural" | "keyword" | "auto" | "fast";
+            /** @enum {string} */
+            type: "search";
+        } | {
+            goal?: string;
+            pageTokens: number;
+            result: {
+                url: string;
+            };
+            /** @enum {string} */
+            type: "crawl";
         };
-        Entity: components$1["schemas"]["CompanyEntity"] | components$1["schemas"]["PersonEntity"] | components$1["schemas"]["ArticleEntity"] | components$1["schemas"]["ResearchPaperEntity"] | components$1["schemas"]["CustomEntity"];
-        /** Event */
-        Event: {
-            /**
-             * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["Webset"];
-            /** @description The unique identifier for the event */
-            id: string;
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
+type Research = components$1["schemas"]["ResearchDtoClass"];
+type ResearchStatus = Research["status"];
+type ResearchEvent = components$1["schemas"]["ResearchEventDtoClass"];
+type ResearchOperation = components$1["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$1["schemas"]["ListResearchResponseDto"];
+type ResearchCreateRequest = components$1["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$1 = Record<string, string | number | boolean | string[] | undefined>;
+interface RequestBody$1 {
+    [key: string]: unknown;
+}
+declare class ResearchBaseClient {
+    protected client: Exa;
+    constructor(client: Exa);
+    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody$1, params?: QueryParams$1): Promise<T>;
+    protected rawRequest(endpoint: string, method?: string, data?: RequestBody$1, params?: QueryParams$1): Promise<Response>;
+    protected buildPaginationParams(pagination?: ListResearchRequest): QueryParams$1;
+}
+
+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";
+    }>;
+}
+
+/**
+ * Base client for Websets API
+ */
+
+/**
+ * Type for API query parameters
+ */
+type QueryParams = Record<string, string | number | boolean | string[] | undefined>;
+/**
+ * Type for API request body
+ */
+interface RequestBody {
+    [key: string]: unknown;
+}
+/**
+ * Common pagination parameters
+ */
+interface PaginationParams {
+    /**
+     * Cursor for pagination
+     */
+    cursor?: string;
+    /**
+     * Maximum number of items per page
+     */
+    limit?: number;
+}
+/**
+ * Base client class for all Websets-related API clients
+ */
+declare class WebsetsBaseClient {
+    protected client: Exa;
+    /**
+     * Initialize a new Websets base client
+     * @param client The Exa client instance
+     */
+    constructor(client: Exa);
+    /**
+     * Make a request to the Websets API
+     * @param endpoint The endpoint path
+     * @param method The HTTP method
+     * @param data Optional request body data
+     * @param params Optional query parameters
+     * @returns The response JSON
+     * @throws ExaError with API error details if the request fails
+     */
+    protected request<T = unknown>(endpoint: string, method?: string, data?: RequestBody, params?: QueryParams, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Helper to build pagination parameters
+     * @param pagination The pagination parameters
+     * @returns QueryParams object with pagination parameters
+     */
+    protected buildPaginationParams(pagination?: PaginationParams): QueryParams;
+}
+
+interface components {
+    schemas: {
+        /** Article */
+        ArticleEntity: {
             /**
-             * @default event
+             * @default article
              * @constant
              */
-            object: "event";
+            type: "article";
+        };
+        /** Company */
+        CompanyEntity: {
             /**
-             * @default webset.created
+             * @default company
              * @constant
              */
-            type: "webset.created";
-        } | {
-            /**
-             * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["Webset"];
-            /** @description The unique identifier for the event */
-            id: string;
-            /**
-             * @default event
-             * @constant
-             */
-            object: "event";
-            /**
-             * @default webset.deleted
-             * @constant
-             */
-            type: "webset.deleted";
-        } | {
-            /**
-             * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["Webset"];
-            /** @description The unique identifier for the event */
-            id: string;
-            /**
-             * @default event
-             * @constant
-             */
-            object: "event";
-            /**
-             * @default webset.idle
-             * @constant
-             */
-            type: "webset.idle";
-        } | {
-            /**
-             * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["Webset"];
-            /** @description The unique identifier for the event */
-            id: string;
-            /**
-             * @default event
-             * @constant
-             */
-            object: "event";
-            /**
-             * @default webset.paused
-             * @constant
-             */
-            type: "webset.paused";
-        } | {
-            /**
-             * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["WebsetItem"];
-            /** @description The unique identifier for the event */
-            id: string;
+            type: "company";
+        };
+        CreateCriterionParameters: {
+            /** @description The description of the criterion */
+            description: string;
+        };
+        CreateEnrichmentParameters: {
+            /** @description Provide a description of the enrichment task you want to perform to each Webset Item. */
+            description: string;
             /**
-             * @default event
-             * @constant
+             * @description Format of the enrichment response.
+             *
+             *     We automatically select the best format based on the description. If you want to explicitly specify the format, you can do so here.
+             * @enum {string}
              */
-            object: "event";
+            format?: CreateEnrichmentParametersFormat;
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata?: {
+                [key: string]: string;
+            };
+            /** @description When the format is options, the different options for the enrichment agent to choose from. */
+            options?: {
+                /** @description The label of the option */
+                label: string;
+            }[];
+        };
+        CreateImportParameters: {
+            /** @description The number of records to import */
+            count: number;
+            /** @description When format is `csv`, these are the specific import parameters. */
+            csv?: {
+                /** @description Column containing the key identifier for the entity (e.g. URL, Name, etc.). If not provided, we will try to infer it from the file. */
+                identifier?: number;
+            };
+            /** @description What type of entity the import contains (e.g. People, Companies, etc.), and thus should be attempted to be resolved as. */
+            entity: components["schemas"]["CompanyEntity"] | components["schemas"]["PersonEntity"] | components["schemas"]["ArticleEntity"] | components["schemas"]["ResearchPaperEntity"] | components["schemas"]["CustomEntity"];
             /**
-             * @default webset.item.created
-             * @constant
+             * @description When the import is in CSV format, we expect a column containing the key identifier for the entity - for now URL. If not provided, import will fail to be processed.
+             * @enum {string}
              */
-            type: "webset.item.created";
-        } | {
+            format: CreateImportParametersFormat;
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata?: {
+                [key: string]: string;
+            };
+            /** @description The size of the file in megabytes. Maximum size is 50 MB. */
+            size: number;
+            /** @description The title of the import */
+            title?: string;
+        };
+        /** @description The response to a successful import. Includes the upload URL and the upload valid until date. */
+        CreateImportResponse: {
+            /** @description The number of entities in the import */
+            count: number;
             /**
              * Format: date-time
-             * @description The date and time the event was created
+             * @description When the import was created
              */
             createdAt: string;
-            data: components$1["schemas"]["WebsetItem"];
-            /** @description The unique identifier for the event */
-            id: string;
-            /**
-             * @default event
-             * @constant
-             */
-            object: "event";
-            /**
-             * @default webset.item.enriched
-             * @constant
-             */
-            type: "webset.item.enriched";
-        } | {
+            /** @description The type of entity the import contains. */
+            entity: components["schemas"]["Entity"];
             /**
              * Format: date-time
-             * @description The date and time the event was created
-             */
-            createdAt: string;
-            data: components$1["schemas"]["WebsetSearch"];
-            /** @description The unique identifier for the event */
-            id: string;
-            /**
-             * @default event
-             * @constant
+             * @description When the import failed
              */
-            object: "event";
+            failedAt: string | null;
+            /** @description A human readable message of the import failure */
+            failedMessage: string | null;
             /**
-             * @default webset.search.created
-             * @constant
+             * @description The reason the import failed
+             * @enum {string|null}
              */
-            type: "webset.search.created";
-        } | {
+            failedReason: CreateImportResponseFailedReason;
             /**
-             * Format: date-time
-             * @description The date and time the event was created
+             * @description The format of the import.
+             * @enum {string}
              */
-            createdAt: string;
-            data: components$1["schemas"]["WebsetSearch"];
-            /** @description The unique identifier for the event */
+            format: CreateImportResponseFormat;
+            /** @description The unique identifier for the Import */
             id: string;
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata: {
+                [key: string]: string;
+            };
             /**
-             * @default event
-             * @constant
+             * @description The type of object
+             * @enum {string}
              */
-            object: "event";
+            object: CreateImportResponseObject;
             /**
-             * @default webset.search.updated
-             * @constant
+             * @description The status of the Import
+             * @enum {string}
              */
-            type: "webset.search.updated";
-        } | {
+            status: CreateImportResponseStatus;
+            /** @description The title of the import */
+            title: string;
             /**
              * Format: date-time
-             * @description The date and time the event was created
+             * @description When the import was last updated
              */
-            createdAt: string;
-            data: components$1["schemas"]["WebsetSearch"];
-            /** @description The unique identifier for the event */
-            id: string;
+            updatedAt: string;
+            /** @description The URL to upload the file to */
+            uploadUrl: string;
+            /** @description The date and time until the upload URL is valid. The upload URL will be valid for 1 hour. */
+            uploadValidUntil: string;
+        };
+        CreateMonitorParameters: {
+            /** @description Behavior to perform when monitor runs */
+            behavior: {
+                /** @description Specify the search parameters for the Monitor.
+                 *
+                 *     By default, the search parameters (query, entity and criteria) from the last search are used when no parameters are provided. */
+                config: {
+                    /**
+                     * @description The behaviour of the Search when it is added to a Webset.
+                     * @default append
+                     * @enum {string}
+                     */
+                    behavior: WebsetSearchBehavior;
+                    /** @description The maximum number of results to find */
+                    count: number;
+                    /** @description The criteria to search for. By default, the criteria from the last search is used. */
+                    criteria?: {
+                        description: string;
+                    }[];
+                    /**
+                     * Entity
+                     * @description The entity to search for. By default, the entity from the last search/import is used.
+                     */
+                    entity?: components["schemas"]["Entity"];
+                    /** @description The query to search for. By default, the query from the last search is used. */
+                    query?: string;
+                };
+                /**
+                 * @default search
+                 * @constant
+                 */
+                type: "search";
+            };
+            /** @description How often the monitor will run */
+            cadence: {
+                /** @description Cron expression for monitor cadence (must be a valid Unix cron with 5 fields). The schedule must trigger at most once per day. */
+                cron: string;
+                /**
+                 * @description IANA timezone (e.g., "America/New_York")
+                 * @default Etc/UTC
+                 */
+                timezone: string;
+            };
+            metadata?: {
+                [key: string]: string;
+            };
+            /** @description The id of the Webset */
+            websetId: string;
+        };
+        CreateWebhookParameters: {
+            /** @description The events to trigger the webhook */
+            events: EventType[];
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata?: {
+                [key: string]: string;
+            };
             /**
-             * @default event
-             * @constant
+             * Format: uri
+             * @description The URL to send the webhook to
              */
-            object: "event";
-            /**
-             * @default webset.search.canceled
-             * @constant
+            url: string;
+        };
+        CreateWebsetParameters: {
+            /** @description Add enrichments to extract additional data from found items.
+             *
+             *     Enrichments automatically search for and extract specific information (like contact details, funding data, employee counts, etc.) from each item added to your Webset. */
+            enrichments?: components["schemas"]["CreateEnrichmentParameters"][];
+            /** @description The external identifier for the webset.
+             *
+             *     You can use this to reference the Webset by your own internal identifiers. */
+            externalId?: string;
+            /** @description Import data from existing Websets and Imports into this Webset. */
+            import?: {
+                /** @description The ID of the source to search. */
+                id: string;
+                /** @enum {string} */
+                source: WebsetImportSource;
+            }[];
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata?: {
+                [key: string]: string;
+            };
+            /** @description Create initial search for the Webset. */
+            search?: {
+                /**
+                 * @description Number of Items the Webset will attempt to find.
+                 *
+                 *     The actual number of Items found may be less than this number depending on the search complexity.
+                 * @default 10
+                 */
+                count: number;
+                /** @description Criteria every item is evaluated against.
+                 *
+                 *     It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query. Only use this when you need more fine control. */
+                criteria?: components["schemas"]["CreateCriterionParameters"][];
+                /** @description Entity the Webset will return results for.
+                 *
+                 *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
+                entity?: components["schemas"]["Entity"];
+                /** @description Sources (existing imports or websets) to exclude from search results. Any results found within these sources will be omitted to prevent finding them during search. */
+                exclude?: {
+                    /** @description The ID of the source to exclude. */
+                    id: string;
+                    /** @enum {string} */
+                    source: WebsetSearchExcludeSource;
+                }[];
+                /** @description Natural language search query describing what you are looking for.
+                 *
+                 *     Be specific and descriptive about your requirements, characteristics, and any constraints that help narrow down the results.
+                 *
+                 *     Any URLs provided will be crawled and used as additional context for the search. */
+                query: string;
+                /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
+                 *     Result of the analysis will be available in the `recall` field within the search request. */
+                recall?: boolean;
+                /** @description Limit the search to specific sources (existing imports or websets). Any results found within these sources matching the search criteria will be included in the Webset. */
+                scope?: {
+                    /** @description The ID of the source to search. */
+                    id: string;
+                    relationship?: {
+                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
+                        definition: string;
+                        limit: number;
+                    };
+                    /** @enum {string} */
+                    source: WebsetSearchScopeSource;
+                }[];
+            };
+        };
+        CreateWebsetSearchParameters: {
+            /**
+             * @description How this search interacts with existing items in the Webset:
+             *
+             *     - **override**: Replace existing items and evaluate all items against new criteria
+             *     - **append**: Add new items to existing ones, keeping items that match the new criteria
+             * @default override
              */
-            type: "webset.search.canceled";
-        } | {
+            behavior: WebsetSearchBehavior;
+            /** @description Number of Items the Search will attempt to find.
+             *
+             *     The actual number of Items found may be less than this number depending on the query complexity. */
+            count: number;
+            /** @description Criteria every item is evaluated against.
+             *
+             *     It's not required to provide your own criteria, we automatically detect the criteria from all the information provided in the query. Only use this when you need more fine control. */
+            criteria?: components["schemas"]["CreateCriterionParameters"][];
+            /** @description Entity the search will return results for.
+             *
+             *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
+            entity?: components["schemas"]["Entity"];
+            /** @description Sources (existing imports or websets) to exclude from search results. Any results found within these sources will be omitted to prevent finding them during search. */
+            exclude?: {
+                /** @description The ID of the source to exclude. */
+                id: string;
+                /** @enum {string} */
+                source: WebsetSearchExcludeSource;
+            }[];
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata?: {
+                [key: string]: string;
+            };
+            /** @description Natural language search query describing what you are looking for.
+             *
+             *     Be specific and descriptive about your requirements, characteristics, and any constraints that help narrow down the results.
+             *
+             *     Any URLs provided will be crawled and used as additional context for the search. */
+            query: string;
+            /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
+             *     Result of the analysis will be available in the `recall` field within the search request. */
+            recall?: boolean;
+            /** @description Limit the search to specific sources (existing imports). Any results found within these sources matching the search criteria will be included in the Webset. */
+            scope?: {
+                /** @description The ID of the source to search. */
+                id: string;
+                relationship?: {
+                    /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
+                    definition: string;
+                    limit: number;
+                };
+                /** @enum {string} */
+                source: WebsetSearchScopeSource;
+            }[];
+        };
+        /** Custom */
+        CustomEntity: {
+            description: string;
+            /**
+             * @default custom
+             * @constant
+             */
+            type: "custom";
+        };
+        EnrichmentResult: {
+            /** @description The id of the Enrichment that generated the result */
+            enrichmentId: string;
+            format: components["schemas"]["WebsetEnrichmentFormat"];
+            /**
+             * @default enrichment_result
+             * @constant
+             */
+            object: "enrichment_result";
+            /** @description The reasoning for the result when an Agent is used. */
+            reasoning: string | null;
+            /** @description The references used to generate the result. */
+            references: {
+                /** @description The relevant snippet of the reference content */
+                snippet: string | null;
+                /** @description The title of the reference */
+                title: string | null;
+                /**
+                 * Format: uri
+                 * @description The URL of the reference
+                 */
+                url: string;
+            }[];
+            /** @description The result of the enrichment. */
+            result: string[] | null;
+            /**
+             * @description The status of the enrichment result.
+             * @enum {string}
+             */
+            status: EnrichmentResultStatus;
+        };
+        Entity: components["schemas"]["CompanyEntity"] | components["schemas"]["PersonEntity"] | components["schemas"]["ArticleEntity"] | components["schemas"]["ResearchPaperEntity"] | components["schemas"]["CustomEntity"];
+        /** Event */
+        Event: {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["WebsetSearch"];
+            data: components["schemas"]["Webset"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -588,17 +811,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default webset.search.completed
+             * @default webset.created
              * @constant
              */
-            type: "webset.search.completed";
+            type: "webset.created";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["Import"];
+            data: components["schemas"]["Webset"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -607,17 +830,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default import.created
+             * @default webset.deleted
              * @constant
              */
-            type: "import.created";
+            type: "webset.deleted";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["Import"];
+            data: components["schemas"]["Webset"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -626,17 +849,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default import.completed
+             * @default webset.idle
              * @constant
              */
-            type: "import.completed";
+            type: "webset.idle";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["Monitor"];
+            data: components["schemas"]["Webset"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -645,17 +868,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default monitor.created
+             * @default webset.paused
              * @constant
              */
-            type: "monitor.created";
+            type: "webset.paused";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["Monitor"];
+            data: components["schemas"]["WebsetItem"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -664,17 +887,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default monitor.updated
+             * @default webset.item.created
              * @constant
              */
-            type: "monitor.updated";
+            type: "webset.item.created";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["Monitor"];
+            data: components["schemas"]["WebsetItem"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -683,17 +906,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default monitor.deleted
+             * @default webset.item.enriched
              * @constant
              */
-            type: "monitor.deleted";
+            type: "webset.item.enriched";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["MonitorRun"];
+            data: components["schemas"]["WebsetSearch"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -702,17 +925,17 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default monitor.run.created
+             * @default webset.search.created
              * @constant
              */
-            type: "monitor.run.created";
+            type: "webset.search.created";
         } | {
             /**
              * Format: date-time
              * @description The date and time the event was created
              */
             createdAt: string;
-            data: components$1["schemas"]["MonitorRun"];
+            data: components["schemas"]["WebsetSearch"];
             /** @description The unique identifier for the event */
             id: string;
             /**
@@ -721,79 +944,250 @@ interface components$1 {
              */
             object: "event";
             /**
-             * @default monitor.run.completed
+             * @default webset.search.updated
              * @constant
              */
-            type: "monitor.run.completed";
-        };
-        /** @enum {string} */
-        EventType: EventType;
-        GetWebsetResponse: components$1["schemas"]["Webset"] & {
-            /** @description When expand query parameter contains `items`, this will contain the items in the webset */
-            items?: components$1["schemas"]["WebsetItem"][];
-        };
-        Import: {
-            /** @description The number of entities in the import */
-            count: number;
+            type: "webset.search.updated";
+        } | {
             /**
              * Format: date-time
-             * @description When the import was created
+             * @description The date and time the event was created
              */
             createdAt: string;
-            /** @description The type of entity the import contains. */
-            entity: components$1["schemas"]["Entity"];
+            data: components["schemas"]["WebsetSearch"];
+            /** @description The unique identifier for the event */
+            id: string;
             /**
-             * Format: date-time
-             * @description When the import failed
+             * @default event
+             * @constant
              */
-            failedAt: string | null;
-            /** @description A human readable message of the import failure */
-            failedMessage: string | null;
+            object: "event";
             /**
-             * @description The reason the import failed
-             * @enum {string|null}
+             * @default webset.search.canceled
+             * @constant
              */
-            failedReason: ImportFailedReason;
+            type: "webset.search.canceled";
+        } | {
             /**
-             * @description The format of the import.
-             * @enum {string}
+             * Format: date-time
+             * @description The date and time the event was created
              */
-            format: ImportFormat;
-            /** @description The unique identifier for the Import */
+            createdAt: string;
+            data: components["schemas"]["WebsetSearch"];
+            /** @description The unique identifier for the event */
             id: string;
-            /** @description Set of key-value pairs you want to associate with this object. */
-            metadata: {
-                [key: string]: string;
-            };
             /**
-             * @description The type of object
-             * @enum {string}
+             * @default event
+             * @constant
              */
-            object: ImportObject;
+            object: "event";
             /**
-             * @description The status of the Import
-             * @enum {string}
+             * @default webset.search.completed
+             * @constant
              */
-            status: ImportStatus;
-            /** @description The title of the import */
-            title: string;
+            type: "webset.search.completed";
+        } | {
             /**
              * Format: date-time
-             * @description When the import was last updated
+             * @description The date and time the event was created
              */
-            updatedAt: string;
-        };
-        ListEventsResponse: {
-            /** @description The list of events */
-            data: components$1["schemas"]["Event"][];
-            /** @description Whether there are more results to paginate through */
-            hasMore: boolean;
+            createdAt: string;
+            data: components["schemas"]["Import"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default import.created
+             * @constant
+             */
+            type: "import.created";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["Import"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default import.completed
+             * @constant
+             */
+            type: "import.completed";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["Monitor"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default monitor.created
+             * @constant
+             */
+            type: "monitor.created";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["Monitor"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default monitor.updated
+             * @constant
+             */
+            type: "monitor.updated";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["Monitor"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default monitor.deleted
+             * @constant
+             */
+            type: "monitor.deleted";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["MonitorRun"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default monitor.run.created
+             * @constant
+             */
+            type: "monitor.run.created";
+        } | {
+            /**
+             * Format: date-time
+             * @description The date and time the event was created
+             */
+            createdAt: string;
+            data: components["schemas"]["MonitorRun"];
+            /** @description The unique identifier for the event */
+            id: string;
+            /**
+             * @default event
+             * @constant
+             */
+            object: "event";
+            /**
+             * @default monitor.run.completed
+             * @constant
+             */
+            type: "monitor.run.completed";
+        };
+        /** @enum {string} */
+        EventType: EventType;
+        GetWebsetResponse: components["schemas"]["Webset"] & {
+            /** @description When expand query parameter contains `items`, this will contain the items in the webset */
+            items?: components["schemas"]["WebsetItem"][];
+        };
+        Import: {
+            /** @description The number of entities in the import */
+            count: number;
+            /**
+             * Format: date-time
+             * @description When the import was created
+             */
+            createdAt: string;
+            /** @description The type of entity the import contains. */
+            entity: components["schemas"]["Entity"];
+            /**
+             * Format: date-time
+             * @description When the import failed
+             */
+            failedAt: string | null;
+            /** @description A human readable message of the import failure */
+            failedMessage: string | null;
+            /**
+             * @description The reason the import failed
+             * @enum {string|null}
+             */
+            failedReason: ImportFailedReason;
+            /**
+             * @description The format of the import.
+             * @enum {string}
+             */
+            format: ImportFormat;
+            /** @description The unique identifier for the Import */
+            id: string;
+            /** @description Set of key-value pairs you want to associate with this object. */
+            metadata: {
+                [key: string]: string;
+            };
+            /**
+             * @description The type of object
+             * @enum {string}
+             */
+            object: ImportObject;
+            /**
+             * @description The status of the Import
+             * @enum {string}
+             */
+            status: ImportStatus;
+            /** @description The title of the import */
+            title: string;
+            /**
+             * Format: date-time
+             * @description When the import was last updated
+             */
+            updatedAt: string;
+        };
+        ListEventsResponse: {
+            /** @description The list of events */
+            data: components["schemas"]["Event"][];
+            /** @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;
         };
         ListImportsResponse: {
             /** @description The list of imports */
-            data: components$1["schemas"]["Import"][];
+            data: components["schemas"]["Import"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -801,7 +1195,7 @@ interface components$1 {
         };
         ListMonitorRunsResponse: {
             /** @description The list of monitor runs */
-            data: components$1["schemas"]["MonitorRun"][];
+            data: components["schemas"]["MonitorRun"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -809,7 +1203,7 @@ interface components$1 {
         };
         ListMonitorsResponse: {
             /** @description The list of monitors */
-            data: components$1["schemas"]["Monitor"][];
+            data: components["schemas"]["Monitor"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -817,7 +1211,7 @@ interface components$1 {
         };
         ListWebhookAttemptsResponse: {
             /** @description The list of webhook attempts */
-            data: components$1["schemas"]["WebhookAttempt"][];
+            data: components["schemas"]["WebhookAttempt"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -825,7 +1219,7 @@ interface components$1 {
         };
         ListWebhooksResponse: {
             /** @description The list of webhooks */
-            data: components$1["schemas"]["Webhook"][];
+            data: components["schemas"]["Webhook"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -833,7 +1227,7 @@ interface components$1 {
         };
         ListWebsetItemResponse: {
             /** @description The list of webset items */
-            data: components$1["schemas"]["WebsetItem"][];
+            data: components["schemas"]["WebsetItem"][];
             /** @description Whether there are more Items to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of Items */
@@ -841,7 +1235,7 @@ interface components$1 {
         };
         ListWebsetsResponse: {
             /** @description The list of websets */
-            data: components$1["schemas"]["Webset"][];
+            data: components["schemas"]["Webset"][];
             /** @description Whether there are more results to paginate through */
             hasMore: boolean;
             /** @description The cursor to paginate through the next set of results */
@@ -870,7 +1264,7 @@ interface components$1 {
                      * Entity
                      * @description The entity to search for. By default, the entity from the last search/import is used.
                      */
-                    entity?: components$1["schemas"]["Entity"];
+                    entity?: components["schemas"]["Entity"];
                     /** @description The query to search for. By default, the query from the last search is used. */
                     query?: string;
                 };
@@ -901,7 +1295,7 @@ interface components$1 {
              * MonitorRun
              * @description The last run of the monitor
              */
-            lastRun: components$1["schemas"]["MonitorRun"];
+            lastRun: components["schemas"]["MonitorRun"];
             /** @description Set of key-value pairs you want to associate with this object. */
             metadata: {
                 [key: string]: string;
@@ -950,7 +1344,7 @@ interface components$1 {
                  * Entity
                  * @description The entity to search for. By default, the entity from the last search/import is used.
                  */
-                entity?: components$1["schemas"]["Entity"];
+                entity?: components["schemas"]["Entity"];
                 /** @description The query to search for. By default, the query from the last search is used. */
                 query?: string;
             };
@@ -1029,7 +1423,7 @@ interface components$1 {
             /** @description Entity used to inform the decomposition.
              *
              *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
-            entity?: components$1["schemas"]["Entity"];
+            entity?: components["schemas"]["Entity"];
             /** @description Natural language search query describing what you are looking for.
              *
              *     Be specific and descriptive about your requirements, characteristics, and any constraints that help narrow down the results. */
@@ -1057,7 +1451,7 @@ interface components$1 {
                     description: string;
                 }[];
                 /** @description Detected entity from the query. */
-                entity: components$1["schemas"]["CompanyEntity"] | components$1["schemas"]["PersonEntity"] | components$1["schemas"]["ArticleEntity"] | components$1["schemas"]["ResearchPaperEntity"] | components$1["schemas"]["CustomEntity"];
+                entity: components["schemas"]["CompanyEntity"] | components["schemas"]["PersonEntity"] | components["schemas"]["ArticleEntity"] | components["schemas"]["ResearchPaperEntity"] | components["schemas"]["CustomEntity"];
             };
         };
         /** Research Paper */
@@ -1095,8 +1489,8 @@ interface components$1 {
             title?: string;
         };
         UpdateMonitor: {
-            behavior?: components$1["schemas"]["MonitorBehavior"];
-            cadence?: components$1["schemas"]["MonitorCadence"];
+            behavior?: components["schemas"]["MonitorBehavior"];
+            cadence?: components["schemas"]["MonitorCadence"];
             metadata?: {
                 [key: string]: string;
             };
@@ -1210,13 +1604,13 @@ interface components$1 {
              */
             createdAt: string;
             /** @description The Enrichments to apply to the Webset Items. */
-            enrichments: components$1["schemas"]["WebsetEnrichment"][];
+            enrichments: components["schemas"]["WebsetEnrichment"][];
             /** @description The external identifier for the webset */
             externalId: string | null;
             /** @description The unique identifier for the webset */
             id: string;
             /** @description Imports that have been performed on the webset. */
-            imports: components$1["schemas"]["Import"][];
+            imports: components["schemas"]["Import"][];
             /**
              * @description Set of key-value pairs you want to associate with this object.
              * @default {}
@@ -1225,14 +1619,14 @@ interface components$1 {
                 [key: string]: string;
             };
             /** @description The Monitors for the Webset. */
-            monitors: components$1["schemas"]["Monitor"][];
+            monitors: components["schemas"]["Monitor"][];
             /**
              * @default webset
              * @constant
              */
             object: "webset";
             /** @description The searches that have been performed on the webset. */
-            searches: components$1["schemas"]["WebsetSearch"][];
+            searches: components["schemas"]["WebsetSearch"][];
             /**
              * WebsetStatus
              * @description The status of the webset
@@ -1258,7 +1652,7 @@ interface components$1 {
             /** @description The description of the enrichment task provided during the creation of the enrichment. */
             description: string;
             /** @description The format of the enrichment response. */
-            format: components$1["schemas"]["WebsetEnrichmentFormat"];
+            format: components["schemas"]["WebsetEnrichmentFormat"];
             /** @description The unique identifier for the enrichment */
             id: string;
             /** @description The instructions for the enrichment Agent.
@@ -1312,9 +1706,9 @@ interface components$1 {
              */
             createdAt: string;
             /** @description The enrichments results of the Webset item */
-            enrichments: components$1["schemas"]["EnrichmentResult"][] | null;
+            enrichments: components["schemas"]["EnrichmentResult"][] | null;
             /** @description The criteria evaluations of the item */
-            evaluations: components$1["schemas"]["WebsetItemEvaluation"][];
+            evaluations: components["schemas"]["WebsetItemEvaluation"][];
             /** @description The unique identifier for the Webset Item */
             id: string;
             /**
@@ -1323,7 +1717,7 @@ interface components$1 {
              */
             object: "webset_item";
             /** @description The properties of the Item */
-            properties: components$1["schemas"]["WebsetItemPersonProperties"] | components$1["schemas"]["WebsetItemCompanyProperties"] | components$1["schemas"]["WebsetItemArticleProperties"] | components$1["schemas"]["WebsetItemResearchPaperProperties"] | components$1["schemas"]["WebsetItemCustomProperties"];
+            properties: components["schemas"]["WebsetItemPersonProperties"] | components["schemas"]["WebsetItemCompanyProperties"] | components["schemas"]["WebsetItemArticleProperties"] | components["schemas"]["WebsetItemResearchPaperProperties"] | components["schemas"]["WebsetItemCustomProperties"];
             /**
              * @description The source of the Item
              * @enum {string}
@@ -1542,7 +1936,7 @@ interface components$1 {
             /** @description The entity the search will return results for.
              *
              *     When no entity is provided during creation, we will automatically select the best entity based on the query. */
-            entity: components$1["schemas"]["Entity"];
+            entity: components["schemas"]["Entity"];
             /** @description Sources (existing imports or websets) used to omit certain results to be found during the search. */
             exclude: {
                 id: string;
@@ -1630,55 +2024,55 @@ interface components$1 {
     headers: never;
     pathItems: never;
 }
-type ArticleEntity = components$1["schemas"]["ArticleEntity"];
-type CompanyEntity = components$1["schemas"]["CompanyEntity"];
-type CreateCriterionParameters = components$1["schemas"]["CreateCriterionParameters"];
-type CreateEnrichmentParameters = components$1["schemas"]["CreateEnrichmentParameters"];
-type CreateImportParameters = components$1["schemas"]["CreateImportParameters"];
-type CreateImportResponse = components$1["schemas"]["CreateImportResponse"];
-type CreateMonitorParameters = components$1["schemas"]["CreateMonitorParameters"];
-type CreateWebhookParameters = components$1["schemas"]["CreateWebhookParameters"];
-type CreateWebsetParameters = components$1["schemas"]["CreateWebsetParameters"];
-type CreateWebsetSearchParameters = components$1["schemas"]["CreateWebsetSearchParameters"];
-type CustomEntity = components$1["schemas"]["CustomEntity"];
-type EnrichmentResult = components$1["schemas"]["EnrichmentResult"];
-type Entity = components$1["schemas"]["Entity"];
-type Event = components$1["schemas"]["Event"];
-type GetWebsetResponse = components$1["schemas"]["GetWebsetResponse"];
-type Import = components$1["schemas"]["Import"];
-type ListEventsResponse = components$1["schemas"]["ListEventsResponse"];
-type ListImportsResponse = components$1["schemas"]["ListImportsResponse"];
-type ListMonitorRunsResponse = components$1["schemas"]["ListMonitorRunsResponse"];
-type ListMonitorsResponse = components$1["schemas"]["ListMonitorsResponse"];
-type ListWebhookAttemptsResponse = components$1["schemas"]["ListWebhookAttemptsResponse"];
-type ListWebhooksResponse = components$1["schemas"]["ListWebhooksResponse"];
-type ListWebsetItemResponse = components$1["schemas"]["ListWebsetItemResponse"];
-type ListWebsetsResponse = components$1["schemas"]["ListWebsetsResponse"];
-type Monitor = components$1["schemas"]["Monitor"];
-type MonitorBehavior = components$1["schemas"]["MonitorBehavior"];
-type MonitorCadence = components$1["schemas"]["MonitorCadence"];
-type MonitorRun = components$1["schemas"]["MonitorRun"];
-type PersonEntity = components$1["schemas"]["PersonEntity"];
-type PreviewWebsetParameters = components$1["schemas"]["PreviewWebsetParameters"];
-type PreviewWebsetResponse = components$1["schemas"]["PreviewWebsetResponse"];
-type ResearchPaperEntity = components$1["schemas"]["ResearchPaperEntity"];
-type UpdateEnrichmentParameters = components$1["schemas"]["UpdateEnrichmentParameters"];
-type UpdateImport = components$1["schemas"]["UpdateImport"];
-type UpdateMonitor = components$1["schemas"]["UpdateMonitor"];
-type UpdateWebhookParameters = components$1["schemas"]["UpdateWebhookParameters"];
-type UpdateWebsetRequest = components$1["schemas"]["UpdateWebsetRequest"];
-type Webhook = components$1["schemas"]["Webhook"];
-type WebhookAttempt = components$1["schemas"]["WebhookAttempt"];
-type Webset = components$1["schemas"]["Webset"];
-type WebsetEnrichment = components$1["schemas"]["WebsetEnrichment"];
-type WebsetItem = components$1["schemas"]["WebsetItem"];
-type WebsetItemArticleProperties = components$1["schemas"]["WebsetItemArticleProperties"];
-type WebsetItemCompanyProperties = components$1["schemas"]["WebsetItemCompanyProperties"];
-type WebsetItemCustomProperties = components$1["schemas"]["WebsetItemCustomProperties"];
-type WebsetItemEvaluation = components$1["schemas"]["WebsetItemEvaluation"];
-type WebsetItemPersonProperties = components$1["schemas"]["WebsetItemPersonProperties"];
-type WebsetItemResearchPaperProperties = components$1["schemas"]["WebsetItemResearchPaperProperties"];
-type WebsetSearch = components$1["schemas"]["WebsetSearch"];
+type ArticleEntity = components["schemas"]["ArticleEntity"];
+type CompanyEntity = components["schemas"]["CompanyEntity"];
+type CreateCriterionParameters = components["schemas"]["CreateCriterionParameters"];
+type CreateEnrichmentParameters = components["schemas"]["CreateEnrichmentParameters"];
+type CreateImportParameters = components["schemas"]["CreateImportParameters"];
+type CreateImportResponse = components["schemas"]["CreateImportResponse"];
+type CreateMonitorParameters = components["schemas"]["CreateMonitorParameters"];
+type CreateWebhookParameters = components["schemas"]["CreateWebhookParameters"];
+type CreateWebsetParameters = components["schemas"]["CreateWebsetParameters"];
+type CreateWebsetSearchParameters = components["schemas"]["CreateWebsetSearchParameters"];
+type CustomEntity = components["schemas"]["CustomEntity"];
+type EnrichmentResult = components["schemas"]["EnrichmentResult"];
+type Entity = components["schemas"]["Entity"];
+type Event = components["schemas"]["Event"];
+type GetWebsetResponse = components["schemas"]["GetWebsetResponse"];
+type Import = components["schemas"]["Import"];
+type ListEventsResponse = components["schemas"]["ListEventsResponse"];
+type ListImportsResponse = components["schemas"]["ListImportsResponse"];
+type ListMonitorRunsResponse = components["schemas"]["ListMonitorRunsResponse"];
+type ListMonitorsResponse = components["schemas"]["ListMonitorsResponse"];
+type ListWebhookAttemptsResponse = components["schemas"]["ListWebhookAttemptsResponse"];
+type ListWebhooksResponse = components["schemas"]["ListWebhooksResponse"];
+type ListWebsetItemResponse = components["schemas"]["ListWebsetItemResponse"];
+type ListWebsetsResponse = components["schemas"]["ListWebsetsResponse"];
+type Monitor = components["schemas"]["Monitor"];
+type MonitorBehavior = components["schemas"]["MonitorBehavior"];
+type MonitorCadence = components["schemas"]["MonitorCadence"];
+type MonitorRun = components["schemas"]["MonitorRun"];
+type PersonEntity = components["schemas"]["PersonEntity"];
+type PreviewWebsetParameters = components["schemas"]["PreviewWebsetParameters"];
+type PreviewWebsetResponse = components["schemas"]["PreviewWebsetResponse"];
+type ResearchPaperEntity = components["schemas"]["ResearchPaperEntity"];
+type UpdateEnrichmentParameters = components["schemas"]["UpdateEnrichmentParameters"];
+type UpdateImport = components["schemas"]["UpdateImport"];
+type UpdateMonitor = components["schemas"]["UpdateMonitor"];
+type UpdateWebhookParameters = components["schemas"]["UpdateWebhookParameters"];
+type UpdateWebsetRequest = components["schemas"]["UpdateWebsetRequest"];
+type Webhook = components["schemas"]["Webhook"];
+type WebhookAttempt = components["schemas"]["WebhookAttempt"];
+type Webset = components["schemas"]["Webset"];
+type WebsetEnrichment = components["schemas"]["WebsetEnrichment"];
+type WebsetItem = components["schemas"]["WebsetItem"];
+type WebsetItemArticleProperties = components["schemas"]["WebsetItemArticleProperties"];
+type WebsetItemCompanyProperties = components["schemas"]["WebsetItemCompanyProperties"];
+type WebsetItemCustomProperties = components["schemas"]["WebsetItemCustomProperties"];
+type WebsetItemEvaluation = components["schemas"]["WebsetItemEvaluation"];
+type WebsetItemPersonProperties = components["schemas"]["WebsetItemPersonProperties"];
+type WebsetItemResearchPaperProperties = components["schemas"]["WebsetItemResearchPaperProperties"];
+type WebsetSearch = components["schemas"]["WebsetSearch"];
 declare enum CreateEnrichmentParametersFormat {
     text = "text",
     date = "date",
@@ -2230,1835 +2624,177 @@ declare class WebsetWebhooksClient extends WebsetsBaseClient {
     listAttempts(id: string, options?: ListWebhookAttemptsOptions): Promise<ListWebhookAttemptsResponse>;
     /**
      * Iterate through all attempts for a Webhook, handling pagination automatically
-     * @param id The ID of the Webhook
-     * @param options Pagination and filtering options
-     * @returns Async generator of Webhook attempts
-     */
-    listAllAttempts(id: string, options?: ListWebhookAttemptsOptions): AsyncGenerator<WebhookAttempt>;
-    /**
-     * Collect all attempts for a Webhook into an array
-     * @param id The ID of the Webhook
-     * @param options Pagination and filtering options
-     * @returns Promise resolving to an array of all Webhook attempts
-     */
-    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
- */
-
-/**
- * Options for listing Websets (API only supports pagination)
- */
-interface ListWebsetsOptions extends PaginationParams {
-}
-/**
- * Client for managing Websets
- */
-declare class WebsetsClient extends WebsetsBaseClient {
-    /**
-     * Client for managing Events
-     */
-    events: EventsClient;
-    /**
-     * Client for managing Imports
-     */
-    imports: ImportsClient;
-    /**
-     * Client for managing Webset Items
-     */
-    items: WebsetItemsClient;
-    /**
-     * Client for managing Webset Searches
-     */
-    searches: WebsetSearchesClient;
-    /**
-     * Client for managing Webset Enrichments
-     */
-    enrichments: WebsetEnrichmentsClient;
-    /**
-     * Client for managing Webset Monitors
-     */
-    monitors: WebsetMonitorsClient;
-    /**
-     * Client for managing Webset Webhooks
-     */
-    webhooks: WebsetWebhooksClient;
-    /**
-     * Initialize a new Websets client
-     * @param client The Exa client instance
-     */
-    constructor(client: Exa);
-    /**
-     * Create a new Webset
-     * @param params The Webset creation parameters
-     * @returns The created Webset
-     */
-    create(params: CreateWebsetParameters, options?: {
-        headers?: WebsetHeadersLike;
-    }): Promise<Webset>;
-    /**
-     * Preview a webset
-     * @param params The preview parameters
-     * @returns The preview response showing how the query will be decomposed
-     */
-    preview(params: PreviewWebsetParameters): Promise<PreviewWebsetResponse>;
-    /**
-     * Get a Webset by ID
-     * @param id The ID of the Webset
-     * @param expand Optional array of relations to expand
-     * @returns The Webset
-     */
-    get(id: string, expand?: Array<"items">): Promise<GetWebsetResponse>;
-    /**
-     * List all Websets
-     * @param options Pagination options (filtering by status is not supported by API)
-     * @returns The list of Websets
-     */
-    list(options?: ListWebsetsOptions): Promise<ListWebsetsResponse>;
-    /**
-     * Iterate through all Websets, handling pagination automatically
-     * @param options Pagination options
-     * @returns Async generator of Websets
-     */
-    listAll(options?: ListWebsetsOptions): AsyncGenerator<Webset>;
-    /**
-     * Collect all Websets into an array
-     * @param options Pagination options
-     * @returns Promise resolving to an array of all Websets
-     */
-    getAll(options?: ListWebsetsOptions): Promise<Webset[]>;
-    /**
-     * Update a Webset
-     * @param id The ID of the Webset
-     * @param params The Webset update parameters
-     * @returns The updated Webset
-     */
-    update(id: string, params: UpdateWebsetRequest): Promise<Webset>;
-    /**
-     * Delete a Webset
-     * @param id The ID of the Webset
-     * @returns The deleted Webset
-     */
-    delete(id: string): Promise<Webset>;
-    /**
-     * Cancel a running Webset
-     * @param id The ID or external ID of the Webset
-     * @returns The canceled Webset (as returned by the API)
-     */
-    cancel(id: string): Promise<Webset>;
-    /**
-     * Wait until a Webset is idle
-     * @param id The ID of the Webset
-     * @param options Configuration options for timeout and polling
-     * @returns The Webset once it becomes idle
-     * @throws Error if the Webset does not become idle within the timeout
-     */
-    waitUntilIdle(id: string, options?: {
-        timeout?: number;
-        pollInterval?: number;
-        onPoll?: (status: WebsetStatus) => void;
-    } | number): Promise<Webset>;
-}
-
-interface components {
-    schemas: {
-        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;
-        };
-        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";
-            /** @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";
-        };
-        ResearchEventDtoClass: ({
-            /** @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;
-        });
-        ResearchOperationDtoClass: {
-            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";
-        };
-    };
-    responses: never;
-    parameters: never;
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
+     * @param id The ID of the Webhook
+     * @param options Pagination and filtering options
+     * @returns Async generator of Webhook attempts
+     */
+    listAllAttempts(id: string, options?: ListWebhookAttemptsOptions): AsyncGenerator<WebhookAttempt>;
+    /**
+     * Collect all attempts for a Webhook into an array
+     * @param id The ID of the Webhook
+     * @param options Pagination and filtering options
+     * @returns Promise resolving to an array of all Webhook attempts
+     */
+    getAllAttempts(id: string, options?: ListWebhookAttemptsOptions): Promise<WebhookAttempt[]>;
 }
 
-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
+ * Websets API client
  */
-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;
+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>;
 }
 
-declare class ResearchClient extends ResearchBaseClient {
+/**
+ * Main client for Websets API
+ */
+
+/**
+ * Options for listing Websets (API only supports pagination)
+ */
+interface ListWebsetsOptions extends PaginationParams {
+}
+/**
+ * Client for managing Websets
+ */
+declare class WebsetsClient extends WebsetsBaseClient {
+    /**
+     * Client for managing Events
+     */
+    events: EventsClient;
+    /**
+     * Client for managing Imports
+     */
+    imports: ImportsClient;
+    /**
+     * Client for managing Webset Items
+     */
+    items: WebsetItemsClient;
+    /**
+     * Client for managing Webset Searches
+     */
+    searches: WebsetSearchesClient;
+    /**
+     * Client for managing Webset Enrichments
+     */
+    enrichments: WebsetEnrichmentsClient;
+    /**
+     * Client for managing Webset Monitors
+     */
+    monitors: WebsetMonitorsClient;
+    /**
+     * Client for managing Webset Webhooks
+     */
+    webhooks: WebsetWebhooksClient;
+    /**
+     * Initialize a new Websets client
+     * @param client The Exa client instance
+     */
     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?: {
+    /**
+     * Create a new Webset
+     * @param params The Webset creation parameters
+     * @returns The created Webset
+     */
+    create(params: CreateWebsetParameters, options?: {
+        headers?: WebsetHeadersLike;
+    }): Promise<Webset>;
+    /**
+     * Preview a webset
+     * @param params The preview parameters
+     * @returns The preview response showing how the query will be decomposed
+     */
+    preview(params: PreviewWebsetParameters): Promise<PreviewWebsetResponse>;
+    /**
+     * Get a Webset by ID
+     * @param id The ID of the Webset
+     * @param expand Optional array of relations to expand
+     * @returns The Webset
+     */
+    get(id: string, expand?: Array<"items">): Promise<GetWebsetResponse>;
+    /**
+     * List all Websets
+     * @param options Pagination options (filtering by status is not supported by API)
+     * @returns The list of Websets
+     */
+    list(options?: ListWebsetsOptions): Promise<ListWebsetsResponse>;
+    /**
+     * Iterate through all Websets, handling pagination automatically
+     * @param options Pagination options
+     * @returns Async generator of Websets
+     */
+    listAll(options?: ListWebsetsOptions): AsyncGenerator<Webset>;
+    /**
+     * Collect all Websets into an array
+     * @param options Pagination options
+     * @returns Promise resolving to an array of all Websets
+     */
+    getAll(options?: ListWebsetsOptions): Promise<Webset[]>;
+    /**
+     * Update a Webset
+     * @param id The ID of the Webset
+     * @param params The Webset update parameters
+     * @returns The updated Webset
+     */
+    update(id: string, params: UpdateWebsetRequest): Promise<Webset>;
+    /**
+     * Delete a Webset
+     * @param id The ID of the Webset
+     * @returns The deleted Webset
+     */
+    delete(id: string): Promise<Webset>;
+    /**
+     * Cancel a running Webset
+     * @param id The ID or external ID of the Webset
+     * @returns The canceled Webset (as returned by the API)
+     */
+    cancel(id: string): Promise<Webset>;
+    /**
+     * Wait until a Webset is idle
+     * @param id The ID of the Webset
+     * @param options Configuration options for timeout and polling
+     * @returns The Webset once it becomes idle
+     * @throws Error if the Webset does not become idle within the timeout
+     */
+    waitUntilIdle(id: string, options?: {
+        timeout?: number;
         pollInterval?: number;
-        timeoutMs?: number;
-        events?: boolean;
-        outputSchema: ZodSchema<T>;
-    }): Promise<ResearchTyped<T> & {
-        status: "completed" | "failed" | "canceled";
-    }>;
+        onPoll?: (status: WebsetStatus) => void;
+    } | number): Promise<Webset>;
 }
 
 /**