from __future__ import annotations from datetime import datetime from pprint import pformat from typing import Any from langchain_core.messages import AIMessage, HumanMessage, RemoveMessage, SystemMessage, ToolMessage import config COLORS = { "blue": "\033[94m", "cyan": "\033[96m", "green": "\033[92m", "magenta": "\033[95m", "red": "\033[91m", "yellow": "\033[93m", "dim": "\033[2m", "reset": "\033[0m", } def _enabled() -> bool: return bool(getattr(config, "EXECUTION_LOGGING_ENABLED", True)) def _color(text: str, color: str) -> str: if not getattr(config, "EXECUTION_LOG_USE_COLOR", True): return text return f"{COLORS.get(color, '')}{text}{COLORS['reset']}" def _truncate(value: Any, max_chars: int | None = None) -> str: text = "" if value is None else str(value) limit = max_chars or getattr(config, "EXECUTION_LOG_MAX_CHARS", 1200) if len(text) <= limit: return text return f"{text[:limit]}... [truncated {len(text) - limit} chars]" def _message_role(message: Any) -> str: if isinstance(message, HumanMessage): return "human" if isinstance(message, AIMessage): return "ai" if isinstance(message, ToolMessage): return "tool" if isinstance(message, SystemMessage): return "system" if isinstance(message, RemoveMessage): return "remove" return message.__class__.__name__ def _message_preview(message: Any) -> dict[str, Any]: preview = { "type": _message_role(message), "id": getattr(message, "id", None), } if isinstance(message, RemoveMessage): return preview content = getattr(message, "content", "") if content: preview["content"] = _truncate(content) tool_calls = getattr(message, "tool_calls", None) if tool_calls: preview["tool_calls"] = [ { "name": call.get("name"), "args": call.get("args"), "id": call.get("id"), } for call in tool_calls ] tool_name = getattr(message, "name", None) if tool_name: preview["name"] = tool_name tool_call_id = getattr(message, "tool_call_id", None) if tool_call_id: preview["tool_call_id"] = tool_call_id return preview def _messages_preview(messages: list[Any]) -> dict[str, Any]: return { "count": len(messages), "last_messages": [_message_preview(message) for message in messages[-4:]], } def state_preview(state: Any) -> dict[str, Any]: if not isinstance(state, dict): return {"value": _truncate(state)} preview: dict[str, Any] = {} for key, value in state.items(): if key == "messages": preview[key] = _messages_preview(value or []) elif key in {"conversation_summary", "context_summary", "final_answer"}: preview[key] = _truncate(value) elif key == "agent_answers": preview[key] = { "count": len(value or []), "items": [ { "index": item.get("index"), "question": _truncate(item.get("question", ""), 240), "answer": _truncate(item.get("answer", ""), 500), } for item in (value or [])[:3] if isinstance(item, dict) ], } elif isinstance(value, set): preview[key] = sorted(value) else: preview[key] = value return preview def update_preview(update: Any) -> Any: if not isinstance(update, dict): return _truncate(update) preview: dict[str, Any] = {} for key, value in update.items(): if key == "messages": preview[key] = [_message_preview(message) for message in value] elif key in {"conversation_summary", "context_summary", "final_answer"}: preview[key] = _truncate(value) elif key == "agent_answers": preview[key] = state_preview({"agent_answers": value})["agent_answers"] elif isinstance(value, set): preview[key] = sorted(value) else: preview[key] = value return preview def _print_block(title: str, payload: Any, color: str) -> None: if not _enabled(): return timestamp = datetime.now().strftime("%H:%M:%S") print(_color(f"\n[{timestamp}] {title}", color)) print(_color("-" * 80, "dim")) print(pformat(payload, width=120, sort_dicts=False)) def log_chat_start(message: str, thread_id: str, has_pending_interrupt: bool) -> None: _print_block( "USER QUERY", { "thread_id": thread_id, "pending_interrupt": has_pending_interrupt, "message": _truncate(message), }, "blue", ) def log_chat_end(state: Any) -> None: _print_block("FINAL GRAPH STATE", state_preview(state), "blue") def log_node_start(name: str, state: Any) -> None: _print_block(f"NODE START: {name}", state_preview(state), "cyan") def log_node_end(name: str, update: Any) -> None: _print_block(f"NODE OUTPUT: {name}", update_preview(update), "green") def log_route(name: str, decision: Any, state: Any | None = None) -> None: payload = {"decision": _truncate(decision)} if state is not None: payload["state"] = state_preview(state) _print_block(f"ROUTE: {name}", payload, "yellow") def log_tool_start(name: str, args: dict[str, Any]) -> None: _print_block(f"TOOL START: {name}", args, "magenta") def log_tool_end(name: str, output: Any) -> None: _print_block(f"TOOL OUTPUT: {name}", {"output": _truncate(output)}, "magenta") def log_error(scope: str, error: Exception) -> None: _print_block(f"ERROR: {scope}", {"type": error.__class__.__name__, "message": str(error)}, "red") def logged_node(name: str, fn): def _wrapped(state, *args, **kwargs): log_node_start(name, state) try: result = fn(state, *args, **kwargs) except Exception as exc: log_error(name, exc) raise log_node_end(name, result) return result return _wrapped