Allow customized details about function calling

[rgbkrk]

Let's add on to the ChatLab metadata decorator (see #38) to allow people to modify what the little details tab shows.

 𝑓  Flipped a coin!

Input:

{}

Output:

"tails"

As part of this we'll want metadata to be applied for the following states around the function (for use by our display calls)

• calling - While the function is "trying" to be called
• succeeded - what to show when the function successfully finishes
• failed - what to show when the function fails (an exception)

At its most basic, it could work like this:

@on_success("Flipped a coin!")
@on_failure("Failed to flip a coin. :(")
def flip_a_coin():
    '''Returns heads or tails'''
    return random.choice(['heads', 'tails'])

Advanced Formatting options

Since we work with named parameters, we could apply the arguments to strings with named parameters.

import requests
import chatlab

class PokemonFetchError(Exception):
    """An error for when we fail to fetch a pokemon, tailored for LLM output"""
    def __init__(self, pokemon_name):
        self.pokemon_name = pokemon_name
        self.message = f"Failed to fetch information for Pokemon '{self.pokemon_name}'. Please make sure the Pokemon name is correct."
        super().__init__(self.message)

@on_success("Go {name}!")
@on_failure("Failed to fetch Pokemon {name}")
def fetch_pokemon(name: str):
    """Fetch information about a pokemon by name"""
    url = f"https://pokeapi.co/api/v2/pokemon/{name}"
    try:
        response = requests.get(url)
        response.raise_for_status()  # will raise an HTTPError if the response status code is 4xx or 5xx
        return response.json()
    except requests.HTTPError:
        raise PokemonFetchError(name)

Get me information about murkrow.

 𝑓  Go murkrow!

Input:

{ "name": "murkrow" }

Output:

<<information about murkrow here>>

[rgbkrk]

Closing as this is effectively done via #136 and its also way more fun.