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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.73
+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,7 +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: `autotouch linkedin list-build create --company-query 'SaaS startups' --headcount 1-10 --people-query 'Account Executive OR SDR' --num-results 250 --wait`
+- 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`
@@ -149,7 +149,7 @@ 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 paced provider requests, visible progress, and cooldown status
+- `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

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

@@ -109,7 +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: `autotouch linkedin list-build create --company-query 'SaaS startups' --headcount 1-10 --people-query 'Account Executive OR SDR' --num-results 250 --wait`
+- 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`
@@ -124,7 +124,7 @@ 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 paced provider requests, visible progress, and cooldown status
+- `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

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

@@ -141,6 +141,42 @@ def _split_repeated_values(values: Optional[List[str]]) -> List[str]:
     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),
@@ -172,6 +208,23 @@ def _normalize_linkedin_list_build_payload(args: argparse.Namespace, *, runtime:
     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"),
@@ -456,6 +509,19 @@ def register_linkedin_subcommands(
     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")

{autotouch_cli-0.2.73 → 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.73`.
+Generated from the installed parser for `autotouch-cli` `0.2.74`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -2365,6 +2365,19 @@ Create a paced background LinkedIn list-build job
                                             [--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]
@@ -2388,6 +2401,19 @@ Create a paced background LinkedIn list-build job
   - `--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

{autotouch_cli-0.2.73 → autotouch_cli-0.2.74}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.73",
+  "version": "0.2.74",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -33877,6 +33877,164 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "location_id",
+          "required": false,
+          "help": "LinkedIn location/region ID applied to company and people search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--location-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "company_location_id",
+          "required": false,
+          "help": "LinkedIn location/region ID applied only to company search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--company-location-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "people_location_id",
+          "required": false,
+          "help": "LinkedIn location/region ID applied only to people search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--people-location-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "company_industry_id",
+          "required": false,
+          "help": "LinkedIn industry ID applied to company search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--company-industry-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "people_industry_id",
+          "required": false,
+          "help": "LinkedIn industry ID applied to people search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--people-industry-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "role_id",
+          "required": false,
+          "help": "Resolved LinkedIn job-title ID for people search; repeat or comma-separate",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--role-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "function_id",
+          "required": false,
+          "help": "Resolved LinkedIn department/function ID for Sales Nav people search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--function-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "seniority",
+          "required": false,
+          "help": "Sales Nav seniority filter value; repeat or comma-separate",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--seniority"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "profile_language",
+          "required": false,
+          "help": "Profile language code, e.g. en",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--profile-language"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "technology_id",
+          "required": false,
+          "help": "Sales Nav technology ID applied to company search",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--technology-id"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "has_job_offers",
+          "required": false,
+          "help": "Filter companies currently hiring on LinkedIn",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--has-job-offers"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "company_filter",
+          "required": false,
+          "help": "Catalog company filter as FIELD=VALUE; repeat for multiple filters",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--company-filter"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "people_filter",
+          "required": false,
+          "help": "Catalog people filter as FIELD=VALUE; repeat for multiple filters",
+          "kind": "string",
+          "action": "append",
+          "repeatable": true,
+          "flags": [
+            "--people-filter"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "extra_params_json",
           "required": false,
@@ -34106,7 +34264,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch linkedin list-build create [-h] [--data-json DATA_JSON]\n                                            [--data-file DATA_FILE]\n                                            [--mode {company-first-people}]\n                                            [--linkedin-api {auto,classic,sales_navigator}]\n                                            [--company-query COMPANY_QUERY]\n                                            [--people-query PEOPLE_QUERY]\n                                            [--headcount HEADCOUNT]\n                                            [--num-results NUM_RESULTS]\n                                            [--excluded-title EXCLUDED_TITLE]\n                                            [--extra-params-json EXTRA_PARAMS_JSON]\n                                            [--company-extra-params-json COMPANY_EXTRA_PARAMS_JSON]\n                                            [--people-extra-params-json PEOPLE_EXTRA_PARAMS_JSON]\n                                            [--wait]\n                                            [--poll-interval POLL_INTERVAL]\n                                            [--wait-timeout WAIT_TIMEOUT]\n                                            [--base-url BASE_URL]\n                                            [--token TOKEN] [--use-x-api-key]\n                                            [--timeout TIMEOUT]\n                                            [--output {json,ndjson,human}]\n                                            [--compact] [--select SELECT |\n                                            --json-pointer JSON_POINTER]\n                                            [--verbose]"
+        "autotouch linkedin list-build create [-h] [--data-json DATA_JSON]\n                                            [--data-file DATA_FILE]\n                                            [--mode {company-first-people}]\n                                            [--linkedin-api {auto,classic,sales_navigator}]\n                                            [--company-query COMPANY_QUERY]\n                                            [--people-query PEOPLE_QUERY]\n                                            [--headcount HEADCOUNT]\n                                            [--num-results NUM_RESULTS]\n                                            [--excluded-title EXCLUDED_TITLE]\n                                            [--location-id LOCATION_ID]\n                                            [--company-location-id COMPANY_LOCATION_ID]\n                                            [--people-location-id PEOPLE_LOCATION_ID]\n                                            [--company-industry-id COMPANY_INDUSTRY_ID]\n                                            [--people-industry-id PEOPLE_INDUSTRY_ID]\n                                            [--role-id ROLE_ID]\n                                            [--function-id FUNCTION_ID]\n                                            [--seniority SENIORITY]\n                                            [--profile-language PROFILE_LANGUAGE]\n                                            [--technology-id TECHNOLOGY_ID]\n                                            [--has-job-offers]\n                                            [--company-filter COMPANY_FILTER]\n                                            [--people-filter PEOPLE_FILTER]\n                                            [--extra-params-json EXTRA_PARAMS_JSON]\n                                            [--company-extra-params-json COMPANY_EXTRA_PARAMS_JSON]\n                                            [--people-extra-params-json PEOPLE_EXTRA_PARAMS_JSON]\n                                            [--wait]\n                                            [--poll-interval POLL_INTERVAL]\n                                            [--wait-timeout WAIT_TIMEOUT]\n                                            [--base-url BASE_URL]\n                                            [--token TOKEN] [--use-x-api-key]\n                                            [--timeout TIMEOUT]\n                                            [--output {json,ndjson,human}]\n                                            [--compact] [--select SELECT |\n                                            --json-pointer JSON_POINTER]\n                                            [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"

{autotouch_cli-0.2.73 → autotouch_cli-0.2.74}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.73
+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,7 +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: `autotouch linkedin list-build create --company-query 'SaaS startups' --headcount 1-10 --people-query 'Account Executive OR SDR' --num-results 250 --wait`
+- 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`
@@ -149,7 +149,7 @@ 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 paced provider requests, visible progress, and cooldown status
+- `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

{autotouch_cli-0.2.73 → autotouch_cli-0.2.74}/autotouch_shared/linkedin_contract.py

@@ -68,11 +68,14 @@ _LINKEDIN_ENDPOINTS: Dict[str, Dict[str, Any]] = {
             "headcount": "optional range such as 1-10 or {'min':1,'max':10}",
             "num_results": "optional 1-1000 target people results",
             "excluded_titles": "optional array of titles to exclude after people results return",
+            "filters": "optional catalog filters applied to company and people searches",
+            "company_filters": "optional catalog filters applied to company search; compiled by API mode",
+            "people_filters": "optional catalog filters applied to people search; compiled by API mode",
             "extra_params": "optional object applied to company and people searches",
             "company_extra_params": "optional object applied only to company search",
-            "people_extra_params": "optional object applied only to people search",
+            "people_extra_params": "optional object applied only to people search; structured title filters should use provider IDs",
         },
-        "notes": "Recommended path for large LinkedIn/Sales Navigator lists. Runs as a paced background job with durable progress and cooldown state.",
+        "notes": "Recommended path for large LinkedIn/Sales Navigator lists. Runs as a Smart Table-owned paced background job with durable progress and cooldown state.",
     },
     "linkedin_list_build_status": {
         "method": "GET",
@@ -196,13 +199,16 @@ _LINKEDIN_RECIPES: Dict[str, Dict[str, Any]] = {
             "headcount": "1-10",
             "num_results": 250,
             "excluded_titles": ["founder", "owner", "ceo", "chief", "president"],
-            "company_extra_params": {"industry": ["4"]},
-            "people_extra_params": {},
+            "company_filters": {"location": ["103644278"], "industry": ["6"]},
+            "people_filters": {"location": ["103644278"], "profile_language": ["en"]},
         },
         "usage": "autotouch linkedin list-build create --data-file <payload.json> --wait",
         "notes": [
             "Recommended path for larger LinkedIn/Sales Navigator lists.",
-            "The worker searches companies first, filters returned headcount locally, then searches people at matched companies.",
+            "Execution is owned by Smart Table workers; the retired standalone List Builder worker is not required.",
+            "The worker sends headcount to company search, validates returned headcount locally, then searches people at matched companies.",
+            "Catalog filters compile to classic or Sales Navigator shapes after the connected account mode is resolved.",
+            "Use title text in people_query; only use structured role/job-title params after resolving provider IDs.",
             "No provider-hidden fallback is used when LinkedIn is disconnected, cooled down, or rate limited.",
             "Use 'autotouch linkedin filters' and 'autotouch linkedin search-params' to discover structured filter fields and IDs.",
         ],

{autotouch_cli-0.2.73 → autotouch_cli-0.2.74}/autotouch_shared/linkedin_filters.py

@@ -280,12 +280,13 @@ _FILTERS: List[Dict[str, Any]] = [
         provider_field="role",
         api_modes=["sales_navigator"],
         categories=["people"],
-        value_kind="id_or_text",
+        value_kind="id",
         resolver_type="JOB_TITLE",
         supports_include_exclude=True,
-        shape='{"include":["Account Executive","Sales Development Representative"],"exclude":["Founder"]}',
-        examples=[{"include": ["Account Executive"], "exclude": ["Founder", "Owner"]}],
+        shape='{"include":["1234"],"exclude":["5678"]}',
+        examples=[{"include": ["1234"], "exclude": ["5678"]}],
         aliases=["job_title", "title"],
+        notes=["Resolve human title text with /linkedin/search/parameters before using this structured filter."],
     ),
     _entry(
         "past_role",
@@ -633,6 +634,152 @@ def linkedin_parameter_types(*, service: Optional[str] = None) -> List[Dict[str,
     return [deepcopy(entry) for entry in _PARAMETER_TYPES if target in entry.get("services", [])]
 
 
+def _find_filter_entry(field: str, *, api_mode: str, category: str) -> Optional[Dict[str, Any]]:
+    target = str(field or "").strip().lower()
+    api = str(api_mode or "").strip().lower()
+    cat = str(category or "").strip().lower()
+    for entry in _FILTERS:
+        aliases = [str(alias).lower() for alias in entry.get("aliases", [])]
+        if target not in {str(entry.get("field", "")).lower(), *aliases}:
+            continue
+        if api not in entry.get("api_modes", []):
+            continue
+        if cat not in entry.get("categories", []):
+            continue
+        return entry
+    return None
+
+
+def _list_values(value: Any) -> List[Any]:
+    if value is None or value == "":
+        return []
+    if isinstance(value, list):
+        values = value
+    elif isinstance(value, tuple):
+        values = list(value)
+    else:
+        values = [value]
+    return [item for item in values if item not in (None, "")]
+
+
+def _include_exclude(value: Any) -> Dict[str, List[Any]]:
+    if isinstance(value, dict):
+        return {
+            "include": _list_values(value.get("include") or value.get("includes") or value.get("values")),
+            "exclude": _list_values(value.get("exclude") or value.get("excludes")),
+        }
+    return {"include": _list_values(value), "exclude": []}
+
+
+def _parse_range_filter(value: Any) -> List[Dict[str, int]]:
+    if value is None or value == "":
+        return []
+    if isinstance(value, list):
+        output: List[Dict[str, int]] = []
+        for item in value:
+            output.extend(_parse_range_filter(item))
+        return output
+    if isinstance(value, dict):
+        try:
+            minimum = int(value.get("min"))
+        except Exception:
+            return []
+        parsed: Dict[str, int] = {"min": minimum}
+        maximum = value.get("max")
+        if maximum not in (None, ""):
+            try:
+                parsed["max"] = int(maximum)
+            except Exception:
+                pass
+        return [parsed]
+
+    raw = str(value).strip().lower().replace(",", "")
+    for bucket in HEADCOUNT_BUCKETS:
+        if raw == str(bucket["label"]).lower().replace(",", ""):
+            parsed = {"min": int(bucket["min"])}
+            if bucket.get("max") is not None:
+                parsed["max"] = int(bucket["max"])
+            return [parsed]
+    numbers: List[int] = []
+    current = ""
+    for char in raw:
+        if char.isdigit():
+            current += char
+        elif current:
+            numbers.append(int(current))
+            current = ""
+    if current:
+        numbers.append(int(current))
+    if not numbers:
+        return []
+    parsed = {"min": numbers[0]}
+    if "+" not in raw and len(numbers) > 1:
+        parsed["max"] = numbers[1]
+    return [parsed]
+
+
+def _coerce_filter_value(entry: Dict[str, Any], value: Any) -> Any:
+    field = str(entry.get("field") or "")
+    kind = str(entry.get("value_kind") or "")
+    shape = str(entry.get("shape") or "")
+
+    if kind in {"range_bucket", "numeric_range"}:
+        if kind == "numeric_range" and isinstance(value, dict):
+            return value
+        return _parse_range_filter(value)
+    if kind == "boolean":
+        if isinstance(value, bool):
+            return value
+        return str(value).strip().lower() in {"1", "true", "yes", "y", "on"}
+    if kind == "object":
+        return value if isinstance(value, dict) else {}
+    if kind in {"enum", "iso_639_1", "enum_or_number"}:
+        if shape.startswith("["):
+            return _list_values(value)
+        return value
+    if field in {"saved_search_id", "recent_search_id"}:
+        values = _list_values(value)
+        return str(values[0]) if values else ""
+    if entry.get("supports_include_exclude"):
+        parts = _include_exclude(value)
+        payload: Dict[str, Any] = {}
+        if parts["include"]:
+            payload["include"] = parts["include"]
+        if parts["exclude"]:
+            payload["exclude"] = parts["exclude"]
+        return payload
+    return _list_values(value) if shape.startswith("[") else value
+
+
+def compile_linkedin_search_filters(
+    filters: Optional[Dict[str, Any]],
+    *,
+    api_mode: str,
+    category: str,
+) -> Dict[str, Any]:
+    """Compile catalog-level filter values into Unipile search extra_params.
+
+    The caller should pass the already resolved LinkedIn API mode. This keeps
+    CLI clients mode-neutral while still emitting classic vs Sales Navigator
+    shapes correctly after account capability resolution.
+    """
+    if not isinstance(filters, dict):
+        return {}
+    compiled: Dict[str, Any] = {}
+    for raw_field, raw_value in filters.items():
+        field = str(raw_field or "").strip()
+        if not field:
+            continue
+        entry = _find_filter_entry(field, api_mode=api_mode, category=category)
+        if entry is None:
+            raise ValueError(f"LinkedIn filter '{field}' is not supported for {api_mode}/{category}")
+        value = _coerce_filter_value(entry, raw_value)
+        if value in (None, "", [], {}):
+            continue
+        compiled[str(entry.get("provider_field") or field)] = value
+    return compiled
+
+
 def linkedin_filter_catalog(
     *,
     api_mode: Optional[str] = None,
@@ -654,6 +801,7 @@ def linkedin_filter_catalog(
 
 __all__ = [
     "HEADCOUNT_BUCKETS",
+    "compile_linkedin_search_filters",
     "linkedin_filter_catalog",
     "linkedin_filter_entries",
     "linkedin_parameter_types",

{autotouch_cli-0.2.73 → autotouch_cli-0.2.74}/pyproject.toml

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