exa-js 2.0.3 → 2.0.6

package/dist/index.d.mts

@@ -771,7 +771,7 @@ interface components {
              *
              *     You can use this to reference the Webset by your own internal identifiers. */
             externalId?: string;
-            /** @description Import data from existing Websets and Imports into this Webset. */
+            /** @description Attach/load data from existing Imports or Websets into this Webset. For CSV Imports, this schedules ingestion and creates a staging pool of items (ImportItems do not automatically appear as Webset Items; searches create Webset Items). This does not filter searches. To filter a search to only look within an Import or Webset, use search.scope instead. */
             import?: {
                 /** @description The ID of the source to search. */
                 id: string;
@@ -815,13 +815,14 @@ interface components {
                 /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
                  *     Result of the analysis will be available in the `recall` field within the search request. */
                 recall?: boolean;
-                /** @description Limit the search to specific sources (existing imports or websets). Any results found within these sources matching the search criteria will be included in the Webset. */
+                /** @description Limit this search to only consider candidates from the listed sources (existing Imports or Websets). Scope applies per-search; if you run another search and want to stay within the same dataset, pass scope again. When scope is present, the search behavior is OVERRIDE (replaces results rather than appending). Note: Using the same Import in both top-level import and search.scope will return a 400 error. */
                 scope?: {
                     /** @description The ID of the source to search. */
                     id: string;
                     relationship?: {
-                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
+                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. Only needed for hop searches (graph traversal) from the source entities to related targets. Examples: "investors of", "current employer", "employees at". Omit for simple filtering within the source. */
                         definition: string;
+                        /** @description Number of related entities to find per source entity (fanout). Only used for hop searches. Range: 1-10. */
                         limit: number;
                     };
                     /** @enum {string} */
@@ -1550,6 +1551,11 @@ interface components {
         };
         PreviewWebsetParameters: {
             search: {
+                /**
+                 * @description When query parameter search=true, the number of preview items to return.
+                 * @default 10
+                 */
+                count: number;
                 /** @description Entity used to inform the decomposition.
                  *
                  *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
@@ -1576,6 +1582,8 @@ interface components {
                     label: string;
                 }[];
             }[];
+            /** @description Preview items matching the search criteria. */
+            items: components["schemas"]["WebsetItemPreview"][];
             search: {
                 /** @description Detected criteria from the query. */
                 criteria: {
@@ -2013,6 +2021,17 @@ interface components {
              */
             url: string;
         };
+        WebsetItemPreview: {
+            /**
+             * Format: date-time
+             * @description The date and time the preview was created
+             */
+            createdAt: string;
+            /** @description The unique identifier for the preview item */
+            id: string;
+            /** @description The properties of the preview item */
+            properties: components["schemas"]["WebsetItemPersonProperties"] | components["schemas"]["WebsetItemCompanyProperties"] | components["schemas"]["WebsetItemArticleProperties"] | components["schemas"]["WebsetItemResearchPaperProperties"] | components["schemas"]["WebsetItemCustomProperties"];
+        };
         WebsetItemResearchPaperProperties: {
             /** @description The text content of the research paper */
             content: string | null;

package/dist/index.d.ts

@@ -771,7 +771,7 @@ interface components {
              *
              *     You can use this to reference the Webset by your own internal identifiers. */
             externalId?: string;
-            /** @description Import data from existing Websets and Imports into this Webset. */
+            /** @description Attach/load data from existing Imports or Websets into this Webset. For CSV Imports, this schedules ingestion and creates a staging pool of items (ImportItems do not automatically appear as Webset Items; searches create Webset Items). This does not filter searches. To filter a search to only look within an Import or Webset, use search.scope instead. */
             import?: {
                 /** @description The ID of the source to search. */
                 id: string;
@@ -815,13 +815,14 @@ interface components {
                 /** @description Whether to provide an estimate of how many total relevant results could exist for this search.
                  *     Result of the analysis will be available in the `recall` field within the search request. */
                 recall?: boolean;
-                /** @description Limit the search to specific sources (existing imports or websets). Any results found within these sources matching the search criteria will be included in the Webset. */
+                /** @description Limit this search to only consider candidates from the listed sources (existing Imports or Websets). Scope applies per-search; if you run another search and want to stay within the same dataset, pass scope again. When scope is present, the search behavior is OVERRIDE (replaces results rather than appending). Note: Using the same Import in both top-level import and search.scope will return a 400 error. */
                 scope?: {
                     /** @description The ID of the source to search. */
                     id: string;
                     relationship?: {
-                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. */
+                        /** @description What the relationship of the entities you hope to find is relative to the entities contained in the provided source. Only needed for hop searches (graph traversal) from the source entities to related targets. Examples: "investors of", "current employer", "employees at". Omit for simple filtering within the source. */
                         definition: string;
+                        /** @description Number of related entities to find per source entity (fanout). Only used for hop searches. Range: 1-10. */
                         limit: number;
                     };
                     /** @enum {string} */
@@ -1550,6 +1551,11 @@ interface components {
         };
         PreviewWebsetParameters: {
             search: {
+                /**
+                 * @description When query parameter search=true, the number of preview items to return.
+                 * @default 10
+                 */
+                count: number;
                 /** @description Entity used to inform the decomposition.
                  *
                  *     It is not required to provide it, we automatically detect the entity from all the information provided in the query. Only use this when you need more fine control. */
@@ -1576,6 +1582,8 @@ interface components {
                     label: string;
                 }[];
             }[];
+            /** @description Preview items matching the search criteria. */
+            items: components["schemas"]["WebsetItemPreview"][];
             search: {
                 /** @description Detected criteria from the query. */
                 criteria: {
@@ -2013,6 +2021,17 @@ interface components {
              */
             url: string;
         };
+        WebsetItemPreview: {
+            /**
+             * Format: date-time
+             * @description The date and time the preview was created
+             */
+            createdAt: string;
+            /** @description The unique identifier for the preview item */
+            id: string;
+            /** @description The properties of the preview item */
+            properties: components["schemas"]["WebsetItemPersonProperties"] | components["schemas"]["WebsetItemCompanyProperties"] | components["schemas"]["WebsetItemArticleProperties"] | components["schemas"]["WebsetItemResearchPaperProperties"] | components["schemas"]["WebsetItemCustomProperties"];
+        };
         WebsetItemResearchPaperProperties: {
             /** @description The text content of the research paper */
             content: string | null;

package/dist/index.js

@@ -74,7 +74,7 @@ var import_cross_fetch = __toESM(require("cross-fetch"));
 // package.json
 var package_default = {
   name: "exa-js",
-  version: "2.0.3",
+  version: "2.0.6",
   description: "Exa SDK for Node.js and the browser",
   publishConfig: {
     access: "public"