autotouch-cli 0.2.72__tar.gz → 0.2.74__tar.gz

{autotouch_cli-0.2.72 → autotouch_cli-0.2.74}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.72
+Version: 0.2.74
 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
@@ -134,6 +134,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
 - Run provider-hidden search: `autotouch search companies`, `autotouch search people`
 - Inspect LinkedIn/Sales Nav filters: `autotouch linkedin filters --api sales_navigator --category people`
+- Build a paced LinkedIn people list on Smart Table workers: `autotouch linkedin list-build create --company-query 'SaaS startups' --headcount 1-10 --people-query 'Account Executive OR SDR' --num-results 250 --wait`
 - Run one LinkedIn search page/debug replay: `autotouch linkedin search`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
@@ -148,6 +149,8 @@ For automation or agent-driven setup, use:
 - `autotouch cli-reference` for the shipped parser-generated reference
 - `autotouch capabilities --output json` for provider/workflow contracts
 - `autotouch linkedin filters --output json` for LinkedIn/Sales Navigator filter tokens such as headcount, industry, location, role, function, and seniority
+- `autotouch linkedin list-build create` for durable LinkedIn/Sales Navigator list building with Smart Table-owned paced provider requests, visible progress, and cooldown status
+- `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists
 - `autotouch rows list` / `autotouch rows get` / `autotouch cells get` for read-back and audit
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
 - `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands

{autotouch_cli-0.2.72 → autotouch_cli-0.2.74}/README.md

@@ -109,6 +109,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
 - Run provider-hidden search: `autotouch search companies`, `autotouch search people`
 - Inspect LinkedIn/Sales Nav filters: `autotouch linkedin filters --api sales_navigator --category people`
+- Build a paced LinkedIn people list on Smart Table workers: `autotouch linkedin list-build create --company-query 'SaaS startups' --headcount 1-10 --people-query 'Account Executive OR SDR' --num-results 250 --wait`
 - Run one LinkedIn search page/debug replay: `autotouch linkedin search`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
@@ -123,6 +124,8 @@ For automation or agent-driven setup, use:
 - `autotouch cli-reference` for the shipped parser-generated reference
 - `autotouch capabilities --output json` for provider/workflow contracts
 - `autotouch linkedin filters --output json` for LinkedIn/Sales Navigator filter tokens such as headcount, industry, location, role, function, and seniority
+- `autotouch linkedin list-build create` for durable LinkedIn/Sales Navigator list building with Smart Table-owned paced provider requests, visible progress, and cooldown status
+- `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists
 - `autotouch rows list` / `autotouch rows get` / `autotouch cells get` for read-back and audit
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
 - `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands

{autotouch_cli-0.2.72 → autotouch_cli-0.2.74}/autotouch_cli/cli.py

@@ -95,6 +95,9 @@ from autotouch_cli.commands.linkedin import (
     cmd_linkedin_comments as cmd_linkedin_comments_impl,
     cmd_linkedin_filters as cmd_linkedin_filters_impl,
     cmd_linkedin_limits as cmd_linkedin_limits_impl,
+    cmd_linkedin_list_build_create as cmd_linkedin_list_build_create_impl,
+    cmd_linkedin_list_build_results as cmd_linkedin_list_build_results_impl,
+    cmd_linkedin_list_build_status as cmd_linkedin_list_build_status_impl,
     cmd_linkedin_post as cmd_linkedin_post_impl,
     cmd_linkedin_posts as cmd_linkedin_posts_impl,
     cmd_linkedin_reactions as cmd_linkedin_reactions_impl,
@@ -1546,6 +1549,9 @@ _register("linkedin_limits", cmd_linkedin_limits_impl, _linkedin_command_runtime
 _register("linkedin_search", cmd_linkedin_search_impl, _linkedin_command_runtime)
 _register("linkedin_search_params", cmd_linkedin_search_params_impl, _linkedin_command_runtime)
 _register("linkedin_filters", cmd_linkedin_filters_impl, _linkedin_command_runtime)
+_register("linkedin_list_build_create", cmd_linkedin_list_build_create_impl, _linkedin_command_runtime)
+_register("linkedin_list_build_status", cmd_linkedin_list_build_status_impl, _linkedin_command_runtime)
+_register("linkedin_list_build_results", cmd_linkedin_list_build_results_impl, _linkedin_command_runtime)
 _register("linkedin_posts", cmd_linkedin_posts_impl, _linkedin_command_runtime)
 _register("linkedin_post", cmd_linkedin_post_impl, _linkedin_command_runtime)
 _register("linkedin_comments", cmd_linkedin_comments_impl, _linkedin_command_runtime)

{autotouch_cli-0.2.72 → autotouch_cli-0.2.74}/autotouch_cli/commands/linkedin.py

@@ -2,8 +2,9 @@ from __future__ import annotations
 
 import argparse
 import json
+import time
 from dataclasses import dataclass
-from typing import Any, Callable, Dict, Optional, Sequence
+from typing import Any, Callable, Dict, List, Optional, Sequence
 
 from autotouch_shared.linkedin_filters import linkedin_filter_catalog
 from autotouch_cli.exceptions import AutotouchInputError
@@ -118,6 +119,208 @@ def cmd_linkedin_search_params(args: argparse.Namespace, *, runtime: LinkedInCom
     runtime.print_json(data, args.compact)
 
 
+def _load_optional_json_object(raw: Optional[str], *, context: str) -> Optional[Dict[str, Any]]:
+    if not raw:
+        return None
+    try:
+        parsed = json.loads(raw)
+    except Exception as exc:
+        raise AutotouchInputError(f"invalid JSON for {context}: {exc}") from exc
+    if not isinstance(parsed, dict):
+        raise AutotouchInputError(f"{context} must be a JSON object")
+    return parsed
+
+
+def _split_repeated_values(values: Optional[List[str]]) -> List[str]:
+    output: List[str] = []
+    for raw in values or []:
+        for part in str(raw).replace("\n", ",").split(","):
+            value = part.strip()
+            if value:
+                output.append(value)
+    return output
+
+
+def _coerce_filter_arg_value(raw: str) -> Any:
+    value = str(raw or "").strip()
+    if not value:
+        return ""
+    if value[0] in "[{\"" or value.lower() in {"true", "false", "null"}:
+        try:
+            return json.loads(value)
+        except Exception:
+            pass
+    if "," in value:
+        return [part.strip() for part in value.split(",") if part.strip()]
+    return value
+
+
+def _parse_filter_pairs(values: Optional[List[str]], *, context: str) -> Dict[str, Any]:
+    filters: Dict[str, Any] = {}
+    for raw in values or []:
+        item = str(raw or "").strip()
+        if not item:
+            continue
+        if "=" not in item:
+            raise AutotouchInputError(f"{context} filters must use FIELD=VALUE")
+        field, value = item.split("=", 1)
+        field = field.strip()
+        if not field:
+            raise AutotouchInputError(f"{context} filter field is empty")
+        filters[field] = _coerce_filter_arg_value(value)
+    return filters
+
+
+def _add_repeated_filter(filters: Dict[str, Any], field: str, values: Optional[List[str]]) -> None:
+    parsed = _split_repeated_values(values)
+    if parsed:
+        filters[field] = parsed
+
+
+def _normalize_linkedin_list_build_payload(args: argparse.Namespace, *, runtime: LinkedInCommandRuntime) -> Dict[str, Any]:
+    explicit = runtime.load_json_input(
+        inline_json=getattr(args, "data_json", None),
+        file_path=getattr(args, "data_file", None),
+        context="data",
+        default=None,
+    )
+    if explicit is not None:
+        if not isinstance(explicit, dict):
+            raise AutotouchInputError("linkedin list-build payload must be a JSON object")
+        return explicit
+
+    company_query = str(getattr(args, "company_query", "") or "").strip()
+    if not company_query:
+        raise AutotouchInputError("linkedin list-build create requires --company-query or --data-file")
+
+    payload: Dict[str, Any] = {
+        "mode": str(getattr(args, "mode", "company-first-people") or "company-first-people").strip(),
+        "company_query": company_query,
+        "headcount": str(getattr(args, "headcount", "1-10") or "1-10").strip(),
+        "num_results": max(1, min(int(getattr(args, "num_results", 100) or 100), 1000)),
+    }
+    people_query = str(getattr(args, "people_query", "") or "").strip()
+    if people_query:
+        payload["people_query"] = people_query
+    linkedin_api = str(getattr(args, "linkedin_api", "auto") or "auto").strip()
+    if linkedin_api and linkedin_api != "auto":
+        payload["linkedin_api"] = linkedin_api
+    excluded_titles = _split_repeated_values(getattr(args, "excluded_title", None))
+    if excluded_titles:
+        payload["excluded_titles"] = excluded_titles
+    company_filters = _parse_filter_pairs(getattr(args, "company_filter", None), context="company")
+    people_filters = _parse_filter_pairs(getattr(args, "people_filter", None), context="people")
+    _add_repeated_filter(company_filters, "location", getattr(args, "company_location_id", None) or getattr(args, "location_id", None))
+    _add_repeated_filter(people_filters, "location", getattr(args, "people_location_id", None) or getattr(args, "location_id", None))
+    _add_repeated_filter(company_filters, "industry", getattr(args, "company_industry_id", None))
+    _add_repeated_filter(people_filters, "industry", getattr(args, "people_industry_id", None))
+    _add_repeated_filter(people_filters, "role", getattr(args, "role_id", None))
+    _add_repeated_filter(people_filters, "function", getattr(args, "function_id", None))
+    _add_repeated_filter(people_filters, "seniority", getattr(args, "seniority", None))
+    _add_repeated_filter(people_filters, "profile_language", getattr(args, "profile_language", None))
+    _add_repeated_filter(company_filters, "technologies", getattr(args, "technology_id", None))
+    if getattr(args, "has_job_offers", False):
+        company_filters["has_job_offers"] = True
+    if company_filters:
+        payload["company_filters"] = company_filters
+    if people_filters:
+        payload["people_filters"] = people_filters
+    for arg_name, payload_key, context in (
+        ("extra_params_json", "extra_params", "extra-params"),
+        ("company_extra_params_json", "company_extra_params", "company-extra-params"),
+        ("people_extra_params_json", "people_extra_params", "people-extra-params"),
+    ):
+        parsed = _load_optional_json_object(getattr(args, arg_name, None), context=context)
+        if parsed is not None:
+            payload[payload_key] = parsed
+    return payload
+
+
+def _wait_for_linkedin_list_build(
+    job_id: str,
+    args: argparse.Namespace,
+    *,
+    runtime: LinkedInCommandRuntime,
+    token: Optional[str],
+) -> Dict[str, Any]:
+    started = time.time()
+    interval = max(1, int(getattr(args, "poll_interval", 5) or 5))
+    timeout = max(0, int(getattr(args, "wait_timeout", 0) or 0))
+    terminal = {"completed", "error", "cancelled"}
+    latest: Dict[str, Any] = {}
+
+    while True:
+        latest = runtime.request_api(
+            "GET",
+            f"/api/integrations/linkedin/list-builds/{job_id}",
+            base_url=args.base_url,
+            token=token,
+            use_x_api_key=args.use_x_api_key,
+            timeout=args.timeout,
+            verbose=args.verbose,
+        )
+        status = str(latest.get("status") or "").strip().lower() if isinstance(latest, dict) else ""
+        if status in terminal:
+            return latest
+        if timeout and (time.time() - started) >= timeout:
+            return latest
+        time.sleep(interval)
+
+
+def cmd_linkedin_list_build_create(args: argparse.Namespace, *, runtime: LinkedInCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    payload = _normalize_linkedin_list_build_payload(args, runtime=runtime)
+    data = runtime.request_api(
+        "POST",
+        "/api/integrations/linkedin/list-builds",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    if getattr(args, "wait", False) and isinstance(data, dict) and data.get("job_id"):
+        data = _wait_for_linkedin_list_build(str(data["job_id"]), args, runtime=runtime, token=token)
+    runtime.print_json(data, args.compact)
+
+
+def cmd_linkedin_list_build_status(args: argparse.Namespace, *, runtime: LinkedInCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    job_id = str(args.job_id).strip()
+    data = runtime.request_api(
+        "GET",
+        f"/api/integrations/linkedin/list-builds/{job_id}",
+        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)
+
+
+def cmd_linkedin_list_build_results(args: argparse.Namespace, *, runtime: LinkedInCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    job_id = str(args.job_id).strip()
+    params: Dict[str, Any] = {
+        "type": str(getattr(args, "type", "people") or "people"),
+        "page": max(1, int(getattr(args, "page", 1) or 1)),
+        "page_size": max(1, min(int(getattr(args, "page_size", 50) or 50), 500)),
+    }
+    data = runtime.request_api(
+        "GET",
+        f"/api/integrations/linkedin/list-builds/{job_id}/results",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        params=params,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
 def cmd_linkedin_filters(args: argparse.Namespace, *, runtime: LinkedInCommandRuntime) -> None:
     output = linkedin_filter_catalog(
         api_mode=getattr(args, "api", None),
@@ -293,6 +496,54 @@ def register_linkedin_subcommands(
     add_api_common_arguments(filters_parser)
     filters_parser.set_defaults(func=handlers["filters"])
 
+    list_build_parser = linkedin_sub.add_parser("list-build", help="Create and inspect paced LinkedIn list-build jobs")
+    list_build_sub = list_build_parser.add_subparsers(dest="linkedin_list_build_cmd", required=True)
+
+    list_build_create = list_build_sub.add_parser("create", help="Create a paced background LinkedIn list-build job")
+    list_build_create.add_argument("--data-json", help="Explicit list-build payload JSON (overrides individual flags)")
+    list_build_create.add_argument("--data-file", help="Path to list-build payload JSON file")
+    list_build_create.add_argument("--mode", choices=["company-first-people"], default="company-first-people", help="List build mode")
+    list_build_create.add_argument("--linkedin-api", choices=["auto", "classic", "sales_navigator"], default="auto", help="API mode (default: auto; uses connected account mode)")
+    list_build_create.add_argument("--company-query", help="Company-search query used to build the seed account set")
+    list_build_create.add_argument("--people-query", help="People-search query/title terms")
+    list_build_create.add_argument("--headcount", default="1-10", help="Company headcount range, e.g. 1-10 or 11-50")
+    list_build_create.add_argument("--num-results", type=int, default=100, help="Target number of people results, 1-1000")
+    list_build_create.add_argument("--excluded-title", action="append", help="Title to exclude after results return; repeat or comma-separate")
+    list_build_create.add_argument("--location-id", action="append", help="LinkedIn location/region ID applied to company and people search")
+    list_build_create.add_argument("--company-location-id", action="append", help="LinkedIn location/region ID applied only to company search")
+    list_build_create.add_argument("--people-location-id", action="append", help="LinkedIn location/region ID applied only to people search")
+    list_build_create.add_argument("--company-industry-id", action="append", help="LinkedIn industry ID applied to company search")
+    list_build_create.add_argument("--people-industry-id", action="append", help="LinkedIn industry ID applied to people search")
+    list_build_create.add_argument("--role-id", action="append", help="Resolved LinkedIn job-title ID for people search; repeat or comma-separate")
+    list_build_create.add_argument("--function-id", action="append", help="Resolved LinkedIn department/function ID for Sales Nav people search")
+    list_build_create.add_argument("--seniority", action="append", help="Sales Nav seniority filter value; repeat or comma-separate")
+    list_build_create.add_argument("--profile-language", action="append", help="Profile language code, e.g. en")
+    list_build_create.add_argument("--technology-id", action="append", help="Sales Nav technology ID applied to company search")
+    list_build_create.add_argument("--has-job-offers", action="store_true", help="Filter companies currently hiring on LinkedIn")
+    list_build_create.add_argument("--company-filter", action="append", help="Catalog company filter as FIELD=VALUE; repeat for multiple filters")
+    list_build_create.add_argument("--people-filter", action="append", help="Catalog people filter as FIELD=VALUE; repeat for multiple filters")
+    list_build_create.add_argument("--extra-params-json", help="JSON object applied to both company and people searches")
+    list_build_create.add_argument("--company-extra-params-json", help="JSON object applied only to company search")
+    list_build_create.add_argument("--people-extra-params-json", help="JSON object applied only to people search")
+    list_build_create.add_argument("--wait", action="store_true", help="Poll until the job reaches completed, error, or cancelled")
+    list_build_create.add_argument("--poll-interval", type=int, default=5, help="Polling interval seconds for --wait")
+    list_build_create.add_argument("--wait-timeout", type=int, default=0, help="Max seconds to wait (0 = no timeout)")
+    add_api_common_arguments(list_build_create)
+    list_build_create.set_defaults(func=handlers["list_build_create"])
+
+    list_build_status = list_build_sub.add_parser("status", help="Get LinkedIn list-build job status")
+    list_build_status.add_argument("--job-id", required=True, help="LinkedIn list-build job id")
+    add_api_common_arguments(list_build_status)
+    list_build_status.set_defaults(func=handlers["list_build_status"])
+
+    list_build_results = list_build_sub.add_parser("results", help="Get LinkedIn list-build results")
+    list_build_results.add_argument("--job-id", required=True, help="LinkedIn list-build job id")
+    list_build_results.add_argument("--type", choices=["people", "companies", "all"], default="people", help="Result type")
+    list_build_results.add_argument("--page", type=int, default=1, help="Results page")
+    list_build_results.add_argument("--page-size", type=int, default=50, help="Results per page, 1-500")
+    add_api_common_arguments(list_build_results)
+    list_build_results.set_defaults(func=handlers["list_build_results"])
+
     posts_parser = linkedin_sub.add_parser("posts", help="List LinkedIn posts for a user")
     posts_parser.add_argument("--identifier", required=True, help="LinkedIn profile URL, public ID, or URN")
     posts_parser.add_argument("--cursor", help="Pagination cursor from previous response")

{autotouch_cli-0.2.72 → autotouch_cli-0.2.74}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.72`.
+Generated from the installed parser for `autotouch-cli` `0.2.74`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -2243,10 +2243,10 @@ LinkedIn list-building operations
 - Auth: `varies_by_subcommand`
 - Stability: `stable`
 - Destructive: `no`
-- Subcommands: `recipe, status, limits, search, search-params, filters, posts, post, comments, reactions`
+- Subcommands: `recipe, status, limits, search, search-params, filters, list-build, posts, post, comments, reactions`
 - Example:
   - `autotouch linkedin [-h]
-                          {recipe,status,limits,search,search-params,filters,posts,post,comments,reactions} ...`
+                          {recipe,status,limits,search,search-params,filters,list-build,posts,post,comments,reactions} ...`
 
 #### `autotouch linkedin comments`
 
@@ -2336,6 +2336,166 @@ View LinkedIn send limits and usage
   - `--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
 
+#### `autotouch linkedin list-build`
+
+Create and inspect paced LinkedIn list-build jobs
+
+- Auth: `varies_by_subcommand`
+- Stability: `stable`
+- Destructive: `no`
+- Subcommands: `create, status, results`
+- Example:
+  - `autotouch linkedin list-build [-h] {create,status,results} ...`
+
+#### `autotouch linkedin list-build create`
+
+Create a paced background LinkedIn list-build job
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch linkedin list-build create [-h] [--data-json DATA_JSON]
+                                            [--data-file DATA_FILE]
+                                            [--mode {company-first-people}]
+                                            [--linkedin-api {auto,classic,sales_navigator}]
+                                            [--company-query COMPANY_QUERY]
+                                            [--people-query PEOPLE_QUERY]
+                                            [--headcount HEADCOUNT]
+                                            [--num-results NUM_RESULTS]
+                                            [--excluded-title EXCLUDED_TITLE]
+                                            [--location-id LOCATION_ID]
+                                            [--company-location-id COMPANY_LOCATION_ID]
+                                            [--people-location-id PEOPLE_LOCATION_ID]
+                                            [--company-industry-id COMPANY_INDUSTRY_ID]
+                                            [--people-industry-id PEOPLE_INDUSTRY_ID]
+                                            [--role-id ROLE_ID]
+                                            [--function-id FUNCTION_ID]
+                                            [--seniority SENIORITY]
+                                            [--profile-language PROFILE_LANGUAGE]
+                                            [--technology-id TECHNOLOGY_ID]
+                                            [--has-job-offers]
+                                            [--company-filter COMPANY_FILTER]
+                                            [--people-filter PEOPLE_FILTER]
+                                            [--extra-params-json EXTRA_PARAMS_JSON]
+                                            [--company-extra-params-json COMPANY_EXTRA_PARAMS_JSON]
+                                            [--people-extra-params-json PEOPLE_EXTRA_PARAMS_JSON]
+                                            [--wait]
+                                            [--poll-interval POLL_INTERVAL]
+                                            [--wait-timeout WAIT_TIMEOUT]
+                                            [--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:
+  - `--data-json` (kind=json; input=json): Explicit list-build payload JSON (overrides individual flags)
+  - `--data-file` (kind=file; input=file): Path to list-build payload JSON file
+  - `--mode` (kind=string; choices=company-first-people; default=company-first-people): List build mode
+  - `--linkedin-api` (kind=string; choices=auto,classic,sales_navigator; default=auto): API mode (default: auto; uses connected account mode)
+  - `--company-query` (kind=string): Company-search query used to build the seed account set
+  - `--people-query` (kind=string): People-search query/title terms
+  - `--headcount` (kind=string; default=1-10): Company headcount range, e.g. 1-10 or 11-50
+  - `--num-results` (kind=integer; default=100): Target number of people results, 1-1000
+  - `--excluded-title` (kind=string; repeatable): Title to exclude after results return; repeat or comma-separate
+  - `--location-id` (kind=string; repeatable): LinkedIn location/region ID applied to company and people search
+  - `--company-location-id` (kind=string; repeatable): LinkedIn location/region ID applied only to company search
+  - `--people-location-id` (kind=string; repeatable): LinkedIn location/region ID applied only to people search
+  - `--company-industry-id` (kind=string; repeatable): LinkedIn industry ID applied to company search
+  - `--people-industry-id` (kind=string; repeatable): LinkedIn industry ID applied to people search
+  - `--role-id` (kind=string; repeatable): Resolved LinkedIn job-title ID for people search; repeat or comma-separate
+  - `--function-id` (kind=string; repeatable): Resolved LinkedIn department/function ID for Sales Nav people search
+  - `--seniority` (kind=string; repeatable): Sales Nav seniority filter value; repeat or comma-separate
+  - `--profile-language` (kind=string; repeatable): Profile language code, e.g. en
+  - `--technology-id` (kind=string; repeatable): Sales Nav technology ID applied to company search
+  - `--has-job-offers` (kind=boolean; when omitted=False; when present=True): Filter companies currently hiring on LinkedIn
+  - `--company-filter` (kind=string; repeatable): Catalog company filter as FIELD=VALUE; repeat for multiple filters
+  - `--people-filter` (kind=string; repeatable): Catalog people filter as FIELD=VALUE; repeat for multiple filters
+  - `--extra-params-json` (kind=json; input=json): JSON object applied to both company and people searches
+  - `--company-extra-params-json` (kind=json; input=json): JSON object applied only to company search
+  - `--people-extra-params-json` (kind=json; input=json): JSON object applied only to people search
+  - `--wait` (kind=boolean; when omitted=False; when present=True): Poll until the job reaches completed, error, or cancelled
+  - `--poll-interval` (kind=integer; default=5): Polling interval seconds for --wait
+  - `--wait-timeout` (kind=integer; default=0): Max seconds to wait (0 = no timeout)
+  - `--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
+  - `--timeout` (kind=integer; default=30): HTTP timeout in seconds
+  - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
+  - `--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
+
+#### `autotouch linkedin list-build results`
+
+Get LinkedIn list-build results
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--job-id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch linkedin list-build results [-h] --job-id JOB_ID
+                                             [--type {people,companies,all}]
+                                             [--page PAGE]
+                                             [--page-size PAGE_SIZE]
+                                             [--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:
+  - `--job-id` (required; kind=string): LinkedIn list-build job id
+  - `--type` (kind=string; choices=people,companies,all; default=people): Result type
+  - `--page` (kind=integer; default=1): Results page
+  - `--page-size` (kind=integer; default=50): Results per page, 1-500
+  - `--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
+  - `--timeout` (kind=integer; default=30): HTTP timeout in seconds
+  - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
+  - `--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
+
+#### `autotouch linkedin list-build status`
+
+Get LinkedIn list-build job status
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--job-id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch linkedin list-build status [-h] --job-id JOB_ID
+                                            [--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:
+  - `--job-id` (required; kind=string): LinkedIn list-build job id
+  - `--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
+  - `--timeout` (kind=integer; default=30): HTTP timeout in seconds
+  - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
+  - `--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
+
 #### `autotouch linkedin post`
 
 Get full details for a single LinkedIn post
@@ -2436,7 +2596,7 @@ Print LinkedIn payload recipes for search and list-building
 - Output modes: `json, ndjson, human`
 - Example:
   - `autotouch linkedin recipe [-h]
-                                 [--type {all,search,search_url,search_params,posts,comments,reactions}]
+                                 [--type {all,list_build_company_first_people,search,search_url,search_params,posts,comments,reactions}]
                                  [--out-file OUT_FILE] [--base-url BASE_URL]
                                  [--token TOKEN] [--use-x-api-key]
                                  [--timeout TIMEOUT]
@@ -2444,7 +2604,7 @@ Print LinkedIn payload recipes for search and list-building
                                  [--select SELECT |
                                  --json-pointer JSON_POINTER] [--verbose]`
 - Options:
-  - `--type` (kind=string; choices=all,search,search_url,search_params,posts,comments,reactions; default=all)
+  - `--type` (kind=string; choices=all,list_build_company_first_people,search,search_url,search_params,posts,comments,reactions; default=all)
   - `--out-file` (kind=file; input=file): Optional path to save the selected payload JSON
   - `--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