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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.88
+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
@@ -178,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.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 --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.88 → autotouch_cli-0.2.90}/README.md

@@ -153,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.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 --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.88 → 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.88`.
+Generated from the installed parser for `autotouch-cli` `0.2.90`.
 Manifest schema version: `2`.
 
 ## Output Modes

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

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

{autotouch_cli-0.2.88 → 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.88 → 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.88
+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
@@ -178,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.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 --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.88 → 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.88 → autotouch_cli-0.2.90}/pyproject.toml

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