higherdata-sdk 0.6.0 → 0.7.0

package/dist/index.js

@@ -273,7 +273,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "account.limits",
-    "description": "Returns the current plan rate limits, concurrency and monthly email verification allowance.",
+    "description": "Returns the current plan rate limits, concurrency and available purchased verify credit balance.",
     "risk": "read",
     "scopes": [],
     "input": {
@@ -458,7 +458,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "account.usage",
-    "description": "Returns monthly activity, the email verification allowance and its reset time.",
+    "description": "Returns monthly activity, the available purchased verify credit balance.",
     "risk": "read",
     "scopes": [],
     "input": {
@@ -1921,7 +1921,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "email.find",
-    "description": "Find a person's work email from company pattern evidence. Tries at most three candidates in order and stops at the first deliverable. Dry run only plans candidates. Use the returned requestId to read or continue pending work.",
+    "description": "Find a person's work email from company pattern evidence. Tries at most three candidates in order and stops at the first deliverable. At zero verify credits, returns the best available pattern guess marked unverified. Dry run only plans candidates. Use the returned requestId to read or continue pending work.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -1932,6 +1932,11 @@ var TOOL_CATALOG = [
         {
           "type": "object",
           "properties": {
+            "personId": {
+              "description": "Stable person id to attach the verified email to.",
+              "type": "string",
+              "pattern": "^hdp_[0-9a-f]{32}$"
+            },
             "firstName": {
               "type": "string",
               "minLength": 1,
@@ -1970,6 +1975,11 @@ var TOOL_CATALOG = [
                   "minLength": 1,
                   "maxLength": 240
                 },
+                "linkedinUrl": {
+                  "description": "LinkedIn company page URL.",
+                  "type": "string",
+                  "maxLength": 2048
+                },
                 "city": {
                   "description": "City of the headquarters.",
                   "type": "string",
@@ -2519,7 +2529,7 @@ var TOOL_CATALOG = [
                 }
               },
               "additionalProperties": false,
-              "description": "Company to match. Supply an id, a domain, or a name."
+              "description": "Company to match. Supply an id, a domain, a LinkedIn URL, or a name."
             }
           },
           "required": [
@@ -2549,7 +2559,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "email.verify",
-    "description": "Verify one email address. Dry run spends nothing. Returns a requestId for pending work; call this tool with requestId to read or continue it. Verification results use deliverable, undeliverable, risky or unknown.",
+    "description": "Verify one email address not already held for a contact. API callers may explicitly pass force to verify an existing address. Provider answers use purchased verify credits; cached answers are free. Dry run spends nothing. Returns a requestId for pending work; call this tool with requestId to read or continue it. Verification results use deliverable, undeliverable, risky or unknown.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -2560,12 +2570,21 @@ var TOOL_CATALOG = [
         {
           "type": "object",
           "properties": {
+            "personId": {
+              "description": "Stable person id to attach the verified email to.",
+              "type": "string",
+              "pattern": "^hdp_[0-9a-f]{32}$"
+            },
             "email": {
               "type": "string",
               "maxLength": 320,
               "format": "email",
               "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
               "description": "Work email address to verify."
+            },
+            "force": {
+              "description": "API override to verify an address already held for a contact. Not offered in the UI.",
+              "type": "boolean"
             }
           },
           "required": [
@@ -2774,7 +2793,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "enrich.company",
-    "description": "Compare a company record with HigherData Core, using stable id, exact domain, then exact name and location. Name matches always require review. Dry run returns comparisons without recording them.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Compare a company record with HigherData Core, using stable id, LinkedIn URL, exact domain, then exact name and location. Name matches always require review. Dry run returns comparisons without recording them.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "write_local",
     "scopes": [
       "data:read",
@@ -2801,6 +2820,11 @@ var TOOL_CATALOG = [
           "minLength": 1,
           "maxLength": 240
         },
+        "linkedinUrl": {
+          "description": "LinkedIn company page URL.",
+          "type": "string",
+          "maxLength": 2048
+        },
         "city": {
           "description": "City of the headquarters.",
           "type": "string",
@@ -3350,7 +3374,7 @@ var TOOL_CATALOG = [
         }
       },
       "additionalProperties": false,
-      "description": "Company to match. Supply an id, a domain, or a name."
+      "description": "Company to match. Supply an id, a domain, a LinkedIn URL, or a name."
     }
   },
   {
@@ -3424,8 +3448,7 @@ var TOOL_CATALOG = [
         "linkedinUrl": {
           "description": "LinkedIn person profile URL.",
           "type": "string",
-          "maxLength": 2048,
-          "format": "uri"
+          "maxLength": 2048
         },
         "name": {
           "description": "Person's full name.",
@@ -3434,7 +3457,7 @@ var TOOL_CATALOG = [
           "maxLength": 240
         },
         "company": {
-          "description": "Company this person works at. Supply an id, a domain, or a name.",
+          "description": "Company this person works at. Supply an id, a domain, a LinkedIn URL, or a name.",
           "type": "object",
           "properties": {
             "id": {
@@ -3454,6 +3477,11 @@ var TOOL_CATALOG = [
               "minLength": 1,
               "maxLength": 240
             },
+            "linkedinUrl": {
+              "description": "LinkedIn company page URL.",
+              "type": "string",
+              "maxLength": 2048
+            },
             "city": {
               "description": "City of the headquarters.",
               "type": "string",
@@ -6108,6 +6136,14 @@ var TOOL_CATALOG = [
                         "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                       }
                     },
+                    "sort": {
+                      "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+                      "type": "string",
+                      "enum": [
+                        "company_size_desc",
+                        "company_size_asc"
+                      ]
+                    },
                     "firstName": {
                       "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
                       "type": "string",
@@ -6236,7 +6272,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "lists.export",
-    "description": "Export a saved list as paged CSV or JSONL with opaque ids. CSV escapes spreadsheet formulas. Pages contain at most 50 records.Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Export a saved list as paged CSV or JSONL with opaque ids. CSV escapes spreadsheet formulas. Pages contain at most 50 records.Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -6425,7 +6461,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "lookup.company",
-    "description": "Look up a company by exactly one domain, exact or near name (optionally with location), or opaque hdo_ id. Returns bounded candidates and ambiguity metadata.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Look up a company by exactly one domain, exact or near name (optionally with location), LinkedIn company page URL, or opaque hdo_ id, or up to 100 ids. Returns bounded candidates and ambiguity metadata.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -6450,7 +6486,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6493,7 +6529,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6513,7 +6549,7 @@ var TOOL_CATALOG = [
               "description": "Opaque company id (hdo_)."
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6523,6 +6559,59 @@ var TOOL_CATALOG = [
             "id"
           ],
           "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "ids": {
+              "minItems": 1,
+              "maxItems": 100,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "pattern": "^hdo_[0-9a-f]{32}$",
+                "description": "Opaque company id (hdo_)."
+              },
+              "description": "Look up up to 100 opaque company ids in one call."
+            },
+            "excludeListId": {
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          "required": [
+            "ids"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "linkedinUrl": {
+              "type": "string",
+              "maxLength": 2048,
+              "description": "LinkedIn company page URL."
+            },
+            "candidateLimit": {
+              "default": 5,
+              "description": "Maximum candidates to return.",
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 5
+            },
+            "excludeListId": {
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+              "type": "string",
+              "format": "uuid",
+              "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            }
+          },
+          "required": [
+            "linkedinUrl"
+          ],
+          "additionalProperties": false
         }
       ]
     }
@@ -6538,6 +6627,12 @@ var TOOL_CATALOG = [
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "type": "object",
       "properties": {
+        "excludeListId": {
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
+          "type": "string",
+          "format": "uuid",
+          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
         "companyId": {
           "description": "Select a company from a previous ambiguous company-scoped lookup.",
           "type": "string",
@@ -6584,7 +6679,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6611,7 +6706,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6651,7 +6746,7 @@ var TOOL_CATALOG = [
               "maximum": 20
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6668,7 +6763,6 @@ var TOOL_CATALOG = [
             "linkedinUrl": {
               "type": "string",
               "maxLength": 2048,
-              "format": "uri",
               "description": "LinkedIn person profile URL."
             },
             "candidateLimit": {
@@ -6679,7 +6773,7 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
@@ -6706,10 +6800,14 @@ var TOOL_CATALOG = [
               "maximum": 5
             },
             "excludeListId": {
-              "description": "Saved list whose members are left out of the result.",
+              "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
               "type": "string",
               "format": "uuid",
               "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+            },
+            "includeEmployment": {
+              "description": "Include current and past jobs for this person, with suppression applied to each job.",
+              "type": "boolean"
             }
           },
           "required": [
@@ -6722,7 +6820,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "search.companies",
-    "description": "Find companies in HigherData Core using explicit filters. Optional domain uses exact website-host matching and ranks root sites first. Pages contain at most 50 records and opaque ids.  Insights fields and filters require the Insights or Unlimited plan.",
+    "description": "Find companies in HigherData Core using explicit filters. Optional domain uses exact website-host matching and ranks root sites first. Interactive pages contain at most 50 records. A download (download: true) contains at most 500 records and opaque ids.  Insights fields and filters require the Insights or Complete plan.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -7073,10 +7171,10 @@ var TOOL_CATALOG = [
         },
         "limit": {
           "default": 50,
-          "description": "Maximum records in this page.",
+          "description": "Maximum records in this page. Interactive search accepts at most 50. A download (download true) accepts at most 500.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 50
+          "maximum": 500
         },
         "cursor": {
           "description": "Cursor from the previous page. Omit it for the first page.",
@@ -7766,10 +7864,14 @@ var TOOL_CATALOG = [
           "additionalProperties": false
         },
         "excludeListId": {
-          "description": "Saved list whose members are left out of the result.",
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
           "type": "string",
           "format": "uuid",
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "download": {
+          "description": "Set true to download a page. Interactive search stays at 50 records. The server reads this flag from the request, not from a plan or role.",
+          "type": "boolean"
         }
       },
       "additionalProperties": false
@@ -8813,7 +8915,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "search.count_people",
-    "description": "Count people once by primary current job before suppression using release-built aggregates; search results may match other current jobs. Unsupported refinements return a qualified baseline. exact: true explicitly requests one capped detailed count of matching people; never use it for live filtering.",
+    "description": "Count people once by primary current job before suppression using release-built aggregates; search results may match other current jobs. Names and email use exact indexed counts. Unsupported refinements return an unavailable count, never a total that ignores them. exact: true explicitly requests one capped detailed count of matching people; never use it for live filtering.",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -9528,7 +9630,7 @@ var TOOL_CATALOG = [
         },
         "exact": {
           "default": false,
-          "description": "Explicitly run a detailed capped count instead of a rollup estimate. Never enable for live filtering.",
+          "description": "Explicitly request a detailed count when an indexed count is unavailable. Never enable for live filtering.",
           "type": "boolean"
         }
       },
@@ -9639,7 +9741,7 @@ var TOOL_CATALOG = [
   },
   {
     "name": "search.people",
-    "description": "Find people in HigherData Core, with 1 to 5 positive company HQ country codes or industries required unless a company id, company name, domain or indexed email scopes the search. Unscoped person names use indexed tokens and bounded, ranked pages. Person, job and company location use distinct filters; each city filter requires its corresponding country. Company-scoped contacts also support legacy contactLocation filters. Pages contain at most 50 people and opaque ids. ",
+    "description": "Find people in HigherData Core, with 1 to 5 positive company HQ country codes or industries required unless a company id, company name, domain or indexed email scopes the search. Unscoped person names use indexed tokens and bounded, ranked pages. Person, job and company location use distinct filters; each city filter requires its corresponding country. Company-scoped contacts also support legacy contactLocation filters. Interactive pages contain at most 50 people. A download (download: true) contains at most 500 people and opaque ids. ",
     "risk": "read",
     "scopes": [
       "data:read"
@@ -10285,12 +10387,20 @@ var TOOL_CATALOG = [
             "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
           }
         },
+        "sort": {
+          "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+          "type": "string",
+          "enum": [
+            "company_size_desc",
+            "company_size_asc"
+          ]
+        },
         "limit": {
           "default": 50,
-          "description": "Maximum records in this page.",
+          "description": "Maximum records in this page. Interactive search accepts at most 50. A download (download true) accepts at most 500.",
           "type": "integer",
           "minimum": 1,
-          "maximum": 50
+          "maximum": 500
         },
         "cursor": {
           "description": "Cursor from the previous page. Omit it for the first page.",
@@ -10359,10 +10469,14 @@ var TOOL_CATALOG = [
           "additionalProperties": false
         },
         "excludeListId": {
-          "description": "Saved list whose members are left out of the result.",
+          "description": "Ignore one suppression list for this call only, tenant owner only. Allowed kinds: customers, open_deals, competitors, partners, employees, custom. Do not contact, opt-out and global erasure rules cannot be lifted.",
           "type": "string",
           "format": "uuid",
           "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+        },
+        "download": {
+          "description": "Set true to download a page. Interactive search stays at 50 records. The server reads this flag from the request, not from a plan or role.",
+          "type": "boolean"
         }
       },
       "additionalProperties": false
@@ -13149,6 +13263,14 @@ var TOOL_CATALOG = [
                         "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                       }
                     },
+                    "sort": {
+                      "description": "Sort by primary company employee estimate, largest or smallest first. Unknown sizes come last. Available from the November 2026 release.",
+                      "type": "string",
+                      "enum": [
+                        "company_size_desc",
+                        "company_size_asc"
+                      ]
+                    },
                     "firstName": {
                       "description": "First name tokens, using accent-folded fuzzy matching. Requires companyId.",
                       "type": "string",
@@ -13588,23 +13710,35 @@ var TOOL_CATALOG = [
 
 // src/transport.ts
 import { z } from "zod";
-var failure = z.object({ error: z.union([z.string(), z.object({ code: z.string().max(128), message: z.string().max(2048).optional(), retry_after: z.number().nonnegative().finite().optional() })]) });
+var failure = z.object({ error: z.union([z.string(), z.object({ code: z.string().max(128), message: z.string().max(2048).optional(), billing_href: z.string().max(2048).optional(), retry_after: z.number().nonnegative().finite().optional() })]) });
 var HigherDataError = class extends Error {
-  constructor(message, code, status = 0, retryAfter2, requestId) {
+  constructor(message, code, status = 0, retryAfter2, requestId, billingHref) {
     super(message);
     this.code = code;
     this.status = status;
     this.retryAfter = retryAfter2;
     this.requestId = requestId;
+    this.billingHref = billingHref;
     this.name = "HigherDataError";
   }
   code;
   status;
   retryAfter;
   requestId;
+  billingHref;
 };
 var limits = z.object({ maxRetries: z.number().int().min(0).max(5), timeoutMs: z.number().int().min(1).max(3e5), maxRetryDelayMs: z.number().int().min(0).max(3e5) });
 var MAX_RESPONSE = 8 * 1024 * 1024;
+var DOWNLOAD_PAGE_ROWS = 500;
+var INTERACTIVE_PAGE_ROWS = 50;
+function responseByteLimit(path, input) {
+  const name = path.split("?")[0]?.split("/").at(-1);
+  if (name !== "search.companies" && name !== "search.people") return MAX_RESPONSE;
+  if (!input || typeof input !== "object" || Array.isArray(input) || input.download !== true) return MAX_RESPONSE;
+  const limit = input.limit;
+  const rows = typeof limit === "number" && Number.isInteger(limit) && limit >= 1 ? Math.min(limit, DOWNLOAD_PAGE_ROWS) : INTERACTIVE_PAGE_ROWS;
+  return MAX_RESPONSE * Math.ceil(rows / INTERACTIVE_PAGE_ROWS);
+}
 function retryAfter(response, data, now) {
   const value = response.headers.get("retry-after");
   if (value !== null) {
@@ -13621,9 +13755,9 @@ function retryAfter(response, data, now) {
 }
 function apiError(response, data, now) {
   const parsed = failure.safeParse(data), error = parsed.success ? parsed.data.error : null;
-  return new HigherDataError(typeof error === "object" && error?.message ? error.message : "The HigherData API request failed.", typeof error === "string" ? error : error?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0);
+  return new HigherDataError(typeof error === "object" && error?.message ? error.message : "The HigherData API request failed.", typeof error === "string" ? error : error?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0, typeof error === "object" ? error?.billing_href : void 0);
 }
-async function responseJson(response) {
+async function responseJson(response, maxBytes) {
   if (!response.body) throw new HigherDataError("The API returned an invalid response.", "invalid_response");
   const reader = response.body.getReader(), chunks = [];
   let length = 0;
@@ -13632,7 +13766,7 @@ async function responseJson(response) {
       const { done, value } = await reader.read();
       if (done) break;
       length += value.byteLength;
-      if (length > MAX_RESPONSE) {
+      if (length > maxBytes) {
         await reader.cancel();
         throw new HigherDataError("The API response exceeded the size limit.", "response_too_large");
       }
@@ -13706,7 +13840,7 @@ var JsonTransport = class {
         const timeout = AbortSignal.timeout(options.timeoutMs ?? this.settings.timeoutMs);
         response = await (this.options.fetch ?? fetch)(url.toString(), { method: "POST", headers, body, redirect: "manual", signal: options.signal ? AbortSignal.any([timeout, options.signal]) : timeout });
         try {
-          data = await responseJson(response);
+          data = await responseJson(response, responseByteLimit(path, input));
         } catch (error2) {
           if (response.ok) throw error2;
           data = void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "higherdata-sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Typed HigherData API client generated from the tool registry.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -24,7 +24,7 @@
     "directory": "packages/sdk"
   },
   "higherdata": {
-    "minimumServerVersion": "0.2.0"
+    "minimumServerVersion": "0.7.0"
   },
   "scripts": {
     "build": "npm run sdk:generate --prefix ../.. && tsup",