@fraziym/axoniz 0.1.0

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

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

package/dist/core/logger.js

@@ -0,0 +1,640 @@
+/**
+ * AXONIZ-ZERO Comprehensive Logger
+ * Logs every detail of system operation to files and console.
+ *
+ * Features:
+ *   - Session-scoped log files (one per session)
+ *   - Structured JSON logs for programmatic analysis
+ *   - Human-readable logs for debugging
+ *   - Captures: agent steps, tool calls, backend interactions, memory ops, errors
+ *   - Configurable via ~/.axoniz/config.json under "logging"
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { AXONIZ_HOME } from "./config.js";
+/* ── Configuration ────────────────────────────────────────────────────────── */
+export const LOG_DIR = path.join(AXONIZ_HOME, "logs");
+export const SESSION_DIR = path.join(LOG_DIR, "sessions");
+export const STRUCTURED_DIR = path.join(LOG_DIR, "structured");
+for (const d of [LOG_DIR, SESSION_DIR, STRUCTURED_DIR]) {
+    try {
+        fs.mkdirSync(d, { recursive: true });
+    }
+    catch {
+        /* ignore */
+    }
+}
+const LEVEL_ORDER = {
+    DEBUG: 10,
+    INFO: 20,
+    WARNING: 30,
+    ERROR: 40,
+    CRITICAL: 50,
+};
+/** Runtime logging configuration. */
+export class LogConfig {
+    level = "INFO";
+    console = true;
+    file = true;
+    structured = true; // JSON logs
+    max_bytes = 10 * 1024 * 1024; // 10 MB
+    backup_count = 10;
+    capture_llm_prompts = false; // Off by default — can be huge
+    capture_tool_args = true;
+    capture_tool_results = true;
+    capture_backend_health = true;
+    session_id = "";
+    static fromConfig(cfg) {
+        const lc = (cfg.logging ?? {});
+        const inst = new LogConfig();
+        inst.level = String(lc.level ?? "INFO");
+        inst.console = Boolean(lc.console ?? true);
+        inst.file = Boolean(lc.file ?? true);
+        inst.structured = Boolean(lc.structured ?? true);
+        inst.max_bytes = Number(lc.max_bytes ?? 10 * 1024 * 1024);
+        inst.backup_count = Number(lc.backup_count ?? 10);
+        inst.capture_llm_prompts = Boolean(lc.capture_llm_prompts ?? false);
+        inst.capture_tool_args = Boolean(lc.capture_tool_args ?? true);
+        inst.capture_tool_results = Boolean(lc.capture_tool_results ?? true);
+        inst.capture_backend_health = Boolean(lc.capture_backend_health ?? true);
+        return inst;
+    }
+}
+/* ── Session tracking ─────────────────────────────────────────────────────── */
+let sessionCounter = 0;
+function pad(n, w) {
+    return String(n).padStart(w, "0");
+}
+function newSessionId() {
+    sessionCounter += 1;
+    const d = new Date();
+    const ts = `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1, 2)}${pad(d.getUTCDate(), 2)}` +
+        `_${pad(d.getUTCHours(), 2)}${pad(d.getUTCMinutes(), 2)}${pad(d.getUTCSeconds(), 2)}`;
+    return `${ts}_${pad(sessionCounter, 4)}`;
+}
+/* ── Formatting ───────────────────────────────────────────────────────────── */
+const COLORS = {
+    DEBUG: "\u001b[36m", // cyan
+    INFO: "\u001b[90m", // gray
+    WARNING: "\u001b[93m", // yellow
+    ERROR: "\u001b[91m", // red
+    CRITICAL: "\u001b[95m", // magenta
+};
+const RESET = "\u001b[0m";
+const GRAY = "\u001b[38;5;240m";
+const NO_COLOR = Boolean(process.env.NO_COLOR);
+function colorize(code, s) {
+    return NO_COLOR ? s : `${code}${s}${RESET}`;
+}
+function fmtConsoleTs(d) {
+    const p = (n, w = 2) => pad(n, w);
+    return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;
+}
+function fmtIsoTs(d) {
+    const p = (n, w = 2) => pad(n, w);
+    return (`${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())}` +
+        `T${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`);
+}
+function consoleLine(level, domain, msg) {
+    const lvl = colorize(COLORS[level] ?? "", level.padEnd(5));
+    const src = domain !== "axoniz" ? colorize(GRAY, `[${domain}]`) + " " : "";
+    return `  ${colorize(GRAY, fmtConsoleTs(new Date()))}  ${lvl}  ${src}${msg}`;
+}
+function fileLine(level, domain, msg) {
+    return `${fmtIsoTs(new Date())} ${level.padEnd(8)} [${domain}] ${msg}`;
+}
+/* ── JSON serializer ──────────────────────────────────────────────────────── */
+function jsonDefault(v) {
+    if (v instanceof Date)
+        return v.toISOString();
+    if (v instanceof Error)
+        return { name: v.name, message: v.message, stack: v.stack };
+    if (typeof v === "bigint")
+        return v.toString();
+    if (typeof v === "object" && v !== null) {
+        const entries = Object.entries(v).filter(([k]) => !k.startsWith("_"));
+        if (entries.length > 0)
+            return Object.fromEntries(entries);
+    }
+    return String(v);
+}
+export function safeJson(v, indent) {
+    try {
+        return JSON.stringify(v, (_k, val) => jsonDefault(val), indent);
+    }
+    catch {
+        return String(v);
+    }
+}
+/* ── Rotating file writer ─────────────────────────────────────────────────── */
+class RotatingWriter {
+    filePath;
+    maxBytes;
+    backupCount;
+    stream = null;
+    constructor(filePath, maxBytes, backupCount) {
+        this.filePath = filePath;
+        this.maxBytes = maxBytes;
+        this.backupCount = backupCount;
+        this.open();
+    }
+    open() {
+        try {
+            this.stream = fs.createWriteStream(this.filePath, { flags: "a", encoding: "utf-8" });
+            this.stream.on("error", () => {
+                this.stream = null;
+            });
+        }
+        catch {
+            this.stream = null;
+        }
+    }
+    write(line) {
+        if (!this.stream)
+            return;
+        try {
+            this.stream.write(line + "\n");
+            this.maybeRotate();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    maybeRotate() {
+        try {
+            const st = fs.statSync(this.filePath);
+            if (st.size <= this.maxBytes)
+                return;
+            this.stream?.end();
+            this.stream = null;
+            for (let i = this.backupCount - 1; i >= 1; i--) {
+                const src = `${this.filePath}.${i}`;
+                const dst = `${this.filePath}.${i + 1}`;
+                if (fs.existsSync(src)) {
+                    try {
+                        fs.renameSync(src, dst);
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                }
+            }
+            try {
+                fs.renameSync(this.filePath, `${this.filePath}.1`);
+            }
+            catch {
+                /* ignore */
+            }
+            this.open();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    close() {
+        try {
+            this.stream?.end();
+        }
+        catch {
+            /* ignore */
+        }
+        this.stream = null;
+    }
+}
+/* ── Structured JSON logger ───────────────────────────────────────────────── */
+/** Writes JSON events to a dedicated structured log file (one JSON object per line). */
+export class StructuredLogger {
+    sessionId;
+    path;
+    stream = null;
+    constructor(sessionId) {
+        this.sessionId = sessionId;
+        this.path = path.join(STRUCTURED_DIR, `${sessionId}.jsonl`);
+        try {
+            this.stream = fs.createWriteStream(this.path, { flags: "a", encoding: "utf-8" });
+            this.stream.on("error", () => {
+                this.stream = null;
+            });
+        }
+        catch (e) {
+            process.stderr.write(`[Logger] Failed to open structured log: ${String(e)}\n`);
+            this.stream = null;
+        }
+    }
+    emit(eventType, data) {
+        if (!this.stream)
+            return;
+        const entry = {
+            ts: new Date().toISOString(),
+            session: this.sessionId,
+            type: eventType,
+            data,
+        };
+        try {
+            this.stream.write(safeJson(entry) + "\n");
+        }
+        catch {
+            /* ignore */
+        }
+    }
+    close() {
+        try {
+            this.stream?.end();
+        }
+        catch {
+            /* ignore */
+        }
+        this.stream = null;
+    }
+}
+/* ── Main Logger ──────────────────────────────────────────────────────────── */
+/**
+ * Central logging hub for AXONIZ-ZERO.
+ * One logger per session with console, file, and structured outputs.
+ */
+export class AxonizLogger {
+    config;
+    sessionId;
+    startedAt;
+    mainWriter = null;
+    sessionWriter = null;
+    structured = null;
+    minLevel = "INFO";
+    constructor(config) {
+        this.config = config ?? new LogConfig();
+        this.sessionId = this.config.session_id || newSessionId();
+        this.startedAt = new Date();
+        this.minLevel = normalizeLevel(this.config.level);
+        if (this.config.file) {
+            try {
+                this.mainWriter = new RotatingWriter(path.join(LOG_DIR, "axoniz.log"), this.config.max_bytes, this.config.backup_count);
+            }
+            catch (e) {
+                this.warning(`Could not open main log file: ${String(e)}`);
+            }
+            try {
+                this.sessionWriter = new RotatingWriter(path.join(SESSION_DIR, `${this.sessionId}.log`), Number.MAX_SAFE_INTEGER, 0);
+            }
+            catch (e) {
+                this.warning(`Could not open session log file: ${String(e)}`);
+            }
+        }
+        this.structured = this.config.structured ? new StructuredLogger(this.sessionId) : null;
+        this.logSessionStart();
+    }
+    logSessionStart() {
+        const bar = "=".repeat(60);
+        this.info(bar);
+        this.info("AXONIZ-ZERO Session Started");
+        this.info(`  Session ID : ${this.sessionId}`);
+        this.info(`  Started at : ${this.startedAt.toISOString()}`);
+        this.info(`  Log level  : ${this.config.level}`);
+        this.info(`  Console    : ${this.config.console}`);
+        this.info(`  File log   : ${this.config.file}`);
+        this.info(`  Structured : ${this.config.structured}`);
+        this.info(bar);
+        this.structuredEmit("session_start", {
+            session_id: this.sessionId,
+            started_at: this.startedAt.toISOString(),
+            config: { ...this.config },
+        });
+    }
+    structuredEmit(eventType, data) {
+        this.structured?.emit(eventType, data);
+    }
+    /* ── Core logging API ──────────────────────────────────────────────────── */
+    emit(level, msg, domain = "axoniz") {
+        if (LEVEL_ORDER[level] < LEVEL_ORDER[this.minLevel])
+            return;
+        if (this.config.console) {
+            const line = consoleLine(level, domain, msg);
+            process.stderr.write(line + "\n");
+        }
+        if (this.config.file) {
+            const line = fileLine(level, domain, msg);
+            this.mainWriter?.write(line);
+            this.sessionWriter?.write(line);
+        }
+    }
+    debug(msg, domain = "axoniz") {
+        this.emit("DEBUG", msg, domain);
+    }
+    info(msg, domain = "axoniz") {
+        this.emit("INFO", msg, domain);
+    }
+    warning(msg, domain = "axoniz") {
+        this.emit("WARNING", msg, domain);
+    }
+    /** Python-compatible alias for warning(). */
+    warn(msg, domain = "axoniz") {
+        this.warning(msg, domain);
+    }
+    error(msg, domain = "axoniz") {
+        this.emit("ERROR", msg, domain);
+    }
+    critical(msg, domain = "axoniz") {
+        this.emit("CRITICAL", msg, domain);
+    }
+    /* ── Structured event logging ──────────────────────────────────────────── */
+    logEvent(eventType, data) {
+        this.structuredEmit(eventType, data);
+        this.debug(`[${eventType}] ${safeJson(data).slice(0, 200)}`);
+    }
+    /* ── Agent lifecycle ───────────────────────────────────────────────────── */
+    logAgentInit(config) {
+        const safe = {};
+        for (const [k, v] of Object.entries(config)) {
+            if (!["api_key", "token", "password"].includes(k))
+                safe[k] = v;
+        }
+        this.info(`Agent initialized | config=${safeJson(safe)}`, "axoniz.agent");
+        this.logEvent("agent_init", { config: safe });
+    }
+    logAgentRun(task, mode = "agent") {
+        this.info(`Agent run | mode=${mode} | task=${task.slice(0, 200)}`, "axoniz.agent");
+        this.logEvent("agent_run", { mode, task: task.slice(0, 2000) });
+    }
+    logAgentStep(step, total, thoughtPreview = "") {
+        this.debug(`Step ${step}/${total} | thought=${thoughtPreview.slice(0, 100)}`, "axoniz.agent");
+        this.logEvent("agent_step", { step, total, thought_preview: thoughtPreview.slice(0, 500) });
+    }
+    logAgentDone(resultPreview = "", stepsTaken = 0, tokensOut = 0) {
+        this.info(`Agent done | steps=${stepsTaken} | tokens=${tokensOut}`, "axoniz.agent");
+        this.logEvent("agent_done", {
+            result_preview: resultPreview.slice(0, 500),
+            steps_taken: stepsTaken,
+            tokens_out: tokensOut,
+        });
+    }
+    logAgentError(exc, context = "") {
+        const err = exc instanceof Error ? exc : new Error(String(exc));
+        const tb = err.stack ?? String(exc);
+        this.error(`Agent error | context=${context} | ${err.message}\n${tb}`, "axoniz.agent");
+        this.logEvent("agent_error", { context, error: err.message, traceback: tb });
+    }
+    logAgentChat(message, responsePreview = "") {
+        this.info(`Chat | msg=${message.slice(0, 200)}`, "axoniz.agent");
+        this.logEvent("agent_chat", {
+            message: message.slice(0, 2000),
+            response_preview: responsePreview.slice(0, 500),
+        });
+    }
+    /* ── Backend interactions ──────────────────────────────────────────────── */
+    logBackendHealth(backend, result) {
+        if (!this.config.capture_backend_health)
+            return;
+        const status = String(result.status ?? "unknown");
+        this.info(`Backend health | ${backend} | ${status}`, "axoniz.backend");
+        this.logEvent("backend_health", { backend, result });
+    }
+    logBackendComplete(backend, model, promptTokens, outputTokens, durationMs, error) {
+        if (error) {
+            this.error(`Backend complete failed | ${backend} | ${model} | ${error}`, "axoniz.backend");
+            this.logEvent("backend_complete_error", { backend, model, error });
+        }
+        else {
+            this.debug(`Backend complete | ${backend} | ${model} | ${promptTokens} \u2192 ${outputTokens} tok | ${durationMs}ms`, "axoniz.backend");
+            this.logEvent("backend_complete", {
+                backend,
+                model,
+                prompt_tokens: promptTokens,
+                output_tokens: outputTokens,
+                duration_ms: durationMs,
+            });
+        }
+    }
+    logBackendLoad(backend, model, result) {
+        this.info(`Backend load | ${backend} | ${model} | ${result}`, "axoniz.backend");
+        this.logEvent("backend_load", { backend, model, result });
+    }
+    /* ── Tool execution ────────────────────────────────────────────────────── */
+    logToolCall(name, args, step = 0) {
+        if (!this.config.capture_tool_args)
+            return;
+        const safe = {};
+        for (const [k, v] of Object.entries(args)) {
+            if (!["api_key", "token", "password", "secret"].includes(k))
+                safe[k] = v;
+        }
+        this.info(`Tool call | ${name} | step=${step} | args=${safeJson(safe)}`, "axoniz.tools");
+        this.logEvent("tool_call", { name, args: safe, step });
+    }
+    logToolResult(name, result, durationMs = 0, error) {
+        if (!this.config.capture_tool_results)
+            return;
+        const preview = result ? String(result).slice(0, 500) : "";
+        if (error) {
+            this.error(`Tool error | ${name} | ${error}`, "axoniz.tools");
+            this.logEvent("tool_error", { name, error, duration_ms: durationMs });
+        }
+        else {
+            this.debug(`Tool result | ${name} | ${preview.slice(0, 100)}... | ${durationMs}ms`, "axoniz.tools");
+            this.logEvent("tool_result", { name, result_preview: preview, duration_ms: durationMs });
+        }
+    }
+    /* ── Memory operations ─────────────────────────────────────────────────── */
+    logMemoryQuery(query, resultsCount, domain = "axoniz.memory") {
+        this.debug(`Memory query | ${query.slice(0, 100)} | ${resultsCount} results`, domain);
+        this.logEvent("memory_query", { query: query.slice(0, 500), results_count: resultsCount });
+    }
+    logMemoryStore(key, size, domain = "axoniz.memory") {
+        this.debug(`Memory store | ${key} | ${size} bytes`, domain);
+        this.logEvent("memory_store", { key, size });
+    }
+    /* ── Swarm / Loop ──────────────────────────────────────────────────────── */
+    logSwarmRun(task, workers, subTasks) {
+        this.info(`Swarm run | ${subTasks} sub-tasks | ${workers} workers`, "axoniz.swarm");
+        this.logEvent("swarm_run", { task: task.slice(0, 500), workers, sub_tasks: subTasks });
+    }
+    logSwarmWorkerDone(workerId, taskId, status, durationMs, score = 0.0) {
+        this.debug(`Swarm worker ${workerId} done | task=${taskId} | ${status} | ${durationMs}ms | score=${score}`, "axoniz.swarm");
+        this.logEvent("swarm_worker_done", {
+            worker_id: workerId,
+            task_id: taskId,
+            status,
+            duration_ms: durationMs,
+            score,
+        });
+    }
+    logLoopCycle(cycle, maxCycles, tasksCompleted, tasksFailed) {
+        this.info(`Loop cycle ${cycle}/${maxCycles} | done=${tasksCompleted} | failed=${tasksFailed}`, "axoniz.loop");
+        this.logEvent("loop_cycle", {
+            cycle,
+            max_cycles: maxCycles,
+            tasks_completed: tasksCompleted,
+            tasks_failed: tasksFailed,
+        });
+    }
+    /* ── Config changes ────────────────────────────────────────────────────── */
+    logConfigChange(key, oldVal, newVal) {
+        this.info(`Config change | ${key}: ${String(oldVal)} \u2192 ${String(newVal)}`, "axoniz.config");
+        this.logEvent("config_change", { key, old: String(oldVal), new: String(newVal) });
+    }
+    /* ── Session end ───────────────────────────────────────────────────────── */
+    logSessionEnd(reason = "normal") {
+        const elapsed = (Date.now() - this.startedAt.getTime()) / 1000;
+        const bar = "=".repeat(60);
+        this.info(bar);
+        this.info(`Session Ended | ${this.sessionId} | reason=${reason} | elapsed=${elapsed.toFixed(1)}s`);
+        this.info(bar);
+        this.logEvent("session_end", {
+            session_id: this.sessionId,
+            reason,
+            elapsed_seconds: elapsed,
+        });
+        this.structured?.close();
+        this.structured = null;
+    }
+    close() {
+        this.mainWriter?.close();
+        this.sessionWriter?.close();
+        this.structured?.close();
+        this.mainWriter = null;
+        this.sessionWriter = null;
+        this.structured = null;
+    }
+    /* ── Utility ───────────────────────────────────────────────────────────── */
+    getSessionLogPath() {
+        return path.join(SESSION_DIR, `${this.sessionId}.log`);
+    }
+    getStructuredLogPath() {
+        return path.join(STRUCTURED_DIR, `${this.sessionId}.jsonl`);
+    }
+    /** Return info about recent session log files. */
+    getRecentSessions(n = 10) {
+        let files;
+        try {
+            files = fs
+                .readdirSync(SESSION_DIR)
+                .filter((f) => f.endsWith(".log"))
+                .sort((a, b) => b.localeCompare(a));
+        }
+        catch {
+            return [];
+        }
+        const sessions = [];
+        for (const f of files.slice(0, n)) {
+            const p = path.join(SESSION_DIR, f);
+            try {
+                const st = fs.statSync(p);
+                sessions.push({
+                    session_id: f.replace(/\.log$/, ""),
+                    size_kb: (st.size / 1024).toFixed(1),
+                    modified: st.mtime.toISOString(),
+                    path: p,
+                });
+            }
+            catch {
+                /* ignore */
+            }
+        }
+        return sessions;
+    }
+    /** Time an async operation, logging entry/exit/failure. */
+    async timed(label, fn, domain = "axoniz") {
+        const t0 = Date.now();
+        this.debug(`${label} started`, domain);
+        try {
+            const result = await fn();
+            this.debug(`${label} completed in ${Date.now() - t0}ms`, domain);
+            return result;
+        }
+        catch (e) {
+            const err = e instanceof Error ? e : new Error(String(e));
+            this.error(`${label} failed after ${Date.now() - t0}ms | ${err.message}`, domain);
+            throw e;
+        }
+    }
+}
+/* ── Global instance ──────────────────────────────────────────────────────── */
+let loggerInstance = null;
+function normalizeLevel(level) {
+    const up = level.toUpperCase();
+    return (up in LEVEL_ORDER ? up : "INFO");
+}
+/** Get or create the global logger instance. */
+export function getLogger(config) {
+    if (loggerInstance === null) {
+        loggerInstance = new AxonizLogger(config);
+    }
+    return loggerInstance;
+}
+/** Explicitly (re)initialize the logger. Call once at startup. */
+export function initLogger(config) {
+    loggerInstance?.close();
+    loggerInstance = new AxonizLogger(config);
+    return loggerInstance;
+}
+/* ── Convenience wrappers (backward-compatible with debug.ts) ─────────────── */
+export function debug(msg, domain = "axoniz") {
+    getLogger().debug(msg, domain);
+}
+export function info(msg, domain = "axoniz") {
+    getLogger().info(msg, domain);
+}
+export function warn(msg, domain = "axoniz") {
+    getLogger().warning(msg, domain);
+}
+export function error(msg, domain = "axoniz") {
+    getLogger().error(msg, domain);
+}
+export function critical(msg, domain = "axoniz") {
+    getLogger().critical(msg, domain);
+}
+export function logJson(data, label = "JSON") {
+    try {
+        getLogger().debug(`${label}:\n${safeJson(data, 2)}`);
+    }
+    catch {
+        getLogger().debug(`${label}: ${String(data)}`);
+    }
+}
+/** Dynamically change console log level. */
+export function setLevel(level) {
+    const lg = getLogger();
+    lg.config.level = level.toUpperCase();
+    // Re-derive threshold through a public setter path.
+    lg.minLevel = normalizeLevel(level);
+    lg.info(`Log level set to ${level.toUpperCase()}`);
+}
+/** Catch-all error handler with actionable fix hints. */
+export function robustHandle(e, context = "") {
+    const err = e instanceof Error ? e : new Error(String(e));
+    const msg = context ? `[CRITICAL] ${context}: ${err.message}` : `[CRITICAL] ${err.message}`;
+    getLogger().error(msg);
+    const s = err.message.toLowerCase();
+    if (s.includes("econnrefused") || s.includes("refused") || s.includes("10061")) {
+        console.log("  [FIX] Backend connection refused. Is LM Studio/Ollama running?");
+    }
+    else if (s.includes("transformers") || s.includes("onnx") || s.includes("av._core")) {
+        console.log("  [FIX] Voice model dependency error. Check your ONNX runtime install.");
+    }
+    else if (s.includes("404")) {
+        console.log("  [FIX] Check your endpoint URL in settings.");
+    }
+    if (["1", "true", "yes"].includes(String(process.env.AXONIZ_DEBUG ?? "").toLowerCase())) {
+        console.error(err.stack);
+    }
+}
+/** Decorator-style helper to log function entry/exit with timing. */
+export function logCalls(level = "info", domain = "axoniz") {
+    return function (fn, ctx) {
+        const name = ctx?.name ?? fn.name ?? "<anonymous>";
+        return (...args) => {
+            const lg = getLogger();
+            lg[level](`\u2192 ${name} | args=${args.length}`, domain);
+            const t0 = Date.now();
+            try {
+                const result = fn(...args);
+                lg[level](`\u2190 ${name} | ok | ${Date.now() - t0}ms`, domain);
+                return result;
+            }
+            catch (e) {
+                const err = e instanceof Error ? e : new Error(String(e));
+                lg.error(`\u2190 ${name} | FAILED | ${Date.now() - t0}ms | ${err.message}`, domain);
+                throw e;
+            }
+        };
+    };
+}
+//# sourceMappingURL=logger.js.map