F4: verify task recovery and document Prompt background jobs

backend/services/pipecat/pipeline.py

@@ -847,40 +847,43 @@ async def run_pipeline(
             messages.insert(0, {"role": "system", "content": content})
 
     set_visible_tools([])
-    await brain.setup(
-        cfg,
-        BrainRuntime(
-            context=context,
-            llm=llm,
-            queue_frame=worker.queue_frame,
-            set_system_prompt=set_system_prompt,
-            set_tools=set_visible_tools,
-            call_end=call_end,
-            session_id=cfg.conversation_id,
-            client_tools=client_tools,
-            worker=worker,
-            context_aggregator=WorkflowAggregatorPair(
-                user_aggregator,
-                assistant_aggregator,
-            ),
-            transport=transport,
-            switch_services=service_controller.switch,
-            set_knowledge_scope=knowledge_retrieval.set_scope,
-            set_vision_scope=lambda scope: workflow_vision_scope.update(scope),
-            vision_function=workflow_vision_function,
-            set_input_enabled=lambda enabled: input_state.__setitem__("enabled", enabled),
-            apply_turn_config=apply_workflow_turn_config,
-            flow_global_functions=flow_global_functions,
-        ),
-    )
     try:
+        await brain.setup(
+            cfg,
+            BrainRuntime(
+                context=context,
+                llm=llm,
+                queue_frame=worker.queue_frame,
+                set_system_prompt=set_system_prompt,
+                set_tools=set_visible_tools,
+                call_end=call_end,
+                session_id=cfg.conversation_id,
+                client_tools=client_tools,
+                worker=worker,
+                context_aggregator=WorkflowAggregatorPair(
+                    user_aggregator,
+                    assistant_aggregator,
+                ),
+                transport=transport,
+                switch_services=service_controller.switch,
+                set_knowledge_scope=knowledge_retrieval.set_scope,
+                set_vision_scope=lambda scope: workflow_vision_scope.update(scope),
+                vision_function=workflow_vision_function,
+                set_input_enabled=lambda enabled: input_state.__setitem__("enabled", enabled),
+                apply_turn_config=apply_workflow_turn_config,
+                flow_global_functions=flow_global_functions,
+            ),
+        )
         await brain.run_preflight()
-    except Exception:
+        # Preflight tools may assign variables used by the opening speech.
+        greeting = await brain.greeting(cfg)
+    except BaseException:
+        close = getattr(brain, "close", None)
+        if close:
+            await close()
         if recorder:
             await recorder.finish(status="failed")
         raise
-    # Preflight tools may assign variables used by the opening speech.
-    greeting = await brain.greeting(cfg)
 
     async def submit_user_input(value: UserInput) -> None:
         if not value.has_image: