langfuse

Langfuse is the LLM observability layer for joelclaw. Every LLM call produces a Langfuse trace with nested hierarchy, I/O, usage, cost, and attribution.

| Level | Created on | Ended on | Contains |

| joelclaw.session trace | sessionstart | sessionshutdown | userId, sessionId, tags, turn count | | session span | sessionstart | sessionshutdown | Channel, session type, turn count | | turn-N span | messagestart[user] | messageend[assistant] with text output | User input (clean), sourceChannel metadata |

L'instrument Joelclaw LLM appelle avec le traçage Langfuse. Couvre le SDK @langfuse/tracing, la hiérarchie d'observation (étendues, générations, outils, agents), propagateAttributes pour userId/sessionId/tags, l'extension pi-session (langfuse-cost) et l'intégration OTEL du bus système. À utiliser lors de l'ajout de traces Langfuse, du débogage de traces manquantes/interrompues, de la vérification des données de coût ou de l'amélioration de l'observabilité sur n'importe quelle surface LLM. Source : joelhooks/joelclaw.