@egain/ai-agent-sdk 0.1.0

package/dist/core/events/EventEmitter.js.map

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

package/dist/core/logging/LogLevel.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Log levels in order of severity
+ * Lower numbers = more verbose, higher numbers = more severe
+ */
+export declare enum LogLevel {
+    TRACE = 0,
+    DEBUG = 1,
+    INFO = 2,
+    WARN = 3,
+    ERROR = 4,
+    FATAL = 5
+}
+/**
+ * Get the string name of a log level
+ * @param level - The log level
+ * @returns The string name of the level
+ */
+export declare function getLevelName(level: LogLevel): string;
+/**
+ * Get the numeric value of a log level
+ * @param level - The log level
+ * @returns The numeric value
+ */
+export declare function getLevelValue(level: LogLevel): number;
+/**
+ * Check if a log level is enabled based on the current threshold
+ * A level is enabled if it is greater than or equal to the threshold
+ * @param level - The log level to check
+ * @param threshold - The minimum log level threshold
+ * @returns True if the level should be logged
+ */
+export declare function isLevelEnabled(level: LogLevel, threshold: LogLevel): boolean;
+//# sourceMappingURL=LogLevel.d.ts.map

package/dist/core/logging/LogLevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.d.ts","sourceRoot":"","sources":["../../../src/core/logging/LogLevel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,GAAG,OAAO,CAE5E"}

package/dist/core/logging/LogLevel.js

@@ -0,0 +1,40 @@
+/**
+ * Log levels in order of severity
+ * Lower numbers = more verbose, higher numbers = more severe
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["TRACE"] = 0] = "TRACE";
+    LogLevel[LogLevel["DEBUG"] = 1] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["WARN"] = 3] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 4] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 5] = "FATAL";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Get the string name of a log level
+ * @param level - The log level
+ * @returns The string name of the level
+ */
+export function getLevelName(level) {
+    return LogLevel[level] || 'UNKNOWN';
+}
+/**
+ * Get the numeric value of a log level
+ * @param level - The log level
+ * @returns The numeric value
+ */
+export function getLevelValue(level) {
+    return level;
+}
+/**
+ * Check if a log level is enabled based on the current threshold
+ * A level is enabled if it is greater than or equal to the threshold
+ * @param level - The log level to check
+ * @param threshold - The minimum log level threshold
+ * @returns True if the level should be logged
+ */
+export function isLevelEnabled(level, threshold) {
+    return level >= threshold;
+}
+//# sourceMappingURL=LogLevel.js.map

package/dist/core/logging/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["../../../src/core/logging/LogLevel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,yCAAS,CAAA;AACX,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,SAAmB;IACjE,OAAO,KAAK,IAAI,SAAS,CAAC;AAC5B,CAAC"}

package/dist/core/logging/Logger.d.ts

@@ -0,0 +1,120 @@
+import { EventEmitter } from '../events/EventEmitter.js';
+import { LogLevel } from './LogLevel.js';
+import { LoggerEvents } from './types.js';
+/**
+ * Logger configuration options
+ */
+export interface LoggerConfig {
+    /**
+     * Minimum log level threshold
+     * @default LogLevel.INFO
+     */
+    level?: LogLevel;
+    /**
+     * Enable console output
+     * @default true
+     */
+    enableConsole?: boolean;
+    /**
+     * Logger name for identification
+     * @default undefined
+     */
+    name?: string;
+    /**
+     * Context provider function that returns dynamic context at log time
+     * This allows including dynamic values like sessionId in all log entries
+     * @default undefined
+     */
+    contextProvider?: () => Record<string, any>;
+}
+/**
+ * Logger class that extends EventEmitter for log subscription
+ * Supports log level filtering and console output
+ */
+export declare class Logger extends EventEmitter<LoggerEvents> {
+    private level;
+    private enableConsole;
+    private name?;
+    private contextProvider?;
+    constructor(config?: LoggerConfig);
+    /**
+     * Set the minimum log level threshold
+     * @param level - The minimum log level to log
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Get the current log level threshold
+     * @returns The current log level
+     */
+    getLevel(): LogLevel;
+    /**
+     * Enable or disable console output
+     * @param enabled - Whether to enable console output
+     */
+    enableConsoleOutput(enabled: boolean): void;
+    /**
+     * Check if console output is enabled
+     * @returns True if console output is enabled
+     */
+    isConsoleOutputEnabled(): boolean;
+    /**
+     * Log a TRACE level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    trace(message: string, context?: Record<string, any>): void;
+    /**
+     * Log a DEBUG level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    debug(message: string, context?: Record<string, any>): void;
+    /**
+     * Log an INFO level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    info(message: string, context?: Record<string, any>): void;
+    /**
+     * Log a WARN level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    warn(message: string, context?: Record<string, any>): void;
+    /**
+     * Log an ERROR level message
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    error(message: string, error?: Error, context?: Record<string, any>): void;
+    /**
+     * Log a FATAL level message
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    fatal(message: string, error?: Error, context?: Record<string, any>): void;
+    /**
+     * Internal logging method
+     * Checks level threshold, creates log entry, emits event, and outputs to console
+     * @param level - The log level
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    private log;
+    /**
+     * Output log entry to console based on level
+     * @param entry - The log entry to output
+     */
+    private outputToConsole;
+    /**
+     * Create a child logger with additional context
+     * @param name - Name for the child logger
+     * @param context - Additional context to include in all logs
+     * @returns A new logger instance with merged context
+     */
+    createChild(name: string, context?: Record<string, any>): Logger;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/core/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAgC,MAAM,eAAe,CAAC;AACvE,OAAO,EAAY,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,qBAAa,MAAO,SAAQ,YAAY,CAAC,YAAY,CAAC;IACpD,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,eAAe,CAAC,CAA4B;gBAExC,MAAM,GAAE,YAAiB;IAQrC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B;;;OAGG;IACH,QAAQ,IAAI,QAAQ;IAIpB;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3C;;;OAGG;IACH,sBAAsB,IAAI,OAAO;IAIjC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI1D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI1D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI1E;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI1E;;;;;;;OAOG;IACH,OAAO,CAAC,GAAG;IAmDX;;;OAGG;IACH,OAAO,CAAC,eAAe;IAwCvB;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;CAsBjE"}

package/dist/core/logging/Logger.js

@@ -0,0 +1,204 @@
+import { EventEmitter } from '../events/EventEmitter.js';
+import { LogLevel, isLevelEnabled, getLevelName } from './LogLevel.js';
+/**
+ * Logger class that extends EventEmitter for log subscription
+ * Supports log level filtering and console output
+ */
+export class Logger extends EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.level = config.level ?? LogLevel.INFO;
+        this.enableConsole = config.enableConsole ?? true;
+        this.name = config.name;
+        this.contextProvider = config.contextProvider;
+    }
+    /**
+     * Set the minimum log level threshold
+     * @param level - The minimum log level to log
+     */
+    setLevel(level) {
+        this.level = level;
+    }
+    /**
+     * Get the current log level threshold
+     * @returns The current log level
+     */
+    getLevel() {
+        return this.level;
+    }
+    /**
+     * Enable or disable console output
+     * @param enabled - Whether to enable console output
+     */
+    enableConsoleOutput(enabled) {
+        this.enableConsole = enabled;
+    }
+    /**
+     * Check if console output is enabled
+     * @returns True if console output is enabled
+     */
+    isConsoleOutputEnabled() {
+        return this.enableConsole;
+    }
+    /**
+     * Log a TRACE level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    trace(message, context) {
+        this.log(LogLevel.TRACE, message, undefined, context);
+    }
+    /**
+     * Log a DEBUG level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, message, undefined, context);
+    }
+    /**
+     * Log an INFO level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    info(message, context) {
+        this.log(LogLevel.INFO, message, undefined, context);
+    }
+    /**
+     * Log a WARN level message
+     * @param message - The log message
+     * @param context - Optional context/metadata
+     */
+    warn(message, context) {
+        this.log(LogLevel.WARN, message, undefined, context);
+    }
+    /**
+     * Log an ERROR level message
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    error(message, error, context) {
+        this.log(LogLevel.ERROR, message, error, context);
+    }
+    /**
+     * Log a FATAL level message
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    fatal(message, error, context) {
+        this.log(LogLevel.FATAL, message, error, context);
+    }
+    /**
+     * Internal logging method
+     * Checks level threshold, creates log entry, emits event, and outputs to console
+     * @param level - The log level
+     * @param message - The log message
+     * @param error - Optional error object
+     * @param context - Optional context/metadata
+     */
+    log(level, message, error, context) {
+        // Check if this level should be logged
+        if (!isLevelEnabled(level, this.level)) {
+            return;
+        }
+        // Get dynamic context from provider if available
+        let dynamicContext = {};
+        if (this.contextProvider) {
+            try {
+                dynamicContext = this.contextProvider() || {};
+            }
+            catch (err) {
+                // Silently ignore errors in context provider to avoid breaking logging
+            }
+        }
+        // Extract sessionId from dynamic context if present
+        const sessionId = dynamicContext.sessionId;
+        // Merge contexts: dynamic context first, then explicit context (explicit takes precedence)
+        const mergedContext = { ...dynamicContext, ...context };
+        // Remove sessionId from merged context since it's stored separately in LogEntry
+        if (sessionId !== undefined) {
+            delete mergedContext.sessionId;
+        }
+        // Create log entry
+        const entry = {
+            level,
+            message,
+            timestamp: Date.now(),
+            context: Object.keys(mergedContext).length > 0 ? mergedContext : undefined,
+            error,
+            loggerName: this.name,
+            sessionId,
+        };
+        // Emit log event for subscribers
+        this.emit('log', entry);
+        // Output to console if enabled
+        if (this.enableConsole) {
+            this.outputToConsole(entry);
+        }
+    }
+    /**
+     * Output log entry to console based on level
+     * @param entry - The log entry to output
+     */
+    outputToConsole(entry) {
+        const levelName = getLevelName(entry.level);
+        const timestamp = new Date(entry.timestamp).toISOString();
+        const sessionIdPart = entry.sessionId ? ` [sessionId:${entry.sessionId}]` : '';
+        const prefix = entry.loggerName
+            ? `[${levelName}] [${timestamp}] [${entry.loggerName}]${sessionIdPart}`
+            : `[${levelName}] [${timestamp}]${sessionIdPart}`;
+        const message = `${prefix} ${entry.message}`;
+        // Include context if present
+        const logArgs = [message];
+        if (entry.context) {
+            logArgs.push(entry.context);
+        }
+        if (entry.error) {
+            logArgs.push(entry.error);
+        }
+        // Use appropriate console method based on level
+        switch (entry.level) {
+            case LogLevel.TRACE:
+            case LogLevel.DEBUG:
+                console.debug(...logArgs);
+                break;
+            case LogLevel.INFO:
+                console.info(...logArgs);
+                break;
+            case LogLevel.WARN:
+                console.warn(...logArgs);
+                break;
+            case LogLevel.ERROR:
+            case LogLevel.FATAL:
+                console.error(...logArgs);
+                if (entry.error?.stack) {
+                    console.error(entry.error.stack);
+                }
+                break;
+        }
+    }
+    /**
+     * Create a child logger with additional context
+     * @param name - Name for the child logger
+     * @param context - Additional context to include in all logs
+     * @returns A new logger instance with merged context
+     */
+    createChild(name, context) {
+        const childLogger = new Logger({
+            level: this.level,
+            enableConsole: this.enableConsole,
+            name: name,
+            contextProvider: this.contextProvider, // Inherit parent's context provider
+        });
+        // Override log method to include parent context
+        const originalLog = childLogger['log'].bind(childLogger);
+        childLogger['log'] = (level, message, error, childContext) => {
+            const mergedContext = { ...context, ...childContext };
+            originalLog(level, message, error, mergedContext);
+        };
+        return childLogger;
+    }
+}
+//# sourceMappingURL=Logger.js.map

package/dist/core/logging/Logger.js.map

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

package/dist/core/logging/globalLogger.d.ts

@@ -0,0 +1,8 @@
+import { Logger } from './Logger.js';
+/**
+ * Global logger instance for application-wide logging
+ * Default level: INFO
+ * Default console output: enabled
+ */
+export declare const globalLogger: Logger;
+//# sourceMappingURL=globalLogger.d.ts.map

package/dist/core/logging/globalLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalLogger.d.ts","sourceRoot":"","sources":["../../../src/core/logging/globalLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAGvB,CAAC"}

package/dist/core/logging/globalLogger.js

@@ -0,0 +1,12 @@
+import { Logger } from './Logger.js';
+import { LogLevel } from './LogLevel.js';
+/**
+ * Global logger instance for application-wide logging
+ * Default level: INFO
+ * Default console output: enabled
+ */
+export const globalLogger = new Logger({
+    level: LogLevel.INFO,
+    enableConsole: true,
+});
+//# sourceMappingURL=globalLogger.js.map

package/dist/core/logging/globalLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalLogger.js","sourceRoot":"","sources":["../../../src/core/logging/globalLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC;IACrC,KAAK,EAAE,QAAQ,CAAC,IAAI;IACpB,aAAa,EAAE,IAAI;CACpB,CAAC,CAAC"}

package/dist/core/logging/types.d.ts

@@ -0,0 +1,45 @@
+import { LogLevel } from './LogLevel.js';
+/**
+ * Log entry structure emitted by the logger
+ */
+export interface LogEntry {
+    /**
+     * Log level
+     */
+    level: LogLevel;
+    /**
+     * Log message
+     */
+    message: string;
+    /**
+     * Timestamp when the log was created (milliseconds since epoch)
+     */
+    timestamp: number;
+    /**
+     * Optional context/metadata
+     */
+    context?: Record<string, any>;
+    /**
+     * Optional error object (for ERROR and FATAL levels)
+     */
+    error?: Error;
+    /**
+     * Optional agent identifier
+     */
+    agentId?: string | number;
+    /**
+     * Optional session identifier
+     */
+    sessionId?: string | number;
+    /**
+     * Optional logger name for identification
+     */
+    loggerName?: string;
+}
+/**
+ * Logger event map for EventEmitter
+ */
+export interface LoggerEvents {
+    log: LogEntry;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/logging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/logging/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,KAAK,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,QAAQ,CAAC;CACf"}

package/dist/core/logging/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/logging/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/logging/types.ts"],"names":[],"mappings":""}