autotouch-cli 0.2.81__tar.gz → 0.2.82__tar.gz

{autotouch_cli-0.2.81 → autotouch_cli-0.2.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.81
+Version: 0.2.82
 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
@@ -133,9 +133,9 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect one cell: `autotouch cells get`
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
 - Run neural search for niche/specific company or people discovery: `autotouch search companies`, `autotouch search people`
-- Inspect LinkedIn filters: `autotouch linkedin filters --category people`
+- Inspect list-build inputs: `autotouch list-build inputs`
 - Build durable company and lead lists on Smart Table workers: `autotouch list-build companies`, `autotouch list-build leads`
-- Run one LinkedIn search page/debug replay: `autotouch linkedin search`
+- Check connected LinkedIn account status/limits: `autotouch linkedin status`, `autotouch linkedin limits`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
 - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
@@ -148,7 +148,7 @@ Autotouch has two different company/people discovery paths.
 
 Use `autotouch search companies` and `autotouch search people` for neural search when the target is niche, semantic, or hard to express with structured filters. Examples: "AI workflow platforms for healthcare", "AI workflow startups selling to law firms", or "RevOps operators at PLG SaaS companies". Neural company/people search returns at most 10 results per API call and costs 1 credit per API call.
 
-Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. 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 is the default path for larger LinkedIn-sourced company and lead lists using filters like geography IDs, company size, industry IDs, title/persona, and current company IDs. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
+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.
 
@@ -160,10 +160,11 @@ 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.81` or newer for the research-workspace list-build guidance, 10-result neural search cap, and provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
+- `autotouch --version` should be `0.2.82` or newer for the single LinkedIn-sourced list-build path, `list-build inputs/pricing`, research-workspace list-build guidance, and 10-result neural search cap
 - `autotouch capabilities --output json --select list_builds` for documented list-build inputs such as geography IDs, company size buckets, profile language, and company IDs
-- `autotouch list-build companies` and `autotouch list-build leads` for durable provider-hidden company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned network connection requirement
-- `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists
+- `autotouch 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 linkedin status` and `autotouch linkedin limits` for connected-account diagnostics; do not use connected LinkedIn search/search-params for list building
 - `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.81 → autotouch_cli-0.2.82}/README.md

@@ -108,9 +108,9 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect one cell: `autotouch cells get`
 - Create a workflow column: `autotouch columns recipe`, `autotouch columns create`
 - Run neural search for niche/specific company or people discovery: `autotouch search companies`, `autotouch search people`
-- Inspect LinkedIn filters: `autotouch linkedin filters --category people`
+- Inspect list-build inputs: `autotouch list-build inputs`
 - Build durable company and lead lists on Smart Table workers: `autotouch list-build companies`, `autotouch list-build leads`
-- Run one LinkedIn search page/debug replay: `autotouch linkedin search`
+- Check connected LinkedIn account status/limits: `autotouch linkedin status`, `autotouch linkedin limits`
 - Run controlled slices: `autotouch columns run-next`
 - Poll authoritative state: `autotouch jobs get`
 - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
@@ -123,7 +123,7 @@ Autotouch has two different company/people discovery paths.
 
 Use `autotouch search companies` and `autotouch search people` for neural search when the target is niche, semantic, or hard to express with structured filters. Examples: "AI workflow platforms for healthcare", "AI workflow startups selling to law firms", or "RevOps operators at PLG SaaS companies". Neural company/people search returns at most 10 results per API call and costs 1 credit per API call.
 
-Use `autotouch list-build companies` and `autotouch list-build leads` for structured, repeatable list construction. 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 is the default path for larger LinkedIn-sourced company and lead lists using filters like geography IDs, company size, industry IDs, title/persona, and current company IDs. Durable list builds run as background jobs with status/results endpoints and cost 1 credit per successful non-empty result page.
+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.
 
@@ -135,10 +135,11 @@ 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.81` or newer for the research-workspace list-build guidance, 10-result neural search cap, and provider-hidden `autotouch list-build ...`; older CLIs may still show the removed `autotouch linkedin list-build` surface
+- `autotouch --version` should be `0.2.82` or newer for the single LinkedIn-sourced list-build path, `list-build inputs/pricing`, research-workspace list-build guidance, and 10-result neural search cap
 - `autotouch capabilities --output json --select list_builds` for documented list-build inputs such as geography IDs, company size buckets, profile language, and company IDs
-- `autotouch list-build companies` and `autotouch list-build leads` for durable provider-hidden company and lead list builds with Smart Table-owned background workers, visible progress, and no user-owned network connection requirement
-- `autotouch linkedin search` for one-page LinkedIn/Sales Navigator replay/debug searches; it is not the recommended path for large lists
+- `autotouch 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 linkedin status` and `autotouch linkedin limits` for connected-account diagnostics; do not use connected LinkedIn search/search-params for list building
 - `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.81 → autotouch_cli-0.2.82}/autotouch_cli/cli.py

@@ -106,7 +106,9 @@ from autotouch_cli.commands.linkedin import (
 from autotouch_cli.commands.list_build import (
     ListBuildCommandRuntime as ListBuildCommandHandlerRuntime,
     cmd_list_build_companies as cmd_list_build_companies_impl,
+    cmd_list_build_inputs as cmd_list_build_inputs_impl,
     cmd_list_build_leads as cmd_list_build_leads_impl,
+    cmd_list_build_pricing as cmd_list_build_pricing_impl,
     cmd_list_build_results as cmd_list_build_results_impl,
     cmd_list_build_status as cmd_list_build_status_impl,
 )
@@ -1580,6 +1582,8 @@ _register("list_build_companies", cmd_list_build_companies_impl, _list_build_com
 _register("list_build_leads", cmd_list_build_leads_impl, _list_build_command_runtime)
 _register("list_build_status", cmd_list_build_status_impl, _list_build_command_runtime)
 _register("list_build_results", cmd_list_build_results_impl, _list_build_command_runtime)
+_register("list_build_inputs", cmd_list_build_inputs_impl, _list_build_command_runtime)
+_register("list_build_pricing", cmd_list_build_pricing_impl, _list_build_command_runtime)
 
 # -- Template emitter commands (use _template_runtime) --
 _register("schema", emit_schema, _template_runtime)
@@ -2016,8 +2020,8 @@ def cmd_capabilities(args: argparse.Namespace) -> None:
                     print(f"  - {item}")
             filter_count = len((linkedin.get("filter_catalog") or {}).get("filters") or [])
             if filter_count:
-                print(f"Structured filters: {filter_count} exposed via `autotouch linkedin filters`")
-            print("Tip: run `autotouch linkedin recipe` for example payloads.")
+                print(f"Structured filters: {filter_count} exposed via `autotouch list-build inputs`")
+            print("Tip: run `autotouch list-build inputs` for list-building IDs and values.")
         if isinstance(search, dict):
             print("")
             print("Provider-hidden search")

{autotouch_cli-0.2.81 → autotouch_cli-0.2.82}/autotouch_cli/cli_contracts.py

@@ -25,7 +25,6 @@ _AUTH_MODE_EXACT: Dict[str, str] = {
     "webhooks.ingest": "webhook_token",
     "cli-manifest": "none",
     "cli-reference": "none",
-    "linkedin.filters": "none",
     "schema": "none",
     "status": "none",
     "watch": "none",

{autotouch_cli-0.2.81 → autotouch_cli-0.2.82}/autotouch_cli/commands/linkedin.py

@@ -305,15 +305,9 @@ def register_linkedin_subcommands(
     handlers: Dict[str, Callable[[argparse.Namespace], None]],
     recipe_types: Sequence[str],
 ) -> None:
-    parser = subparsers.add_parser("linkedin", help="Connected LinkedIn search and engagement operations")
+    parser = subparsers.add_parser("linkedin", help="Connected LinkedIn account operations")
     linkedin_sub = parser.add_subparsers(dest="linkedin_cmd", required=True)
 
-    recipe_parser = linkedin_sub.add_parser("recipe", help="Print LinkedIn payload recipes for search and list-building")
-    recipe_parser.add_argument("--type", choices=["all", *recipe_types], default="all")
-    recipe_parser.add_argument("--out-file", help="Optional path to save the selected payload JSON")
-    add_api_common_arguments(recipe_parser)
-    recipe_parser.set_defaults(func=handlers["recipe"])
-
     status_parser = linkedin_sub.add_parser("status", help="Check LinkedIn connection status")
     add_api_common_arguments(status_parser)
     status_parser.set_defaults(func=handlers["status"])
@@ -321,58 +315,3 @@ def register_linkedin_subcommands(
     limits_parser = linkedin_sub.add_parser("limits", help="View LinkedIn send limits and usage")
     add_api_common_arguments(limits_parser)
     limits_parser.set_defaults(func=handlers["limits"])
-
-    search_parser = linkedin_sub.add_parser("search", help="Search LinkedIn for people, companies, jobs, or posts")
-    search_parser.add_argument("--data-json", help="Explicit search payload JSON (overrides individual flags)")
-    search_parser.add_argument("--data-file", help="Path to search payload JSON file")
-    search_parser.add_argument("--url", help="Full LinkedIn/Sales Navigator search URL (overrides keyword filters)")
-    search_parser.add_argument("--category", choices=["people", "companies", "jobs", "posts"], default="people", help="Search category (default: people)")
-    search_parser.add_argument("--keywords", help="Free-text keyword search")
-    search_parser.add_argument("--linkedin-api", choices=["auto", "classic", "sales_navigator"], default="auto", help=argparse.SUPPRESS)
-    search_parser.add_argument("--cursor", help="Pagination cursor from previous response")
-    search_parser.add_argument("--limit", type=int, default=25, help="Results per page, 1-100 (default: 25)")
-    search_parser.add_argument("--extra-params-json", help="JSON object with additional search filters (location IDs, industry, etc.)")
-    add_api_common_arguments(search_parser)
-    search_parser.set_defaults(func=handlers["search"])
-
-    params_parser = linkedin_sub.add_parser("search-params", help="Resolve names to LinkedIn parameter IDs for search filters")
-    params_parser.add_argument("--type", required=True, help="Parameter type: location, industry, company, school, title, language, etc.")
-    params_parser.add_argument("--keywords", default="", help="Search text to match")
-    params_parser.add_argument("--linkedin-api", choices=["auto", "classic", "sales_navigator"], default="auto", help=argparse.SUPPRESS)
-    params_parser.add_argument("--limit", type=int, default=25, help="Max results, 1-250 (default: 25)")
-    add_api_common_arguments(params_parser)
-    params_parser.set_defaults(func=handlers["search_params"])
-
-    filters_parser = linkedin_sub.add_parser("filters", help="Print the LinkedIn/Sales Navigator structured filter catalog")
-    filters_parser.add_argument("--api", choices=["all", "classic", "sales_navigator"], default="all", help="Filter by API mode")
-    filters_parser.add_argument("--category", choices=["all", "people", "companies", "jobs", "posts"], default="all", help="Filter by search category")
-    filters_parser.add_argument("--field", help="Show one filter field or alias, e.g. headcount, company_headcount, role")
-    filters_parser.add_argument("--out-file", help="Optional path to save the selected catalog JSON")
-    add_api_common_arguments(filters_parser)
-    filters_parser.set_defaults(func=handlers["filters"])
-
-    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")
-    posts_parser.add_argument("--limit", type=int, default=25, help="Results per page, 1-100 (default: 25)")
-    add_api_common_arguments(posts_parser)
-    posts_parser.set_defaults(func=handlers["posts"])
-
-    post_parser = linkedin_sub.add_parser("post", help="Get full details for a single LinkedIn post")
-    post_parser.add_argument("--post-id", required=True, help="LinkedIn post ID")
-    add_api_common_arguments(post_parser)
-    post_parser.set_defaults(func=handlers["post"])
-
-    comments_parser = linkedin_sub.add_parser("comments", help="List comments on a LinkedIn post")
-    comments_parser.add_argument("--post-id", required=True, help="LinkedIn post ID")
-    comments_parser.add_argument("--cursor", help="Pagination cursor from previous response")
-    comments_parser.add_argument("--limit", type=int, default=100, help="Results per page, 1-100 (default: 100)")
-    add_api_common_arguments(comments_parser)
-    comments_parser.set_defaults(func=handlers["comments"])
-
-    reactions_parser = linkedin_sub.add_parser("reactions", help="List reactions on a LinkedIn post")
-    reactions_parser.add_argument("--post-id", required=True, help="LinkedIn post ID")
-    reactions_parser.add_argument("--cursor", help="Pagination cursor from previous response")
-    reactions_parser.add_argument("--limit", type=int, default=100, help="Results per page, 1-100 (default: 100)")
-    add_api_common_arguments(reactions_parser)
-    reactions_parser.set_defaults(func=handlers["reactions"])

{autotouch_cli-0.2.81 → autotouch_cli-0.2.82}/autotouch_cli/commands/list_build.py

@@ -132,13 +132,41 @@ def cmd_list_build_results(args: argparse.Namespace, *, runtime: ListBuildComman
     runtime.print_json(data, args.compact)
 
 
+def cmd_list_build_inputs(args: argparse.Namespace, *, runtime: ListBuildCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "GET",
+        "/api/list-builds/inputs",
+        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_list_build_pricing(args: argparse.Namespace, *, runtime: ListBuildCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "GET",
+        "/api/list-builds/pricing",
+        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 register_list_build_subcommands(
     subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
     *,
     add_api_common_arguments: Callable[[argparse.ArgumentParser], None],
     handlers: Dict[str, Callable[[argparse.Namespace], None]],
 ) -> None:
-    parser = subparsers.add_parser("list-build", help="Build durable company and lead lists")
+    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:
@@ -183,3 +211,10 @@ def register_list_build_subcommands(
     add_api_common_arguments(results)
     results.set_defaults(func=handlers["results"])
 
+    inputs = sub.add_parser("inputs", help="Show valid list-build filter IDs and values")
+    add_api_common_arguments(inputs)
+    inputs.set_defaults(func=handlers["inputs"])
+
+    pricing = sub.add_parser("pricing", help="Show list-build pricing rules")
+    add_api_common_arguments(pricing)
+    pricing.set_defaults(func=handlers["pricing"])

{autotouch_cli-0.2.81 → autotouch_cli-0.2.82}/autotouch_cli/commands/search.py

@@ -255,7 +255,7 @@ def register_search_subcommands(
     handlers: Dict[str, Callable[[argparse.Namespace], None]],
     recipe_types: Sequence[str],
 ) -> None:
-    parser = subparsers.add_parser("search", help="Provider-hidden search and list-building operations")
+    parser = subparsers.add_parser("search", help="Provider-hidden search operations")
     search_sub = parser.add_subparsers(dest="search_cmd", required=True)
 
     recipe_parser = search_sub.add_parser("recipe", help="Print search payload recipes")