agentic-rag / project /core /execution_logger.py
devank2000's picture
initial commit
b3b0ccd verified
Raw History Blame Contribute Delete
6.24 kB
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