autotouch-cli 0.2.85__tar.gz → 0.2.86__tar.gz

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.85
+Version: 0.2.86
 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

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_cli/cli.py

@@ -2398,6 +2398,7 @@ cmd_auth_schema = _bound("auth_schema")
 cmd_auth_whoami = _bound("auth_whoami")
 cmd_cells_get = _bound("cells_get")
 cmd_columns_create = _bound("columns_create")
+cmd_columns_update = _bound("columns_update")
 cmd_columns_move = _bound("columns_move")
 cmd_columns_projections = _bound("columns_projections")
 cmd_columns_run_next = _bound("columns_run_next")

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_cli/commands/columns.py

@@ -7,6 +7,16 @@ from typing import Any, Callable, Dict, Sequence
 from autotouch_cli.exceptions import AutotouchCreditError, AutotouchInputError
 
 
+_RESEARCH_MODE_ALIASES = {
+    "lite": "lite",
+    "light": "lite",
+    "quick": "lite",
+    "heavy": "heavy",
+    "deep": "heavy",
+    "thorough": "heavy",
+}
+
+
 @dataclass(frozen=True)
 class ColumnCommandRuntime:
     resolve_token: Callable[[str | None, bool], str | None]
@@ -52,6 +62,54 @@ def _apply_column_position_overrides(
     return merged
 
 
+def _normalize_research_mode_option(value: Any) -> str:
+    normalized = str(value or "").strip().lower()
+    if normalized in _RESEARCH_MODE_ALIASES:
+        return _RESEARCH_MODE_ALIASES[normalized]
+    raise AutotouchInputError("--research-mode must be one of: lite, heavy")
+
+
+def _apply_research_mode_overrides(
+    payload: Dict[str, Any],
+    args: argparse.Namespace,
+    *,
+    force_agent_on_explicit: bool,
+) -> Dict[str, Any]:
+    explicit_value = getattr(args, "research_mode", None)
+    config = payload.get("config")
+    if not isinstance(config, dict):
+        if explicit_value is None:
+            return payload
+        config = {}
+
+    current_mode = str(config.get("mode") or "").strip().lower()
+    has_research_mode = (
+        config.get("researchMode") is not None
+        or config.get("research_mode") is not None
+    )
+    should_default_agent_lite = current_mode == "agent" and not has_research_mode
+    should_clean_agent_config = current_mode == "agent" and has_research_mode
+    if explicit_value is None and not should_default_agent_lite and not should_clean_agent_config:
+        return payload
+
+    merged = dict(payload)
+    next_config = dict(config)
+    if explicit_value is not None:
+        if force_agent_on_explicit:
+            next_config["mode"] = "agent"
+        next_config["researchMode"] = _normalize_research_mode_option(explicit_value)
+    elif config.get("researchMode") is not None:
+        next_config["researchMode"] = _normalize_research_mode_option(config.get("researchMode"))
+    elif config.get("research_mode") is not None:
+        next_config["researchMode"] = _normalize_research_mode_option(config.get("research_mode"))
+    else:
+        next_config["researchMode"] = "lite"
+    next_config.pop("research_mode", None)
+    next_config.pop("lite", None)
+    merged["config"] = next_config
+    return merged
+
+
 def _normalize_http_request_test_payload(payload: Dict[str, Any]) -> Dict[str, Any]:
     candidate = payload
     config = payload.get("config")
@@ -111,6 +169,7 @@ def cmd_columns_create(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
         allow_position=True,
         allow_neighbors=True,
     )
+    payload = _apply_research_mode_overrides(payload, args, force_agent_on_explicit=True)
     runtime.validate_column_contract_payload_or_exit(payload)
     runtime.validate_add_to_crm_create_payload(payload)
     data = runtime.request_api(
@@ -156,6 +215,7 @@ def cmd_columns_update(args: argparse.Namespace, *, runtime: ColumnCommandRuntim
         allow_position=True,
         allow_neighbors=False,
     )
+    payload = _apply_research_mode_overrides(payload, args, force_agent_on_explicit=False)
     runtime.validate_column_contract_payload_or_exit(payload)
     data = runtime.request_api(
         "PATCH",
@@ -401,6 +461,11 @@ def register_columns_subcommands(
     pcc.add_argument("--position", type=float, help="Explicit numeric position override")
     pcc.add_argument("--after-column-id", help="Place the new column after this existing column id")
     pcc.add_argument("--before-column-id", help="Place the new column before this existing column id")
+    pcc.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        help="For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite.",
+    )
     add_api_common_arguments(pcc)
     pcc.set_defaults(func=handlers["create"])
 
@@ -417,6 +482,11 @@ def register_columns_subcommands(
     pcu.add_argument("--data-json", help="ColumnUpdate payload JSON")
     pcu.add_argument("--data-file", help="ColumnUpdate payload file path")
     pcu.add_argument("--position", type=float, help="Explicit numeric position override")
+    pcu.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        help="Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent.",
+    )
     add_api_common_arguments(pcu)
     pcu.set_defaults(func=handlers["update"])
 
@@ -545,6 +615,12 @@ def register_columns_subcommands(
 
     pcre = col_sub.add_parser("recipe", help="Print copy-ready ColumnCreate payload templates")
     pcre.add_argument("--type", choices=["all", *column_recipe_types], default="all")
+    pcre.add_argument(
+        "--research-mode",
+        choices=["lite", "heavy"],
+        default="lite",
+        help="Research Agent depth for LLM recipes (default: lite; heavy costs more per row)",
+    )
     pcre.add_argument("--out-file", help="Write template JSON to file (single type writes payload only)")
     add_output_formatting_arguments(pcre)
     pcre.set_defaults(func=handlers["recipe"])

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.85`.
+Generated from the installed parser for `autotouch-cli` `0.2.86`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -1079,6 +1079,7 @@ For llm_enrichment, there are two valid authoring paths:
                                 [--data-file DATA_FILE] [--position POSITION]
                                 [--after-column-id AFTER_COLUMN_ID]
                                 [--before-column-id BEFORE_COLUMN_ID]
+                                [--research-mode {lite,heavy}]
                                 [--base-url BASE_URL] [--token TOKEN]
                                 [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
@@ -1100,6 +1101,7 @@ The runnable prompt is always config.advancedPrompt before execution.
   - `--position` (kind=number): Explicit numeric position override
   - `--after-column-id` (kind=string): Place the new column after this existing column id
   - `--before-column-id` (kind=string): Place the new column before this existing column id
+  - `--research-mode` (kind=string; choices=lite,heavy): For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite.
   - `--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
@@ -1321,12 +1323,14 @@ Print copy-ready ColumnCreate payload templates
 - Example:
   - `autotouch columns recipe [-h]
                                 [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]
+                                [--research-mode {lite,heavy}]
                                 [--out-file OUT_FILE]
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER]`
 - Options:
   - `--type` (kind=string; choices=all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads; default=all)
+  - `--research-mode` (kind=string; choices=lite,heavy; default=lite): Research Agent depth for LLM recipes (default: lite; heavy costs more per row)
   - `--out-file` (kind=file; input=file): Write template JSON to file (single type writes payload only)
   - `--output` (kind=string; choices=json,ndjson,human; default=json): Output mode
   - `--compact` (kind=boolean; when omitted=False; when present=True): Print compact JSON
@@ -1538,6 +1542,7 @@ Update a column definition. Nested config keys merge into the existing config, s
   - `autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID
                                 [--data-json DATA_JSON]
                                 [--data-file DATA_FILE] [--position POSITION]
+                                [--research-mode {lite,heavy}]
                                 [--base-url BASE_URL] [--token TOKEN]
                                 [--use-x-api-key] [--timeout TIMEOUT]
                                 [--output {json,ndjson,human}] [--compact]
@@ -1549,6 +1554,7 @@ Update a column definition. Nested config keys merge into the existing config, s
   - `--data-json` (kind=json; input=json): ColumnUpdate payload JSON
   - `--data-file` (kind=file; input=file): ColumnUpdate payload file path
   - `--position` (kind=number): Explicit numeric position override
+  - `--research-mode` (kind=string; choices=lite,heavy): Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent.
   - `--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.85 → autotouch_cli-0.2.86}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.85",
+  "version": "0.2.86",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -14852,6 +14852,21 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "research_mode",
+          "required": false,
+          "help": "For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite.",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "lite",
+            "heavy"
+          ],
+          "flags": [
+            "--research-mode"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -15005,7 +15020,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns create [-h] --table-id TABLE_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--after-column-id AFTER_COLUMN_ID]\n                                [--before-column-id BEFORE_COLUMN_ID]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch columns create [-h] --table-id TABLE_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--after-column-id AFTER_COLUMN_ID]\n                                [--before-column-id BEFORE_COLUMN_ID]\n                                [--research-mode {lite,heavy}]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -15084,6 +15099,21 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "research_mode",
+          "required": false,
+          "help": "Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent.",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "lite",
+            "heavy"
+          ],
+          "flags": [
+            "--research-mode"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "base_url",
           "required": false,
@@ -15237,7 +15267,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
+        "autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID\n                                [--data-json DATA_JSON]\n                                [--data-file DATA_FILE] [--position POSITION]\n                                [--research-mode {lite,heavy}]\n                                [--base-url BASE_URL] [--token TOKEN]\n                                [--use-x-api-key] [--timeout TIMEOUT]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER] [--verbose]"
       ],
       "stability": "stable",
       "handler": "_fn"
@@ -17564,6 +17594,23 @@
           ],
           "takes_value": true
         },
+        {
+          "dest": "research_mode",
+          "required": false,
+          "help": "Research Agent depth for LLM recipes (default: lite; heavy costs more per row)",
+          "kind": "string",
+          "action": "store",
+          "choices": [
+            "lite",
+            "heavy"
+          ],
+          "default_when_omitted": "lite",
+          "default": "lite",
+          "flags": [
+            "--research-mode"
+          ],
+          "takes_value": true
+        },
         {
           "dest": "out_file",
           "required": false,
@@ -17663,7 +17710,7 @@
       },
       "availability": null,
       "examples": [
-        "autotouch columns recipe [-h]\n                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]\n                                [--out-file OUT_FILE]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER]"
+        "autotouch columns recipe [-h]\n                                [--type {all,formatter,llm_enrichment,email_finder,phone_finder,lead_finder,add_to_crm,sync_to_table,add_to_sequence,http_request,add_to_leads,sync_to_leads}]\n                                [--research-mode {lite,heavy}]\n                                [--out-file OUT_FILE]\n                                [--output {json,ndjson,human}] [--compact]\n                                [--select SELECT |\n                                --json-pointer JSON_POINTER]"
       ],
       "stability": "stable",
       "handler": "_fn"

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_cli/templates.py

@@ -917,6 +917,32 @@ def _recipe_payload(recipe_type: str) -> Dict[str, Any]:
     return _json_copy(payload)
 
 
+def _apply_recipe_research_mode(payload: Dict[str, Any], research_mode: Any) -> Dict[str, Any]:
+    config = payload.get("config")
+    if not isinstance(config, dict):
+        return payload
+    if str(config.get("mode") or "").strip().lower() != "agent":
+        return payload
+    mode = str(research_mode or "lite").strip().lower()
+    if mode not in {"lite", "heavy"}:
+        mode = "lite"
+    payload = dict(payload)
+    payload["config"] = {
+        **config,
+        "researchMode": mode,
+    }
+    payload["config"].pop("research_mode", None)
+    payload["config"].pop("lite", None)
+    return payload
+
+
+def _recipe_payload_for_args(recipe_type: str, args: argparse.Namespace) -> Dict[str, Any]:
+    return _apply_recipe_research_mode(
+        _recipe_payload(recipe_type),
+        getattr(args, "research_mode", "lite"),
+    )
+
+
 def _sequence_recipe_payload(recipe_type: str) -> Dict[str, Any]:
     payload = SEQUENCE_RECIPES.get(recipe_type)
     if not payload:
@@ -1639,7 +1665,7 @@ def emit_workflows_scaffold(args: argparse.Namespace, runtime: TemplateRuntime)
 def emit_columns_recipe(args: argparse.Namespace, runtime: TemplateRuntime) -> None:
     selected_type = str(args.type or "all")
     if selected_type == "all":
-        recipes = {name: _recipe_payload(name) for name in COLUMN_RECIPE_TYPES}
+        recipes = {name: _recipe_payload_for_args(name, args) for name in COLUMN_RECIPE_TYPES}
         output = {
             "recipes": recipes,
             "notes": COLUMN_RECIPE_NOTES,
@@ -1662,7 +1688,7 @@ def emit_columns_recipe(args: argparse.Namespace, runtime: TemplateRuntime) -> N
         runtime.print_json(output, getattr(args, "compact", False))
         return
 
-    payload = _recipe_payload(selected_type)
+    payload = _recipe_payload_for_args(selected_type, args)
     output_single = {
         "type": selected_type,
         "payload": payload,

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.85
+Version: 0.2.86
 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

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/autotouch_shared/provider_registry.py

@@ -378,6 +378,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "config": {
                 "instructions": "Research the company in this row and return JSON with icp_fit, summary, and risks.",
                 "mode": "agent",
+                "researchMode": "lite",
                 "temperature": 0.7,
                 "promptSource": "generated",
                 "useCompanyContext": True,
@@ -397,6 +398,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "Runtime only injects values for placeholders the prompt explicitly references.",
             "Manual/basic prompts should use explicit placeholders like {{company_name}}, {{domain}}, or {{user_value_proposition}} when those values are needed.",
             "Agent mode is JSON-oriented.",
+            "Agent research depth lives in config.researchMode and defaults to lite; set heavy only when the broader 2-credit research pass is needed.",
             "Basic mode can be text or JSON; JSON requires dataType=json.",
         ),
         column_type={

{autotouch_cli-0.2.85 → autotouch_cli-0.2.86}/pyproject.toml

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