@better-openclaw/core 1.0.26 → 1.0.31

package/dist/logger/sinks/console-sink.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/logger/sinks/console-sink.ts
+/**
+* Human-readable console output sink.
+* Formats log entries as single-line summaries with optional step details.
+*/
+var ConsoleSink = class {
+	write(entry) {
+		const time = entry.timestamp.slice(11, 19);
+		const lvl = entry.level.toUpperCase().padEnd(5);
+		const src = entry.source;
+		const outcome = entry.outcome ? ` (${entry.outcome})` : "";
+		const duration = entry.durationMs != null ? ` [${entry.durationMs}ms]` : "";
+		const line = `[${time}] [${lvl}] [${src}] ${entry.category}: ${entry.message}${outcome}${duration}`;
+		switch (entry.level) {
+			case "error":
+				console.error(line);
+				break;
+			case "warn":
+				console.warn(line);
+				break;
+			default: console.log(line);
+		}
+		if (entry.steps) for (const step of entry.steps) {
+			const icon = step.status === "success" ? "+" : step.status === "failure" ? "x" : step.status === "skipped" ? "-" : "~";
+			const stepDuration = step.durationMs != null ? ` [${step.durationMs}ms]` : "";
+			const detail = step.detail ? ` (${step.detail})` : "";
+			console.log(`  ${icon} ${step.name}${detail}${stepDuration}`);
+		}
+		if (entry.error) {
+			console.error(`  Error: ${entry.error.message}`);
+			if (entry.error.stack) console.error(`  ${entry.error.stack}`);
+		}
+	}
+};
+//#endregion
+exports.ConsoleSink = ConsoleSink;
+
+//# sourceMappingURL=console-sink.cjs.map

package/dist/logger/sinks/console-sink.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-sink.cjs","names":[],"sources":["../../../src/logger/sinks/console-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Human-readable console output sink.\n * Formats log entries as single-line summaries with optional step details.\n */\nexport class ConsoleSink implements LogSink {\n\twrite(entry: OperationsLogEntry): void {\n\t\tconst time = entry.timestamp.slice(11, 19);\n\t\tconst lvl = entry.level.toUpperCase().padEnd(5);\n\t\tconst src = entry.source;\n\t\tconst outcome = entry.outcome ? ` (${entry.outcome})` : \"\";\n\t\tconst duration = entry.durationMs != null ? ` [${entry.durationMs}ms]` : \"\";\n\n\t\tconst line = `[${time}] [${lvl}] [${src}] ${entry.category}: ${entry.message}${outcome}${duration}`;\n\n\t\tswitch (entry.level) {\n\t\t\tcase \"error\":\n\t\t\t\tconsole.error(line);\n\t\t\t\tbreak;\n\t\t\tcase \"warn\":\n\t\t\t\tconsole.warn(line);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tconsole.log(line);\n\t\t}\n\n\t\tif (entry.steps) {\n\t\t\tfor (const step of entry.steps) {\n\t\t\t\tconst icon =\n\t\t\t\t\tstep.status === \"success\"\n\t\t\t\t\t\t? \"+\"\n\t\t\t\t\t\t: step.status === \"failure\"\n\t\t\t\t\t\t\t? \"x\"\n\t\t\t\t\t\t\t: step.status === \"skipped\"\n\t\t\t\t\t\t\t\t? \"-\"\n\t\t\t\t\t\t\t\t: \"~\";\n\t\t\t\tconst stepDuration = step.durationMs != null ? ` [${step.durationMs}ms]` : \"\";\n\t\t\t\tconst detail = step.detail ? ` (${step.detail})` : \"\";\n\t\t\t\tconsole.log(`  ${icon} ${step.name}${detail}${stepDuration}`);\n\t\t\t}\n\t\t}\n\n\t\tif (entry.error) {\n\t\t\tconsole.error(`  Error: ${entry.error.message}`);\n\t\t\tif (entry.error.stack) {\n\t\t\t\tconsole.error(`  ${entry.error.stack}`);\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;;AAMA,IAAa,cAAb,MAA4C;CAC3C,MAAM,OAAiC;EACtC,MAAM,OAAO,MAAM,UAAU,MAAM,IAAI,GAAG;EAC1C,MAAM,MAAM,MAAM,MAAM,aAAa,CAAC,OAAO,EAAE;EAC/C,MAAM,MAAM,MAAM;EAClB,MAAM,UAAU,MAAM,UAAU,KAAK,MAAM,QAAQ,KAAK;EACxD,MAAM,WAAW,MAAM,cAAc,OAAO,KAAK,MAAM,WAAW,OAAO;EAEzE,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,MAAM,SAAS,IAAI,MAAM,UAAU,UAAU;AAEzF,UAAQ,MAAM,OAAd;GACC,KAAK;AACJ,YAAQ,MAAM,KAAK;AACnB;GACD,KAAK;AACJ,YAAQ,KAAK,KAAK;AAClB;GACD,QACC,SAAQ,IAAI,KAAK;;AAGnB,MAAI,MAAM,MACT,MAAK,MAAM,QAAQ,MAAM,OAAO;GAC/B,MAAM,OACL,KAAK,WAAW,YACb,MACA,KAAK,WAAW,YACf,MACA,KAAK,WAAW,YACf,MACA;GACN,MAAM,eAAe,KAAK,cAAc,OAAO,KAAK,KAAK,WAAW,OAAO;GAC3E,MAAM,SAAS,KAAK,SAAS,KAAK,KAAK,OAAO,KAAK;AACnD,WAAQ,IAAI,KAAK,KAAK,GAAG,KAAK,OAAO,SAAS,eAAe;;AAI/D,MAAI,MAAM,OAAO;AAChB,WAAQ,MAAM,YAAY,MAAM,MAAM,UAAU;AAChD,OAAI,MAAM,MAAM,MACf,SAAQ,MAAM,KAAK,MAAM,MAAM,QAAQ"}

package/dist/logger/sinks/console-sink.d.cts

@@ -0,0 +1,2 @@
+import { t as ConsoleSink } from "../../console-sink-BHQpRyCt.cjs";
+export { ConsoleSink };

package/dist/logger/sinks/console-sink.d.mts

@@ -0,0 +1,2 @@
+import { t as ConsoleSink } from "../../console-sink-bouG_M1K.mjs";
+export { ConsoleSink };

package/dist/logger/sinks/console-sink.mjs

@@ -0,0 +1,38 @@
+//#region src/logger/sinks/console-sink.ts
+/**
+* Human-readable console output sink.
+* Formats log entries as single-line summaries with optional step details.
+*/
+var ConsoleSink = class {
+	write(entry) {
+		const time = entry.timestamp.slice(11, 19);
+		const lvl = entry.level.toUpperCase().padEnd(5);
+		const src = entry.source;
+		const outcome = entry.outcome ? ` (${entry.outcome})` : "";
+		const duration = entry.durationMs != null ? ` [${entry.durationMs}ms]` : "";
+		const line = `[${time}] [${lvl}] [${src}] ${entry.category}: ${entry.message}${outcome}${duration}`;
+		switch (entry.level) {
+			case "error":
+				console.error(line);
+				break;
+			case "warn":
+				console.warn(line);
+				break;
+			default: console.log(line);
+		}
+		if (entry.steps) for (const step of entry.steps) {
+			const icon = step.status === "success" ? "+" : step.status === "failure" ? "x" : step.status === "skipped" ? "-" : "~";
+			const stepDuration = step.durationMs != null ? ` [${step.durationMs}ms]` : "";
+			const detail = step.detail ? ` (${step.detail})` : "";
+			console.log(`  ${icon} ${step.name}${detail}${stepDuration}`);
+		}
+		if (entry.error) {
+			console.error(`  Error: ${entry.error.message}`);
+			if (entry.error.stack) console.error(`  ${entry.error.stack}`);
+		}
+	}
+};
+//#endregion
+export { ConsoleSink };
+
+//# sourceMappingURL=console-sink.mjs.map

package/dist/logger/sinks/console-sink.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-sink.mjs","names":[],"sources":["../../../src/logger/sinks/console-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Human-readable console output sink.\n * Formats log entries as single-line summaries with optional step details.\n */\nexport class ConsoleSink implements LogSink {\n\twrite(entry: OperationsLogEntry): void {\n\t\tconst time = entry.timestamp.slice(11, 19);\n\t\tconst lvl = entry.level.toUpperCase().padEnd(5);\n\t\tconst src = entry.source;\n\t\tconst outcome = entry.outcome ? ` (${entry.outcome})` : \"\";\n\t\tconst duration = entry.durationMs != null ? ` [${entry.durationMs}ms]` : \"\";\n\n\t\tconst line = `[${time}] [${lvl}] [${src}] ${entry.category}: ${entry.message}${outcome}${duration}`;\n\n\t\tswitch (entry.level) {\n\t\t\tcase \"error\":\n\t\t\t\tconsole.error(line);\n\t\t\t\tbreak;\n\t\t\tcase \"warn\":\n\t\t\t\tconsole.warn(line);\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tconsole.log(line);\n\t\t}\n\n\t\tif (entry.steps) {\n\t\t\tfor (const step of entry.steps) {\n\t\t\t\tconst icon =\n\t\t\t\t\tstep.status === \"success\"\n\t\t\t\t\t\t? \"+\"\n\t\t\t\t\t\t: step.status === \"failure\"\n\t\t\t\t\t\t\t? \"x\"\n\t\t\t\t\t\t\t: step.status === \"skipped\"\n\t\t\t\t\t\t\t\t? \"-\"\n\t\t\t\t\t\t\t\t: \"~\";\n\t\t\t\tconst stepDuration = step.durationMs != null ? ` [${step.durationMs}ms]` : \"\";\n\t\t\t\tconst detail = step.detail ? ` (${step.detail})` : \"\";\n\t\t\t\tconsole.log(`  ${icon} ${step.name}${detail}${stepDuration}`);\n\t\t\t}\n\t\t}\n\n\t\tif (entry.error) {\n\t\t\tconsole.error(`  Error: ${entry.error.message}`);\n\t\t\tif (entry.error.stack) {\n\t\t\t\tconsole.error(`  ${entry.error.stack}`);\n\t\t\t}\n\t\t}\n\t}\n}\n"],"mappings":";;;;;AAMA,IAAa,cAAb,MAA4C;CAC3C,MAAM,OAAiC;EACtC,MAAM,OAAO,MAAM,UAAU,MAAM,IAAI,GAAG;EAC1C,MAAM,MAAM,MAAM,MAAM,aAAa,CAAC,OAAO,EAAE;EAC/C,MAAM,MAAM,MAAM;EAClB,MAAM,UAAU,MAAM,UAAU,KAAK,MAAM,QAAQ,KAAK;EACxD,MAAM,WAAW,MAAM,cAAc,OAAO,KAAK,MAAM,WAAW,OAAO;EAEzE,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK,IAAI,IAAI,MAAM,SAAS,IAAI,MAAM,UAAU,UAAU;AAEzF,UAAQ,MAAM,OAAd;GACC,KAAK;AACJ,YAAQ,MAAM,KAAK;AACnB;GACD,KAAK;AACJ,YAAQ,KAAK,KAAK;AAClB;GACD,QACC,SAAQ,IAAI,KAAK;;AAGnB,MAAI,MAAM,MACT,MAAK,MAAM,QAAQ,MAAM,OAAO;GAC/B,MAAM,OACL,KAAK,WAAW,YACb,MACA,KAAK,WAAW,YACf,MACA,KAAK,WAAW,YACf,MACA;GACN,MAAM,eAAe,KAAK,cAAc,OAAO,KAAK,KAAK,WAAW,OAAO;GAC3E,MAAM,SAAS,KAAK,SAAS,KAAK,KAAK,OAAO,KAAK;AACnD,WAAQ,IAAI,KAAK,KAAK,GAAG,KAAK,OAAO,SAAS,eAAe;;AAI/D,MAAI,MAAM,OAAO;AAChB,WAAQ,MAAM,YAAY,MAAM,MAAM,UAAU;AAChD,OAAI,MAAM,MAAM,MACf,SAAQ,MAAM,KAAK,MAAM,MAAM,QAAQ"}

package/dist/logger/sinks/file-sink.cjs

@@ -0,0 +1,72 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../skills-uPxJVmKk.cjs");
+let node_fs = require("node:fs");
+let node_os = require("node:os");
+let node_path = require("node:path");
+//#region src/logger/sinks/file-sink.ts
+const DEFAULT_MAX_SIZE = 10 * 1024 * 1024;
+const DEFAULT_MAX_FILES = 5;
+function defaultLogDir() {
+	return process.env.OPENCLAW_LOG_DIR ?? (0, node_path.join)((0, node_os.homedir)(), ".better-openclaw", "logs");
+}
+/**
+* NDJSON file sink with size-based rotation.
+*
+* Writes one JSON object per line (newline-delimited JSON).
+* Rotates files when they exceed maxFileSize:
+*   operations.log → operations.1.log → operations.2.log → ...
+*/
+var FileSink = class {
+	currentSize = 0;
+	initialized = false;
+	logDir;
+	maxFileSize;
+	maxFiles;
+	filename;
+	logPath;
+	constructor(options) {
+		this.logDir = options?.logDir ?? defaultLogDir();
+		this.maxFileSize = options?.maxFileSize ?? (process.env.OPENCLAW_LOG_MAX_SIZE ? Number.parseInt(process.env.OPENCLAW_LOG_MAX_SIZE, 10) : DEFAULT_MAX_SIZE);
+		this.maxFiles = options?.maxFiles ?? (process.env.OPENCLAW_LOG_MAX_FILES ? Number.parseInt(process.env.OPENCLAW_LOG_MAX_FILES, 10) : DEFAULT_MAX_FILES);
+		this.filename = options?.filename ?? "operations";
+		this.logPath = (0, node_path.join)(this.logDir, `${this.filename}.log`);
+	}
+	write(entry) {
+		this.ensureDir();
+		const line = `${JSON.stringify(entry)}\n`;
+		(0, node_fs.appendFileSync)(this.logPath, line, "utf-8");
+		this.currentSize += Buffer.byteLength(line, "utf-8");
+		if (this.currentSize >= this.maxFileSize) this.rotate();
+	}
+	ensureDir() {
+		if (this.initialized) return;
+		if (!(0, node_fs.existsSync)(this.logDir)) (0, node_fs.mkdirSync)(this.logDir, { recursive: true });
+		if ((0, node_fs.existsSync)(this.logPath)) try {
+			this.currentSize = (0, node_fs.statSync)(this.logPath).size;
+		} catch {
+			this.currentSize = 0;
+		}
+		this.initialized = true;
+	}
+	rotate() {
+		const oldest = (0, node_path.join)(this.logDir, `${this.filename}.${this.maxFiles}.log`);
+		if ((0, node_fs.existsSync)(oldest)) try {
+			(0, node_fs.unlinkSync)(oldest);
+		} catch {}
+		for (let i = this.maxFiles - 1; i >= 1; i--) {
+			const from = (0, node_path.join)(this.logDir, `${this.filename}.${i}.log`);
+			const to = (0, node_path.join)(this.logDir, `${this.filename}.${i + 1}.log`);
+			if ((0, node_fs.existsSync)(from)) try {
+				(0, node_fs.renameSync)(from, to);
+			} catch {}
+		}
+		if ((0, node_fs.existsSync)(this.logPath)) try {
+			(0, node_fs.renameSync)(this.logPath, (0, node_path.join)(this.logDir, `${this.filename}.1.log`));
+		} catch {}
+		this.currentSize = 0;
+	}
+};
+//#endregion
+exports.FileSink = FileSink;
+
+//# sourceMappingURL=file-sink.cjs.map

package/dist/logger/sinks/file-sink.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.cjs","names":[],"sources":["../../../src/logger/sinks/file-sink.ts"],"sourcesContent":["import { appendFileSync, existsSync, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { LogSink, OperationsLogEntry } from \"../types.js\";\n\nexport interface FileSinkOptions {\n\t/** Log directory. Default: ~/.better-openclaw/logs */\n\tlogDir?: string;\n\t/** Max file size in bytes before rotation. Default: 10 MB */\n\tmaxFileSize?: number;\n\t/** Max number of rotated files to keep. Default: 5 */\n\tmaxFiles?: number;\n\t/** Base filename (without extension). Default: \"operations\" */\n\tfilename?: string;\n}\n\nconst DEFAULT_MAX_SIZE = 10 * 1024 * 1024; // 10 MB\nconst DEFAULT_MAX_FILES = 5;\n\nfunction defaultLogDir(): string {\n\treturn process.env.OPENCLAW_LOG_DIR ?? join(homedir(), \".better-openclaw\", \"logs\");\n}\n\n/**\n * NDJSON file sink with size-based rotation.\n *\n * Writes one JSON object per line (newline-delimited JSON).\n * Rotates files when they exceed maxFileSize:\n *   operations.log → operations.1.log → operations.2.log → ...\n */\nexport class FileSink implements LogSink {\n\tprivate currentSize = 0;\n\tprivate initialized = false;\n\tprivate readonly logDir: string;\n\tprivate readonly maxFileSize: number;\n\tprivate readonly maxFiles: number;\n\tprivate readonly filename: string;\n\tprivate readonly logPath: string;\n\n\tconstructor(options?: FileSinkOptions) {\n\t\tthis.logDir = options?.logDir ?? defaultLogDir();\n\t\tthis.maxFileSize =\n\t\t\toptions?.maxFileSize ??\n\t\t\t(process.env.OPENCLAW_LOG_MAX_SIZE\n\t\t\t\t? Number.parseInt(process.env.OPENCLAW_LOG_MAX_SIZE, 10)\n\t\t\t\t: DEFAULT_MAX_SIZE);\n\t\tthis.maxFiles =\n\t\t\toptions?.maxFiles ??\n\t\t\t(process.env.OPENCLAW_LOG_MAX_FILES\n\t\t\t\t? Number.parseInt(process.env.OPENCLAW_LOG_MAX_FILES, 10)\n\t\t\t\t: DEFAULT_MAX_FILES);\n\t\tthis.filename = options?.filename ?? \"operations\";\n\t\tthis.logPath = join(this.logDir, `${this.filename}.log`);\n\t}\n\n\twrite(entry: OperationsLogEntry): void {\n\t\tthis.ensureDir();\n\t\tconst line = `${JSON.stringify(entry)}\\n`;\n\t\tappendFileSync(this.logPath, line, \"utf-8\");\n\t\tthis.currentSize += Buffer.byteLength(line, \"utf-8\");\n\n\t\tif (this.currentSize >= this.maxFileSize) {\n\t\t\tthis.rotate();\n\t\t}\n\t}\n\n\tprivate ensureDir(): void {\n\t\tif (this.initialized) return;\n\n\t\tif (!existsSync(this.logDir)) {\n\t\t\tmkdirSync(this.logDir, { recursive: true });\n\t\t}\n\n\t\t// Seed current size from existing file\n\t\tif (existsSync(this.logPath)) {\n\t\t\ttry {\n\t\t\t\tthis.currentSize = statSync(this.logPath).size;\n\t\t\t} catch {\n\t\t\t\tthis.currentSize = 0;\n\t\t\t}\n\t\t}\n\n\t\tthis.initialized = true;\n\t}\n\n\tprivate rotate(): void {\n\t\t// Delete the oldest file if it exists\n\t\tconst oldest = join(this.logDir, `${this.filename}.${this.maxFiles}.log`);\n\t\tif (existsSync(oldest)) {\n\t\t\ttry {\n\t\t\t\tunlinkSync(oldest);\n\t\t\t} catch {\n\t\t\t\t// Ignore\n\t\t\t}\n\t\t}\n\n\t\t// Shift existing rotated files: N-1 → N, N-2 → N-1, ..., 1 → 2\n\t\tfor (let i = this.maxFiles - 1; i >= 1; i--) {\n\t\t\tconst from = join(this.logDir, `${this.filename}.${i}.log`);\n\t\t\tconst to = join(this.logDir, `${this.filename}.${i + 1}.log`);\n\t\t\tif (existsSync(from)) {\n\t\t\t\ttry {\n\t\t\t\t\trenameSync(from, to);\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Rename current log to .1.log\n\t\tif (existsSync(this.logPath)) {\n\t\t\ttry {\n\t\t\t\trenameSync(this.logPath, join(this.logDir, `${this.filename}.1.log`));\n\t\t\t} catch {\n\t\t\t\t// Ignore\n\t\t\t}\n\t\t}\n\n\t\tthis.currentSize = 0;\n\t}\n}\n"],"mappings":";;;;;;AAgBA,MAAM,mBAAmB,KAAK,OAAO;AACrC,MAAM,oBAAoB;AAE1B,SAAS,gBAAwB;AAChC,QAAO,QAAQ,IAAI,qBAAA,GAAA,UAAA,OAAA,GAAA,QAAA,UAAkC,EAAE,oBAAoB,OAAO;;;;;;;;;AAUnF,IAAa,WAAb,MAAyC;CACxC,cAAsB;CACtB,cAAsB;CACtB;CACA;CACA;CACA;CACA;CAEA,YAAY,SAA2B;AACtC,OAAK,SAAS,SAAS,UAAU,eAAe;AAChD,OAAK,cACJ,SAAS,gBACR,QAAQ,IAAI,wBACV,OAAO,SAAS,QAAQ,IAAI,uBAAuB,GAAG,GACtD;AACJ,OAAK,WACJ,SAAS,aACR,QAAQ,IAAI,yBACV,OAAO,SAAS,QAAQ,IAAI,wBAAwB,GAAG,GACvD;AACJ,OAAK,WAAW,SAAS,YAAY;AACrC,OAAK,WAAA,GAAA,UAAA,MAAe,KAAK,QAAQ,GAAG,KAAK,SAAS,MAAM;;CAGzD,MAAM,OAAiC;AACtC,OAAK,WAAW;EAChB,MAAM,OAAO,GAAG,KAAK,UAAU,MAAM,CAAC;AACtC,GAAA,GAAA,QAAA,gBAAe,KAAK,SAAS,MAAM,QAAQ;AAC3C,OAAK,eAAe,OAAO,WAAW,MAAM,QAAQ;AAEpD,MAAI,KAAK,eAAe,KAAK,YAC5B,MAAK,QAAQ;;CAIf,YAA0B;AACzB,MAAI,KAAK,YAAa;AAEtB,MAAI,EAAA,GAAA,QAAA,YAAY,KAAK,OAAO,CAC3B,EAAA,GAAA,QAAA,WAAU,KAAK,QAAQ,EAAE,WAAW,MAAM,CAAC;AAI5C,OAAA,GAAA,QAAA,YAAe,KAAK,QAAQ,CAC3B,KAAI;AACH,QAAK,eAAA,GAAA,QAAA,UAAuB,KAAK,QAAQ,CAAC;UACnC;AACP,QAAK,cAAc;;AAIrB,OAAK,cAAc;;CAGpB,SAAuB;EAEtB,MAAM,UAAA,GAAA,UAAA,MAAc,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,KAAK,SAAS,MAAM;AACzE,OAAA,GAAA,QAAA,YAAe,OAAO,CACrB,KAAI;AACH,IAAA,GAAA,QAAA,YAAW,OAAO;UACX;AAMT,OAAK,IAAI,IAAI,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK;GAC5C,MAAM,QAAA,GAAA,UAAA,MAAY,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,EAAE,MAAM;GAC3D,MAAM,MAAA,GAAA,UAAA,MAAU,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,IAAI,EAAE,MAAM;AAC7D,QAAA,GAAA,QAAA,YAAe,KAAK,CACnB,KAAI;AACH,KAAA,GAAA,QAAA,YAAW,MAAM,GAAG;WACb;;AAOV,OAAA,GAAA,QAAA,YAAe,KAAK,QAAQ,CAC3B,KAAI;AACH,IAAA,GAAA,QAAA,YAAW,KAAK,UAAA,GAAA,UAAA,MAAc,KAAK,QAAQ,GAAG,KAAK,SAAS,QAAQ,CAAC;UAC9D;AAKT,OAAK,cAAc"}

package/dist/logger/sinks/file-sink.d.cts

@@ -0,0 +1,36 @@
+import { n as LogSink, s as OperationsLogEntry } from "../../types-CyZ5mn6w.cjs";
+
+//#region src/logger/sinks/file-sink.d.ts
+interface FileSinkOptions {
+  /** Log directory. Default: ~/.better-openclaw/logs */
+  logDir?: string;
+  /** Max file size in bytes before rotation. Default: 10 MB */
+  maxFileSize?: number;
+  /** Max number of rotated files to keep. Default: 5 */
+  maxFiles?: number;
+  /** Base filename (without extension). Default: "operations" */
+  filename?: string;
+}
+/**
+ * NDJSON file sink with size-based rotation.
+ *
+ * Writes one JSON object per line (newline-delimited JSON).
+ * Rotates files when they exceed maxFileSize:
+ *   operations.log → operations.1.log → operations.2.log → ...
+ */
+declare class FileSink implements LogSink {
+  private currentSize;
+  private initialized;
+  private readonly logDir;
+  private readonly maxFileSize;
+  private readonly maxFiles;
+  private readonly filename;
+  private readonly logPath;
+  constructor(options?: FileSinkOptions);
+  write(entry: OperationsLogEntry): void;
+  private ensureDir;
+  private rotate;
+}
+//#endregion
+export { FileSink, FileSinkOptions };
+//# sourceMappingURL=file-sink.d.cts.map

package/dist/logger/sinks/file-sink.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.d.cts","names":[],"sources":["../../../src/logger/sinks/file-sink.ts"],"mappings":";;;UAKiB,eAAA;;EAEhB,MAAA;EAF+B;EAI/B,WAAA;EAJ+B;EAM/B,QAAA;EAFA;EAIA,QAAA;AAAA;;;AAiBD;;;;;cAAa,QAAA,YAAoB,OAAA;EAAA,QACxB,WAAA;EAAA,QACA,WAAA;EAAA,iBACS,MAAA;EAAA,iBACA,WAAA;EAAA,iBACA,QAAA;EAAA,iBACA,QAAA;EAAA,iBACA,OAAA;cAEL,OAAA,GAAU,eAAA;EAgBtB,KAAA,CAAM,KAAA,EAAO,kBAAA;EAAA,QAWL,SAAA;EAAA,QAmBA,MAAA;AAAA"}

package/dist/logger/sinks/file-sink.d.mts

@@ -0,0 +1,36 @@
+import { n as LogSink, s as OperationsLogEntry } from "../../types-BREUfzzq.mjs";
+
+//#region src/logger/sinks/file-sink.d.ts
+interface FileSinkOptions {
+  /** Log directory. Default: ~/.better-openclaw/logs */
+  logDir?: string;
+  /** Max file size in bytes before rotation. Default: 10 MB */
+  maxFileSize?: number;
+  /** Max number of rotated files to keep. Default: 5 */
+  maxFiles?: number;
+  /** Base filename (without extension). Default: "operations" */
+  filename?: string;
+}
+/**
+ * NDJSON file sink with size-based rotation.
+ *
+ * Writes one JSON object per line (newline-delimited JSON).
+ * Rotates files when they exceed maxFileSize:
+ *   operations.log → operations.1.log → operations.2.log → ...
+ */
+declare class FileSink implements LogSink {
+  private currentSize;
+  private initialized;
+  private readonly logDir;
+  private readonly maxFileSize;
+  private readonly maxFiles;
+  private readonly filename;
+  private readonly logPath;
+  constructor(options?: FileSinkOptions);
+  write(entry: OperationsLogEntry): void;
+  private ensureDir;
+  private rotate;
+}
+//#endregion
+export { FileSink, FileSinkOptions };
+//# sourceMappingURL=file-sink.d.mts.map

package/dist/logger/sinks/file-sink.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.d.mts","names":[],"sources":["../../../src/logger/sinks/file-sink.ts"],"mappings":";;;UAKiB,eAAA;;EAEhB,MAAA;EAF+B;EAI/B,WAAA;EAJ+B;EAM/B,QAAA;EAFA;EAIA,QAAA;AAAA;;;AAiBD;;;;;cAAa,QAAA,YAAoB,OAAA;EAAA,QACxB,WAAA;EAAA,QACA,WAAA;EAAA,iBACS,MAAA;EAAA,iBACA,WAAA;EAAA,iBACA,QAAA;EAAA,iBACA,QAAA;EAAA,iBACA,OAAA;cAEL,OAAA,GAAU,eAAA;EAgBtB,KAAA,CAAM,KAAA,EAAO,kBAAA;EAAA,QAWL,SAAA;EAAA,QAmBA,MAAA;AAAA"}

package/dist/logger/sinks/file-sink.mjs

@@ -0,0 +1,70 @@
+import { appendFileSync, existsSync, mkdirSync, renameSync, statSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+//#region src/logger/sinks/file-sink.ts
+const DEFAULT_MAX_SIZE = 10 * 1024 * 1024;
+const DEFAULT_MAX_FILES = 5;
+function defaultLogDir() {
+	return process.env.OPENCLAW_LOG_DIR ?? join(homedir(), ".better-openclaw", "logs");
+}
+/**
+* NDJSON file sink with size-based rotation.
+*
+* Writes one JSON object per line (newline-delimited JSON).
+* Rotates files when they exceed maxFileSize:
+*   operations.log → operations.1.log → operations.2.log → ...
+*/
+var FileSink = class {
+	currentSize = 0;
+	initialized = false;
+	logDir;
+	maxFileSize;
+	maxFiles;
+	filename;
+	logPath;
+	constructor(options) {
+		this.logDir = options?.logDir ?? defaultLogDir();
+		this.maxFileSize = options?.maxFileSize ?? (process.env.OPENCLAW_LOG_MAX_SIZE ? Number.parseInt(process.env.OPENCLAW_LOG_MAX_SIZE, 10) : DEFAULT_MAX_SIZE);
+		this.maxFiles = options?.maxFiles ?? (process.env.OPENCLAW_LOG_MAX_FILES ? Number.parseInt(process.env.OPENCLAW_LOG_MAX_FILES, 10) : DEFAULT_MAX_FILES);
+		this.filename = options?.filename ?? "operations";
+		this.logPath = join(this.logDir, `${this.filename}.log`);
+	}
+	write(entry) {
+		this.ensureDir();
+		const line = `${JSON.stringify(entry)}\n`;
+		appendFileSync(this.logPath, line, "utf-8");
+		this.currentSize += Buffer.byteLength(line, "utf-8");
+		if (this.currentSize >= this.maxFileSize) this.rotate();
+	}
+	ensureDir() {
+		if (this.initialized) return;
+		if (!existsSync(this.logDir)) mkdirSync(this.logDir, { recursive: true });
+		if (existsSync(this.logPath)) try {
+			this.currentSize = statSync(this.logPath).size;
+		} catch {
+			this.currentSize = 0;
+		}
+		this.initialized = true;
+	}
+	rotate() {
+		const oldest = join(this.logDir, `${this.filename}.${this.maxFiles}.log`);
+		if (existsSync(oldest)) try {
+			unlinkSync(oldest);
+		} catch {}
+		for (let i = this.maxFiles - 1; i >= 1; i--) {
+			const from = join(this.logDir, `${this.filename}.${i}.log`);
+			const to = join(this.logDir, `${this.filename}.${i + 1}.log`);
+			if (existsSync(from)) try {
+				renameSync(from, to);
+			} catch {}
+		}
+		if (existsSync(this.logPath)) try {
+			renameSync(this.logPath, join(this.logDir, `${this.filename}.1.log`));
+		} catch {}
+		this.currentSize = 0;
+	}
+};
+//#endregion
+export { FileSink };
+
+//# sourceMappingURL=file-sink.mjs.map

package/dist/logger/sinks/file-sink.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sink.mjs","names":[],"sources":["../../../src/logger/sinks/file-sink.ts"],"sourcesContent":["import { appendFileSync, existsSync, mkdirSync, renameSync, statSync, unlinkSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { join } from \"node:path\";\nimport type { LogSink, OperationsLogEntry } from \"../types.js\";\n\nexport interface FileSinkOptions {\n\t/** Log directory. Default: ~/.better-openclaw/logs */\n\tlogDir?: string;\n\t/** Max file size in bytes before rotation. Default: 10 MB */\n\tmaxFileSize?: number;\n\t/** Max number of rotated files to keep. Default: 5 */\n\tmaxFiles?: number;\n\t/** Base filename (without extension). Default: \"operations\" */\n\tfilename?: string;\n}\n\nconst DEFAULT_MAX_SIZE = 10 * 1024 * 1024; // 10 MB\nconst DEFAULT_MAX_FILES = 5;\n\nfunction defaultLogDir(): string {\n\treturn process.env.OPENCLAW_LOG_DIR ?? join(homedir(), \".better-openclaw\", \"logs\");\n}\n\n/**\n * NDJSON file sink with size-based rotation.\n *\n * Writes one JSON object per line (newline-delimited JSON).\n * Rotates files when they exceed maxFileSize:\n *   operations.log → operations.1.log → operations.2.log → ...\n */\nexport class FileSink implements LogSink {\n\tprivate currentSize = 0;\n\tprivate initialized = false;\n\tprivate readonly logDir: string;\n\tprivate readonly maxFileSize: number;\n\tprivate readonly maxFiles: number;\n\tprivate readonly filename: string;\n\tprivate readonly logPath: string;\n\n\tconstructor(options?: FileSinkOptions) {\n\t\tthis.logDir = options?.logDir ?? defaultLogDir();\n\t\tthis.maxFileSize =\n\t\t\toptions?.maxFileSize ??\n\t\t\t(process.env.OPENCLAW_LOG_MAX_SIZE\n\t\t\t\t? Number.parseInt(process.env.OPENCLAW_LOG_MAX_SIZE, 10)\n\t\t\t\t: DEFAULT_MAX_SIZE);\n\t\tthis.maxFiles =\n\t\t\toptions?.maxFiles ??\n\t\t\t(process.env.OPENCLAW_LOG_MAX_FILES\n\t\t\t\t? Number.parseInt(process.env.OPENCLAW_LOG_MAX_FILES, 10)\n\t\t\t\t: DEFAULT_MAX_FILES);\n\t\tthis.filename = options?.filename ?? \"operations\";\n\t\tthis.logPath = join(this.logDir, `${this.filename}.log`);\n\t}\n\n\twrite(entry: OperationsLogEntry): void {\n\t\tthis.ensureDir();\n\t\tconst line = `${JSON.stringify(entry)}\\n`;\n\t\tappendFileSync(this.logPath, line, \"utf-8\");\n\t\tthis.currentSize += Buffer.byteLength(line, \"utf-8\");\n\n\t\tif (this.currentSize >= this.maxFileSize) {\n\t\t\tthis.rotate();\n\t\t}\n\t}\n\n\tprivate ensureDir(): void {\n\t\tif (this.initialized) return;\n\n\t\tif (!existsSync(this.logDir)) {\n\t\t\tmkdirSync(this.logDir, { recursive: true });\n\t\t}\n\n\t\t// Seed current size from existing file\n\t\tif (existsSync(this.logPath)) {\n\t\t\ttry {\n\t\t\t\tthis.currentSize = statSync(this.logPath).size;\n\t\t\t} catch {\n\t\t\t\tthis.currentSize = 0;\n\t\t\t}\n\t\t}\n\n\t\tthis.initialized = true;\n\t}\n\n\tprivate rotate(): void {\n\t\t// Delete the oldest file if it exists\n\t\tconst oldest = join(this.logDir, `${this.filename}.${this.maxFiles}.log`);\n\t\tif (existsSync(oldest)) {\n\t\t\ttry {\n\t\t\t\tunlinkSync(oldest);\n\t\t\t} catch {\n\t\t\t\t// Ignore\n\t\t\t}\n\t\t}\n\n\t\t// Shift existing rotated files: N-1 → N, N-2 → N-1, ..., 1 → 2\n\t\tfor (let i = this.maxFiles - 1; i >= 1; i--) {\n\t\t\tconst from = join(this.logDir, `${this.filename}.${i}.log`);\n\t\t\tconst to = join(this.logDir, `${this.filename}.${i + 1}.log`);\n\t\t\tif (existsSync(from)) {\n\t\t\t\ttry {\n\t\t\t\t\trenameSync(from, to);\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Rename current log to .1.log\n\t\tif (existsSync(this.logPath)) {\n\t\t\ttry {\n\t\t\t\trenameSync(this.logPath, join(this.logDir, `${this.filename}.1.log`));\n\t\t\t} catch {\n\t\t\t\t// Ignore\n\t\t\t}\n\t\t}\n\n\t\tthis.currentSize = 0;\n\t}\n}\n"],"mappings":";;;;AAgBA,MAAM,mBAAmB,KAAK,OAAO;AACrC,MAAM,oBAAoB;AAE1B,SAAS,gBAAwB;AAChC,QAAO,QAAQ,IAAI,oBAAoB,KAAK,SAAS,EAAE,oBAAoB,OAAO;;;;;;;;;AAUnF,IAAa,WAAb,MAAyC;CACxC,cAAsB;CACtB,cAAsB;CACtB;CACA;CACA;CACA;CACA;CAEA,YAAY,SAA2B;AACtC,OAAK,SAAS,SAAS,UAAU,eAAe;AAChD,OAAK,cACJ,SAAS,gBACR,QAAQ,IAAI,wBACV,OAAO,SAAS,QAAQ,IAAI,uBAAuB,GAAG,GACtD;AACJ,OAAK,WACJ,SAAS,aACR,QAAQ,IAAI,yBACV,OAAO,SAAS,QAAQ,IAAI,wBAAwB,GAAG,GACvD;AACJ,OAAK,WAAW,SAAS,YAAY;AACrC,OAAK,UAAU,KAAK,KAAK,QAAQ,GAAG,KAAK,SAAS,MAAM;;CAGzD,MAAM,OAAiC;AACtC,OAAK,WAAW;EAChB,MAAM,OAAO,GAAG,KAAK,UAAU,MAAM,CAAC;AACtC,iBAAe,KAAK,SAAS,MAAM,QAAQ;AAC3C,OAAK,eAAe,OAAO,WAAW,MAAM,QAAQ;AAEpD,MAAI,KAAK,eAAe,KAAK,YAC5B,MAAK,QAAQ;;CAIf,YAA0B;AACzB,MAAI,KAAK,YAAa;AAEtB,MAAI,CAAC,WAAW,KAAK,OAAO,CAC3B,WAAU,KAAK,QAAQ,EAAE,WAAW,MAAM,CAAC;AAI5C,MAAI,WAAW,KAAK,QAAQ,CAC3B,KAAI;AACH,QAAK,cAAc,SAAS,KAAK,QAAQ,CAAC;UACnC;AACP,QAAK,cAAc;;AAIrB,OAAK,cAAc;;CAGpB,SAAuB;EAEtB,MAAM,SAAS,KAAK,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,KAAK,SAAS,MAAM;AACzE,MAAI,WAAW,OAAO,CACrB,KAAI;AACH,cAAW,OAAO;UACX;AAMT,OAAK,IAAI,IAAI,KAAK,WAAW,GAAG,KAAK,GAAG,KAAK;GAC5C,MAAM,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,EAAE,MAAM;GAC3D,MAAM,KAAK,KAAK,KAAK,QAAQ,GAAG,KAAK,SAAS,GAAG,IAAI,EAAE,MAAM;AAC7D,OAAI,WAAW,KAAK,CACnB,KAAI;AACH,eAAW,MAAM,GAAG;WACb;;AAOV,MAAI,WAAW,KAAK,QAAQ,CAC3B,KAAI;AACH,cAAW,KAAK,SAAS,KAAK,KAAK,QAAQ,GAAG,KAAK,SAAS,QAAQ,CAAC;UAC9D;AAKT,OAAK,cAAc"}

package/dist/logger/types.d.cts

@@ -0,0 +1,2 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, n as LogSink, o as OperationStep, r as LogSource, s as OperationsLogEntry, t as LogLevel } from "../types-CyZ5mn6w.cjs";
+export { LogLevel, LogSink, LogSource, OperationCategory, OperationOutcome, OperationStep, OperationsLogEntry, OperationsLoggerOptions };

package/dist/logger/types.d.mts

@@ -0,0 +1,2 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, n as LogSink, o as OperationStep, r as LogSource, s as OperationsLogEntry, t as LogLevel } from "../types-BREUfzzq.mjs";
+export { LogLevel, LogSink, LogSource, OperationCategory, OperationOutcome, OperationStep, OperationsLogEntry, OperationsLoggerOptions };

package/dist/logger/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/logger-CZ0Qnyiu.d.mts

@@ -0,0 +1,66 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, o as OperationStep, s as OperationsLogEntry } from "./types-BREUfzzq.mjs";
+
+//#region src/logger/logger.d.ts
+/**
+ * Tracks individual steps within a multi-step operation (e.g. deploy, generate).
+ */
+declare class StepTracker {
+  private readonly logger;
+  private readonly category;
+  private readonly operationName;
+  private steps;
+  private currentStep;
+  private readonly operationStart;
+  constructor(logger: OperationsLogger, category: OperationCategory, operationName: string);
+  /** Start a new step. Automatically completes the previous step if still open. */
+  begin(name: string, detail?: string): void;
+  /** Mark the current step as completed. */
+  complete(detail?: string): void;
+  /** Mark the current step as failed. */
+  fail(error: string): void;
+  /** Record a skipped step. */
+  skip(name: string, reason?: string): void;
+  /** Finalize and log the full operation summary. Returns all steps. */
+  finalize(outcome: OperationOutcome): OperationStep[];
+  /** Get the current list of steps (snapshot). */
+  getSteps(): OperationStep[];
+}
+/**
+ * Centralized operations logger.
+ *
+ * Follows fire-and-forget semantics — sink errors are silently caught and
+ * logging never blocks or crashes the main flow.
+ */
+declare class OperationsLogger {
+  private readonly source;
+  private readonly sinks;
+  private readonly correlationId;
+  private readonly sessionId;
+  private readonly minLevel;
+  constructor(options: OperationsLoggerOptions);
+  /** Create a child logger that inherits correlation/session but can override source or sinks. */
+  child(overrides: Partial<OperationsLoggerOptions>): OperationsLogger;
+  /** Log an operation with full context. Fire-and-forget to all sinks. */
+  log(entry: Omit<OperationsLogEntry, "id" | "timestamp" | "source" | "correlationId" | "sessionId">): void;
+  info(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  warn(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  error(category: OperationCategory, message: string, err?: Error | null, context?: Record<string, unknown>): void;
+  debug(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  /**
+   * Log a timed operation. Wraps an async/sync function with start/end/duration logging.
+   * Re-throws the original error on failure.
+   */
+  timed<T>(category: OperationCategory, message: string, fn: () => T | Promise<T>, context?: Record<string, unknown>): Promise<T>;
+  /** Create a step tracker for multi-step operations (deploy, generate pipeline). */
+  createStepTracker(category: OperationCategory, operationName: string): StepTracker;
+  /** Flush all sinks. */
+  flush(): Promise<void>;
+  /** Destroy all sinks (cleanup timers, close streams). */
+  destroy(): Promise<void>;
+  getCorrelationId(): string;
+  getSessionId(): string;
+  private shouldLog;
+}
+//#endregion
+export { StepTracker as n, OperationsLogger as t };
+//# sourceMappingURL=logger-CZ0Qnyiu.d.mts.map

package/dist/logger-CZ0Qnyiu.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CZ0Qnyiu.d.mts","names":[],"sources":["../src/logger/logger.ts"],"mappings":";;;;;AAmDA;cAAa,WAAA;EAAA,iBAMM,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,aAAA;EAAA,QAPV,KAAA;EAAA,QACA,WAAA;EAAA,iBACS,cAAA;cAGC,MAAA,EAAQ,gBAAA,EACR,QAAA,EAAU,iBAAA,EACV,aAAA;EA0EO;EAtEzB,KAAA,CAAM,IAAA,UAAc,MAAA;EALF;EAyBlB,QAAA,CAAS,MAAA;EA/BD;EAwCR,IAAA,CAAK,KAAA;EAtCY;EA+CjB,IAAA,CAAK,IAAA,UAAc,MAAA;EA5CO;EAwD1B,QAAA,CAAS,OAAA,EAAS,gBAAA,GAAmB,aAAA;EAvDT;EA2E5B,QAAA,CAAA,GAAY,aAAA;AAAA;;;;;;;cAWA,gBAAA;EAAA,iBACK,MAAA;EAAA,iBACA,KAAA;EAAA,iBACA,aAAA;EAAA,iBACA,SAAA;EAAA,iBACA,QAAA;cAEL,OAAA,EAAS,uBAAA;EAtCgB;EA+CrC,KAAA,CAAM,SAAA,EAAW,OAAA,CAAQ,uBAAA,IAA2B,gBAAA;EA3BxC;EAsCZ,GAAA,CACC,KAAA,EAAO,IAAA,CAAK,kBAAA;EA0Bb,IAAA,CAAK,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EAI7D,IAAA,CAAK,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EAI7D,KAAA,CACC,QAAA,EAAU,iBAAA,EACV,OAAA,UACA,GAAA,GAAM,KAAA,SACN,OAAA,GAAU,MAAA;EAkBX,KAAA,CAAM,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EA7EzC;;;;EAqFf,KAAA,GAAA,CACL,QAAA,EAAU,iBAAA,EACV,OAAA,UACA,EAAA,QAAU,CAAA,GAAI,OAAA,CAAQ,CAAA,GACtB,OAAA,GAAU,MAAA,oBACR,OAAA,CAAQ,CAAA;EArEH;EAgHR,iBAAA,CAAkB,QAAA,EAAU,iBAAA,EAAmB,aAAA,WAAwB,WAAA;EAtFV;EA2FvD,KAAA,CAAA,GAAS,OAAA;EAvF8C;EAoGvD,OAAA,CAAA,GAAW,OAAA;EAYjB,gBAAA,CAAA;EAIA,YAAA,CAAA;EAAA,QAIQ,SAAA;AAAA"}

package/dist/logger-DDfwai-A.d.cts

@@ -0,0 +1,66 @@
+import { a as OperationOutcome, c as OperationsLoggerOptions, i as OperationCategory, o as OperationStep, s as OperationsLogEntry } from "./types-CyZ5mn6w.cjs";
+
+//#region src/logger/logger.d.ts
+/**
+ * Tracks individual steps within a multi-step operation (e.g. deploy, generate).
+ */
+declare class StepTracker {
+  private readonly logger;
+  private readonly category;
+  private readonly operationName;
+  private steps;
+  private currentStep;
+  private readonly operationStart;
+  constructor(logger: OperationsLogger, category: OperationCategory, operationName: string);
+  /** Start a new step. Automatically completes the previous step if still open. */
+  begin(name: string, detail?: string): void;
+  /** Mark the current step as completed. */
+  complete(detail?: string): void;
+  /** Mark the current step as failed. */
+  fail(error: string): void;
+  /** Record a skipped step. */
+  skip(name: string, reason?: string): void;
+  /** Finalize and log the full operation summary. Returns all steps. */
+  finalize(outcome: OperationOutcome): OperationStep[];
+  /** Get the current list of steps (snapshot). */
+  getSteps(): OperationStep[];
+}
+/**
+ * Centralized operations logger.
+ *
+ * Follows fire-and-forget semantics — sink errors are silently caught and
+ * logging never blocks or crashes the main flow.
+ */
+declare class OperationsLogger {
+  private readonly source;
+  private readonly sinks;
+  private readonly correlationId;
+  private readonly sessionId;
+  private readonly minLevel;
+  constructor(options: OperationsLoggerOptions);
+  /** Create a child logger that inherits correlation/session but can override source or sinks. */
+  child(overrides: Partial<OperationsLoggerOptions>): OperationsLogger;
+  /** Log an operation with full context. Fire-and-forget to all sinks. */
+  log(entry: Omit<OperationsLogEntry, "id" | "timestamp" | "source" | "correlationId" | "sessionId">): void;
+  info(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  warn(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  error(category: OperationCategory, message: string, err?: Error | null, context?: Record<string, unknown>): void;
+  debug(category: OperationCategory, message: string, context?: Record<string, unknown>): void;
+  /**
+   * Log a timed operation. Wraps an async/sync function with start/end/duration logging.
+   * Re-throws the original error on failure.
+   */
+  timed<T>(category: OperationCategory, message: string, fn: () => T | Promise<T>, context?: Record<string, unknown>): Promise<T>;
+  /** Create a step tracker for multi-step operations (deploy, generate pipeline). */
+  createStepTracker(category: OperationCategory, operationName: string): StepTracker;
+  /** Flush all sinks. */
+  flush(): Promise<void>;
+  /** Destroy all sinks (cleanup timers, close streams). */
+  destroy(): Promise<void>;
+  getCorrelationId(): string;
+  getSessionId(): string;
+  private shouldLog;
+}
+//#endregion
+export { StepTracker as n, OperationsLogger as t };
+//# sourceMappingURL=logger-DDfwai-A.d.cts.map

package/dist/logger-DDfwai-A.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-DDfwai-A.d.cts","names":[],"sources":["../src/logger/logger.ts"],"mappings":";;;;;AAmDA;cAAa,WAAA;EAAA,iBAMM,MAAA;EAAA,iBACA,QAAA;EAAA,iBACA,aAAA;EAAA,QAPV,KAAA;EAAA,QACA,WAAA;EAAA,iBACS,cAAA;cAGC,MAAA,EAAQ,gBAAA,EACR,QAAA,EAAU,iBAAA,EACV,aAAA;EA0EO;EAtEzB,KAAA,CAAM,IAAA,UAAc,MAAA;EALF;EAyBlB,QAAA,CAAS,MAAA;EA/BD;EAwCR,IAAA,CAAK,KAAA;EAtCY;EA+CjB,IAAA,CAAK,IAAA,UAAc,MAAA;EA5CO;EAwD1B,QAAA,CAAS,OAAA,EAAS,gBAAA,GAAmB,aAAA;EAvDT;EA2E5B,QAAA,CAAA,GAAY,aAAA;AAAA;;;;;;;cAWA,gBAAA;EAAA,iBACK,MAAA;EAAA,iBACA,KAAA;EAAA,iBACA,aAAA;EAAA,iBACA,SAAA;EAAA,iBACA,QAAA;cAEL,OAAA,EAAS,uBAAA;EAtCgB;EA+CrC,KAAA,CAAM,SAAA,EAAW,OAAA,CAAQ,uBAAA,IAA2B,gBAAA;EA3BxC;EAsCZ,GAAA,CACC,KAAA,EAAO,IAAA,CAAK,kBAAA;EA0Bb,IAAA,CAAK,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EAI7D,IAAA,CAAK,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EAI7D,KAAA,CACC,QAAA,EAAU,iBAAA,EACV,OAAA,UACA,GAAA,GAAM,KAAA,SACN,OAAA,GAAU,MAAA;EAkBX,KAAA,CAAM,QAAA,EAAU,iBAAA,EAAmB,OAAA,UAAiB,OAAA,GAAU,MAAA;EA7EzC;;;;EAqFf,KAAA,GAAA,CACL,QAAA,EAAU,iBAAA,EACV,OAAA,UACA,EAAA,QAAU,CAAA,GAAI,OAAA,CAAQ,CAAA,GACtB,OAAA,GAAU,MAAA,oBACR,OAAA,CAAQ,CAAA;EArEH;EAgHR,iBAAA,CAAkB,QAAA,EAAU,iBAAA,EAAmB,aAAA,WAAwB,WAAA;EAtFV;EA2FvD,KAAA,CAAA,GAAS,OAAA;EAvF8C;EAoGvD,OAAA,CAAA,GAAW,OAAA;EAYjB,gBAAA,CAAA;EAIA,YAAA,CAAA;EAAA,QAIQ,SAAA;AAAA"}

package/dist/memu-BfRXtwmL.d.cts

@@ -0,0 +1,7 @@
+import { t as AgentFrameworkDefinition } from "./types-DIsPc-hb.cjs";
+
+//#region src/frameworks/memu.d.ts
+declare const memuFramework: AgentFrameworkDefinition;
+//#endregion
+export { memuFramework as t };
+//# sourceMappingURL=memu-BfRXtwmL.d.cts.map

package/dist/memu-BfRXtwmL.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memu-BfRXtwmL.d.cts","names":[],"sources":["../src/frameworks/memu.ts"],"mappings":";;;cAuBa,aAAA,EAAe,wBAAA"}

package/dist/memu-C-fXbWr-.d.mts

@@ -0,0 +1,7 @@
+import { t as AgentFrameworkDefinition } from "./types-DbXajvYq.mjs";
+
+//#region src/frameworks/memu.d.ts
+declare const memuFramework: AgentFrameworkDefinition;
+//#endregion
+export { memuFramework as t };
+//# sourceMappingURL=memu-C-fXbWr-.d.mts.map

package/dist/memu-C-fXbWr-.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memu-C-fXbWr-.d.mts","names":[],"sources":["../src/frameworks/memu.ts"],"mappings":";;;cAuBa,aAAA,EAAe,wBAAA"}

package/dist/migrations.cjs

@@ -1,20 +1,28 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/migrations.ts
-const CURRENT_CONFIG_VERSION = 2;
-const migrations = { 1: (input) => ({
-	...input,
-	configVersion: 2,
-	deploymentType: input.deploymentType ?? "docker"
-}) };
+const CURRENT_CONFIG_VERSION = 3;
+const migrations = {
+	1: (input) => ({
+		...input,
+		configVersion: 2,
+		deploymentType: input.deploymentType ?? "docker"
+	}),
+	2: (input) => ({
+		...input,
+		configVersion: 3,
+		primaryFramework: input.primaryFramework ?? "openclaw",
+		companionFrameworks: input.companionFrameworks ?? []
+	})
+};
 /**
 * Applies sequential migrations to bring a config from its current version
 * to CURRENT_CONFIG_VERSION. Returns the config unchanged if already current.
 */
 function migrateConfig(input) {
 	let version = input.configVersion ?? 1;
-	if (version > 2) throw new Error(`No migration path from config version ${version}`);
+	if (version > 3) throw new Error(`No migration path from config version ${version}`);
 	let current = { ...input };
-	while (version < 2) {
+	while (version < 3) {
 		const migrationFn = migrations[version];
 		if (!migrationFn) throw new Error(`No migration path from config version ${version}`);
 		current = migrationFn(current);
@@ -26,7 +34,7 @@ function migrateConfig(input) {
 * Returns true if the config needs migration to the current version.
 */
 function needsMigration(input) {
-	return (input.configVersion ?? 1) < 2;
+	return (input.configVersion ?? 1) < 3;
 }
 //#endregion
 exports.CURRENT_CONFIG_VERSION = CURRENT_CONFIG_VERSION;

package/dist/migrations.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.cjs","names":[],"sources":["../src/migrations.ts"],"sourcesContent":["export const CURRENT_CONFIG_VERSION = 2;\n\ntype MigrationFn = (input: Record<string, unknown>) => Record<string, unknown>;\n\nconst migrations: Record<number, MigrationFn> = {\n\t// v1 → v2: ensure deploymentType field exists (defaulting to \"docker\")\n\t1: (input) => ({\n\t\t...input,\n\t\tconfigVersion: 2,\n\t\tdeploymentType: (input.deploymentType as string) ?? \"docker\",\n\t}),\n};\n\n/**\n * Applies sequential migrations to bring a config from its current version\n * to CURRENT_CONFIG_VERSION. Returns the config unchanged if already current.\n */\nexport function migrateConfig(input: Record<string, unknown>): Record<string, unknown> {\n\tlet version = (input.configVersion as number) ?? 1;\n\n\tif (version > CURRENT_CONFIG_VERSION) {\n\t\tthrow new Error(`No migration path from config version ${version}`);\n\t}\n\n\tlet current = { ...input };\n\n\twhile (version < CURRENT_CONFIG_VERSION) {\n\t\tconst migrationFn = migrations[version];\n\t\tif (!migrationFn) {\n\t\t\tthrow new Error(`No migration path from config version ${version}`);\n\t\t}\n\t\tcurrent = migrationFn(current);\n\t\tversion++;\n\t}\n\n\treturn current;\n}\n\n/**\n * Returns true if the config needs migration to the current version.\n */\nexport function needsMigration(input: Record<string, unknown>): boolean {\n\tconst version = (input.configVersion as number) ?? 1;\n\treturn version < CURRENT_CONFIG_VERSION;\n}\n"],"mappings":";;AAAA,MAAa,yBAAyB;AAItC,MAAM,aAA0C,EAE/C,IAAI,WAAW;CACd,GAAG;CACH,eAAe;CACf,gBAAiB,MAAM,kBAA6B;CACpD,GACD;;;;;AAMD,SAAgB,cAAc,OAAyD;CACtF,IAAI,UAAW,MAAM,iBAA4B;AAEjD,KAAI,UAAA,EACH,OAAM,IAAI,MAAM,yCAAyC,UAAU;CAGpE,IAAI,UAAU,EAAE,GAAG,OAAO;AAE1B,QAAO,UAAA,GAAkC;EACxC,MAAM,cAAc,WAAW;AAC/B,MAAI,CAAC,YACJ,OAAM,IAAI,MAAM,yCAAyC,UAAU;AAEpE,YAAU,YAAY,QAAQ;AAC9B;;AAGD,QAAO;;;;;AAMR,SAAgB,eAAe,OAAyC;AAEvE,SADiB,MAAM,iBAA4B,KAAA"}
+{"version":3,"file":"migrations.cjs","names":[],"sources":["../src/migrations.ts"],"sourcesContent":["export const CURRENT_CONFIG_VERSION = 3;\n\ntype MigrationFn = (input: Record<string, unknown>) => Record<string, unknown>;\n\nconst migrations: Record<number, MigrationFn> = {\n\t// v1 → v2: ensure deploymentType field exists (defaulting to \"docker\")\n\t1: (input) => ({\n\t\t...input,\n\t\tconfigVersion: 2,\n\t\tdeploymentType: (input.deploymentType as string) ?? \"docker\",\n\t}),\n\t// v2 → v3: add primaryFramework (defaults to \"openclaw\" for existing configs)\n\t2: (input) => ({\n\t\t...input,\n\t\tconfigVersion: 3,\n\t\tprimaryFramework: (input.primaryFramework as string) ?? \"openclaw\",\n\t\tcompanionFrameworks: (input.companionFrameworks as string[]) ?? [],\n\t}),\n};\n\n/**\n * Applies sequential migrations to bring a config from its current version\n * to CURRENT_CONFIG_VERSION. Returns the config unchanged if already current.\n */\nexport function migrateConfig(input: Record<string, unknown>): Record<string, unknown> {\n\tlet version = (input.configVersion as number) ?? 1;\n\n\tif (version > CURRENT_CONFIG_VERSION) {\n\t\tthrow new Error(`No migration path from config version ${version}`);\n\t}\n\n\tlet current = { ...input };\n\n\twhile (version < CURRENT_CONFIG_VERSION) {\n\t\tconst migrationFn = migrations[version];\n\t\tif (!migrationFn) {\n\t\t\tthrow new Error(`No migration path from config version ${version}`);\n\t\t}\n\t\tcurrent = migrationFn(current);\n\t\tversion++;\n\t}\n\n\treturn current;\n}\n\n/**\n * Returns true if the config needs migration to the current version.\n */\nexport function needsMigration(input: Record<string, unknown>): boolean {\n\tconst version = (input.configVersion as number) ?? 1;\n\treturn version < CURRENT_CONFIG_VERSION;\n}\n"],"mappings":";;AAAA,MAAa,yBAAyB;AAItC,MAAM,aAA0C;CAE/C,IAAI,WAAW;EACd,GAAG;EACH,eAAe;EACf,gBAAiB,MAAM,kBAA6B;EACpD;CAED,IAAI,WAAW;EACd,GAAG;EACH,eAAe;EACf,kBAAmB,MAAM,oBAA+B;EACxD,qBAAsB,MAAM,uBAAoC,EAAE;EAClE;CACD;;;;;AAMD,SAAgB,cAAc,OAAyD;CACtF,IAAI,UAAW,MAAM,iBAA4B;AAEjD,KAAI,UAAA,EACH,OAAM,IAAI,MAAM,yCAAyC,UAAU;CAGpE,IAAI,UAAU,EAAE,GAAG,OAAO;AAE1B,QAAO,UAAA,GAAkC;EACxC,MAAM,cAAc,WAAW;AAC/B,MAAI,CAAC,YACJ,OAAM,IAAI,MAAM,yCAAyC,UAAU;AAEpE,YAAU,YAAY,QAAQ;AAC9B;;AAGD,QAAO;;;;;AAMR,SAAgB,eAAe,OAAyC;AAEvE,SADiB,MAAM,iBAA4B,KAAA"}

package/dist/migrations.d.cts

@@ -1,5 +1,5 @@
 //#region src/migrations.d.ts
-declare const CURRENT_CONFIG_VERSION = 2;
+declare const CURRENT_CONFIG_VERSION = 3;
 /**
  * Applies sequential migrations to bring a config from its current version
  * to CURRENT_CONFIG_VERSION. Returns the config unchanged if already current.

package/dist/migrations.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.cts","names":[],"sources":["../src/migrations.ts"],"mappings":";cAAa,sBAAA;AAAb;;;;AAAA,iBAiBgB,aAAA,CAAc,KAAA,EAAO,MAAA,oBAA0B,MAAA;AAA/D;;;AAAA,iBAwBgB,cAAA,CAAe,KAAA,EAAO,MAAA"}
+{"version":3,"file":"migrations.d.cts","names":[],"sources":["../src/migrations.ts"],"mappings":";cAAa,sBAAA;AAAb;;;;AAAA,iBAwBgB,aAAA,CAAc,KAAA,EAAO,MAAA,oBAA0B,MAAA;AAA/D;;;AAAA,iBAwBgB,cAAA,CAAe,KAAA,EAAO,MAAA"}

package/dist/migrations.d.mts

@@ -1,5 +1,5 @@
 //#region src/migrations.d.ts
-declare const CURRENT_CONFIG_VERSION = 2;
+declare const CURRENT_CONFIG_VERSION = 3;
 /**
  * Applies sequential migrations to bring a config from its current version
  * to CURRENT_CONFIG_VERSION. Returns the config unchanged if already current.

package/dist/migrations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.mts","names":[],"sources":["../src/migrations.ts"],"mappings":";cAAa,sBAAA;AAAb;;;;AAAA,iBAiBgB,aAAA,CAAc,KAAA,EAAO,MAAA,oBAA0B,MAAA;AAA/D;;;AAAA,iBAwBgB,cAAA,CAAe,KAAA,EAAO,MAAA"}
+{"version":3,"file":"migrations.d.mts","names":[],"sources":["../src/migrations.ts"],"mappings":";cAAa,sBAAA;AAAb;;;;AAAA,iBAwBgB,aAAA,CAAc,KAAA,EAAO,MAAA,oBAA0B,MAAA;AAA/D;;;AAAA,iBAwBgB,cAAA,CAAe,KAAA,EAAO,MAAA"}