autotouch-cli 0.2.55__tar.gz → 0.2.58__tar.gz

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.55
+Version: 0.2.58
 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
@@ -40,6 +40,8 @@ For a shipped human-readable reference generated from the installed parser, use
 pipx install autotouch-cli
 # or
 pip install autotouch-cli
+# upgrade
+pip install -U autotouch-cli
 ```
 
 ## First Run
@@ -135,6 +137,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Poll authoritative state: `autotouch jobs get`
 - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
 - Query leads: `autotouch leads query`
+- Find a lead by email or phone: `autotouch leads query --search '<email-or-phone>' --limit 10`
 
 ## More
 
@@ -163,7 +166,7 @@ Prompt variables in authored prompts support nested JSON access:
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/main/docs/platform/authentication.md

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/README.md

@@ -15,6 +15,8 @@ For a shipped human-readable reference generated from the installed parser, use
 pipx install autotouch-cli
 # or
 pip install autotouch-cli
+# upgrade
+pip install -U autotouch-cli
 ```
 
 ## First Run
@@ -110,6 +112,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Poll authoritative state: `autotouch jobs get`
 - Create/activate sequences: `autotouch sequences recipe`, `autotouch sequences create`, `autotouch sequences activate`
 - Query leads: `autotouch leads query`
+- Find a lead by email or phone: `autotouch leads query --search '<email-or-phone>' --limit 10`
 
 ## More
 
@@ -138,7 +141,7 @@ Prompt variables in authored prompts support nested JSON access:
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.54/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/main/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/main/docs/platform/authentication.md

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/autotouch_cli/cli.py

@@ -64,6 +64,7 @@ from autotouch_cli.commands.auth import (
     cmd_auth_check as cmd_auth_check_impl,
     cmd_auth_clear as cmd_auth_clear_impl,
     cmd_auth_login as cmd_auth_login_impl,
+    cmd_auth_status as cmd_auth_status_impl,
     cmd_auth_set_key as cmd_auth_set_key_impl,
     cmd_auth_show as cmd_auth_show_impl,
     cmd_auth_whoami as cmd_auth_whoami_impl,
@@ -104,6 +105,7 @@ from autotouch_cli.commands.linkedin import (
 from autotouch_cli.commands.rows import (
     RowCommandRuntime as RowCommandHandlerRuntime,
     cmd_rows_add as cmd_rows_add_impl,
+    cmd_rows_dedupe as cmd_rows_dedupe_impl,
     cmd_rows_delete as cmd_rows_delete_impl,
     cmd_rows_get as cmd_rows_get_impl,
     cmd_rows_import_csv as cmd_rows_import_csv_impl,
@@ -141,6 +143,10 @@ from autotouch_cli.commands.tables import (
     TableCommandRuntime as TableCommandHandlerRuntime,
     cmd_tables_create as cmd_tables_create_impl,
     cmd_tables_list as cmd_tables_list_impl,
+    cmd_tables_update as cmd_tables_update_impl,
+    cmd_tables_identity_get as cmd_tables_identity_get_impl,
+    cmd_tables_identity_set as cmd_tables_identity_set_impl,
+    cmd_tables_identity_clear as cmd_tables_identity_clear_impl,
 )
 from autotouch_cli.commands.tasks import (
     TaskCommandRuntime as TaskCommandHandlerRuntime,
@@ -160,6 +166,7 @@ from autotouch_cli.commands.tasks import (
 )
 from autotouch_cli.commands.webhooks import (
     WebhookCommandRuntime as WebhookCommandHandlerRuntime,
+    cmd_webhooks_configure_ingest as cmd_webhooks_configure_ingest_impl,
     cmd_webhooks_deliveries_attempts as cmd_webhooks_deliveries_attempts_impl,
     cmd_webhooks_deliveries_list as cmd_webhooks_deliveries_list_impl,
     cmd_webhooks_get as cmd_webhooks_get_impl,
@@ -316,6 +323,7 @@ from autotouch_cli.templates import (
     emit_webhooks_recipe,
     emit_workflows_list,
     emit_workflows_recipe,
+    emit_workflows_scaffold,
 )
 from autotouch_shared.provider_registry import (
     ProviderContractValidationError,
@@ -1021,6 +1029,9 @@ def _job_snapshot(job_doc: Dict[str, Any]) -> Dict[str, Any]:
         "processed_rows": int(job_doc.get("processed_rows") or 0),
         "total_rows": int(job_doc.get("total_rows") or 0),
         "error_rows": int(job_doc.get("error_rows") or 0),
+        "skipped_rows": int(job_doc.get("skipped_rows") or 0),
+        "pending_batches": int(job_doc.get("pending_batches") or 0),
+        "terminal_reason": job_doc.get("terminal_reason"),
         "credits_used": float(job_doc.get("credits_used") or 0.0),
         "billable": bool(job_doc.get("billable", False)),
         "updated_at": job_doc.get("updated_at"),
@@ -1347,6 +1358,7 @@ def _bound(name: str) -> Callable:
 
 # -- Auth commands --
 _register("auth_check", cmd_auth_check_impl, _auth_command_runtime)
+_register("auth_status", cmd_auth_status_impl, _auth_command_runtime)
 _register("auth_set_key", cmd_auth_set_key_impl, _auth_command_runtime)
 _register("auth_bootstrap", cmd_auth_bootstrap_impl, _auth_command_runtime)
 _register("auth_login", cmd_auth_login_impl, _auth_command_runtime)
@@ -1369,6 +1381,10 @@ _register("workspace_secrets_delete", cmd_workspace_secrets_delete_impl, _worksp
 # -- Table commands --
 _register("tables_list", cmd_tables_list_impl, _table_command_runtime)
 _register("tables_create", cmd_tables_create_impl, _table_command_runtime)
+_register("tables_update", cmd_tables_update_impl, _table_command_runtime)
+_register("tables_identity_get", cmd_tables_identity_get_impl, _table_command_runtime)
+_register("tables_identity_set", cmd_tables_identity_set_impl, _table_command_runtime)
+_register("tables_identity_clear", cmd_tables_identity_clear_impl, _table_command_runtime)
 
 # -- Row commands --
 _register("rows_list", cmd_rows_list_impl, _row_command_runtime)
@@ -1379,6 +1395,7 @@ _register("rows_import_csv", cmd_rows_import_csv_impl, _row_command_runtime)
 _register("rows_import_status", cmd_rows_import_status_impl, _row_command_runtime)
 _register("rows_import_verify", cmd_rows_import_verify_impl, _row_command_runtime)
 _register("rows_import_rollback", cmd_rows_import_rollback_impl, _row_command_runtime)
+_register("rows_dedupe", cmd_rows_dedupe_impl, _row_command_runtime)
 
 # -- Cell commands --
 _register("cells_get", cmd_cells_get_impl, _cell_command_runtime)
@@ -1450,6 +1467,7 @@ _register("webhooks_get", cmd_webhooks_get_impl, _webhook_command_runtime)
 _register("webhooks_rotate", cmd_webhooks_rotate_impl, _webhook_command_runtime)
 _register("webhooks_ingest", cmd_webhooks_ingest_impl, _webhook_command_runtime)
 _register("webhooks_recipe", cmd_webhooks_recipe_impl, _webhook_command_runtime)
+_register("webhooks_configure_ingest", cmd_webhooks_configure_ingest_impl, _webhook_command_runtime)
 _register("webhooks_subscriptions_list", cmd_webhooks_subscriptions_list_impl, _webhook_command_runtime)
 _register("webhooks_subscriptions_create", cmd_webhooks_subscriptions_create_impl, _webhook_command_runtime)
 _register("webhooks_subscriptions_get", cmd_webhooks_subscriptions_get_impl, _webhook_command_runtime)
@@ -1496,6 +1514,7 @@ _register("sequences_recipe", emit_sequences_recipe, _template_runtime)
 _register("leads_recipe", emit_leads_recipe, _template_runtime)
 _register("workflows_list", emit_workflows_list, _template_runtime)
 _register("workflows_recipe", emit_workflows_recipe, _template_runtime)
+_register("workflows_scaffold", emit_workflows_scaffold, _template_runtime)
 
 # -- Special-case commands that pass extra kwargs --
 
@@ -2265,6 +2284,7 @@ def _load_bundled_cli_reference() -> Optional[str]:
 # ---------------------------------------------------------------------------
 cmd_auth_bootstrap = _bound("auth_bootstrap")
 cmd_auth_check = _bound("auth_check")
+cmd_auth_status = _bound("auth_status")
 cmd_auth_schema = _bound("auth_schema")
 cmd_auth_whoami = _bound("auth_whoami")
 cmd_cells_get = _bound("cells_get")
@@ -2280,6 +2300,7 @@ cmd_schema = _bound("schema")
 cmd_sequences_enroll = _bound("sequences_enroll")
 cmd_sequences_status = _bound("sequences_status")
 cmd_tasks_recipe = _bound("tasks_recipe")
+cmd_workflows_scaffold = _bound("workflows_scaffold")
 cmd_webhooks_recipe = _bound("webhooks_recipe")
 cmd_workspace_secrets_delete = _bound("workspace_secrets_delete")
 cmd_workspace_secrets_schema = _bound("workspace_secrets_schema")

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/autotouch_cli/commands/auth.py

@@ -45,6 +45,86 @@ def cmd_auth_check(args: argparse.Namespace, *, runtime: AuthCommandRuntime) ->
     runtime.print_json(output, args.compact)
 
 
+def cmd_auth_status(args: argparse.Namespace, *, runtime: AuthCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    check_body = runtime.request_api(
+        "GET",
+        "/api/auth/check",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+
+    details_body: Any = None
+    details_warning: Optional[str] = None
+    try:
+        details_body = runtime.request_api(
+            "GET",
+            "/api/auth/user-details",
+            base_url=args.base_url,
+            token=token,
+            use_x_api_key=args.use_x_api_key,
+            timeout=args.timeout,
+            verbose=args.verbose,
+        )
+    except SystemExit as exc:
+        details_warning = f"user-details lookup failed with exit code {exc.code}"
+    except Exception as exc:
+        details_warning = str(exc)
+
+    output: Dict[str, Any] = {
+        "ok": bool((check_body or {}).get("ok", True)) if isinstance(check_body, dict) else True,
+        "base_url": runtime.api_url(args.base_url),
+        "auth_header_mode": "x-api-key" if args.use_x_api_key else "authorization",
+    }
+
+    if isinstance(check_body, dict):
+        for key in (
+            "auth_type",
+            "user_id",
+            "email",
+            "organization_id",
+            "api_key_id",
+            "api_key_name",
+            "granted_scopes",
+        ):
+            if key in check_body:
+                output[key] = check_body.get(key)
+
+    if isinstance(details_body, dict):
+        for key in (
+            "first_name",
+            "last_name",
+            "title",
+            "organization_name",
+            "organization_domain",
+            "organization_credits",
+            "organization_credits_monthly_quota",
+            "organization_next_renewal_date",
+            "user_allowance",
+            "user_monthly_quota",
+            "credit_access",
+            "permissions",
+            "plan",
+            "confirmed",
+        ):
+            if key in details_body:
+                output[key] = details_body.get(key)
+        if output.get("user_id") is None and details_body.get("id") is not None:
+            output["user_id"] = details_body.get("id")
+        if output.get("email") is None and details_body.get("email") is not None:
+            output["email"] = details_body.get("email")
+        if output.get("organization_id") is None and details_body.get("organization_id") is not None:
+            output["organization_id"] = details_body.get("organization_id")
+
+    if details_warning:
+        output["details_warning"] = details_warning
+
+    runtime.print_json(output, args.compact)
+
+
 def cmd_auth_set_key(args: argparse.Namespace, *, runtime: AuthCommandRuntime) -> None:
     api_key = (args.api_key or "").strip() if getattr(args, "api_key", None) else None
     if not api_key:
@@ -357,6 +437,18 @@ def register_auth_subcommands(
     add_api_common_arguments(pa)
     pa.set_defaults(func=handlers["check"])
 
+    pastatus = auth_sub.add_parser(
+        "status",
+        help="Resolve auth, identity, and credit/allowance context",
+        description=(
+            "Fetch the effective auth context plus organization/user credit state. "
+            "This is the best one-command status check when a key is valid but pointed at the wrong org "
+            "or the real blocker is allowance/quota state rather than authentication."
+        ),
+    )
+    add_api_common_arguments(pastatus)
+    pastatus.set_defaults(func=handlers["status"])
+
     pab = auth_sub.add_parser("bootstrap", help="Register an account/org and return a developer key")
     pab.add_argument("--first-name", help="First name")
     pab.add_argument("--last-name", help="Last name")
@@ -396,7 +488,12 @@ def register_auth_subcommands(
     add_output_formatting_arguments(pask)
     pask.set_defaults(func=handlers["set_key"])
 
-    pashow = auth_sub.add_parser("show", help="Show current auth config")
+    pashow = auth_sub.add_parser(
+        "show",
+        aliases=["config"],
+        help="Show current local auth config",
+        description="Show the locally saved auth config only. This command does not contact the API.",
+    )
     add_output_formatting_arguments(pashow)
     pashow.set_defaults(func=handlers["show"])
 

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/autotouch_cli/commands/jobs.py

@@ -82,6 +82,12 @@ def cmd_jobs_watch(args: argparse.Namespace, *, runtime: JobCommandRuntime) -> N
         "event": "job.timed_out" if timed_out else "job.completed",
         "job_id": final_job.get("job_id") or final_job.get("jobId") or args.job_id,
         "status": final_job.get("status"),
+        "processed_rows": int(final_job.get("processed_rows") or 0),
+        "error_rows": int(final_job.get("error_rows") or 0),
+        "skipped_rows": int(final_job.get("skipped_rows") or 0),
+        "total_rows": int(final_job.get("total_rows") or 0),
+        "pending_batches": int(final_job.get("pending_batches") or 0),
+        "terminal_reason": final_job.get("terminal_reason"),
         "job_status_url": f"{runtime.api_url(args.base_url)}/api/bulk-jobs/{args.job_id}",
         "timed_out": timed_out,
         "polls": int(poll_result.get("polls") or 0),

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/autotouch_cli/commands/rows.py

@@ -35,6 +35,23 @@ class RowCommandRuntime:
     default_timeout_seconds: int
 
 
+def _parse_json_cell_values(value: Any) -> Any:
+    if isinstance(value, str):
+        stripped = value.strip()
+        if stripped[:1] in {"{", "["}:
+            try:
+                parsed = json.loads(stripped)
+            except Exception:
+                return value
+            return _parse_json_cell_values(parsed)
+        return value
+    if isinstance(value, list):
+        return [_parse_json_cell_values(item) for item in value]
+    if isinstance(value, dict):
+        return {key: _parse_json_cell_values(item) for key, item in value.items()}
+    return value
+
+
 def cmd_rows_list(args: argparse.Namespace, *, runtime: RowCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
     filters = runtime.load_json_input(
@@ -73,6 +90,8 @@ def cmd_rows_list(args: argparse.Namespace, *, runtime: RowCommandRuntime) -> No
         timeout=args.timeout,
         verbose=args.verbose,
     )
+    if bool(getattr(args, "parse_json_cells", False)):
+        data = _parse_json_cell_values(data)
     runtime.print_json(data, args.compact)
 
 
@@ -87,6 +106,8 @@ def cmd_rows_get(args: argparse.Namespace, *, runtime: RowCommandRuntime) -> Non
         timeout=args.timeout,
         verbose=args.verbose,
     )
+    if bool(getattr(args, "parse_json_cells", False)):
+        data = _parse_json_cell_values(data)
     runtime.print_json(data, args.compact)
 
 
@@ -489,6 +510,23 @@ def cmd_rows_import_csv(args: argparse.Namespace, *, runtime: RowCommandRuntime)
     if field_mappings is not None:
         form_fields["field_mappings"] = json.dumps(field_mappings)
 
+    ingest_mode = str(getattr(args, "ingest_mode", None) or "").strip()
+    if ingest_mode:
+        ingest_policy: Dict[str, Any] = {"mode": ingest_mode}
+        match_rule_id = str(getattr(args, "match_rule_id", None) or "").strip()
+        match_column = str(getattr(args, "match_column", None) or "").strip()
+        match_strategy = str(getattr(args, "match_strategy", None) or "").strip()
+        merge_mode = str(getattr(args, "merge_mode", None) or "").strip()
+        if match_rule_id:
+            ingest_policy["rule_id"] = match_rule_id
+        if match_column:
+            ingest_policy["column_key"] = match_column
+        if match_strategy:
+            ingest_policy["match_strategy"] = match_strategy
+        if merge_mode:
+            ingest_policy["merge_mode"] = merge_mode
+        form_fields["ingest_policy"] = json.dumps(ingest_policy)
+
     use_async = bool(getattr(args, "use_async", True))
     params = {"use_async": "true" if use_async else "false"}
     response = runtime.request_multipart_api(
@@ -718,6 +756,50 @@ def cmd_rows_import_rollback(args: argparse.Namespace, *, runtime: RowCommandRun
             raise AutotouchAPIError(f"import rollback had {failed_count} failures")
 
 
+def cmd_rows_dedupe(args: argparse.Namespace, *, runtime: RowCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    stats_only = bool(getattr(args, "stats_only", False))
+    output_format = str(getattr(args, "output", "json") or "json").strip().lower()
+
+    if stats_only:
+        data = runtime.request_api(
+            "GET",
+            f"/api/tables/{args.table_id}/dedupe/{args.column_key}/stats",
+            base_url=args.base_url,
+            token=token,
+            use_x_api_key=args.use_x_api_key,
+            timeout=args.timeout,
+            verbose=args.verbose,
+        )
+        if output_format == "json" or not isinstance(data, dict):
+            runtime.print_json(data, args.compact)
+            return
+        total_rows = data.get("total_rows", "?")
+        unique_values = data.get("unique_values", "?")
+        rows_to_delete = data.get("rows_to_delete", "?")
+        print(f"Column:         {args.column_key}")
+        print(f"Total rows:     {total_rows}")
+        print(f"Unique values:  {unique_values}")
+        print(f"Rows to delete: {rows_to_delete}")
+        print(f"(Run again without --stats-only / --dry-run to delete duplicates)")
+    else:
+        data = runtime.request_api(
+            "POST",
+            f"/api/tables/{args.table_id}/dedupe",
+            base_url=args.base_url,
+            token=token,
+            use_x_api_key=args.use_x_api_key,
+            payload={"column_key": args.column_key},
+            timeout=args.timeout,
+            verbose=args.verbose,
+        )
+        if output_format == "json" or not isinstance(data, dict):
+            runtime.print_json(data, args.compact)
+            return
+        rows_deleted = data.get("rows_deleted", data.get("deleted", "?"))
+        print(f"Dedupe complete: {rows_deleted} duplicate rows deleted from column '{args.column_key}'")
+
+
 def register_rows_subcommands(
     subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
     *,
@@ -737,12 +819,22 @@ def register_rows_subcommands(
     prl.add_argument("--sort-file", help="Optional JSON file for server-side sort")
     prl.add_argument("--page-size", type=int, default=50, help="Rows per page (1-1000, default 50)")
     prl.add_argument("--cursor", help="Pagination cursor from a previous rows list response")
+    prl.add_argument(
+        "--parse-json-cells",
+        action="store_true",
+        help="Parse stringified JSON object/array cell values before printing output",
+    )
     add_api_common_arguments(prl)
     prl.set_defaults(func=handlers["list"])
 
     prg = rows_sub.add_parser("get", help="Get one flattened row by id")
     prg.add_argument("--table-id", required=True)
     prg.add_argument("--row-id", required=True)
+    prg.add_argument(
+        "--parse-json-cells",
+        action="store_true",
+        help="Parse stringified JSON object/array cell values before printing output",
+    )
     add_api_common_arguments(prg)
     prg.set_defaults(func=handlers["get"])
 
@@ -830,11 +922,47 @@ def register_rows_subcommands(
     pric.add_argument("--wait", action="store_true", help="Wait for async optimized import to complete")
     pric.add_argument("--poll-interval", type=int, default=2, help="Polling interval seconds for --wait")
     pric.add_argument("--wait-timeout", type=int, default=0, help="Max seconds to wait (0 = no timeout)")
+    _INGEST_MODES = ["allow", "skip", "upsert"]
+    _MATCH_STRATEGIES = ["email", "domain", "linkedin_url", "external_id", "exact_text"]
+    _MERGE_MODES = ["fill_empty", "overwrite_mapped"]
+    pric.add_argument(
+        "--ingest-mode",
+        choices=_INGEST_MODES,
+        default=None,
+        help="Duplicate handling: allow / skip / upsert (enables server-side identity resolution)",
+    )
+    pric.add_argument("--match-rule-id", default=None, help="Use a pre-configured table identity rule by ID")
+    pric.add_argument("--match-column", default=None, help="Column key to match on (when no rule-id)")
+    pric.add_argument(
+        "--match-strategy",
+        choices=_MATCH_STRATEGIES,
+        default=None,
+        help="Normalisation strategy for the match column",
+    )
+    pric.add_argument(
+        "--merge-mode",
+        choices=_MERGE_MODES,
+        default=None,
+        help="Cell merge strategy when upserting (default: fill_empty)",
+    )
     pric.set_defaults(trim_headers=True, empty_as_null=True, skip_empty_rows=True)
     pric.set_defaults(check_company_blacklist=True, check_email_blacklist=False, use_async=True)
     add_api_common_arguments(pric)
     pric.set_defaults(func=handlers["import_csv"])
 
+    prdedupe = rows_sub.add_parser("dedupe", help="Preview or remove duplicate rows by column value")
+    prdedupe.add_argument("--table-id", required=True)
+    prdedupe.add_argument("--column-key", required=True, help="Column to deduplicate on")
+    prdedupe.add_argument(
+        "--stats-only",
+        "--dry-run",
+        dest="stats_only",
+        action="store_true",
+        help="Print deduplication preview without deleting rows",
+    )
+    add_api_common_arguments(prdedupe)
+    prdedupe.set_defaults(func=handlers["dedupe"])
+
     prschema = rows_sub.add_parser("schema", help="Print row payload schemas for add/import helpers")
     prschema.add_argument("--type", choices=["all", *row_schema_types], default="all")
     prschema.add_argument("--out-file", help="Write schema JSON to file")

{autotouch_cli-0.2.55 → autotouch_cli-0.2.58}/autotouch_cli/commands/search.py

@@ -119,13 +119,20 @@ def cmd_search_people(args: argparse.Namespace, *, runtime: SearchCommandRuntime
 
 def cmd_search_similar_companies(args: argparse.Namespace, *, runtime: SearchCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {
+        "company_name": str(getattr(args, "company_name", "") or "").strip(),
+        "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+    }
+    company_domain = str(getattr(args, "company_domain", "") or "").strip()
+    company_description = str(getattr(args, "company_description", "") or "").strip()
+    if company_domain:
+        payload["company_domain"] = company_domain
+    if company_description:
+        payload["company_description"] = company_description
     payload = _load_search_payload(
         args,
         runtime=runtime,
-        default_payload={
-            "company_name": str(getattr(args, "company_name", "") or "").strip(),
-            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
-        },
+        default_payload=payload,
     )
     data = runtime.request_api(
         "POST",
@@ -278,6 +285,8 @@ def register_search_subcommands(
 
     similar_parser = search_sub.add_parser("similar-companies", help="Find companies similar to a seed company")
     similar_parser.add_argument("--company-name", help="Seed company name")
+    similar_parser.add_argument("--company-domain", help="Official company domain to ground similarity search")
+    similar_parser.add_argument("--company-description", help="Short semantic company description to improve peer matching")
     similar_parser.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
     similar_parser.add_argument("--data-json", help="Explicit request payload JSON")
     similar_parser.add_argument("--data-file", help="Path to request payload JSON file")