exa-js 1.8.17 → 1.8.19

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import { ZodSchema } from 'zod';
+
 /**
  * Base client for Websets API
  */
@@ -287,6 +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 */
+                recall?: boolean;
             };
         };
         CreateWebsetSearchParameters: {
@@ -327,12 +331,11 @@ 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 */
+            recall?: boolean;
         };
         /** Custom */
         CustomEntity: {
-            /** @description When you decide to use a custom entity, this is the description of the entity.
-             *
-             *     The entity represents what type of results the  will return. For example, if you want results to be Job Postings, you might use "Job Postings" as the entity description. */
             description: string;
             /**
              * @default custom
@@ -362,6 +365,11 @@ interface components$1 {
             }[];
             /** @description The result of the enrichment. */
             result: string[] | null;
+            /**
+             * @description The status of the enrichment result.
+             * @enum {string}
+             */
+            status: EnrichmentResultStatus;
         };
         Entity: components$1["schemas"]["CompanyEntity"] | components$1["schemas"]["PersonEntity"] | components$1["schemas"]["ArticleEntity"] | components$1["schemas"]["ResearchPaperEntity"] | components$1["schemas"]["CustomEntity"];
         /** Event */
@@ -557,6 +565,7 @@ interface components$1 {
             type: "webset.search.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"][];
@@ -1332,13 +1341,37 @@ interface components$1 {
             object: "webset_search";
             /** @description The progress of the search */
             progress: {
+                /** @description The number of results analyzed so far */
+                analyzed: number;
                 /** @description The completion percentage of the search */
                 completion: number;
                 /** @description The number of results found so far */
                 found: number;
+                /** @description The estimated time remaining in seconds, null if unknown */
+                timeLeft: number | null;
             };
             /** @description The query used to create the search. */
             query: string;
+            /** @description Recall metrics for the search, null if not yet computed or requested. */
+            recall: {
+                expected: {
+                    bounds: {
+                        /** @description The maximum estimated total number of potential matches */
+                        max: number;
+                        /** @description The minimum estimated total number of potential matches */
+                        min: number;
+                    };
+                    /**
+                     * @description The confidence in the estimate
+                     * @enum {string}
+                     */
+                    confidence: WebsetSearchRecallExpectedConfidence;
+                    /** @description The estimated total number of potential matches */
+                    total: number;
+                };
+                /** @description The reasoning for the estimate */
+                reasoning: string;
+            } | null;
             /**
              * WebsetSearchStatus
              * @description The status of the search
@@ -1449,6 +1482,11 @@ declare enum CreateWebsetSearchParametersExcludeSource {
     import = "import",
     webset = "webset"
 }
+declare enum EnrichmentResultStatus {
+    pending = "pending",
+    completed = "completed",
+    canceled = "canceled"
+}
 declare enum EventType {
     webset_created = "webset.created",
     webset_deleted = "webset.deleted",
@@ -1564,6 +1602,11 @@ declare enum WebsetSearchExcludeSource {
     import = "import",
     webset = "webset"
 }
+declare enum WebsetSearchRecallExpectedConfidence {
+    high = "high",
+    medium = "medium",
+    low = "low"
+}
 declare enum WebsetSearchStatus {
     created = "created",
     running = "running",
@@ -2144,6 +2187,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.
      *
@@ -2697,29 +2744,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.
@@ -2917,6 +2947,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.
  */
@@ -2989,6 +3052,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.
@@ -3012,6 +3079,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
      *
@@ -3041,4 +3118,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 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,6 +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 */
+                recall?: boolean;
             };
         };
         CreateWebsetSearchParameters: {
@@ -327,12 +331,11 @@ 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 */
+            recall?: boolean;
         };
         /** Custom */
         CustomEntity: {
-            /** @description When you decide to use a custom entity, this is the description of the entity.
-             *
-             *     The entity represents what type of results the  will return. For example, if you want results to be Job Postings, you might use "Job Postings" as the entity description. */
             description: string;
             /**
              * @default custom
@@ -362,6 +365,11 @@ interface components$1 {
             }[];
             /** @description The result of the enrichment. */
             result: string[] | null;
+            /**
+             * @description The status of the enrichment result.
+             * @enum {string}
+             */
+            status: EnrichmentResultStatus;
         };
         Entity: components$1["schemas"]["CompanyEntity"] | components$1["schemas"]["PersonEntity"] | components$1["schemas"]["ArticleEntity"] | components$1["schemas"]["ResearchPaperEntity"] | components$1["schemas"]["CustomEntity"];
         /** Event */
@@ -557,6 +565,7 @@ interface components$1 {
             type: "webset.search.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"][];
@@ -1332,13 +1341,37 @@ interface components$1 {
             object: "webset_search";
             /** @description The progress of the search */
             progress: {
+                /** @description The number of results analyzed so far */
+                analyzed: number;
                 /** @description The completion percentage of the search */
                 completion: number;
                 /** @description The number of results found so far */
                 found: number;
+                /** @description The estimated time remaining in seconds, null if unknown */
+                timeLeft: number | null;
             };
             /** @description The query used to create the search. */
             query: string;
+            /** @description Recall metrics for the search, null if not yet computed or requested. */
+            recall: {
+                expected: {
+                    bounds: {
+                        /** @description The maximum estimated total number of potential matches */
+                        max: number;
+                        /** @description The minimum estimated total number of potential matches */
+                        min: number;
+                    };
+                    /**
+                     * @description The confidence in the estimate
+                     * @enum {string}
+                     */
+                    confidence: WebsetSearchRecallExpectedConfidence;
+                    /** @description The estimated total number of potential matches */
+                    total: number;
+                };
+                /** @description The reasoning for the estimate */
+                reasoning: string;
+            } | null;
             /**
              * WebsetSearchStatus
              * @description The status of the search
@@ -1449,6 +1482,11 @@ declare enum CreateWebsetSearchParametersExcludeSource {
     import = "import",
     webset = "webset"
 }
+declare enum EnrichmentResultStatus {
+    pending = "pending",
+    completed = "completed",
+    canceled = "canceled"
+}
 declare enum EventType {
     webset_created = "webset.created",
     webset_deleted = "webset.deleted",
@@ -1564,6 +1602,11 @@ declare enum WebsetSearchExcludeSource {
     import = "import",
     webset = "webset"
 }
+declare enum WebsetSearchRecallExpectedConfidence {
+    high = "high",
+    medium = "medium",
+    low = "low"
+}
 declare enum WebsetSearchStatus {
     created = "created",
     running = "running",
@@ -2144,6 +2187,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.
      *
@@ -2697,29 +2744,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.
@@ -2917,6 +2947,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.
  */
@@ -2989,6 +3052,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.
@@ -3012,6 +3079,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
      *
@@ -3041,4 +3118,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 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.js

@@ -1024,6 +1024,18 @@ var WebsetsClient = class extends WebsetsBaseClient {
   }
 };
 
+// src/zod-utils.ts
+var import_zod = require("zod");
+var import_zod_to_json_schema = require("zod-to-json-schema");
+function isZodSchema(obj) {
+  return obj instanceof import_zod.ZodType;
+}
+function zodToJsonSchema(schema) {
+  return (0, import_zod_to_json_schema.zodToJsonSchema)(schema, {
+    $refStrategy: "none"
+  });
+}
+
 // src/research/base.ts
 var ResearchBaseClient = class {
   /**
@@ -1084,23 +1096,17 @@ var ResearchClient = class extends ResearchBaseClient {
   constructor(client) {
     super(client);
   }
-  /**
-   * Create a new research task.
-   *
-   * @param params Object containing:
-   *   - model: The research model to use (e.g., ResearchModel.ExaResearch).
-   *   - instructions: High-level guidance for the research agent.
-   *   - output: An object with a `schema` property (JSONSchema) that defines the expected output structure.
-   *
-   * @returns An object containing the unique ID of the created research task.
-   */
   async createTask(params) {
     const { instructions, model, output } = params;
+    let schema = output?.schema;
+    if (schema && isZodSchema(schema)) {
+      schema = zodToJsonSchema(schema);
+    }
     const payload = {
       instructions,
       model: model ?? "exa-research",
       output: output ? {
-        schema: output.schema,
+        schema,
         inferSchema: output.inferSchema ?? true
       } : { inferSchema: true }
     };
@@ -1233,7 +1239,16 @@ var Exa2 = class {
       contentsOptions.text = true;
     }
     if (text !== void 0) contentsOptions.text = text;
-    if (summary !== void 0) contentsOptions.summary = summary;
+    if (summary !== void 0) {
+      if (typeof summary === "object" && summary !== null && "schema" in summary && summary.schema && isZodSchema(summary.schema)) {
+        contentsOptions.summary = {
+          ...summary,
+          schema: zodToJsonSchema(summary.schema)
+        };
+      } else {
+        contentsOptions.summary = summary;
+      }
+    }
     if (highlights !== void 0) contentsOptions.highlights = highlights;
     if (subpages !== void 0) contentsOptions.subpages = subpages;
     if (subpageTarget !== void 0)
@@ -1426,28 +1441,6 @@ var Exa2 = class {
     };
     return await this.request("/contents", "POST", payload);
   }
-  /**
-   * Generate an answer to a query.
-   * @param {string} query - The question or query to answer.
-   * @param {AnswerOptions} [options] - Additional options for answer generation.
-   * @returns {Promise<AnswerResponse>} The generated answer and source references.
-   *
-   * Example with systemPrompt:
-   * ```ts
-   * const answer = await exa.answer("What is quantum computing?", {
-   *   text: true,
-   *   model: "exa",
-   *   systemPrompt: "Answer in a technical manner suitable for experts."
-   * });
-   * ```
-   *
-   * Note: For streaming responses, use the `streamAnswer` method:
-   * ```ts
-   * for await (const chunk of exa.streamAnswer(query)) {
-   *   // Handle chunks
-   * }
-   * ```
-   */
   async answer(query, options) {
     if (options?.stream) {
       throw new ExaError(
@@ -1455,43 +1448,32 @@ var Exa2 = class {
         400 /* BadRequest */
       );
     }
+    let outputSchema = options?.outputSchema;
+    if (outputSchema && isZodSchema(outputSchema)) {
+      outputSchema = zodToJsonSchema(outputSchema);
+    }
     const requestBody = {
       query,
       stream: false,
       text: options?.text ?? false,
       model: options?.model ?? "exa",
       systemPrompt: options?.systemPrompt,
-      outputSchema: options?.outputSchema
+      outputSchema
     };
     return await this.request("/answer", "POST", requestBody);
   }
-  /**
-   * Stream an answer as an async generator
-   *
-   * Each iteration yields a chunk with partial text (`content`) or new citations.
-   * Use this if you'd like to read the answer incrementally, e.g. in a chat UI.
-   *
-   * Example usage:
-   * ```ts
-   * for await (const chunk of exa.streamAnswer("What is quantum computing?", {
-   *   text: false,
-   *   systemPrompt: "Answer in a concise manner suitable for beginners."
-   * })) {
-   *   if (chunk.content) process.stdout.write(chunk.content);
-   *   if (chunk.citations) {
-   *     console.log("\nCitations: ", chunk.citations);
-   *   }
-   * }
-   * ```
-   */
   async *streamAnswer(query, options) {
+    let outputSchema = options?.outputSchema;
+    if (outputSchema && isZodSchema(outputSchema)) {
+      outputSchema = zodToJsonSchema(outputSchema);
+    }
     const body = {
       query,
       text: options?.text ?? false,
       stream: true,
       model: options?.model ?? "exa",
       systemPrompt: options?.systemPrompt,
-      outputSchema: options?.outputSchema
+      outputSchema
     };
     const response = await fetchImpl(this.baseURL + "/answer", {
       method: "POST",