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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.47
+Version: 0.2.49
 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.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.49}/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.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.49}/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.49`.
 Manifest schema version: `2`.
 
 ## Output Modes

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

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.47
+Version: 0.2.49
 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.49/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.49/docs/platform/authentication.md

{autotouch_cli-0.2.47 → autotouch_cli-0.2.49}/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),
@@ -147,6 +151,12 @@ def _text(value: Any) -> str:
     return str(value or "").strip()
 
 
+def _mapping_text(value: Any) -> str:
+    if isinstance(value, dict):
+        return _text(value.get("column"))
+    return _text(value)
+
+
 def _llm_provider_values() -> Tuple[str, ...]:
     return ("gemini", "xai", "openai", "anthropic", "groq")
 
@@ -271,6 +281,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 +304,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 +355,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 +378,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 +446,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 +492,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",
@@ -505,6 +521,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "For non-LinkedIn lookup, use lookupStrategy=domain/company with firstName+lastName+domain/company fields.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "email_finder",
@@ -531,6 +548,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "strategy_field": "config.strategy",
             "lookup_strategy_field": "config.lookupStrategy",
             "input_fields": ["config.linkedinUrl", "config.firstName", "config.lastName", "config.company", "config.domain"],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"emailColumn": {"column": "email_validation", "path": "response"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -552,6 +576,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",
@@ -572,6 +597,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "You can use linkedinUrl or email/workEmail/personalEmail inputs.",
+            "Primitive source columns map directly. If an upstream source column stores structured JSON, map it as an object with column + path, for example {\"column\": \"linkedin_lookup\", \"path\": \"linkedin_url\"}.",
         ),
         column_type={
             "type": "phone_finder",
@@ -605,6 +631,13 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
                 "config.lastName",
                 "config.company",
             ],
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
+                    {"phoneColumn": {"column": "mobile_phone", "path": "mobile_number"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -626,6 +659,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={
@@ -650,6 +684,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
         },
         recipe_notes=(
             "Add more targeting keys as needed (jobFunctions, seniorities, keywords, excludeKeywords, skills).",
+            "Primitive source columns map directly. If companyDomain or other mapped inputs come from structured JSON, use {\"column\": \"...\", \"path\": \"...\"} instead of a plain string column key.",
         ),
         column_type={
             "type": "lead_finder",
@@ -675,6 +710,12 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "source_mode_field": "config.sourceMode",
             "company_domain_field": "config.companyDomain",
             "max_results_field": "config.maxResults",
+            "structured_source_mapping": {
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "examples": [
+                    {"companyDomain": {"column": "company_lookup", "path": "domain"}},
+                ],
+            },
         },
         composition_contract={
             "consumes": {
@@ -706,6 +747,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={
@@ -745,7 +787,7 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "companyDomain is required; LinkedIn is optional.",
             "Include at least one usable hard-identity mapping such as LinkedIn, email, or phone.",
             "If companyDomain is missing in the table, derive or enrich that domain column first.",
-            "Primitive source columns map directly. Structured JSON columns must specify an explicit path such as work_email.response or mobile_phone.mobile_number.",
+            "Primitive source columns map directly. If a mapped source column stores structured JSON, send an object with column + path, for example {\"column\": \"work_email\", \"path\": \"response\"} or {\"column\": \"mobile_phone\", \"path\": \"mobile_number\"}.",
             "Add to CRM is optional and non-billable.",
             "Creating add_to_crm after upstream email/phone/lead columns already finished does not replay those older source updates; run add_to_crm explicitly or rerun the upstream source column.",
         ),
@@ -772,18 +814,19 @@ _PROVIDER_CONTRACTS: Tuple[ResearchTableProviderContract, ...] = (
             "eligibility": "company domain plus at least one valid LinkedIn URL, email, or phone must resolve from mapped source columns",
             "replay_behavior": "source updates only; explicit run required to backfill older upstream results",
             "structured_source_mapping": {
-                "rule": "primitive columns map directly; structured columns require explicit path",
-                "field": "config.fieldMappings.*.path",
+                "rule": "primitive columns map directly; structured columns use {column, path}",
+                "field": "config.fieldMappings.*",
                 "examples": [
-                    "emailAddresses[].path = response",
-                    "phoneNumbers[].path = mobile_number",
+                    {"emailAddresses": [{"column": "work_email", "path": "response", "type": "work"}]},
+                    {"phoneNumbers": [{"column": "mobile_phone", "path": "mobile_number", "type": "mobile"}]},
+                    {"linkedinUrl": {"column": "linkedin_lookup", "path": "linkedin_url"}},
                 ],
             },
         },
         composition_contract={
             "consumes": {
                 "kind": "crm_export_inputs",
-                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns must identify the exact JSON key via path",
+                "shape": "mapped source row values including company domain plus LinkedIn/email/phone identity; structured source columns use explicit {column, path} mappings to identify the exact field",
             },
             "produces": {
                 "kind": "lead_ids",
@@ -794,12 +837,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 +949,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 +1019,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 +1047,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 +1087,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",
@@ -1257,30 +1306,39 @@ def validate_column_provider_contract(
 
     if contract.key == "email_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain")
+            _mapping_text(cfg.get(field_name))
+            for field_name in ("linkedinUrl", "firstName", "lastName", "company", "domain", "emailColumn")
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, or name/company fields.",
+                "email_finder requires at least one lookup input such as config.linkedinUrl, config.domain, config.emailColumn, or name/company fields.",
                 hint="Use `autotouch columns recipe --type email_finder`.",
             )
         return contract
 
     if contract.key == "phone_finder":
         if not any(
-            _text(cfg.get(field_name))
-            for field_name in ("linkedinUrl", "email", "workEmail", "personalEmail", "firstName", "lastName", "company")
+            _mapping_text(cfg.get(field_name))
+            for field_name in (
+                "linkedinUrl",
+                "email",
+                "workEmail",
+                "personalEmail",
+                "firstName",
+                "lastName",
+                "company",
+                "phoneColumn",
+            )
         ):
             raise ProviderContractValidationError(
                 "missing_required_field",
-                "phone_finder requires at least one lookup input such as config.linkedinUrl or config.email/workEmail.",
+                "phone_finder requires at least one lookup input such as config.linkedinUrl, config.email/workEmail, or config.phoneColumn.",
                 hint="Use `autotouch columns recipe --type phone_finder`.",
             )
         return contract
 
     if contract.key == "lead_finder":
-        if not _text(cfg.get("companyDomain")):
+        if not _mapping_text(cfg.get("companyDomain")):
             raise ProviderContractValidationError(
                 "missing_required_field",
                 "lead_finder requires config.companyDomain.",
@@ -1308,7 +1366,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 +1413,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.49}/pyproject.toml

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