@better-openclaw/core 1.0.26 → 1.0.30

package/dist/logger/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/logger/logger.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n\tLogLevel,\n\tLogSink,\n\tLogSource,\n\tOperationCategory,\n\tOperationOutcome,\n\tOperationStep,\n\tOperationsLogEntry,\n\tOperationsLoggerOptions,\n} from \"./types.js\";\n\n/** Keys that must never appear in logged context. */\nconst SENSITIVE_KEYS = new Set([\n\t\"apikey\",\n\t\"api_key\",\n\t\"password\",\n\t\"token\",\n\t\"secret\",\n\t\"authorization\",\n\t\"credentials\",\n\t\"private_key\",\n\t\"privatekey\",\n]);\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n\tdebug: 0,\n\tinfo: 1,\n\twarn: 2,\n\terror: 3,\n};\n\n/** Strip sensitive keys from a context object (shallow). */\nfunction sanitizeContext(\n\tctx: Record<string, unknown> | undefined,\n): Record<string, unknown> | undefined {\n\tif (!ctx) return ctx;\n\tconst clean: Record<string, unknown> = {};\n\tfor (const [key, value] of Object.entries(ctx)) {\n\t\tif (SENSITIVE_KEYS.has(key.toLowerCase())) {\n\t\t\tclean[key] = \"[REDACTED]\";\n\t\t} else {\n\t\t\tclean[key] = value;\n\t\t}\n\t}\n\treturn clean;\n}\n\n/**\n * Tracks individual steps within a multi-step operation (e.g. deploy, generate).\n */\nexport class StepTracker {\n\tprivate steps: OperationStep[] = [];\n\tprivate currentStep: OperationStep | null = null;\n\tprivate readonly operationStart = Date.now();\n\n\tconstructor(\n\t\tprivate readonly logger: OperationsLogger,\n\t\tprivate readonly category: OperationCategory,\n\t\tprivate readonly operationName: string,\n\t) {}\n\n\t/** Start a new step. Automatically completes the previous step if still open. */\n\tbegin(name: string, detail?: string): void {\n\t\tif (this.currentStep && this.currentStep.status === \"in_progress\") {\n\t\t\tthis.currentStep.status = \"success\";\n\t\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\t}\n\t\tthis.currentStep = {\n\t\t\tname,\n\t\t\tstatus: \"in_progress\",\n\t\t\tdetail,\n\t\t\tstartedAt: new Date().toISOString(),\n\t\t};\n\t\tthis.steps.push(this.currentStep);\n\t\tthis.logger.debug(this.category, `[${this.operationName}] ${name}`, {\n\t\t\tstep: name,\n\t\t\tdetail,\n\t\t});\n\t}\n\n\t/** Mark the current step as completed. */\n\tcomplete(detail?: string): void {\n\t\tif (!this.currentStep) return;\n\t\tthis.currentStep.status = \"success\";\n\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\tif (detail) this.currentStep.detail = detail;\n\t}\n\n\t/** Mark the current step as failed. */\n\tfail(error: string): void {\n\t\tif (!this.currentStep) return;\n\t\tthis.currentStep.status = \"failure\";\n\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\tthis.currentStep.detail = error;\n\t}\n\n\t/** Record a skipped step. */\n\tskip(name: string, reason?: string): void {\n\t\tthis.steps.push({\n\t\t\tname,\n\t\t\tstatus: \"skipped\",\n\t\t\tdetail: reason,\n\t\t\tstartedAt: new Date().toISOString(),\n\t\t\tcompletedAt: new Date().toISOString(),\n\t\t\tdurationMs: 0,\n\t\t});\n\t}\n\n\t/** Finalize and log the full operation summary. Returns all steps. */\n\tfinalize(outcome: OperationOutcome): OperationStep[] {\n\t\t// Close any open step\n\t\tif (this.currentStep && this.currentStep.status === \"in_progress\") {\n\t\t\tthis.currentStep.status = outcome === \"failure\" ? \"failure\" : \"success\";\n\t\t\tthis.currentStep.completedAt = new Date().toISOString();\n\t\t\tthis.currentStep.durationMs = Date.now() - new Date(this.currentStep.startedAt).getTime();\n\t\t}\n\n\t\tthis.logger.log({\n\t\t\tlevel: outcome === \"failure\" ? \"error\" : \"info\",\n\t\t\tcategory: this.category,\n\t\t\tmessage: `${this.operationName} ${outcome}`,\n\t\t\toutcome,\n\t\t\tdurationMs: Date.now() - this.operationStart,\n\t\t\tsteps: this.steps,\n\t\t});\n\t\treturn this.steps;\n\t}\n\n\t/** Get the current list of steps (snapshot). */\n\tgetSteps(): OperationStep[] {\n\t\treturn [...this.steps];\n\t}\n}\n\n/**\n * Centralized operations logger.\n *\n * Follows fire-and-forget semantics — sink errors are silently caught and\n * logging never blocks or crashes the main flow.\n */\nexport class OperationsLogger {\n\tprivate readonly source: LogSource;\n\tprivate readonly sinks: LogSink[];\n\tprivate readonly correlationId: string;\n\tprivate readonly sessionId: string;\n\tprivate readonly minLevel: LogLevel;\n\n\tconstructor(options: OperationsLoggerOptions) {\n\t\tthis.source = options.source;\n\t\tthis.sinks = options.sinks ?? [];\n\t\tthis.correlationId = options.correlationId ?? randomUUID();\n\t\tthis.sessionId = options.sessionId ?? randomUUID();\n\t\tthis.minLevel = options.minLevel ?? \"info\";\n\t}\n\n\t/** Create a child logger that inherits correlation/session but can override source or sinks. */\n\tchild(overrides: Partial<OperationsLoggerOptions>): OperationsLogger {\n\t\treturn new OperationsLogger({\n\t\t\tsource: overrides.source ?? this.source,\n\t\t\tsinks: overrides.sinks ?? this.sinks,\n\t\t\tcorrelationId: overrides.correlationId ?? this.correlationId,\n\t\t\tsessionId: overrides.sessionId ?? this.sessionId,\n\t\t\tminLevel: overrides.minLevel ?? this.minLevel,\n\t\t});\n\t}\n\n\t/** Log an operation with full context. Fire-and-forget to all sinks. */\n\tlog(\n\t\tentry: Omit<OperationsLogEntry, \"id\" | \"timestamp\" | \"source\" | \"correlationId\" | \"sessionId\">,\n\t): void {\n\t\tif (!this.shouldLog(entry.level)) return;\n\n\t\tconst full: OperationsLogEntry = {\n\t\t\tid: randomUUID(),\n\t\t\ttimestamp: new Date().toISOString(),\n\t\t\tsource: this.source,\n\t\t\tcorrelationId: this.correlationId,\n\t\t\tsessionId: this.sessionId,\n\t\t\t...entry,\n\t\t\tcontext: sanitizeContext(entry.context),\n\t\t};\n\n\t\tfor (const sink of this.sinks) {\n\t\t\ttry {\n\t\t\t\tconst result = sink.write(full);\n\t\t\t\tif (result instanceof Promise) {\n\t\t\t\t\tresult.catch(() => {});\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Sink failures must never crash the main flow\n\t\t\t}\n\t\t}\n\t}\n\n\tinfo(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"info\", category, message, context });\n\t}\n\n\twarn(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"warn\", category, message, context });\n\t}\n\n\terror(\n\t\tcategory: OperationCategory,\n\t\tmessage: string,\n\t\terr?: Error | null,\n\t\tcontext?: Record<string, unknown>,\n\t): void {\n\t\tthis.log({\n\t\t\tlevel: \"error\",\n\t\t\tcategory,\n\t\t\tmessage,\n\t\t\tcontext,\n\t\t\terror: err\n\t\t\t\t? {\n\t\t\t\t\t\tname: err.name,\n\t\t\t\t\t\tmessage: err.message,\n\t\t\t\t\t\tstack: err.stack,\n\t\t\t\t\t\tcode: (err as { code?: string }).code,\n\t\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t});\n\t}\n\n\tdebug(category: OperationCategory, message: string, context?: Record<string, unknown>): void {\n\t\tthis.log({ level: \"debug\", category, message, context });\n\t}\n\n\t/**\n\t * Log a timed operation. Wraps an async/sync function with start/end/duration logging.\n\t * Re-throws the original error on failure.\n\t */\n\tasync timed<T>(\n\t\tcategory: OperationCategory,\n\t\tmessage: string,\n\t\tfn: () => T | Promise<T>,\n\t\tcontext?: Record<string, unknown>,\n\t): Promise<T> {\n\t\tconst start = Date.now();\n\t\tthis.log({\n\t\t\tlevel: \"info\",\n\t\t\tcategory,\n\t\t\tmessage,\n\t\t\toutcome: \"in_progress\",\n\t\t\tcontext,\n\t\t});\n\t\ttry {\n\t\t\tconst result = await fn();\n\t\t\tthis.log({\n\t\t\t\tlevel: \"info\",\n\t\t\t\tcategory,\n\t\t\t\tmessage,\n\t\t\t\toutcome: \"success\",\n\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\tcontext,\n\t\t\t});\n\t\t\treturn result;\n\t\t} catch (err) {\n\t\t\tthis.log({\n\t\t\t\tlevel: \"error\",\n\t\t\t\tcategory,\n\t\t\t\tmessage,\n\t\t\t\toutcome: \"failure\",\n\t\t\t\tdurationMs: Date.now() - start,\n\t\t\t\terror:\n\t\t\t\t\terr instanceof Error\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tname: err.name,\n\t\t\t\t\t\t\t\tmessage: err.message,\n\t\t\t\t\t\t\t\tstack: err.stack,\n\t\t\t\t\t\t\t\tcode: (err as { code?: string }).code,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: { name: \"UnknownError\", message: String(err) },\n\t\t\t\tcontext,\n\t\t\t});\n\t\t\tthrow err;\n\t\t}\n\t}\n\n\t/** Create a step tracker for multi-step operations (deploy, generate pipeline). */\n\tcreateStepTracker(category: OperationCategory, operationName: string): StepTracker {\n\t\treturn new StepTracker(this, category, operationName);\n\t}\n\n\t/** Flush all sinks. */\n\tasync flush(): Promise<void> {\n\t\tfor (const sink of this.sinks) {\n\t\t\tif (sink.flush) {\n\t\t\t\ttry {\n\t\t\t\t\tawait sink.flush();\n\t\t\t\t} catch {\n\t\t\t\t\t// Silent\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Destroy all sinks (cleanup timers, close streams). */\n\tasync destroy(): Promise<void> {\n\t\tfor (const sink of this.sinks) {\n\t\t\tif (sink.destroy) {\n\t\t\t\ttry {\n\t\t\t\t\tawait sink.destroy();\n\t\t\t\t} catch {\n\t\t\t\t\t// Silent\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\tgetCorrelationId(): string {\n\t\treturn this.correlationId;\n\t}\n\n\tgetSessionId(): string {\n\t\treturn this.sessionId;\n\t}\n\n\tprivate shouldLog(level: LogLevel): boolean {\n\t\treturn LEVEL_ORDER[level] >= LEVEL_ORDER[this.minLevel];\n\t}\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/logger/sinks/callback-sink.ts
+/**
+* Callback sink — delegates to a user-provided function.
+* Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.
+*/
+var CallbackSink = class {
+	constructor(onEntry) {
+		this.onEntry = onEntry;
+	}
+	write(entry) {
+		return this.onEntry(entry);
+	}
+};
+//#endregion
+exports.CallbackSink = CallbackSink;
+
+//# sourceMappingURL=callback-sink.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-sink.cjs","names":[],"sources":["../../../src/logger/sinks/callback-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Callback sink — delegates to a user-provided function.\n * Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.\n */\nexport class CallbackSink implements LogSink {\n\tconstructor(private readonly onEntry: (entry: OperationsLogEntry) => void | Promise<void>) {}\n\n\twrite(entry: OperationsLogEntry): void | Promise<void> {\n\t\treturn this.onEntry(entry);\n\t}\n}\n"],"mappings":";;;;;;AAMA,IAAa,eAAb,MAA6C;CAC5C,YAAY,SAA+E;AAA9D,OAAA,UAAA;;CAE7B,MAAM,OAAiD;AACtD,SAAO,KAAK,QAAQ,MAAM"}

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

@@ -0,0 +1,2 @@
+import { t as CallbackSink } from "../../callback-sink-iNThWRnQ.cjs";
+export { CallbackSink };

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

@@ -0,0 +1,2 @@
+import { t as CallbackSink } from "../../callback-sink-CdMKYayY.mjs";
+export { CallbackSink };

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

@@ -0,0 +1,17 @@
+//#region src/logger/sinks/callback-sink.ts
+/**
+* Callback sink — delegates to a user-provided function.
+* Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.
+*/
+var CallbackSink = class {
+	constructor(onEntry) {
+		this.onEntry = onEntry;
+	}
+	write(entry) {
+		return this.onEntry(entry);
+	}
+};
+//#endregion
+export { CallbackSink };
+
+//# sourceMappingURL=callback-sink.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callback-sink.mjs","names":[],"sources":["../../../src/logger/sinks/callback-sink.ts"],"sourcesContent":["import type { LogSink, OperationsLogEntry } from \"../types.js\";\n\n/**\n * Callback sink — delegates to a user-provided function.\n * Useful for tests, Sentry breadcrumbs, WebSocket streaming, etc.\n */\nexport class CallbackSink implements LogSink {\n\tconstructor(private readonly onEntry: (entry: OperationsLogEntry) => void | Promise<void>) {}\n\n\twrite(entry: OperationsLogEntry): void | Promise<void> {\n\t\treturn this.onEntry(entry);\n\t}\n}\n"],"mappings":";;;;;AAMA,IAAa,eAAb,MAA6C;CAC5C,YAAY,SAA+E;AAA9D,OAAA,UAAA;;CAE7B,MAAM,OAAiD;AACtD,SAAO,KAAK,QAAQ,MAAM"}

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"}