exa-js 1.8.18 → 1.8.20

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { ZodSchema } from 'zod';
+
 /**
  * Base client for Websets API
  */
@@ -287,7 +289,8 @@ interface components$1 {
                  *
                  *     Any URLs provided will be crawled and used as additional context for the search. */
                 query: string;
-                /** @description Whether to compute recall metrics for the search */
+                /** @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;
             };
         };
@@ -329,7 +332,8 @@ interface components$1 {
              *
              *     Any URLs provided will be crawled and used as additional context for the search. */
             query: string;
-            /** @description Whether to compute recall metrics for the search */
+            /** @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;
         };
         /** Custom */
@@ -358,7 +362,10 @@ interface components$1 {
                 snippet: string | null;
                 /** @description The title of the reference */
                 title: string | null;
-                /** @description The URL of the reference */
+                /**
+                 * Format: uri
+                 * @description The URL of the reference
+                 */
                 url: string;
             }[];
             /** @description The result of the enrichment. */
@@ -695,7 +702,7 @@ interface components$1 {
                      * @default append
                      * @enum {string}
                      */
-                    behavior: MonitorBehaviorConfigBehavior;
+                    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. */
@@ -775,7 +782,7 @@ interface components$1 {
                  * @default append
                  * @enum {string}
                  */
-                behavior: MonitorBehaviorConfigBehavior;
+                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. */
@@ -826,6 +833,8 @@ interface components$1 {
              * @description When the run failed
              */
             failedAt: string | null;
+            /** @description The reason the run failed */
+            failedReason: string | null;
             /** @description The unique identifier for the Monitor Run */
             id: string;
             /** @description The monitor that the run is associated with */
@@ -1020,6 +1029,8 @@ interface components$1 {
             status: WebsetStatus;
             /** @description The Streams for the Webset. */
             streams: unknown[];
+            /** @description The title of the webset */
+            title: string | null;
             /**
              * Format: date-time
              * @description The date and time the webset was updated
@@ -1214,7 +1225,10 @@ interface components$1 {
                 snippet: string | null;
                 /** @description The title of the reference */
                 title: string | null;
-                /** @description The URL of the reference */
+                /**
+                 * Format: uri
+                 * @description The URL of the reference
+                 */
                 url: string;
             }[];
             /**
@@ -1527,10 +1541,6 @@ declare enum MonitorStatus {
     enabled = "enabled",
     disabled = "disabled"
 }
-declare enum MonitorBehaviorConfigBehavior {
-    override = "override",
-    append = "append"
-}
 declare enum MonitorRunObject {
     monitor_run = "monitor_run"
 }
@@ -1538,7 +1548,8 @@ declare enum MonitorRunStatus {
     created = "created",
     running = "running",
     completed = "completed",
-    canceled = "canceled"
+    canceled = "canceled",
+    failed = "failed"
 }
 declare enum MonitorRunType {
     search = "search",
@@ -1796,6 +1807,15 @@ declare class ImportsClient extends WebsetsBaseClient {
  * Client for managing Webset Items
  */
 
+/**
+ * Options for listing webset items
+ */
+interface ListWebsetItemsOptions extends PaginationParams {
+    /**
+     * The id of the source to filter items by
+     */
+    sourceId?: string;
+}
 /**
  * Client for managing Webset Items
  */
@@ -1803,24 +1823,24 @@ declare class WebsetItemsClient extends WebsetsBaseClient {
     /**
      * List all Items for a Webset
      * @param websetId The ID of the Webset
-     * @param params - Optional pagination parameters
+     * @param params - Optional pagination and filtering parameters
      * @returns A promise that resolves with the list of Items
      */
-    list(websetId: string, params?: PaginationParams): Promise<ListWebsetItemResponse>;
+    list(websetId: string, params?: ListWebsetItemsOptions): Promise<ListWebsetItemResponse>;
     /**
      * Iterate through all Items in a Webset, handling pagination automatically
      * @param websetId The ID of the Webset
      * @param options Pagination options
      * @returns Async generator of Webset Items
      */
-    listAll(websetId: string, options?: PaginationParams): AsyncGenerator<WebsetItem>;
+    listAll(websetId: string, options?: ListWebsetItemsOptions): AsyncGenerator<WebsetItem>;
     /**
      * Collect all items from a Webset into an array
      * @param websetId The ID of the Webset
      * @param options Pagination options
      * @returns Promise resolving to an array of all Webset Items
      */
-    getAll(websetId: string, options?: PaginationParams): Promise<WebsetItem[]>;
+    getAll(websetId: string, options?: ListWebsetItemsOptions): Promise<WebsetItem[]>;
     /**
      * Get an Item by ID
      * @param websetId The ID of the Webset
@@ -1959,6 +1979,10 @@ interface ListWebhookAttemptsOptions extends PaginationParams {
      * The type of event to filter by
      */
     eventType?: EventType;
+    /**
+     * Filter attempts by their success status
+     */
+    successful?: boolean;
 }
 /**
  * Client for managing Webset Webhooks
@@ -2185,6 +2209,10 @@ declare class ResearchBaseClient {
  */
 declare class ResearchClient extends ResearchBaseClient {
     constructor(client: Exa);
+    /**
+     * Create a new research task with Zod schema for strongly typed output
+     */
+    createTask<T>(params: ResearchCreateTaskParamsTyped<ZodSchema<T>>): Promise<SchemaResearchCreateTaskResponseDto>;
     /**
      * Create a new research task.
      *
@@ -2738,29 +2766,12 @@ type HighlightsContentsOptions = {
  */
 type SummaryContentsOptions = {
     query?: string;
-    schema?: JSONSchema;
+    schema?: Record<string, unknown> | ZodSchema;
 };
 /**
- * Represents a JSON Schema definition used for structured summary output.
- * To learn more visit https://json-schema.org/overview/what-is-jsonschema.
+ * @deprecated Use Record<string, unknown> instead.
  */
-type JSONSchema = {
-    $schema?: string;
-    title?: string;
-    description?: string;
-    type: "object" | "array" | "string" | "number" | "boolean" | "null" | "integer";
-    properties?: Record<string, JSONSchema>;
-    items?: JSONSchema | JSONSchema[];
-    required?: string[];
-    enum?: any[];
-    additionalProperties?: boolean | JSONSchema;
-    definitions?: Record<string, JSONSchema>;
-    patternProperties?: Record<string, JSONSchema>;
-    allOf?: JSONSchema[];
-    anyOf?: JSONSchema[];
-    oneOf?: JSONSchema[];
-    not?: JSONSchema;
-};
+type JSONSchema = Record<string, unknown>;
 /**
  * Options for retrieving the context from a list of search results. The context is a string
  * representation of all the search results.
@@ -2958,6 +2969,39 @@ type AnswerStreamResponse = {
     answer?: string;
     citations?: SearchResult<{}>[];
 };
+/**
+ * Enhanced answer options that accepts either JSON schema or Zod schema
+ */
+type AnswerOptionsTyped<T> = Omit<AnswerOptions, "outputSchema"> & {
+    outputSchema: T;
+};
+/**
+ * Enhanced answer response with strongly typed answer when using Zod
+ */
+type AnswerResponseTyped<T> = Omit<AnswerResponse, "answer"> & {
+    answer: T;
+};
+/**
+ * Enhanced summary contents options that accepts either JSON schema or Zod schema
+ */
+type SummaryContentsOptionsTyped<T> = Omit<SummaryContentsOptions, "schema"> & {
+    schema: T;
+};
+/**
+ * Enhanced research task output options that accepts either JSON schema or Zod schema
+ */
+type ResearchTaskOutputTyped<T> = {
+    inferSchema?: boolean;
+    schema: T;
+};
+/**
+ * Enhanced research task creation params with zod schema support
+ */
+type ResearchCreateTaskParamsTyped<T> = {
+    instructions: string;
+    model?: "exa-research" | "exa-research-pro";
+    output?: ResearchTaskOutputTyped<T>;
+};
 /**
  * The Exa class encapsulates the API's endpoints.
  */
@@ -3030,6 +3074,10 @@ declare class Exa {
      * @returns {Promise<SearchResponse<T>>} A list of document contents for the requested URLs.
      */
     getContents<T extends ContentsOptions>(urls: string | string[] | SearchResult<T>[], options?: T): Promise<SearchResponse<T>>;
+    /**
+     * Generate an answer with Zod schema for strongly typed output
+     */
+    answer<T>(query: string, options: AnswerOptionsTyped<ZodSchema<T>>): Promise<AnswerResponseTyped<T>>;
     /**
      * Generate an answer to a query.
      * @param {string} query - The question or query to answer.
@@ -3053,6 +3101,16 @@ declare class Exa {
      * ```
      */
     answer(query: string, options?: AnswerOptions): Promise<AnswerResponse>;
+    /**
+     * Stream an answer with Zod schema for structured output (non-streaming content)
+     * Note: Structured output works only with non-streaming content, not with streaming chunks
+     */
+    streamAnswer<T>(query: string, options: {
+        text?: boolean;
+        model?: "exa" | "exa-pro";
+        systemPrompt?: string;
+        outputSchema: ZodSchema<T>;
+    }): AsyncGenerator<AnswerStreamChunk>;
     /**
      * Stream an answer as an async generator
      *
@@ -3082,4 +3140,4 @@ declare class Exa {
     private parseSSEStream;
 }
 
-export { type AnswerOptions, type AnswerResponse, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type SchemaListResearchTasksRequestDto as ListResearchTasksRequest, type SchemaListResearchTasksResponseDto as ListResearchTasksResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type RegularSearchOptions, ResearchClient, type SchemaResearchCreateTaskRequestDto as ResearchCreateTaskRequest, type SchemaResearchCreateTaskResponseDto as ResearchCreateTaskResponse, type ResearchPaperEntity, type SchemaResearchTaskDto as ResearchTask, type ResearchTaskEvent, type ResearchTaskOperation, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };
+export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type SchemaListResearchTasksRequestDto as ListResearchTasksRequest, type SchemaListResearchTasksResponseDto as ListResearchTasksResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type RegularSearchOptions, ResearchClient, type ResearchCreateTaskParamsTyped, type SchemaResearchCreateTaskRequestDto as ResearchCreateTaskRequest, type SchemaResearchCreateTaskResponseDto as ResearchCreateTaskResponse, type ResearchPaperEntity, type SchemaResearchTaskDto as ResearchTask, type ResearchTaskEvent, type ResearchTaskOperation, type ResearchTaskOutputTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { ZodSchema } from 'zod';
+
 /**
  * Base client for Websets API
  */
@@ -287,7 +289,8 @@ interface components$1 {
                  *
                  *     Any URLs provided will be crawled and used as additional context for the search. */
                 query: string;
-                /** @description Whether to compute recall metrics for the search */
+                /** @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;
             };
         };
@@ -329,7 +332,8 @@ interface components$1 {
              *
              *     Any URLs provided will be crawled and used as additional context for the search. */
             query: string;
-            /** @description Whether to compute recall metrics for the search */
+            /** @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;
         };
         /** Custom */
@@ -358,7 +362,10 @@ interface components$1 {
                 snippet: string | null;
                 /** @description The title of the reference */
                 title: string | null;
-                /** @description The URL of the reference */
+                /**
+                 * Format: uri
+                 * @description The URL of the reference
+                 */
                 url: string;
             }[];
             /** @description The result of the enrichment. */
@@ -695,7 +702,7 @@ interface components$1 {
                      * @default append
                      * @enum {string}
                      */
-                    behavior: MonitorBehaviorConfigBehavior;
+                    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. */
@@ -775,7 +782,7 @@ interface components$1 {
                  * @default append
                  * @enum {string}
                  */
-                behavior: MonitorBehaviorConfigBehavior;
+                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. */
@@ -826,6 +833,8 @@ interface components$1 {
              * @description When the run failed
              */
             failedAt: string | null;
+            /** @description The reason the run failed */
+            failedReason: string | null;
             /** @description The unique identifier for the Monitor Run */
             id: string;
             /** @description The monitor that the run is associated with */
@@ -1020,6 +1029,8 @@ interface components$1 {
             status: WebsetStatus;
             /** @description The Streams for the Webset. */
             streams: unknown[];
+            /** @description The title of the webset */
+            title: string | null;
             /**
              * Format: date-time
              * @description The date and time the webset was updated
@@ -1214,7 +1225,10 @@ interface components$1 {
                 snippet: string | null;
                 /** @description The title of the reference */
                 title: string | null;
-                /** @description The URL of the reference */
+                /**
+                 * Format: uri
+                 * @description The URL of the reference
+                 */
                 url: string;
             }[];
             /**
@@ -1527,10 +1541,6 @@ declare enum MonitorStatus {
     enabled = "enabled",
     disabled = "disabled"
 }
-declare enum MonitorBehaviorConfigBehavior {
-    override = "override",
-    append = "append"
-}
 declare enum MonitorRunObject {
     monitor_run = "monitor_run"
 }
@@ -1538,7 +1548,8 @@ declare enum MonitorRunStatus {
     created = "created",
     running = "running",
     completed = "completed",
-    canceled = "canceled"
+    canceled = "canceled",
+    failed = "failed"
 }
 declare enum MonitorRunType {
     search = "search",
@@ -1796,6 +1807,15 @@ declare class ImportsClient extends WebsetsBaseClient {
  * Client for managing Webset Items
  */
 
+/**
+ * Options for listing webset items
+ */
+interface ListWebsetItemsOptions extends PaginationParams {
+    /**
+     * The id of the source to filter items by
+     */
+    sourceId?: string;
+}
 /**
  * Client for managing Webset Items
  */
@@ -1803,24 +1823,24 @@ declare class WebsetItemsClient extends WebsetsBaseClient {
     /**
      * List all Items for a Webset
      * @param websetId The ID of the Webset
-     * @param params - Optional pagination parameters
+     * @param params - Optional pagination and filtering parameters
      * @returns A promise that resolves with the list of Items
      */
-    list(websetId: string, params?: PaginationParams): Promise<ListWebsetItemResponse>;
+    list(websetId: string, params?: ListWebsetItemsOptions): Promise<ListWebsetItemResponse>;
     /**
      * Iterate through all Items in a Webset, handling pagination automatically
      * @param websetId The ID of the Webset
      * @param options Pagination options
      * @returns Async generator of Webset Items
      */
-    listAll(websetId: string, options?: PaginationParams): AsyncGenerator<WebsetItem>;
+    listAll(websetId: string, options?: ListWebsetItemsOptions): AsyncGenerator<WebsetItem>;
     /**
      * Collect all items from a Webset into an array
      * @param websetId The ID of the Webset
      * @param options Pagination options
      * @returns Promise resolving to an array of all Webset Items
      */
-    getAll(websetId: string, options?: PaginationParams): Promise<WebsetItem[]>;
+    getAll(websetId: string, options?: ListWebsetItemsOptions): Promise<WebsetItem[]>;
     /**
      * Get an Item by ID
      * @param websetId The ID of the Webset
@@ -1959,6 +1979,10 @@ interface ListWebhookAttemptsOptions extends PaginationParams {
      * The type of event to filter by
      */
     eventType?: EventType;
+    /**
+     * Filter attempts by their success status
+     */
+    successful?: boolean;
 }
 /**
  * Client for managing Webset Webhooks
@@ -2185,6 +2209,10 @@ declare class ResearchBaseClient {
  */
 declare class ResearchClient extends ResearchBaseClient {
     constructor(client: Exa);
+    /**
+     * Create a new research task with Zod schema for strongly typed output
+     */
+    createTask<T>(params: ResearchCreateTaskParamsTyped<ZodSchema<T>>): Promise<SchemaResearchCreateTaskResponseDto>;
     /**
      * Create a new research task.
      *
@@ -2738,29 +2766,12 @@ type HighlightsContentsOptions = {
  */
 type SummaryContentsOptions = {
     query?: string;
-    schema?: JSONSchema;
+    schema?: Record<string, unknown> | ZodSchema;
 };
 /**
- * Represents a JSON Schema definition used for structured summary output.
- * To learn more visit https://json-schema.org/overview/what-is-jsonschema.
+ * @deprecated Use Record<string, unknown> instead.
  */
-type JSONSchema = {
-    $schema?: string;
-    title?: string;
-    description?: string;
-    type: "object" | "array" | "string" | "number" | "boolean" | "null" | "integer";
-    properties?: Record<string, JSONSchema>;
-    items?: JSONSchema | JSONSchema[];
-    required?: string[];
-    enum?: any[];
-    additionalProperties?: boolean | JSONSchema;
-    definitions?: Record<string, JSONSchema>;
-    patternProperties?: Record<string, JSONSchema>;
-    allOf?: JSONSchema[];
-    anyOf?: JSONSchema[];
-    oneOf?: JSONSchema[];
-    not?: JSONSchema;
-};
+type JSONSchema = Record<string, unknown>;
 /**
  * Options for retrieving the context from a list of search results. The context is a string
  * representation of all the search results.
@@ -2958,6 +2969,39 @@ type AnswerStreamResponse = {
     answer?: string;
     citations?: SearchResult<{}>[];
 };
+/**
+ * Enhanced answer options that accepts either JSON schema or Zod schema
+ */
+type AnswerOptionsTyped<T> = Omit<AnswerOptions, "outputSchema"> & {
+    outputSchema: T;
+};
+/**
+ * Enhanced answer response with strongly typed answer when using Zod
+ */
+type AnswerResponseTyped<T> = Omit<AnswerResponse, "answer"> & {
+    answer: T;
+};
+/**
+ * Enhanced summary contents options that accepts either JSON schema or Zod schema
+ */
+type SummaryContentsOptionsTyped<T> = Omit<SummaryContentsOptions, "schema"> & {
+    schema: T;
+};
+/**
+ * Enhanced research task output options that accepts either JSON schema or Zod schema
+ */
+type ResearchTaskOutputTyped<T> = {
+    inferSchema?: boolean;
+    schema: T;
+};
+/**
+ * Enhanced research task creation params with zod schema support
+ */
+type ResearchCreateTaskParamsTyped<T> = {
+    instructions: string;
+    model?: "exa-research" | "exa-research-pro";
+    output?: ResearchTaskOutputTyped<T>;
+};
 /**
  * The Exa class encapsulates the API's endpoints.
  */
@@ -3030,6 +3074,10 @@ declare class Exa {
      * @returns {Promise<SearchResponse<T>>} A list of document contents for the requested URLs.
      */
     getContents<T extends ContentsOptions>(urls: string | string[] | SearchResult<T>[], options?: T): Promise<SearchResponse<T>>;
+    /**
+     * Generate an answer with Zod schema for strongly typed output
+     */
+    answer<T>(query: string, options: AnswerOptionsTyped<ZodSchema<T>>): Promise<AnswerResponseTyped<T>>;
     /**
      * Generate an answer to a query.
      * @param {string} query - The question or query to answer.
@@ -3053,6 +3101,16 @@ declare class Exa {
      * ```
      */
     answer(query: string, options?: AnswerOptions): Promise<AnswerResponse>;
+    /**
+     * Stream an answer with Zod schema for structured output (non-streaming content)
+     * Note: Structured output works only with non-streaming content, not with streaming chunks
+     */
+    streamAnswer<T>(query: string, options: {
+        text?: boolean;
+        model?: "exa" | "exa-pro";
+        systemPrompt?: string;
+        outputSchema: ZodSchema<T>;
+    }): AsyncGenerator<AnswerStreamChunk>;
     /**
      * Stream an answer as an async generator
      *
@@ -3082,4 +3140,4 @@ declare class Exa {
     private parseSSEStream;
 }
 
-export { type AnswerOptions, type AnswerResponse, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type SchemaListResearchTasksRequestDto as ListResearchTasksRequest, type SchemaListResearchTasksResponseDto as ListResearchTasksResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type RegularSearchOptions, ResearchClient, type SchemaResearchCreateTaskRequestDto as ResearchCreateTaskRequest, type SchemaResearchCreateTaskResponseDto as ResearchCreateTaskResponse, type ResearchPaperEntity, type SchemaResearchTaskDto as ResearchTask, type ResearchTaskEvent, type ResearchTaskOperation, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };
+export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, CreateWebsetParametersImportSource, CreateWebsetParametersSearchExcludeSource, type CreateWebsetSearchParameters, CreateWebsetSearchParametersExcludeSource, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type SchemaListResearchTasksRequestDto as ListResearchTasksRequest, type SchemaListResearchTasksResponseDto as ListResearchTasksResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type RegularSearchOptions, ResearchClient, type ResearchCreateTaskParamsTyped, type SchemaResearchCreateTaskRequestDto as ResearchCreateTaskRequest, type SchemaResearchCreateTaskResponseDto as ResearchCreateTaskResponse, type ResearchPaperEntity, type SchemaResearchTaskDto as ResearchTask, type ResearchTaskEvent, type ResearchTaskOperation, type ResearchTaskOutputTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };