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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.83
+Version: 0.2.86
 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.86}/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.86}/autotouch_cli/cli.py

@@ -2398,6 +2398,7 @@ cmd_auth_schema = _bound("auth_schema")
 cmd_auth_whoami = _bound("auth_whoami")
 cmd_cells_get = _bound("cells_get")
 cmd_columns_create = _bound("columns_create")
+cmd_columns_update = _bound("columns_update")
 cmd_columns_move = _bound("columns_move")
 cmd_columns_projections = _bound("columns_projections")
 cmd_columns_run_next = _bound("columns_run_next")

{autotouch_cli-0.2.83 → autotouch_cli-0.2.86}/autotouch_cli/commands/columns.py

@@ -7,6 +7,16 @@ from typing import Any, Callable, Dict, Sequence
 from autotouch_cli.exceptions import AutotouchCreditError, AutotouchInputError
 
 
+_RESEARCH_MODE_ALIASES = {
+    "lite": "lite",
+    "light": "lite",
+    "quick": "lite",
+    "heavy": "heavy",
+    "deep": "heavy",
+    "thorough": "heavy",
+}
+
+
 @dataclass(frozen=True)
 class ColumnCommandRuntime:
     resolve_token: Callable[[str | None, bool], str | None]
@@ -52,6 +62,54 @@ def _apply_column_position_overrides(
     return merged
 
 
+def _normalize_research_mode_option(value: Any) -> str:
+    normalized = str(value or "").strip().lower()
+    if normalized in _RESEARCH_MODE_ALIASES:
+        return _RESEARCH_MODE_ALIASES[normalized]
+    raise AutotouchInputError("--research-mode must be one of: lite, heavy")
+
+
+def _apply_research_mode_overrides(
+    payload: Dict[str, Any],
+    args: argparse.Namespace,
+    *,
+    force_agent_on_explicit: bool,
+) -> Dict[str, Any]:
+    explicit_value = getattr(args, "research_mode", None)
+    config = payload.get("config")
+    if not isinstance(config, dict):
+        if explicit_value is None:
+            return payload
+        config = {}
+
+    current_mode = str(config.get("mode") or "").strip().lower()
+    has_research_mode = (
+        config.get("researchMode") is not None
+        or config.get("research_mode") is not None
+    )
+    should_default_agent_lite = current_mode == "agent" and not has_research_mode
+    should_clean_agent_config = current_mode == "agent" and has_research_mode
+    if explicit_value is None and not should_default_agent_lite and not should_clean_agent_config:
+        return payload
+
+    merged = dict(payload)
+    next_config = dict(config)
+    if explicit_value is not None:
+        if force_agent_on_explicit:
+            next_config["mode"] = "agent"
+        next_config["researchMode"] = _normalize_research_mode_option(explicit_value)
+    elif config.get("researchMode") is not None:
+        next_config["researchMode"] = _normalize_research_mode_option(config.get("researchMode"))
+    elif config.get("research_mode") is not None:
+        next_config["researchMode"] = _normalize_research_mode_option(config.get("research_mode"))
+    else:
+        next_config["researchMode"] = "lite"
+    next_config.pop("research_mode", None)
+    next_config.pop("lite", None)
+    merged["config"] = next_config
+    return merged
+
+
 def _normalize_http_request_test_payload(payload: Dict[str, Any]) -> Dict[str, Any]:
     candidate = payload
     config = payload.get("config")
@@ -111,6 +169,7 @@ def cmd_columns_create(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
         allow_position=True,
         allow_neighbors=True,
     )
+    payload = _apply_research_mode_overrides(payload, args, force_agent_on_explicit=True)
     runtime.validate_column_contract_payload_or_exit(payload)
     runtime.validate_add_to_crm_create_payload(payload)
     data = runtime.request_api(
@@ -156,6 +215,7 @@ def cmd_columns_update(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
         allow_position=True,
         allow_neighbors=False,
     )
+    payload = _apply_research_mode_overrides(payload, args, force_agent_on_explicit=False)
     runtime.validate_column_contract_payload_or_exit(payload)
     data = runtime.request_api(
         "PATCH",
@@ -401,6 +461,11 @@ def register_columns_subcommands(
     pcc.add_argument("--position", type=float, help="Explicit numeric position override")
     pcc.add_argument("--after-column-id", help="Place the new column after this existing column id")
     pcc.add_argument("--before-column-id", help="Place the new column before this existing column id")
+    pcc.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        help="For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite.",
+    )
     add_api_common_arguments(pcc)
     pcc.set_defaults(func=handlers["create"])
 
@@ -417,6 +482,11 @@ def register_columns_subcommands(
     pcu.add_argument("--data-json", help="ColumnUpdate payload JSON")
     pcu.add_argument("--data-file", help="ColumnUpdate payload file path")
     pcu.add_argument("--position", type=float, help="Explicit numeric position override")
+    pcu.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        help="Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent.",
+    )
     add_api_common_arguments(pcu)
     pcu.set_defaults(func=handlers["update"])
 
@@ -545,6 +615,12 @@ def register_columns_subcommands(
 
     pcre = col_sub.add_parser("recipe", help="Print copy-ready ColumnCreate payload templates")
     pcre.add_argument("--type", choices=["all", *column_recipe_types], default="all")
+    pcre.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        default="lite",
+        help="Research Agent depth for LLM recipes (default: lite; heavy costs more per row)",
+    )
     pcre.add_argument("--out-file", help="Write template JSON to file (single type writes payload only)")
     add_output_formatting_arguments(pcre)
     pcre.set_defaults(func=handlers["recipe"])

{autotouch_cli-0.2.83 → autotouch_cli-0.2.86}/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.86}/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.86`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -1079,6 +1079,7 @@ For llm_enrichment, there are two valid authoring paths:
                                 [--data-file DATA_FILE] [--position POSITION]
                                 [--after-column-id AFTER_COLUMN_ID]
                                 [--before-column-id BEFORE_COLUMN_ID]
+                                [--research-mode {lite,heavy}]
                                 [--base-url BASE_URL] [--token TOKEN]
                                 [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
@@ -1100,6 +1101,7 @@ The runnable prompt is always config.advancedPrompt before execution.
   - `--position` (kind=number): Explicit numeric position override
   - `--after-column-id` (kind=string): Place the new column after this existing column id
   - `--before-column-id` (kind=string): Place the new column before this existing column id
+  - `--research-mode` (kind=string; choices=lite,heavy): For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite.
   - `--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
@@ -1321,12 +1323,14 @@ Print copy-ready ColumnCreate payload templates
 - Example:
   - `autotouch columns recipe [-h]
                                 [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]
+                                [--research-mode {lite,heavy}]
                                 [--out-file OUT_FILE]
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER]`
 - Options:
   - `--type` (kind=string; choices=all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads; default=all)
+  - `--research-mode` (kind=string; choices=lite,heavy; default=lite): Research Agent depth for LLM recipes (default: lite; heavy costs more per row)
   - `--out-file` (kind=file; input=file): Write template JSON to file (single type writes payload only)
   - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
   - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
@@ -1538,6 +1542,7 @@ Update a column definition. Nested config keys merge into the existing config, s
   - `autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID
                                 [--data-json DATA_JSON]
                                 [--data-file DATA_FILE] [--position POSITION]
+                                [--research-mode {lite,heavy}]
                                 [--base-url BASE_URL] [--token TOKEN]
                                 [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
@@ -1549,6 +1554,7 @@ Update a column definition. Nested config keys merge into the existing config, s
   - `--data-json` (kind=json; input=json): ColumnUpdate payload JSON
   - `--data-file` (kind=file; input=file): ColumnUpdate payload file path
   - `--position` (kind=number): Explicit numeric position override
+  - `--research-mode` (kind=string; choices=lite,heavy): Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent.
   - `--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
@@ -2323,15 +2329,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 +2337,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 +2360,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 +2375,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 +2409,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 +2417,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 +2446,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`