haive.agents.base.debug_utils
=============================

.. py:module:: haive.agents.base.debug_utils

.. autoapi-nested-parse::

   Debug utilities for agent execution with Rich UI.

   Provides comprehensive debugging and logging capabilities for agent execution,
   particularly focused on runnable config and recursion limit issues.



Classes
-------

.. autoapisummary::

   haive.agents.base.debug_utils.AgentDebugger


Functions
---------

.. autoapisummary::

   haive.agents.base.debug_utils.debug_runnable_config
   haive.agents.base.debug_utils.disable_agent_debugging
   haive.agents.base.debug_utils.enable_agent_debugging
   haive.agents.base.debug_utils.get_agent_debugger


Module Contents
---------------

.. py:class:: AgentDebugger(agent_name = 'Agent', enabled = False)

   Rich UI debugger for agent execution.

   Init  .

   :param agent_name: [TODO: Add description]
   :param enabled: [TODO: Add description]


   .. py:method:: disable()

      Disable debugging output.



   .. py:method:: enable()

      Enable debugging output.



   .. py:method:: log_agent_execution_start(input_data, config)

      Log the start of agent execution.



   .. py:method:: log_config_preparation(base_config, runtime_config, thread_id, kwargs)

      Log the config preparation process.



   .. py:method:: log_recursion_limit_flow(step, recursion_limit, source = '')

      Track recursion limit through the execution flow.



   .. py:method:: log_runnable_config(config, context = '')

      Log runnable config with rich formatting.



.. py:function:: debug_runnable_config(config, context = '', agent_name = 'Agent')

   Quick function to debug a runnable config.


.. py:function:: disable_agent_debugging()

   Disable global agent debugging.


.. py:function:: enable_agent_debugging()

   Enable global agent debugging.


.. py:function:: get_agent_debugger(agent_name = 'Agent')

   Get or create agent debugger.