From d8c8b060af6b331052fdaf77ee9663af5c17aa19 Mon Sep 17 00:00:00 2001
From: Eric Gustin <34000337+EricGustin@users.noreply.github.com>
Date: Mon, 16 Dec 2024 18:32:03 -0800
Subject: [PATCH] Update `arcade chat` Help Menu (#170)

# PR Description
* Fixes available commands display bug
* Add `/history` command. Displays the conversation history.


```
Available Commands:
  /show         Show all available tools
  /history      Show the chat history
  /clear        Clear the chat history
  /exit         Exit the chat
  /?, /help     Help for a command

Surround in """ for multi-line messages
```
---
 arcade/arcade/cli/utils.py | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/arcade/arcade/cli/utils.py b/arcade/arcade/cli/utils.py
index 21aa61ad..16a7cccf 100644
--- a/arcade/arcade/cli/utils.py
+++ b/arcade/arcade/cli/utils.py
@@ -39,8 +39,10 @@ class OrderCommands(TyperGroup):
 
 
 class ChatCommand(str, Enum):
-    HELP = "/?"
+    HELP = "/help"
+    HELP_ALT = "/?"
     CLEAR = "/clear"
+    HISTORY = "/history"
     SHOW = "/show"
     EXIT = "/exit"
 
@@ -628,12 +630,13 @@ def display_chat_help() -> None:
     help_message = dedent(f"""\
         [default]
         Available Commands:
-          {ChatCommand.SHOW:<10} Show all available tools
-          {ChatCommand.CLEAR:<10} Clear the chat history
-          {ChatCommand.HELP:<10} Help for a command
-          {ChatCommand.EXIT:<10} Exit the chat
+          {ChatCommand.SHOW.value:<13} Show all available tools
+          {ChatCommand.HISTORY.value:<13} Show the chat history
+          {ChatCommand.CLEAR.value:<13} Clear the chat history
+          {ChatCommand.EXIT.value:<13} Exit the chat
+          {ChatCommand.HELP_ALT.value}, {ChatCommand.HELP.value:<9} Help for a command
 
-        Use \"\"\" to begin & end a multi-line message[/default]
+        Surround in \"\"\" for multi-line messages[/default]
     """)
     console.print(help_message)
 
@@ -650,11 +653,14 @@ def handle_user_command(
     """
     Handle user commands during `arcade chat` and return True if a command was processed, otherwise False.
     """
-    if user_input == ChatCommand.HELP:
+    if user_input in [ChatCommand.HELP, ChatCommand.HELP_ALT]:
         display_chat_help()
         return True
     elif user_input == ChatCommand.EXIT:
         raise KeyboardInterrupt
+    elif user_input == ChatCommand.HISTORY:
+        console.print(history)
+        return True
     elif user_input == ChatCommand.CLEAR:
         console.print("Chat history cleared.", style="bold green")
         history.clear()