autotouch-cli 0.2.60__tar.gz → 0.2.61__tar.gz

{autotouch_cli-0.2.60 → autotouch_cli-0.2.61}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.60
+Version: 0.2.61
 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.60 → autotouch_cli-0.2.61}/autotouch_cli/commands/columns.py

@@ -379,7 +379,22 @@ def register_columns_subcommands(
     add_api_common_arguments(pcl)
     pcl.set_defaults(func=handlers["list"])
 
-    pcc = col_sub.add_parser("create", help="Create a column")
+    pcc = col_sub.add_parser(
+        "create",
+        help="Create a column",
+        description=(
+            "Create a column from a ColumnCreate payload.\n"
+            "For llm_enrichment, there are two valid authoring paths:\n"
+            "- generated path: send config.instructions and let the API compile config.advancedPrompt\n"
+            "- manual path: send config.advancedPrompt directly when you want exact prompt control"
+        ),
+        epilog=(
+            "Recommended flow for llm_enrichment:\n\n"
+            "autotouch columns recipe --type llm_enrichment --output human\n\n"
+            "The runnable prompt is always config.advancedPrompt before execution."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
     pcc.add_argument("--table-id", required=True)
     pcc.add_argument("--data-json", help="ColumnCreate payload JSON")
     pcc.add_argument("--data-file", help="ColumnCreate payload file path")

{autotouch_cli-0.2.60 → autotouch_cli-0.2.61}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.60`.
+Generated from the installed parser for `autotouch-cli` `0.2.61`.
 Manifest schema version: `2`.
 
 ## Output Modes
@@ -653,6 +653,11 @@ Column operations
 
 Create a column
 
+Create a column from a ColumnCreate payload.
+For llm_enrichment, there are two valid authoring paths:
+- generated path: send config.instructions and let the API compile config.advancedPrompt
+- manual path: send config.advancedPrompt directly when you want exact prompt control
+
 - Auth: `developer_key_or_user_session`
 - Stability: `stable`
 - Destructive: `no`
@@ -669,6 +674,15 @@ Create a column
                                 [--output {json,ndjson,human}] [--compact]
                                 [--select SELECT |
                                 --json-pointer JSON_POINTER] [--verbose]`
+- Notes:
+
+```text
+Recommended flow for llm_enrichment:
+
+autotouch columns recipe --type llm_enrichment --output human
+
+The runnable prompt is always config.advancedPrompt before execution.
+```
 - Options:
   - `--table-id` (required; kind=string)
   - `--data-json` (kind=json; input=json): ColumnCreate payload JSON

{autotouch_cli-0.2.60 → autotouch_cli-0.2.61}/autotouch_cli/data/cli-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.2.60",
+  "version": "0.2.61",
   "manifest_schema_version": 2,
   "entry_points": {
     "autotouch": "autotouch_cli.cli:main",
@@ -14777,8 +14777,8 @@
       "aliases": [],
       "group": "columns",
       "help": "Create a column",
-      "description": null,
-      "notes": null,
+      "description": "Create a column from a ColumnCreate payload.\nFor llm_enrichment, there are two valid authoring paths:\n- generated path: send config.instructions and let the API compile config.advancedPrompt\n- manual path: send config.advancedPrompt directly when you want exact prompt control",
+      "notes": "Recommended flow for llm_enrichment:\n\nautotouch columns recipe --type llm_enrichment --output human\n\nThe runnable prompt is always config.advancedPrompt before execution.",
       "required_flags": [
         "--table-id"
       ],

{autotouch_cli-0.2.60 → autotouch_cli-0.2.61}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.60
+Version: 0.2.61
 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.60 → autotouch_cli-0.2.61}/autotouch_shared/provider_registry.py

@@ -158,6 +158,14 @@ def _mapping_text(value: Any) -> str:
     return _text(value)
 
 
+def _llm_advanced_prompt_text(config: Dict[str, Any]) -> str:
+    return (
+        _text(config.get("advancedPrompt"))
+        or _text(config.get("advanced_prompt"))
+        or _text(config.get("prompt"))
+    )
+
+
 def _llm_provider_values() -> Tuple[str, ...]:
     return ("llm", "gemini", "xai", "openai", "anthropic", "groq")
 
@@ -378,13 +386,14 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             },
         },
         recipe_notes=(
-            "Recommended default for agent mode: provide instructions and let the API compile the runnable prompt.",
+            "The runnable prompt is always config.advancedPrompt before execution.",
+            "Generated path: provide instructions and let the API compile config.advancedPrompt for you.",
+            "Manual path: write config.advancedPrompt directly when you want exact control over the final prompt.",
             "When the platform generates the runnable prompt from instructions, keep useAutoSchema=true unless you intentionally want to own the schema yourself.",
             "Do not send user_schema/response_schema in that default generated-prompt path; prompt/schema drift is possible if you later change the generated prompt but keep a frozen custom schema.",
             "Basic is for extraction, scoring, or classification using fields already in the row. Agent is for tasks that may need outside lookup or web research.",
             "Create/update always materializes the runnable prompt into config.advancedPrompt before execution.",
             "Generated agent-mode prompts always include company/requester context.",
-            "Basic mode stays manual-prompt-first; write the prompt directly from the user goal/preferences.",
             "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.",
@@ -1357,6 +1366,38 @@ def validate_column_provider_contract(
             )
         return contract
 
+    if contract.key == "llm":
+        prompt_source = _normalize(cfg.get("promptSource") or cfg.get("prompt_source"))
+        instructions = _text(cfg.get("instructions"))
+        advanced_prompt = _llm_advanced_prompt_text(cfg)
+
+        if prompt_source == "generated":
+            if not instructions:
+                raise ProviderContractValidationError(
+                    "missing_required_field",
+                    "Generated LLM prompt mode requires config.instructions.",
+                    hint="Use instructions for shorthand/high-level intent, or switch to config.promptSource='manual' and write config.advancedPrompt directly.",
+                )
+            return contract
+
+        if prompt_source == "manual":
+            if not advanced_prompt:
+                raise ProviderContractValidationError(
+                    "missing_required_field",
+                    "Manual LLM prompt mode requires config.advancedPrompt.",
+                    hint="Write config.advancedPrompt directly, or remove config.promptSource and supply config.instructions for the generated path.",
+                )
+            return contract
+
+        if instructions or advanced_prompt:
+            return contract
+
+        raise ProviderContractValidationError(
+            "missing_required_field",
+            "LLM enrichment columns require either config.instructions or config.advancedPrompt.",
+            hint="Use instructions for the generated path or write config.advancedPrompt directly for the manual path.",
+        )
+
     if contract.key == "add_to_sequence":
         if not _text(cfg.get("sequenceId")):
             raise ProviderContractValidationError(

{autotouch_cli-0.2.60 → autotouch_cli-0.2.61}/pyproject.toml

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