--- IMPORTS ---

from datetime import datetime, timedelta import json # Kept for formatting hidden state

--- GLOBAL STATE VARIABLES ---

Time State

current_datetime_obj = datetime(2024, 7, 26, 8, 0, 0) # Example start time time_tracker = 0 # Minutes consumed by the last action

Character State

This list will hold strings describing the characters currently relevant/present.

current_characters = []

--- HELPER FUNCTIONS (TIME) ---

def format_datetime_for_display(dt_obj): """Formats a datetime object into a human-readable string.""" if not isinstance(dt_obj, datetime): return "Invalid Date Object" return dt_obj.strftime("%B %d, %Y %I:%M %p") # Example: July 26, 2024 08:00 AM

def format_datetime_for_state(dt_obj): """Formats a datetime object into an ISO-like string for state.""" if not isinstance(dt_obj, datetime): return "Invalid Date Object" return dt_obj.strftime("%Y-%m-%d %H:%M:%S") # Example: 2024-07-26 08:00:00

--- CORE TIME SYSTEM FUNCTION ---

def advance_time(minutes): """Advances the global game time by a specified number of minutes.""" global current_datetime_obj, time_tracker if not isinstance(minutes, (int, float)) or minutes < 0: print("Warning: Invalid time advancement value. Must be a non-negative number.") minutes = 0 time_tracker = int(minutes) if time_tracker > 0: try: current_datetime_obj += timedelta(minutes=time_tracker) # print(f"DEBUG: Time advanced by {time_tracker} minutes. New time: {format_datetime_for_display(current_datetime_obj)}") except OverflowError: print("ERROR: Date calculation resulted in an overflow.") time_tracker = 0 else: time_tracker = 0 # print("DEBUG: No time passed for action.")

--- CHARACTER MANAGEMENT FUNCTION ---

def set_current_characters(character_list): """ Updates the global list of currently relevant characters. Expects a list of strings, where each string describes a character. """ global current_characters if isinstance(character_list, list): # Basic validation: check if elements are strings (optional but good practice) if all(isinstance(item, str) for item in character_list): current_characters = character_list # print(f"DEBUG: Characters updated. {len(current_characters)} characters set.") else: print("Warning: Character list contains non-string elements. Characters not updated.") else: print("Warning: Invalid input for set_current_characters. Expected a list. Characters not updated.") # Decide on behavior: keep old list or clear it? Keeping old might be safer. # current_characters = [] # Option to clear if input is invalid

--- NARRATION & OUTPUT FUNCTIONS ---

def generate_response(narrative_text): """Generates the final output string including narrative, time footnote, and hidden state.""" final_output = str(narrative_text) # Ensure narrative is string final_output += "\n" + generate_dynamic_footnote() final_output += "\n" + generate_hidden_state() return final_output

def generate_dynamic_footnote(): """Generates the footnote string, containing only visible time information.""" formatted_dt = format_datetime_for_display(current_datetime_obj) lines = [ f"📅 Date & Time: {formatted_dt}", f"⏳ Last Action Time: {time_tracker} minutes" ] return "\n----\n".join(lines) + "\n----"

def generate_hidden_state(): """Generates a compact hidden state summary including time and characters.""" global current_characters # Ensure we are using the global variable state_summary = { "time_iso": format_datetime_for_state(current_datetime_obj), "last_action_minutes": time_tracker, # Add the current character list to the state "present_characters": current_characters } try: # Ensure compact formatting for the state state_string = json.dumps(state_summary, separators=(',', ':')) except Exception as e: print(f"Error formatting hidden state: {e}") state_string = str(state_summary) # Fallback return f"

--- MAIN EXAMPLE USAGE (Conceptual) ---

1. Initialization

print("Time and Character system initialized.")

Define the characters for the initial scene

initial_characters = [ "[Name: Principal Thompson Age: Mid 50s Body/Appearance: Solid, imposing build; formal, stiff posture.]", "[Alex: The Jock. Athletic build, confident air, often found near other popular kids.]", "[Ben: The Nerd. Often has a book or tablet, sits near the front, quiet unless spoken to about academics.]", "[Chris: The Class Clown. Restless energy, seeks opportunities for jokes, often whispers to neighbors.]", "[David: The hot guy. Often is seen surrounded by girls, but ignores them. thoughtful expression, tends to be quiet and observant.]", "[Ethan: The Rebel. Slouches in his seat, often wears headphones before class, skeptical expression.]", "[Finn: The Average Guy. Friendly, blends in, participates reasonably when called upon.]", "[Grace: The Popular Girl. Fashion-conscious, sits with her clique, often checking her phone discreetly.]", "[Hannah: The Overachiever. Sits upright, organized materials, hand often ready to shoot up.]", "[Isabelle: The Shy Girl. Avoids eye contact, sits near the side or back, speaks softly if called on.]", "[Jessica: The Gossip. Leans towards friends to whisper, watches social interactions keenly, bubbly.]", "[Katherine: The Activist. Engaged posture, often has pins or stickers related to causes, ready to debate.]", "[Lily: The Athlete. Energetic even when sitting, often wears sporty attire, focused and competitive.]" ]

Set these characters into the state

set_current_characters(initial_characters)

Initial scene narrative

initial_narrative = "The bell screams, signaling the start of another day at Northwood High. You step into the bustling hallway. Principal Thompson stands near the main office, observing the flow of students. You recognize many faces heading to their first period." print(generate_response(initial_narrative)) # Hidden state will include time and the full character list

2. Example Action: Walking to class (takes 5 minutes)

print("\n-- You walk towards your first class. --") action_narrative = "You navigate the crowded hallway, dodging backpacks and weaving through groups of chatting students. Some familiar faces blur past." advance_time(5)

Note: Character list remains the same unless explicitly changed by set_current_characters()

print(generate_response(action_narrative))

3. Example Action: Attending a class (takes 45 minutes) - Perhaps fewer characters are relevant now

print("\n-- You sit down in English class. --")

Let's say only a few specific students and the (unlisted) teacher are relevant now

class_characters = [ "[Ben: The Nerd. Sits near the front, already has his textbook open.]", "[Hannah: The Overachiever. Sits upright, pen poised over her notebook.]", "[Isabelle: The Shy Girl. Sits near the back corner, looking at her desk.]", "[Ethan: The Rebel. Slouches in the back row, discreetly untangling earbuds.]" # The Teacher isn't in the original list, but could be added here if needed for the scene: # "[Ms. Davis: English Teacher. Mid 40s, sharp eyes, holding a worn copy of Shakespeare.]" ] set_current_characters(class_characters) # Update the relevant characters for this scene action_narrative = "You find your usual seat in English class. Ms. Davis enters and begins the lesson on Macbeth. Ben is already taking notes, while Ethan looks half-asleep." advance_time(45) print(generate_response(action_narrative)) # Hidden state now shows the smaller list of characters

4. Example Action: Quick hallway chat (takes 2 minutes) - Different characters involved

print("\n-- Class ends, you chat with Alex in the hall. --") hallway_characters = [ "[Alex: The Jock. Leaning against the lockers, talking about the upcoming game.]" # Maybe Grace walks by: # "[Grace: The Popular Girl. Walks past with her friends, glancing your way.]" ] set_current_characters(hallway_characters) # Update characters again action_narrative = "As you leave English, you bump into Alex. He starts telling you about practice later today." advance_time(2) print(generate_response(action_narrative)) # Hidden state shows Alex (and maybe Grace)