higherdata 0.6.0 → 0.7.0

package/dist/index.js

@@ -20878,7 +20878,7 @@ var init_generated = __esm({
       },
       {
         "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": {
@@ -21063,7 +21063,7 @@ var init_generated = __esm({
       },
       {
         "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": {
@@ -22526,7 +22526,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -22537,6 +22537,11 @@ var init_generated = __esm({
             {
               "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,
@@ -22575,6 +22580,11 @@ var init_generated = __esm({
                       "minLength": 1,
                       "maxLength": 240
                     },
+                    "linkedinUrl": {
+                      "description": "LinkedIn company page URL.",
+                      "type": "string",
+                      "maxLength": 2048
+                    },
                     "city": {
                       "description": "City of the headquarters.",
                       "type": "string",
@@ -23124,7 +23134,7 @@ var init_generated = __esm({
                     }
                   },
                   "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": [
@@ -23154,7 +23164,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -23165,12 +23175,21 @@ var init_generated = __esm({
             {
               "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": [
@@ -23379,7 +23398,7 @@ var init_generated = __esm({
       },
       {
         "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",
@@ -23406,6 +23425,11 @@ var init_generated = __esm({
               "minLength": 1,
               "maxLength": 240
             },
+            "linkedinUrl": {
+              "description": "LinkedIn company page URL.",
+              "type": "string",
+              "maxLength": 2048
+            },
             "city": {
               "description": "City of the headquarters.",
               "type": "string",
@@ -23955,7 +23979,7 @@ var init_generated = __esm({
             }
           },
           "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."
         }
       },
       {
@@ -24029,8 +24053,7 @@ var init_generated = __esm({
             "linkedinUrl": {
               "description": "LinkedIn person profile URL.",
               "type": "string",
-              "maxLength": 2048,
-              "format": "uri"
+              "maxLength": 2048
             },
             "name": {
               "description": "Person's full name.",
@@ -24039,7 +24062,7 @@ var init_generated = __esm({
               "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": {
@@ -24059,6 +24082,11 @@ var init_generated = __esm({
                   "minLength": 1,
                   "maxLength": 240
                 },
+                "linkedinUrl": {
+                  "description": "LinkedIn company page URL.",
+                  "type": "string",
+                  "maxLength": 2048
+                },
                 "city": {
                   "description": "City of the headquarters.",
                   "type": "string",
@@ -26713,6 +26741,14 @@ var init_generated = __esm({
                             "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",
@@ -26841,7 +26877,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -27030,7 +27066,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -27055,7 +27091,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27098,7 +27134,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27118,7 +27154,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27128,6 +27164,59 @@ var init_generated = __esm({
                 "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
             }
           ]
         }
@@ -27143,6 +27232,12 @@ var init_generated = __esm({
           "$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",
@@ -27189,7 +27284,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27216,7 +27311,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27256,7 +27351,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27273,7 +27368,6 @@ var init_generated = __esm({
                 "linkedinUrl": {
                   "type": "string",
                   "maxLength": 2048,
-                  "format": "uri",
                   "description": "LinkedIn person profile URL."
                 },
                 "candidateLimit": {
@@ -27284,7 +27378,7 @@ var init_generated = __esm({
                   "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)$"
@@ -27311,10 +27405,14 @@ var init_generated = __esm({
                   "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": [
@@ -27327,7 +27425,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -27678,10 +27776,10 @@ var init_generated = __esm({
             },
             "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.",
@@ -28371,10 +28469,14 @@ var init_generated = __esm({
               "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
@@ -29418,7 +29520,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -30133,7 +30235,7 @@ var init_generated = __esm({
             },
             "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"
             }
           },
@@ -30244,7 +30346,7 @@ var init_generated = __esm({
       },
       {
         "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"
@@ -30890,12 +30992,20 @@ var init_generated = __esm({
                 "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.",
@@ -30964,10 +31074,14 @@ var init_generated = __esm({
               "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
@@ -33754,6 +33868,14 @@ var init_generated = __esm({
                             "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",
@@ -34194,6 +34316,14 @@ var init_generated = __esm({
 });
 
 // ../sdk/src/transport.ts
+function responseByteLimit(path2, input2) {
+  const name2 = path2.split("?")[0]?.split("/").at(-1);
+  if (name2 !== "search.companies" && name2 !== "search.people") return MAX_RESPONSE;
+  if (!input2 || typeof input2 !== "object" || Array.isArray(input2) || input2.download !== true) return MAX_RESPONSE;
+  const limit = input2.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) {
@@ -34210,9 +34340,9 @@ function retryAfter(response, data, now) {
 }
 function apiError(response, data, now) {
   const parsed = failure2.safeParse(data), error63 = parsed.success ? parsed.data.error : null;
-  return new HigherDataError(typeof error63 === "object" && error63?.message ? error63.message : "The HigherData API request failed.", typeof error63 === "string" ? error63 : error63?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0);
+  return new HigherDataError(typeof error63 === "object" && error63?.message ? error63.message : "The HigherData API request failed.", typeof error63 === "string" ? error63 : error63?.code ?? "http_error", response.status, retryAfter(response, data, now), response.headers.get("x-request-id") ?? void 0, typeof error63 === "object" ? error63?.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;
@@ -34221,7 +34351,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");
       }
@@ -34258,28 +34388,32 @@ function delay(ms, signal) {
     signal?.addEventListener("abort", abort, { once: true });
   });
 }
-var failure2, HigherDataError, limits, MAX_RESPONSE, JsonTransport;
+var failure2, HigherDataError, limits, MAX_RESPONSE, DOWNLOAD_PAGE_ROWS, INTERACTIVE_PAGE_ROWS, JsonTransport;
 var init_transport = __esm({
   "../sdk/src/transport.ts"() {
     "use strict";
     init_zod();
-    failure2 = external_exports.object({ error: external_exports.union([external_exports.string(), external_exports.object({ code: external_exports.string().max(128), message: external_exports.string().max(2048).optional(), retry_after: external_exports.number().nonnegative().finite().optional() })]) });
+    failure2 = external_exports.object({ error: external_exports.union([external_exports.string(), external_exports.object({ code: external_exports.string().max(128), message: external_exports.string().max(2048).optional(), billing_href: external_exports.string().max(2048).optional(), retry_after: external_exports.number().nonnegative().finite().optional() })]) });
     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;
     };
     limits = external_exports.object({ maxRetries: external_exports.number().int().min(0).max(5), timeoutMs: external_exports.number().int().min(1).max(3e5), maxRetryDelayMs: external_exports.number().int().min(0).max(3e5) });
     MAX_RESPONSE = 8 * 1024 * 1024;
+    DOWNLOAD_PAGE_ROWS = 500;
+    INTERACTIVE_PAGE_ROWS = 50;
     JsonTransport = class {
       constructor(options) {
         this.options = options;
@@ -34317,7 +34451,7 @@ var init_transport = __esm({
             const timeout = AbortSignal.timeout(options.timeoutMs ?? this.settings.timeoutMs);
             response = await (this.options.fetch ?? fetch)(url2.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(path2, input2));
             } catch (error64) {
               if (response.ok) throw error64;
               data = void 0;
@@ -34377,6 +34511,8 @@ var init_exit_codes = __esm({
 function apiFailure(status, data) {
   const parsed = external_exports.object({ error: external_exports.union([external_exports.string(), external_exports.object({ code: external_exports.string(), message: external_exports.string().optional() })]) }).safeParse(data);
   const code = parsed.success ? (typeof parsed.data.error === "string" ? parsed.data.error : parsed.data.error.code).toLowerCase() : "";
+  if (code === "credits_required") return new CliError("Email verification is paused for credit.", EXIT_CODES.LIMIT);
+  if (code === "plan_required") return new CliError("Your plan does not include this feature.");
   if (status === 401 || status === 403 || ["unauthorized", "forbidden"].includes(code)) return new CliError("Authentication failed. Run higherdata login or check HIGHERDATA_API_KEY and the selected space.", EXIT_CODES.AUTH);
   const message = parsed.success && typeof parsed.data.error !== "string" ? parsed.data.error.message : void 0;
   if (code === "limit_exceeded" && message && /^This month's email verification allowance is reached\. Resets \d{4}-\d{2}-\d{2}\. Upgrade: (https:\/\/[^\s]+|\/docs\/plans-and-limits)$/.test(message)) return new CliError(message, EXIT_CODES.LIMIT);
@@ -34409,7 +34545,7 @@ var init_api2 = __esm({
     ApiClient = class {
       constructor(settings, fetchImpl = fetch) {
         this.settings = settings;
-        this.transport = new JsonTransport({ ...settings, fetch: fetchImpl, maxRetries: 0 });
+        this.transport = new JsonTransport({ ...settings, fetch: (url2, init) => fetchImpl(url2, { ...init, headers: { ...init?.headers, "x-higherdata-client": "cli" } }), maxRetries: 0 });
       }
       settings;
       transport;
@@ -34431,7 +34567,7 @@ var init_api2 = __esm({
             if (error63.status) {
               const mapped = apiFailure(error63.status, { error: { code: error63.code, message: error63.message } });
               const plain = (value) => (this.settings.apiKey ? value.replaceAll(this.settings.apiKey, "[redacted]") : value).replace(/[\u0000-\u001f\u007f-\u009f]/gu, " ");
-              throw new CliError(`${plain(error63.code)}: ${plain(error63.message === "The HigherData API request failed." ? mapped.message : error63.message)}${error63.requestId ? ` (request: ${plain(error63.requestId)})` : ""}`, mapped.exitCode);
+              throw new CliError(`${plain(error63.code)}: ${plain(error63.message === "The HigherData API request failed." ? mapped.message : error63.message)}${error63.billingHref ? ` Buy verify credits: ${plain(error63.billingHref)}` : ""}${error63.requestId ? ` (request: ${plain(error63.requestId)})` : ""}`, mapped.exitCode);
             }
             if (error63.code === "response_too_large") throw new CliError("The API response exceeded the CLI size limit.");
             throw new CliError(error63.message);
@@ -38002,7 +38138,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "higherdata",
-      version: "0.6.0",
+      version: "0.7.0",
       type: "module",
       bin: {
         higherdata: "dist/index.js"
@@ -38052,7 +38188,7 @@ var init_package = __esm({
         directory: "packages/cli"
       },
       higherdata: {
-        minimumServerVersion: "0.2.0"
+        minimumServerVersion: "0.7.0"
       },
       optionalDependencies: {
         "@napi-rs/keyring": "2.1.0"
@@ -39875,6 +40011,13 @@ var init_records = __esm({
   }
 });
 
+// ../../src/lib/lookup/linkedin.ts
+var init_linkedin = __esm({
+  "../../src/lib/lookup/linkedin.ts"() {
+    "use strict";
+  }
+});
+
 // ../../src/lib/lookup/phone.ts
 var init_phone = __esm({
   "../../src/lib/lookup/phone.ts"() {
@@ -40649,6 +40792,7 @@ var suppressionKeyTypeSchema;
 var init_normalize = __esm({
   "../../src/lib/suppression/normalize.ts"() {
     "use strict";
+    init_linkedin();
     init_phone();
     init_es62();
     init_zod();
@@ -41051,28 +41195,9 @@ function pageCsv(headers, rows) {
   return `${lines.join("\r\n")}\r
 `;
 }
-function companyPageCsv(items) {
-  return pageCsv(
-    [...COMPANY_DOWNLOAD_FIELDS],
-    items.map((item) => COMPANY_DOWNLOAD_FIELDS.map((field) => item[field]))
-  );
-}
-function peoplePageCsv(items) {
-  return pageCsv(
-    [...PEOPLE_DOWNLOAD_FIELDS],
-    items.map((item) => PEOPLE_DOWNLOAD_FIELDS.map((field) => item[field]))
-  );
-}
-function searchPageJsonl(kind, items) {
-  const fields = kind === "companies" ? COMPANY_DOWNLOAD_FIELDS : PEOPLE_DOWNLOAD_FIELDS;
-  return items.map((item) => JSON.stringify(Object.fromEntries(fields.map((field) => [field, item[field] ?? null]))) + "\n").join("");
-}
-var COMPANY_DOWNLOAD_FIELDS, PEOPLE_DOWNLOAD_FIELDS;
 var init_search_download = __esm({
   "../../src/lib/csv/search-download.ts"() {
     "use strict";
-    COMPANY_DOWNLOAD_FIELDS = ["id", "companyName", "normalizedDomain", "headquartersCountryCode", "industryLinkedin", "employeeCountEstimate"];
-    PEOPLE_DOWNLOAD_FIELDS = ["id", "fullName", "jobTitle", "companyName", "emailAddress", "countryCode"];
   }
 });
 
@@ -41082,60 +41207,168 @@ function searchDownloadFormat(path2) {
   if (!/\.(csv|jsonl)$/.test(path2)) throw new CliError("Choose a new .csv or .jsonl destination.");
   return path2.endsWith(".jsonl") ? "jsonl" : "csv";
 }
+function customerRecord(item) {
+  const value = customerOutput(item);
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new CliError("The API returned an invalid search page.");
+  return value;
+}
+function csvCellValue(value) {
+  return value !== null && typeof value === "object" ? JSON.stringify(value) : value;
+}
+function downloadRecordsJsonl(items) {
+  return items.map((item) => `${JSON.stringify(customerRecord(item))}
+`).join("");
+}
+function downloadProgress(count, finishedAll) {
+  const label = `${count.toLocaleString("en-US")} ${count === 1 ? "row" : "rows"}`;
+  return finishedAll ? `${label} (all)` : label;
+}
 async function downloadSearch(api, name2, input2, path2, options) {
   const format2 = searchDownloadFormat(path2);
   if (options.all && api.settings.idempotencyKey) throw new CliError("An idempotency key applies to one page. Omit --all.");
   const file2 = await open5(path2, "wx", 384);
-  let count = 0, first = true, cursor = input2.cursor, loaded = options.loadedPage;
-  const seen = /* @__PURE__ */ new Set();
-  if (typeof cursor === "string") seen.add(cursor);
-  try {
-    while (true) {
-      let raw, headers;
+  const seenCursors = /* @__PURE__ */ new Set();
+  const seenIds = /* @__PURE__ */ new Set();
+  const startCursor = typeof input2.cursor === "string" ? input2.cursor : void 0;
+  if (startCursor) seenCursors.add(startCursor);
+  const requestInput = { ...input2, ...options.all ? { limit: SEARCH_DOWNLOAD_PAGE_SIZE, download: true } : {} };
+  delete requestInput.cursor;
+  let loaded = options.loadedPage;
+  let reserved = 0;
+  let written = 0;
+  let capped = false;
+  let position = 0;
+  const columns = [];
+  const csvRows = [];
+  const idPattern = name2 === "search.companies" ? /^hdo_[a-f0-9]{32}$/ : /^hdp_[a-f0-9]{32}$/;
+  let ahead = { kind: "ready", cursor: startCursor };
+  const queue = [];
+  let failed = false;
+  async function writeAt(text2, at) {
+    const body = Buffer.from(text2);
+    let offset = 0;
+    while (offset < body.length) {
+      const { bytesWritten } = await file2.write(body, offset, body.length - offset, at + offset);
+      if (bytesWritten <= 0) throw new CliError("The download could not be written.");
+      offset += bytesWritten;
+    }
+    return at + body.length;
+  }
+  function csvText(records) {
+    return pageCsv(columns, records.map((record2) => columns.map((key) => csvCellValue(record2[key]))));
+  }
+  async function writeRecords(items) {
+    if (!items.length) return;
+    if (options.beforeWrite) await options.beforeWrite();
+    if (format2 === "jsonl") {
+      position = await writeAt(downloadRecordsJsonl(items), position);
+      return;
+    }
+    const records = items.map(customerRecord);
+    const seen = new Set(columns);
+    const grew = columns.length > 0 && records.some((record2) => Object.keys(record2).some((key) => !seen.has(key)));
+    for (const record2 of records) for (const key of Object.keys(record2)) if (!seen.has(key)) {
+      seen.add(key);
+      columns.push(key);
+    }
+    const first = csvRows.length === 0;
+    csvRows.push(...records);
+    if (first) position = await writeAt(csvText(records), position);
+    else if (grew) {
+      position = await writeAt(csvText(csvRows), 0);
+      await file2.truncate(position);
+    } else {
+      const page = csvText(records);
+      position = await writeAt(page.slice(page.indexOf("\r\n") + 2), position);
+    }
+  }
+  async function pace(headers) {
+    if (headers?.get("ratelimit-remaining") !== "0") return;
+    const reset = headers.get("ratelimit-reset");
+    if (reset !== null && reset !== void 0 && /^\d+(?:\.\d+)?$/.test(reset.trim())) await options.sleep(Number(reset) * 1e3);
+  }
+  function kick() {
+    if (ahead.kind !== "ready" || queue.length >= SEARCH_DOWNLOAD_WINDOW || failed) return;
+    const cursor = ahead.cursor;
+    ahead = { kind: "wait" };
+    const promise2 = fetchPage(cursor);
+    void promise2.catch(() => void 0);
+    queue.push(promise2);
+  }
+  async function fetchPage(cursor) {
+    try {
+      let raw;
+      let headers;
       if (loaded) {
         raw = loaded;
         loaded = void 0;
       } else {
-        const response = await api.request(`/api/v1/tools/${name2}`, { ...input2, ...cursor === void 0 ? {} : { cursor } }, { authenticated: true, rateLimitRecovery: options });
+        const response = await api.request(`/api/v1/tools/${name2}`, { ...requestInput, ...cursor === void 0 ? {} : { cursor } }, { authenticated: true, rateLimitRecovery: options });
         raw = response.data;
         headers = response.headers;
       }
       const page = pageSchema2.safeParse(raw);
-      if (!page.success || page.data.items.some((item) => typeof item.id !== "string" || !(name2 === "search.companies" ? /^hdo_[a-f0-9]{32}$/ : /^hdp_[a-f0-9]{32}$/).test(item.id))) throw new CliError("The API returned an invalid search page.");
-      const items = page.data.items.slice(0, SEARCH_DOWNLOAD_CAP - count);
-      if (format2 === "jsonl") await file2.writeFile(searchPageJsonl(name2 === "search.companies" ? "companies" : "people", items));
-      else {
-        const csv = (name2 === "search.companies" ? companyPageCsv : peoplePageCsv)(items);
-        await file2.writeFile(first ? csv : csv.slice(csv.indexOf("\r\n") + 2));
-      }
-      first = false;
-      count += items.length;
-      options.progress?.(`Downloaded ${count.toLocaleString("en-US")} of 5,000`);
+      if (!page.success || page.data.items.some((item) => typeof item.id !== "string" || !idPattern.test(item.id))) throw new CliError("The API returned an invalid search page.");
+      const fresh = [];
+      for (const item of page.data.items) {
+        const id = item.id;
+        if (seenIds.has(id)) continue;
+        seenIds.add(id);
+        fresh.push(item);
+      }
+      const items = fresh.slice(0, Math.max(0, SEARCH_DOWNLOAD_CAP - reserved));
+      reserved += items.length;
       const next = page.data.nextCursor;
-      if (!options.all || !next || count === SEARCH_DOWNLOAD_CAP) return { rows: count, capped: !!options.all && count === SEARCH_DOWNLOAD_CAP && (!!next || items.length < page.data.items.length) };
-      if (seen.has(next)) throw new CliError("The API repeated a cursor. Pagination stopped.");
-      seen.add(next);
-      cursor = next;
-      if (headers?.get("ratelimit-remaining") === "0") {
-        const reset = headers.get("ratelimit-reset");
-        if (reset !== null && /^\d+(?:\.\d+)?$/.test(reset.trim())) await options.sleep(Number(reset) * 1e3);
-      }
+      const cappedPage = Boolean(options.all) && reserved === SEARCH_DOWNLOAD_CAP && (Boolean(next) || fresh.length > items.length);
+      const stop = !options.all || !next || cappedPage;
+      if (!stop && next) {
+        if (seenCursors.has(next)) {
+          ahead = { kind: "stop" };
+          return { items, done: true, capped: cappedPage, error: new CliError("The API repeated a cursor. Pagination stopped.") };
+        }
+        seenCursors.add(next);
+        await pace(headers);
+        ahead = { kind: "ready", cursor: next };
+        kick();
+      } else ahead = { kind: "stop" };
+      return { items, done: stop, capped: cappedPage };
+    } catch (error63) {
+      failed = true;
+      ahead = { kind: "stop" };
+      throw error63;
     }
+  }
+  try {
+    kick();
+    while (queue.length) {
+      const planned = await queue[0];
+      await writeRecords(planned.items);
+      written += planned.items.length;
+      if (planned.capped) capped = true;
+      options.progress?.(downloadProgress(written, planned.done && Boolean(options.all) && !capped));
+      queue.shift();
+      kick();
+      if (planned.error) throw planned.error;
+    }
+    return { rows: written, capped };
   } finally {
     await file2.close();
   }
 }
-var SEARCH_DOWNLOAD_CAP, SEARCH_DOWNLOAD_CAP_NOTICE, isSearchResults, pageSchema2;
+var SEARCH_DOWNLOAD_CAP, SEARCH_DOWNLOAD_CAP_NOTICE, SEARCH_DOWNLOAD_PAGE_SIZE, SEARCH_DOWNLOAD_WINDOW, isSearchResults, pageSchema2;
 var init_search_download2 = __esm({
   "src/search-download.ts"() {
     "use strict";
     init_zod();
     init_search_download();
     init_api2();
+    init_output();
     SEARCH_DOWNLOAD_CAP = 5e3;
     SEARCH_DOWNLOAD_CAP_NOTICE = "Download stopped at 5,000 rows. Save the search to a list and export the list for larger sets.";
+    SEARCH_DOWNLOAD_PAGE_SIZE = 500;
+    SEARCH_DOWNLOAD_WINDOW = 3;
     isSearchResults = (name2) => name2 === "search.companies" || name2 === "search.people";
-    pageSchema2 = external_exports.object({ items: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).max(50), nextCursor: external_exports.string().min(1).max(2048).nullable() });
+    pageSchema2 = external_exports.object({ items: external_exports.array(external_exports.record(external_exports.string(), external_exports.unknown())).max(500), nextCursor: external_exports.string().min(1).max(2048).nullable() });
   }
 });
 
@@ -43893,7 +44126,7 @@ async function globalScript(runtime, env, script) {
   }
 }
 async function autoUpdate(input2) {
-  if (!interactiveUpdateAllowed(input2.args, input2.env, input2.runtime) || input2.env.HIGHERDATA_NO_AUTO_UPDATE === "1" || input2.env.HIGHERDATA_UPDATE_RERUN === "1" || ["update", "upgrade", "config"].includes(primaryCommand(input2.args) ?? "")) return null;
+  if (!interactiveUpdateAllowed(input2.args, input2.env, input2.runtime) || input2.env.HIGHERDATA_NO_AUTO_UPDATE === "1" || input2.env.HIGHERDATA_UPDATE_RERUN === "1" || ["update", "upgrade", "config", "guide"].includes(primaryCommand(input2.args) ?? "")) return null;
   if ((await input2.readConfig()).autoUpdate === false) return null;
   const candidate = await possibleGlobalScript(input2.runtime, input2.env);
   if (!candidate) return null;
@@ -46497,13 +46730,14 @@ function fieldsFor(schema, input2 = {}, variant = 0, prefix = "") {
       const discriminant = Object.keys(branches[0].properties).find((key) => branches.every((s) => s.properties?.[key]?.const !== void 0));
       const matched = branches.findIndex((s) => (s.required ?? []).some((key) => Object.hasOwn(input2, key)));
       const index = discriminant ? Math.max(0, branches.findIndex((s) => s.properties[discriminant].const === input2[discriminant])) : matched >= 0 ? matched : Math.min(variant, branches.length - 1);
-      const choices = branches.map((s) => discriminant ? s.properties[discriminant].const : Object.keys(s.properties).map(title).join(" / "));
+      const choices = branches.map((s) => discriminant ? s.properties[discriminant].const : Object.keys(s.properties).filter((key) => key !== "force").map(title).join(" / "));
       const selector = { path: prefix ? `${prefix}.$variant` : "$variant", label: "Input type", required: true, schema: { type: "string", enum: choices } };
       return [selector, ...fieldsFor(branches[index], input2, variant, prefix).filter((f) => !discriminant || f.path !== `${prefix ? `${prefix}.` : ""}${discriminant}`)];
     }
     return fieldsFor(branches[0] ?? {}, input2, variant, prefix);
   }
   return Object.entries(schema.properties ?? {}).flatMap(([key, raw]) => {
+    if (key === "force") return [];
     const path2 = prefix ? `${prefix}.${key}` : key;
     const alternatives2 = raw.anyOf ?? raw.oneOf;
     const field = alternatives2?.length === 2 && alternatives2.some((s) => s.type === "null") ? alternatives2.find((s) => s.type !== "null") : raw;
@@ -46712,12 +46946,12 @@ async function finishEmailRequest(name2, result, poll, sleep) {
 }
 function registerToolCommands(program2, runtime) {
   const tools = program2.command("tools").description("Every HigherData tool, with schema-driven flags and JSON input");
-  for (const tool of TOOL_CATALOG) for (const parent of tool.name === "email.find" ? [tools, program2] : [tools]) {
-    const command = parent.command(parent === program2 ? "find-email" : tool.name).description(tool.description).option("--input <json>", "Tool input as a JSON object", inputObject, {}).option("--execute", "Execute an irreversible action or email request (default: preview)").option("--yes", "Confirm execution of this request");
+  for (const tool of TOOL_CATALOG) for (const parent of tool.name.startsWith("email.") ? [tools, program2] : [tools]) {
+    const command = parent.command(parent === program2 ? tool.name === "email.find" ? "find-email" : "verify-email" : tool.name).description(tool.description).option("--input <json>", "Tool input as a JSON object", inputObject, {}).option("--execute", "Execute an irreversible action or email request (default: preview)").option("--yes", "Confirm execution of this request");
     const flags = flagFields(tool.input).map((field, index) => {
       const flag2 = field.path.replace(/([a-z])([A-Z])/gu, "$1-$2").replaceAll(".", "-").replaceAll("_", "-").toLowerCase();
       const attribute = `field${index}`;
-      const option = new Option(`--${flag2} <value>`, `${field.schema.description ?? field.path}${field.schema.type === "array" ? " (comma separated strings or JSON array)" : ""}`);
+      const option = new Option(field.path === "force" ? "--force" : `${field.path === "linkedinUrl" ? "--linkedin <value>, " : ""}--${flag2} <value>`, `${field.schema.description ?? field.path}${field.schema.type === "array" ? " (comma separated strings or JSON array)" : ""}`);
       option.attributeName = () => attribute;
       command.addOption(option);
       return { field, attribute };
@@ -46725,7 +46959,10 @@ function registerToolCommands(program2, runtime) {
     command.action(async (options, cmd) => {
       if (options.execute && needsConfirmation(tool) && !options.yes) throw new CliError("Review the dry run, then supply --execute --yes to confirm this request.");
       let input2 = options.input;
-      for (const { field, attribute } of flags) if (typeof options[attribute] === "string") input2 = putField(input2, field, options[attribute]);
+      for (const { field, attribute } of flags) {
+        if (typeof options[attribute] === "string") input2 = putField(input2, field, options[attribute]);
+        else if (field.path === "force" && options[attribute] === true) input2 = { ...input2, force: true };
+      }
       const globals = cmd.optsWithGlobals();
       const settings = resolveSettings(await runtime.readConfig(), globals, runtime.env);
       const api = new ApiClient({ ...settings, idempotencyKey: globals.idempotencyKey ?? randomUUID5() }, runtime.fetchImpl);
@@ -47413,7 +47650,7 @@ function TerminalScreen({ state, columns, rows = 28, colors = true, profile = "d
       isCore && (fullScreen ? /* @__PURE__ */ jsx5(Box4, { children: ["Overview", "Contacts", "Insights"].map((label, i) => /* @__PURE__ */ jsx5(Hit, { action: { key: `record-${i}` }, children: /* @__PURE__ */ jsx5(Text, { color, children: ` [${label}] ` }) }, label)) }) : /* @__PURE__ */ jsx5(Text, { color, children: "[1 Overview] [2 Contacts] [3 Insights]" })),
       state.tab === 2 && !row.insights ? /* @__PURE__ */ jsx5(Text, { children: "Insights requires an Insights or Unlimited plan, and a release with Insights fields. Check Account / Limits." }) : fieldLines(state.tool?.name.startsWith("changes.") ? reviewFields(row) : detail, width - 4).slice(state.selected, state.selected + limit - 2).map((line, i) => /* @__PURE__ */ jsx5(Text, { children: line }, i))
     ] });
-    help = isCore ? `Up/Down scroll. ${fullScreen ? "O/C/I record tabs." : "1/2/3 tabs."} A add to list. ${String(row.id).startsWith("hdp_") ? String(row.emailAddress ?? row.email ?? "").trim() ? "V verify email. " : "F find email. " : ""}Esc back.` : "Up/Down scroll. Esc back.";
+    help = isCore ? `Up/Down scroll. ${fullScreen ? "O/C/I record tabs." : "1/2/3 tabs."} A add to list. ${String(row.id).startsWith("hdp_") && !String(row.emailAddress ?? row.email ?? "").trim() ? "F find email. " : ""}Esc back.` : "Up/Down scroll. Esc back.";
     if (state.tool?.name.startsWith("changes.")) help += " A approve. X reject. P apply. U restore. Each opens a preview.";
     if (state.tool?.name === "hygiene.duplicates") help += " M propose merge. X dismiss.";
     if (state.tool?.name === "hygiene.orphans") help += " P propose repair.";
@@ -47539,7 +47776,7 @@ function screenButtons(state) {
     if (state.tool?.name === "hygiene.duplicates") return [["Merge", "m"], ["Dismiss", "x"], ["Back", "escape"]];
     if (coreRecord(state.row)) {
       const row = detailRecord(state.row);
-      const emailAction = String(row.id).startsWith("hdp_") ? String(row.emailAddress ?? row.email ?? "").trim() ? [["Verify email", "v"]] : [["Find email", "f"]] : [];
+      const emailAction = String(row.id).startsWith("hdp_") && !String(row.emailAddress ?? row.email ?? "").trim() ? [["Find email", "f"]] : [];
       return [["Add to list", "a"], ...emailAction, ["Suppression", "s"], ["Back", "escape"]];
     }
   }
@@ -47991,7 +48228,6 @@ function InteractiveApp({ session, fullScreen = true, events }) {
       } else if (isCore && input2 === "a") form("lists.add", { ids: [record2.id] });
       else if (isCore && String(record2.id).startsWith("hdp_") && !String(record2.emailAddress ?? record2.email ?? "").trim() && input2 === "f") form("email.find", { firstName: record2.firstName, lastName: record2.lastName, company: record2.companyId ? { id: record2.companyId } : {} });
       else if (isCore && input2 === "s") form("suppress.check", { keys: [{ keyType: String(record2.id).startsWith("hdo_") ? "company_id" : "person_id", value: record2.id }] });
-      else if (isCore && String(record2.id).startsWith("hdp_") && !!String(record2.emailAddress ?? record2.email ?? "").trim() && input2 === "v") form("email.verify", { email: record2.emailAddress ?? record2.email });
     }
   }
   useInput(handleInput);
@@ -48254,7 +48490,7 @@ var peopleArrayFlags = {
   excludeEmail: "excludeEmails"
 };
 var scalarFlags = ["employeeCountMin", "employeeCountMax", "revenueMinUsd", "revenueMaxUsd", "websiteAvailability", "linkedinAvailability", "fundingDateAfter", "fundingDateBefore"];
-var peopleScalarFlags = ["companyFoundedYearMin", "companyFoundedYearMax", "jobStartDateAfter", "jobStartDateBefore", "emailAvailability", "phoneAvailability", "requireVerifiedEmail"];
+var peopleScalarFlags = ["sort", "companyFoundedYearMin", "companyFoundedYearMax", "jobStartDateAfter", "jobStartDateBefore", "emailAvailability", "phoneAvailability", "requireVerifiedEmail"];
 var flag = (name2) => name2.replace(/[A-Z]/gu, (letter) => `-${letter.toLowerCase()}`);
 var collect = (value, previous = []) => [...previous, value];
 function positiveLimit(value) {
@@ -48297,6 +48533,39 @@ async function buildFilters(api, options, kind) {
 
 // src/commands.ts
 init_output();
+
+// src/guide.ts
+var AGENT_GUIDE = `HigherData agent guide
+
+Count first, then download.
+
+  higherdata count --country-code CA --json
+  That estimates companies and their contacts. For a people count:
+  higherdata tools search.count_people --input '{"filters":{"countryCodes":["CA"]}}' --json
+
+  higherdata search people --country-code CA --title-keyword Operations --all --out people.jsonl
+  --all requests the largest page the API allows (500) and writes every matching row.
+  Progress prints "344 rows" while it runs and "453 rows (all)" when the download finishes.
+  The 5,000 row cap is mentioned only when a download hits it. Save the search to a list and export the list for a larger set.
+  --out people.jsonl has the same fields as --jsonl. A .csv file has those same fields. Do not download twice.
+
+Filters and allowed values.
+
+  higherdata search people --help
+  higherdata search companies --help
+  higherdata tools search.facets --json
+  Facets list country, state, industry, NAICS, funding, department, seniority and role family values, plus city suggestions.
+  --where "Canadian software companies" proposes filters before the search.
+  A people search needs a country or an industry.
+
+Company lookup.
+
+  Do not call lookup.company once per person.
+  When batch company lookup is available, pass up to 100 hdo_ ids in one lookup.company call.
+  Until that call accepts ids, lookup.company takes one domain, name, LinkedIn URL, or hdo_ id.
+`;
+
+// src/commands.ts
 init_search_download2();
 
 // src/pagination.ts
@@ -48366,11 +48635,11 @@ function wholeNumber(value) {
 }
 var collectScope = (value, previous = []) => [...previous, value];
 function registerAccountCommands(program2, deps) {
-  program2.command("usage").description("Show monthly activity and email verification allowance").action(async (_options, command) => {
+  program2.command("usage").description("Show monthly activity and purchased verify credits").action(async (_options, command) => {
     const { api, mode } = await deps.session(command);
     deps.emit(await api.tool("account.usage", {}), mode);
   });
-  program2.command("limits").description("Show rate limits, the plan allowance, and the reset date").action(async (_options, command) => {
+  program2.command("limits").description("Show plan rate limits, concurrency and purchased verify credits").action(async (_options, command) => {
     const { api, mode } = await deps.session(command);
     deps.emit(await api.tool("account.limits", {}), mode);
   });
@@ -48609,6 +48878,9 @@ function registerCommands(program2, runtime) {
     await runtime.writeConfig(config2);
     emit(identity, mode);
   });
+  program2.command("guide").description("Print the agent quick reference").action(() => {
+    runtime.out(AGENT_GUIDE);
+  });
   const search = program2.command("search").description("Search HigherData Core");
   for (const kind of ["companies", "people"]) pageOptions(excludeList(addFilterOptions(search.command(kind).description(`Find ${kind}`), kind === "people"))).option("--out <path>", "Download to a new .csv or .jsonl file (up to 5,000 rows with --all)").action(async (options, command) => {
     const { api, mode } = await session(command);
@@ -48632,14 +48904,16 @@ function registerCommands(program2, runtime) {
     const { api, mode } = await session(command);
     emit(await api.tool("lookup.find", { query: query.join(" "), ...options.company ? { companyId: options.company } : {} }), mode);
   });
-  excludeList(lookup.command("company <domain>")).action(async (domain2, options, command) => {
-    const { api, mode } = await session(command);
-    emit(await api.tool("lookup.company", { domain: domain2, ...excluded(options) }), mode);
-  });
-  excludeList(lookup.command("person <email>")).action(async (email3, options, command) => {
-    const { api, mode } = await session(command);
-    emit(await api.tool("lookup.person", { email: email3, ...excluded(options) }), mode);
-  });
+  for (const kind of ["company", "person"]) {
+    excludeList(lookup.command(`${kind} [identity]`).option("--linkedin <url>", `Look up a ${kind} by LinkedIn URL`).option("--ids <ids>", "Company ids, comma-separated (up to 100)")).action(async (identity, options, command) => {
+      if (Number(Boolean(identity)) + Number(Boolean(options.linkedin)) + Number(Boolean(options.ids)) !== 1) throw new CliError("Supply one identity, --linkedin URL or --ids list.");
+      if (options.ids && kind !== "company") throw new CliError("--ids is available for company lookup only.");
+      const ids = options.ids?.split(",").map((id) => id.trim());
+      if (ids && (!ids.length || ids.length > 100 || ids.some((id) => !/^hdo_[0-9a-f]{32}$/.test(id)))) throw new CliError("Use 1 to 100 opaque hdo_ company ids.");
+      const { api, mode } = await session(command);
+      emit(await api.tool(`lookup.${kind}`, { ...ids ? { ids } : options.linkedin ? { linkedinUrl: options.linkedin } : kind === "company" ? { domain: identity } : { email: identity }, ...excluded(options) }), mode);
+    });
+  }
   const lists = program2.command("lists").description("Create, refresh and export saved lists");
   addFilterOptions(lists.command("create <name>").option("--kind <kind>", "companies or people", "companies").option("--recurring", "Refresh automatically on each data release").option("--dry-run", "Preview without creating a list"), true).action(async (name2, options, command) => {
     if (options.kind !== "companies" && options.kind !== "people") throw new CliError("Choose --kind companies or people.");
@@ -48712,7 +48986,7 @@ function createProgram(overrides = {}) {
     } else program2.outputHelp();
   });
   program2.hook("preAction", async (_program, command) => {
-    if (["login", "update", "upgrade"].includes(command.name()) || ["mcp", "skills", "config"].includes(command.parent?.name() ?? "")) return;
+    if (["login", "update", "upgrade", "guide"].includes(command.name()) || ["mcp", "skills", "config"].includes(command.parent?.name() ?? "")) return;
     if (command === program2 && (!runtime.updater.stdinTTY || !runtime.updater.stdoutTTY || Object.hasOwn(runtime.env, "CI") || program2.opts().json || program2.opts().jsonl)) return;
     const settings = resolveSettings(await runtime.readConfig(), command.optsWithGlobals(), runtime.env);
     await checkCliVersion({ apiUrl: settings.apiUrl, version: package_default.version, cache: runtime.versionCache, fetchImpl: runtime.fetchImpl, now: runtime.now, warn: runtime.err });