activeclaw 2026.2.11 → 2026.2.13

package/dist/utils-dp_OM900.js

@@ -1,476 +0,0 @@
-import { a as resolveOAuthDir, c as expandHomePrefix, l as resolveEffectiveHomeDir, n as resolveConfigPath, u as resolveRequiredHomeDir } from "./paths-BZtyHNCi.js";
-import { createRequire } from "node:module";
-import os from "node:os";
-import path from "node:path";
-import fs from "node:fs";
-import { Logger } from "tslog";
-import JSON5 from "json5";
-import chalk, { Chalk } from "chalk";
-
-//#region src/logging/config.ts
-function readLoggingConfig() {
-	const configPath = resolveConfigPath();
-	try {
-		if (!fs.existsSync(configPath)) return;
-		const raw = fs.readFileSync(configPath, "utf-8");
-		const logging = JSON5.parse(raw)?.logging;
-		if (!logging || typeof logging !== "object" || Array.isArray(logging)) return;
-		return logging;
-	} catch {
-		return;
-	}
-}
-
-//#endregion
-//#region src/logging/levels.ts
-const ALLOWED_LOG_LEVELS = [
-	"silent",
-	"fatal",
-	"error",
-	"warn",
-	"info",
-	"debug",
-	"trace"
-];
-function normalizeLogLevel(level, fallback = "info") {
-	const candidate = (level ?? fallback).trim();
-	return ALLOWED_LOG_LEVELS.includes(candidate) ? candidate : fallback;
-}
-function levelToMinLevel(level) {
-	return {
-		fatal: 0,
-		error: 1,
-		warn: 2,
-		info: 3,
-		debug: 4,
-		trace: 5,
-		silent: Number.POSITIVE_INFINITY
-	}[level];
-}
-
-//#endregion
-//#region src/logging/state.ts
-const loggingState = {
-	cachedLogger: null,
-	cachedSettings: null,
-	cachedConsoleSettings: null,
-	overrideSettings: null,
-	consolePatched: false,
-	forceConsoleToStderr: false,
-	consoleTimestampPrefix: false,
-	consoleSubsystemFilter: null,
-	resolvingConsoleSettings: false,
-	rawConsole: null
-};
-
-//#endregion
-//#region src/logging/logger.ts
-const DEFAULT_LOG_DIR = "/tmp/openclaw";
-const DEFAULT_LOG_FILE = path.join(DEFAULT_LOG_DIR, "openclaw.log");
-const LOG_PREFIX = "openclaw";
-const LOG_SUFFIX = ".log";
-const MAX_LOG_AGE_MS = 1440 * 60 * 1e3;
-const requireConfig = createRequire(import.meta.url);
-const externalTransports = /* @__PURE__ */ new Set();
-function attachExternalTransport(logger, transport) {
-	logger.attachTransport((logObj) => {
-		if (!externalTransports.has(transport)) return;
-		try {
-			transport(logObj);
-		} catch {}
-	});
-}
-function resolveSettings() {
-	let cfg = loggingState.overrideSettings ?? readLoggingConfig();
-	if (!cfg) try {
-		cfg = requireConfig("../config/config.js").loadConfig?.().logging;
-	} catch {
-		cfg = void 0;
-	}
-	return {
-		level: normalizeLogLevel(cfg?.level, "info"),
-		file: cfg?.file ?? defaultRollingPathForToday()
-	};
-}
-function settingsChanged(a, b) {
-	if (!a) return true;
-	return a.level !== b.level || a.file !== b.file;
-}
-function isFileLogLevelEnabled(level) {
-	const settings = loggingState.cachedSettings ?? resolveSettings();
-	if (!loggingState.cachedSettings) loggingState.cachedSettings = settings;
-	if (settings.level === "silent") return false;
-	return levelToMinLevel(level) <= levelToMinLevel(settings.level);
-}
-function buildLogger(settings) {
-	fs.mkdirSync(path.dirname(settings.file), { recursive: true });
-	if (isRollingPath(settings.file)) pruneOldRollingLogs(path.dirname(settings.file));
-	const logger = new Logger({
-		name: "openclaw",
-		minLevel: levelToMinLevel(settings.level),
-		type: "hidden"
-	});
-	logger.attachTransport((logObj) => {
-		try {
-			const time = logObj.date?.toISOString?.() ?? (/* @__PURE__ */ new Date()).toISOString();
-			const line = JSON.stringify({
-				...logObj,
-				time
-			});
-			fs.appendFileSync(settings.file, `${line}\n`, { encoding: "utf8" });
-		} catch {}
-	});
-	for (const transport of externalTransports) attachExternalTransport(logger, transport);
-	return logger;
-}
-function getLogger() {
-	const settings = resolveSettings();
-	const cachedLogger = loggingState.cachedLogger;
-	const cachedSettings = loggingState.cachedSettings;
-	if (!cachedLogger || settingsChanged(cachedSettings, settings)) {
-		loggingState.cachedLogger = buildLogger(settings);
-		loggingState.cachedSettings = settings;
-	}
-	return loggingState.cachedLogger;
-}
-function getChildLogger(bindings, opts) {
-	const base = getLogger();
-	const minLevel = opts?.level ? levelToMinLevel(opts.level) : void 0;
-	const name = bindings ? JSON.stringify(bindings) : void 0;
-	return base.getSubLogger({
-		name,
-		minLevel,
-		prefix: bindings ? [name ?? ""] : []
-	});
-}
-function toPinoLikeLogger(logger, level) {
-	const buildChild = (bindings) => toPinoLikeLogger(logger.getSubLogger({ name: bindings ? JSON.stringify(bindings) : void 0 }), level);
-	return {
-		level,
-		child: buildChild,
-		trace: (...args) => logger.trace(...args),
-		debug: (...args) => logger.debug(...args),
-		info: (...args) => logger.info(...args),
-		warn: (...args) => logger.warn(...args),
-		error: (...args) => logger.error(...args),
-		fatal: (...args) => logger.fatal(...args)
-	};
-}
-function formatLocalDate(date) {
-	return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
-}
-function defaultRollingPathForToday() {
-	const today = formatLocalDate(/* @__PURE__ */ new Date());
-	return path.join(DEFAULT_LOG_DIR, `${LOG_PREFIX}-${today}${LOG_SUFFIX}`);
-}
-function isRollingPath(file) {
-	const base = path.basename(file);
-	return base.startsWith(`${LOG_PREFIX}-`) && base.endsWith(LOG_SUFFIX) && base.length === `${LOG_PREFIX}-YYYY-MM-DD${LOG_SUFFIX}`.length;
-}
-function pruneOldRollingLogs(dir) {
-	try {
-		const entries = fs.readdirSync(dir, { withFileTypes: true });
-		const cutoff = Date.now() - MAX_LOG_AGE_MS;
-		for (const entry of entries) {
-			if (!entry.isFile()) continue;
-			if (!entry.name.startsWith(`${LOG_PREFIX}-`) || !entry.name.endsWith(LOG_SUFFIX)) continue;
-			const fullPath = path.join(dir, entry.name);
-			try {
-				if (fs.statSync(fullPath).mtimeMs < cutoff) fs.rmSync(fullPath, { force: true });
-			} catch {}
-		}
-	} catch {}
-}
-
-//#endregion
-//#region src/terminal/palette.ts
-const LOBSTER_PALETTE = {
-	accent: "#FF5A2D",
-	accentBright: "#FF7A3D",
-	accentDim: "#D14A22",
-	info: "#FF8A5B",
-	success: "#2FBF71",
-	warn: "#FFB020",
-	error: "#E23D2D",
-	muted: "#8B7F77"
-};
-
-//#endregion
-//#region src/terminal/theme.ts
-const hasForceColor = typeof process.env.FORCE_COLOR === "string" && process.env.FORCE_COLOR.trim().length > 0 && process.env.FORCE_COLOR.trim() !== "0";
-const baseChalk = process.env.NO_COLOR && !hasForceColor ? new Chalk({ level: 0 }) : chalk;
-const hex = (value) => baseChalk.hex(value);
-const theme = {
-	accent: hex(LOBSTER_PALETTE.accent),
-	accentBright: hex(LOBSTER_PALETTE.accentBright),
-	accentDim: hex(LOBSTER_PALETTE.accentDim),
-	info: hex(LOBSTER_PALETTE.info),
-	success: hex(LOBSTER_PALETTE.success),
-	warn: hex(LOBSTER_PALETTE.warn),
-	error: hex(LOBSTER_PALETTE.error),
-	muted: hex(LOBSTER_PALETTE.muted),
-	heading: baseChalk.bold.hex(LOBSTER_PALETTE.accent),
-	command: hex(LOBSTER_PALETTE.accentBright),
-	option: hex(LOBSTER_PALETTE.warn)
-};
-const isRich = () => Boolean(baseChalk.level > 0);
-const colorize = (rich, color, value) => rich ? color(value) : value;
-
-//#endregion
-//#region src/globals.ts
-let globalVerbose = false;
-function setVerbose(v) {
-	globalVerbose = v;
-}
-function isVerbose() {
-	return globalVerbose;
-}
-function shouldLogVerbose() {
-	return globalVerbose || isFileLogLevelEnabled("debug");
-}
-function logVerbose(message) {
-	if (!shouldLogVerbose()) return;
-	try {
-		getLogger().debug({ message }, "verbose");
-	} catch {}
-	if (!globalVerbose) return;
-	console.log(theme.muted(message));
-}
-function logVerboseConsole(message) {
-	if (!globalVerbose) return;
-	console.log(theme.muted(message));
-}
-const success = theme.success;
-const warn = theme.warn;
-const info = theme.info;
-const danger = theme.error;
-
-//#endregion
-//#region src/utils.ts
-async function ensureDir(dir) {
-	await fs.promises.mkdir(dir, { recursive: true });
-}
-/**
-* Check if a file or directory exists at the given path.
-*/
-async function pathExists(targetPath) {
-	try {
-		await fs.promises.access(targetPath);
-		return true;
-	} catch {
-		return false;
-	}
-}
-function clampNumber(value, min, max) {
-	return Math.max(min, Math.min(max, value));
-}
-function clampInt(value, min, max) {
-	return clampNumber(Math.floor(value), min, max);
-}
-/** Alias for clampNumber (shorter, more common name) */
-const clamp = clampNumber;
-/**
-* Escapes special regex characters in a string so it can be used in a RegExp constructor.
-*/
-function escapeRegExp(value) {
-	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
-* Safely parse JSON, returning null on error instead of throwing.
-*/
-function safeParseJson(raw) {
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-/**
-* Type guard for plain objects (not arrays, null, Date, RegExp, etc.).
-* Uses Object.prototype.toString for maximum safety.
-*/
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value) && Object.prototype.toString.call(value) === "[object Object]";
-}
-/**
-* Type guard for Record<string, unknown> (less strict than isPlainObject).
-* Accepts any non-null object that isn't an array.
-*/
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function normalizeE164(number) {
-	const digits = number.replace(/^whatsapp:/, "").trim().replace(/[^\d+]/g, "");
-	if (digits.startsWith("+")) return `+${digits.slice(1)}`;
-	return `+${digits}`;
-}
-/**
-* "Self-chat mode" heuristic (single phone): the gateway is logged in as the owner's own WhatsApp account,
-* and `channels.whatsapp.allowFrom` includes that same number. Used to avoid side-effects that make no sense when the
-* "bot" and the human are the same WhatsApp identity (e.g. auto read receipts, @mention JID triggers).
-*/
-function isSelfChatMode(selfE164, allowFrom) {
-	if (!selfE164) return false;
-	if (!Array.isArray(allowFrom) || allowFrom.length === 0) return false;
-	const normalizedSelf = normalizeE164(selfE164);
-	return allowFrom.some((n) => {
-		if (n === "*") return false;
-		try {
-			return normalizeE164(String(n)) === normalizedSelf;
-		} catch {
-			return false;
-		}
-	});
-}
-function toWhatsappJid(number) {
-	const withoutPrefix = number.replace(/^whatsapp:/, "").trim();
-	if (withoutPrefix.includes("@")) return withoutPrefix;
-	return `${normalizeE164(withoutPrefix).replace(/\D/g, "")}@s.whatsapp.net`;
-}
-function resolveLidMappingDirs(opts) {
-	const dirs = /* @__PURE__ */ new Set();
-	const addDir = (dir) => {
-		if (!dir) return;
-		dirs.add(resolveUserPath(dir));
-	};
-	addDir(opts?.authDir);
-	for (const dir of opts?.lidMappingDirs ?? []) addDir(dir);
-	addDir(resolveOAuthDir());
-	addDir(path.join(CONFIG_DIR, "credentials"));
-	return [...dirs];
-}
-function readLidReverseMapping(lid, opts) {
-	const mappingFilename = `lid-mapping-${lid}_reverse.json`;
-	const mappingDirs = resolveLidMappingDirs(opts);
-	for (const dir of mappingDirs) {
-		const mappingPath = path.join(dir, mappingFilename);
-		try {
-			const data = fs.readFileSync(mappingPath, "utf8");
-			const phone = JSON.parse(data);
-			if (phone === null || phone === void 0) continue;
-			return normalizeE164(String(phone));
-		} catch {}
-	}
-	return null;
-}
-function jidToE164(jid, opts) {
-	const match = jid.match(/^(\d+)(?::\d+)?@(s\.whatsapp\.net|hosted)$/);
-	if (match) return `+${match[1]}`;
-	const lidMatch = jid.match(/^(\d+)(?::\d+)?@(lid|hosted\.lid)$/);
-	if (lidMatch) {
-		const lid = lidMatch[1];
-		const phone = readLidReverseMapping(lid, opts);
-		if (phone) return phone;
-		if (opts?.logMissing ?? shouldLogVerbose()) logVerbose(`LID mapping not found for ${lid}; skipping inbound message`);
-	}
-	return null;
-}
-async function resolveJidToE164(jid, opts) {
-	if (!jid) return null;
-	const direct = jidToE164(jid, opts);
-	if (direct) return direct;
-	if (!/(@lid|@hosted\.lid)$/.test(jid)) return null;
-	if (!opts?.lidLookup?.getPNForLID) return null;
-	try {
-		const pnJid = await opts.lidLookup.getPNForLID(jid);
-		if (!pnJid) return null;
-		return jidToE164(pnJid, opts);
-	} catch (err) {
-		if (shouldLogVerbose()) logVerbose(`LID mapping lookup failed for ${jid}: ${String(err)}`);
-		return null;
-	}
-}
-function sleep(ms) {
-	return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function isHighSurrogate(codeUnit) {
-	return codeUnit >= 55296 && codeUnit <= 56319;
-}
-function isLowSurrogate(codeUnit) {
-	return codeUnit >= 56320 && codeUnit <= 57343;
-}
-function sliceUtf16Safe(input, start, end) {
-	const len = input.length;
-	let from = start < 0 ? Math.max(len + start, 0) : Math.min(start, len);
-	let to = end === void 0 ? len : end < 0 ? Math.max(len + end, 0) : Math.min(end, len);
-	if (to < from) {
-		const tmp = from;
-		from = to;
-		to = tmp;
-	}
-	if (from > 0 && from < len) {
-		if (isLowSurrogate(input.charCodeAt(from)) && isHighSurrogate(input.charCodeAt(from - 1))) from += 1;
-	}
-	if (to > 0 && to < len) {
-		if (isHighSurrogate(input.charCodeAt(to - 1)) && isLowSurrogate(input.charCodeAt(to))) to -= 1;
-	}
-	return input.slice(from, to);
-}
-function truncateUtf16Safe(input, maxLen) {
-	const limit = Math.max(0, Math.floor(maxLen));
-	if (input.length <= limit) return input;
-	return sliceUtf16Safe(input, 0, limit);
-}
-function resolveUserPath(input) {
-	const trimmed = input.trim();
-	if (!trimmed) return trimmed;
-	if (trimmed.startsWith("~")) {
-		const expanded = expandHomePrefix(trimmed, {
-			home: resolveRequiredHomeDir(process.env, os.homedir),
-			env: process.env,
-			homedir: os.homedir
-		});
-		return path.resolve(expanded);
-	}
-	return path.resolve(trimmed);
-}
-function resolveConfigDir(env = process.env, homedir = os.homedir) {
-	const override = env.OPENCLAW_STATE_DIR?.trim() || env.CLAWDBOT_STATE_DIR?.trim();
-	if (override) return resolveUserPath(override);
-	const newDir = path.join(resolveRequiredHomeDir(env, homedir), ".openclaw");
-	try {
-		if (fs.existsSync(newDir)) return newDir;
-	} catch {}
-	return newDir;
-}
-function resolveHomeDir() {
-	return resolveEffectiveHomeDir(process.env, os.homedir);
-}
-function resolveHomeDisplayPrefix() {
-	const home = resolveHomeDir();
-	if (!home) return;
-	if (process.env.OPENCLAW_HOME?.trim()) return {
-		home,
-		prefix: "$OPENCLAW_HOME"
-	};
-	return {
-		home,
-		prefix: "~"
-	};
-}
-function shortenHomePath(input) {
-	if (!input) return input;
-	const display = resolveHomeDisplayPrefix();
-	if (!display) return input;
-	const { home, prefix } = display;
-	if (input === home) return prefix;
-	if (input.startsWith(`${home}/`) || input.startsWith(`${home}\\`)) return `${prefix}${input.slice(home.length)}`;
-	return input;
-}
-function shortenHomeInString(input) {
-	if (!input) return input;
-	const display = resolveHomeDisplayPrefix();
-	if (!display) return input;
-	return input.split(display.home).join(display.prefix);
-}
-function formatTerminalLink(label, url, opts) {
-	const esc = "\x1B";
-	const safeLabel = label.replaceAll(esc, "");
-	const safeUrl = url.replaceAll(esc, "");
-	if (!(opts?.force === true ? true : opts?.force === false ? false : Boolean(process.stdout.isTTY))) return opts?.fallback ?? `${safeLabel} (${safeUrl})`;
-	return `\u001b]8;;${safeUrl}\u0007${safeLabel}\u001b]8;;\u0007`;
-}
-const CONFIG_DIR = resolveConfigDir();
-
-//#endregion
-export { shouldLogVerbose as A, levelToMinLevel as B, truncateUtf16Safe as C, logVerbose as D, isVerbose as E, theme as F, readLoggingConfig as H, getChildLogger as I, getLogger as L, warn as M, colorize as N, logVerboseConsole as O, isRich as P, toPinoLikeLogger as R, toWhatsappJid as S, info as T, normalizeLogLevel as V, safeParseJson as _, ensureDir as a, sleep as b, isPlainObject as c, jidToE164 as d, normalizeE164 as f, resolveUserPath as g, resolveJidToE164 as h, clampNumber as i, success as j, setVerbose as k, isRecord as l, resolveConfigDir as m, clamp as n, escapeRegExp as o, pathExists as p, clampInt as r, formatTerminalLink as s, CONFIG_DIR as t, isSelfChatMode as u, shortenHomeInString as v, danger as w, sliceUtf16Safe as x, shortenHomePath as y, loggingState as z };

package/docs/hooks/soul-evil.md

@@ -1,69 +0,0 @@
----
-summary: "SOUL Evil hook (swap SOUL.md with SOUL_EVIL.md)"
-read_when:
-  - You want to enable or tune the SOUL Evil hook
-  - You want a purge window or random-chance persona swap
-title: "SOUL Evil Hook"
----
-
-# SOUL Evil Hook
-
-The SOUL Evil hook swaps the **injected** `SOUL.md` content with `SOUL_EVIL.md` during
-a purge window or by random chance. It does **not** modify files on disk.
-
-## How It Works
-
-When `agent:bootstrap` runs, the hook can replace the `SOUL.md` content in memory
-before the system prompt is assembled. If `SOUL_EVIL.md` is missing or empty,
-OpenClaw logs a warning and keeps the normal `SOUL.md`.
-
-Sub-agent runs do **not** include `SOUL.md` in their bootstrap files, so this hook
-has no effect on sub-agents.
-
-## Enable
-
-```bash
-openclaw hooks enable soul-evil
-```
-
-Then set the config:
-
-```json
-{
-  "hooks": {
-    "internal": {
-      "enabled": true,
-      "entries": {
-        "soul-evil": {
-          "enabled": true,
-          "file": "SOUL_EVIL.md",
-          "chance": 0.1,
-          "purge": { "at": "21:00", "duration": "15m" }
-        }
-      }
-    }
-  }
-}
-```
-
-Create `SOUL_EVIL.md` in the agent workspace root (next to `SOUL.md`).
-
-## Options
-
-- `file` (string): alternate SOUL filename (default: `SOUL_EVIL.md`)
-- `chance` (number 0–1): random chance per run to use `SOUL_EVIL.md`
-- `purge.at` (HH:mm): daily purge start (24-hour clock)
-- `purge.duration` (duration): window length (e.g. `30s`, `10m`, `1h`)
-
-**Precedence:** purge window wins over chance.
-
-**Timezone:** uses `agents.defaults.userTimezone` when set; otherwise host timezone.
-
-## Notes
-
-- No files are written or modified on disk.
-- If `SOUL.md` is not in the bootstrap list, the hook does nothing.
-
-## See Also
-
-- [Hooks](/automation/hooks)

package/docs/zh-CN/hooks/soul-evil.md

@@ -1,72 +0,0 @@
----
-read_when:
-  - 你想要启用或调整 SOUL Evil 钩子
-  - 你想要设置清除窗口或随机概率的人格替换
-summary: SOUL Evil 钩子（将 SOUL.md 替换为 SOUL_EVIL.md）
-title: SOUL Evil 钩子
-x-i18n:
-  generated_at: "2026-02-01T20:42:18Z"
-  model: claude-opus-4-5
-  provider: pi
-  source_hash: cc32c1e207f2b6923a6ede8299293f8fc07f3c8d6b2a377775237c0173fe8d1b
-  source_path: hooks/soul-evil.md
-  workflow: 14
----
-
-# SOUL Evil 钩子
-
-SOUL Evil 钩子在清除窗口期间或随机概率下，将**注入的** `SOUL.md` 内容替换为 `SOUL_EVIL.md`。它**不会**修改磁盘上的文件。
-
-## 工作原理
-
-当 `agent:bootstrap` 运行时，该钩子可以在系统提示词组装之前，在内存中替换 `SOUL.md` 的内容。如果 `SOUL_EVIL.md` 缺失或为空，OpenClaw 会记录警告并保留正常的 `SOUL.md`。
-
-子智能体运行**不会**在其引导文件中包含 `SOUL.md`，因此此钩子对子智能体没有影响。
-
-## 启用
-
-```bash
-openclaw hooks enable soul-evil
-```
-
-然后设置配置：
-
-```json
-{
-  "hooks": {
-    "internal": {
-      "enabled": true,
-      "entries": {
-        "soul-evil": {
-          "enabled": true,
-          "file": "SOUL_EVIL.md",
-          "chance": 0.1,
-          "purge": { "at": "21:00", "duration": "15m" }
-        }
-      }
-    }
-  }
-}
-```
-
-在智能体工作区根目录（`SOUL.md` 旁边）创建 `SOUL_EVIL.md`。
-
-## 选项
-
-- `file`（字符串）：替代的 SOUL 文件名（默认：`SOUL_EVIL.md`）
-- `chance`（数字 0–1）：每次运行使用 `SOUL_EVIL.md` 的随机概率
-- `purge.at`（HH:mm）：每日清除开始时间（24 小时制）
-- `purge.duration`（时长）：窗口长度（例如 `30s`、`10m`、`1h`）
-
-**优先级：** 清除窗口优先于随机概率。
-
-**时区：** 设置了 `agents.defaults.userTimezone` 时使用该时区；否则使用主机时区。
-
-## 注意事项
-
-- 不会在磁盘上写入或修改任何文件。
-- 如果 `SOUL.md` 不在引导列表中，该钩子不执行任何操作。
-
-## 另请参阅
-
-- [钩子](/automation/hooks)