import { isPlainObject, resolveUserPath } from "../utils.js"; import type { OpenClawConfig } from "./types.js"; const PATH_VALUE_RE = /^~(?=$|[\\/])/; const PATH_KEY_RE = /(dir|path|paths|file|root|workspace)$/i; const PATH_LIST_KEYS = new Set(["paths", "pathPrepend"]); function normalizeStringValue(key: string | undefined, value: string): string { if (!PATH_VALUE_RE.test(value.trim())) { return value; } if (!key) { return value; } if (PATH_KEY_RE.test(key) || PATH_LIST_KEYS.has(key)) { return resolveUserPath(value); } return value; } function normalizeAny(key: string | undefined, value: unknown): unknown { if (typeof value === "string") { return normalizeStringValue(key, value); } if (Array.isArray(value)) { const normalizeChildren = Boolean(key && PATH_LIST_KEYS.has(key)); return value.map((entry) => { if (typeof entry === "string") { return normalizeChildren ? normalizeStringValue(key, entry) : entry; } if (Array.isArray(entry)) { return normalizeAny(undefined, entry); } if (isPlainObject(entry)) { return normalizeAny(undefined, entry); } return entry; }); } if (!isPlainObject(value)) { return value; } for (const [childKey, childValue] of Object.entries(value)) { const next = normalizeAny(childKey, childValue); if (next !== childValue) { value[childKey] = next; } } return value; } /** * Normalize "~" paths in path-ish config fields. * * Goal: accept `~/...` consistently across config file + env overrides, while * keeping the surface area small and predictable. */ export function normalizeConfigPaths(cfg: OpenClawConfig): OpenClawConfig { if (!cfg || typeof cfg !== "object") { return cfg; } normalizeAny(undefined, cfg); return cfg; }