feat: add LETTA_DEBUG env var for debug logging (#190)

Co-authored-by: Letta <noreply@letta.com>

src/utils/debug.ts

@@ -0,0 +1,43 @@
+// src/utils/debug.ts
+// Simple debug logging utility - only logs when LETTA_DEBUG env var is set
+
+/**
+ * Check if debug mode is enabled via LETTA_DEBUG env var
+ * Set LETTA_DEBUG=1 or LETTA_DEBUG=true to enable debug logging
+ */
+export function isDebugEnabled(): boolean {
+  const debug = process.env.LETTA_DEBUG;
+  return debug === "1" || debug === "true";
+}
+
+/**
+ * Log a debug message (only if LETTA_DEBUG is enabled)
+ * @param prefix - A prefix/tag for the log message (e.g., "check-approval")
+ * @param message - The message to log
+ * @param args - Additional arguments to log
+ */
+export function debugLog(
+  prefix: string,
+  message: string,
+  ...args: unknown[]
+): void {
+  if (isDebugEnabled()) {
+    console.log(`[${prefix}] ${message}`, ...args);
+  }
+}
+
+/**
+ * Log a debug warning (only if LETTA_DEBUG is enabled)
+ * @param prefix - A prefix/tag for the log message
+ * @param message - The message to log
+ * @param args - Additional arguments to log
+ */
+export function debugWarn(
+  prefix: string,
+  message: string,
+  ...args: unknown[]
+): void {
+  if (isDebugEnabled()) {
+    console.warn(`[${prefix}] ${message}`, ...args);
+  }
+}