exa-js 1.10.0 → 1.10.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +183 -54
- package/dist/index.d.ts +183 -54
- package/dist/index.js +9 -9
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +8 -8
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -3,228 +3,330 @@ import { ZodSchema } from 'zod';
|
|
|
3
3
|
interface components$1 {
|
|
4
4
|
schemas: {
|
|
5
5
|
ListResearchResponseDto: {
|
|
6
|
-
/** @description
|
|
6
|
+
/** @description Research requests ordered by creation time (newest first) */
|
|
7
7
|
data: components$1["schemas"]["ResearchDtoClass"][];
|
|
8
|
-
/** @description
|
|
8
|
+
/** @description If true, use nextCursor to fetch more results */
|
|
9
9
|
hasMore: boolean;
|
|
10
|
-
/** @description
|
|
10
|
+
/** @description Pass this value as the cursor parameter to fetch the next page */
|
|
11
11
|
nextCursor: string | null;
|
|
12
12
|
};
|
|
13
13
|
ResearchCreateRequestDtoClass: {
|
|
14
|
-
/** @description Instructions for what research should be conducted */
|
|
14
|
+
/** @description Instructions for what you would like research on. A good prompt clearly defines what information you want to find, how research should be conducted, and what the output should look like. */
|
|
15
15
|
instructions: string;
|
|
16
16
|
/**
|
|
17
|
+
* @description Research model to use. exa-research is faster and cheaper, while exa-research-pro provides more thorough analysis and stronger reasoning.
|
|
17
18
|
* @default exa-research
|
|
18
19
|
* @enum {string}
|
|
19
20
|
*/
|
|
20
|
-
model: "exa-research" | "exa-research-pro";
|
|
21
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
22
|
+
/** @description JSON Schema to enforce structured output. When provided, the research output will be validated against this schema and returned as parsed JSON. */
|
|
21
23
|
outputSchema?: {
|
|
22
24
|
[key: string]: unknown;
|
|
23
25
|
};
|
|
24
26
|
};
|
|
25
27
|
ResearchDtoClass: {
|
|
26
|
-
/** @description
|
|
28
|
+
/** @description When the research was created (Unix timestamp in milliseconds) */
|
|
27
29
|
createdAt: number;
|
|
28
|
-
/** @description The
|
|
30
|
+
/** @description The original research instructions provided */
|
|
29
31
|
instructions: string;
|
|
30
32
|
/**
|
|
31
|
-
* @description The model used for
|
|
33
|
+
* @description The model used for this research request
|
|
32
34
|
* @default exa-research
|
|
33
35
|
* @enum {string}
|
|
34
36
|
*/
|
|
35
|
-
model: "exa-research" | "exa-research-pro";
|
|
37
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
38
|
+
/** @description The JSON Schema used to validate the output, if provided */
|
|
36
39
|
outputSchema?: {
|
|
37
40
|
[key: string]: unknown;
|
|
38
41
|
};
|
|
39
|
-
/** @description
|
|
42
|
+
/** @description Unique identifier for tracking and retrieving this research request */
|
|
40
43
|
researchId: string;
|
|
41
44
|
/** @enum {string} */
|
|
42
45
|
status: "pending";
|
|
43
46
|
} | {
|
|
44
|
-
/** @description
|
|
47
|
+
/** @description When the research was created (Unix timestamp in milliseconds) */
|
|
45
48
|
createdAt: number;
|
|
49
|
+
/** @description Real-time log of operations as research progresses. Poll this endpoint or use ?stream=true for live updates. */
|
|
46
50
|
events?: components$1["schemas"]["ResearchEventDtoClass"][];
|
|
47
|
-
/** @description The
|
|
51
|
+
/** @description The original research instructions provided */
|
|
48
52
|
instructions: string;
|
|
49
53
|
/**
|
|
50
|
-
* @description The model used for
|
|
54
|
+
* @description The model used for this research request
|
|
51
55
|
* @default exa-research
|
|
52
56
|
* @enum {string}
|
|
53
57
|
*/
|
|
54
|
-
model: "exa-research" | "exa-research-pro";
|
|
58
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
59
|
+
/** @description The JSON Schema used to validate the output, if provided */
|
|
55
60
|
outputSchema?: {
|
|
56
61
|
[key: string]: unknown;
|
|
57
62
|
};
|
|
58
|
-
/** @description
|
|
63
|
+
/** @description Unique identifier for tracking and retrieving this research request */
|
|
59
64
|
researchId: string;
|
|
60
65
|
/** @enum {string} */
|
|
61
66
|
status: "running";
|
|
62
67
|
} | {
|
|
68
|
+
/** @description Detailed cost breakdown for billing purposes */
|
|
63
69
|
costDollars: {
|
|
70
|
+
/** @description Count of web pages fully crawled and processed. Only pages that were read in detail are counted. */
|
|
64
71
|
numPages: number;
|
|
72
|
+
/** @description Count of web searches performed. Each search query counts as one search. */
|
|
65
73
|
numSearches: number;
|
|
74
|
+
/** @description Total AI tokens used for reasoning, planning, and generating the final output */
|
|
66
75
|
reasoningTokens: number;
|
|
76
|
+
/** @description Total cost in USD for this research request */
|
|
67
77
|
total: number;
|
|
68
78
|
};
|
|
69
|
-
/** @description
|
|
79
|
+
/** @description When the research was created (Unix timestamp in milliseconds) */
|
|
70
80
|
createdAt: number;
|
|
81
|
+
/** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
|
|
71
82
|
events?: components$1["schemas"]["ResearchEventDtoClass"][];
|
|
72
|
-
/** @description
|
|
83
|
+
/** @description When the research completed (Unix timestamp in milliseconds) */
|
|
73
84
|
finishedAt: number;
|
|
74
|
-
/** @description The
|
|
85
|
+
/** @description The original research instructions provided */
|
|
75
86
|
instructions: string;
|
|
76
87
|
/**
|
|
77
|
-
* @description The model used for
|
|
88
|
+
* @description The model used for this research request
|
|
78
89
|
* @default exa-research
|
|
79
90
|
* @enum {string}
|
|
80
91
|
*/
|
|
81
|
-
model: "exa-research" | "exa-research-pro";
|
|
92
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
93
|
+
/** @description The final research results, containing both raw text and parsed JSON if outputSchema was provided */
|
|
82
94
|
output: {
|
|
95
|
+
/** @description The complete research output as text. If outputSchema was provided, this is a JSON string. */
|
|
83
96
|
content: string;
|
|
97
|
+
/** @description Structured JSON object matching your outputSchema. Only present when outputSchema was provided and the output successfully validated. */
|
|
84
98
|
parsed?: {
|
|
85
99
|
[key: string]: unknown;
|
|
86
100
|
};
|
|
87
101
|
};
|
|
102
|
+
/** @description The JSON Schema used to validate the output, if provided */
|
|
88
103
|
outputSchema?: {
|
|
89
104
|
[key: string]: unknown;
|
|
90
105
|
};
|
|
91
|
-
/** @description
|
|
106
|
+
/** @description Unique identifier for tracking and retrieving this research request */
|
|
92
107
|
researchId: string;
|
|
93
108
|
/** @enum {string} */
|
|
94
109
|
status: "completed";
|
|
95
110
|
} | {
|
|
96
|
-
/** @description
|
|
111
|
+
/** @description When the research was created (Unix timestamp in milliseconds) */
|
|
97
112
|
createdAt: number;
|
|
113
|
+
/** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
|
|
98
114
|
events?: components$1["schemas"]["ResearchEventDtoClass"][];
|
|
99
|
-
/** @description
|
|
115
|
+
/** @description When the research was canceled (Unix timestamp in milliseconds) */
|
|
100
116
|
finishedAt: number;
|
|
101
|
-
/** @description The
|
|
117
|
+
/** @description The original research instructions provided */
|
|
102
118
|
instructions: string;
|
|
103
119
|
/**
|
|
104
|
-
* @description The model used for
|
|
120
|
+
* @description The model used for this research request
|
|
105
121
|
* @default exa-research
|
|
106
122
|
* @enum {string}
|
|
107
123
|
*/
|
|
108
|
-
model: "exa-research" | "exa-research-pro";
|
|
124
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
125
|
+
/** @description The JSON Schema used to validate the output, if provided */
|
|
109
126
|
outputSchema?: {
|
|
110
127
|
[key: string]: unknown;
|
|
111
128
|
};
|
|
112
|
-
/** @description
|
|
129
|
+
/** @description Unique identifier for tracking and retrieving this research request */
|
|
113
130
|
researchId: string;
|
|
114
131
|
/** @enum {string} */
|
|
115
132
|
status: "canceled";
|
|
116
133
|
} | {
|
|
117
|
-
/** @description
|
|
134
|
+
/** @description When the research was created (Unix timestamp in milliseconds) */
|
|
118
135
|
createdAt: number;
|
|
119
|
-
/** @description
|
|
136
|
+
/** @description Human-readable error message explaining what went wrong. */
|
|
120
137
|
error: string;
|
|
138
|
+
/** @description Detailed log of all operations performed during research. Use ?events=true to include this field for debugging or monitoring progress. */
|
|
121
139
|
events?: components$1["schemas"]["ResearchEventDtoClass"][];
|
|
122
|
-
/** @description
|
|
140
|
+
/** @description When the research failed (Unix timestamp in milliseconds) */
|
|
123
141
|
finishedAt: number;
|
|
124
|
-
/** @description The
|
|
142
|
+
/** @description The original research instructions provided */
|
|
125
143
|
instructions: string;
|
|
126
144
|
/**
|
|
127
|
-
* @description The model used for
|
|
145
|
+
* @description The model used for this research request
|
|
128
146
|
* @default exa-research
|
|
129
147
|
* @enum {string}
|
|
130
148
|
*/
|
|
131
|
-
model: "exa-research" | "exa-research-pro";
|
|
149
|
+
model: "exa-research-fast" | "exa-research" | "exa-research-pro";
|
|
150
|
+
/** @description The JSON Schema used to validate the output, if provided */
|
|
132
151
|
outputSchema?: {
|
|
133
152
|
[key: string]: unknown;
|
|
134
153
|
};
|
|
135
|
-
/** @description
|
|
154
|
+
/** @description Unique identifier for tracking and retrieving this research request */
|
|
136
155
|
researchId: string;
|
|
137
156
|
/** @enum {string} */
|
|
138
157
|
status: "failed";
|
|
139
158
|
};
|
|
140
159
|
ResearchEventDtoClass: ({
|
|
141
|
-
/** @description
|
|
160
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
142
161
|
createdAt: number;
|
|
143
162
|
/** @enum {string} */
|
|
144
163
|
eventType: "research-definition";
|
|
164
|
+
/** @description The complete research instructions as provided */
|
|
145
165
|
instructions: string;
|
|
166
|
+
/** @description The JSON Schema that will validate the final output */
|
|
146
167
|
outputSchema?: {
|
|
147
168
|
[key: string]: unknown;
|
|
148
169
|
};
|
|
170
|
+
/** @description The research request this event belongs to */
|
|
149
171
|
researchId: string;
|
|
150
172
|
} | {
|
|
151
|
-
/** @description
|
|
173
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
152
174
|
createdAt: number;
|
|
153
175
|
/** @enum {string} */
|
|
154
176
|
eventType: "research-output";
|
|
177
|
+
/** @description The final research result, either successful with data or failed with error */
|
|
155
178
|
output: {
|
|
179
|
+
/** @description The complete research output as text. If outputSchema was provided, this is a JSON string. */
|
|
156
180
|
content: string;
|
|
157
181
|
costDollars: {
|
|
182
|
+
/** @description Count of web pages fully crawled and processed. Only pages that were read in detail are counted. */
|
|
158
183
|
numPages: number;
|
|
184
|
+
/** @description Count of web searches performed. Each search query counts as one search. */
|
|
159
185
|
numSearches: number;
|
|
186
|
+
/** @description Total AI tokens used for reasoning, planning, and generating the final output */
|
|
160
187
|
reasoningTokens: number;
|
|
188
|
+
/** @description Total cost in USD for this research request */
|
|
161
189
|
total: number;
|
|
162
190
|
};
|
|
163
191
|
/** @enum {string} */
|
|
164
192
|
outputType: "completed";
|
|
193
|
+
/** @description Structured JSON object matching your outputSchema. Only present when outputSchema was provided and the output successfully validated. */
|
|
165
194
|
parsed?: {
|
|
166
195
|
[key: string]: unknown;
|
|
167
196
|
};
|
|
168
197
|
} | {
|
|
198
|
+
/** @description Detailed error message explaining why the research failed */
|
|
169
199
|
error: string;
|
|
170
200
|
/** @enum {string} */
|
|
171
201
|
outputType: "failed";
|
|
172
202
|
};
|
|
203
|
+
/** @description The research request this event belongs to */
|
|
173
204
|
researchId: string;
|
|
174
205
|
}) | ({
|
|
175
|
-
/** @description
|
|
206
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
176
207
|
createdAt: number;
|
|
177
208
|
/** @enum {string} */
|
|
178
209
|
eventType: "plan-definition";
|
|
210
|
+
/** @description Identifier for this planning cycle */
|
|
179
211
|
planId: string;
|
|
212
|
+
/** @description The research request this event belongs to */
|
|
180
213
|
researchId: string;
|
|
181
214
|
} | {
|
|
182
|
-
/** @description
|
|
215
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
183
216
|
createdAt: number;
|
|
184
|
-
|
|
217
|
+
/** @description The actual operation performed (think, search, or crawl) */
|
|
218
|
+
data: {
|
|
219
|
+
/** @description The AI's reasoning process and decision-making steps */
|
|
220
|
+
content: string;
|
|
221
|
+
/** @enum {string} */
|
|
222
|
+
type: "think";
|
|
223
|
+
} | {
|
|
224
|
+
/** @description What the AI is trying to find with this search */
|
|
225
|
+
goal?: string;
|
|
226
|
+
/** @description Token cost for processing search result snippets */
|
|
227
|
+
pageTokens: number;
|
|
228
|
+
/** @description The exact search query sent to the search engine */
|
|
229
|
+
query: string;
|
|
230
|
+
/** @description URLs returned by the search, ranked by relevance */
|
|
231
|
+
results: {
|
|
232
|
+
url: string;
|
|
233
|
+
}[];
|
|
234
|
+
/**
|
|
235
|
+
* @description Search algorithm used (neural for semantic search, keyword for exact matches)
|
|
236
|
+
* @enum {string}
|
|
237
|
+
*/
|
|
238
|
+
searchType: "neural" | "keyword" | "auto" | "fast";
|
|
239
|
+
/** @enum {string} */
|
|
240
|
+
type: "search";
|
|
241
|
+
} | {
|
|
242
|
+
/** @description What information the AI expects to find on this page */
|
|
243
|
+
goal?: string;
|
|
244
|
+
/** @description Token cost for processing the full page content */
|
|
245
|
+
pageTokens: number;
|
|
246
|
+
/** @description The specific page that was crawled */
|
|
247
|
+
result: {
|
|
248
|
+
url: string;
|
|
249
|
+
};
|
|
250
|
+
/** @enum {string} */
|
|
251
|
+
type: "crawl";
|
|
252
|
+
};
|
|
185
253
|
/** @enum {string} */
|
|
186
254
|
eventType: "plan-operation";
|
|
255
|
+
/** @description Unique identifier for this specific operation */
|
|
187
256
|
operationId: string;
|
|
257
|
+
/** @description Which plan this operation belongs to */
|
|
188
258
|
planId: string;
|
|
259
|
+
/** @description The research request this event belongs to */
|
|
189
260
|
researchId: string;
|
|
190
261
|
} | {
|
|
191
|
-
/** @description
|
|
262
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
192
263
|
createdAt: number;
|
|
193
264
|
/** @enum {string} */
|
|
194
265
|
eventType: "plan-output";
|
|
195
|
-
|
|
266
|
+
/** @description The plan's decision: either generate tasks or stop researching */
|
|
267
|
+
output: {
|
|
268
|
+
/** @enum {string} */
|
|
269
|
+
outputType: "tasks";
|
|
270
|
+
/** @description Why these specific tasks were chosen */
|
|
271
|
+
reasoning: string;
|
|
272
|
+
/** @description List of task instructions that will be executed in parallel */
|
|
273
|
+
tasksInstructions: string[];
|
|
274
|
+
} | {
|
|
275
|
+
/** @enum {string} */
|
|
276
|
+
outputType: "stop";
|
|
277
|
+
/** @description Why the AI decided to stop researching */
|
|
278
|
+
reasoning: string;
|
|
279
|
+
};
|
|
280
|
+
/** @description Which plan is producing this output */
|
|
196
281
|
planId: string;
|
|
282
|
+
/** @description The research request this event belongs to */
|
|
197
283
|
researchId: string;
|
|
198
284
|
}) | ({
|
|
199
|
-
/** @description
|
|
285
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
200
286
|
createdAt: number;
|
|
201
287
|
/** @enum {string} */
|
|
202
288
|
eventType: "task-definition";
|
|
289
|
+
/** @description What this task should accomplish */
|
|
203
290
|
instructions: string;
|
|
291
|
+
/** @description The plan that generated this task */
|
|
204
292
|
planId: string;
|
|
293
|
+
/** @description The research request this event belongs to */
|
|
205
294
|
researchId: string;
|
|
295
|
+
/** @description Identifier for tracking this specific task */
|
|
206
296
|
taskId: string;
|
|
207
297
|
} | {
|
|
208
|
-
/** @description
|
|
298
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
209
299
|
createdAt: number;
|
|
300
|
+
/** @description The actual operation performed within this task */
|
|
210
301
|
data: {
|
|
302
|
+
/** @description The AI's reasoning process and decision-making steps */
|
|
211
303
|
content: string;
|
|
212
304
|
/** @enum {string} */
|
|
213
305
|
type: "think";
|
|
214
306
|
} | {
|
|
307
|
+
/** @description What the AI is trying to find with this search */
|
|
215
308
|
goal?: string;
|
|
309
|
+
/** @description Token cost for processing search result snippets */
|
|
216
310
|
pageTokens: number;
|
|
311
|
+
/** @description The exact search query sent to the search engine */
|
|
217
312
|
query: string;
|
|
313
|
+
/** @description URLs returned by the search, ranked by relevance */
|
|
218
314
|
results: {
|
|
219
315
|
url: string;
|
|
220
316
|
}[];
|
|
221
|
-
/**
|
|
317
|
+
/**
|
|
318
|
+
* @description Search algorithm used (neural for semantic search, keyword for exact matches)
|
|
319
|
+
* @enum {string}
|
|
320
|
+
*/
|
|
222
321
|
searchType: "neural" | "keyword" | "auto" | "fast";
|
|
223
322
|
/** @enum {string} */
|
|
224
323
|
type: "search";
|
|
225
324
|
} | {
|
|
325
|
+
/** @description What information the AI expects to find on this page */
|
|
226
326
|
goal?: string;
|
|
327
|
+
/** @description Token cost for processing the full page content */
|
|
227
328
|
pageTokens: number;
|
|
329
|
+
/** @description The specific page that was crawled */
|
|
228
330
|
result: {
|
|
229
331
|
url: string;
|
|
230
332
|
};
|
|
@@ -233,42 +335,62 @@ interface components$1 {
|
|
|
233
335
|
};
|
|
234
336
|
/** @enum {string} */
|
|
235
337
|
eventType: "task-operation";
|
|
338
|
+
/** @description Unique identifier for this specific operation */
|
|
236
339
|
operationId: string;
|
|
340
|
+
/** @description The plan that owns this task */
|
|
237
341
|
planId: string;
|
|
342
|
+
/** @description The research request this event belongs to */
|
|
238
343
|
researchId: string;
|
|
344
|
+
/** @description Which task is performing this operation */
|
|
239
345
|
taskId: string;
|
|
240
346
|
} | {
|
|
241
|
-
/** @description
|
|
347
|
+
/** @description When this event occurred (Unix timestamp in milliseconds) */
|
|
242
348
|
createdAt: number;
|
|
243
349
|
/** @enum {string} */
|
|
244
350
|
eventType: "task-output";
|
|
351
|
+
/** @description The successful completion result of this task */
|
|
245
352
|
output: {
|
|
353
|
+
/** @description The information gathered by this task */
|
|
246
354
|
content: string;
|
|
247
355
|
/** @enum {string} */
|
|
248
356
|
outputType: "completed";
|
|
249
357
|
};
|
|
358
|
+
/** @description The plan that owns this task */
|
|
250
359
|
planId: string;
|
|
360
|
+
/** @description The research request this event belongs to */
|
|
251
361
|
researchId: string;
|
|
362
|
+
/** @description Which task produced this output */
|
|
252
363
|
taskId: string;
|
|
253
364
|
});
|
|
254
365
|
ResearchOperationDtoClass: {
|
|
366
|
+
/** @description The AI's reasoning process and decision-making steps */
|
|
255
367
|
content: string;
|
|
256
368
|
/** @enum {string} */
|
|
257
369
|
type: "think";
|
|
258
370
|
} | {
|
|
371
|
+
/** @description What the AI is trying to find with this search */
|
|
259
372
|
goal?: string;
|
|
373
|
+
/** @description Token cost for processing search result snippets */
|
|
260
374
|
pageTokens: number;
|
|
375
|
+
/** @description The exact search query sent to the search engine */
|
|
261
376
|
query: string;
|
|
377
|
+
/** @description URLs returned by the search, ranked by relevance */
|
|
262
378
|
results: {
|
|
263
379
|
url: string;
|
|
264
380
|
}[];
|
|
265
|
-
/**
|
|
381
|
+
/**
|
|
382
|
+
* @description Search algorithm used (neural for semantic search, keyword for exact matches)
|
|
383
|
+
* @enum {string}
|
|
384
|
+
*/
|
|
266
385
|
searchType: "neural" | "keyword" | "auto" | "fast";
|
|
267
386
|
/** @enum {string} */
|
|
268
387
|
type: "search";
|
|
269
388
|
} | {
|
|
389
|
+
/** @description What information the AI expects to find on this page */
|
|
270
390
|
goal?: string;
|
|
391
|
+
/** @description Token cost for processing the full page content */
|
|
271
392
|
pageTokens: number;
|
|
393
|
+
/** @description The specific page that was crawled */
|
|
272
394
|
result: {
|
|
273
395
|
url: string;
|
|
274
396
|
};
|
|
@@ -309,7 +431,7 @@ type ResearchStreamEvent = ResearchEvent;
|
|
|
309
431
|
*/
|
|
310
432
|
type ResearchCreateParamsTyped<T> = {
|
|
311
433
|
instructions: string;
|
|
312
|
-
model?: "
|
|
434
|
+
model?: ResearchCreateRequest["model"];
|
|
313
435
|
outputSchema?: T;
|
|
314
436
|
};
|
|
315
437
|
type ResearchDefinitionEvent = Extract<ResearchEvent, {
|
|
@@ -354,7 +476,7 @@ declare class ResearchClient extends ResearchBaseClient {
|
|
|
354
476
|
create<T>(params: ResearchCreateParamsTyped<ZodSchema<T>>): Promise<ResearchCreateResponse>;
|
|
355
477
|
create(params: {
|
|
356
478
|
instructions: string;
|
|
357
|
-
model?: "
|
|
479
|
+
model?: ResearchCreateRequest["model"];
|
|
358
480
|
outputSchema?: Record<string, unknown>;
|
|
359
481
|
}): Promise<ResearchCreateResponse>;
|
|
360
482
|
get(researchId: string): Promise<Research>;
|
|
@@ -510,7 +632,7 @@ interface components {
|
|
|
510
632
|
metadata?: {
|
|
511
633
|
[key: string]: string;
|
|
512
634
|
};
|
|
513
|
-
/** @description The size of the file in
|
|
635
|
+
/** @description The size of the file in bytes. Maximum size is 50 MB. */
|
|
514
636
|
size: number;
|
|
515
637
|
/** @description The title of the import */
|
|
516
638
|
title?: string;
|
|
@@ -638,6 +760,13 @@ interface components {
|
|
|
638
760
|
*
|
|
639
761
|
* Enrichments automatically search for and extract specific information (like contact details, funding data, employee counts, etc.) from each item added to your Webset. */
|
|
640
762
|
enrichments?: components["schemas"]["CreateEnrichmentParameters"][];
|
|
763
|
+
/** @description Global exclusion sources (existing imports or websets) that apply to all operations within this Webset. Any results found within these sources will be omitted across all search and import operations. */
|
|
764
|
+
exclude?: {
|
|
765
|
+
/** @description The ID of the source to exclude. */
|
|
766
|
+
id: string;
|
|
767
|
+
/** @enum {string} */
|
|
768
|
+
source: WebsetExcludeSource;
|
|
769
|
+
}[];
|
|
641
770
|
/** @description The external identifier for the webset.
|
|
642
771
|
*
|
|
643
772
|
* You can use this to reference the Webset by your own internal identifiers. */
|
|
@@ -675,7 +804,7 @@ interface components {
|
|
|
675
804
|
/** @description The ID of the source to exclude. */
|
|
676
805
|
id: string;
|
|
677
806
|
/** @enum {string} */
|
|
678
|
-
source:
|
|
807
|
+
source: WebsetExcludeSource;
|
|
679
808
|
}[];
|
|
680
809
|
/** @description Natural language search query describing what you are looking for.
|
|
681
810
|
*
|
|
@@ -726,7 +855,7 @@ interface components {
|
|
|
726
855
|
/** @description The ID of the source to exclude. */
|
|
727
856
|
id: string;
|
|
728
857
|
/** @enum {string} */
|
|
729
|
-
source:
|
|
858
|
+
source: WebsetExcludeSource;
|
|
730
859
|
}[];
|
|
731
860
|
/** @description Set of key-value pairs you want to associate with this object. */
|
|
732
861
|
metadata?: {
|
|
@@ -1941,7 +2070,7 @@ interface components {
|
|
|
1941
2070
|
exclude: {
|
|
1942
2071
|
id: string;
|
|
1943
2072
|
/** @enum {string} */
|
|
1944
|
-
source:
|
|
2073
|
+
source: WebsetExcludeSource;
|
|
1945
2074
|
}[];
|
|
1946
2075
|
/** @description The unique identifier for the search */
|
|
1947
2076
|
id: string;
|
|
@@ -2209,7 +2338,7 @@ declare enum WebsetItemEvaluationSatisfied {
|
|
|
2209
2338
|
no = "no",
|
|
2210
2339
|
unclear = "unclear"
|
|
2211
2340
|
}
|
|
2212
|
-
declare enum
|
|
2341
|
+
declare enum WebsetExcludeSource {
|
|
2213
2342
|
import = "import",
|
|
2214
2343
|
webset = "webset"
|
|
2215
2344
|
}
|
|
@@ -3313,4 +3442,4 @@ declare class Exa {
|
|
|
3313
3442
|
private parseSSEStream;
|
|
3314
3443
|
}
|
|
3315
3444
|
|
|
3316
|
-
export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, type CreateWebsetSearchParameters, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type ListResearchRequest, type ListResearchResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type PreviewWebsetParameters, type PreviewWebsetResponse, type RegularSearchOptions, type Research, type ResearchCreateParamsTyped, type ResearchCreateRequest, type ResearchCreateResponse, type ResearchDefinitionEvent, type ResearchEvent, type ResearchOperation, type ResearchOutputEvent, type ResearchPaperEntity, type ResearchPlanDefinitionEvent, type ResearchPlanOperationEvent, type ResearchPlanOutputEvent, type ResearchStatus, type ResearchStreamEvent, type ResearchStreamEventTyped, type ResearchTaskDefinitionEvent, type ResearchTaskOperationEvent, type ResearchTaskOutputEvent, type ResearchTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateEnrichmentParameters, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, type WebsetHeadersLike, WebsetImportSource, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason,
|
|
3445
|
+
export { type AnswerOptions, type AnswerOptionsTyped, type AnswerResponse, type AnswerResponseTyped, type AnswerStreamChunk, type AnswerStreamResponse, type ArticleEntity, type BaseSearchOptions, type CompanyEntity, type ContentsOptions, type ContentsResultComponent, type ContextOptions, type CostDollars, type CostDollarsContents, type CostDollarsSeearch, type CreateCriterionParameters, type CreateEnrichmentParameters, CreateEnrichmentParametersFormat, type CreateImportParameters, CreateImportParametersFormat, type CreateImportResponse, type CreateImportWithCsvParameters, type CreateMonitorParameters, type CreateWebhookParameters, type CreateWebsetParameters, type CreateWebsetSearchParameters, type CsvDataInput, type CustomEntity, type Default, type EnrichmentResult, type Entity, type Event, EventType, EventsClient, Exa, ExaError, type ExtrasOptions, type ExtrasResponse, type FindSimilarOptions, type GetWebsetResponse, type HighlightsContentsOptions, type HighlightsResponse, HttpStatusCode, type Import, ImportFailedReason, ImportFormat, ImportObject, ImportStatus, ImportsClient, type JSONSchema, type ListEventsResponse, type ListImportsResponse, type ListMonitorRunsResponse, type ListMonitorsOptions, type ListMonitorsResponse, type ListResearchRequest, type ListResearchResponse, type ListWebhookAttemptsResponse, type ListWebhooksResponse, type ListWebsetItemResponse, type ListWebsetItemsOptions, type ListWebsetsResponse, type LivecrawlOptions, type Monitor, type MonitorBehavior, type MonitorCadence, MonitorObject, type MonitorRun, MonitorRunObject, MonitorRunStatus, MonitorRunType, MonitorStatus, type PersonEntity, type PreviewWebsetParameters, type PreviewWebsetResponse, type RegularSearchOptions, type Research, type ResearchCreateParamsTyped, type ResearchCreateRequest, type ResearchCreateResponse, type ResearchDefinitionEvent, type ResearchEvent, type ResearchOperation, type ResearchOutputEvent, type ResearchPaperEntity, type ResearchPlanDefinitionEvent, type ResearchPlanOperationEvent, type ResearchPlanOutputEvent, type ResearchStatus, type ResearchStreamEvent, type ResearchStreamEventTyped, type ResearchTaskDefinitionEvent, type ResearchTaskOperationEvent, type ResearchTaskOutputEvent, type ResearchTyped, type SearchResponse, type SearchResult, type Status, type SubpagesResponse, type SummaryContentsOptions, type SummaryContentsOptionsTyped, type SummaryResponse, type TextContentsOptions, type TextResponse, type UpdateEnrichmentParameters, type UpdateImport, type UpdateMonitor, UpdateMonitorStatus, type UpdateWebhookParameters, type UpdateWebsetRequest, type WaitUntilCompletedOptions, type Webhook, type WebhookAttempt, WebhookStatus, type Webset, type WebsetEnrichment, WebsetEnrichmentFormat, WebsetEnrichmentStatus, WebsetEnrichmentsClient, WebsetExcludeSource, type WebsetHeadersLike, WebsetImportSource, type WebsetItem, type WebsetItemArticleProperties, type WebsetItemCompanyProperties, type WebsetItemCustomProperties, type WebsetItemEvaluation, WebsetItemEvaluationSatisfied, type WebsetItemPersonProperties, type WebsetItemResearchPaperProperties, WebsetItemSource, WebsetItemsClient, WebsetMonitorsClient, type WebsetSearch, WebsetSearchBehavior, WebsetSearchCanceledReason, WebsetSearchScopeSource, WebsetSearchStatus, WebsetSearchesClient, WebsetStatus, WebsetWebhooksClient, WebsetsClient, Exa as default };
|