PyPI - autotouch-cli - Versions diffs - 0.2.86__tar.gz → 0.2.88__tar.gz - Mend

autotouch-cli 0.2.86tar.gz → 0.2.88tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (55) hide show

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.86
+Version: 0.2.88
 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
@@ -36,6 +36,8 @@ For a shipped human-readable reference generated from the installed parser, use
 ## Install
+Released package:
 ```bash
 pipx install autotouch-cli
 # or
@@ -44,6 +46,16 @@ pip install autotouch-cli
 pip install -U autotouch-cli
 ```
+Unreleased branch or pre-publish build:
+```bash
+pipx install --force "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+# or
+python -m pip install -U "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+```
+The `autotouch-cli` package name installs the latest published package from the configured package index. Use the git/source install form when testing a version bump before the release tag has published.
 ## First Run
 Existing developer key:
@@ -132,7 +144,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - 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`
+- Run Exa Company Search for basic company discovery, competitors, and lookalikes: `autotouch search companies`, `autotouch search similar-companies`
 - 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`
 - Check connected LinkedIn account status/limits: `autotouch linkedin status`, `autotouch linkedin limits`
@@ -146,13 +158,19 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 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 search companies` for Exa Company Search when the target is basic company discovery, competitors, lookalikes, or a semantic company search. Put company constraints directly in natural language: industry, geography, funding, headcount, technology, founded date, and similarity. Examples: "AI workflow platforms for healthcare", "US education software startups focused on AI math tutoring with 1-50 employees", or "companies like Rippling for HR and workforce management". Exa company search returns up to 100 results per API call and costs 1 credit per 10 returned results.
+Use `autotouch search similar-companies` as a convenience wrapper for Exa Company Search similarity. Prefer `--query` for Exa's documented semantic patterns, such as "companies like Notion", "competitors of Stripe", or "companies working on making space travel cheaper". The older seed fields `company_name`, `company_domain`, and `company_description` remain available when you want the CLI/API to compose that query; it does not use Exa `/findSimilar`.
-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.
+Use `autotouch search people` for provider-hidden people search when the target is niche, semantic, or hard to express with structured filters. People search currently 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 LinkedIn/Sales Navigator 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. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
-For account-first prospecting, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+For account-first prospecting from LinkedIn/Sales Navigator, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use Exa company search as a default pre-step for every LinkedIn list build; use it when the user's target is genuinely semantic, niche, competitor-based, or not meant to be LinkedIn-sourced.
+Use `autotouch agents ...` for recurring signal-based discovery. Scheduled agents support `--target ACCOUNTS` for company/account output and `--target LEADS` for people output. Every agent writes a source/signal table for the evidence it used; lead agents then write `candidate_research.candidates[]` on source rows and list-sync those candidates into the lead/candidate output table. See the agent playbook for the full source-table and candidate-sync contract.
 ## More
@@ -160,7 +178,7 @@ 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.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
+- `autotouch --version` should be `0.2.88` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, the cleaned single LinkedIn-sourced list-build path, Exa Company Search up to 100 results, and scheduled agent `--target ACCOUNTS|LEADS`
 - `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 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_cli-0.2.86 → autotouch_cli-0.2.88}/README.md RENAMED Viewed

@@ -11,6 +11,8 @@ For a shipped human-readable reference generated from the installed parser, use
 ## Install
+Released package:
 ```bash
 pipx install autotouch-cli
 # or
@@ -19,6 +21,16 @@ pip install autotouch-cli
 pip install -U autotouch-cli
 ```
+Unreleased branch or pre-publish build:
+```bash
+pipx install --force "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+# or
+python -m pip install -U "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+```
+The `autotouch-cli` package name installs the latest published package from the configured package index. Use the git/source install form when testing a version bump before the release tag has published.
 ## First Run
 Existing developer key:
@@ -107,7 +119,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - 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`
+- Run Exa Company Search for basic company discovery, competitors, and lookalikes: `autotouch search companies`, `autotouch search similar-companies`
 - 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`
 - Check connected LinkedIn account status/limits: `autotouch linkedin status`, `autotouch linkedin limits`
@@ -121,13 +133,19 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 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 search companies` for Exa Company Search when the target is basic company discovery, competitors, lookalikes, or a semantic company search. Put company constraints directly in natural language: industry, geography, funding, headcount, technology, founded date, and similarity. Examples: "AI workflow platforms for healthcare", "US education software startups focused on AI math tutoring with 1-50 employees", or "companies like Rippling for HR and workforce management". Exa company search returns up to 100 results per API call and costs 1 credit per 10 returned results.
+Use `autotouch search similar-companies` as a convenience wrapper for Exa Company Search similarity. Prefer `--query` for Exa's documented semantic patterns, such as "companies like Notion", "competitors of Stripe", or "companies working on making space travel cheaper". The older seed fields `company_name`, `company_domain`, and `company_description` remain available when you want the CLI/API to compose that query; it does not use Exa `/findSimilar`.
-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.
+Use `autotouch search people` for provider-hidden people search when the target is niche, semantic, or hard to express with structured filters. People search currently 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 LinkedIn/Sales Navigator 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. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
-For account-first prospecting, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+For account-first prospecting from LinkedIn/Sales Navigator, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use Exa company search as a default pre-step for every LinkedIn list build; use it when the user's target is genuinely semantic, niche, competitor-based, or not meant to be LinkedIn-sourced.
+Use `autotouch agents ...` for recurring signal-based discovery. Scheduled agents support `--target ACCOUNTS` for company/account output and `--target LEADS` for people output. Every agent writes a source/signal table for the evidence it used; lead agents then write `candidate_research.candidates[]` on source rows and list-sync those candidates into the lead/candidate output table. See the agent playbook for the full source-table and candidate-sync contract.
 ## More
@@ -135,7 +153,7 @@ 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.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
+- `autotouch --version` should be `0.2.88` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, the cleaned single LinkedIn-sourced list-build path, Exa Company Search up to 100 results, and scheduled agent `--target ACCOUNTS|LEADS`
 - `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 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_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_cli/commands/agents.py RENAMED Viewed

@@ -10,6 +10,9 @@ from dataclasses import dataclass
 from typing import Any, Callable, Dict, Optional, Sequence
+AGENT_TARGET_CHOICES = ["LEADS", "ACCOUNTS"]
 @dataclass(frozen=True)
 class AgentCommandRuntime:
     resolve_token: Callable[[Optional[str], bool], Optional[str]]
@@ -50,7 +53,12 @@ def cmd_agents_create(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
     token = runtime.resolve_token(args.token, required=True)
     if getattr(args, "from_file", None):
-        payload = runtime.load_json_input(args.from_file)
+        payload = runtime.load_json_input(
+            inline_json=None,
+            file_path=args.from_file,
+            context="agent",
+            default={},
+        )
     else:
         payload: Dict[str, Any] = {}
         if args.name:
@@ -106,7 +114,7 @@ def cmd_agents_create(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
     # AI generation: generate persona, signals, and create in one shot
     if getattr(args, "generate", False) and "personaConfig" not in payload:
-        target = payload.get("targetType", "LEADS")
+        target = str(payload.get("targetType") or "LEADS").upper()
         sys.stderr.write(f"Generating persona for {target}...\n")
         persona_data = runtime.request_api(
             "POST", "/api/agents/generate-persona",
@@ -119,17 +127,21 @@ def cmd_agents_create(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
         payload["personaConfig"] = persona
         sys.stderr.write(f"  Persona generated: {json.dumps(persona, ensure_ascii=False)[:200]}...\n")
-        # Generate topics
-        sys.stderr.write("Generating topic suggestions...\n")
-        topic_data = runtime.request_api(
-            "POST", "/api/agents/generate-signal-topics",
-            base_url=args.base_url, token=token,
-            use_x_api_key=args.use_x_api_key,
-            payload={"targetType": target, "personaConfig": persona},
-            timeout=args.timeout, verbose=args.verbose,
-        )
-        topics = topic_data.get("topics") or []
-        sys.stderr.write(f"  Topics: {topics}\n")
+        topics = []
+        if target == "LEADS":
+            # LinkedIn topic engagement is a people-output signal. Account
+            # agents should stick to company-compatible signals such as jobs
+            # and news until a company-output topic signal exists.
+            sys.stderr.write("Generating topic suggestions...\n")
+            topic_data = runtime.request_api(
+                "POST", "/api/agents/generate-signal-topics",
+                base_url=args.base_url, token=token,
+                use_x_api_key=args.use_x_api_key,
+                payload={"targetType": target, "personaConfig": persona},
+                timeout=args.timeout, verbose=args.verbose,
+            )
+            topics = topic_data.get("topics") or []
+            sys.stderr.write(f"  Topics: {topics}\n")
         # Generate job signal
         sys.stderr.write("Generating job signal config...\n")
@@ -146,7 +158,7 @@ def cmd_agents_create(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
         # Assemble signals
         signals = []
-        if topics:
+        if target == "LEADS" and topics:
             signals.append({
                 "key": "linkedin-topic-post-engagement",
                 "config": {"topics": [{"id": "", "label": t, "trackingMode": "all"} for t in topics[:5]]},
@@ -184,7 +196,12 @@ def cmd_agents_update(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
     token = runtime.resolve_token(args.token, required=True)
     if getattr(args, "from_file", None):
-        payload = runtime.load_json_input(args.from_file)
+        payload = runtime.load_json_input(
+            inline_json=None,
+            file_path=args.from_file,
+            context="agent",
+            default={},
+        )
     else:
         payload: Dict[str, Any] = {}
         if getattr(args, "name", None):
@@ -447,7 +464,7 @@ def register_agents_subcommands(
     # -- create --
     pac = agents_sub.add_parser("create", help="Create a new agent")
     pac.add_argument("--name", help="Agent name")
-    pac.add_argument("--target", choices=["LEADS"], help="Target type")
+    pac.add_argument("--target", choices=AGENT_TARGET_CHOICES, help="Target type")
     pac.add_argument("--assigned-user", dest="assigned_user", help="Assigned user ID")
     pac.add_argument("--schedule-time", dest="schedule_time", help="Time of day (HH:MM) — used by daily/weekly")
     pac.add_argument("--schedule-tz", dest="schedule_tz", help="Timezone (default: UTC)")
@@ -585,14 +602,14 @@ def register_agents_subcommands(
     # -- generate-persona --
     pagp = agents_sub.add_parser("generate-persona", help="Generate ICP persona config via AI")
-    pagp.add_argument("--target", choices=["LEADS"], default="LEADS", help="Target type")
+    pagp.add_argument("--target", choices=AGENT_TARGET_CHOICES, default="LEADS", help="Target type")
     pagp.add_argument("--current-config", dest="current_config", help="Path to current persona config JSON")
     add_api_common_arguments(pagp)
     pagp.set_defaults(func=handlers["generate_persona"])
     # -- generate-topics --
     pagt = agents_sub.add_parser("generate-topics", help="Generate signal topic suggestions via AI")
-    pagt.add_argument("--target", choices=["LEADS"], default="LEADS", help="Target type")
+    pagt.add_argument("--target", choices=AGENT_TARGET_CHOICES, default="LEADS", help="Target type")
     pagt.add_argument("--persona", help="Path to persona config JSON")
     pagt.add_argument("--current-topics", dest="current_topics", help="Comma-separated current topics")
     add_api_common_arguments(pagt)
@@ -600,7 +617,7 @@ def register_agents_subcommands(
     # -- generate-job-signal --
     pagj = agents_sub.add_parser("generate-job-signal", help="Generate job signal config via AI")
-    pagj.add_argument("--target", choices=["LEADS"], default="LEADS", help="Target type")
+    pagj.add_argument("--target", choices=AGENT_TARGET_CHOICES, default="LEADS", help="Target type")
     pagj.add_argument("--persona", help="Path to persona config JSON")
     pagj.add_argument("--current-titles", dest="current_titles", help="Comma-separated current job titles")
     pagj.add_argument("--current-keywords", dest="current_keywords", help="Comma-separated current keywords")

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_cli/commands/search.py RENAMED Viewed

@@ -67,7 +67,7 @@ def cmd_search_companies(args: argparse.Namespace, *, runtime: SearchCommandRunt
         runtime=runtime,
         default_payload={
             "query": str(getattr(args, "query", "") or "").strip(),
-            "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 10)),
+            "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 100)),
         },
     )
     data = runtime.request_api(
@@ -120,11 +120,16 @@ 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", 10) or 10), 10)),
+        "limit": max(1, min(int(getattr(args, "limit", 10) or 10), 100)),
     }
+    query = str(getattr(args, "query", "") or "").strip()
+    company_name = str(getattr(args, "company_name", "") or "").strip()
     company_domain = str(getattr(args, "company_domain", "") or "").strip()
     company_description = str(getattr(args, "company_description", "") or "").strip()
+    if query:
+        payload["query"] = query
+    if company_name:
+        payload["company_name"] = company_name
     if company_domain:
         payload["company_domain"] = company_domain
     if company_description:
@@ -264,9 +269,9 @@ def register_search_subcommands(
     add_api_common_arguments(recipe_parser)
     recipe_parser.set_defaults(func=handlers["recipe"])
-    companies_parser = search_sub.add_parser("companies", help="Find companies with provider-hidden neural search")
-    companies_parser.add_argument("--query", help="Free-text company query")
-    companies_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-10 (default: 10)")
+    companies_parser = search_sub.add_parser("companies", help="Find companies with Exa Company Search")
+    companies_parser.add_argument("--query", help="Natural-language company query")
+    companies_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-100 (default: 10)")
     companies_parser.add_argument("--data-json", help="Explicit request payload JSON")
     companies_parser.add_argument("--data-file", help="Path to request payload JSON file")
     add_api_common_arguments(companies_parser)
@@ -284,10 +289,11 @@ def register_search_subcommands(
     people_parser.set_defaults(func=handlers["people"])
     similar_parser = search_sub.add_parser("similar-companies", help="Find companies similar to a seed company")
+    similar_parser.add_argument("--query", help="Exa Company Search semantic similarity query, e.g. 'companies like Notion for enterprise knowledge management'")
     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=10, help="Max results, 1-10 (default: 10)")
+    similar_parser.add_argument("--limit", type=int, default=10, help="Max results, 1-100 (default: 10)")
     similar_parser.add_argument("--data-json", help="Explicit request payload JSON")
     similar_parser.add_argument("--data-file", help="Path to request payload JSON file")
     add_api_common_arguments(similar_parser)

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_cli/data/CLI_REFERENCE.md RENAMED Viewed

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
-Generated from the installed parser for `autotouch-cli` `0.2.86`.
+Generated from the installed parser for `autotouch-cli` `0.2.88`.
 Manifest schema version: `2`.
 ## Output Modes
@@ -34,7 +34,7 @@ Create a new agent
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch agents create [-h] [--name NAME] [--target {LEADS}]
+  - `autotouch agents create [-h] [--name NAME] [--target {LEADS,ACCOUNTS}]
                                [--assigned-user ASSIGNED_USER]
                                [--schedule-time SCHEDULE_TIME]
                                [--schedule-tz SCHEDULE_TZ]
@@ -56,7 +56,7 @@ Create a new agent
                                [--verbose]`
 - Options:
   - `--name` (kind=string): Agent name
-  - `--target` (kind=string; choices=LEADS): Target type
+  - `--target` (kind=string; choices=LEADS,ACCOUNTS): Target type
   - `--assigned-user` (kind=string): Assigned user ID
   - `--schedule-time` (kind=string): Time of day (HH:MM) — used by daily/weekly
   - `--schedule-tz` (kind=string): Timezone (default: UTC)
@@ -118,7 +118,7 @@ Generate job signal config via AI
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch agents generate-job-signal [-h] [--target {LEADS}]
+  - `autotouch agents generate-job-signal [-h] [--target {LEADS,ACCOUNTS}]
                                             [--persona PERSONA]
                                             [--current-titles CURRENT_TITLES]
                                             [--current-keywords CURRENT_KEYWORDS]
@@ -130,7 +130,7 @@ Generate job signal config via AI
                                             --json-pointer JSON_POINTER]
                                             [--verbose]`
 - Options:
-  - `--target` (kind=string; choices=LEADS; default=LEADS): Target type
+  - `--target` (kind=string; choices=LEADS,ACCOUNTS; default=LEADS): Target type
   - `--persona` (kind=string): Path to persona config JSON
   - `--current-titles` (kind=string; comma-separated): Comma-separated current job titles
   - `--current-keywords` (kind=string; comma-separated): Comma-separated current keywords
@@ -153,7 +153,7 @@ Generate ICP persona config via AI
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch agents generate-persona [-h] [--target {LEADS}]
+  - `autotouch agents generate-persona [-h] [--target {LEADS,ACCOUNTS}]
                                          [--current-config CURRENT_CONFIG]
                                          [--base-url BASE_URL] [--token TOKEN]
                                          [--use-x-api-key] [--timeout TIMEOUT]
@@ -162,7 +162,7 @@ Generate ICP persona config via AI
                                          --json-pointer JSON_POINTER]
                                          [--verbose]`
 - Options:
-  - `--target` (kind=string; choices=LEADS; default=LEADS): Target type
+  - `--target` (kind=string; choices=LEADS,ACCOUNTS; default=LEADS): Target type
   - `--current-config` (kind=string): Path to current persona config JSON
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
   - `--token` (kind=string; sensitive): Developer API key / JWT token
@@ -183,7 +183,7 @@ Generate signal topic suggestions via AI
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch agents generate-topics [-h] [--target {LEADS}]
+  - `autotouch agents generate-topics [-h] [--target {LEADS,ACCOUNTS}]
                                         [--persona PERSONA]
                                         [--current-topics CURRENT_TOPICS]
                                         [--base-url BASE_URL] [--token TOKEN]
@@ -193,7 +193,7 @@ Generate signal topic suggestions via AI
                                         --json-pointer JSON_POINTER]
                                         [--verbose]`
 - Options:
-  - `--target` (kind=string; choices=LEADS; default=LEADS): Target type
+  - `--target` (kind=string; choices=LEADS,ACCOUNTS; default=LEADS): Target type
   - `--persona` (kind=string): Path to persona config JSON
   - `--current-topics` (kind=string; comma-separated): Comma-separated current topics
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
@@ -1322,14 +1322,14 @@ Print copy-ready ColumnCreate payload templates
 - Output modes: `json, ndjson, human`
 - Example:
   - `autotouch columns recipe [-h]
-                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]
+                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads,sync_to_leads_array,add_to_leads_array}]
                                 [--research-mode {lite,heavy}]
                                 [--out-file OUT_FILE]
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER]`
 - Options:
-  - `--type` (kind=string; choices=all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads; default=all)
+  - `--type` (kind=string; choices=all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads,sync_to_leads_array,add_to_leads_array; default=all)
   - `--research-mode` (kind=string; choices=lite,heavy; default=lite): Research Agent depth for LLM recipes (default: lite; heavy costs more per row)
   - `--out-file` (kind=file; input=file): Write template JSON to file (single type writes payload only)
   - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
@@ -3559,7 +3559,7 @@ Provider-hidden search operations
 #### `autotouch search companies`
-Find companies with provider-hidden neural search
+Find companies with Exa Company Search
 - Auth: `developer_key_or_user_session`
 - Stability: `stable`
@@ -3575,8 +3575,8 @@ Find companies with provider-hidden neural search
                                   [--select SELECT |
                                   --json-pointer JSON_POINTER] [--verbose]`
 - Options:
-  - `--query` (kind=string): Free-text company query
-  - `--limit` (kind=integer; default=10): Max results, 1-10 (default: 10)
+  - `--query` (kind=string): Natural-language company query
+  - `--limit` (kind=integer; default=10): Max results, 1-100 (default: 10)
   - `--data-json` (kind=json; input=json): Explicit request payload JSON
   - `--data-file` (kind=file; input=file): Path to request payload JSON file
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
@@ -3811,7 +3811,8 @@ Find companies similar to a seed company
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch search similar-companies [-h] [--company-name COMPANY_NAME]
+  - `autotouch search similar-companies [-h] [--query QUERY]
+                                          [--company-name COMPANY_NAME]
                                           [--company-domain COMPANY_DOMAIN]
                                           [--company-description COMPANY_DESCRIPTION]
                                           [--limit LIMIT]
@@ -3825,10 +3826,11 @@ Find companies similar to a seed company
                                           --json-pointer JSON_POINTER]
                                           [--verbose]`
 - Options:
+  - `--query` (kind=string): Exa Company Search semantic similarity query, e.g. 'companies like Notion for enterprise knowledge management'
   - `--company-name` (kind=string): Seed company name
   - `--company-domain` (kind=string): Official company domain to ground similarity search
   - `--company-description` (kind=string): Short semantic company description to improve peer matching
-  - `--limit` (kind=integer; default=10): Max results, 1-10 (default: 10)
+  - `--limit` (kind=integer; default=10): Max results, 1-100 (default: 10)
   - `--data-json` (kind=json; input=json): Explicit request payload JSON
   - `--data-file` (kind=file; input=file): Path to request payload JSON file
   - `--base-url` (kind=string; default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_cli/data/cli-manifest.json RENAMED Viewed

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.86",
+  "version": "0.2.88",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -6304,7 +6304,7 @@
       ],
       "aliases": [],
       "group": "search",
-      "help": "Find companies with provider-hidden neural search",
+      "help": "Find companies with Exa Company Search",
       "description": null,
       "notes": null,
       "required_flags": [],
@@ -6313,7 +6313,7 @@
         {
           "dest": "query",
           "required": false,
-          "help": "Free-text company query",
+          "help": "Natural-language company query",
           "kind": "string",
           "action": "store",
           "flags": [
@@ -6324,7 +6324,7 @@
         {
           "dest": "limit",
           "required": false,
-          "help": "Max results, 1-10 (default: 10)",
+          "help": "Max results, 1-100 (default: 10)",
           "kind": "integer",
           "action": "store",
           "default_when_omitted": 10,
@@ -6785,6 +6785,17 @@
       "required_flags": [],
       "positionals": [],
       "options": [
+        {
+          "dest": "query",
+          "required": false,
+          "help": "Exa Company Search semantic similarity query, e.g. 'companies like Notion for enterprise knowledge management'",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--query"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "company_name",
           "required": false,
@@ -6821,7 +6832,7 @@
         {
           "dest": "limit",
           "required": false,
-          "help": "Max results, 1-10 (default: 10)",
+          "help": "Max results, 1-100 (default: 10)",
           "kind": "integer",
           "action": "store",
           "default_when_omitted": 10,
@@ -7008,7 +7019,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch search similar-companies [-h] [--company-name COMPANY_NAME]\n                                          [--company-domain COMPANY_DOMAIN]\n                                          [--company-description COMPANY_DESCRIPTION]\n                                          [--limit LIMIT]\n                                          [--data-json DATA_JSON]\n                                          [--data-file DATA_FILE]\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 search similar-companies [-h] [--query QUERY]\n                                          [--company-name COMPANY_NAME]\n                                          [--company-domain COMPANY_DOMAIN]\n                                          [--company-description COMPANY_DESCRIPTION]\n                                          [--limit LIMIT]\n                                          [--data-json DATA_JSON]\n                                          [--data-file DATA_FILE]\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"
@@ -17585,7 +17596,9 @@
             "add_to_sequence",
             "http_request",
             "add_to_leads",
-            "sync_to_leads"
+            "sync_to_leads",
+            "sync_to_leads_array",
+            "add_to_leads_array"
           ],
           "default_when_omitted": "all",
           "default": "all",
@@ -17710,7 +17723,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns recipe [-h]\n                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]\n                                [--research-mode {lite,heavy}]\n                                [--out-file OUT_FILE]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER]"
+        "autotouch columns recipe [-h]\n                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads,sync_to_leads_array,add_to_leads_array}]\n                                [--research-mode {lite,heavy}]\n                                [--out-file OUT_FILE]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -34783,7 +34796,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "flags": [
             "--target"
@@ -35163,7 +35177,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents create [-h] [--name NAME] [--target {LEADS}]\n                               [--assigned-user ASSIGNED_USER]\n                               [--schedule-time SCHEDULE_TIME]\n                               [--schedule-tz SCHEDULE_TZ]\n                               [--schedule-frequency {hourly,every_6h,every_12h,daily,weekly}]\n                               [--schedule-days {all,weekdays}]\n                               [--schedule-day-of-week 0-6]\n                               [--schedule-window-start SCHEDULE_WINDOW_START]\n                               [--schedule-window-end SCHEDULE_WINDOW_END]\n                               [--auto-find-email] [--auto-find-phone]\n                               [--auto-broaden]\n                               [--auto-create-lead-mode {qualified_only,everyone,manual_only}]\n                               [--auto-sequence-id AUTO_SEQUENCE_ID]\n                               [--status {DRAFT,ACTIVE,PAUSED}]\n                               [--from-file FROM_FILE] [--generate]\n                               [--base-url BASE_URL] [--token TOKEN]\n                               [--use-x-api-key] [--timeout TIMEOUT]\n                               [--output {json,ndjson,human}] [--compact]\n                               [--select SELECT | --json-pointer JSON_POINTER]\n                               [--verbose]"
+        "autotouch agents create [-h] [--name NAME] [--target {LEADS,ACCOUNTS}]\n                               [--assigned-user ASSIGNED_USER]\n                               [--schedule-time SCHEDULE_TIME]\n                               [--schedule-tz SCHEDULE_TZ]\n                               [--schedule-frequency {hourly,every_6h,every_12h,daily,weekly}]\n                               [--schedule-days {all,weekdays}]\n                               [--schedule-day-of-week 0-6]\n                               [--schedule-window-start SCHEDULE_WINDOW_START]\n                               [--schedule-window-end SCHEDULE_WINDOW_END]\n                               [--auto-find-email] [--auto-find-phone]\n                               [--auto-broaden]\n                               [--auto-create-lead-mode {qualified_only,everyone,manual_only}]\n                               [--auto-sequence-id AUTO_SEQUENCE_ID]\n                               [--status {DRAFT,ACTIVE,PAUSED}]\n                               [--from-file FROM_FILE] [--generate]\n                               [--base-url BASE_URL] [--token TOKEN]\n                               [--use-x-api-key] [--timeout TIMEOUT]\n                               [--output {json,ndjson,human}] [--compact]\n                               [--select SELECT | --json-pointer JSON_POINTER]\n                               [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -36335,7 +36349,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36508,7 +36523,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents generate-persona [-h] [--target {LEADS}]\n                                         [--current-config CURRENT_CONFIG]\n                                         [--base-url BASE_URL] [--token TOKEN]\n                                         [--use-x-api-key] [--timeout TIMEOUT]\n                                         [--output {json,ndjson,human}]\n                                         [--compact] [--select SELECT |\n                                         --json-pointer JSON_POINTER]\n                                         [--verbose]"
+        "autotouch agents generate-persona [-h] [--target {LEADS,ACCOUNTS}]\n                                         [--current-config CURRENT_CONFIG]\n                                         [--base-url BASE_URL] [--token TOKEN]\n                                         [--use-x-api-key] [--timeout TIMEOUT]\n                                         [--output {json,ndjson,human}]\n                                         [--compact] [--select SELECT |\n                                         --json-pointer JSON_POINTER]\n                                         [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -36534,7 +36549,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36719,7 +36735,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents generate-topics [-h] [--target {LEADS}]\n                                        [--persona PERSONA]\n                                        [--current-topics CURRENT_TOPICS]\n                                        [--base-url BASE_URL] [--token TOKEN]\n                                        [--use-x-api-key] [--timeout TIMEOUT]\n                                        [--output {json,ndjson,human}]\n                                        [--compact] [--select SELECT |\n                                        --json-pointer JSON_POINTER]\n                                        [--verbose]"
+        "autotouch agents generate-topics [-h] [--target {LEADS,ACCOUNTS}]\n                                        [--persona PERSONA]\n                                        [--current-topics CURRENT_TOPICS]\n                                        [--base-url BASE_URL] [--token TOKEN]\n                                        [--use-x-api-key] [--timeout TIMEOUT]\n                                        [--output {json,ndjson,human}]\n                                        [--compact] [--select SELECT |\n                                        --json-pointer JSON_POINTER]\n                                        [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -36745,7 +36761,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36942,7 +36959,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents generate-job-signal [-h] [--target {LEADS}]\n                                            [--persona PERSONA]\n                                            [--current-titles CURRENT_TITLES]\n                                            [--current-keywords CURRENT_KEYWORDS]\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 agents generate-job-signal [-h] [--target {LEADS,ACCOUNTS}]\n                                            [--persona PERSONA]\n                                            [--current-titles CURRENT_TITLES]\n                                            [--current-keywords CURRENT_KEYWORDS]\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.86 → autotouch_cli-0.2.88}/autotouch_cli/templates.py RENAMED Viewed

@@ -51,6 +51,69 @@ COLUMN_RECIPE_ALIASES: Dict[str, Dict[str, Any]] = {
             "Emits the standard Sync to Leads payload. Internal provider/config names remain add_to_crm.",
         ],
     },
+    "sync_to_leads_array": {
+        "canonical": "add_to_crm",
+        "key": "sync_contact_list_to_leads",
+        "label": "Sync Contact List to Leads",
+        "payload": {
+            "key": "sync_contact_list_to_leads",
+            "label": "Sync Contact List to Leads",
+            "kind": "enrichment",
+            "dataType": "json",
+            "origin": "manual",
+            "autoRun": "onSourceUpdate",
+            "config": {
+                "provider": "add_to_crm",
+                "requireCompanyDomain": True,
+                "leadSource": "research_table_export",
+                "fieldMappings": {
+                    "mode": "array",
+                    "sourceColumn": "<CONTACT_LIST_COLUMN_KEY>",
+                    "sourceArrayPath": "contacts",
+                    "common": {
+                        "companyDomain": "domain",
+                        "companyName": "company_name",
+                    },
+                    "template": {
+                        "linkedinUrl": "linkedin_url",
+                        "firstName": "first_name",
+                        "lastName": "last_name",
+                        "title": "title",
+                        "companyName": "company_name",
+                        "companyDomain": "company_domain",
+                        "emailAddresses": [
+                            {"column": "work_email", "type": "work"},
+                            {"column": "email", "type": "work"},
+                        ],
+                        "phoneNumbers": [
+                            {"column": "mobile_phone", "type": "mobile"},
+                            {"column": "phone", "type": "mobile"},
+                        ],
+                    },
+                },
+                "sourceColumns": [
+                    "<CONTACT_LIST_COLUMN_KEY>",
+                    "domain",
+                    "company_name",
+                ],
+            },
+        },
+        "notes": [
+            "Use this when an upstream research column returns a contact/person array such as contacts[], people[], leads[], or items[] and the goal is to write Leads directly.",
+            "Set config.fieldMappings.sourceColumn to the upstream column key, for example key_buyer_leads.",
+            "Set config.fieldMappings.sourceArrayPath to the array path inside that JSON value; use contacts for key_buyer_leads.contacts[] or items for canonical items[].",
+            "Template fields are item-relative: linkedinUrl=linkedin_url reads each array item's linkedin_url.",
+            "Common fields are parent-row mappings used for every item, usually domain/company_name.",
+            "Prefer this over manual row extraction, local JSON files, and rows add/import when writing discovered contacts into Leads CRM.",
+        ],
+    },
+    "add_to_leads_array": {
+        "canonical": "add_to_crm",
+        "alias_of": "sync_to_leads_array",
+        "notes": [
+            "Legacy-friendly alias for sync_to_leads_array.",
+        ],
+    },
 }
 COLUMN_RECIPE_TYPES = tuple(dict.fromkeys([*COLUMN_RECIPE_BASE_TYPES, *COLUMN_RECIPE_ALIASES.keys()]))
 WORKFLOW_BLUEPRINT_TYPES = tuple(sorted(automation_workflow_blueprints().keys()))
@@ -103,11 +166,16 @@ def _build_column_recipe_catalog() -> Tuple[Dict[str, Dict[str, Any]], Dict[str,
             recipes[recipe_type] = payload
         notes[recipe_type] = contract.recipe_notes_list()
     for alias, metadata in COLUMN_RECIPE_ALIASES.items():
+        alias_of = str(metadata.get("alias_of") or "").strip()
+        if alias_of and alias_of in recipes:
+            recipes[alias] = json.loads(json.dumps(recipes[alias_of]))
+            notes[alias] = list(metadata.get("notes") or []) + list(notes.get(alias_of) or [])
+            continue
         canonical = str(metadata.get("canonical") or "").strip()
         canonical_payload = recipes.get(canonical)
         if not isinstance(canonical_payload, dict):
             continue
-        alias_payload = json.loads(json.dumps(canonical_payload))
+        alias_payload = json.loads(json.dumps(metadata.get("payload") or canonical_payload))
         if metadata.get("key"):
             alias_payload["key"] = metadata["key"]
         if metadata.get("label"):

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_cli.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.86
+Version: 0.2.88
 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
@@ -36,6 +36,8 @@ For a shipped human-readable reference generated from the installed parser, use
 ## Install
+Released package:
 ```bash
 pipx install autotouch-cli
 # or
@@ -44,6 +46,16 @@ pip install autotouch-cli
 pip install -U autotouch-cli
 ```
+Unreleased branch or pre-publish build:
+```bash
+pipx install --force "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+# or
+python -m pip install -U "git+ssh://git@github.com/nicolonic/autotouch_main.git@<branch-or-sha>"
+```
+The `autotouch-cli` package name installs the latest published package from the configured package index. Use the git/source install form when testing a version bump before the release tag has published.
 ## First Run
 Existing developer key:
@@ -132,7 +144,7 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 - Inspect rows: `autotouch rows list`, `autotouch rows get`
 - 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`
+- Run Exa Company Search for basic company discovery, competitors, and lookalikes: `autotouch search companies`, `autotouch search similar-companies`
 - 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`
 - Check connected LinkedIn account status/limits: `autotouch linkedin status`, `autotouch linkedin limits`
@@ -146,13 +158,19 @@ autotouch rows get --table-id "$TABLE_ID" --row-id "$ROW_ID" --output json
 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 search companies` for Exa Company Search when the target is basic company discovery, competitors, lookalikes, or a semantic company search. Put company constraints directly in natural language: industry, geography, funding, headcount, technology, founded date, and similarity. Examples: "AI workflow platforms for healthcare", "US education software startups focused on AI math tutoring with 1-50 employees", or "companies like Rippling for HR and workforce management". Exa company search returns up to 100 results per API call and costs 1 credit per 10 returned results.
+Use `autotouch search similar-companies` as a convenience wrapper for Exa Company Search similarity. Prefer `--query` for Exa's documented semantic patterns, such as "companies like Notion", "competitors of Stripe", or "companies working on making space travel cheaper". The older seed fields `company_name`, `company_domain`, and `company_description` remain available when you want the CLI/API to compose that query; it does not use Exa `/findSimilar`.
-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.
+Use `autotouch search people` for provider-hidden people search when the target is niche, semantic, or hard to express with structured filters. People search currently 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 LinkedIn/Sales Navigator 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. User-supplied `keywords` are optional when structured filters are present; use them only to refine, disambiguate, or recover hard-to-classify targets instead of carrying the whole target definition.
-For account-first prospecting, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use neural search as a default pre-step for every list build; use it when the user's target is genuinely semantic or niche.
+For account-first prospecting from LinkedIn/Sales Navigator, build companies/accounts first, inspect the returned company IDs, then pass those IDs to `autotouch list-build leads --current-company-id ...`. Do not use Exa company search as a default pre-step for every LinkedIn list build; use it when the user's target is genuinely semantic, niche, competitor-based, or not meant to be LinkedIn-sourced.
+Use `autotouch agents ...` for recurring signal-based discovery. Scheduled agents support `--target ACCOUNTS` for company/account output and `--target LEADS` for people output. Every agent writes a source/signal table for the evidence it used; lead agents then write `candidate_research.candidates[]` on source rows and list-sync those candidates into the lead/candidate output table. See the agent playbook for the full source-table and candidate-sync contract.
 ## More
@@ -160,7 +178,7 @@ 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.85` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, and the cleaned single LinkedIn-sourced list-build path
+- `autotouch --version` should be `0.2.88` or newer for structured company list builds without user-supplied keywords, stored list-build input lookup, research-workspace list-build guidance, the cleaned single LinkedIn-sourced list-build path, Exa Company Search up to 100 results, and scheduled agent `--target ACCOUNTS|LEADS`
 - `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 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_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_shared/linkedin_contract.py RENAMED Viewed

@@ -63,6 +63,8 @@ _LINKEDIN_CAPABILITIES: Dict[str, Any] = {
         "autotouch linkedin status",
         "autotouch linkedin limits",
         "autotouch list-build inputs",
+        "autotouch list-build inputs --type geo --query 'United States'",
+        "autotouch list-build inputs --type industry --query 'software'",
         "autotouch list-build companies --geo-id 103644278 --industry-id <industry_id> --company-size 1-10 --num-results 100 --wait",
     ],
 }

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_shared/provider_registry.py RENAMED Viewed

@@ -837,16 +837,47 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                     {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
                 ],
             },
+            "array_mode": {
+                "mode": "config.fieldMappings.mode=array",
+                "source_column_field": "config.fieldMappings.sourceColumn",
+                "array_path_field": "config.fieldMappings.sourceArrayPath",
+                "default_array_path": "items",
+                "common_field": "config.fieldMappings.common",
+                "template_field": "config.fieldMappings.template",
+                "template_scope": "item-relative",
+                "recommended_recipe": "autotouch columns recipe --type sync_to_leads_array",
+                "example": {
+                    "sourceColumn": "key_buyer_leads",
+                    "sourceArrayPath": "contacts",
+                    "template": {
+                        "firstName": "first_name",
+                        "lastName": "last_name",
+                        "linkedinUrl": "linkedin_url",
+                    },
+                },
+            },
         },
         composition_contract={
             "consumes": {
                 "kind": "crm_export_inputs",
-                "shape": "mapped source row values including company domain plus hard identity or, in single mode, provisional firstName/lastName fallback; structured source columns use explicit {column, path} mappings to identify the exact field",
+                "shape": "mapped source row values, multi-slot mappings, or array-mode contact/person items from a structured source column; strict mode requires company domain plus hard identity or, in single mode, provisional firstName/lastName fallback",
             },
             "produces": {
                 "kind": "lead_ids",
                 "shape": "lead creation/update result with CRM lead ids stored on the source row",
             },
+            "decision_hints": {
+                "prefer_when": [
+                    "the target output is Leads CRM, not a separate contacts research table",
+                    "an upstream research column already returns contacts[], people[], leads[], or items[]",
+                ],
+                "prefer_sync_to_table_when": [
+                    "you need a destination contacts table for per-contact enrichment, review, export, or sequencing context before CRM sync",
+                ],
+                "avoid": [
+                    "manual rows list -> local JSON transform -> rows add/import for contacts produced by an upstream column",
+                ],
+            },
             "common_next_steps": [
                 "add_to_sequence using the column key that stores those lead IDs",
             ],

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/autotouch_shared/search_contract.py RENAMED Viewed

@@ -1,4 +1,4 @@
-"""Shared provider-hidden search contract for API capabilities, CLI recipes, and docs."""
+"""Shared search contract for Exa company search, people search, and related API capabilities."""
 from __future__ import annotations
@@ -15,8 +15,8 @@ _SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
         "path": "/api/search/companies",
         "required_scope": SEARCH_SCOPE,
         "body": {
-            "query": "required free-text company search query",
-            "limit": "optional 1-10 (default 10)",
+            "query": "required Exa Company Search natural-language query; include industry, geography, funding, headcount, technology, and similarity constraints in the query",
+            "limit": "optional 1-100 (default 10)",
         },
         "response": {"items_field": "items", "item_type": "company"},
     },
@@ -38,10 +38,11 @@ _SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
         "path": "/api/search/similar-companies",
         "required_scope": SEARCH_SCOPE,
         "body": {
-            "company_name": "required seed company name",
-            "company_domain": "optional official company domain",
-            "company_description": "optional short semantic description to improve peer matching",
-            "limit": "optional 1-10 (default 10)",
+            "query": "optional Exa Company Search semantic similarity query; use this for direct Exa query patterns like 'companies like Notion' or 'competitors of Stripe'",
+            "company_name": "optional seed company name used when query is omitted",
+            "company_domain": "optional official company domain used to disambiguate the seed in the Exa Company Search query",
+            "company_description": "optional semantic description appended to the Exa Company Search query",
+            "limit": "optional 1-100 (default 10)",
         },
         "response": {"items_field": "items", "item_type": "company"},
     },
@@ -108,13 +109,14 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
         "use_company_search_when": [
             "you need to discover target accounts before looking for contacts",
             "the search criteria are market, product, or industry driven",
+            "the user wants basic company discovery, competitors, lookalikes, or a semantic company search",
         ],
         "use_people_search_when": [
             "you already know the target companies",
             "the search criteria are role, persona, or skill driven",
         ],
         "use_list_build_instead_when": [
-            "the user wants a LinkedIn-sourced company or lead list",
+            "the user wants a LinkedIn/Sales Navigator-sourced company or lead list",
             "the search can be expressed with geography, industry, company size, title, or current-company filters",
             "the desired output is a durable background job with status/results",
         ],
@@ -122,9 +124,9 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
     "pricing": {
         "charge_on": "api_call_or_actual_results_returned",
         "families": {
-            "companies": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
+            "companies": {"credits_per_bucket": 1, "bucket_size": 10, "max_results_per_call": 100, "rule": "1 credit per 10 returned Exa company results"},
             "people": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
-            "similar_companies": {"credits_per_call": 1, "max_results_per_call": 10, "rule": "1 credit per neural search API call"},
+            "similar_companies": {"credits_per_bucket": 1, "bucket_size": 10, "max_results_per_call": 100, "rule": "1 credit per 10 returned Exa company results"},
             "news": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
             "local_businesses": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
             "reviews": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
@@ -132,8 +134,9 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
         },
     },
     "recommended_cli": [
-        "autotouch search companies --query 'remote IT asset management' --limit 25",
-        "autotouch search people --query 'VP IT' --company 'Rippling' --limit 25",
+        "autotouch search companies --query 'remote IT asset management companies in the US with 50-200 employees' --limit 100",
+        "autotouch search companies --query 'companies like Rippling in HR software, based in the United States, with 50-500 employees' --limit 100",
+        "autotouch search people --query 'VP IT' --company 'Rippling' --limit 10",
         "autotouch search recipe --type companies --out-file companies.json",
     ],
 }
@@ -141,11 +144,12 @@ _SEARCH_CAPABILITIES: Dict[str, Any] = {
 _SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
     "companies": {
-        "payload": {"query": "remote IT asset management", "limit": 10},
+        "payload": {"query": "remote IT asset management companies in the US with 50-200 employees", "limit": 100},
         "usage": "autotouch search companies --data-file <payload.json>",
         "notes": [
-            "Use this when you need to discover target accounts first.",
-            "Pricing: 1 credit per neural search API call. Max 10 returned companies per call.",
+            "Use this for basic Exa Company Search: company discovery, competitors, lookalikes, and semantic market scans.",
+            "Put Exa company constraints in natural language: industry, geography, funding, headcount, technology, founded date, and similarity.",
+            "Pricing: 1 credit per 10 returned Exa company results. Max 100 returned companies per call.",
         ],
     },
     "people": {
@@ -164,16 +168,15 @@ _SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
     },
     "similar_companies": {
         "payload": {
-            "company_name": "Rippling",
-            "company_domain": "rippling.com",
-            "company_description": "Workforce management and HR software platform for businesses",
-            "limit": 10,
+            "query": "companies like Rippling for workforce management, HR, payroll, IT, benefits, devices, and app access",
+            "limit": 100,
         },
         "usage": "autotouch search similar-companies --data-file <payload.json>",
         "notes": [
-            "Good for expanding a seed account list.",
-            "Best results come from providing company_domain and a short company_description when known.",
-            "Pricing: 1 credit per neural search API call. Max 10 returned companies per call.",
+            "Convenience wrapper for Exa Company Search similarity queries, not Exa /findSimilar.",
+            "Prefer query for Exa's documented semantic patterns: companies like X, competitors of X, or companies working on Y.",
+            "Seed fields company_name, company_domain, and company_description remain available when you want the CLI/API to compose the query.",
+            "Pricing: 1 credit per 10 returned Exa company results. Max 100 returned companies per call.",
         ],
     },
     "news": {

{autotouch_cli-0.2.86 → autotouch_cli-0.2.88}/pyproject.toml RENAMED Viewed

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