Upload 23 files

.gitattributes

@@ -33,3 +33,7 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+pathways/Virelia/assets/Bartender01.png filter=lfs diff=lfs merge=lfs -text
+pathways/Virelia/assets/Seraphine01.png filter=lfs diff=lfs merge=lfs -text
+pathways/Virelia/assets/Seraphine02.mp4 filter=lfs diff=lfs merge=lfs -text
+pathways/Virelia/assets/VireliaInn.png filter=lfs diff=lfs merge=lfs -text

ai_llm.py

@@ -0,0 +1,70 @@
+from together import Together
+from openai import OpenAI
+import os
+import json
+
+class AI_LLM:
+    def __init__(self):
+        self.llm_version = os.getenv("LLM_VERSION")
+        if self.llm_version == "OPENAI":
+            self.client = OpenAI(api_key=os.getenv("OPENAI_API_KEY"))
+            self.model = "gpt-4.1-mini-2025-04-14"
+        else:
+            self.client = OpenAI(api_key=os.getenv("TOGETHER_API_KEY"), base_url="https://api.together.xyz/v1")
+            self.model = "meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8"
+        print(f"Using model: {self.model})")
+
+    def talk_to_LLM(self, messages, functions_list, functions_module, stage_key_values):
+        function_output = { "text": []}
+        completion = self.client.chat.completions.create(
+        model = self.model,
+        messages = messages,
+        tools = functions_list,
+        ).choices[0].message
+
+        if completion.tool_calls:
+            messages.append(completion)
+            for tool_call in completion.tool_calls:
+                function_name = tool_call.function.name
+                function_args = json.loads(tool_call.function.arguments)
+                function = getattr(functions_module, function_name, None)
+                if function:
+                    function_output = function(**function_args, stage_key_values=stage_key_values)
+                    for msg in function_output["text"]:
+                        messages.append({
+                            "role": "tool",
+                            "tool_call_id": tool_call.id,
+                            "content": msg,
+                        })
+                else:
+                    print(f"Function {function_name} not found in module {functions_module.__name__}")
+
+        else:
+            messages.append({
+                "role": "assistant",
+                "content": completion.content,
+            })
+            function_output["text"].append(completion.content)
+        
+        return function_output
+    
+    def get_structured_output(self, messages, structured_output_schema, functions_module, stage_key_values):
+        function_output = {"text": []}
+        completion = self.client.chat.completions.create(
+            model=self.model,
+            messages=messages,
+            response_format=structured_output_schema
+        ).choices[0].message
+
+        function = getattr(functions_module, "process_structured_output", None)
+        if function:
+            function_output = function(completion.content, stage_key_values=stage_key_values)
+        else:
+            print(f"Function 'process_structured_output' not found in module {functions_module.__name__}")
+            messages.append({
+                "role": "assistant",
+                "content": completion.content,
+            })
+            function_output["text"].append(completion.content)
+
+        return function_output

gradioIf.py

@@ -0,0 +1,136 @@
+import json
+import gradio as gr
+from ai_llm import AI_LLM
+from pathway import Pathway
+
+with open("pathways/Virelia/Virelia.json", "r") as file:
+    pathway_json = json.load(file)
+ai_llm = AI_LLM()
+temp_pathway = Pathway(pathway_json, ai_llm)
+
+# Initial chatbot messages
+initial_ui = temp_pathway.get_current_stage_inital_ui()
+chatbot_messages = []
+image_url = ""
+
+if initial_ui:
+    if "text" in initial_ui:
+        for msg in initial_ui["text"]:
+            chatbot_messages.append({
+                "role": "assistant",
+                "content": msg
+            })
+    if "image" in initial_ui:
+        image_url = initial_ui["image"]
+
+sessions = {}
+
+def initialize_session(request: gr.Request):
+    sessions[request.session_hash] = Pathway(pathway_json, ai_llm)
+
+def close_session(request: gr.Request):
+    if request.session_hash in sessions:
+        del sessions[request.session_hash]
+
+def next_turn(request:gr.Request, user_input, chatbot_history):
+    if user_input.strip() == "":
+        return "", chatbot_history, gr.update(), gr.update(), gr.update()
+    
+    pathway = sessions[request.session_hash]
+    chatbot_history.append({
+        "role": "user",
+        "content": user_input
+    })
+    pathway_complete, response, next_stage_ui, checker_ui = pathway.next_step(user_input)
+    for r in response["text"]:
+        chatbot_history.append({
+            "role": "assistant",
+            "content": r
+        })
+
+    if next_stage_ui:
+        if "text" in next_stage_ui:
+            for msg in next_stage_ui["text"]:
+                chatbot_history.append({
+                    "role": "assistant",
+                    "content": msg
+                })
+
+    if checker_ui:
+        checker_text = ""
+        checker_title = "Hint"
+        if "text" in checker_ui:
+            for msg in checker_ui["text"]:
+                checker_text += "<span style='color:orange; font-weight:bold;'>"
+                checker_text += msg + "</span><br>"
+        if "title" in checker_ui:
+            checker_title = checker_ui["title"]
+
+        chatbot_history.append(gr.ChatMessage(
+            role="assistant",
+            content=checker_text,
+            metadata={"title": "<span style='color:red; font-weight:bold;'>" + checker_title +"</span>", "status": "done"}
+        ))
+
+    if "image" in response:
+        stage_image = response["image"]
+    else:
+        stage_image = gr.update()
+
+    if "video" in response:
+        stage_video = gr.update(value=response["video"], visible=True)
+    else:
+        stage_video = gr.update(visible=False)
+
+    if pathway_complete:
+        chatbot_history.append({
+            "role": "assistant",
+            "content": "Congratulations! You have completed the quest."
+        })
+
+        pathway_complete_ui = pathway.get_pathway_complete_ui()
+        if pathway_complete_ui:
+            title = "Quest Complete"
+            text = ""
+            if "title" in pathway_complete_ui:
+                title = pathway_complete_ui["title"]
+            if "text" in pathway_complete_ui:
+                for msg in pathway_complete_ui["text"]:
+                    text += "<span style='color:orange; font-weight:bold;'>"
+                    text += msg + "</span><br>"
+            chatbot_history.append(gr.ChatMessage(
+                role="assistant",
+                content=text,
+                metadata={"title": "<span style='color:red; font-weight:bold;'>" + title + "</span>", "status": "done"}
+            ))
+        return gr.update(interactive=False, value=""), chatbot_history, stage_image, stage_video, gr.update(interactive=False)
+
+    return "", chatbot_history, stage_image, stage_video, gr.update()
+
+css = """
+button[aria-label="Clear"] {
+    display: none !important;
+}
+footer {display: none !important;}
+.gr-chatbot {
+    max-height: 500px; /* Set the maximum height */
+    overflow-y: auto;  /* Enable vertical scrolling for overflow */
+}
+"""
+
+with gr.Blocks(css=css) as chatbotDisplay:
+    with gr.Row():
+        with gr.Column(scale=1):
+            stage_image = gr.Image(value=image_url, show_label=False, show_download_button=False)
+            stage_video = gr.Video(show_label=False, show_download_button=False, visible=False, autoplay=True)
+        with gr.Column(scale=2):
+            chatBot = gr.Chatbot(chatbot_messages,type="messages", group_consecutive_messages=False, scale=2, show_label=False)
+            input = gr.Textbox(show_label=False, placeholder="Type your message here...", lines=1)
+            submit_btn = gr.Button("Submit")
+
+    input.submit(next_turn, [input, chatBot], [input, chatBot, stage_image, stage_video, submit_btn])
+    submit_btn.click(next_turn, [input, chatBot], [input, chatBot, stage_image, stage_video, submit_btn])
+    chatbotDisplay.load(initialize_session)
+    chatbotDisplay.close(close_session)
+
+chatbotDisplay.launch(share=False)

pathway.py

@@ -0,0 +1,36 @@
+from stage import Stage
+
+class Pathway:
+    def __init__(self, pathway_json, ai_llm):
+        self.pathway_json = pathway_json
+        self.ai_llm = ai_llm
+        self.pathway_complete = False
+
+        self.stages = {}
+        for stage_id, stage_data in self.pathway_json.items():
+            if stage_id != "pathway_complete":
+                self.stages[stage_id] = Stage(stage_data, ai_llm)
+        self.current_stage = self.stages["1"]
+    
+    def next_step(self, user_input):
+        next_stage_ui = None
+        stage_complete, response, checker_ui = self.current_stage.next_step(user_input)
+        if stage_complete:
+            print("***Stage Complete***.", self.current_stage.stage_json["name"])
+            self.current_stage = self.stages.get(self.current_stage.get_next_stage(), None)
+            if self.current_stage is None:
+                self.pathway_complete = True
+            else:
+                next_stage_ui = self.current_stage.get_initial_ui()
+
+        return self.pathway_complete, response, next_stage_ui, checker_ui
+    
+    def get_current_stage_inital_ui(self):
+        return self.current_stage.get_initial_ui()
+    
+    def get_pathway_complete_ui(self):
+        pathway_complete_ui = None
+        if "pathway_complete" in self.pathway_json:
+            if "ui" in self.pathway_json["pathway_complete"]:
+                pathway_complete_ui = self.pathway_json["pathway_complete"]["ui"]
+        return pathway_complete_ui

pathways/Virelia/Stage1.txt

@@ -0,0 +1,8 @@
+As the player makes their way toward the infamous Whispering Pines, they notice a small village nestled on the edge of the forest. 
+The buildings are simple, but the warm glow of hearth fires spills from the windows, offering a brief sense of comfort in the shadow of the dark woods ahead. At the heart of the village, they spot a humble inn, its sign creaking softly in the wind — The Pine’s Rest. 
+The player has a choice. Do they head toward the inn, eager to stock up on supplies and get some tips that might help them survive the dangers of Whispering Pines? Or do they head straight to Virelia on their own?
+
+More Instructions:
+- You can respond with structured function calls or a simple statement depending on the context
+- Use 'straight_to_Virelia_alone' if the player decides to head straight to the woods on their own
+- Use 'enter_inn' if the player decides to stop by at the inn

pathways/Virelia/Stage10.txt

@@ -0,0 +1,12 @@
+The player was warned about the bandits in the woods and was adviced to seek help before setting off. 
+Despite that, the player has decided to journey alone and must face the consequences. Allow the player to walk a little.
+Then the player should get attacked by bandits. The player has a sword and attempts to fight off the bandits.
+But they are far too many in number and the player dies. The game ends.
+
+Instructions:
+- Don't output more than 2-3 sentences at a time. Keep it clear and concise.
+- Allow the player to get deep into the woods before the bandits attack.
+- The player cannot overcome the bandits no matter what they do will die eventually.
+- You can respond with structured function calls or a simple statement depending on the context.
+- Do not call any function if you are unsure.
+- Use 'player_killed' when the player is killed by the bandits and the game ends.

pathways/Virelia/Stage10_functions.json

@@ -0,0 +1,16 @@
+[{
+    "type": "function",
+    "function": {
+        "name": "player_killed",
+        "description": "If the player is killed by bandits in the woods.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "details": {"type": "string"}
+            },
+            "required": ["details"],
+            "additionalProperties": false
+        }
+    },
+    "strict": true
+}]

pathways/Virelia/Stage10_functions_definition.py

@@ -0,0 +1,6 @@
+def player_killed(details, stage_key_values):
+    print("In player_killed function:", stage_key_values)
+    stage_key_values["stage_complete"] = True
+    return {
+        "text": [details]
+    }

pathways/Virelia/Stage1_functions.json

@@ -0,0 +1,18 @@
+[{
+    "type": "function",
+    "function": {
+        "name": "enter_inn",
+        "description": "Called if the player decides to enter the inn and ask for advice.",
+        "additionalProperties": false
+    },
+    "strict": true
+},
+{
+    "type": "function",
+    "function": {
+        "name": "straight_to_Virelia_alone",
+        "description": "Called if the player decides not to stop at The Pine’s Rest inn and heads straight to Virelia by themselves.",
+        "additionalProperties": false
+    },
+    "strict": true
+}]

pathways/Virelia/Stage1_functions_definition.py

@@ -0,0 +1,26 @@
+def enter_inn(stage_key_values):
+    print("In enter_inn function:", stage_key_values)
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "2"
+    return {
+        "text": ["Wise choice. The forest waits, but first, a brief stop may be the difference between life and death.",
+                 "The bartender greets you with a nod, and you take a seat at the bar.",
+                ],
+        "image": "pathways/Virelia/assets/Bartender01.png"
+    }
+
+def straight_to_Virelia_alone(stage_key_values):
+    print("In straight_to_Virelia_alone function:", stage_key_values)
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "10"
+    return {
+        "text": ["You have decided to go on the journey alone. Good luck with that!"]
+    }
+
+def forced_stage_exit(stage_key_values):
+    print("In forced_stage_exit function:", stage_key_values)
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "10"
+    return {
+        "text": ["You have taken too long to decide. You have been forced to leave and continue your journey alone. Good luck with that!"]
+    }

pathways/Virelia/Stage2.txt

@@ -0,0 +1,66 @@
+The player is greeted by the bartender as they enter the inn.
+The bartender serves as a guide for the player, but only when asked for advice. He will subtly steer the player toward Dame Seraphine as the only viable option for survival through the Whispering Pines, but he will not mention her directly unless asked. The bartender provides advice only when the player actively seeks it. Speak only as the bartender in short, simple sentences.
+
+Objective of the Interaction:-
+The bartender's main role is to encourage the player to seek out Dame Seraphine without giving too much information upfront. He should act as a guide but remain passive unless asked for advice. The player must actively engage with the bartender to learn about Seraphine and her location, ensuring that the discovery feels like a natural progression of the conversation rather than a forced narrative element.
+
+General Interaction Rules:-
+
+---------------------------------------
+1. Casual Conversation -
+
+Behavior: The bartender engages in casual conversation, asking the player about their travels, where they’re heading, or what brings them to the tavern. The bartender does not mention Seraphine unless the player brings up Virelia or the Whispering Pines.
+
+Sample Dialogue -
+
+Bartender: "What brings you into our humble tavern today, traveler? Passing through, or staying a while?"
+
+---------------------------------------
+2. When the player mentions Virelia or the Whispering Pines -
+
+Behavior: If the player mentions Virelia or the Whispering Pines (or shows an intent to travel through them), the bartender will express concern about the dangers of the journey, particularly the bandits.
+
+Sample Dialogue-
+
+Bartender: "Ah, Virelia, eh? You know, the forest through the Whispering Pines has been crawling with bandits lately. Not something you want to tackle alone. You’ll be a prime target out there, and the way those bandits strike... you won’t last without some help."
+
+---------------------------------------
+3. When the player asks for advice on survival - 
+
+Behavior: Only when the player asks for advice on how to survive the journey (such as asking about how to deal with the bandits or about potential allies), the bartender will recommend Dame Seraphine as the best choice. Call the function 'give_hint'.
+
+Gate: If the player has not asked for advice, the bartender will not directly mention Seraphine or offer any guidance. He will simply offer casual comments or warnings.
+
+Sample Dialogue (when advice is asked for):
+
+Bartender: "Well, if you want to survive that trek, you’ll need more than just good luck. There’s only one person I’d trust to keep you safe out there—Dame Seraphine the hero of the Crimson Dawn. She’s defeated the bandits countless times.  Best warrior around, smart, fearless. She’s your best bet."
+
+---------------------------------------
+4. When the player asks for more details about Seraphine - 
+The bartender should not offer any other information about Seraphine's past, skills, or backstory unless directly prompted by the player. The bartender describes Seraphine as the best, most skilled warrior and a necessary ally for survival. The bartender asks the Player if they want to hear the story of the Crimson Dawn. 
+
+If the player says they want to hear the story, the bartender will provide some of these details. call the function 'details_on_dame_seraphine'
+
+Most famously, she defeated the bandits during the Siege of the Crimson Dawn. The Siege was a tense and critical situation where the bandits had the town surrounded. She organized the local militias and devised a plan to protect the civilians, with time running out. The bandits underestimated the defenders, and Seraphine led a successful counterattack that caught the attackers off guard, ultimately routing them from the gates. The townspeople are forever grateful to her for her courage, skill and leadership.
+
+---------------------------------------
+5. When the player asks where they can find Seraphine - 
+Behavior: If the player specifically asks where Dame Seraphine is located, the bartender will give them directions to her, but only after the player has sought advice. The bartender will not offer this information until it is requested.
+
+Sample Dialogue (when asked about Seraphine's location):
+
+Bartender: "Ah, she’s sitting over by that table by the window, the one in the corner.  If you approach her right, you might just convince her to help you."
+
+Call the function 'approach_Seraphine'
+
+Restrictions -
+The bartender will not mention Seraphine unless the player explicitly asks for advice on how to survive or how to deal with the bandits.
+The bartender will not volunteer Seraphine’s location unless the player specifically asks where she is.
+
+---------------------------------------
+
+More Instructions:
+- Speak only as the bartender, in short 2 or 3 sentences.
+- You can respond with structured function calls or a simple statement spoken by the bartender depending on the context
+- Use 'straight_to_Virelia_alone' if the player says they don't need advice or if they decide not to engage Seraphine
+- Use 'approach_Seraphine' if the player asks where they can find Seraphine

pathways/Virelia/Stage2_functions.json

@@ -0,0 +1,58 @@
+[{
+    "type": "function",
+    "function": {
+        "name": "approach_Seraphine",
+        "description": "Called if the player decides to engage Seraphine or asks where they can find her",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "bartender_response": {"type": "string"}
+            },
+            "required": ["bartender_response"],
+            "additionalProperties": false
+        },
+        "additionalProperties": false
+    },
+    "strict": true
+},
+{
+    "type": "function",
+    "function": {
+        "name": "straight_to_Virelia_alone",
+        "description": "Called if the player does not ask for help or decides they are better off alone.",
+        "additionalProperties": false
+    },
+    "strict": true
+},
+{
+    "type": "function",
+    "function": {
+        "name": "give_hint",
+        "description": "Only when the player asks for advice on how to survive the journey (such as asking about how to deal with the bandits or about potential allies), the bartender will recommend Dame Seraphine as the best choice.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "bartender_hint": {"type": "string"}
+            },
+            "required": ["bartender_hint"],
+            "additionalProperties": false
+        },
+        "strict": true
+    }
+},
+{
+    "type": "function",
+    "function": {
+        "name": "details_on_dame_seraphine",
+        "description": "TThe bartender should not offer any other information about Seraphine's past, skills, or backstory unless directly prompted by the player. The bartender describes Seraphine as the best, most skilled warrior and a necessary ally for survival. If the player says they want to hear the story of the Crimson Dawn, the bartender will provide some of the details.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "details": {"type": "string"}
+            },
+            "required": ["details"],
+            "additionalProperties": false
+        },
+        "strict": true
+    }
+}]

pathways/Virelia/Stage2_functions_definition.py

@@ -0,0 +1,49 @@
+def approach_Seraphine(bartender_response, stage_key_values):
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "3"
+    return {
+        "text": [bartender_response],
+        "image": "pathways/Virelia/assets/Seraphine01.png",
+        "video": "pathways/Virelia/assets/Seraphine02.mp4"
+    }
+
+def straight_to_Virelia_alone(stage_key_values):
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "10"
+    return {
+        "text": ["You have decided to go on the journey alone. Good luck with that!"]
+    }
+
+def forced_stage_exit(stage_key_values):
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "10"
+    return {
+        "text": ["You have taken too long at the inn. You have been forced to leave and continue your journey alone. Good luck with that!"]
+    }
+
+def give_hint(bartender_hint, stage_key_values):
+    stage_key_values["hint_given"] = True
+    return {
+        "text": [bartender_hint]
+    }
+
+def details_on_dame_seraphine(details, stage_key_values):
+    stage_key_values["details_given"] = True
+    return {
+        "text": [details]
+    }
+
+def checker_function(stage_key_values):
+    stage_key_values["interaction_count_for_hint"] = 0
+    if stage_key_values.get("details_given", False):
+        return {
+            "text": ["Walk over to Seraphine and convince her to join you on your journey."]
+        }
+    elif stage_key_values.get("hint_given", False):
+        return {
+            "text": ["Find out why Seraphine maybe your best bet for a safe journey."]
+        }
+    
+    return {
+        "text": ["Ask for advice on how to get through the Whispering Pines safely."]
+    }

pathways/Virelia/Stage3.txt

@@ -0,0 +1,52 @@
+You are an expert in Cognitive Behavioral Therapy(CBT) in an AI dungeon game setting. You will evaluate the arguments of the player who is trying to help a NPC (Dame Seraphine) through her cognitive distortion. In the game, if the player succeeds in countering the distortion, they can persuade Dame Seraphine to join them on their journey. You assume the role of Dame Seraphine, the NPC, and evaluate the arguments made by the player using your expertise in CBT. 
+
+Here is the backstory for the game:
+
+As the player makes their way toward the infamous Whispering Pines, they notice a small village nestled on the edge of the forest. The buildings are simple, but the warm glow of hearth fires spills from the windows, offering a brief sense of comfort in the shadow of the dark woods ahead. At the heart of the village, they spot a humble inn, its sign creaking softly in the wind — The Pine’s Rest. 
+
+The player enters the inn and in conversation with the bartender learns about Dame Seraphine. It is now evident that convincing Seraphine to join them on their journey through the woods is critical for their safety. This is what the bartender said about Seraphine - 
+"Well, if you want to survive that trek, you’ll need more than just good luck. There’s only one person I’d trust to keep you safe out there — Dame Seraphine the hero of the Crimson Dawn. She’s defeated the bandits countless times.  Best warrior around, smart, fearless. She’s your best bet. Most famously, she defeated the bandits during the Siege of the Crimson Dawn. The Siege was a tense and critical situation where the bandits had the town surrounded. She organized the local militias and devised a plan to protect the civilians, with time running out. The bandits underestimated the defenders, and Seraphine led a successful counterattack that caught the attackers off guard, ultimately routing them from the gates. The townspeople are forever grateful to her for her courage, skill and leadership."
+
+The scene starts with the player approaching Seraphine and greeting her. Seraphine is polite and engages with the player. However she suffers from the cognitive distortion known as 'Discounting the positive'. The goal of the game is to teach the user how to counter the cognitive distortions that Seraphine is experiencing by reframing her distortions. You will play the role of Seraphine and speak only as her. When the player asks for help to cross the Whispering Pines, she will initially refuse and tell the Player that she is not the right person to help, that others might be better suited.
+
+If the Player asks about Crimson Dawn, this is a sample of what she might say - 
+"Ah, the Siege... Yes, it was... it was intense. The bandits had us surrounded. I organized the local militias, put together a plan to protect the civilians. We had to work quickly—time was running out. The bandits underestimated us, and we managed to turn the tide with a daring counterattack. We caught them off guard, routed them from the gates."
+
+"But... it wasn’t as heroic as it sounds. We got lucky. The bandits were disorganized, and they made mistakes. It wasn’t really because of anything I did. Anyone could have come up with a plan like that. It just... worked out."
+
+The player must provide a convincing argument that challenges Seraphine’s self-doubt and demonstrates her value. Do not put words in the player's mouth. The objective is to test if the player can make the argument. 
+
+----------------------------------------------
+Framework for Assessing the Player’s Argument:-
+To assess whether the player has made a convincing argument, we will use a framework based on three key criteria: 
+
+1. Empathy and Validation
+This category evaluates how well the player acknowledges Seraphine’s emotional state and validates her experiences. It measures the player's ability to make Seraphine feel heard and understood, while offering reassurance that her feelings are valid.
+
+Score 0 - Poor: The player does not acknowledge Seraphine’s emotions or dismisses her feelings.
+
+Score 1 - Fair: The player acknowledges Seraphine’s emotions but does so in a generic or detached way.
+
+Score 2 - Excellent: The player shows deep empathy, truly understanding Seraphine’s internal struggle and validating her feelings while reassuring her that her experience matters.
+
+2. Logical and Persuasive Argumentation
+This category measures the strength of the argument the player makes in challenging Seraphine's belief that her past successes were just luck. It evaluates how well the player uses evidence and logical reasoning to convince Seraphine of her own worth.
+
+Score 0 - Poor: The player fails to provide a strong argument, or the reasoning lacks clarity and is unconvincing.
+
+Score 1 - Fair: The player makes a reasonable argument but lacks structure, depth, or specificity in convincing Seraphine.
+
+Score 2 - Excellent: The player offers a clear, logical, and persuasive argument, using specific examples and detailed reasoning to directly challenge Seraphine’s distortion and reinforce her strengths.
+
+3. Challenge to the Distortion
+This category evaluates how well the player confronts Seraphine’s cognitive distortion (discounting the positive) and helps her reframe her negative self-assessment. It measures the depth of the challenge and whether the player effectively shifts Seraphine’s perspective.
+
+Score 0 - Poor: The player does not directly challenge the distortion or provides a weak challenge that doesn’t address Seraphine’s beliefs.
+
+Score 1 - Fair: The player points out the distortion but does so in a more indirect or generic way.
+
+Score 2 - Excellent: The player directly confronts the distortion and offers a well-supported, thoughtful reframing, encouraging Seraphine to recognize her true abilities.
+----------------------------------------------
+
+More Instructions:
+- Speak only as Seraphine, in short 2 or 3 sentences.

pathways/Virelia/Stage3_functions.json

@@ -0,0 +1,35 @@
+[{
+    "type": "function",
+    "function": {
+        "name": "assess_player_argument",
+        "description": "Called to assess the player's argument when trying to convince Seraphine that her past successes were not just luck, but a result of her own talent and hard work. The function evaluates the player's empathy, logical reasoning, and ability to challenge cognitive distortions.",
+        "parameters": {
+            "type": "object",
+            "properties": {
+                "empathy_and_validation": {
+                    "description": "Evaluates how well the player acknowledges Seraphine’s emotional state and validates her experiences. It measures the player's ability to make Seraphine feel heard and understood, while offering reassurance that her feelings are valid.",
+                    "type": "number",
+                    "enum": [0, 1, 2]
+                },
+                "logical_and_persuasive": {
+                    "description": "Measures the strength of the argument the player makes in challenging Seraphine's belief that her past successes were just luck. It evaluates how well the player uses evidence and logical reasoning to convince Seraphine of her own worth.",
+                    "type": "number",
+                    "enum": [0, 1, 2]
+                },
+                "challenges_distortion": {
+                    "description": "Evaluates how well the player confronts Seraphine’s cognitive distortion (discounting the positive) and helps her reframe her negative self-assessment. It measures the depth of the challenge and whether the player effectively shifts Seraphine’s perspective.",
+                    "type": "number",
+                    "enum": [0, 1, 2]
+                },
+                "Seraphine_response": {
+                    "description": "The response from Seraphine based on the player's argument assessment.",
+                    "type": "string"
+                }
+            },
+            "required": ["empathy_and_validation", "logical_and_persuasive", "challenges_distortion", "Seraphine_response"],
+            "additionalProperties": false
+        },
+        "additionalProperties": false
+    },
+    "strict": true
+}]

pathways/Virelia/Stage3_functions_definition.py

@@ -0,0 +1,56 @@
+import json
+
+def process_structured_output(output_json_str, stage_key_values):
+    output_json = json.loads(output_json_str)
+    print("-----", output_json)
+    argument_strength = 0
+    if "empathy_validation" in stage_key_values:
+        if stage_key_values["empathy_validation"] < output_json["empathy_validation"]:
+            stage_key_values["empathy_validation"] = output_json["empathy_validation"]
+    else:
+        stage_key_values["empathy_validation"] = output_json["empathy_validation"]
+    argument_strength += output_json["empathy_validation"]
+
+    if "logical_and_persuasive_argumentation" in stage_key_values:
+        if stage_key_values["logical_and_persuasive_argumentation"] < output_json["logical_and_persuasive_argumentation"]:
+            stage_key_values["logical_and_persuasive_argumentation"] = output_json["logical_and_persuasive_argumentation"]
+    else:
+        stage_key_values["logical_and_persuasive_argumentation"] = output_json["logical_and_persuasive_argumentation"]
+    argument_strength += output_json["logical_and_persuasive_argumentation"]
+
+    if "challenge_distortion" in stage_key_values:
+        if stage_key_values["challenge_distortion"] < output_json["challenge_distortion"]:
+            stage_key_values["challenge_distortion"] = output_json["challenge_distortion"]
+    else:
+        stage_key_values["challenge_distortion"] = output_json["challenge_distortion"]
+    argument_strength += output_json["challenge_distortion"]
+
+    if argument_strength >= 5:
+        stage_key_values["stage_complete"] = True
+
+        return {
+            "text": [output_json["Seraphine’s_response"], "Congratulations! You have successfully convinced Seraphine to join you on your journey!"]
+        }
+
+    return {
+        "text": [output_json["Seraphine’s_response"]]
+    }
+
+def forced_stage_exit(stage_key_values):
+    stage_key_values["stage_complete"] = True
+    stage_key_values["next_stage"] = "10"
+    return {
+        "text": ["You have taken too long to convince Seraphine. You have been forced to leave and continue your journey alone. Good luck with that!"]
+    }
+
+def checker_function(stage_key_values):
+    stage_key_values["interaction_count_for_hint"] = 0
+    hints = {"text": ["Try to incorporate the following in your arguments:"]}
+    if stage_key_values.get("empathy_validation", 0) < 2:
+        hints["text"].append(" - Empathize with Seraphine and understand her perspective.")
+    if stage_key_values.get("logical_and_persuasive_argumentation", 0) < 2:
+        hints["text"].append(" - Use logical arguments with evidence to persuade Seraphine.")
+    if stage_key_values.get("challenge_distortion", 0) < 2:
+        hints["text"].append(" - Seraphine suffers from the cognitive distortion known as 'Discounting the positive'. Challenge this distortion by providing a more appropriate reframing of her thoughts.")
+
+    return hints

pathways/Virelia/Virelia.json

@@ -0,0 +1,82 @@
+{
+    "1": {
+        "name": "Background",
+        "max_interactions": 10,
+        "interactions_for_hint": 3,
+        "prompt_file1": "pathways/Virelia/Virelia.txt",
+        "prompt_file2": "pathways/Virelia/Stage1.txt",
+        "functions_list": "pathways/Virelia/Stage1_functions.json",
+        "functions_definition": "pathways.Virelia.Stage1_functions_definition",
+        "ui": {
+            "text": ["You’re on your way to the lively town of Virelia, a place famous for its vibrant markets and friendly people. However, before you can reach it, you must navigate the perilous Whispering Pines—a dense, treacherous forest known to be home to dangerous bandits. The woods have claimed many travelers, and those who’ve entered without proper caution have often never returned.",
+            "As you approach the edge of the forest, you notice a small village nestled at the boundary. In the heart of the village stands a humble inn, The Pine’s Rest, its sign swaying in the chilly breeze. It seems like a wise stop to rest, gather supplies, and—more importantly—speak with the locals. They know the dangers of the Whispering Pines well and may offer valuable advice that could make all the difference in safely navigating the woods.",
+            "What will you do? Will you enter the inn and ask for advice before continuing your journey?"
+            ],
+            "image": "pathways/Virelia/assets/VireliaInn.png"
+        }
+    },
+    "10": {
+        "name": "Journey alone",
+        "prompt_file1": "pathways/Virelia/Virelia.txt",
+        "prompt_file2": "pathways/Virelia/Stage10.txt",
+        "functions_list": "pathways/Virelia/Stage10_functions.json",
+        "functions_definition": "pathways.Virelia.Stage10_functions_definition",
+        "ui": {
+            "text": ["Test-text: You decide to embark on your journey alone, leaving the tavern behind."]
+        }
+    },
+    "2": {
+        "name": "The bartender",
+        "prompt_file1": "pathways/Virelia/Virelia.txt",
+        "prompt_file2": "pathways/Virelia/Stage2.txt",
+        "functions_list": "pathways/Virelia/Stage2_functions.json",
+        "functions_definition": "pathways.Virelia.Stage2_functions_definition"
+    },
+    "3": {
+        "name": "Convince Seraphine",
+        "prompt_file1": "pathways/Virelia/Stage3.txt",
+        "structured_output_schema": {
+            "type": "json_schema",
+            "json_schema": {
+                "name": "assess_player_argument",
+                "schema" : {
+                    "type": "object",
+                    "properties": {
+                        "empathy_validation": {
+                            "type": "number",
+                            "enum": [0, 1, 2],
+                            "description": "Evaluates how well the player acknowledges Seraphine’s emotional state and validates her experiences. It measures the player's ability to make Seraphine feel heard and understood, while offering reassurance that her feelings are valid."
+                        },
+                        "logical_and_persuasive_argumentation": {
+                            "type": "number",
+                            "enum": [0, 1, 2],
+                            "description": "Evaluates the player's ability to present a logical and persuasive argument that addresses Seraphine's concerns. It measures how well the player articulates the benefits of joining them on their journey, while also considering Seraphine's emotional state."
+                        },
+                        "challenge_distortion": {
+                            "type": "number",
+                            "enum": [0, 1, 2],
+                            "description": "Evaluates the player's ability to challenge Seraphine's distortion, specifically 'Discounting the positive'. It measures how well the player helps Seraphine see a more balanced perspective on her situation and the potential for positive outcomes."
+                        },
+                        "Seraphine’s_response": {
+                            "type": "string",
+                            "description": "The response from Seraphine after the player has made their argument. It should reflect her emotional state and willingness to join the player on their journey."
+                        }
+                    },
+                    "required": ["empathy_validation", "logical_and_persuasive_argumentation", "challenge_distortion", "Seraphine’s_response"],
+                    "additionalProperties": false
+                },
+                "strict": true
+            }
+        },
+        "functions_definition": "pathways.Virelia.Stage3_functions_definition",
+        "ui": {
+            "text": ["Seraphine looks up at you as you approach her."]
+        }
+    },
+    "pathway_complete": {
+        "ui": {
+            "title": "Discounting the positive",
+            "text": ["The cognitive distortion 'Discounting the positive' is a common cognitive distortion where individuals tend to overlook or minimize positive experiences, achievements, or qualities. This can lead to a negative self-image and a skewed perception of reality. In the context of Seraphine, she struggles with this distortion, believing that her past mistakes overshadow any potential for future success or happiness.",  "Think about how this may apply to your life. Does this distortion resonate with you? Have you ever found yourself dismissing your own achievements or positive experiences? If so, how can you work towards recognizing and valuing the positive aspects of your life?"]
+        }
+    }
+}

pathways/Virelia/Virelia.txt

@@ -0,0 +1,10 @@
+Instructions:
+You are an AI game master. Your job is to create an adventure based on the descriptions provided and interactions with the user. 
+
+IMPORTANT RESTRICTION AND GATING INFORMATION: 
+Do not take action on behalf of the player.  
+Ask the player what they want to do before taking any action. 
+
+Game description:
+The player is on their way to the beautiful town of Virelia. On the road to Virelia, however, is the dense and foreboding Whispering Pines, an infamous forest known for ruthless bandits, waiting for the unwary to wander too close. Their ambushes are swift and merciless, and many travelers have never  emerged from the forest's depths. 
+But the journey is necessary—Virelia awaits, and the city holds answers to the quest that drives you forward. Yet, crossing Whispering Pines is no small feat.

pathways/Virelia/assets/Seraphine02.mp4

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:0acd4270e31d5df3bf0be75fc5fbfcff1dafb031ab1503bf59d71300e7354da7
+size 2792333

requirements.txt

@@ -0,0 +1,3 @@
+together==1.5.21
+gradio==5.37.0
+openai==1.95.1

stage.py

@@ -0,0 +1,106 @@
+import json
+import importlib
+import copy
+
+class Stage:
+    def __init__(self, stage_json, ai_llm, pathway_parameters=None):
+        self.stage_json = stage_json
+        self.ai_llm = ai_llm
+        if "ui" in stage_json:
+            self.ui = copy.deepcopy(stage_json["ui"])
+        else:
+            self.ui = {}
+
+        #If "text msgs are in the UI, add them to the ui component in the form of an llm message list"
+        if "text" in self.ui:
+            self.ui["text"] = []
+            for msg in stage_json["ui"]["text"]:
+                self.ui["text"].append({
+                    "role": "assistant",
+                    "content": msg
+                })
+        else:
+            self.ui["text"] = []
+            
+        #Any parameters that the stage wants to pass on to subsequent stages
+        self.stage_parameters = {}
+        #Key values that the stage will use to track its progress
+        self.stage_key_values = {
+            "stage_complete": False,
+            "next_stage": None,
+            "max_interactions": 10,
+            "interactions_for_hint": 3
+        }
+        if pathway_parameters:
+            self.stage_key_values["max_interactions"] = pathway_parameters.get("max_interactions", 10)
+            self.stage_key_values["interactions_for_hint"] = pathway_parameters.get("interactions_for_hint", 3)
+        if "max_interactions" in self.stage_json:
+            self.stage_key_values["max_interactions"] = self.stage_json["max_interactions"]
+        if "interactions_for_hint" in self.stage_json:
+            self.stage_key_values["interactions_for_hint"] = self.stage_json["interactions_for_hint"]
+
+        #Total number of interactions within the stage
+        self.stage_key_values["interaction_count"] = 0
+        #Number of interactions before each hint is given (different hints at different phases of the stage)
+        self.stage_key_values["interaction_count_for_hint"] = 0
+        self.stage_prompt = ""
+        file_no = 1
+        while "prompt_file" + str(file_no) in self.stage_json:
+            file_name = self.stage_json["prompt_file" + str(file_no)]
+            with open(file_name, "r") as file:
+                self.stage_prompt += file.read()
+            file_no += 1
+
+        self.llm_messages = [{"role": "system", "content": self.stage_prompt}]
+
+        self.functions_list = None
+        self.functions_module = None
+        self.structured_output_schema = None
+        if "structured_output_schema" in self.stage_json:
+            self.structured_output_schema = self.stage_json["structured_output_schema"]
+            self.functions_module = importlib.import_module(self.stage_json["functions_definition"])
+        elif "functions_list" in self.stage_json:
+            with open(self.stage_json["functions_list"], "r") as file:
+                self.functions_list = json.load(file)
+
+            self.functions_module = importlib.import_module(self.stage_json["functions_definition"])
+
+    def next_step(self, player_input):
+        self.stage_key_values["interaction_count"] += 1
+        self.stage_key_values["interaction_count_for_hint"] += 1
+        checker_ui = None
+        response_ui = {"text": [""]}
+        if not self.stage_key_values["stage_complete"]:
+            self.llm_messages.append({"role": "user", "content": player_input})
+            self.ui["text"].append({"role": "user", "content": player_input})
+            if self.structured_output_schema:
+                response_ui = self.ai_llm.get_structured_output(self.llm_messages, self.structured_output_schema, self.functions_module, self.stage_key_values)
+            else:
+                response_ui = self.ai_llm.talk_to_LLM(self.llm_messages, self.functions_list, self.functions_module, self.stage_key_values)
+            self.ui["text"].append({"role": "assistant", "content": response_ui["text"]})
+            if self.stage_key_values["interaction_count"] >= self.stage_key_values["max_interactions"]:
+                forced_exit_function = getattr(self.functions_module, "forced_stage_exit", None)
+                if forced_exit_function:
+                    forced_exit_msg = forced_exit_function(stage_key_values=self.stage_key_values)
+                    response_ui["text"] += forced_exit_msg["text"]
+                    self.ui["text"].append({"role": "assistant", "content": response_ui["text"]})
+                    return True, response_ui, checker_ui
+                else:
+                    print("No forced exit function found in module", self.functions_module.__name__ if self.functions_module else "None")
+            if self.stage_key_values["interaction_count_for_hint"] >= self.stage_key_values["interactions_for_hint"] and not self.stage_key_values["stage_complete"]:
+                checker_function = getattr(self.functions_module, "checker_function", None)
+                if checker_function:
+                    checker_ui = checker_function(stage_key_values=self.stage_key_values)
+                else:
+                    print("No checker function found in module", self.functions_module.__name__ if self.functions_module else "None")
+
+        return self.stage_key_values["stage_complete"], response_ui, checker_ui
+    
+    def get_next_stage(self):
+        return self.stage_key_values["next_stage"]
+    
+    def get_stage_parameters(self):
+        return self.get_stage_parameters
+    
+    def get_initial_ui(self):
+        return copy.deepcopy(self.stage_json.get("ui", None))