@agentuity/telemetry 3.0.0-alpha.0

package/dist/fetch.js

@@ -0,0 +1,82 @@
+import { context, propagation, SpanStatusCode, trace } from '@opentelemetry/api';
+/**
+ * Reference to the original fetch function before instrumentation
+ */
+export const __originalFetch = fetch; // save the original fetch before we patch it
+/**
+ * Instruments the global fetch function with OpenTelemetry tracing
+ *
+ * Replaces the global fetch with an instrumented version that creates spans
+ * for each HTTP request and propagates trace context in headers
+ */
+export function instrumentFetch() {
+    const patch = async (input, init) => {
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+        const method = init?.method ||
+            (typeof input !== 'string' && !(input instanceof URL) ? input.method || 'GET' : 'GET');
+        // Get the active span if it exists
+        const activeSpan = trace.getActiveSpan();
+        // If there's no active span, just call the original fetch
+        if (!activeSpan) {
+            return __originalFetch(input, init);
+        }
+        // Get the current active context
+        const currentContext = context.active();
+        const _url = new URL(url);
+        // Create a child span using the current context
+        const childSpan = trace.getTracer('fetch').startSpan(`${method} ${_url.pathname}`, {
+            attributes: {
+                'http.url': url,
+                'http.path': _url.pathname,
+                'http.method': method,
+                host: _url.host,
+            },
+        }, currentContext);
+        try {
+            // Prepare trace context injection
+            const carrier = {};
+            // Create a new context with the child span
+            const newContext = trace.setSpan(currentContext, childSpan);
+            // Use the new context for propagation
+            propagation.inject(newContext, carrier);
+            // Preserve original headers and add trace context
+            // Handle headers from both Request input and init parameter
+            const baseHeaders = typeof input !== 'string' && !(input instanceof URL) && input instanceof Request
+                ? input.headers
+                : undefined;
+            const headers = new Headers(baseHeaders ?? init?.headers ?? {});
+            // Add trace context headers (overwriting any already present)
+            for (const [key, value] of Object.entries(carrier)) {
+                headers.set(key, value);
+            }
+            // Create new init object with updated headers
+            const newInit = {
+                ...init,
+                headers,
+            };
+            const response = await __originalFetch(input, newInit);
+            // Add response attributes to span
+            childSpan.setAttributes({
+                'http.status_code': response.status,
+                'http.user_agent': response.headers.get('user-agent') || '',
+            });
+            if (!response.ok) {
+                childSpan.setStatus({ code: SpanStatusCode.ERROR });
+            }
+            else {
+                childSpan.setStatus({ code: SpanStatusCode.OK });
+            }
+            return response;
+        }
+        catch (error) {
+            childSpan.recordException(error);
+            childSpan.setStatus({ code: SpanStatusCode.ERROR });
+            throw error;
+        }
+        finally {
+            childSpan.end();
+        }
+    };
+    globalThis.fetch = patch;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"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"}

package/dist/globals.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Global state for Telemetry instance (survives hot reloads)
+ */
+import type { TelemetryResponse } from './telemetry';
+export declare const telemetry: {
+    get: () => TelemetryResponse | undefined;
+    set: (v: TelemetryResponse) => void;
+};
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,eAAO,MAAM,SAAS;eACZ,iBAAiB,GAAG,SAAS;aAE7B,iBAAiB,KAAG,IAAI;CAGjC,CAAC"}

package/dist/globals.js

@@ -0,0 +1,13 @@
+/**
+ * Global state for Telemetry instance (survives hot reloads)
+ */
+const telemetryInstanceKey = Symbol.for('@agentuity/telemetry:instance');
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const g = globalThis;
+export const telemetry = {
+    get: () => g[telemetryInstanceKey],
+    set: (v) => {
+        g[telemetryInstanceKey] = v;
+    },
+};
+//# sourceMappingURL=globals.js.map

package/dist/globals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.js","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAEzE,8DAA8D;AAC9D,MAAM,CAAC,GAAG,UAAiB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG;IACxB,GAAG,EAAE,GAAkC,EAAE,CACxC,CAAC,CAAC,oBAAoB,CAAkC;IACzD,GAAG,EAAE,CAAC,CAAoB,EAAQ,EAAE;QACnC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACD,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,16 @@
+import { propagation } from '@opentelemetry/api';
+/**
+ * Injects trace context into response headers using the OpenTelemetry propagation API
+ *
+ * @param headers - Optional existing headers to include
+ * @returns A record of headers with trace context injected
+ */
+export declare function injectTraceContextToHeaders(headers?: Record<string, string> | Headers): Record<string, string>;
+/**
+ * Extracts trace context from Bun Request headers
+ *
+ * @param req - The Bun Request object
+ * @returns The context with trace information
+ */
+export declare function extractTraceContextFromRequest(req: Request): ReturnType<typeof propagation.extract>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAC1C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAY,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoBxB;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC7C,GAAG,EAAE,OAAO,GACV,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,CAAC,CAYxC"}

package/dist/http.js

@@ -0,0 +1,44 @@
+import { context, propagation } from '@opentelemetry/api';
+/**
+ * Injects trace context into response headers using the OpenTelemetry propagation API
+ *
+ * @param headers - Optional existing headers to include
+ * @returns A record of headers with trace context injected
+ */
+export function injectTraceContextToHeaders(headers = {}) {
+    let _headers;
+    if (headers instanceof Headers) {
+        _headers = {};
+        headers.forEach((v, k) => {
+            _headers[k] = v;
+        });
+    }
+    else {
+        _headers = { ...headers };
+    }
+    // Create a carrier object for the headers
+    const carrier = { ..._headers };
+    // Get the current context
+    const currentContext = context.active();
+    // Inject trace context into the carrier
+    propagation.inject(currentContext, carrier);
+    return carrier;
+}
+/**
+ * Extracts trace context from Bun Request headers
+ *
+ * @param req - The Bun Request object
+ * @returns The context with trace information
+ */
+export function extractTraceContextFromRequest(req) {
+    // Create a carrier object from the headers
+    const carrier = {};
+    // Convert headers to the format expected by the propagator
+    req.headers.forEach((value, key) => {
+        carrier[key.toLowerCase()] = value;
+    });
+    // Extract the context using the global propagator
+    const activeContext = context.active();
+    return propagation.extract(activeContext, carrier);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAC1C,UAA4C,EAAE;IAE9C,IAAI,QAAgC,CAAC;IACrC,IAAI,OAAO,YAAY,OAAO,EAAE,CAAC;QAChC,QAAQ,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACJ,CAAC;SAAM,CAAC;QACP,QAAQ,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,0CAA0C;IAC1C,MAAM,OAAO,GAA2B,EAAE,GAAG,QAAQ,EAA4B,CAAC;IAElF,0BAA0B;IAC1B,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAExC,wCAAwC;IACxC,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAE5C,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC7C,GAAY;IAEZ,2CAA2C;IAC3C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,2DAA2D;IAC3D,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAClC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,kDAAkD;IAClD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACvC,OAAO,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @agentuity/telemetry - OpenTelemetry telemetry for Agentuity
+ *
+ * Auto-initializes from environment variables on import (Vercel-style).
+ *
+ * @example Automatic initialization (recommended)
+ * ```typescript
+ * // Just import - auto-configures from AGENTUITY_* env vars
+ * import '@agentuity/telemetry';
+ *
+ * // Then access the globals anywhere
+ * import { tracer, logger, meter } from '@agentuity/telemetry';
+ * ```
+ *
+ * @example Explicit configuration
+ * ```typescript
+ * import { register } from '@agentuity/telemetry';
+ *
+ * register({
+ *   name: 'my-app',
+ *   version: '1.0.0',
+ *   // ... optional overrides
+ * });
+ * ```
+ */
+export type { Logger } from './logger';
+export { __originalConsole } from './logger';
+export type { TelemetryConfig, TelemetryResponse } from './telemetry';
+export { injectTraceContextToHeaders, extractTraceContextFromRequest } from './http';
+export { enrichContextWithTraceState, generateTraceId, generateSpanId, type TraceStateEntries, } from './tracestate';
+export { register, registerTelemetry, getTelemetry, ensureInitialized } from './telemetry';
+import type { Tracer, Meter } from '@opentelemetry/api';
+import type { Logger } from './logger';
+/**
+ * Get the OpenTelemetry tracer (auto-initialized)
+ */
+export declare const tracer: Tracer;
+/**
+ * Get the OpenTelemetry meter (auto-initialized)
+ */
+export declare const meter: Meter;
+/**
+ * Get the Logger instance (auto-initialized)
+ */
+export declare const logger: Logger;
+/**
+ * Shutdown telemetry (call on process exit)
+ */
+export declare function shutdown(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,QAAQ,CAAC;AAGrF,OAAO,EACN,2BAA2B,EAC3B,eAAe,EACf,cAAc,EACd,KAAK,iBAAiB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG3F,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAEnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK,EAAE,KAElB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,MAEnB,CAAC;AAEH;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAK9C"}

package/dist/index.js

@@ -0,0 +1,62 @@
+/**
+ * @agentuity/telemetry - OpenTelemetry telemetry for Agentuity
+ *
+ * Auto-initializes from environment variables on import (Vercel-style).
+ *
+ * @example Automatic initialization (recommended)
+ * ```typescript
+ * // Just import - auto-configures from AGENTUITY_* env vars
+ * import '@agentuity/telemetry';
+ *
+ * // Then access the globals anywhere
+ * import { tracer, logger, meter } from '@agentuity/telemetry';
+ * ```
+ *
+ * @example Explicit configuration
+ * ```typescript
+ * import { register } from '@agentuity/telemetry';
+ *
+ * register({
+ *   name: 'my-app',
+ *   version: '1.0.0',
+ *   // ... optional overrides
+ * });
+ * ```
+ */
+// Re-export console reference for custom loggers
+export { __originalConsole } from './logger';
+// Re-export HTTP utilities for trace context propagation
+export { injectTraceContextToHeaders, extractTraceContextFromRequest } from './http';
+// Re-export trace state utilities
+export { enrichContextWithTraceState, generateTraceId, generateSpanId, } from './tracestate';
+// Core registration function
+export { register, registerTelemetry, getTelemetry, ensureInitialized } from './telemetry';
+import { ensureInitialized } from './telemetry';
+/**
+ * Get the OpenTelemetry tracer (auto-initialized)
+ */
+export const tracer = new Proxy({}, {
+    get: (_, prop) => ensureInitialized().tracer[prop],
+});
+/**
+ * Get the OpenTelemetry meter (auto-initialized)
+ */
+export const meter = new Proxy({}, {
+    get: (_, prop) => ensureInitialized().meter[prop],
+});
+/**
+ * Get the Logger instance (auto-initialized)
+ */
+export const logger = new Proxy({}, {
+    get: (_, prop) => ensureInitialized().logger[prop],
+});
+/**
+ * Shutdown telemetry (call on process exit)
+ */
+export async function shutdown() {
+    const telemetry = ensureInitialized();
+    if (telemetry?.shutdown) {
+        await telemetry.shutdown();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,yDAAyD;AACzD,OAAO,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,QAAQ,CAAC;AAErF,kCAAkC;AAClC,OAAO,EACN,2BAA2B,EAC3B,eAAe,EACf,cAAc,GAEd,MAAM,cAAc,CAAC;AAEtB,6BAA6B;AAC7B,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAK3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,KAAK,CAAC,EAAY,EAAE;IACrD,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAoB,CAAC;CAClE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAU,IAAI,KAAK,CAAC,EAAW,EAAE;IAClD,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,IAAmB,CAAC;CAChE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,KAAK,CAAC,EAAY,EAAE;IACrD,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,iBAAiB,EAAE,CAAC,MAAM,CAAC,IAAoB,CAAC;CAClE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC7B,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACtC,IAAI,SAAS,EAAE,QAAQ,EAAE,CAAC;QACzB,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;AACF,CAAC"}

package/dist/logger/console.d.ts

@@ -0,0 +1,69 @@
+import type { LogLevel, Logger } from '@agentuity/core';
+/**
+ * Console implementation of the Logger interface
+ */
+export default class ConsoleLogger implements Logger {
+    private context;
+    private formatContext;
+    private logLevel;
+    private colors;
+    private detectedTraceLoopLog;
+    private useColors;
+    /**
+     * Creates a new console logger
+     *
+     * @param context - Initial context for the logger
+     */
+    constructor(context?: Record<string, unknown>, formatContext?: boolean, logLevel?: LogLevel);
+    private shouldLog;
+    /**
+     * Log a trace message (most verbose)
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    trace(message: unknown, ...args: unknown[]): void;
+    /**
+     * Log a debug message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message: unknown, ...args: unknown[]): void;
+    /**
+     * Log an info message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message: unknown, ...args: unknown[]): void;
+    /**
+     * Log a warning message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message: unknown, ...args: unknown[]): void;
+    /**
+     * Log an error message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message: unknown, ...args: unknown[]): void;
+    /**
+     * Log a fatal error message and exit the process
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    fatal(message: unknown, ...args: unknown[]): never;
+    /**
+     * Create a child logger with additional context
+     *
+     * @param opts - Additional context for the child logger
+     * @returns A new logger instance with the additional context
+     */
+    child(opts: Record<string, unknown>): Logger;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/logger/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/logger/console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAoHxD;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,MAAM;IACnD,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,SAAS,CAAU;IAE3B;;;;OAIG;gBAEF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,aAAa,UAAO,EACpB,QAAQ,GAAE,QAAiB;IAW5B,OAAO,CAAC,SAAS;IAgBjB;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkBjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkBjD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IA8BhD;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkBhD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAkBjD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,KAAK;IAKlD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAU5C"}

package/dist/logger/console.js

@@ -0,0 +1,278 @@
+import { __originalConsole } from '../logger';
+import { formatMessage } from './util';
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+// Helper to convert hex color to ANSI 24-bit color code
+function hexToAnsi(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return `\x1b[38;2;${r};${g};${b}m`;
+}
+function shouldUseColors() {
+    // FORCE_COLOR overrides all checks (used when stdout is piped but we still want colors)
+    if (process.env.FORCE_COLOR === '1') {
+        return true;
+    }
+    // Check for NO_COLOR environment variable (any non-empty value disables colors)
+    if (process.env.NO_COLOR) {
+        return false;
+    }
+    // Check for TERM=dumb
+    if (process.env.TERM === 'dumb') {
+        return false;
+    }
+    // Check if stdout is a TTY
+    if (!process.stdout || typeof process.stdout.isTTY === 'undefined') {
+        return false;
+    }
+    if (process.stdout && typeof process.stdout.isTTY !== 'undefined' && !process.stdout.isTTY) {
+        return false;
+    }
+    return true;
+}
+function getLogColors(scheme) {
+    if (scheme === 'light') {
+        // Darker, high-contrast colors for light backgrounds
+        return {
+            trace: {
+                level: hexToAnsi('#008B8B') + BOLD, // Dark cyan
+                message: hexToAnsi('#4B4B4B'), // Dark gray
+            },
+            debug: {
+                level: hexToAnsi('#0000CD') + BOLD, // Medium blue
+                message: hexToAnsi('#006400'), // Dark green
+            },
+            info: {
+                level: hexToAnsi('#FF8C00') + BOLD, // Dark orange
+                message: hexToAnsi('#0066CC') + BOLD, // Strong blue
+            },
+            warn: {
+                level: hexToAnsi('#9400D3') + BOLD, // Dark violet
+                message: hexToAnsi('#8B008B'), // Dark magenta
+            },
+            error: {
+                level: hexToAnsi('#DC143C') + BOLD, // Crimson
+                message: hexToAnsi('#8B0000') + BOLD, // Dark red
+            },
+        };
+    }
+    // Dark mode colors (brighter for dark backgrounds)
+    return {
+        trace: {
+            level: hexToAnsi('#00FFFF') + BOLD, // Cyan
+            message: hexToAnsi('#A0A0A0'), // Light gray
+        },
+        debug: {
+            level: hexToAnsi('#5C9CFF') + BOLD, // Blue
+            message: hexToAnsi('#90EE90'), // Light green
+        },
+        info: {
+            level: hexToAnsi('#FFD700') + BOLD, // Gold/Yellow
+            message: hexToAnsi('#FFFFFF') + BOLD, // White
+        },
+        warn: {
+            level: hexToAnsi('#FF00FF') + BOLD, // Magenta
+            message: hexToAnsi('#FF00FF'), // Magenta
+        },
+        error: {
+            level: hexToAnsi('#FF4444') + BOLD, // Red
+            message: hexToAnsi('#FF4444'), // Red
+        },
+    };
+}
+// Detect color scheme from environment
+function detectColorScheme() {
+    const scheme = process.env.COLOR_SCHEME?.toLowerCase();
+    if (scheme === 'light' || scheme === 'dark') {
+        return scheme;
+    }
+    if (process.env.CI) {
+        return 'light';
+    }
+    return 'dark'; // Default to dark mode
+}
+const NOCOLORS = Object.freeze({ level: '', reset: '', message: '' });
+/**
+ * Console implementation of the Logger interface
+ */
+export default class ConsoleLogger {
+    context;
+    formatContext;
+    logLevel;
+    colors;
+    detectedTraceLoopLog;
+    useColors;
+    /**
+     * Creates a new console logger
+     *
+     * @param context - Initial context for the logger
+     */
+    constructor(context = {}, formatContext = true, logLevel = 'info') {
+        this.context = context;
+        this.formatContext = formatContext;
+        this.logLevel = logLevel;
+        this.useColors = shouldUseColors();
+        this.colors = this.useColors
+            ? getLogColors(detectColorScheme())
+            : {};
+    }
+    shouldLog(level) {
+        switch (this.logLevel) {
+            case 'trace':
+                return true;
+            case 'debug':
+                return level === 'debug' || level === 'info' || level === 'warn' || level === 'error';
+            case 'info':
+                return level === 'info' || level === 'warn' || level === 'error';
+            case 'warn':
+                return level === 'warn' || level === 'error';
+            case 'error':
+                return level === 'error';
+        }
+        return false;
+    }
+    /**
+     * Log a trace message (most verbose)
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    trace(message, ...args) {
+        if (!this.shouldLog('trace')) {
+            return;
+        }
+        try {
+            const colors = this.useColors ? this.colors.trace : NOCOLORS;
+            const formattedMessage = formatMessage(this.formatContext, this.context, message, args);
+            __originalConsole.debug(`${colors.level}[TRACE]${RESET} ${colors.message}${formattedMessage}${RESET}`);
+        }
+        catch (err) {
+            // Fallback to direct logging if formatting fails
+            const colors = this.colors.trace;
+            __originalConsole.debug(`${colors.level}[TRACE]${RESET} ${message}`, ...args);
+            __originalConsole.error('Error formatting log message:', err);
+        }
+    }
+    /**
+     * Log a debug message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    debug(message, ...args) {
+        if (!this.shouldLog('debug')) {
+            return;
+        }
+        try {
+            const colors = this.useColors ? this.colors.debug : NOCOLORS;
+            const formattedMessage = formatMessage(this.formatContext, this.context, message, args);
+            __originalConsole.debug(`${colors.level}[DEBUG]${RESET} ${colors.message}${formattedMessage}${RESET}`);
+        }
+        catch (err) {
+            // Fallback to direct logging if formatting fails
+            const colors = this.colors.debug;
+            __originalConsole.debug(`${colors.level}[DEBUG]${RESET} ${message}`, ...args);
+            __originalConsole.error('Error formatting log message:', err);
+        }
+    }
+    /**
+     * Log an info message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    info(message, ...args) {
+        if (!this.shouldLog('info')) {
+            return;
+        }
+        // suppress the default traceloop message at info level
+        if (!this.detectedTraceLoopLog &&
+            typeof message === 'string' &&
+            message.includes('Traceloop exporting traces to')) {
+            this.detectedTraceLoopLog = true;
+            if (this.shouldLog('debug')) {
+                this.debug(message, ...args);
+            }
+            return;
+        }
+        try {
+            const colors = this.useColors ? this.colors.info : NOCOLORS;
+            const formattedMessage = formatMessage(this.formatContext, this.context, message, args);
+            __originalConsole.info(`${colors.level}[INFO]${RESET} ${colors.message}${formattedMessage}${RESET}`);
+        }
+        catch (err) {
+            // Fallback to direct logging if formatting fails
+            const colors = this.colors.info;
+            __originalConsole.info(`${colors.level}[INFO]${RESET} ${message}`, ...args);
+            __originalConsole.error('Error formatting log message:', err);
+        }
+    }
+    /**
+     * Log a warning message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    warn(message, ...args) {
+        if (!this.shouldLog('warn')) {
+            return;
+        }
+        try {
+            const colors = this.useColors ? this.colors.warn : NOCOLORS;
+            const formattedMessage = formatMessage(this.formatContext, this.context, message, args);
+            __originalConsole.warn(`${colors.level}[WARN]${RESET}  ${colors.message}${formattedMessage}${RESET}`);
+        }
+        catch (err) {
+            // Fallback to direct logging if formatting fails
+            const colors = this.colors.warn;
+            __originalConsole.warn(`${colors.level}[WARN]${RESET}  ${message}`, ...args);
+            __originalConsole.error('Error formatting log message:', err);
+        }
+    }
+    /**
+     * Log an error message
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    error(message, ...args) {
+        if (!this.shouldLog('error')) {
+            return;
+        }
+        try {
+            const colors = this.useColors ? this.colors.error : NOCOLORS;
+            const formattedMessage = formatMessage(this.formatContext, this.context, message, args);
+            __originalConsole.error(`${colors.level}[ERROR]${RESET} ${colors.message}${formattedMessage}${RESET}`);
+        }
+        catch (err) {
+            // Fallback to direct logging if formatting fails
+            const colors = this.colors.error;
+            __originalConsole.error(`${colors.level}[ERROR]${RESET} ${message}`, ...args);
+            __originalConsole.error('Error formatting log message:', err);
+        }
+    }
+    /**
+     * Log a fatal error message and exit the process
+     *
+     * @param message - The message to log
+     * @param args - Additional arguments to log
+     */
+    fatal(message, ...args) {
+        this.error(message, ...args);
+        process.exit(1);
+    }
+    /**
+     * Create a child logger with additional context
+     *
+     * @param opts - Additional context for the child logger
+     * @returns A new logger instance with the additional context
+     */
+    child(opts) {
+        return new ConsoleLogger({
+            ...this.context,
+            ...opts,
+        }, this.formatContext, this.logLevel);
+    }
+}
+//# sourceMappingURL=console.js.map