Phase 3b: workflow assist endpoint (POST /api/user/workflows/assist)

application/single_app/admin_settings_fields.py

@@ -4024,6 +4024,19 @@
             "default": False,
             "depends_on": {"key": "allow_user_workflows", "equals": True},
         },
+        {
+            "key": "enable_workflow_ai_assistant",
+            "type": "switch",
+            "label": "Enable AI Workflow Assistant",
+            "help": (
+                "Users can describe a change in plain language and review the "
+                "assistant's proposed edit in the V2 workflow editor before they "
+                "save it. The assistant never saves, runs or shares a workflow, "
+                "and it only uses documents the user can already open."
+            ),
+            "default": True,
+            "depends_on": {"key": "allow_user_workflows", "equals": True},
+        },
         {
             "key": "allow_group_workflows",
             "type": "switch",

application/single_app/config.py

@@ -100,7 +100,7 @@
 EXECUTOR_TYPE = 'thread'
 EXECUTOR_MAX_WORKERS = 30
 SESSION_TYPE = 'filesystem'
-VERSION = "0.261.207"
+VERSION = "0.261.208"
 IS_DEVELOPMENT = is_development_env_enabled()
 
 # Opt-out for deployments where App Service Easy Auth is active but the platform

application/single_app/functions_settings.py

@@ -1160,6 +1160,14 @@
     return True
 
 
+def is_workflow_assistant_enabled_for_user(settings, user_roles=None):
+    """Return True when the AI workflow assistant is on and personal workflows are available to the user."""
+    source_settings = settings or {}
+    if not is_user_workflows_enabled_for_user(source_settings, user_roles=user_roles):
+        return False
+    return source_settings.get('enable_workflow_ai_assistant', False) is True
+
+
 def _authorize_user_settings_access(user_id, operation, allow_cross_user=False):
     """Authorize user-settings access for the current request context."""
     normalized_user_id = str(user_id or '').strip()
@@ -1439,6 +1447,8 @@
         'allow_user_plugins': False,
         'allow_user_workflows': False,
         'require_member_of_workflow_user': False,
+        # The AI workflow assistant in the V2 editor. It only applies where personal workflows do.
+        'enable_workflow_ai_assistant': True,
         'workflow_max_tasks': 50,
         'workflow_max_loop_items': WORKFLOW_LOOP_ITEMS_DEFAULT,
         'workflow_max_repeat_iterations': WORKFLOW_REPEAT_ITERATIONS_DEFAULT,
@@ -3865,6 +3875,21 @@
     return wrapper
 
 
+def workflow_assistant_required(f):
+    """Allow the route only when the AI workflow assistant is available to the signed-in user."""
+    @wraps(f)
+    def wrapper(*args, **kwargs):
+        settings = get_settings()
+        user_roles = (session.get('user') or {}).get('roles', [])
+        if is_workflow_assistant_enabled_for_user(settings, user_roles=user_roles):
+            return f(*args, **kwargs)
+        return jsonify({
+            'error': 'The AI workflow assistant is not available.',
+            'code': 'workflow_assistant_disabled',
+        }), 403
+    return wrapper
+
+
 def enabled_required(setting_key):
     def decorator(f):
         @wraps(f)