autotouch-cli 0.2.87__tar.gz → 0.2.88__tar.gz

{autotouch_cli-0.2.87 → autotouch_cli-0.2.88}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.87
+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:
@@ -158,13 +170,15 @@ For structured company builds, start with industry IDs plus geo/company-size fil
 
 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
 
 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.87` 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, and Exa Company Search up to 100 results
+- `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.87 → autotouch_cli-0.2.88}/README.md

@@ -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:
@@ -133,13 +145,15 @@ For structured company builds, start with industry IDs plus geo/company-size fil
 
 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
 
 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.87` 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, and Exa Company Search up to 100 results
+- `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.87 → autotouch_cli-0.2.88}/autotouch_cli/commands/agents.py

@@ -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.87 → autotouch_cli-0.2.88}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.87`.
+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)

{autotouch_cli-0.2.87 → autotouch_cli-0.2.88}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.87",
+  "version": "0.2.88",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -34796,7 +34796,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "flags": [
             "--target"
@@ -35176,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"
@@ -36348,7 +36349,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36521,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"
@@ -36547,7 +36549,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36732,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"
@@ -36758,7 +36761,8 @@
           "kind": "string",
           "action": "store",
           "choices": [
-            "LEADS"
+            "LEADS",
+            "ACCOUNTS"
           ],
           "default_when_omitted": "LEADS",
           "default": "LEADS",
@@ -36955,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.87 → autotouch_cli-0.2.88}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.87
+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:
@@ -158,13 +170,15 @@ For structured company builds, start with industry IDs plus geo/company-size fil
 
 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
 
 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.87` 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, and Exa Company Search up to 100 results
+- `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.87 → autotouch_cli-0.2.88}/pyproject.toml

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