autotouch-cli 0.2.92__tar.gz → 0.2.94__tar.gz

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.92
+Version: 0.2.94
 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.92` 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, V2 sequence flowGraph recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
+- `autotouch --version` should be `0.2.94` 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, branch-aware LinkedIn sequence recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
 - `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.92 → autotouch_cli-0.2.94}/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.92` 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, V2 sequence flowGraph recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
+- `autotouch --version` should be `0.2.94` 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, branch-aware LinkedIn sequence recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
 - `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.92 → autotouch_cli-0.2.94}/autotouch_cli/cli.py

@@ -141,6 +141,7 @@ from autotouch_cli.commands.agents import (
     cmd_agents_get as cmd_agents_get_impl,
     cmd_agents_create as cmd_agents_create_impl,
     cmd_agents_update as cmd_agents_update_impl,
+    cmd_agents_diff as cmd_agents_diff_impl,
     cmd_agents_delete as cmd_agents_delete_impl,
     cmd_agents_run as cmd_agents_run_impl,
     cmd_agents_runs as cmd_agents_runs_impl,
@@ -1478,6 +1479,7 @@ _register("agents_list", cmd_agents_list_impl, _agent_command_runtime)
 _register("agents_get", cmd_agents_get_impl, _agent_command_runtime)
 _register("agents_create", cmd_agents_create_impl, _agent_command_runtime)
 _register("agents_update", cmd_agents_update_impl, _agent_command_runtime)
+_register("agents_diff", cmd_agents_diff_impl, _agent_command_runtime)
 _register("agents_delete", cmd_agents_delete_impl, _agent_command_runtime)
 _register("agents_run", cmd_agents_run_impl, _agent_command_runtime)
 _register("agents_runs", cmd_agents_runs_impl, _agent_command_runtime)

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/commands/agents.py

@@ -3,17 +3,32 @@
 from __future__ import annotations
 
 import argparse
+import difflib
 import json
 import sys
 import time
 from dataclasses import dataclass
-from typing import Any, Callable, Dict, Optional, Sequence
+from typing import Any, Callable, Dict, List, Optional, Sequence
 
 from autotouch_cli.exceptions import AutotouchInputError
 
 
 AGENT_TARGET_CHOICES = ["LEADS", "ACCOUNTS"]
 
+AGENT_READ_ONLY_FIELDS = {
+    "id",
+    "configVersion",
+    "createdAt",
+    "updatedAt",
+    "nextRunAt",
+    "lastRunAt",
+    "sourceTableName",
+    "outputTableName",
+    "leadCounts",
+    "outputCounts",
+    "qualifiedColumnId",
+}
+
 
 @dataclass(frozen=True)
 class AgentCommandRuntime:
@@ -29,6 +44,76 @@ class AgentCommandRuntime:
 # CRUD
 # ---------------------------------------------------------------------------
 
+def _write_json_file(path: str, data: Any) -> None:
+    with open(path, "w", encoding="utf-8") as handle:
+        json.dump(data, handle, indent=2, ensure_ascii=False)
+        handle.write("\n")
+
+
+def _editable_agent_payload(agent: Dict[str, Any]) -> Dict[str, Any]:
+    return {key: value for key, value in agent.items() if key not in AGENT_READ_ONLY_FIELDS}
+
+
+def _json_lines(data: Any) -> List[str]:
+    return json.dumps(data, indent=2, sort_keys=True, ensure_ascii=False).splitlines()
+
+
+def _diff_payload(current: Dict[str, Any], patch: Dict[str, Any]) -> Dict[str, Any]:
+    before = {key: current.get(key) for key in patch.keys()}
+    after = dict(before)
+    after.update(patch)
+    changes = [
+        {"field": key, "before": before.get(key), "after": after.get(key)}
+        for key in sorted(patch.keys())
+        if before.get(key) != after.get(key)
+    ]
+    unified_diff = "\n".join(
+        difflib.unified_diff(
+            _json_lines(before),
+            _json_lines(after),
+            fromfile="current",
+            tofile="proposed",
+            lineterm="",
+        )
+    )
+    return {"changed": bool(changes), "changes": changes, "diff": unified_diff}
+
+
+def _diff_from_agents(current: Dict[str, Any], proposed: Dict[str, Any], fields: Sequence[str]) -> Dict[str, Any]:
+    before = {key: current.get(key) for key in fields}
+    after = {key: proposed.get(key) for key in fields}
+    changes = [
+        {"field": key, "before": before.get(key), "after": after.get(key)}
+        for key in sorted(fields)
+        if before.get(key) != after.get(key)
+    ]
+    unified_diff = "\n".join(
+        difflib.unified_diff(
+            _json_lines(before),
+            _json_lines(after),
+            fromfile="current",
+            tofile="proposed",
+            lineterm="",
+        )
+    )
+    return {"changed": bool(changes), "changes": changes, "diff": unified_diff}
+
+
+def _validate_update_remote(args: argparse.Namespace, payload: Dict[str, Any], *, runtime: AgentCommandRuntime, token: Optional[str]) -> Dict[str, Any]:
+    data = runtime.request_api(
+        "POST", f"/api/agents/{args.agent_id}/validate-update",
+        base_url=args.base_url, token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout, verbose=args.verbose,
+    )
+    if not isinstance(data, dict):
+        raise AutotouchInputError("agent update validation response must be a JSON object")
+    fields = data.get("changedFields") or []
+    if isinstance(fields, list) and isinstance(data.get("currentAgent"), dict) and isinstance(data.get("agent"), dict):
+        data.update(_diff_from_agents(data["currentAgent"], data["agent"], [str(field) for field in fields]))
+    return data
+
 def cmd_agents_list(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
     token = runtime.resolve_token(args.token, required=True)
     data = runtime.request_api(
@@ -48,6 +133,10 @@ def cmd_agents_get(args: argparse.Namespace, *, runtime: AgentCommandRuntime) ->
         use_x_api_key=args.use_x_api_key,
         timeout=args.timeout, verbose=args.verbose,
     )
+    out_file = getattr(args, "out_file", None)
+    if out_file:
+        payload = _editable_agent_payload(data if isinstance(data, dict) else {})
+        _write_json_file(out_file, payload)
     runtime.print_json(data, args.compact)
 
 
@@ -258,6 +347,14 @@ def cmd_agents_update(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
                     merged_schedule[key] = value
             payload["schedule"] = merged_schedule
 
+    if getattr(args, "dry_run", False):
+        data = _validate_update_remote(args, payload, runtime=runtime, token=token)
+        data.setdefault("dryRun", True)
+        data.setdefault("patch", payload)
+        data.setdefault("next", "Run again without --dry-run to apply this patch.")
+        runtime.print_json(data, args.compact)
+        return
+
     data = runtime.request_api(
         "PATCH", f"/api/agents/{args.agent_id}",
         base_url=args.base_url, token=token,
@@ -268,6 +365,22 @@ def cmd_agents_update(args: argparse.Namespace, *, runtime: AgentCommandRuntime)
     runtime.print_json(data, args.compact)
 
 
+def cmd_agents_diff(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    patch = runtime.load_json_input(
+        inline_json=None,
+        file_path=args.from_file,
+        context="agent patch",
+        default={},
+    )
+    if not isinstance(patch, dict):
+        raise AutotouchInputError("agent patch must be a JSON object")
+    result = _validate_update_remote(args, patch, runtime=runtime, token=token)
+    result.setdefault("agentId", args.agent_id)
+    result.setdefault("patch", patch)
+    runtime.print_json(result, args.compact)
+
+
 def cmd_agents_delete(args: argparse.Namespace, *, runtime: AgentCommandRuntime) -> None:
     delete_associated_tables = bool(getattr(args, "delete_associated_tables", False))
     if delete_associated_tables and not bool(getattr(args, "yes", False)):
@@ -465,6 +578,7 @@ def register_agents_subcommands(
     # -- get --
     pag = agents_sub.add_parser("get", help="Get one agent by id")
     pag.add_argument("agent_id", help="Agent ID")
+    pag.add_argument("--out-file", dest="out_file", help="Write editable agent config JSON to file")
     add_api_common_arguments(pag)
     pag.set_defaults(func=handlers["get"])
 
@@ -577,9 +691,17 @@ def register_agents_subcommands(
         help="Active-hours window end (HH:MM) — used by hourly/every_6h/every_12h",
     )
     pau.add_argument("--from-file", dest="from_file", help="Path to JSON patch payload file")
+    pau.add_argument("--dry-run", action="store_true", help="Preview the patch and diff without applying it")
     add_api_common_arguments(pau)
     pau.set_defaults(func=handlers["update"])
 
+    # -- diff --
+    padiff = agents_sub.add_parser("diff", help="Preview changes from a JSON patch without applying them")
+    padiff.add_argument("agent_id", help="Agent ID")
+    padiff.add_argument("--from-file", dest="from_file", required=True, help="Path to JSON patch payload file")
+    add_api_common_arguments(padiff)
+    padiff.set_defaults(func=handlers["diff"])
+
     # -- delete --
     pad = agents_sub.add_parser("delete", help="Soft-delete an agent and detach its associated tables")
     pad.add_argument("agent_id", help="Agent ID")

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/commands/sequences.py

@@ -77,6 +77,71 @@ def _attach_sequence_enroll_hints(output: Dict[str, Any], payload: Dict[str, Any
     return enriched
 
 
+def _sequence_shape(sequence: Dict[str, Any]) -> Dict[str, Any]:
+    steps = sequence.get("steps") if isinstance(sequence.get("steps"), list) else []
+    flow_graph = sequence.get("flowGraph") if isinstance(sequence.get("flowGraph"), dict) else {}
+    nodes = flow_graph.get("nodes") if isinstance(flow_graph.get("nodes"), list) else []
+    edges = flow_graph.get("edges") if isinstance(flow_graph.get("edges"), list) else []
+    return {
+        "step_count": len(steps),
+        "step_kinds": [str((step or {}).get("kind") or "") for step in steps if isinstance(step, dict)],
+        "flow_graph_present": bool(flow_graph),
+        "flow_graph_node_count": len(nodes),
+        "flow_graph_edge_count": len(edges),
+        "has_branching": any(str((node or {}).get("kind") or "").lower() in {"condition", "branch"} for node in nodes if isinstance(node, dict)),
+    }
+
+
+def _fetch_sequence_readback(
+    sequence_id: str,
+    args: argparse.Namespace,
+    *,
+    runtime: SequenceCommandRuntime,
+    token: Optional[str],
+) -> Optional[Dict[str, Any]]:
+    if not sequence_id:
+        return None
+    data = runtime.request_api(
+        "GET",
+        f"/api/sequences/{sequence_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    return data if isinstance(data, dict) else None
+
+
+def _sequence_mutation_output(
+    mutation_result: Dict[str, Any],
+    args: argparse.Namespace,
+    *,
+    runtime: SequenceCommandRuntime,
+    token: Optional[str],
+    submitted_payload: Optional[Dict[str, Any]] = None,
+    sequence_id: Optional[str] = None,
+) -> Dict[str, Any]:
+    output = dict(mutation_result)
+    submitted_shape = _sequence_shape(submitted_payload) if isinstance(submitted_payload, dict) else None
+    if submitted_shape:
+        output["submitted_shape"] = submitted_shape
+    readback_id = str(sequence_id or output.get("id") or output.get("sequenceId") or "").strip()
+    readback = _fetch_sequence_readback(readback_id, args, runtime=runtime, token=token)
+    if readback:
+        readback_shape = _sequence_shape(readback)
+        output["sequence"] = readback
+        output["verified_readback"] = True
+        output["readback_shape"] = readback_shape
+        if submitted_shape:
+            output["readback_shape_matches_submitted"] = readback_shape == submitted_shape
+        output["verification_hint"] = "This output includes the sequence as saved by the API; summarize this readback, not only the submitted payload."
+    else:
+        output["verified_readback"] = False
+        output["verification_hint"] = "Could not read back the saved sequence; verify with `autotouch sequences get --sequence-id <id>` before summarizing."
+    return output
+
+
 def _sequence_mutation_params(args: argparse.Namespace) -> Optional[Dict[str, Any]]:
     return sequence_mutation_params_impl(args)
 
@@ -181,6 +246,8 @@ def cmd_sequences_create(args: argparse.Namespace, *, runtime: SequenceCommandRu
         timeout=args.timeout,
         verbose=args.verbose,
     )
+    if isinstance(data, dict):
+        data = _sequence_mutation_output(data, args, runtime=runtime, token=token, submitted_payload=payload)
     runtime.print_json(data, args.compact)
 
 
@@ -230,6 +297,8 @@ def cmd_sequences_update(args: argparse.Namespace, *, runtime: SequenceCommandRu
                 )
                 raise AutotouchAPIError(message, status_code=exc.status_code, response_body=exc.response_body) from exc
         raise
+    if isinstance(data, dict):
+        data = _sequence_mutation_output(data, args, runtime=runtime, token=token, submitted_payload=payload, sequence_id=args.sequence_id)
     runtime.print_json(data, args.compact)
 
 

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.92`.
+Generated from the installed parser for `autotouch-cli` `0.2.94`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -20,10 +20,10 @@ Scheduled agent management
 - Auth: `varies_by_subcommand`
 - Stability: `stable`
 - Destructive: `no`
-- Subcommands: `list, get, create, update, delete, run, runs, watch, generate-persona, generate-topics, generate-job-signal, signals`
+- Subcommands: `list, get, create, update, diff, delete, run, runs, watch, generate-persona, generate-topics, generate-job-signal, signals`
 - Example:
   - `autotouch agents [-h]
-                        {list,get,create,update,delete,run,runs,watch,generate-persona,generate-topics,generate-job-signal,signals} ...`
+                        {list,get,create,update,diff,delete,run,runs,watch,generate-persona,generate-topics,generate-job-signal,signals} ...`
 
 #### `autotouch agents create`
 
@@ -112,6 +112,35 @@ Soft-delete an agent and detach its associated tables
   - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
   - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
 
+#### `autotouch agents diff`
+
+Preview changes from a JSON patch without applying them
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--from-file`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch agents diff [-h] --from-file FROM_FILE [--base-url BASE_URL]
+                             [--token TOKEN] [--use-x-api-key]
+                             [--timeout TIMEOUT]
+                             [--output {json,ndjson,human}] [--compact]
+                             [--select SELECT | --json-pointer JSON_POINTER]
+                             [--verbose]
+                             agent_id`
+- Options:
+  - `--from-file` (required; kind=file; input=file): Path to JSON patch payload file
+  - `--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
+  - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
+  - `--timeout` (kind=integer; default=30): HTTP timeout in seconds
+  - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
+  - `--select` (kind=string): Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer` (kind=string): Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (kind=boolean; when omitted=False; when present=True): Print request metadata to stderr
+
 #### `autotouch agents generate-job-signal`
 
 Generate job signal config via AI
@@ -218,13 +247,14 @@ Get one agent by id
 - Destructive: `no`
 - Output modes: `json, ndjson, human`
 - Example:
-  - `autotouch agents get [-h] [--base-url BASE_URL] [--token TOKEN]
-                            [--use-x-api-key] [--timeout TIMEOUT]
-                            [--output {json,ndjson,human}] [--compact]
-                            [--select SELECT | --json-pointer JSON_POINTER]
-                            [--verbose]
+  - `autotouch agents get [-h] [--out-file OUT_FILE] [--base-url BASE_URL]
+                            [--token TOKEN] [--use-x-api-key]
+                            [--timeout TIMEOUT] [--output {json,ndjson,human}]
+                            [--compact] [--select SELECT |
+                            --json-pointer JSON_POINTER] [--verbose]
                             agent_id`
 - Options:
+  - `--out-file` (kind=file; input=file): Write editable agent config JSON to file
   - `--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
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header
@@ -362,9 +392,9 @@ Update an existing agent
                                [--schedule-day-of-week 0-6]
                                [--schedule-window-start SCHEDULE_WINDOW_START]
                                [--schedule-window-end SCHEDULE_WINDOW_END]
-                               [--from-file FROM_FILE] [--base-url BASE_URL]
-                               [--token TOKEN] [--use-x-api-key]
-                               [--timeout TIMEOUT]
+                               [--from-file FROM_FILE] [--dry-run]
+                               [--base-url BASE_URL] [--token TOKEN]
+                               [--use-x-api-key] [--timeout TIMEOUT]
                                [--output {json,ndjson,human}] [--compact]
                                [--select SELECT | --json-pointer JSON_POINTER]
                                [--verbose]
@@ -385,6 +415,7 @@ Update an existing agent
   - `--schedule-window-start` (kind=string): Active-hours window start (HH:MM) — used by hourly/every_6h/every_12h
   - `--schedule-window-end` (kind=string): Active-hours window end (HH:MM) — used by hourly/every_6h/every_12h
   - `--from-file` (kind=file; input=file): Path to JSON patch payload file
+  - `--dry-run` (kind=boolean; when omitted=False; when present=True): Preview the patch and diff without applying it
   - `--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
   - `--use-x-api-key` (kind=boolean; when omitted=False; when present=True): Send token via X-API-Key header

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.92",
+  "version": "0.2.94",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -34390,6 +34390,7 @@
         "get",
         "create",
         "update",
+        "diff",
         "delete",
         "run",
         "runs",
@@ -34405,7 +34406,7 @@
       "output_contract": null,
       "availability": null,
       "examples": [
-        "autotouch agents [-h]\n                        {list,get,create,update,delete,run,runs,watch,generate-persona,generate-topics,generate-job-signal,signals} ..."
+        "autotouch agents [-h]\n                        {list,get,create,update,diff,delete,run,runs,watch,generate-persona,generate-topics,generate-job-signal,signals} ..."
       ],
       "stability": "stable",
       "handler": null
@@ -34606,6 +34607,18 @@
         }
       ],
       "options": [
+        {
+          "dest": "out_file",
+          "required": false,
+          "help": "Write editable agent config JSON to file",
+          "kind": "file",
+          "action": "store",
+          "input_kind": "file",
+          "flags": [
+            "--out-file"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -34759,7 +34772,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents get [-h] [--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]\n                            agent_id"
+        "autotouch agents get [-h] [--out-file OUT_FILE] [--base-url BASE_URL]\n                            [--token TOKEN] [--use-x-api-key]\n                            [--timeout TIMEOUT] [--output {json,ndjson,human}]\n                            [--compact] [--select SELECT |\n                            --json-pointer JSON_POINTER] [--verbose]\n                            agent_id"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -35403,6 +35416,216 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "dry_run",
+          "required": false,
+          "help": "Preview the patch and diff without applying it",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--dry-run"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "base_url",
+          "required": false,
+          "help": "API base URL (default: https://app.autotouch.ai)",
+          "kind": "string",
+          "action": "store",
+          "default_when_omitted": "https://app.autotouch.ai",
+          "default": "https://app.autotouch.ai",
+          "flags": [
+            "--base-url"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "token",
+          "required": false,
+          "help": "Developer API key / JWT token",
+          "kind": "string",
+          "action": "store",
+          "sensitive": true,
+          "flags": [
+            "--token"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "use_x_api_key",
+          "required": false,
+          "help": "Send token via X-API-Key header",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--use-x-api-key"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "timeout",
+          "required": false,
+          "help": "HTTP timeout in seconds",
+          "kind": "integer",
+          "action": "store",
+          "default_when_omitted": 30,
+          "default": 30,
+          "flags": [
+            "--timeout"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "output",
+          "required": false,
+          "help": "Output mode",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "json",
+            "ndjson",
+            "human"
+          ],
+          "default_when_omitted": "json",
+          "default": "json",
+          "flags": [
+            "--output"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "compact",
+          "required": false,
+          "help": "Print compact JSON",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--compact"
+          ],
+          "takes_value": false
+        },
+        {
+          "dest": "select",
+          "required": false,
+          "help": "Extract a dotted field path from the final result (for example: id or items.0.id)",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--select"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "json_pointer",
+          "required": false,
+          "help": "Extract a JSON pointer from the final result (for example: /id)",
+          "kind": "string",
+          "action": "store",
+          "flags": [
+            "--json-pointer"
+          ],
+          "takes_value": true
+        },
+        {
+          "dest": "verbose",
+          "required": false,
+          "help": "Print request metadata to stderr",
+          "kind": "boolean",
+          "action": "store_true",
+          "nargs": 0,
+          "default_when_omitted": false,
+          "value_when_present": true,
+          "flags": [
+            "--verbose"
+          ],
+          "takes_value": false
+        }
+      ],
+      "mutually_exclusive_groups": [
+        {
+          "required": false,
+          "options": [
+            "--select",
+            "--json-pointer"
+          ]
+        }
+      ],
+      "subcommands": [],
+      "leaf_command": true,
+      "auth_mode": "developer_key_or_user_session",
+      "destructive": false,
+      "output_contract": {
+        "modes": [
+          "json",
+          "ndjson",
+          "human"
+        ],
+        "json": {
+          "single_document": true
+        },
+        "ndjson": {
+          "streaming": true,
+          "recommended_for": "progress updates / watch flows"
+        },
+        "human": {
+          "interactive": true
+        }
+      },
+      "availability": null,
+      "examples": [
+        "autotouch agents update [-h] [--name NAME]\n                               [--status {DRAFT,ACTIVE,PAUSED}]\n                               [--auto-find-email AUTO_FIND_EMAIL]\n                               [--auto-find-phone AUTO_FIND_PHONE]\n                               [--auto-broaden AUTO_BROADEN]\n                               [--auto-create-lead-mode {qualified_only,everyone,manual_only}]\n                               [--auto-sequence-id AUTO_SEQUENCE_ID]\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                               [--from-file FROM_FILE] [--dry-run]\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]\n                               agent_id"
+      ],
+      "stability": "stable",
+      "handler": "_fn"
+    },
+    "agents.diff": {
+      "canonical": [
+        "autotouch",
+        "agents",
+        "diff"
+      ],
+      "aliases": [],
+      "group": "agents",
+      "help": "Preview changes from a JSON patch without applying them",
+      "description": null,
+      "notes": null,
+      "required_flags": [
+        "--from-file"
+      ],
+      "positionals": [
+        {
+          "dest": "agent_id",
+          "required": true,
+          "help": "Agent ID",
+          "kind": "string",
+          "action": "store",
+          "name": "agent_id",
+          "positional": true
+        }
+      ],
+      "options": [
+        {
+          "dest": "from_file",
+          "required": true,
+          "help": "Path to JSON patch payload file",
+          "kind": "file",
+          "action": "store",
+          "input_kind": "file",
+          "flags": [
+            "--from-file"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -35556,7 +35779,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch agents update [-h] [--name NAME]\n                               [--status {DRAFT,ACTIVE,PAUSED}]\n                               [--auto-find-email AUTO_FIND_EMAIL]\n                               [--auto-find-phone AUTO_FIND_PHONE]\n                               [--auto-broaden AUTO_BROADEN]\n                               [--auto-create-lead-mode {qualified_only,everyone,manual_only}]\n                               [--auto-sequence-id AUTO_SEQUENCE_ID]\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                               [--from-file FROM_FILE] [--base-url BASE_URL]\n                               [--token TOKEN] [--use-x-api-key]\n                               [--timeout TIMEOUT]\n                               [--output {json,ndjson,human}] [--compact]\n                               [--select SELECT | --json-pointer JSON_POINTER]\n                               [--verbose]\n                               agent_id"
+        "autotouch agents diff [-h] --from-file FROM_FILE [--base-url BASE_URL]\n                             [--token TOKEN] [--use-x-api-key]\n                             [--timeout TIMEOUT]\n                             [--output {json,ndjson,human}] [--compact]\n                             [--select SELECT | --json-pointer JSON_POINTER]\n                             [--verbose]\n                             agent_id"
       ],
       "stability": "stable",
       "handler": "_fn"

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/parser.py

@@ -782,6 +782,7 @@ def build_parser(
             "get": commands["agents_get"],
             "create": commands["agents_create"],
             "update": commands["agents_update"],
+            "diff": commands["agents_diff"],
             "delete": commands["agents_delete"],
             "run": commands["agents_run"],
             "runs": commands["agents_runs"],

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli/templates.py

@@ -379,10 +379,10 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
             {
                 "id": "connect_1",
                 "kind": "LINKEDIN_CONNECT",
-                "waitDays": 1,
+                "waitDays": 0,
                 "waitHours": 0,
-                "waitMinutes": 0,
-                "executionMode": "AUTOMATED",
+                "waitMinutes": 7,
+                "executionMode": "MANUAL",
                 "aiDraft": True,
                 "scriptTemplate": "",
             },
@@ -392,8 +392,8 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "waitDays": 0,
                 "waitHours": 0,
                 "waitMinutes": 0,
-                "executionMode": "AUTOMATED",
-                "emailSendMode": "AUTOMATED",
+                "executionMode": "MANUAL",
+                "emailSendMode": "MANUAL",
                 "emailIsReply": False,
                 "appendSignature": True,
                 "aiDraft": True,
@@ -406,7 +406,7 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
                 "waitDays": 0,
                 "waitHours": 0,
                 "waitMinutes": 0,
-                "executionMode": "AUTOMATED",
+                "executionMode": "MANUAL",
                 "aiDraft": True,
                 "scriptTemplate": "",
             },
@@ -527,28 +527,29 @@ SEQUENCE_RECIPES: Dict[str, Dict[str, Any]] = {
 
 SEQUENCE_RECIPE_NOTES: Dict[str, List[str]] = {
     "create": [
-        "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.",
+        "Recommended default: branch-aware sequence payload with personal delivery plus AUTOMATED email with aiDraft=true.",
+        "Keep steps aligned with graph action sourceStepId values.",
         "AI draft generates subject + body at execution time.",
         "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.",
+        "Emits a branch-aware sequence payload 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": [
-        "Emits a V2 flowGraph: visit profile, connect, wait for accepted connection, then branch to LinkedIn message or fallback email.",
+        "Emits the standard LinkedIn branch sequence: visit profile, manual AI-drafted connect, wait for accepted connection, then branch to LinkedIn message or 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.",
+        "For manual AI-drafted LinkedIn steps, set executionMode=MANUAL, aiDraft=true, and scriptTemplate=\"\".",
+        "LINKEDIN_CONNECT drafts a connection request; invite notes must stay under 300 chars.",
+        "LINKEDIN_CHAT_MESSAGE creates a direct-message task after connection is accepted.",
         "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.",
+        "Every branch must be explicit and must route to the action that should run on that path.",
         "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.",
     ],

{autotouch_cli-0.2.92 → autotouch_cli-0.2.94}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.92
+Version: 0.2.94
 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.92` 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, V2 sequence flowGraph recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
+- `autotouch --version` should be `0.2.94` 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, branch-aware LinkedIn sequence recipes, real agent soft-delete with associated-table handling, and research-table sequence handoff assignee config
 - `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.92 → autotouch_cli-0.2.94}/pyproject.toml

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