Add performance timer decorator for monitoring tool latency

new file mode 100644

@@ -0,0 +1,27 @@

import time

import functools

def timer_decorator(func):

    """

    A simple decorator that logs the execution time of a function.

    Useful for agents to monitor tool performance and latency.

    """

    @functools.wraps(func)

    def wrapper(*args, **kwargs):

        start_time = time.perf_counter()

        result = func(*args, **kwargs)

        end_time = time.perf_counter()

        duration = end_time - start_time

        print(f"DEBUG: {func.__name__} took {duration:.4f} seconds to execute.")

        return result

    return wrapper

if __name__ == "__main__":

    # Example usage:

    @timer_decorator

    def example_tool():

        print("Executing tool logic...")

        time.sleep(0.5)

        return "Task complete"

    example_tool()