taleweave-ai/adventure/generate.py

from logging import getLogger
from random import choice, randint
from typing import List, Tuple

from packit.agent import Agent
from packit.loops import loop_retry
from packit.utils import could_be_json

from adventure.context import broadcast, set_current_world
from adventure.game_system import GameSystem
from adventure.models.config import DEFAULT_CONFIG, WorldConfig
from adventure.models.entity import (
    Actor,
    Effect,
    Item,
    NumberAttributeEffect,
    Portal,
    Room,
    StringAttributeEffect,
    World,
    WorldEntity,
)
from adventure.models.event import GenerateEvent
from adventure.utils import try_parse_float, try_parse_int
from adventure.utils.search import list_actors, list_items, list_rooms

logger = getLogger(__name__)

world_config: WorldConfig = DEFAULT_CONFIG.world

PROMPT_TYPE_FRAGMENTS = {
    "both": "Enter a positive or negative number, or a string value",
    "number": "Enter a positive or negative number",
    "string": "Enter a string value",
}

PROMPT_OPERATION_TYPES = {
    "set": "both",
    "add": "number",
    "subtract": "number",
    "multiply": "number",
    "divide": "number",
    "append": "string",
    "prepend": "string",
}

OPERATIONS = list(PROMPT_OPERATION_TYPES.keys())


def duplicate_name_parser(existing_names: List[str]):
    def name_parser(value: str, **kwargs):
        logger.debug(f"validating generated name: {value}")

        if value in existing_names:
            raise ValueError(f'"{value}" has already been used.')

        if could_be_json(value):
            raise ValueError("The name cannot contain JSON or other commands.")

        if '"' in value or ":" in value:
            raise ValueError("The name cannot contain quotes or colons.")

        if len(value) > 50:
            raise ValueError("The name cannot be longer than 50 characters.")

        return value

    return name_parser


def broadcast_generated(
    message: str | None = None,
    entity: WorldEntity | None = None,
):
    if message:
        event = GenerateEvent.from_name(message)
    elif entity:
        event = GenerateEvent.from_entity(entity)
    else:
        raise ValueError("Either message or entity must be provided")

    broadcast(event)


def generate_system_attributes(
    agent: Agent, world: World, entity: WorldEntity, systems: List[GameSystem]
) -> None:
    for system in systems:
        if system.generate:
            system.generate(agent, world.theme, entity)


def generate_room(
    agent: Agent,
    world: World,
    systems: List[GameSystem],
) -> Room:
    existing_rooms = [room.name for room in list_rooms(world)]

    name = loop_retry(
        agent,
        "Generate one room, area, or location that would make sense in the world of {world_theme}. "
        "Only respond with the room name in title case, do not include the description or any other text. "
        'Do not prefix the name with "the", do not wrap it in quotes. The existing rooms are: {existing_rooms}',
        context={
            "world_theme": world.theme,
            "existing_rooms": existing_rooms,
        },
        result_parser=duplicate_name_parser(existing_rooms),
    )

    broadcast_generated(message=f"Generating room: {name}")
    desc = agent(
        "Generate a detailed description of the {name} area. What does it look like? "
        "What does it smell like? What can be seen or heard?",
        name=name,
    )

    actions = {}
    room = Room(name=name, description=desc, items=[], actors=[], actions=actions)

    item_count = randint(
        world_config.size.room_items.min, world_config.size.room_items.max
    )
    broadcast_generated(f"Generating {item_count} items for room: {name}")

    for _ in range(item_count):
        try:
            item = generate_item(
                agent,
                world,
                systems=systems,
                dest_room=room,
            )
            broadcast_generated(entity=item)

            room.items.append(item)
        except Exception:
            logger.exception("error generating item")

    actor_count = randint(
        world_config.size.room_actors.min, world_config.size.room_actors.max
    )
    broadcast_generated(message=f"Generating {actor_count} actors for room: {name}")

    for _ in range(actor_count):
        try:
            actor = generate_actor(
                agent,
                world,
                systems=systems,
                dest_room=room,
            )
            broadcast_generated(entity=actor)

            room.actors.append(actor)
        except Exception:
            logger.exception("error generating actor")
            continue

    return room


def generate_portals(
    agent: Agent,
    world: World,
    source_room: Room,
    dest_room: Room,
    systems: List[GameSystem],
) -> Tuple[Portal, Portal]:
    existing_source_portals = [portal.name for portal in source_room.portals]
    existing_dest_portals = [portal.name for portal in dest_room.portals]

    outgoing_name = loop_retry(
        agent,
        "Generate the name of a portal that leads from the {source_room} room to the {dest_room} room and fits the world theme of {world_theme}. "
        "Some example portal names are: 'door', 'gate', 'archway', 'staircase', 'trapdoor', 'mirror', and 'magic circle'. "
        "Only respond with the portal name in title case, do not include a description or any other text. "
        'Do not prefix the name with "the", do not wrap it in quotes. Use a unique name. '
        "Do not create any duplicate portals in the same room. The existing portals are: {existing_portals}",
        context={
            "source_room": source_room.name,
            "dest_room": dest_room.name,
            "existing_portals": existing_source_portals,
            "world_theme": world.theme,
        },
        result_parser=duplicate_name_parser(existing_source_portals),
    )
    broadcast_generated(message=f"Generating portal: {outgoing_name}")

    incoming_name = loop_retry(
        agent,
        "Generate the opposite name of the portal that leads from the {dest_room} room to the {source_room} room. "
        "The name should be the opposite of the {outgoing_name} portal and should fit the world theme of {world_theme}. "
        "Some example portal names are: 'door', 'gate', 'archway', 'staircase', 'trapdoor', 'mirror', and 'magic circle'. "
        "Only respond with the portal name in title case, do not include a description or any other text. "
        'Do not prefix the name with "the", do not wrap it in quotes. Use a unique name. '
        "Do not create any duplicate portals in the same room. The existing portals are: {existing_portals}",
        context={
            "source_room": source_room.name,
            "dest_room": dest_room.name,
            "existing_portals": existing_dest_portals,
            "world_theme": world.theme,
            "outgoing_name": outgoing_name,
        },
        result_parser=duplicate_name_parser(existing_dest_portals),
    )

    broadcast_generated(message=f"Linking {outgoing_name} to {incoming_name}")

    outgoing_portal = Portal(
        name=outgoing_name,
        description=f"A {outgoing_name} leads to the {dest_room.name} room.",
        destination=dest_room.name,
    )
    generate_system_attributes(agent, world, outgoing_portal, systems)

    incoming_portal = Portal(
        name=incoming_name,
        description=f"A {incoming_name} leads to the {source_room.name} room.",
        destination=source_room.name,
    )
    generate_system_attributes(agent, world, incoming_portal, systems)

    return (outgoing_portal, incoming_portal)


def generate_item(
    agent: Agent,
    world: World,
    systems: List[GameSystem],
    dest_room: Room | None = None,
    dest_actor: Actor | None = None,
) -> Item:
    existing_items = [
        item.name
        for item in list_items(
            world, include_actor_inventory=True, include_item_inventory=True
        )
    ]
    if dest_actor:
        dest_note = f"The item will be held by the {dest_actor.name} character"
    elif dest_room:
        dest_note = f"The item will be placed in the {dest_room.name} room"
    else:
        dest_note = "The item will be placed in the world"

    name = loop_retry(
        agent,
        "Generate one item or object that would make sense in the world of {world_theme}. {dest_note}. "
        "Only respond with the item name in title case, do not include a description or any other text. Do not prefix the "
        'name with "the", do not wrap it in quotes. Do not include the name of the room. Use a unique name. '
        "Do not create any duplicate items in the same room. Do not give characters any duplicate items. "
        "The existing items are: {existing_items}",
        context={
            "dest_note": dest_note,
            "existing_items": existing_items,
            "world_theme": world.theme,
        },
        result_parser=duplicate_name_parser(existing_items),
    )

    broadcast_generated(message=f"Generating item: {name}")
    desc = agent(
        "Generate a detailed description of the {name} item. What does it look like? What is it made of? What does it do?",
        name=name,
    )

    actions = {}
    item = Item(name=name, description=desc, actions=actions)
    generate_system_attributes(agent, world, item, systems)

    effect_count = randint(
        world_config.size.item_effects.min, world_config.size.item_effects.max
    )
    broadcast_generated(message=f"Generating {effect_count} effects for item: {name}")

    for _ in range(effect_count):
        try:
            effect = generate_effect(agent, world, entity=item)
            item.effects.append(effect)
        except Exception:
            logger.exception("error generating effect")

    return item


def generate_actor(
    agent: Agent,
    world: World,
    systems: List[GameSystem],
    dest_room: Room,
) -> Actor:
    existing_actors = [actor.name for actor in list_actors(world)]
    name = loop_retry(
        agent,
        "Generate one person or creature that would make sense in the world of {world_theme}. "
        "The character will be placed in the {dest_room} room. "
        "Only respond with the character name in title case, do not include a description or any other text. "
        'Do not prefix the name with "the", do not wrap it in quotes. '
        "Do not include the name of the room. Do not give characters any duplicate names."
        "Do not create any duplicate characters. The existing characters are: {existing_actors}",
        context={
            "dest_room": dest_room.name,
            "existing_actors": existing_actors,
            "world_theme": world.theme,
        },
        result_parser=duplicate_name_parser(existing_actors),
    )

    broadcast_generated(message=f"Generating actor: {name}")
    description = agent(
        "Generate a detailed description of the {name} character. What do they look like? What are they wearing? "
        "What are they doing? Describe their appearance from the perspective of an outside observer."
        "Do not include the room or any other characters in the description, because they will move around.",
        name=name,
    )
    backstory = agent(
        "Generate a backstory for the {name} actor. Where are they from? What are they doing here? What are their "
        'goals? Make sure to phrase the backstory in the second person, starting with "you are" and speaking directly to {name}.',
        name=name,
    )

    actor = Actor(
        name=name, backstory=backstory, description=description, actions={}, items=[]
    )
    generate_system_attributes(agent, world, actor, systems)

    # generate the actor's inventory
    item_count = randint(
        world_config.size.actor_items.min, world_config.size.actor_items.max
    )
    broadcast_generated(f"Generating {item_count} items for actor {name}")

    for k in range(item_count):
        try:
            item = generate_item(
                agent,
                world,
                systems,
                dest_actor=actor,
            )
            generate_system_attributes(agent, world, item, systems)
            broadcast_generated(entity=item)

            actor.items.append(item)
        except Exception:
            logger.exception("error generating item")

    return actor


def generate_effect(agent: Agent, world: World, entity: Item) -> Effect:
    entity_type = entity.type
    existing_effects = [effect.name for effect in entity.effects]

    name = loop_retry(
        agent,
        "Generate one effect for an {entity_type} named {entity_name} that would make sense in the world of {theme}. "
        "Only respond with the effect name in title case, do not include a description or any other text. "
        'Do not prefix the name with "the", do not wrap it in quotes. Use a unique name. '
        "Do not create any duplicate effects on the same item. The existing effects are: {existing_effects}. "
        "Some example effects are: 'fire', 'poison', 'frost', 'haste', 'slow', and 'heal'.",
        context={
            "entity_name": entity.name,
            "entity_type": entity_type,
            "existing_effects": existing_effects,
            "theme": world.theme,
        },
        result_parser=duplicate_name_parser(existing_effects),
    )
    broadcast_generated(message=f"Generating effect: {name}")

    description = agent(
        "Generate a detailed description of the {name} effect. What does it look like? What does it do? "
        "How does it affect the target? Describe the effect from the perspective of an outside observer.",
        name=name,
    )

    attribute_names = agent(
        "Generate a short list of attributes that the {name} effect modifies. Include 1 to 3 attributes. "
        "For example, 'heal' increases the target's 'health' attribute, while 'poison' decreases it. "
        "Use a comma-separated list of attribute names, such as 'health, strength, speed'. "
        "Only include the attribute names, do not include the question or any JSON.",
        name=name,
    )

    def operation_parser(value: str, **kwargs):
        if value not in OPERATIONS:
            raise ValueError(
                f'"{value}" is not a valid operation. Choose from: {OPERATIONS}'
            )

        return value

    attributes = []
    for attribute_name in attribute_names.split(","):
        attribute_name = attribute_name.strip()
        if attribute_name:
            operation = loop_retry(
                agent,
                f"How does the {name} effect modify the {attribute_name} attribute? "
                "For example, 'heal' might 'add' to the 'health' attribute, while 'poison' might 'subtract' from it."
                "Another example is 'writing' might 'set' the 'text' attribute, while 'break' might 'set' the 'condition' attribute."
                "Reply with the operation only, without any other text. Respond with a single word for the list of operations."
                "Choose from the following operations: {operations}",
                context={
                    "name": name,
                    "attribute_name": attribute_name,
                    "operations": OPERATIONS,
                },
                result_parser=operation_parser,
            )

            operation_type = PROMPT_OPERATION_TYPES[operation]
            operation_prompt = PROMPT_TYPE_FRAGMENTS[operation_type]

            value = agent(
                f"How much does the {name} effect modify the {attribute_name} attribute? "
                "For example, heal might add '10' to the health attribute, while poison might subtract '5' from it."
                f"{operation_prompt}. Do not include any other text. Do not use JSON.",
                name=name,
                attribute_name=attribute_name,
            )
            value = value.strip()

            int_value = try_parse_int(value)
            if int_value is not None:
                attribute_effect = NumberAttributeEffect(
                    name=attribute_name, operation=operation, value=int_value
                )
            else:
                float_value = try_parse_float(value)
                if float_value is not None:
                    attribute_effect = NumberAttributeEffect(
                        name=attribute_name, operation=operation, value=float_value
                    )
                else:
                    attribute_effect = StringAttributeEffect(
                        name=attribute_name, operation=operation, value=value
                    )

            attributes.append(attribute_effect)

    return Effect(name=name, description=description, attributes=attributes)


def generate_world(
    agent: Agent,
    name: str,
    theme: str,
    systems: List[GameSystem],
    room_count: int | None = None,
) -> World:
    room_count = room_count or randint(
        world_config.size.rooms.min, world_config.size.rooms.max
    )

    broadcast_generated(message=f"Generating a {theme} with {room_count} rooms")
    world = World(name=name, rooms=[], theme=theme, order=[])
    set_current_world(world)

    # generate the rooms
    for _ in range(room_count):
        try:
            room = generate_room(agent, world, systems)
            generate_system_attributes(agent, world, room, systems)
            broadcast_generated(entity=room)
            world.rooms.append(room)
        except Exception:
            logger.exception("error generating room")
            continue

    # generate portals to link the rooms together
    for room in world.rooms:
        num_portals = randint(
            world_config.size.portals.min, world_config.size.portals.max
        )

        if len(room.portals) >= num_portals:
            logger.info(f"room {room.name} already has enough portals")
            continue

        broadcast_generated(
            message=f"Generating {num_portals} portals for room: {room.name}"
        )

        for _ in range(num_portals):
            previous_destinations = [portal.destination for portal in room.portals] + [
                room.name
            ]
            remaining_rooms = [
                r for r in world.rooms if r.name not in previous_destinations
            ]
            if len(remaining_rooms) == 0:
                logger.info(f"no more rooms to link to from {room.name}")
                break

            # TODO: prompt the DM to choose a destination room
            dest_room = choice(
                [r for r in world.rooms if r.name not in previous_destinations]
            )

            try:
                outgoing_portal, incoming_portal = generate_portals(
                    agent, world, room, dest_room, systems
                )

                room.portals.append(outgoing_portal)
                dest_room.portals.append(incoming_portal)
            except Exception:
                logger.exception("error generating portal")
                continue

    # ensure actors act in a stable order
    world.order = [actor.name for room in world.rooms for actor in room.actors]
    return world