autotouch-cli 0.2.83__tar.gz → 0.2.85__tar.gz

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.83
+Version: 0.2.85
 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
@@ -150,7 +150,7 @@ Use `autotouch search companies` and `autotouch search people` for neural search
 
 Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the only CLI path for building LinkedIn-sourced company and lead lists. Treat list builds as the sourcing step for the Smart Table research workspace: build company/account records first by default, add the records to a research table, then enrich, score, segment, find related leads, attach signals/notes, and continue downstream workflows from that table. Use lead builds directly when the request is explicitly person/contact focused. This path uses Autotouch-managed provider access, so users do not need to connect their own LinkedIn account. Use filters like geography IDs, company size, industry IDs, title/persona, and current company IDs; call `autotouch list-build inputs` for supported values. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
 
-For structured company builds, start with industry IDs plus geo/company-size filters. Company builds still need a broad `keywords` anchor (for example, `software`), but keywords are less reliable because they depend on company/profile text; use them to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
+For structured company builds, start with industry IDs plus geo/company-size filters. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
 
 For account-first prospecting, build companies/accounts 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.
 
@@ -160,7 +160,7 @@ 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.83` or newer for the cleaned single LinkedIn-sourced list-build path, `list-build inputs/pricing`, research-workspace list-build guidance, and 10-result neural search cap
+- `autotouch --version` should be `0.2.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
 - `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 inputs` and `autotouch list-build pricing` before creating durable list-build jobs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable LinkedIn-sourced company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned LinkedIn connection requirement

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/README.md

@@ -125,7 +125,7 @@ Use `autotouch search companies` and `autotouch search people` for neural search
 
 Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the only CLI path for building LinkedIn-sourced company and lead lists. Treat list builds as the sourcing step for the Smart Table research workspace: build company/account records first by default, add the records to a research table, then enrich, score, segment, find related leads, attach signals/notes, and continue downstream workflows from that table. Use lead builds directly when the request is explicitly person/contact focused. This path uses Autotouch-managed provider access, so users do not need to connect their own LinkedIn account. Use filters like geography IDs, company size, industry IDs, title/persona, and current company IDs; call `autotouch list-build inputs` for supported values. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
 
-For structured company builds, start with industry IDs plus geo/company-size filters. Company builds still need a broad `keywords` anchor (for example, `software`), but keywords are less reliable because they depend on company/profile text; use them to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
+For structured company builds, start with industry IDs plus geo/company-size filters. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
 
 For account-first prospecting, build companies/accounts 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.
 
@@ -135,7 +135,7 @@ 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.83` or newer for the cleaned single LinkedIn-sourced list-build path, `list-build inputs/pricing`, research-workspace list-build guidance, and 10-result neural search cap
+- `autotouch --version` should be `0.2.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
 - `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 inputs` and `autotouch list-build pricing` before creating durable list-build jobs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable LinkedIn-sourced company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned LinkedIn connection requirement

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/autotouch_cli/commands/list_build.py

@@ -5,6 +5,7 @@ import json
 import time
 from dataclasses import dataclass
 from typing import Any, Callable, Dict, Optional
+from urllib.parse import urlencode
 
 from autotouch_cli.exceptions import AutotouchInputError, AutotouchTimeoutError
 
@@ -43,9 +44,15 @@ def _payload(args: argparse.Namespace, *, runtime: ListBuildCommandRuntime, kind
             filters[key] = values
     if getattr(args, "has_jobs", False):
         filters["has_jobs"] = True
-    profile_language = str(getattr(args, "profile_language", "") or "").strip()
-    if profile_language:
-        filters["profile_language"] = profile_language
+    for attr, key in (
+        ("profile_language", "profile_language"),
+        ("service_category", "service_category"),
+        ("first_name", "first_name"),
+        ("last_name", "last_name"),
+    ):
+        value = str(getattr(args, attr, "") or "").strip()
+        if value:
+            filters[key] = value
     payload: Dict[str, Any] = {
         "kind": kind,
         "num_results": max(1, min(int(getattr(args, "num_results", 100) or 100), 10000)),
@@ -134,6 +141,29 @@ def cmd_list_build_results(args: argparse.Namespace, *, runtime: ListBuildComman
 
 def cmd_list_build_inputs(args: argparse.Namespace, *, runtime: ListBuildCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
+    input_type = str(getattr(args, "type", "") or "").strip()
+    query = str(getattr(args, "query", "") or "").strip()
+    if input_type or query:
+        if not input_type or not query:
+            raise AutotouchInputError("list-build inputs search requires both --type and --query")
+        params = urlencode(
+            {
+                "type": input_type,
+                "q": query,
+                "limit": max(1, min(int(getattr(args, "limit", 20) or 20), 50)),
+            }
+        )
+        data = runtime.request_api(
+            "GET",
+            f"/api/list-builds/inputs/search?{params}",
+            base_url=args.base_url,
+            token=token,
+            use_x_api_key=args.use_x_api_key,
+            timeout=args.timeout,
+            verbose=args.verbose,
+        )
+        runtime.print_json(data, args.compact)
+        return
     data = runtime.request_api(
         "GET",
         "/api/list-builds/inputs",
@@ -169,20 +199,10 @@ def register_list_build_subcommands(
     parser = subparsers.add_parser("list-build", help="Build durable LinkedIn-sourced company and lead lists")
     sub = parser.add_subparsers(dest="list_build_cmd", required=True)
 
-    def add_create_args(p: argparse.ArgumentParser) -> None:
+    def add_common_create_args(p: argparse.ArgumentParser) -> None:
         p.add_argument("--data-json", help="Explicit list-build payload JSON")
         p.add_argument("--data-file", help="Path to list-build payload JSON file")
         p.add_argument("--list-name", help="Optional display name")
-        p.add_argument("--keywords", help="Search keywords")
-        p.add_argument("--title", help="Lead title/persona query")
-        p.add_argument("--geo-id", action="append", help="Geography ID; repeat or comma-separate in JSON")
-        p.add_argument("--industry-id", action="append", help="Industry ID; repeat or comma-separate in JSON")
-        p.add_argument("--company-size", action="append", help="Company size bucket, e.g. 1-10 or 11-50")
-        p.add_argument("--current-company-id", action="append", help="Company ID for lead search")
-        p.add_argument("--past-company-id", action="append", help="Past company ID for lead search")
-        p.add_argument("--school-id", action="append", help="School ID for lead search")
-        p.add_argument("--profile-language", help="Profile language code, e.g. en")
-        p.add_argument("--has-jobs", action="store_true", help="Only include companies with active job listings")
         p.add_argument("--num-results", type=int, default=100, help="Target result count, 1-10000")
         p.add_argument("--page-size", type=int, default=25, help="Provider page size")
         p.add_argument("--wait", action="store_true", help="Poll until terminal status")
@@ -190,12 +210,34 @@ def register_list_build_subcommands(
         p.add_argument("--wait-timeout", type=int, default=0, help="Max seconds to wait (0 = no timeout)")
         add_api_common_arguments(p)
 
+    def add_company_create_args(p: argparse.ArgumentParser) -> None:
+        add_common_create_args(p)
+        p.add_argument("--keywords", required=False, help="Optional company keyword anchor; structured filters can run without it")
+        p.add_argument("--geo-id", action="append", help="LinkedIn GeoURN ID; repeat or comma-separate in JSON")
+        p.add_argument("--industry-id", action="append", help="Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON")
+        p.add_argument("--company-size", action="append", help="Company size bucket, e.g. 1-10 or 11-50")
+        p.add_argument("--has-jobs", action="store_true", help="Only include companies with active job listings")
+
+    def add_lead_create_args(p: argparse.ArgumentParser) -> None:
+        add_common_create_args(p)
+        p.add_argument("--keywords", help="Optional free-text profile keyword")
+        p.add_argument("--title", help="Lead title/persona query")
+        p.add_argument("--geo-id", action="append", help="LinkedIn GeoURN ID; repeat or comma-separate in JSON")
+        p.add_argument("--industry-id", action="append", help="Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON")
+        p.add_argument("--current-company-id", action="append", help="Company ID returned by a company list build")
+        p.add_argument("--past-company-id", action="append", help="Past company ID for lead search")
+        p.add_argument("--school-id", action="append", help="School ID for lead search")
+        p.add_argument("--profile-language", help="Profile language code, e.g. en")
+        p.add_argument("--service-category", help="Service category string")
+        p.add_argument("--first-name", help="First-name filter")
+        p.add_argument("--last-name", help="Last-name filter")
+
     companies = sub.add_parser("companies", help="Build a company/account list")
-    add_create_args(companies)
+    add_company_create_args(companies)
     companies.set_defaults(func=handlers["companies"])
 
     leads = sub.add_parser("leads", help="Build a lead/contact list")
-    add_create_args(leads)
+    add_lead_create_args(leads)
     leads.set_defaults(func=handlers["leads"])
 
     status = sub.add_parser("status", help="Get list-build job status")
@@ -212,6 +254,9 @@ def register_list_build_subcommands(
     results.set_defaults(func=handlers["results"])
 
     inputs = sub.add_parser("inputs", help="Show valid list-build filter IDs and values")
+    inputs.add_argument("--type", choices=["geo", "industry", "service", "title_skill", "title-skills"], help="Search input type")
+    inputs.add_argument("--query", help="Search text for input ID lookup")
+    inputs.add_argument("--limit", type=int, default=20, help="Max lookup results, 1-50")
     add_api_common_arguments(inputs)
     inputs.set_defaults(func=handlers["inputs"])
 

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.83`.
+Generated from the installed parser for `autotouch-cli` `0.2.85`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -2323,15 +2323,7 @@ Build a company/account list
   - `autotouch list-build companies [-h] [--data-json DATA_JSON]
                                       [--data-file DATA_FILE]
                                       [--list-name LIST_NAME]
-                                      [--keywords KEYWORDS] [--title TITLE]
-                                      [--geo-id GEO_ID]
-                                      [--industry-id INDUSTRY_ID]
-                                      [--company-size COMPANY_SIZE]
-                                      [--current-company-id CURRENT_COMPANY_ID]
-                                      [--past-company-id PAST_COMPANY_ID]
-                                      [--school-id SCHOOL_ID]
-                                      [--profile-language PROFILE_LANGUAGE]
-                                      [--has-jobs] [--num-results NUM_RESULTS]
+                                      [--num-results NUM_RESULTS]
                                       [--page-size PAGE_SIZE] [--wait]
                                       [--poll-interval POLL_INTERVAL]
                                       [--wait-timeout WAIT_TIMEOUT]
@@ -2339,21 +2331,15 @@ Build a company/account list
                                       [--use-x-api-key] [--timeout TIMEOUT]
                                       [--output {json,ndjson,human}]
                                       [--compact] [--select SELECT |
-                                      --json-pointer JSON_POINTER] [--verbose]`
+                                      --json-pointer JSON_POINTER] [--verbose]
+                                      [--keywords KEYWORDS] [--geo-id GEO_ID]
+                                      [--industry-id INDUSTRY_ID]
+                                      [--company-size COMPANY_SIZE]
+                                      [--has-jobs]`
 - Options:
   - `--data-json` (kind=json; input=json): Explicit list-build payload JSON
   - `--data-file` (kind=file; input=file): Path to list-build payload JSON file
   - `--list-name` (kind=string): Optional display name
-  - `--keywords` (kind=string): Search keywords
-  - `--title` (kind=string): Lead title/persona query
-  - `--geo-id` (kind=string; repeatable): Geography ID; repeat or comma-separate in JSON
-  - `--industry-id` (kind=string; repeatable): Industry ID; repeat or comma-separate in JSON
-  - `--company-size` (kind=string; repeatable): Company size bucket, e.g. 1-10 or 11-50
-  - `--current-company-id` (kind=string; repeatable): Company ID for lead search
-  - `--past-company-id` (kind=string; repeatable): Past company ID for lead search
-  - `--school-id` (kind=string; repeatable): School ID for lead search
-  - `--profile-language` (kind=string): Profile language code, e.g. en
-  - `--has-jobs` (kind=boolean; when omitted=False; when present=True): Only include companies with active job listings
   - `--num-results` (kind=integer; default=100): Target result count, 1-10000
   - `--page-size` (kind=integer; default=25): Provider page size
   - `--wait` (kind=boolean; when omitted=False; when present=True): Poll until terminal status
@@ -2368,6 +2354,11 @@ Build a company/account list
   - `--select` (kind=string): Extract a dotted field path from the final result (for example: id or items.0.id)
   - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
   - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
+  - `--keywords` (kind=string): Optional company keyword anchor; structured filters can run without it
+  - `--geo-id` (kind=string; repeatable): LinkedIn GeoURN ID; repeat or comma-separate in JSON
+  - `--industry-id` (kind=string; repeatable): Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON
+  - `--company-size` (kind=string; repeatable): Company size bucket, e.g. 1-10 or 11-50
+  - `--has-jobs` (kind=boolean; when omitted=False; when present=True): Only include companies with active job listings
 
 #### `autotouch list-build inputs`
 
@@ -2378,12 +2369,18 @@ Show valid list-build filter IDs and values
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch list-build inputs [-h] [--base-url BASE_URL] [--token TOKEN]
+  - `autotouch list-build inputs [-h]
+                                   [--type {geo,industry,service,title_skill,title-skills}]
+                                   [--query QUERY] [--limit LIMIT]
+                                   [--base-url BASE_URL] [--token TOKEN]
                                    [--use-x-api-key] [--timeout TIMEOUT]
                                    [--output {json,ndjson,human}] [--compact]
                                    [--select SELECT |
                                    --json-pointer JSON_POINTER] [--verbose]`
 - Options:
+  - `--type` (kind=string; choices=geo,industry,service,title_skill,title-skills): Search input type
+  - `--query` (kind=string): Search text for input ID lookup
+  - `--limit` (kind=integer; default=20): Max lookup results, 1-50
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
   - `--token` (kind=string; sensitive): Developer API key / JWT token
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
@@ -2406,15 +2403,7 @@ Build a lead/contact list
   - `autotouch list-build leads [-h] [--data-json DATA_JSON]
                                   [--data-file DATA_FILE]
                                   [--list-name LIST_NAME]
-                                  [--keywords KEYWORDS] [--title TITLE]
-                                  [--geo-id GEO_ID]
-                                  [--industry-id INDUSTRY_ID]
-                                  [--company-size COMPANY_SIZE]
-                                  [--current-company-id CURRENT_COMPANY_ID]
-                                  [--past-company-id PAST_COMPANY_ID]
-                                  [--school-id SCHOOL_ID]
-                                  [--profile-language PROFILE_LANGUAGE]
-                                  [--has-jobs] [--num-results NUM_RESULTS]
+                                  [--num-results NUM_RESULTS]
                                   [--page-size PAGE_SIZE] [--wait]
                                   [--poll-interval POLL_INTERVAL]
                                   [--wait-timeout WAIT_TIMEOUT]
@@ -2422,21 +2411,21 @@ Build a lead/contact list
                                   [--use-x-api-key] [--timeout TIMEOUT]
                                   [--output {json,ndjson,human}] [--compact]
                                   [--select SELECT |
-                                  --json-pointer JSON_POINTER] [--verbose]`
+                                  --json-pointer JSON_POINTER] [--verbose]
+                                  [--keywords KEYWORDS] [--title TITLE]
+                                  [--geo-id GEO_ID]
+                                  [--industry-id INDUSTRY_ID]
+                                  [--current-company-id CURRENT_COMPANY_ID]
+                                  [--past-company-id PAST_COMPANY_ID]
+                                  [--school-id SCHOOL_ID]
+                                  [--profile-language PROFILE_LANGUAGE]
+                                  [--service-category SERVICE_CATEGORY]
+                                  [--first-name FIRST_NAME]
+                                  [--last-name LAST_NAME]`
 - Options:
   - `--data-json` (kind=json; input=json): Explicit list-build payload JSON
   - `--data-file` (kind=file; input=file): Path to list-build payload JSON file
   - `--list-name` (kind=string): Optional display name
-  - `--keywords` (kind=string): Search keywords
-  - `--title` (kind=string): Lead title/persona query
-  - `--geo-id` (kind=string; repeatable): Geography ID; repeat or comma-separate in JSON
-  - `--industry-id` (kind=string; repeatable): Industry ID; repeat or comma-separate in JSON
-  - `--company-size` (kind=string; repeatable): Company size bucket, e.g. 1-10 or 11-50
-  - `--current-company-id` (kind=string; repeatable): Company ID for lead search
-  - `--past-company-id` (kind=string; repeatable): Past company ID for lead search
-  - `--school-id` (kind=string; repeatable): School ID for lead search
-  - `--profile-language` (kind=string): Profile language code, e.g. en
-  - `--has-jobs` (kind=boolean; when omitted=False; when present=True): Only include companies with active job listings
   - `--num-results` (kind=integer; default=100): Target result count, 1-10000
   - `--page-size` (kind=integer; default=25): Provider page size
   - `--wait` (kind=boolean; when omitted=False; when present=True): Poll until terminal status
@@ -2451,6 +2440,17 @@ Build a lead/contact list
   - `--select` (kind=string): Extract a dotted field path from the final result (for example: id or items.0.id)
   - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
   - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
+  - `--keywords` (kind=string): Optional free-text profile keyword
+  - `--title` (kind=string): Lead title/persona query
+  - `--geo-id` (kind=string; repeatable): LinkedIn GeoURN ID; repeat or comma-separate in JSON
+  - `--industry-id` (kind=string; repeatable): Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON
+  - `--current-company-id` (kind=string; repeatable): Company ID returned by a company list build
+  - `--past-company-id` (kind=string; repeatable): Past company ID for lead search
+  - `--school-id` (kind=string; repeatable): School ID for lead search
+  - `--profile-language` (kind=string): Profile language code, e.g. en
+  - `--service-category` (kind=string): Service category string
+  - `--first-name` (kind=string): First-name filter
+  - `--last-name` (kind=string): Last-name filter
 
 #### `autotouch list-build pricing`
 

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.83",
+  "version": "0.2.85",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -32826,125 +32826,6 @@
           ],
           "takes_value": true
         },
-        {
-          "dest": "keywords",
-          "required": false,
-          "help": "Search keywords",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--keywords"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "title",
-          "required": false,
-          "help": "Lead title/persona query",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--title"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "geo_id",
-          "required": false,
-          "help": "Geography ID; repeat or comma-separate in JSON",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--geo-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "industry_id",
-          "required": false,
-          "help": "Industry ID; repeat or comma-separate in JSON",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--industry-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "company_size",
-          "required": false,
-          "help": "Company size bucket, e.g. 1-10 or 11-50",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--company-size"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "current_company_id",
-          "required": false,
-          "help": "Company ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--current-company-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "past_company_id",
-          "required": false,
-          "help": "Past company ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--past-company-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "school_id",
-          "required": false,
-          "help": "School ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--school-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "profile_language",
-          "required": false,
-          "help": "Profile language code, e.g. en",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--profile-language"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "has_jobs",
-          "required": false,
-          "help": "Only include companies with active job listings",
-          "kind": "boolean",
-          "action": "store_true",
-          "nargs": 0,
-          "default_when_omitted": false,
-          "value_when_present": true,
-          "flags": [
-            "--has-jobs"
-          ],
-          "takes_value": false
-        },
         {
           "dest": "num_results",
           "required": false,
@@ -33130,6 +33011,67 @@
             "--verbose"
           ],
           "takes_value": false
+        },
+        {
+          "dest": "keywords",
+          "required": false,
+          "help": "Optional company keyword anchor; structured filters can run without it",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--keywords"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "geo_id",
+          "required": false,
+          "help": "LinkedIn GeoURN ID; repeat or comma-separate in JSON",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--geo-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "industry_id",
+          "required": false,
+          "help": "Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--industry-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "company_size",
+          "required": false,
+          "help": "Company size bucket, e.g. 1-10 or 11-50",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--company-size"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "has_jobs",
+          "required": false,
+          "help": "Only include companies with active job listings",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--has-jobs"
+          ],
+          "takes_value": false
         }
       ],
       "mutually_exclusive_groups": [
@@ -33164,7 +33106,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch list-build companies [-h] [--data-json DATA_JSON]\n                                      [--data-file DATA_FILE]\n                                      [--list-name LIST_NAME]\n                                      [--keywords KEYWORDS] [--title TITLE]\n                                      [--geo-id GEO_ID]\n                                      [--industry-id INDUSTRY_ID]\n                                      [--company-size COMPANY_SIZE]\n                                      [--current-company-id CURRENT_COMPANY_ID]\n                                      [--past-company-id PAST_COMPANY_ID]\n                                      [--school-id SCHOOL_ID]\n                                      [--profile-language PROFILE_LANGUAGE]\n                                      [--has-jobs] [--num-results NUM_RESULTS]\n                                      [--page-size PAGE_SIZE] [--wait]\n                                      [--poll-interval POLL_INTERVAL]\n                                      [--wait-timeout WAIT_TIMEOUT]\n                                      [--base-url BASE_URL] [--token TOKEN]\n                                      [--use-x-api-key] [--timeout TIMEOUT]\n                                      [--output {json,ndjson,human}]\n                                      [--compact] [--select SELECT |\n                                      --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch list-build companies [-h] [--data-json DATA_JSON]\n                                      [--data-file DATA_FILE]\n                                      [--list-name LIST_NAME]\n                                      [--num-results NUM_RESULTS]\n                                      [--page-size PAGE_SIZE] [--wait]\n                                      [--poll-interval POLL_INTERVAL]\n                                      [--wait-timeout WAIT_TIMEOUT]\n                                      [--base-url BASE_URL] [--token TOKEN]\n                                      [--use-x-api-key] [--timeout TIMEOUT]\n                                      [--output {json,ndjson,human}]\n                                      [--compact] [--select SELECT |\n                                      --json-pointer JSON_POINTER] [--verbose]\n                                      [--keywords KEYWORDS] [--geo-id GEO_ID]\n                                      [--industry-id INDUSTRY_ID]\n                                      [--company-size COMPANY_SIZE]\n                                      [--has-jobs]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -33218,125 +33160,6 @@
           ],
           "takes_value": true
         },
-        {
-          "dest": "keywords",
-          "required": false,
-          "help": "Search keywords",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--keywords"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "title",
-          "required": false,
-          "help": "Lead title/persona query",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--title"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "geo_id",
-          "required": false,
-          "help": "Geography ID; repeat or comma-separate in JSON",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--geo-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "industry_id",
-          "required": false,
-          "help": "Industry ID; repeat or comma-separate in JSON",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--industry-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "company_size",
-          "required": false,
-          "help": "Company size bucket, e.g. 1-10 or 11-50",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--company-size"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "current_company_id",
-          "required": false,
-          "help": "Company ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--current-company-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "past_company_id",
-          "required": false,
-          "help": "Past company ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--past-company-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "school_id",
-          "required": false,
-          "help": "School ID for lead search",
-          "kind": "string",
-          "action": "append",
-          "repeatable": true,
-          "flags": [
-            "--school-id"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "profile_language",
-          "required": false,
-          "help": "Profile language code, e.g. en",
-          "kind": "string",
-          "action": "store",
-          "flags": [
-            "--profile-language"
-          ],
-          "takes_value": true
-        },
-        {
-          "dest": "has_jobs",
-          "required": false,
-          "help": "Only include companies with active job listings",
-          "kind": "boolean",
-          "action": "store_true",
-          "nargs": 0,
-          "default_when_omitted": false,
-          "value_when_present": true,
-          "flags": [
-            "--has-jobs"
-          ],
-          "takes_value": false
-        },
         {
           "dest": "num_results",
           "required": false,
@@ -33522,6 +33345,132 @@
             "--verbose"
           ],
           "takes_value": false
+        },
+        {
+          "dest": "keywords",
+          "required": false,
+          "help": "Optional free-text profile keyword",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--keywords"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "title",
+          "required": false,
+          "help": "Lead title/persona query",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--title"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "geo_id",
+          "required": false,
+          "help": "LinkedIn GeoURN ID; repeat or comma-separate in JSON",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--geo-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "industry_id",
+          "required": false,
+          "help": "Industry ID from `autotouch list-build inputs`; repeat or comma-separate in JSON",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--industry-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "current_company_id",
+          "required": false,
+          "help": "Company ID returned by a company list build",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--current-company-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "past_company_id",
+          "required": false,
+          "help": "Past company ID for lead search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--past-company-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "school_id",
+          "required": false,
+          "help": "School ID for lead search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--school-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "profile_language",
+          "required": false,
+          "help": "Profile language code, e.g. en",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--profile-language"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "service_category",
+          "required": false,
+          "help": "Service category string",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--service-category"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "first_name",
+          "required": false,
+          "help": "First-name filter",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--first-name"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "last_name",
+          "required": false,
+          "help": "Last-name filter",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--last-name"
+          ],
+          "takes_value": true
         }
       ],
       "mutually_exclusive_groups": [
@@ -33556,7 +33505,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch list-build leads [-h] [--data-json DATA_JSON]\n                                  [--data-file DATA_FILE]\n                                  [--list-name LIST_NAME]\n                                  [--keywords KEYWORDS] [--title TITLE]\n                                  [--geo-id GEO_ID]\n                                  [--industry-id INDUSTRY_ID]\n                                  [--company-size COMPANY_SIZE]\n                                  [--current-company-id CURRENT_COMPANY_ID]\n                                  [--past-company-id PAST_COMPANY_ID]\n                                  [--school-id SCHOOL_ID]\n                                  [--profile-language PROFILE_LANGUAGE]\n                                  [--has-jobs] [--num-results NUM_RESULTS]\n                                  [--page-size PAGE_SIZE] [--wait]\n                                  [--poll-interval POLL_INTERVAL]\n                                  [--wait-timeout WAIT_TIMEOUT]\n                                  [--base-url BASE_URL] [--token TOKEN]\n                                  [--use-x-api-key] [--timeout TIMEOUT]\n                                  [--output {json,ndjson,human}] [--compact]\n                                  [--select SELECT |\n                                  --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch list-build leads [-h] [--data-json DATA_JSON]\n                                  [--data-file DATA_FILE]\n                                  [--list-name LIST_NAME]\n                                  [--num-results NUM_RESULTS]\n                                  [--page-size PAGE_SIZE] [--wait]\n                                  [--poll-interval POLL_INTERVAL]\n                                  [--wait-timeout WAIT_TIMEOUT]\n                                  [--base-url BASE_URL] [--token TOKEN]\n                                  [--use-x-api-key] [--timeout TIMEOUT]\n                                  [--output {json,ndjson,human}] [--compact]\n                                  [--select SELECT |\n                                  --json-pointer JSON_POINTER] [--verbose]\n                                  [--keywords KEYWORDS] [--title TITLE]\n                                  [--geo-id GEO_ID]\n                                  [--industry-id INDUSTRY_ID]\n                                  [--current-company-id CURRENT_COMPANY_ID]\n                                  [--past-company-id PAST_COMPANY_ID]\n                                  [--school-id SCHOOL_ID]\n                                  [--profile-language PROFILE_LANGUAGE]\n                                  [--service-category SERVICE_CATEGORY]\n                                  [--first-name FIRST_NAME]\n                                  [--last-name LAST_NAME]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -33990,6 +33939,48 @@
       "required_flags": [],
       "positionals": [],
       "options": [
+        {
+          "dest": "type",
+          "required": false,
+          "help": "Search input type",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "geo",
+            "industry",
+            "service",
+            "title_skill",
+            "title-skills"
+          ],
+          "flags": [
+            "--type"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "query",
+          "required": false,
+          "help": "Search text for input ID lookup",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--query"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "limit",
+          "required": false,
+          "help": "Max lookup results, 1-50",
+          "kind": "integer",
+          "action": "store",
+          "default_when_omitted": 20,
+          "default": 20,
+          "flags": [
+            "--limit"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -34143,7 +34134,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch list-build inputs [-h] [--base-url BASE_URL] [--token TOKEN]\n                                   [--use-x-api-key] [--timeout TIMEOUT]\n                                   [--output {json,ndjson,human}] [--compact]\n                                   [--select SELECT |\n                                   --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch list-build inputs [-h]\n                                   [--type {geo,industry,service,title_skill,title-skills}]\n                                   [--query QUERY] [--limit LIMIT]\n                                   [--base-url BASE_URL] [--token TOKEN]\n                                   [--use-x-api-key] [--timeout TIMEOUT]\n                                   [--output {json,ndjson,human}] [--compact]\n                                   [--select SELECT |\n                                   --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.83
+Version: 0.2.85
 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
@@ -150,7 +150,7 @@ Use `autotouch search companies` and `autotouch search people` for neural search
 
 Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. This is the only CLI path for building LinkedIn-sourced company and lead lists. Treat list builds as the sourcing step for the Smart Table research workspace: build company/account records first by default, add the records to a research table, then enrich, score, segment, find related leads, attach signals/notes, and continue downstream workflows from that table. Use lead builds directly when the request is explicitly person/contact focused. This path uses Autotouch-managed provider access, so users do not need to connect their own LinkedIn account. Use filters like geography IDs, company size, industry IDs, title/persona, and current company IDs; call `autotouch list-build inputs` for supported values. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
 
-For structured company builds, start with industry IDs plus geo/company-size filters. Company builds still need a broad `keywords` anchor (for example, `software`), but keywords are less reliable because they depend on company/profile text; use them to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
+For structured company builds, start with industry IDs plus geo/company-size filters. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
 
 For account-first prospecting, build companies/accounts 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.
 
@@ -160,7 +160,7 @@ 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.83` or newer for the cleaned single LinkedIn-sourced list-build path, `list-build inputs/pricing`, research-workspace list-build guidance, and 10-result neural search cap
+- `autotouch --version` should be `0.2.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
 - `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 inputs` and `autotouch list-build pricing` before creating durable list-build jobs
 - `autotouch list-build companies` and `autotouch list-build leads` for durable LinkedIn-sourced company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned LinkedIn connection requirement

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/autotouch_shared/list_build_contract.py

@@ -16,7 +16,7 @@ _LIST_BUILD_ENDPOINTS: Dict[str, Dict[str, Any]] = {
         "body": {
             "kind": "required companies|leads",
             "list_name": "optional display name",
-            "keywords": "required broad anchor for company builds; optional lead keywords; use with structured filters, not as the sole targeting definition",
+            "keywords": "optional broad anchor for company builds with structured filters; optional lead keywords; use with structured filters, not as the sole targeting definition",
             "title": "optional lead title/persona query",
             "num_results": "optional 1-10000 target result count",
             "page_size": "optional provider page size; leads capped to 50",
@@ -26,7 +26,12 @@ _LIST_BUILD_ENDPOINTS: Dict[str, Dict[str, Any]] = {
                 "company_sizes": "optional company size buckets: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10,000, 10,001+",
                 "has_jobs": "optional boolean for company lists",
                 "current_company_ids": "optional company IDs returned by company list builds; used for lead lists",
+                "past_company_ids": "optional past company IDs for lead lists",
+                "school_ids": "optional school IDs for lead lists",
                 "profile_language": "optional language code such as en",
+                "service_category": "optional service category string for lead lists",
+                "first_name": "optional first-name filter for lead lists",
+                "last_name": "optional last-name filter for lead lists",
             },
         },
         "notes": "LinkedIn-sourced durable list build through Autotouch-managed provider access. Does not require a user-owned LinkedIn connection. Use it to source company/account or lead records for the Smart Table research workspace.",
@@ -59,6 +64,17 @@ _LIST_BUILD_ENDPOINTS: Dict[str, Dict[str, Any]] = {
         "required_scope": LIST_BUILD_SCOPE,
         "notes": "Returns documented input IDs and filter values for company and lead list builds.",
     },
+    "list_build_input_search": {
+        "method": "GET",
+        "path": "/api/list-builds/inputs/search",
+        "required_scope": LIST_BUILD_SCOPE,
+        "query": {
+            "type": "required geo|industry|service|title_skill",
+            "q": "required lookup text; query is also accepted as an alias",
+            "limit": "optional 1-50 result count",
+        },
+        "notes": "Searches Autotouch's stored LinkedIn-sourced input catalog and refreshes missing lookup values internally. Responses do not expose the underlying data vendor.",
+    },
 }
 
 _LIST_BUILD_CAPABILITIES: Dict[str, Any] = {
@@ -73,16 +89,27 @@ _LIST_BUILD_CAPABILITIES: Dict[str, Any] = {
         "lead_flow": "Use lead builds directly when the request is explicitly person/contact focused; otherwise derive leads from company/account results.",
     },
     "known_input_ids": {
-        "geo_ids": {"United States": "103644278"},
+        "geo_ids": {
+            "Australia": "101452733",
+            "Canada": "101174742",
+            "France": "105015875",
+            "Germany": "101282230",
+            "India": "102713980",
+            "United Kingdom": "101165590",
+            "United States": "103644278",
+        },
+        "geo_ids_note": "Examples only; /api/list-builds accepts arbitrary valid LinkedIn GeoURN IDs.",
         "company_size_buckets": ["1-10", "11-50", "51-200", "201-500", "501-1000", "1001-5000", "5001-10,000", "10,001+"],
+        "industry_catalog": "GET /api/list-builds/inputs returns 434 active LinkedIn Industry Codes V2 IDs plus inactive/deprecated IDs.",
+        "input_search": "GET /api/list-builds/inputs/search resolves geo, industry, service, and title_skill values from Autotouch's stored input catalog.",
         "profile_language_examples": ["en"],
     },
     "targeting_guidance": [
         "Use this as the only company/lead list-building path.",
         "Call `autotouch list-build inputs` before choosing geography, industry, size, language, or company-ID filters.",
         "Start company/account targeting with industry_ids, geo_ids, and company_sizes.",
-        "Company builds still require a broad keywords anchor, but keywords are less reliable because they depend on company/profile text.",
-        "Use keywords to refine, disambiguate, or recover hard-to-classify targets; avoid keywords-only list builds except for exploratory searches.",
+        "Company builds do not require user-supplied keywords when structured filters are present.",
+        "Use keywords only to refine, disambiguate, or recover hard-to-classify targets; avoid keywords-only list builds except for exploratory searches.",
     ],
     "workflow": [
         "Use this as the only company/lead list-building path.",
@@ -98,7 +125,9 @@ _LIST_BUILD_CAPABILITIES: Dict[str, Any] = {
     },
     "recommended_cli": [
         "autotouch list-build inputs",
-        "autotouch list-build companies --keywords 'software' --geo-id 103644278 --industry-id <industry_id> --company-size 1-10 --num-results 1000 --wait",
+        "autotouch list-build inputs --type geo --query 'Washington'",
+        "autotouch list-build inputs --type industry --query 'software'",
+        "autotouch list-build companies --geo-id 103644278 --industry-id <industry_id> --company-size 1-10 --num-results 1000 --wait",
         "autotouch list-build leads --title 'Account Executive OR SDR' --current-company-id <company_id> --profile-language en --num-results 500 --wait",
         "autotouch list-build status --job-id <job_id>",
         "autotouch list-build results --job-id <job_id> --type companies",

{autotouch_cli-0.2.83 → autotouch_cli-0.2.85}/pyproject.toml

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