autotouch-cli 0.2.48__tar.gz → 0.2.49__tar.gz

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.48
+Version: 0.2.49
 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
@@ -157,7 +157,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/README.md

@@ -132,7 +132,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.48`.
+Generated from the installed parser for `autotouch-cli` `0.2.49`.
 Manifest schema version: `2`.
 
 ## Output Modes

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.48",
+  "version": "0.2.49",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.48
+Version: 0.2.49
 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
@@ -157,7 +157,7 @@ Only send `user_schema` / `response_schema` when you intentionally want to overr
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/autotouch_shared/provider_registry.py

@@ -151,6 +151,12 @@ def _text(value: Any) -> str:
     return str(value or "").strip()
 
 
+def _mapping_text(value: Any) -> str:
+    if isinstance(value, dict):
+        return _text(value.get("column"))
+    return _text(value)
+
+
 def _llm_provider_values() -> Tuple[str, ...]:
     return ("gemini", "xai", "openai", "anthropic", "groq")
 
@@ -515,6 +521,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "For non-LinkedIn lookup, use lookupStrategy=domain/company with firstName+lastName+domain/company fields.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "email_finder",
@@ -541,6 +548,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "strategy_field": "config.strategy",
             "lookup_strategy_field": "config.lookupStrategy",
             "input_fields": ["config.linkedinUrl", "config.firstName", "config.lastName", "config.company", "config.domain"],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"emailColumn": {"column": "email_validation", "path": "response"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -583,6 +597,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "You can use linkedinUrl or email/workEmail/personalEmail inputs.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "phone_finder",
@@ -616,6 +631,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                 "config.lastName",
                 "config.company",
             ],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"phoneColumn": {"column": "mobile_phone", "path": "mobile_number"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -662,6 +684,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "Add more targeting keys as needed (jobFunctions, seniorities, keywords, excludeKeywords, skills).",
+            "Primitive source columns map directly. If companyDomain or other mapped inputs come from structured JSON, use {\"column\": \"...\", \"path\": \"...\"} instead of a plain string column key.",
         ),
         column_type={
             "type": "lead_finder",
@@ -687,6 +710,12 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "source_mode_field": "config.sourceMode",
             "company_domain_field": "config.companyDomain",
             "max_results_field": "config.maxResults",
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"companyDomain": {"column": "company_lookup", "path": "domain"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -758,7 +787,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "companyDomain is required; LinkedIn is optional.",
             "Include at least one usable hard-identity mapping such as LinkedIn, email, or phone.",
             "If companyDomain is missing in the table, derive or enrich that domain column first.",
-            "Primitive source columns map directly. Structured JSON columns must specify an explicit path such as work_email.response or mobile_phone.mobile_number.",
+            "Primitive source columns map directly. If a mapped source column stores structured JSON, send an object with column + path, for example {\"column\": \"work_email\", \"path\": \"response\"} or {\"column\": \"mobile_phone\", \"path\": \"mobile_number\"}.",
             "Add to CRM is optional and non-billable.",
             "Creating add_to_crm after upstream email/phone/lead columns already finished does not replay those older source updates; run add_to_crm explicitly or rerun the upstream source column.",
         ),
@@ -785,18 +814,19 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "eligibility": "company domain plus at least one valid LinkedIn URL, email, or phone must resolve from mapped source columns",
             "replay_behavior": "source updates only; explicit run required to backfill older upstream results",
             "structured_source_mapping": {
-                "rule": "primitive columns map directly; structured columns require explicit path",
-                "field": "config.fieldMappings.*.path",
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "field": "config.fieldMappings.*",
                 "examples": [
-                    "emailAddresses[].path = response",
-                    "phoneNumbers[].path = mobile_number",
+                    {"emailAddresses": [{"column": "work_email", "path": "response", "type": "work"}]},
+                    {"phoneNumbers": [{"column": "mobile_phone", "path": "mobile_number", "type": "mobile"}]},
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
                 ],
             },
         },
         composition_contract={
             "consumes": {
                 "kind": "crm_export_inputs",
-                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns must identify the exact JSON key via path",
+                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns use explicit {column, path} mappings to identify the exact field",
             },
             "produces": {
                 "kind": "lead_ids",
@@ -1276,30 +1306,39 @@ def validate_column_provider_contract(
 
     if contract.key == "email_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain")
+            _mapping_text(cfg.get(field_name))
+            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain", "emailColumn")
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, or name/company fields.",
+                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, config.emailColumn, or name/company fields.",
                 hint="Use `autotouch columns recipe --type email_finder`.",
             )
         return contract
 
     if contract.key == "phone_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "email", "workEmail", "personalEmail", "firstName", "lastName", "company")
+            _mapping_text(cfg.get(field_name))
+            for field_name in (
+                "linkedinUrl",
+                "email",
+                "workEmail",
+                "personalEmail",
+                "firstName",
+                "lastName",
+                "company",
+                "phoneColumn",
+            )
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "phone_finder requires at least one lookup input such as config.linkedinUrl or config.email/workEmail.",
+                "phone_finder requires at least one lookup input such as config.linkedinUrl, config.email/workEmail, or config.phoneColumn.",
                 hint="Use `autotouch columns recipe --type phone_finder`.",
             )
         return contract
 
     if contract.key == "lead_finder":
-        if not _text(cfg.get("companyDomain")):
+        if not _mapping_text(cfg.get("companyDomain")):
             raise ProviderContractValidationError(
                 "missing_required_field",
                 "lead_finder requires config.companyDomain.",

{autotouch_cli-0.2.48 → autotouch_cli-0.2.49}/pyproject.toml

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