rasa-pro 3.14.0.dev20250901__py3-none-any.whl → 3.14.0.dev20250922__py3-none-any.whl

rasa/builder/service.py

@@ -54,8 +54,8 @@ from rasa.builder.guardrails.utils import (
 from rasa.builder.job_manager import job_manager
 from rasa.builder.jobs import (
     run_prompt_to_bot_job,
+    run_replace_all_files_job,
     run_template_to_bot_job,
-    run_update_files_job,
 )
 from rasa.builder.llm_service import llm_service
 from rasa.builder.logging_utils import (
@@ -512,26 +512,31 @@ async def get_bot_files(request: Request) -> HTTPResponse:
         )
 
 
-@bp.route("/files", methods=["PUT"])
-@openapi.summary("Update bot files")
+@bp.route("/files", methods=["POST"])
+@openapi.summary("Replace all bot files")
 @openapi.description(
-    "Updates the bot configuration files and retrains the model. "
-    "Returns immediately with a job ID. Connect to `/job-events/<job_id>` "
-    "for real-time SSE progress tracking."
+    "Replaces all bot configuration files with the provided files, deletes any "
+    "files not included in the request (excluding .rasa/ and models/ directories), "
+    "and retrains the model. Returns immediately with a job ID. Connect to "
+    "`/job-events/<job_id>` for real-time SSE progress tracking."
     "\n\n"
+    "**File Management:**\n"
+    "- All files in the request are written to the project folder\n"
+    "- Files not included in the request are deleted from the project\n"
+    "- Files/folders starting with `.rasa/` or `models/` are excluded from deletion\n\n"
     "**SSE Event Flow:** (available via /job-events/<job_id>)\n"
     "1. `received` - Request received by server\n"
     "2. `validating` - Validating bot configuration files\n"
     "3. `validation_success` - File validation completed successfully\n"
     "4. `training` - Training the bot model with updated files\n"
     "5. `train_success` - Model training completed\n"
-    "6. `done` - Bot files update completed\n\n"
+    "6. `done` - Bot files replacement completed\n\n"
     "**Error Events (can occur at any time):**\n"
     "- `validation_error` - Bot configuration files are invalid\n"
     "- `train_error` - Files updated but training failed\n"
     "- `error` - Unexpected error occurred\n\n"
     "**Usage:**\n"
-    "1. Send PUT request with Content-Type: application/json\n"
+    "1. Send POST request with Content-Type: application/json\n"
     "2. The response will be a JSON object `{job_id: ...}`\n"
     "3. Connect to `/job-events/<job_id>` for a server-sent event stream of progress."
 )
@@ -539,9 +544,11 @@ async def get_bot_files(request: Request) -> HTTPResponse:
 @openapi.body(
     {"application/json": {str: Optional[str]}},
     description=(
-        "A dictionary mapping file names to their updated content. "
-        "The file name should be the name of the file in the project folder. "
-        "Files that are not in the request will not be updated."
+        "A dictionary mapping file names to their complete content. "
+        "All files in the project will be replaced with these files. "
+        "Files not included in the request will be deleted from the project "
+        "(except for .rasa/ and models/ directories). "
+        "The file name should be the relative path from the project root."
     ),
     required=True,
     example={
@@ -558,6 +565,10 @@ async def get_bot_files(request: Request) -> HTTPResponse:
             "  - name: CountVectorsFeaturizer\n"
             "policies:\n  - name: MemoizationPolicy\n  - name: RulePolicy"
         ),
+        "data/nlu.yml": (
+            "version: '3.1'\n"
+            "nlu:\n- intent: greet\n  examples: |\n    - hello\n    - hi"
+        ),
     },
 )
 @openapi.response(
@@ -565,7 +576,7 @@ async def get_bot_files(request: Request) -> HTTPResponse:
     {"application/json": model_to_schema(JobCreateResponse)},
     description=(
         "Job created. Poll or subscribe to /job-events/<job_id> "
-        "for progress and SSE updates."
+        "for progress and SSE updates on file replacement and training."
     ),
 )
 @openapi.response(
@@ -607,8 +618,8 @@ async def get_bot_files(request: Request) -> HTTPResponse:
     schema=str,
 )
 @protected()
-async def update_bot_files(request: Request) -> HTTPResponse:
-    """Update bot files with server-sent events for progress tracking."""
+async def replace_all_bot_files(request: Request) -> HTTPResponse:
+    """Replace all bot files with server-sent events for progress tracking."""
     try:
         bot_files = request.json
     except Exception as exc:
@@ -621,17 +632,17 @@ async def update_bot_files(request: Request) -> HTTPResponse:
 
     try:
         job = job_manager.create_job()
-        request.app.add_task(run_update_files_job(request.app, job, bot_files))
+        request.app.add_task(run_replace_all_files_job(request.app, job, bot_files))
         return response.json(JobCreateResponse(job_id=job.id).model_dump(), status=200)
     except Exception as exc:
         capture_exception_with_context(
             exc,
-            "bot_builder_service.update_bot_files.unexpected_error",
-            tags={"endpoint": "/api/files", "method": "PUT"},
+            "bot_builder_service.replace_all_bot_files.unexpected_error",
+            tags={"endpoint": "/api/files", "method": "POST"},
         )
         return response.json(
             ApiErrorResponse(
-                error="Failed to update bot files", details={"error": str(exc)}
+                error="Failed to replace bot files", details={"error": str(exc)}
             ).model_dump(),
             status=HTTPStatus.INTERNAL_SERVER_ERROR,
         )
@@ -1122,11 +1133,9 @@ async def copilot(request: Request) -> None:
         #    copilot response handler
         start_timestamp = time.perf_counter()
         copilot_client = llm_service.instantiate_copilot()
-        (
-            original_stream,
-            used_documents,
-            system_prompt,
-        ) = await copilot_client.generate_response(context)
+        (original_stream, generation_context) = await copilot_client.generate_response(
+            context
+        )
 
         copilot_response_handler = llm_service.instantiate_handler(
             COPILOT_HANDLER_ROLLING_BUFFER_SIZE
@@ -1142,18 +1151,24 @@ async def copilot(request: Request) -> None:
             asyncio.to_thread(
                 telemetry.log_copilot_from_handler,
                 handler=copilot_response_handler,
-                used_documents=used_documents,
+                used_documents=generation_context.relevant_documents,
                 latency_ms=int((time.perf_counter() - start_timestamp) * 1000),
-                system_prompt=system_prompt,
+                system_message=generation_context.system_message,
+                chat_history=generation_context.chat_history,
+                last_user_message=(
+                    req.last_message.get_text_content()
+                    if (req.last_message and req.last_message.role == ROLE_USER)
+                    else None
+                ),
                 **copilot_client.usage_statistics.model_dump(),
             )
         )
 
         # 9. Once the stream is over, extract and send references
         #    if any documents were used
-        if used_documents:
+        if generation_context.relevant_documents:
             reference_section = copilot_response_handler.extract_references(
-                used_documents
+                generation_context.relevant_documents
             )
             await sse.send(reference_section.to_sse_event().format())
 

rasa/builder/template_cache.py

@@ -0,0 +1,69 @@
+import os
+from pathlib import Path
+
+import aiofiles
+import aiofiles.os
+import aioshutil
+import structlog
+
+from rasa.cli.scaffold import ProjectTemplateName
+
+structlogger = structlog.get_logger()
+
+
+# Root directory for storing downloaded template caches on disk.
+_CACHE_ROOT_DIR = Path(os.getenv("RASA_TEMPLATE_CACHE_DIR", "/templates"))
+
+
+def _template_cache_dir(template: ProjectTemplateName) -> Path:
+    """Return the local cache directory for a given template and version."""
+    return _CACHE_ROOT_DIR / template.value
+
+
+async def _copytree(src: Path, dst: Path) -> None:
+    """Copy directory tree from src to dst, merging into dst.
+
+    Existing files are overwritten. Hidden files and directories are included, as
+    caches can contain `.rasa` metadata that should be applied before calling
+    `ensure_first_used`.
+    """
+    for root, dirs, files in os.walk(src):
+        rel_path = Path(root).relative_to(src)
+        target_dir = dst / rel_path
+        await aiofiles.os.makedirs(target_dir, exist_ok=True)
+        for filename in files:
+            src_file = Path(root) / filename
+            dst_file = target_dir / filename
+            await aioshutil.copy2(src_file, dst_file)
+
+
+async def copy_cache_for_template_if_available(
+    template: ProjectTemplateName, project_folder: Path
+) -> None:
+    """Copy a previously downloaded cache for `template` into `project_folder`.
+
+    If the cache does not exist, this function is a no-op.
+    """
+    try:
+        cache_dir = _template_cache_dir(template)
+        if cache_dir.exists() and any(cache_dir.iterdir()):
+            await _copytree(cache_dir, project_folder)
+            structlogger.info(
+                "project_generator.copy_cache_for_template.success",
+                template=template,
+                event_info=(
+                    "Copied cached template files from cache to project folder."
+                ),
+            )
+        else:
+            structlogger.debug(
+                "project_generator.copy_cache_for_template.missing",
+                template=template,
+                event_info=("No local cache found for template; skipping copy."),
+            )
+    except Exception as exc:
+        structlogger.warning(
+            "project_generator.copy_cache_for_template.error",
+            error=str(exc),
+            template=template,
+        )

rasa/builder/training_service.py

@@ -2,20 +2,33 @@
 
 import os
 from pathlib import Path
+from typing import Optional
 
 import structlog
+from sanic import Sanic
 
 from rasa.builder.exceptions import AgentLoadError, TrainingError
 from rasa.builder.models import TrainingInput
-from rasa.core import agent
+from rasa.core.agent import Agent, load_agent
+from rasa.core.channels.studio_chat import StudioChatInput
 from rasa.core.utils import AvailableEndpoints, read_endpoints_from_path
+from rasa.model import get_latest_model
 from rasa.model_training import TrainingResult, train
 from rasa.shared.importers.importer import TrainingDataImporter
 
 structlogger = structlog.get_logger()
 
 
-async def train_and_load_agent(input: TrainingInput) -> agent.Agent:
+def update_agent(agent: Optional[Agent], app: Sanic) -> None:
+    """Update the agent in the request context."""
+    app.ctx.agent = agent
+    if hasattr(app.ctx, "input_channel") and isinstance(
+        app.ctx.input_channel, StudioChatInput
+    ):
+        app.ctx.input_channel.agent = agent
+
+
+async def train_and_load_agent(input: TrainingInput) -> Agent:
     """Train a model and load an agent.
 
     Args:
@@ -54,6 +67,63 @@ async def train_and_load_agent(input: TrainingInput) -> agent.Agent:
         raise TrainingError(f"SystemExit during training: {e}")
 
 
+async def try_load_existing_agent(project_folder: str) -> Optional[Agent]:
+    """Try to load an existing agent from the project's models directory.
+
+    Args:
+        project_folder: Path to the project folder
+
+    Returns:
+        Loaded Agent instance if successful, None otherwise
+    """
+    models_dir = os.path.join(project_folder, "models")
+
+    if not os.path.exists(models_dir) or not os.path.isdir(models_dir):
+        structlogger.debug("No models directory found", models_dir=models_dir)
+        return None
+
+    try:
+        # Find the latest model in the models directory
+        latest_model_path = get_latest_model(models_dir)
+        if not latest_model_path:
+            structlogger.debug(
+                "No models found in models directory", models_dir=models_dir
+            )
+            return None
+
+        structlogger.info(
+            "Found existing model, attempting to load", model_path=latest_model_path
+        )
+
+        # Get available endpoints for agent loading
+        available_endpoints = AvailableEndpoints.get_instance()
+
+        # Load the agent
+        agent = await load_agent(
+            model_path=latest_model_path, endpoints=available_endpoints
+        )
+
+        if agent and agent.is_ready():
+            structlogger.info(
+                "Successfully loaded existing agent", model_path=latest_model_path
+            )
+            return agent
+        else:
+            structlogger.warning(
+                "Agent loaded but not ready", model_path=latest_model_path
+            )
+            return None
+
+    except Exception as e:
+        structlogger.warning(
+            "Failed to load existing agent",
+            models_dir=models_dir,
+            error=str(e),
+            exc_info=True,
+        )
+        return None
+
+
 async def _setup_endpoints(endpoints_file: Path) -> None:
     """Setup endpoints configuration for training."""
     try:
@@ -90,7 +160,7 @@ async def _train_model(importer: TrainingDataImporter) -> TrainingResult:
         raise TrainingError(f"Model training failed: {e}")
 
 
-async def _load_agent(model_path: str) -> agent.Agent:
+async def _load_agent(model_path: str) -> Agent:
     """Load the trained agent."""
     try:
         structlogger.info("training.loading_agent", model_path=model_path)
@@ -105,7 +175,7 @@ async def _load_agent(model_path: str) -> agent.Agent:
             model_path=model_path,
         )
 
-        agent_instance = await agent.load_agent(
+        agent_instance = await load_agent(
             model_path=model_path,
             remote_storage=None,
             endpoints=available_endpoints,

rasa/cli/project_templates/basic/README.md

@@ -0,0 +1,23 @@
+# Basic Rasa Template
+
+A simple, general-purpose conversational agent template that provides essential conversational capabilities.
+
+## 🚀 What's Included
+
+This template provides a foundation for building conversational agents with:
+- **Basic conversational flows**: Greetings, help, feedback, and human handoff
+- **Help system**: Users can ask for assistance and get guided responses
+- **Feedback collection**: Gather user feedback to improve the agent
+- **Human handoff**: Seamlessly transfer conversations to human agents when needed
+
+## 📁 Directory Structure
+
+```
+├── actions/          # Custom Python logic for agent actions
+├── data/            # Conversational flows and training data
+├── domain/          # Agent configuration (slots, responses, actions)
+├── docs/            # Knowledge base documents (optional)
+├── prompts/         # LLM prompts for enhanced responses
+└── config.yml       # Training pipeline configuration
+```
+

rasa/cli/project_templates/basic/actions/actions.md

@@ -0,0 +1,10 @@
+## 📂 `actions/` – The Agent's Toolkit
+
+This folder contains Python files that define custom actions your agent can perform. Actions are pieces of code that run when your agent needs to do something beyond just responding with text.
+
+**What you'll find:**
+- `action_human_handoff.py`: Handles transferring the conversation to a human agent when needed.
+
+**Edit Python files in this folder** to add new custom logic, integrate with APIs, or perform calculations and data processing.
+
+Learn more about custom actions in the [Rasa documentation](https://rasa.com/docs/pro/build/custom-actions).

rasa/cli/project_templates/basic/config.yml

@@ -1,11 +1,11 @@
-# Rasa Assistant Configuration
-# This file controls your assistant's language, message processing pipeline, and conversation policies.
+# Rasa Agent Configuration
+# This file controls your agent's language, message processing pipeline, and conversation policies.
 # For full documentation, see: https://rasa.com/docs/pro/build/configuring-assistant
 recipe: default.v1
 language: en
 
-# The assistant project unique identifier
-# This default value must be replaced with a unique assistant name within your deployment
+# The agent project unique identifier  
+# This default value must be replaced with a unique agent name within your deployment
 assistant_id: placeholder_default
 
 pipeline:
@@ -24,4 +24,6 @@ policies:
     source: "./docs"
   llm:
     model_group: openai-gpt-4o
+  embeddings:
+    model_group: openai-embeddings
   check_relevancy: true

rasa/cli/project_templates/basic/data/data.md

@@ -1,9 +1,8 @@
-## 📂 `data/` – The agent's Business Logic
+## 📂 `data/` – The Agent's Business Logic
 
-This folder holds files that define your agent’s skills using "flows". Each flow is a step-by-step conversation pattern (like a recipe) for handling a user goal (e.g., checking a balance, updating an address).
+This folder holds files that define your agent’s skills using "flows". [1](https://rasa.com/docs/pro/build/writing-flows) Each flow is a step-by-step conversation pattern (like a recipe) for handling a user goal (e.g., checking a balance, updating an address).
 
-**What you’ll find:**
-- Each YAML file = one or more skills.
-- Flows are made of steps: collecting info, calling actions, and responding.
+**What you'll find:**
+- **general/**: Basic conversational flows (greetings, help, feedback, human handoff)
 
-**Edit txt files in this folder** to add new skills, change existing flows, or adjust what the agent asks.
+**Edit YAML files in this folder** to add new skills, change existing flows, or adjust what the agent asks.

rasa/cli/project_templates/basic/domain/domain.md

@@ -1,9 +1,11 @@
-## 📂 `domain/` – The agent’s Brain
+## 📂 `domain/` – The Agent's Brain
 
-This folder contains YAML files that define the agent’s:
-- **Slots**: The agent’s memory (e.g., user's name, account number, address).
-- **Responses**: The messages your bot can say to users (e.g., greetings, confirmations).
-- **Actions**: Custom logic your agent can run (e.g., checking a balance).
+This folder contains YAML files that define the agent's:
+- **Slots**: The agent's memory (e.g., user's name, session info) [1](https://rasa.com/docs/reference/primitives/slots/).
+- **Responses**: The messages your agent can say to users (e.g., greetings, confirmations) [2](https://rasa.com/docs/reference/primitives/responses).
+- **Actions**: Custom logic your agent can run (e.g., handling feedback, human handoff) [3](https://rasa.com/docs/reference/primitives/custom-actions).
 
+**What you'll find:**
+- **general/**: Basic conversational domain elements (greetings, help, feedback)
 
 You can organize the domain as one big file or many small ones. Rasa will automatically merge everything during training [1](https://rasa.com/docs/reference/config/domain).

rasa/cli/project_templates/basic/domain/general/show_faqs.yml

@@ -3,7 +3,7 @@ version: "3.1"
 responses:
   utter_top_faqs:
     - text: |
-        Try out some of these questions to trigger agent search:
+        Try out some of these questions you can use to get me to search your knowledge base:
         
         - 🤖 What is Rasa?
         - 💬 What is CALM?

rasa/cli/project_templates/basic/endpoints.yml

@@ -60,4 +60,8 @@ model_groups:
       - provider: openai
         model: gpt-4o-2024-11-20
         timeout: 7
-        max_tokens: 256
+        max_completion_tokens: 256
+  - id: openai-embeddings
+    models:
+      - provider: openai
+        model: text-embedding-3-large

rasa/cli/project_templates/default/config.yml

@@ -15,3 +15,7 @@ pipeline:
 policies:
 - name: FlowPolicy
 - name: IntentlessPolicy
+  llm:
+    model_group: openai-gpt-4o
+  embeddings:
+    model_group: openai-embeddings

rasa/cli/project_templates/default/endpoints.yml

@@ -56,3 +56,7 @@ model_groups:
         model: gpt-4o-2024-11-20
         request_timeout: 7
         max_tokens: 256
+  - id: openai-embeddings
+    models:
+      - provider: openai
+        model: text-embedding-3-large

rasa/cli/project_templates/finance/README.md

@@ -0,0 +1,26 @@
+# Finance Banking Agent Template
+
+A lightweight banking conversational agent template for the fictional **Fenlo Bank** that handles account management, card services, and money transfers.
+
+## 🚀 What's Included
+
+This template provides a banking assistant with:
+- **Account Management**: Balance checking and statement downloads
+- **Card Services**: Card activation, blocking, replacement, and listing  
+- **Money Transfers**: Account-to-account transfers and third-party payments
+- **Contact Management**: Add, list, and remove trusted contacts
+- **Bill Management**: Bill payment reminders and scheduling
+- **Banking Knowledge**: FAQ system with Fenlo Bank documentation
+
+## 📁 Directory Structure
+
+```
+├── actions/         # Custom Python logic for banking operations
+├── data/            # Banking conversation flows and training data
+├── domain/          # Banking agent configuration
+├── db/              # Mock JSON database for testing
+├── docs/            # Fenlo Bank knowledge base and FAQ documents
+├── prompts/         # LLM prompts for enhanced banking responses
+└── config.yml       # Training pipeline configuration
+```
+

rasa/cli/project_templates/finance/actions/__init__.py

@@ -1,46 +0,0 @@
-# Account actions
-from actions.accounts.action_ask_account import ActionAskAccount
-from actions.accounts.action_check_balance import ActionCheckBalance
-
-# General actions
-from actions.action_session_start import ActionSessionStart
-
-# Card actions
-from actions.cards.action_ask_card import ActionAskCard
-from actions.cards.action_check_card_existence import ActionCheckCardExistence
-from actions.cards.action_update_card_status import ActionUpdateCardStatus
-
-# Transfer actions
-from actions.transfers.action_add_payee import ActionAddPayee
-from actions.transfers.action_ask_account_from import ActionAskAccountFrom
-from actions.transfers.action_check_payee_existence import ActionCheckPayeeExistence
-from actions.transfers.action_check_sufficient_funds import ActionCheckSufficientFunds
-from actions.transfers.action_list_payees import ActionListPayees
-from actions.transfers.action_process_immediate_payment import (
-    ActionProcessImmediatePayment,
-)
-from actions.transfers.action_remove_payee import ActionRemovePayee
-from actions.transfers.action_schedule_payment import ActionSchedulePayment
-from actions.transfers.action_validate_payment_date import ActionValidatePaymentDate
-
-__all__ = [
-    # General actions
-    "ActionSessionStart",
-    # Account actions
-    "ActionAskAccount",
-    "ActionCheckBalance",
-    # Card actions
-    "ActionAskCard",
-    "ActionCheckCardExistence",
-    "ActionUpdateCardStatus",
-    # Transfer actions
-    "ActionAddPayee",
-    "ActionAskAccountFrom",
-    "ActionCheckPayeeExistence",
-    "ActionCheckSufficientFunds",
-    "ActionListPayees",
-    "ActionProcessImmediatePayment",
-    "ActionRemovePayee",
-    "ActionSchedulePayment",
-    "ActionValidatePaymentDate",
-]

rasa/cli/project_templates/finance/actions/accounts/check_balance.py

@@ -0,0 +1,18 @@
+from typing import Any, Dict, List
+
+from rasa_sdk import Action, Tracker
+from rasa_sdk.events import SlotSet
+from rasa_sdk.executor import CollectingDispatcher
+
+from actions.db import get_account
+
+
+class CheckBalance(Action):
+    def name(self) -> str:
+        return "check_balance"
+
+    def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: Dict[str, Any]
+    ) -> List[Dict[str, Any]]:
+        account = get_account(tracker.sender_id)
+        return [SlotSet("current_balance", account.funds)]

rasa/cli/project_templates/finance/actions/actions.md

@@ -0,0 +1,15 @@
+## 📂 `actions/` – The Agent's Toolkit
+
+This folder contains Python files that define custom banking actions your agent can perform. Actions handle complex banking operations, database interactions, and business logic validation.
+
+**What you'll find:**
+- **accounts/**: Account-related actions (balance checking, account validation)
+- **cards/**: Card management actions (card existence checks, status updates)
+- **transfers/**: Payment and transfer actions (payee management, fund transfers, scheduling)
+- **contacts/**: Contact and advisor management
+- `database.py`: Core database interactions with banking data
+- `action_session_start.py`: Session initialization for banking context
+
+**Edit Python files in this folder** to add new banking features, modify business rules, or integrate with external banking APIs and systems.
+
+Learn more about custom actions in the [Rasa documentation](https://rasa.com/docs/pro/build/custom-actions).

rasa/cli/project_templates/finance/actions/{transfers/action_process_immediate_payment.py → cards/check_that_card_exists.py}

@@ -5,9 +5,9 @@ from rasa_sdk.events import SlotSet
 from rasa_sdk.executor import CollectingDispatcher
 
 
-class ActionProcessImmediatePayment(Action):
+class ActionCheckThatCardExists(Action):
     def name(self) -> Text:
-        return "action_process_immediate_payment"
+        return "check_that_card_exists"
 
     def run(
         self,
@@ -15,4 +15,7 @@ class ActionProcessImmediatePayment(Action):
         tracker: Tracker,
         domain: Dict[Text, Any],
     ) -> List[Dict[Text, Any]]:
-        return [SlotSet("payment_processed", True)]
+        # For example purposes, we assume the card exists; in a real situation,
+        # fetch this info from a database or service.
+        # card_number = tracker.get_slot("bank_card_number")
+        return [SlotSet("return_value", True)]

rasa/cli/project_templates/finance/actions/cards/list_cards.py

@@ -0,0 +1,22 @@
+from typing import Any, Dict, List
+
+from rasa_sdk import Action, Tracker
+from rasa_sdk.events import SlotSet
+from rasa_sdk.executor import CollectingDispatcher
+
+from actions.db import get_cards
+
+
+class ListCards(Action):
+    def name(self) -> str:
+        return "list_cards"
+
+    def run(
+        self, dispatcher: CollectingDispatcher, tracker: Tracker, domain: Dict[str, Any]
+    ) -> List[Dict[str, Any]]:
+        cards = get_cards(tracker.sender_id)
+        if len(cards) > 0:
+            cards_list = "".join([f"- {c.name} ({c.handle}) \n" for c in cards])
+            return [SlotSet("cards_list", cards_list)]
+        else:
+            return [SlotSet("cards_list", None)]