higherdata 0.6.0 → 0.7.1

package/dist/index.js

@@ -20522,14 +20522,20 @@ var init_keychain = __esm({
 });
 
 // src/config.ts
+import { AsyncLocalStorage } from "async_hooks";
 import { chmod, mkdir, open as open2, readFile, rename, unlink } from "fs/promises";
 import { homedir } from "os";
 import { dirname, join } from "path";
 import { randomUUID } from "crypto";
+function withConfigWarn(warn, run) {
+  return configWarn.run(warn, run);
+}
 function warnAboutFileKeychainFallback() {
   if (warnedAboutFileKeychainFallback) return;
   warnedAboutFileKeychainFallback = true;
-  process.stderr.write("HigherData could not access a system keychain. Credentials will be stored in the config file with 0600 permissions.\n");
+  const warn = configWarn.getStore();
+  if (warn) warn(KEYCHAIN_FILE_FALLBACK);
+  else process.stderr.write(KEYCHAIN_FILE_FALLBACK);
 }
 function configPath(home = homedir()) {
   return join(home, ".config", "higherdata", "config.json");
@@ -20639,7 +20645,7 @@ function resolveSettings(config2, options = {}, env = process.env) {
     space: profile.space
   };
 }
-var DEFAULT_API_URL, apiUrlSchema, profileSchema, configSchema, ConfigError, warnedAboutFileKeychainFallback;
+var DEFAULT_API_URL, apiUrlSchema, profileSchema, configSchema, ConfigError, KEYCHAIN_FILE_FALLBACK, warnedAboutFileKeychainFallback, configWarn;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
@@ -20674,7 +20680,9 @@ var init_config = __esm({
         this.name = "ConfigError";
       }
     };
+    KEYCHAIN_FILE_FALLBACK = "HigherData could not access a system keychain. Credentials will be stored in the config file with 0600 permissions.\n";
     warnedAboutFileKeychainFallback = false;
+    configWarn = new AsyncLocalStorage();
   }
 });
 
@@ -20878,7 +20886,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 +21071,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 +22534,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 +22545,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 +22588,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 +23142,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 +23172,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 +23183,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 +23406,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 +23433,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 +23987,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 +24061,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 +24070,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 +24090,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",
@@ -26548,31 +26584,29 @@ var init_generated = __esm({
                           "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                         },
                         "titleKeywords": {
-                          "description": "Job title keywords to match. A person can match any of them.",
+                          "description": "Job title keywords to match, at least 3 characters each after trimming. A person can match any of them.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "requiredTitleKeywords": {
-                          "description": "Job title keywords the person must match.",
+                          "description": "Job title keywords the person must match, at least 3 characters each after trimming.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "requiredTitleKeywordGroups": {
-                          "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+                          "description": "Job title keyword groups, at least 3 characters per keyword after trimming. The person must match every group, and any keyword inside a group.",
                           "maxItems": 10,
                           "type": "array",
                           "items": {
@@ -26581,22 +26615,20 @@ var init_generated = __esm({
                             "type": "array",
                             "items": {
                               "type": "string",
-                              "minLength": 1,
-                              "maxLength": 120,
-                              "pattern": "\\S"
+                              "minLength": 3,
+                              "maxLength": 120
                             }
                           }
                         },
                         "excludeTitleKeywords": {
-                          "description": "Job title keywords that remove a person.",
+                          "description": "Job title keywords that remove a person, at least 3 characters each after trimming.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "jobFunctions": {
@@ -26713,6 +26745,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",
@@ -26839,9 +26879,34 @@ var init_generated = __esm({
           "additionalProperties": false
         }
       },
+      {
+        "name": "lists.delete",
+        "description": "Delete a saved list and its membership and refresh history. Records and CRM data are unchanged. Dry run previews the deletion.",
+        "risk": "destructive",
+        "scopes": [
+          "data:read",
+          "data:write"
+        ],
+        "input": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object",
+          "properties": {
+            "id": {
+              "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)$",
+              "description": "Saved list id in the current space."
+            }
+          },
+          "required": [
+            "id"
+          ],
+          "additionalProperties": false
+        }
+      },
       {
         "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"
@@ -26926,6 +26991,15 @@ var init_generated = __esm({
               "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)$"
+            },
+            "sort": {
+              "description": "List records sorted by name or date added.",
+              "type": "string",
+              "enum": [
+                "name_asc",
+                "name_desc",
+                "added_desc"
+              ]
             }
           },
           "additionalProperties": false
@@ -26963,6 +27037,75 @@ var init_generated = __esm({
           "additionalProperties": false
         }
       },
+      {
+        "name": "lists.remove",
+        "description": "Remove up to 50 saved row ids from a list. A later dynamic refresh may add matching records again. Dry run previews the removal count.",
+        "risk": "destructive",
+        "scopes": [
+          "data:read",
+          "data:write"
+        ],
+        "input": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object",
+          "properties": {
+            "id": {
+              "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)$",
+              "description": "Saved list id in the current space."
+            },
+            "ids": {
+              "minItems": 1,
+              "maxItems": 50,
+              "type": "array",
+              "items": {
+                "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)$"
+              },
+              "description": "Saved row ids returned by lists.get, at most 50 per call."
+            }
+          },
+          "required": [
+            "id",
+            "ids"
+          ],
+          "additionalProperties": false
+        }
+      },
+      {
+        "name": "lists.rename",
+        "description": "Rename a saved list. Dry run previews the name.",
+        "risk": "write_local",
+        "scopes": [
+          "data:read",
+          "data:write"
+        ],
+        "input": {
+          "$schema": "https://json-schema.org/draft/2020-12/schema",
+          "type": "object",
+          "properties": {
+            "id": {
+              "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)$",
+              "description": "Saved list id in the current space."
+            },
+            "name": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 80,
+              "description": "New name for the saved list."
+            }
+          },
+          "required": [
+            "id",
+            "name"
+          ],
+          "additionalProperties": false
+        }
+      },
       {
         "name": "lists.run",
         "description": "Queue a background preview or refresh. Only one job runs per list. Owners and admins can refresh dynamic lists now, including the current release. Dry run reports the proposed release without queueing.",
@@ -27030,7 +27173,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 +27198,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 +27241,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 +27261,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 +27271,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 +27339,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 +27391,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 +27418,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 +27458,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 +27475,6 @@ var init_generated = __esm({
                 "linkedinUrl": {
                   "type": "string",
                   "maxLength": 2048,
-                  "format": "uri",
                   "description": "LinkedIn person profile URL."
                 },
                 "candidateLimit": {
@@ -27284,7 +27485,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 +27512,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 +27532,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 +27883,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 +28576,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 +29627,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 the search index; search results may match other current jobs. Title keywords, required titles, title groups or seniorities can be used without company filters. Empty and exclusion-only counts are rejected. Broad counts are approximate. exact: true explicitly requests one capped detailed count of matching people; never use it for live filtering.",
         "risk": "read",
         "scopes": [
           "data:read"
@@ -29902,31 +30111,29 @@ var init_generated = __esm({
                   "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                 },
                 "titleKeywords": {
-                  "description": "Job title keywords to match. A person can match any of them.",
+                  "description": "Job title keywords to match, at least 3 characters each after trimming. A person can match any of them.",
                   "minItems": 1,
                   "maxItems": 50,
                   "type": "array",
                   "items": {
                     "type": "string",
-                    "minLength": 1,
-                    "maxLength": 120,
-                    "pattern": "\\S"
+                    "minLength": 3,
+                    "maxLength": 120
                   }
                 },
                 "requiredTitleKeywords": {
-                  "description": "Job title keywords the person must match.",
+                  "description": "Job title keywords the person must match, at least 3 characters each after trimming.",
                   "minItems": 1,
                   "maxItems": 50,
                   "type": "array",
                   "items": {
                     "type": "string",
-                    "minLength": 1,
-                    "maxLength": 120,
-                    "pattern": "\\S"
+                    "minLength": 3,
+                    "maxLength": 120
                   }
                 },
                 "requiredTitleKeywordGroups": {
-                  "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+                  "description": "Job title keyword groups, at least 3 characters per keyword after trimming. The person must match every group, and any keyword inside a group.",
                   "maxItems": 10,
                   "type": "array",
                   "items": {
@@ -29935,22 +30142,20 @@ var init_generated = __esm({
                     "type": "array",
                     "items": {
                       "type": "string",
-                      "minLength": 1,
-                      "maxLength": 120,
-                      "pattern": "\\S"
+                      "minLength": 3,
+                      "maxLength": 120
                     }
                   }
                 },
                 "excludeTitleKeywords": {
-                  "description": "Job title keywords that remove a person.",
+                  "description": "Job title keywords that remove a person, at least 3 characters each after trimming.",
                   "minItems": 1,
                   "maxItems": 50,
                   "type": "array",
                   "items": {
                     "type": "string",
-                    "minLength": 1,
-                    "maxLength": 120,
-                    "pattern": "\\S"
+                    "minLength": 3,
+                    "maxLength": 120
                   }
                 },
                 "jobFunctions": {
@@ -30133,7 +30338,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 +30449,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. A title keyword, required title, title group or seniority is enough to search without a company filter. Otherwise use 1 to 5 positive company HQ countries or industries, a company id, company name, domain, email or person name. Empty and exclusion-only searches are rejected. 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"
@@ -30725,31 +30930,29 @@ var init_generated = __esm({
               "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
             },
             "titleKeywords": {
-              "description": "Job title keywords to match. A person can match any of them.",
+              "description": "Job title keywords to match, at least 3 characters each after trimming. A person can match any of them.",
               "minItems": 1,
               "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 120,
-                "pattern": "\\S"
+                "minLength": 3,
+                "maxLength": 120
               }
             },
             "requiredTitleKeywords": {
-              "description": "Job title keywords the person must match.",
+              "description": "Job title keywords the person must match, at least 3 characters each after trimming.",
               "minItems": 1,
               "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 120,
-                "pattern": "\\S"
+                "minLength": 3,
+                "maxLength": 120
               }
             },
             "requiredTitleKeywordGroups": {
-              "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+              "description": "Job title keyword groups, at least 3 characters per keyword after trimming. The person must match every group, and any keyword inside a group.",
               "maxItems": 10,
               "type": "array",
               "items": {
@@ -30758,22 +30961,20 @@ var init_generated = __esm({
                 "type": "array",
                 "items": {
                   "type": "string",
-                  "minLength": 1,
-                  "maxLength": 120,
-                  "pattern": "\\S"
+                  "minLength": 3,
+                  "maxLength": 120
                 }
               }
             },
             "excludeTitleKeywords": {
-              "description": "Job title keywords that remove a person.",
+              "description": "Job title keywords that remove a person, at least 3 characters each after trimming.",
               "minItems": 1,
               "maxItems": 50,
               "type": "array",
               "items": {
                 "type": "string",
-                "minLength": 1,
-                "maxLength": 120,
-                "pattern": "\\S"
+                "minLength": 3,
+                "maxLength": 120
               }
             },
             "jobFunctions": {
@@ -30890,12 +31091,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 +31173,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
@@ -33589,31 +33802,29 @@ var init_generated = __esm({
                           "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
                         },
                         "titleKeywords": {
-                          "description": "Job title keywords to match. A person can match any of them.",
+                          "description": "Job title keywords to match, at least 3 characters each after trimming. A person can match any of them.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "requiredTitleKeywords": {
-                          "description": "Job title keywords the person must match.",
+                          "description": "Job title keywords the person must match, at least 3 characters each after trimming.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "requiredTitleKeywordGroups": {
-                          "description": "Job title keyword groups. The person must match every group, and any keyword inside a group.",
+                          "description": "Job title keyword groups, at least 3 characters per keyword after trimming. The person must match every group, and any keyword inside a group.",
                           "maxItems": 10,
                           "type": "array",
                           "items": {
@@ -33622,22 +33833,20 @@ var init_generated = __esm({
                             "type": "array",
                             "items": {
                               "type": "string",
-                              "minLength": 1,
-                              "maxLength": 120,
-                              "pattern": "\\S"
+                              "minLength": 3,
+                              "maxLength": 120
                             }
                           }
                         },
                         "excludeTitleKeywords": {
-                          "description": "Job title keywords that remove a person.",
+                          "description": "Job title keywords that remove a person, at least 3 characters each after trimming.",
                           "minItems": 1,
                           "maxItems": 50,
                           "type": "array",
                           "items": {
                             "type": "string",
-                            "minLength": 1,
-                            "maxLength": 120,
-                            "pattern": "\\S"
+                            "minLength": 3,
+                            "maxLength": 120
                           }
                         },
                         "jobFunctions": {
@@ -33754,6 +33963,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 +34411,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 +34435,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 +34446,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 +34483,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 +34546,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 +34606,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 +34640,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 +34662,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 +38233,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "higherdata",
-      version: "0.6.0",
+      version: "0.7.1",
       type: "module",
       bin: {
         higherdata: "dist/index.js"
@@ -38052,7 +38283,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 +40106,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 +40887,7 @@ var suppressionKeyTypeSchema;
 var init_normalize = __esm({
   "../../src/lib/suppression/normalize.ts"() {
     "use strict";
+    init_linkedin();
     init_phone();
     init_es62();
     init_zod();
@@ -41051,28 +41290,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 +41302,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 +44221,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 +46825,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 +47041,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 +47054,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);
@@ -47187,7 +47519,7 @@ function BusyMark({ color, size = "large", options = animationOptions(), env = p
   }, [animate]);
   return /* @__PURE__ */ jsx5(Mark, { lines: animate ? busyFrame(frame, size) : markFrame(size), color });
 }
-function TerminalScreen({ state, columns, rows = 28, colors = true, profile = "default", space = "Default", workspace = "HigherOps", remaining = "--", profiles = [], fullScreen = false, identity = "API key", plan = "Plan unavailable", used = "--" }) {
+function TerminalScreen({ state, columns, rows = 28, colors = true, profile = "default", space = "Default", workspace = "HigherOps", remaining = "--", profiles = [], fullScreen = false, identity = "API key", plan = "Plan unavailable", used = "--", keychainNotice = "" }) {
   const width = Math.max(16, columns), color = colors ? "#f2b705" : void 0;
   const limit = Math.max(2, rows - (fullScreen ? 12 : 15));
   const extraRows = [state.error, state.notice].reduce((count, text2) => count + Math.ceil(clean(text2).length / (width - 4)), 0);
@@ -47413,7 +47745,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.";
@@ -47470,6 +47802,7 @@ function TerminalScreen({ state, columns, rows = 28, colors = true, profile = "d
   if (fullScreen) return /* @__PURE__ */ jsx5(PaletteContext.Provider, { value: colors, children: /* @__PURE__ */ jsxs3(Box4, { flexDirection: "column", width, height: rows, overflow: "hidden", backgroundColor: colors ? "#09090b" : void 0, children: [
     /* @__PURE__ */ jsxs3(Box4, { flexDirection: "column", flexGrow: 1, children: [
       /* @__PURE__ */ jsx5(AppBar, { columns: width, active: state.appTab ?? 0, colors, workspace, space, identity, plan, used, remaining }),
+      keychainNotice && /* @__PURE__ */ jsx5(Box4, { flexShrink: 0, paddingX: 1, children: /* @__PURE__ */ jsx5(Text, { wrap: "wrap", children: clean(keychainNotice) }) }),
       /* @__PURE__ */ jsx5(Box4, { flexDirection: "column", paddingX: 1, flexGrow: 1, overflow: "hidden", children: content })
     ] }),
     state.error && /* @__PURE__ */ jsx5(Text, { wrap: "truncate-end", color: colors ? "#ffe37a" : void 0, children: clean(state.error) }),
@@ -47525,6 +47858,7 @@ function TerminalScreen({ state, columns, rows = 28, colors = true, profile = "d
       ] })
     ] }),
     /* @__PURE__ */ jsx5(Text, { dimColor: true, children: "\u2550".repeat(Math.max(1, width - 4)) }),
+    keychainNotice && /* @__PURE__ */ jsx5(Text, { wrap: "wrap", children: clean(keychainNotice) }),
     /* @__PURE__ */ jsx5(Box4, { flexDirection: "column", width: width - 4, minHeight: largeHome ? 0 : Math.max(0, Math.min(rows - 16, 13)), children: content }),
     state.error && /* @__PURE__ */ jsx5(Text, { color: colors ? "red" : void 0, children: clean(state.error) }),
     state.notice && state.screen !== "busy" && /* @__PURE__ */ jsx5(Text, { dimColor: true, children: clean(state.notice) }),
@@ -47539,7 +47873,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"]];
     }
   }
@@ -47592,10 +47926,22 @@ import { open as open7 } from "fs/promises";
 import { useEffect as useEffect3, useRef as useRef2, useState as useState2 } from "react";
 import { render, useApp, useInput, useWindowSize } from "ink";
 import { jsx as jsx6 } from "react/jsx-runtime";
+function recordLabel(value, fallback) {
+  if (!value || typeof value !== "object") return fallback;
+  const record2 = value;
+  if (typeof record2.name === "string" && record2.name.trim()) return record2.name.trim();
+  if (typeof record2.slug === "string" && record2.slug.trim()) return record2.slug.trim();
+  return fallback;
+}
+function principalLabel(principal) {
+  const type = principal && typeof principal === "object" ? principal.type : void 0;
+  return type === "api_key" ? "Signed in with API key" : "Signed in";
+}
 function InteractiveApp({ session, fullScreen = true, events }) {
   const { exit } = useApp(), { columns, rows } = useWindowSize();
   const settings = session.settings();
-  const [chrome, setChrome] = useState2({ workspace: "Workspace", remaining: "--", identity: "Signed out", plan: "Plan unavailable", used: "--" });
+  const signedIn = Boolean(settings.apiKey);
+  const [chrome, setChrome] = useState2({ workspace: "Workspace", space: "", remaining: "--", identity: "Signed in", plan: "Plan unavailable", used: "--" });
   const targets = useRef2(/* @__PURE__ */ new Map());
   const pages = useRef2([]);
   const pressed = useRef2(void 0);
@@ -47612,12 +47958,11 @@ function InteractiveApp({ session, fullScreen = true, events }) {
   }, []);
   useEffect3(() => {
     let active = true;
-    if (!settings.apiKey || !settings.space) return;
+    if (!settings.apiKey) return;
     void Promise.all([session.call("account.whoami", {}), session.call("account.usage", {})]).then(([identity, usage]) => {
-      const tenant = identity.tenant;
-      if (active) setChrome({ workspace: tenant?.slug ?? "Workspace", remaining: typeof usage.verificationsRemaining === "number" ? usage.verificationsRemaining.toLocaleString("en-US") : "--", plan: typeof usage.plan === "string" ? usage.plan : "Plan unavailable", used: String(usage.verificationsUsed ?? "--"), identity: identity.principal?.type === "api_key" ? "Signed in with API key" : "Signed in" });
+      if (active) setChrome({ workspace: recordLabel(identity.tenant, "Workspace"), space: recordLabel(identity.space, ""), remaining: typeof usage.verificationsRemaining === "number" ? usage.verificationsRemaining.toLocaleString("en-US") : "--", plan: typeof usage.plan === "string" ? usage.plan : "Plan unavailable", used: String(usage.verificationsUsed ?? "--"), identity: principalLabel(identity.principal) });
     }).catch(() => {
-      if (active) setChrome({ workspace: "Account unavailable", remaining: "--", identity: "Account unavailable", plan: "Plan unavailable", used: "--" });
+      if (active) setChrome({ workspace: "Account unavailable", space: "Account unavailable", remaining: "--", identity: "Account unavailable", plan: "Plan unavailable", used: "--" });
     });
     return () => {
       active = false;
@@ -47713,7 +48058,7 @@ function InteractiveApp({ session, fullScreen = true, events }) {
     });
     else if (item.id === "login") void work("Waiting for browser approval...", async () => {
       await session.login((code, url2) => patch({ notice: `Approve ${code} at ${url2}` }));
-      return { screen: "home", notice: "Signed in. Choose a space to begin." };
+      return { screen: "home", notice: "Signed in." };
     });
     else if (item.id === "ask") void work("Loading your private conversation...", async () => ({ screen: "ask", ask: await session.call("agent.get", {}), text: "" }));
     else patch({ screen: "tools", group: item.id, selected: 0, appTab: Math.max(0, TAB_GROUPS.indexOf(item.id)) });
@@ -47991,11 +48336,11 @@ 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);
-  return /* @__PURE__ */ jsx6(PointerContext.Provider, { value: targets.current, children: /* @__PURE__ */ jsx6(TerminalScreen, { state, columns, rows, colors: !Object.hasOwn(session.runtime.env, "NO_COLOR") && session.runtime.env.TERM !== "dumb", profile: settings.profile, profiles: Object.keys(session.config.profiles), space: settings.space ?? "Choose a space", workspace: settings.apiKey && settings.space ? chrome.workspace : "Sign in and choose a space", remaining: settings.apiKey && settings.space ? chrome.remaining : "--", fullScreen, identity: settings.apiKey ? chrome.identity : "Signed out", plan: settings.apiKey ? chrome.plan : "Sign in", used: chrome.used }) });
+  const space = signedIn ? chrome.space || settings.space || "Choose a space" : "Signed out";
+  return /* @__PURE__ */ jsx6(PointerContext.Provider, { value: targets.current, children: /* @__PURE__ */ jsx6(TerminalScreen, { state, columns, rows, colors: !Object.hasOwn(session.runtime.env, "NO_COLOR") && session.runtime.env.TERM !== "dumb", profile: settings.profile, profiles: Object.keys(session.config.profiles), space, workspace: signedIn ? chrome.workspace : "Signed out", remaining: signedIn ? chrome.remaining : "--", fullScreen, identity: signedIn ? chrome.identity : "Signed out", plan: signedIn ? chrome.plan : "Sign in", used: signedIn ? chrome.used : "--", keychainNotice: session.keychainNotice }) });
 }
 async function launchInteractive(runtime, options) {
   if (options.idempotencyKey) throw new CliError("Omit --idempotency-key in the interactive app. Each confirmed action gets its own key.");
@@ -48078,8 +48423,18 @@ var init_app = __esm({
       runtime;
       options;
       config = { activeProfile: "default", profiles: { default: {} } };
+      keychainNotice = "";
+      rememberKeychainWarning = (message) => {
+        this.keychainNotice = message.replace(/\s+$/u, "");
+      };
+      loadConfig() {
+        return withConfigWarn(this.rememberKeychainWarning, () => this.runtime.readConfig());
+      }
+      saveConfig(config2 = this.config) {
+        return withConfigWarn(this.rememberKeychainWarning, () => this.runtime.writeConfig(config2));
+      }
       async load() {
-        this.config = await this.runtime.readConfig();
+        this.config = await this.loadConfig();
       }
       async lookup(query) {
         const result = await this.call("lookup.find", { query });
@@ -48102,19 +48457,20 @@ var init_app = __esm({
       async selectSpace(space) {
         await this.api(space).tool("account.whoami", {});
         this.config.profiles[this.config.activeProfile].space = space;
-        await this.runtime.writeConfig(this.config);
+        await this.saveConfig();
       }
       async selectProfile(profile) {
         if (this.runtime.env.HIGHERDATA_API_KEY) throw new CliError("Unset HIGHERDATA_API_KEY to switch saved workspace profiles.");
         if (!Object.hasOwn(this.config.profiles, profile)) throw new CliError("Choose a saved profile.");
         const config2 = { ...this.config, activeProfile: profile };
         await new ApiClient(resolveSettings(config2, this.options, this.runtime.env), this.runtime.fetchImpl).tool("account.whoami", {});
-        await this.runtime.writeConfig(config2);
+        await this.saveConfig(config2);
         this.config = config2;
       }
       async logout() {
         delete this.config.profiles[this.config.activeProfile].apiKey;
-        await this.runtime.writeConfig(this.config);
+        await this.saveConfig();
+        this.config = await this.loadConfig();
       }
       async install(kind, input2, print) {
         const options = { agent: input2.agent, scope: input2.scope, profile: input2.profile, print };
@@ -48122,8 +48478,11 @@ var init_app = __esm({
       }
       async login(prompt) {
         const settings = this.settings(), key = await deviceLogin(this.api(), { now: this.runtime.now, sleep: this.runtime.sleep, openBrowser: this.runtime.openBrowser, prompt });
-        this.config.profiles[this.config.activeProfile] = { apiUrl: settings.apiUrl, apiKey: key };
-        await this.runtime.writeConfig(this.config);
+        const profile = this.config.profiles[this.config.activeProfile];
+        this.config.profiles[this.config.activeProfile] = { ...profile, apiUrl: settings.apiUrl, apiKey: key };
+        delete this.config.profiles[this.config.activeProfile].space;
+        await this.saveConfig();
+        this.config = await this.loadConfig();
       }
       async download(state, path2, options = {}) {
         if (!path2.trim()) throw new CliError("Enter a new destination file.");
@@ -48254,7 +48613,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 +48656,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 +48758,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 +49001,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 +49027,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 +49109,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 });