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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.87
+Version: 0.2.90
 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.90` 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, scheduled agent `--target ACCOUNTS|LEADS`, paced HTTP Request column contracts, and V2 sequence flowGraph recipes
 - `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.90}/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.90` 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, scheduled agent `--target ACCOUNTS|LEADS`, paced HTTP Request column contracts, and V2 sequence flowGraph recipes
 - `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.90}/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.90}/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.90`.
 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.90}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.87",
+  "version": "0.2.90",
   "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.90}/autotouch_cli/templates.py

@@ -199,7 +199,7 @@ SEQUENCE_RECIPE_TYPES = [
 
 SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
     "create": {
-        "name": "Outbound v1",
+        "name": "Outbound flow",
         "sourceTableId": "<TABLE_ID>",
         "sourceTableName": "ICP Prospects",
         "exitRules": {
@@ -243,20 +243,37 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "aiDraft": True,
                 "scriptTemplate": "",
             },
-            {
-                "id": "linkedin_1",
-                "kind": "LINKEDIN_CHAT_MESSAGE",
-                "waitDays": 2,
-                "waitHours": 0,
-                "waitMinutes": 0,
-                "executionMode": "AUTOMATED",
-                "aiDraft": True,
-                "scriptTemplate": "",
-            },
         ],
+        "flowGraph": {
+            "version": 1,
+            "nodes": [
+                {
+                    "id": "step:email_1",
+                    "kind": "action",
+                    "title": "Send email",
+                    "sourceStepId": "email_1",
+                    "position": {"x": 0, "y": 0},
+                },
+                {
+                    "id": "step:call_1",
+                    "kind": "action",
+                    "title": "Call",
+                    "sourceStepId": "call_1",
+                    "position": {"x": 0, "y": 160},
+                },
+            ],
+            "edges": [
+                {
+                    "id": "edge:email_1:call_1",
+                    "source": "step:email_1",
+                    "target": "step:call_1",
+                    "kind": "next",
+                },
+            ],
+        },
     },
     "bulk_automated": {
-        "name": "Bulk outbound v1",
+        "name": "Bulk outbound flow",
         "sourceTableId": "<TABLE_ID>",
         "sourceTableName": "ICP Prospects",
         "exitRules": {
@@ -302,9 +319,36 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "bodyTemplate": "Hi {{first_name}}, circling back on this.",
             },
         ],
+        "flowGraph": {
+            "version": 1,
+            "nodes": [
+                {
+                    "id": "step:email_1",
+                    "kind": "action",
+                    "title": "Send first email",
+                    "sourceStepId": "email_1",
+                    "position": {"x": 0, "y": 0},
+                },
+                {
+                    "id": "step:email_2",
+                    "kind": "action",
+                    "title": "Follow-up email",
+                    "sourceStepId": "email_2",
+                    "position": {"x": 0, "y": 160},
+                },
+            ],
+            "edges": [
+                {
+                    "id": "edge:email_1:email_2",
+                    "source": "step:email_1",
+                    "target": "step:email_2",
+                    "kind": "next",
+                },
+            ],
+        },
     },
     "linkedin_outreach": {
-        "name": "LinkedIn outreach v1",
+        "name": "LinkedIn outreach flow",
         "sourceTableId": "<TABLE_ID>",
         "sourceTableName": "ICP Prospects",
         "exitRules": {
@@ -342,10 +386,24 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "aiDraft": True,
                 "scriptTemplate": "",
             },
+            {
+                "id": "email_fallback_1",
+                "kind": "EMAIL",
+                "waitDays": 0,
+                "waitHours": 0,
+                "waitMinutes": 0,
+                "executionMode": "AUTOMATED",
+                "emailSendMode": "AUTOMATED",
+                "emailIsReply": False,
+                "appendSignature": True,
+                "aiDraft": True,
+                "subjectTemplate": "",
+                "bodyTemplate": "",
+            },
             {
                 "id": "message_1",
                 "kind": "LINKEDIN_CHAT_MESSAGE",
-                "waitDays": 2,
+                "waitDays": 0,
                 "waitHours": 0,
                 "waitMinutes": 0,
                 "executionMode": "AUTOMATED",
@@ -353,6 +411,110 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "scriptTemplate": "",
             },
         ],
+        "flowGraph": {
+            "version": 1,
+            "nodes": [
+                {
+                    "id": "step:visit_1",
+                    "kind": "action",
+                    "title": "Visit profile",
+                    "sourceStepId": "visit_1",
+                    "position": {"x": 0, "y": 0},
+                },
+                {
+                    "id": "step:connect_1",
+                    "kind": "action",
+                    "title": "Connect",
+                    "sourceStepId": "connect_1",
+                    "position": {"x": 0, "y": 160},
+                },
+                {
+                    "id": "condition:connect_1:accepted",
+                    "kind": "condition",
+                    "title": "Wait for connection accepted",
+                    "parentNodeId": "step:connect_1",
+                    "metadata": {
+                        "decisionType": "outcome_wait",
+                        "listenFor": "linkedin_connection_accepted",
+                        "waitMode": "up_to",
+                        "waitDays": 7,
+                        "waitHours": 0,
+                        "waitMinutes": 0,
+                    },
+                    "position": {"x": 0, "y": 320},
+                },
+                {
+                    "id": "branch:connect_1:accepted",
+                    "kind": "branch",
+                    "branchId": "connected",
+                    "title": "Connected",
+                    "parentNodeId": "condition:connect_1:accepted",
+                    "position": {"x": -180, "y": 480},
+                },
+                {
+                    "id": "branch:connect_1:timeout",
+                    "kind": "branch",
+                    "branchId": "not-connected",
+                    "title": "Not connected after 7 days",
+                    "parentNodeId": "condition:connect_1:accepted",
+                    "position": {"x": 180, "y": 480},
+                },
+                {
+                    "id": "step:message_1",
+                    "kind": "action",
+                    "title": "LinkedIn message",
+                    "parentNodeId": "branch:connect_1:accepted",
+                    "sourceStepId": "message_1",
+                    "position": {"x": -180, "y": 640},
+                },
+                {
+                    "id": "step:email_fallback_1",
+                    "kind": "action",
+                    "title": "Fallback email",
+                    "parentNodeId": "branch:connect_1:timeout",
+                    "sourceStepId": "email_fallback_1",
+                    "position": {"x": 180, "y": 640},
+                },
+            ],
+            "edges": [
+                {
+                    "id": "edge:visit_1:connect_1",
+                    "source": "step:visit_1",
+                    "target": "step:connect_1",
+                    "kind": "next",
+                },
+                {
+                    "id": "edge:connect_1:accepted_condition",
+                    "source": "step:connect_1",
+                    "target": "condition:connect_1:accepted",
+                    "kind": "condition",
+                },
+                {
+                    "id": "edge:accepted_condition:connected",
+                    "source": "condition:connect_1:accepted",
+                    "target": "branch:connect_1:accepted",
+                    "kind": "branch",
+                },
+                {
+                    "id": "edge:accepted_condition:timeout",
+                    "source": "condition:connect_1:accepted",
+                    "target": "branch:connect_1:timeout",
+                    "kind": "branch",
+                },
+                {
+                    "id": "edge:connected:message_1",
+                    "source": "branch:connect_1:accepted",
+                    "target": "step:message_1",
+                    "kind": "branch",
+                },
+                {
+                    "id": "edge:timeout:email_fallback_1",
+                    "source": "branch:connect_1:timeout",
+                    "target": "step:email_fallback_1",
+                    "kind": "branch",
+                },
+            ],
+        },
     },
     "enroll": {
         "leadIds": ["<LEAD_ID_1>", "<LEAD_ID_2>"],
@@ -365,25 +527,28 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
 
 SEQUENCE_RECIPE_NOTES: Dict[str, List[str]] = {
     "create": [
-        "Recommended default: personal delivery plus AUTOMATED email with aiDraft=true.",
+        "Recommended default: V2 flowGraph with personal delivery plus AUTOMATED email with aiDraft=true.",
+        "flowGraph.version=1 is the executable authoring layer; keep steps aligned with graph action sourceStepId values.",
         "AI draft generates subject + body at execution time.",
-        "AI draft for LinkedIn message generates message copy; AI draft for call generates a call script.",
+        "AI draft for call generates a call script.",
         "External sequence create/update requires sourceTableId.",
         "Pass --actor-user-id on mutating commands when you need explicit actor resolution.",
     ],
     "bulk_automated": [
+        "Emits a V2 flowGraph with two automated email actions.",
         "Use this when the provider should send email automatically at scale.",
         "Bulk delivery sequences cannot contain MANUAL email steps, so aiDraft does not apply to those email steps.",
         "Activate only after provider readiness is configured (autotouch sequences delivery-status).",
     ],
     "linkedin_outreach": [
-        "LinkedIn outreach sequence: visit profile, connect, then message.",
+        "Emits a V2 flowGraph: visit profile, connect, wait for accepted connection, then branch to LinkedIn message or fallback email.",
         "Supported step kinds: LINKEDIN_VISIT_PROFILE, LINKEDIN_CONNECT, LINKEDIN_CHAT_MESSAGE, LINKEDIN_VOICE_MESSAGE.",
         "LINKEDIN_VISIT_PROFILE is always AUTOMATED and visits the lead's profile (notifies by default).",
         "LINKEDIN_CONNECT sends a connection request; scriptTemplate is the invite note (max 300 chars).",
         "LINKEDIN_CHAT_MESSAGE sends a direct message; uses InMail credits for 2nd/3rd degree connections.",
         "LINKEDIN_VOICE_MESSAGE sends a voice note; only works for 1st degree connections.",
         "Connection degree (1st/2nd/3rd/out_of_network) is auto-detected from the LinkedIn profile.",
+        "The connected branch is explicit in flowGraph; the fallback email branch is explicit and does not happen silently.",
         "Set stopOnLinkedInReply=true in exitRules to stop the sequence when the lead replies on LinkedIn.",
         "Leads must have a linkedin_url field to be reachable for LinkedIn steps.",
     ],
@@ -1787,6 +1952,7 @@ def emit_sequences_recipe(args: argparse.Namespace, runtime: TemplateRuntime) ->
         usage_lookup={
             "create": "autotouch sequences create --data-file <payload.json>",
             "bulk_automated": "autotouch sequences create --data-file <payload.json>",
+            "linkedin_outreach": "autotouch sequences create --data-file <payload.json>",
             "enroll": "autotouch sequences enroll --sequence-id <SEQUENCE_ID> --data-file <payload.json>",
         },
         label="recipe",

{autotouch_cli-0.2.87 → autotouch_cli-0.2.90}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.87
+Version: 0.2.90
 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.90` 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, scheduled agent `--target ACCOUNTS|LEADS`, paced HTTP Request column contracts, and V2 sequence flowGraph recipes
 - `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.90}/autotouch_shared/provider_registry.py

@@ -1089,12 +1089,20 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                 "headers": {},
                 "body": None,
                 "timeoutSeconds": 30,
+                "rateLimit": {
+                    "enabled": False,
+                    "minDelayMs": 5000,
+                    "jitterMs": 1000,
+                    "maxConcurrency": 1,
+                    "scope": "credential",
+                },
             },
         },
         recipe_notes=(
             "Use {{column_key}} placeholders in config.url, config.headers, and config.body to reference row values.",
             "Use {{secrets.name}} to resolve a workspace secret by name.",
             "body can be null, a string template, or an object whose values are templated and sent as JSON.",
+            "Set config.rateLimit.enabled=true for paced background execution. The current safe mode is maxConcurrency=1 with minDelayMs/jitterMs spacing, coordinated across workers by organization, host, and scope.",
             "The stored cell value is the parsed response body (JSON or text), not the full transport envelope.",
             "Preview the resolved request with `autotouch columns test-http-request --table-id <TABLE_ID> --data-file column.json` before creating or running the column.",
         ),
@@ -1123,6 +1131,15 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "headers_field": "config.headers",
             "body_field": "config.body",
             "timeout_field": "config.timeoutSeconds",
+            "rate_limit": {
+                "field": "config.rateLimit",
+                "enabled": "optional boolean",
+                "minDelayMs": "optional integer milliseconds between worker requests",
+                "jitterMs": "optional integer random extra delay in milliseconds",
+                "maxConcurrency": "currently only 1 is supported for strict serialized pacing",
+                "scope": "credential | host | column",
+                "credential_scope": "organization + resolved host + referenced {{secrets.name}} names; falls back to column id when no secrets are referenced",
+            },
             "supported_methods": list(_HTTP_REQUEST_METHODS),
             "template_syntax": {
                 "row_values": "{{column_key}}",
@@ -1564,6 +1581,34 @@ def validate_column_provider_contract(
                 "http_request config.body must be null, a string, or an object.",
                 hint="Use a string body template or a JSON object whose values contain {{column_key}} placeholders.",
             )
+        rate_limit = cfg.get("rateLimit") or cfg.get("rate_limit")
+        if rate_limit is not None:
+            if not isinstance(rate_limit, dict):
+                raise ProviderContractValidationError(
+                    "invalid_field",
+                    "http_request config.rateLimit must be an object when provided.",
+                    hint="Use {\"enabled\": true, \"minDelayMs\": 5000, \"jitterMs\": 1000, \"maxConcurrency\": 1, \"scope\": \"credential\"}.",
+                )
+            max_concurrency = rate_limit.get("maxConcurrency", rate_limit.get("max_concurrency", 1))
+            try:
+                parsed_max_concurrency = int(float(max_concurrency))
+            except (TypeError, ValueError):
+                parsed_max_concurrency = 1
+            if parsed_max_concurrency != 1:
+                raise ProviderContractValidationError(
+                    "invalid_field",
+                    "http_request config.rateLimit.maxConcurrency currently supports only 1.",
+                    hint="Use maxConcurrency: 1 for serialized paced requests.",
+                    detail={"maxConcurrency": max_concurrency},
+                )
+            scope = str(rate_limit.get("scope") or "credential").strip().lower()
+            if scope not in {"credential", "host", "column"}:
+                raise ProviderContractValidationError(
+                    "invalid_field",
+                    "http_request config.rateLimit.scope must be credential, host, or column.",
+                    hint="Use scope: \"credential\" for API keys, cookies, and session-backed providers.",
+                    detail={"scope": rate_limit.get("scope")},
+                )
         return contract
 
     return contract

{autotouch_cli-0.2.87 → autotouch_cli-0.2.90}/pyproject.toml

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