autotouch-cli 0.2.79__tar.gz → 0.2.80__tar.gz

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.79
+Version: 0.2.80
 Summary: Autotouch Smart Table CLI
 Project-URL: Homepage, https://app.autotouch.ai
 Project-URL: Documentation, https://github.com/nicolonic/autotouch_main/tree/main/docs/research-table/reference
@@ -132,9 +132,9 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - Inspect one cell: `autotouch cells get`
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
-- Run provider-hidden search: `autotouch search companies`, `autotouch search people`
+- Run neural search for niche/specific company or people discovery: `autotouch search companies`, `autotouch search people`
 - Inspect LinkedIn filters: `autotouch linkedin filters --category people`
-- Build a durable lead list on Smart Table workers: `autotouch list-build leads --title 'Account Executive OR SDR' --geo-id 103644278 --num-results 1000 --wait`
+- Build durable company and lead lists on Smart Table workers: `autotouch list-build companies`, `autotouch list-build leads`
 - Run one LinkedIn search page/debug replay: `autotouch linkedin search`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
@@ -142,13 +142,23 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Query leads: `autotouch leads query`
 - Find a lead by email or phone: `autotouch leads query --search '<email-or-phone>' --limit 10`
 
+## Neural Search vs Durable List Build
+
+Autotouch has two different company/people discovery paths.
+
+Use `autotouch search companies` and `autotouch search people` for neural search when the target is niche, semantic, or hard to express with structured filters. Examples: "companies like Clay for healthcare", "AI workflow startups selling to law firms", or "RevOps operators at PLG SaaS companies". Neural company/people search returns at most 10 results per API call and costs 1 credit per API call.
+
+Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the default path for larger company and lead lists using filters like geography IDs, company size, industry IDs, title/persona, and current company IDs. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
+
+For account-first prospecting, build companies first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+
 ## More
 
 For automation or agent-driven setup, use:
 - `autotouch cli-manifest --output json` for the local machine-readable command contract
 - `autotouch cli-reference` for the shipped parser-generated reference
 - `autotouch capabilities --output json` for provider/workflow contracts
-- `autotouch --version` should be `0.2.79` or newer for provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
+- `autotouch --version` should be `0.2.80` or newer for the 10-result neural search cap and provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
 - `autotouch capabilities --output json --select list_builds` for documented list-build inputs such as geography IDs, company size buckets, profile language, and company IDs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable provider-hidden company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned network connection requirement
 - `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/README.md

@@ -107,9 +107,9 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - Inspect one cell: `autotouch cells get`
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
-- Run provider-hidden search: `autotouch search companies`, `autotouch search people`
+- Run neural search for niche/specific company or people discovery: `autotouch search companies`, `autotouch search people`
 - Inspect LinkedIn filters: `autotouch linkedin filters --category people`
-- Build a durable lead list on Smart Table workers: `autotouch list-build leads --title 'Account Executive OR SDR' --geo-id 103644278 --num-results 1000 --wait`
+- Build durable company and lead lists on Smart Table workers: `autotouch list-build companies`, `autotouch list-build leads`
 - Run one LinkedIn search page/debug replay: `autotouch linkedin search`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
@@ -117,13 +117,23 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Query leads: `autotouch leads query`
 - Find a lead by email or phone: `autotouch leads query --search '<email-or-phone>' --limit 10`
 
+## Neural Search vs Durable List Build
+
+Autotouch has two different company/people discovery paths.
+
+Use `autotouch search companies` and `autotouch search people` for neural search when the target is niche, semantic, or hard to express with structured filters. Examples: "companies like Clay for healthcare", "AI workflow startups selling to law firms", or "RevOps operators at PLG SaaS companies". Neural company/people search returns at most 10 results per API call and costs 1 credit per API call.
+
+Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the default path for larger company and lead lists using filters like geography IDs, company size, industry IDs, title/persona, and current company IDs. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
+
+For account-first prospecting, build companies first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+
 ## More
 
 For automation or agent-driven setup, use:
 - `autotouch cli-manifest --output json` for the local machine-readable command contract
 - `autotouch cli-reference` for the shipped parser-generated reference
 - `autotouch capabilities --output json` for provider/workflow contracts
-- `autotouch --version` should be `0.2.79` or newer for provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
+- `autotouch --version` should be `0.2.80` or newer for the 10-result neural search cap and provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
 - `autotouch capabilities --output json --select list_builds` for documented list-build inputs such as geography IDs, company size buckets, profile language, and company IDs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable provider-hidden company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned network connection requirement
 - `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/autotouch_cli/commands/search.py

@@ -67,7 +67,7 @@ def cmd_search_companies(args: argparse.Namespace, *, runtime: SearchCommandRunt
         runtime=runtime,
         default_payload={
             "query": str(getattr(args, "query", "") or "").strip(),
-            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+            "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 10)),
         },
     )
     data = runtime.request_api(
@@ -86,7 +86,7 @@ def cmd_search_companies(args: argparse.Namespace, *, runtime: SearchCommandRunt
 def cmd_search_people(args: argparse.Namespace, *, runtime: SearchCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
     payload: Dict[str, Any] = {
-        "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 10)),
     }
     query = str(getattr(args, "query", "") or "").strip()
     company = str(getattr(args, "company", "") or "").strip()
@@ -121,7 +121,7 @@ def cmd_search_similar_companies(args: argparse.Namespace, *, runtime: SearchCom
     token = runtime.resolve_token(args.token, required=True)
     payload: Dict[str, Any] = {
         "company_name": str(getattr(args, "company_name", "") or "").strip(),
-        "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 10)),
     }
     company_domain = str(getattr(args, "company_domain", "") or "").strip()
     company_description = str(getattr(args, "company_description", "") or "").strip()
@@ -266,7 +266,7 @@ def register_search_subcommands(
 
     companies_parser = search_sub.add_parser("companies", help="Find companies with provider-hidden neural search")
     companies_parser.add_argument("--query", help="Free-text company query")
-    companies_parser.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    companies_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-10 (default: 10)")
     companies_parser.add_argument("--data-json", help="Explicit request payload JSON")
     companies_parser.add_argument("--data-file", help="Path to request payload JSON file")
     add_api_common_arguments(companies_parser)
@@ -277,7 +277,7 @@ def register_search_subcommands(
     people_parser.add_argument("--company", help="Optional company name")
     people_parser.add_argument("--location", help="Optional location")
     people_parser.add_argument("--skill", action="append", help="Optional skill (repeatable; comma-separated also supported)")
-    people_parser.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    people_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-10 (default: 10)")
     people_parser.add_argument("--data-json", help="Explicit request payload JSON")
     people_parser.add_argument("--data-file", help="Path to request payload JSON file")
     add_api_common_arguments(people_parser)
@@ -287,7 +287,7 @@ def register_search_subcommands(
     similar_parser.add_argument("--company-name", help="Seed company name")
     similar_parser.add_argument("--company-domain", help="Official company domain to ground similarity search")
     similar_parser.add_argument("--company-description", help="Short semantic company description to improve peer matching")
-    similar_parser.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    similar_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-10 (default: 10)")
     similar_parser.add_argument("--data-json", help="Explicit request payload JSON")
     similar_parser.add_argument("--data-file", help="Path to request payload JSON file")
     add_api_common_arguments(similar_parser)

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.79`.
+Generated from the installed parser for `autotouch-cli` `0.2.80`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -3774,7 +3774,7 @@ Find companies with provider-hidden neural search
                                   --json-pointer JSON_POINTER] [--verbose]`
 - Options:
   - `--query` (kind=string): Free-text company query
-  - `--limit` (kind=integer; default=25): Max results, 1-100 (default: 25)
+  - `--limit` (kind=integer; default=10): Max results, 1-10 (default: 10)
   - `--data-json` (kind=json; input=json): Explicit request payload JSON
   - `--data-file` (kind=file; input=file): Path to request payload JSON file
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
@@ -3914,7 +3914,7 @@ Find people with provider-hidden neural search
   - `--company` (kind=string): Optional company name
   - `--location` (kind=string): Optional location
   - `--skill` (kind=string; repeatable; comma-separated): Optional skill (repeatable; comma-separated also supported)
-  - `--limit` (kind=integer; default=25): Max results, 1-100 (default: 25)
+  - `--limit` (kind=integer; default=10): Max results, 1-10 (default: 10)
   - `--data-json` (kind=json; input=json): Explicit request payload JSON
   - `--data-file` (kind=file; input=file): Path to request payload JSON file
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
@@ -4026,7 +4026,7 @@ Find companies similar to a seed company
   - `--company-name` (kind=string): Seed company name
   - `--company-domain` (kind=string): Official company domain to ground similarity search
   - `--company-description` (kind=string): Short semantic company description to improve peer matching
-  - `--limit` (kind=integer; default=25): Max results, 1-100 (default: 25)
+  - `--limit` (kind=integer; default=10): Max results, 1-10 (default: 10)
   - `--data-json` (kind=json; input=json): Explicit request payload JSON
   - `--data-file` (kind=file; input=file): Path to request payload JSON file
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.79",
+  "version": "0.2.80",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -6324,11 +6324,11 @@
         {
           "dest": "limit",
           "required": false,
-          "help": "Max results, 1-100 (default: 25)",
+          "help": "Max results, 1-10 (default: 10)",
           "kind": "integer",
           "action": "store",
-          "default_when_omitted": 25,
-          "default": 25,
+          "default_when_omitted": 10,
+          "default": 10,
           "flags": [
             "--limit"
           ],
@@ -6579,11 +6579,11 @@
         {
           "dest": "limit",
           "required": false,
-          "help": "Max results, 1-100 (default: 25)",
+          "help": "Max results, 1-10 (default: 10)",
           "kind": "integer",
           "action": "store",
-          "default_when_omitted": 25,
-          "default": 25,
+          "default_when_omitted": 10,
+          "default": 10,
           "flags": [
             "--limit"
           ],
@@ -6821,11 +6821,11 @@
         {
           "dest": "limit",
           "required": false,
-          "help": "Max results, 1-100 (default: 25)",
+          "help": "Max results, 1-10 (default: 10)",
           "kind": "integer",
           "action": "store",
-          "default_when_omitted": 25,
-          "default": 25,
+          "default_when_omitted": 10,
+          "default": 10,
           "flags": [
             "--limit"
           ],

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.79
+Version: 0.2.80
 Summary: Autotouch Smart Table CLI
 Project-URL: Homepage, https://app.autotouch.ai
 Project-URL: Documentation, https://github.com/nicolonic/autotouch_main/tree/main/docs/research-table/reference
@@ -132,9 +132,9 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - Inspect one cell: `autotouch cells get`
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
-- Run provider-hidden search: `autotouch search companies`, `autotouch search people`
+- Run neural search for niche/specific company or people discovery: `autotouch search companies`, `autotouch search people`
 - Inspect LinkedIn filters: `autotouch linkedin filters --category people`
-- Build a durable lead list on Smart Table workers: `autotouch list-build leads --title 'Account Executive OR SDR' --geo-id 103644278 --num-results 1000 --wait`
+- Build durable company and lead lists on Smart Table workers: `autotouch list-build companies`, `autotouch list-build leads`
 - Run one LinkedIn search page/debug replay: `autotouch linkedin search`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
@@ -142,13 +142,23 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Query leads: `autotouch leads query`
 - Find a lead by email or phone: `autotouch leads query --search '<email-or-phone>' --limit 10`
 
+## Neural Search vs Durable List Build
+
+Autotouch has two different company/people discovery paths.
+
+Use `autotouch search companies` and `autotouch search people` for neural search when the target is niche, semantic, or hard to express with structured filters. Examples: "companies like Clay for healthcare", "AI workflow startups selling to law firms", or "RevOps operators at PLG SaaS companies". Neural company/people search returns at most 10 results per API call and costs 1 credit per API call.
+
+Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the default path for larger company and lead lists using filters like geography IDs, company size, industry IDs, title/persona, and current company IDs. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
+
+For account-first prospecting, build companies first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+
 ## More
 
 For automation or agent-driven setup, use:
 - `autotouch cli-manifest --output json` for the local machine-readable command contract
 - `autotouch cli-reference` for the shipped parser-generated reference
 - `autotouch capabilities --output json` for provider/workflow contracts
-- `autotouch --version` should be `0.2.79` or newer for provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
+- `autotouch --version` should be `0.2.80` or newer for the 10-result neural search cap and provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
 - `autotouch capabilities --output json --select list_builds` for documented list-build inputs such as geography IDs, company size buckets, profile language, and company IDs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable provider-hidden company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned network connection requirement
 - `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/autotouch_shared/search_contract.py

@@ -16,7 +16,7 @@ _SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
         "required_scope": SEARCH_SCOPE,
         "body": {
             "query": "required free-text company search query",
-            "limit": "optional 1-100 (default 25)",
+            "limit": "optional 1-10 (default 10)",
         },
         "response": {"items_field": "items", "item_type": "company"},
     },
@@ -29,7 +29,7 @@ _SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
             "company": "optional target company name",
             "location": "optional location string",
             "skills": "optional string[]",
-            "limit": "optional 1-100 (default 25)",
+            "limit": "optional 1-10 (default 10)",
         },
         "response": {"items_field": "items", "item_type": "person"},
     },
@@ -41,7 +41,7 @@ _SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
             "company_name": "required seed company name",
             "company_domain": "optional official company domain",
             "company_description": "optional short semantic description to improve peer matching",
-            "limit": "optional 1-100 (default 25)",
+            "limit": "optional 1-10 (default 10)",
         },
         "response": {"items_field": "items", "item_type": "company"},
     },
@@ -119,11 +119,11 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
         ],
     },
     "pricing": {
-        "charge_on": "actual_results_returned",
+        "charge_on": "api_call_or_actual_results_returned",
         "families": {
-            "companies": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
-            "people": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
-            "similar_companies": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
+            "companies": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
+            "people": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
+            "similar_companies": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
             "news": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
             "local_businesses": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
             "reviews": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
@@ -140,11 +140,11 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
 
 _SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
     "companies": {
-        "payload": {"query": "remote IT asset management", "limit": 25},
+        "payload": {"query": "remote IT asset management", "limit": 10},
         "usage": "autotouch search companies --data-file <payload.json>",
         "notes": [
             "Use this when you need to discover target accounts first.",
-            "Pricing: 1 credit per 10 returned companies.",
+            "Pricing: 1 credit per neural search API call. Max 10 returned companies per call.",
         ],
     },
     "people": {
@@ -153,12 +153,12 @@ _SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
             "company": "Rippling",
             "location": "United States",
             "skills": ["endpoint management", "IT operations"],
-            "limit": 25,
+            "limit": 10,
         },
         "usage": "autotouch search people --data-file <payload.json>",
         "notes": [
             "Use this when you already know the target companies or persona.",
-            "Pricing: 1 credit per 10 returned people.",
+            "Pricing: 1 credit per neural search API call. Max 10 returned people per call.",
         ],
     },
     "similar_companies": {
@@ -166,13 +166,13 @@ _SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
             "company_name": "Rippling",
             "company_domain": "rippling.com",
             "company_description": "Workforce management and HR software platform for businesses",
-            "limit": 25,
+            "limit": 10,
         },
         "usage": "autotouch search similar-companies --data-file <payload.json>",
         "notes": [
             "Good for expanding a seed account list.",
             "Best results come from providing company_domain and a short company_description when known.",
-            "Pricing: 1 credit per 10 returned companies.",
+            "Pricing: 1 credit per neural search API call. Max 10 returned companies per call.",
         ],
     },
     "news": {

{autotouch_cli-0.2.79 → autotouch_cli-0.2.80}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autotouch-cli"
-version = "0.2.79"
+version = "0.2.80"
 description = "Autotouch Smart Table CLI"
 readme = "README.md"
 requires-python = ">=3.9"