autotouch-cli 0.2.47__tar.gz → 0.2.48__tar.gz

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.47
+Version: 0.2.48
 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
@@ -146,9 +146,18 @@ For automation or agent-driven setup, use:
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
 - `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands
 
+## LLM Columns
+
+For `llm_enrichment` in `agent` mode, the recommended path is:
+- provide `config.instructions`
+- let the API compile the runnable prompt
+- keep `config.useAutoSchema = true`
+
+Only send `user_schema` / `response_schema` when you intentionally want to override the generated schema and keep it aligned yourself. The installed recipe surface at `autotouch columns recipe --type llm_enrichment` follows this contract.
+
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/README.md

@@ -121,9 +121,18 @@ For automation or agent-driven setup, use:
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
 - `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands
 
+## LLM Columns
+
+For `llm_enrichment` in `agent` mode, the recommended path is:
+- provide `config.instructions`
+- let the API compile the runnable prompt
+- keep `config.useAutoSchema = true`
+
+Only send `user_schema` / `response_schema` when you intentionally want to override the generated schema and keep it aligned yourself. The installed recipe surface at `autotouch columns recipe --type llm_enrichment` follows this contract.
+
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.47`.
+Generated from the installed parser for `autotouch-cli` `0.2.48`.
 Manifest schema version: `2`.
 
 ## Output Modes

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/autotouch_cli/data/cli-manifest.json

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

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.47
+Version: 0.2.48
 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
@@ -146,9 +146,18 @@ For automation or agent-driven setup, use:
 - `autotouch sequences ...` and `autotouch tasks ...` for sequence/task workflows
 - `pip install 'autotouch-cli[mongo]'` if you need the Mongo-backed `status` / `watch` commands
 
+## LLM Columns
+
+For `llm_enrichment` in `agent` mode, the recommended path is:
+- provide `config.instructions`
+- let the API compile the runnable prompt
+- keep `config.useAutoSchema = true`
+
+Only send `user_schema` / `response_schema` when you intentionally want to override the generated schema and keep it aligned yourself. The installed recipe surface at `autotouch columns recipe --type llm_enrichment` follows this contract.
+
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.47/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.48/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/autotouch_shared/provider_registry.py

@@ -30,6 +30,7 @@ class ResearchTableProviderContract:
     key: str
     display_name: str
     kind: str
+    behavior_class: str = "standard_enrichment"
     provider_aliases: Tuple[str, ...] = ()
     origin_aliases: Tuple[str, ...] = ()
     recipe_type: Optional[str] = None
@@ -39,6 +40,7 @@ class ResearchTableProviderContract:
     setup_contract: Dict[str, Any] = field(default_factory=dict)
     execution_policy: Optional[AutoRunExecutionPolicy] = None
     dispatch_strategy: str = "bulk_queue"
+    readiness_strategy: Optional[str] = None
     save_time_entrypoint: Optional[str] = None
     is_action_provider: bool = False
     composition_contract: Dict[str, Any] = field(default_factory=dict)
@@ -72,10 +74,12 @@ class ResearchTableProviderContract:
         payload: Dict[str, Any] = {
             "display_name": self.display_name,
             "kind": self.kind,
+            "behavior_class": self.behavior_class,
             "recipe_type": self.recipe_type,
             "provider_aliases": list(self.provider_aliases or ()),
             "origin_aliases": list(self.origin_aliases or ()),
             "dispatch_strategy": self.dispatch_strategy,
+            "readiness_strategy": self.readiness_strategy,
             "action_provider": bool(self.is_action_provider),
             "setup_contract": deepcopy(self.setup_contract),
             "composition_contract": deepcopy(self.composition_contract),
@@ -271,6 +275,7 @@ _ADD_TO_SEQUENCE_POLICY = AutoRunExecutionPolicy(
     force_rerun=False,
     respect_existing_done=True,
     default_batch_size=50,
+    batch_size_env="ADD_TO_SEQUENCE_BATCH_SIZE",
 )
 
 _HTTP_REQUEST_POLICY = AutoRunExecutionPolicy(
@@ -293,6 +298,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         key="formatter",
         display_name="Formatter",
         kind="formatter",
+        behavior_class="formatter",
         recipe_type="formatter",
         recipe_payload={
             "key": "engagement_statement",
@@ -343,6 +349,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         key="llm",
         display_name="LLM Enrichment",
         kind="enrichment",
+        behavior_class="standard_enrichment",
         provider_aliases=_llm_provider_values(),
         recipe_type="llm_enrichment",
         recipe_payload={
@@ -365,8 +372,10 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "Recommended default for agent mode: provide instructions and let the API compile the runnable 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.prompt/advancedPrompt before execution.",
+            "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.",
@@ -431,10 +440,10 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                 "generated": {
                     "instructions_field": "config.instructions",
                     "prompt_source": "generated",
-                    "materialized_prompt_fields": ["config.prompt", "config.advancedPrompt"],
+                    "materialized_prompt_fields": ["config.advancedPrompt"],
                 },
                 "manual": {
-                    "prompt_field": "config.prompt",
+                    "prompt_field": "config.advancedPrompt",
                     "prompt_source": "manual",
                 },
             },
@@ -477,13 +486,14 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             ],
         },
         execution_policy=_LLM_POLICY,
-        dispatch_strategy="llm_scheduler",
+        dispatch_strategy="bulk_queue",
         save_time_entrypoint="provider_save_hook",
     ),
     ResearchTableProviderContract(
         key="email_finder",
         display_name="Email Finder",
         kind="enrichment",
+        behavior_class="standard_enrichment",
         provider_aliases=("smart_email_finder", "email_validator", "email_finder"),
         origin_aliases=("email_finder",),
         recipe_type="email_finder",
@@ -552,6 +562,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         key="phone_finder",
         display_name="Phone Finder",
         kind="enrichment",
+        behavior_class="standard_enrichment",
         provider_aliases=("smart_phone_finder", "phone_validator", "phone_finder"),
         origin_aliases=("phone_finder",),
         recipe_type="phone_finder",
@@ -626,6 +637,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         key="lead_finder",
         display_name="Lead Finder",
         kind="enrichment",
+        behavior_class="standard_enrichment",
         provider_aliases=("lead_finder",),
         recipe_type="lead_finder",
         recipe_payload={
@@ -706,6 +718,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         key="add_to_crm",
         display_name="Add to Leads",
         kind="enrichment",
+        behavior_class="action_enrichment",
         provider_aliases=("add_to_crm",),
         recipe_type="add_to_crm",
         recipe_payload={
@@ -794,12 +807,14 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             ],
         },
         execution_policy=_ADD_TO_CRM_POLICY,
+        readiness_strategy="add_to_crm",
         is_action_provider=True,
     ),
     ResearchTableProviderContract(
         key="sync_to_table",
         display_name="Sync to Table",
         kind="enrichment",
+        behavior_class="action_enrichment",
         provider_aliases=("sync_to_table",),
         recipe_type="sync_to_table",
         recipe_payload={
@@ -904,12 +919,14 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         execution_policy=_SYNC_TO_TABLE_POLICY,
         dispatch_strategy="sync_to_table_prefilter",
+        readiness_strategy="sync_to_table",
         is_action_provider=True,
     ),
     ResearchTableProviderContract(
         key="add_to_sequence",
         display_name="Add to Sequence",
         kind="enrichment",
+        behavior_class="action_enrichment",
         provider_aliases=("add_to_sequence",),
         recipe_type="add_to_sequence",
         recipe_payload={
@@ -972,12 +989,14 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             ],
         },
         execution_policy=_ADD_TO_SEQUENCE_POLICY,
+        readiness_strategy="add_to_sequence",
         is_action_provider=True,
     ),
     ResearchTableProviderContract(
         key="http_request",
         display_name="HTTP Request",
         kind="enrichment",
+        behavior_class="standard_enrichment",
         provider_aliases=("http_request",),
         recipe_type="http_request",
         recipe_payload={
@@ -998,7 +1017,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         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 or active org integration credential by provider slug.",
+            "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.",
             "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.",
@@ -1038,7 +1057,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         composition_contract={
             "consumes": {
                 "kind": "row_data",
-                "shape": "{{column_key}} templates resolved from row cell values plus optional {{secrets.name}} org credentials",
+                "shape": "{{column_key}} templates resolved from row cell values plus optional {{secrets.name}} workspace secrets",
             },
             "produces": {
                 "kind": "json",
@@ -1308,7 +1327,7 @@ def validate_column_provider_contract(
             raise ProviderContractValidationError(
                 "invalid_field",
                 "http_request config.headers must be an object when provided.",
-                hint="Set config.headers to a JSON object such as {\"Authorization\": \"Bearer {{secrets.provider}}\"}.",
+                hint="Set config.headers to a JSON object such as {\"Authorization\": \"Bearer {{secrets.openai_api_key}}\"}.",
             )
         body = cfg.get("body")
         if body is not None and not isinstance(body, (str, dict)):
@@ -1355,3 +1374,74 @@ def automation_workflow_blueprints() -> Dict[str, Dict[str, Any]]:
 
 def action_provider_keys() -> Tuple[str, ...]:
     return tuple(contract.key for contract in _PROVIDER_CONTRACTS if contract.is_action_provider)
+
+
+def behavior_class_keys(behavior_class: str) -> Tuple[str, ...]:
+    normalized = _normalize(behavior_class)
+    return tuple(
+        contract.key
+        for contract in _PROVIDER_CONTRACTS
+        if _normalize(contract.behavior_class) == normalized
+    )
+
+
+def orchestrated_runtime_provider_keys(*, include_formatter: bool = False) -> Tuple[str, ...]:
+    providers: List[str] = []
+    for contract in _PROVIDER_CONTRACTS:
+        policy = contract.execution_policy
+        if not policy:
+            continue
+        normalized_behavior = _normalize(contract.behavior_class)
+        if normalized_behavior == "formatter":
+            if include_formatter:
+                providers.append(policy.orchestrator_provider)
+            continue
+        if contract.key == "llm":
+            providers.extend(["gemini", "xai"])
+            continue
+        providers.append(policy.orchestrator_provider)
+    return tuple(dict.fromkeys(provider for provider in providers if provider))
+
+
+def resolve_provider_behavior_class(
+    column: Dict[str, Any],
+    config: Optional[Dict[str, Any]],
+) -> Optional[str]:
+    contract = resolve_effective_provider_contract(column, config)
+    if not contract:
+        return None
+    return contract.behavior_class
+
+
+def should_resolve_managed_llm_model(
+    column: Dict[str, Any],
+    config: Optional[Dict[str, Any]],
+) -> bool:
+    contract = resolve_effective_provider_contract(column, config)
+    if not contract:
+        return False
+    return contract.key == "llm" and _normalize(column.get("origin")) == "ai"
+
+
+def resolve_runtime_orchestrator_provider(
+    column: Dict[str, Any],
+    config: Optional[Dict[str, Any]],
+) -> Optional[str]:
+    contract = resolve_effective_provider_contract(column, config)
+    if not contract or not contract.execution_policy:
+        return None
+    if _normalize(contract.behavior_class) == "formatter":
+        return None
+    if contract.key == "llm":
+        runtime_provider = _normalize((config or {}).get("provider"))
+        if runtime_provider in {"gemini", "xai"}:
+            return runtime_provider
+        return None
+    return contract.execution_policy.orchestrator_provider
+
+
+def uses_orchestrated_bulk_run(
+    column: Dict[str, Any],
+    config: Optional[Dict[str, Any]],
+) -> bool:
+    return resolve_runtime_orchestrator_provider(column, config) is not None

{autotouch_cli-0.2.47 → autotouch_cli-0.2.48}/pyproject.toml

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