silentlake 2026.3.24

package/dist/docker-XFNiArwM.js

@@ -0,0 +1,1254 @@
+import { r as STATE_DIR } from "./paths-GHJ97ebE.js";
+import { n as defaultRuntime } from "./runtime-CT2LIJZu.js";
+import { t as createSubsystemLogger } from "./subsystem-CUp-6QQf.js";
+import { n as markOpenClawExecEnv } from "./openclaw-exec-env-AcZ9we1N.js";
+import { y as resolveUserPath } from "./utils-Bxk6BLTg.js";
+import { c as normalizeAgentId, u as resolveAgentIdFromSessionKey } from "./session-key-gFFk3uv9.js";
+import { i as resolvePathViaExistingAncestorSync } from "./boundary-path-B3FFLYNx.js";
+import { i as resolveAgentConfig } from "./agent-scope-DPP4Z_UU.js";
+import { l as normalizeSecretInputString } from "./types.secrets-BWSeXrF4.js";
+import { c as CHANNEL_IDS } from "./registry-rgYi7KoO.js";
+import { t as getBlockedNetworkModeReason } from "./network-mode-DOgvmom4.js";
+import { t as formatCliCommand } from "./command-format-CYK9XiUC.js";
+import { t as acquireSessionWriteLock } from "./session-write-lock-DNKvpjKf.js";
+import { r as writeJsonAtomic } from "./json-files-WW-H_psG.js";
+import { a as resolveCoreToolProfilePolicy, t as CORE_TOOL_GROUPS } from "./tool-catalog-BV6FcEWS.js";
+import { t as sanitizeEnvVars } from "./sanitize-env-vars-vNSNqm0y.js";
+import { i as resolveWindowsSpawnProgram, n as materializeWindowsSpawnProgram } from "./windows-spawn-vMJGZo89.js";
+import path, { posix } from "node:path";
+import { spawn } from "node:child_process";
+import fs from "node:fs/promises";
+import crypto from "node:crypto";
+//#region src/agents/tool-policy-shared.ts
+const TOOL_NAME_ALIASES = {
+	bash: "exec",
+	"apply-patch": "apply_patch"
+};
+const TOOL_GROUPS = { ...CORE_TOOL_GROUPS };
+function normalizeToolName(name) {
+	const normalized = name.trim().toLowerCase();
+	return TOOL_NAME_ALIASES[normalized] ?? normalized;
+}
+function normalizeToolList(list) {
+	if (!list) return [];
+	return list.map(normalizeToolName).filter(Boolean);
+}
+function expandToolGroups(list) {
+	const normalized = normalizeToolList(list);
+	const expanded = [];
+	for (const value of normalized) {
+		const group = TOOL_GROUPS[value];
+		if (group) {
+			expanded.push(...group);
+			continue;
+		}
+		expanded.push(value);
+	}
+	return Array.from(new Set(expanded));
+}
+function resolveToolProfilePolicy(profile) {
+	return resolveCoreToolProfilePolicy(profile);
+}
+//#endregion
+//#region src/agents/tool-policy.ts
+function wrapOwnerOnlyToolExecution(tool, senderIsOwner) {
+	if (tool.ownerOnly !== true || senderIsOwner || !tool.execute) return tool;
+	return {
+		...tool,
+		execute: async () => {
+			throw new Error("Tool restricted to owner senders.");
+		}
+	};
+}
+const OWNER_ONLY_TOOL_NAME_FALLBACKS = new Set([
+	"whatsapp_login",
+	"cron",
+	"gateway",
+	"nodes"
+]);
+function isOwnerOnlyToolName(name) {
+	return OWNER_ONLY_TOOL_NAME_FALLBACKS.has(normalizeToolName(name));
+}
+function isOwnerOnlyTool(tool) {
+	return tool.ownerOnly === true || isOwnerOnlyToolName(tool.name);
+}
+function applyOwnerOnlyToolPolicy(tools, senderIsOwner) {
+	const withGuard = tools.map((tool) => {
+		if (!isOwnerOnlyTool(tool)) return tool;
+		return wrapOwnerOnlyToolExecution(tool, senderIsOwner);
+	});
+	if (senderIsOwner) return withGuard;
+	return withGuard.filter((tool) => !isOwnerOnlyTool(tool));
+}
+function collectExplicitAllowlist(policies) {
+	const entries = [];
+	for (const policy of policies) {
+		if (!policy?.allow) continue;
+		for (const value of policy.allow) {
+			if (typeof value !== "string") continue;
+			const trimmed = value.trim();
+			if (trimmed) entries.push(trimmed);
+		}
+	}
+	return entries;
+}
+function buildPluginToolGroups(params) {
+	const all = [];
+	const byPlugin = /* @__PURE__ */ new Map();
+	for (const tool of params.tools) {
+		const meta = params.toolMeta(tool);
+		if (!meta) continue;
+		const name = normalizeToolName(tool.name);
+		all.push(name);
+		const pluginId = meta.pluginId.toLowerCase();
+		const list = byPlugin.get(pluginId) ?? [];
+		list.push(name);
+		byPlugin.set(pluginId, list);
+	}
+	return {
+		all,
+		byPlugin
+	};
+}
+function expandPluginGroups(list, groups) {
+	if (!list || list.length === 0) return list;
+	const expanded = [];
+	for (const entry of list) {
+		const normalized = normalizeToolName(entry);
+		if (normalized === "group:plugins") {
+			if (groups.all.length > 0) expanded.push(...groups.all);
+			else expanded.push(normalized);
+			continue;
+		}
+		const tools = groups.byPlugin.get(normalized);
+		if (tools && tools.length > 0) {
+			expanded.push(...tools);
+			continue;
+		}
+		expanded.push(normalized);
+	}
+	return Array.from(new Set(expanded));
+}
+function expandPolicyWithPluginGroups(policy, groups) {
+	if (!policy) return;
+	return {
+		allow: expandPluginGroups(policy.allow, groups),
+		deny: expandPluginGroups(policy.deny, groups)
+	};
+}
+function stripPluginOnlyAllowlist(policy, groups, coreTools) {
+	if (!policy?.allow || policy.allow.length === 0) return {
+		policy,
+		unknownAllowlist: [],
+		strippedAllowlist: false
+	};
+	const normalized = normalizeToolList(policy.allow);
+	if (normalized.length === 0) return {
+		policy,
+		unknownAllowlist: [],
+		strippedAllowlist: false
+	};
+	const pluginIds = new Set(groups.byPlugin.keys());
+	const pluginTools = new Set(groups.all);
+	const unknownAllowlist = [];
+	let hasCoreEntry = false;
+	for (const entry of normalized) {
+		if (entry === "*") {
+			hasCoreEntry = true;
+			continue;
+		}
+		const isPluginEntry = entry === "group:plugins" || pluginIds.has(entry) || pluginTools.has(entry);
+		const isCoreEntry = expandToolGroups([entry]).some((tool) => coreTools.has(tool));
+		if (isCoreEntry) hasCoreEntry = true;
+		if (!isCoreEntry && !isPluginEntry) unknownAllowlist.push(entry);
+	}
+	const strippedAllowlist = !hasCoreEntry;
+	if (strippedAllowlist) {}
+	return {
+		policy: strippedAllowlist ? {
+			...policy,
+			allow: void 0
+		} : policy,
+		unknownAllowlist: Array.from(new Set(unknownAllowlist)),
+		strippedAllowlist
+	};
+}
+function mergeAlsoAllowPolicy(policy, alsoAllow) {
+	if (!policy?.allow || !Array.isArray(alsoAllow) || alsoAllow.length === 0) return policy;
+	return {
+		...policy,
+		allow: Array.from(new Set([...policy.allow, ...alsoAllow]))
+	};
+}
+//#endregion
+//#region src/agents/sandbox/constants.ts
+const DEFAULT_SANDBOX_WORKSPACE_ROOT = path.join(STATE_DIR, "sandboxes");
+const DEFAULT_SANDBOX_IMAGE = "openclaw-sandbox:bookworm-slim";
+const DEFAULT_TOOL_ALLOW = [
+	"exec",
+	"process",
+	"read",
+	"write",
+	"edit",
+	"apply_patch",
+	"image",
+	"sessions_list",
+	"sessions_history",
+	"sessions_send",
+	"sessions_spawn",
+	"sessions_yield",
+	"subagents",
+	"session_status"
+];
+const DEFAULT_TOOL_DENY = [
+	"browser",
+	"canvas",
+	"nodes",
+	"cron",
+	"gateway",
+	...CHANNEL_IDS
+];
+const DEFAULT_SANDBOX_BROWSER_IMAGE = "openclaw-sandbox-browser:bookworm-slim";
+const DEFAULT_SANDBOX_COMMON_IMAGE = "openclaw-sandbox-common:bookworm-slim";
+const SANDBOX_BROWSER_SECURITY_HASH_EPOCH = "2026-02-28-no-sandbox-env";
+const SANDBOX_AGENT_WORKSPACE_MOUNT = "/agent";
+const SANDBOX_STATE_DIR = path.join(STATE_DIR, "sandbox");
+const SANDBOX_REGISTRY_PATH = path.join(SANDBOX_STATE_DIR, "containers.json");
+const SANDBOX_BROWSER_REGISTRY_PATH = path.join(SANDBOX_STATE_DIR, "browsers.json");
+//#endregion
+//#region src/agents/glob-pattern.ts
+function escapeRegex(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function compileGlobPattern(params) {
+	const normalized = params.normalize(params.raw);
+	if (!normalized) return {
+		kind: "exact",
+		value: ""
+	};
+	if (normalized === "*") return { kind: "all" };
+	if (!normalized.includes("*")) return {
+		kind: "exact",
+		value: normalized
+	};
+	return {
+		kind: "regex",
+		value: new RegExp(`^${escapeRegex(normalized).replaceAll("\\*", ".*")}$`)
+	};
+}
+function compileGlobPatterns(params) {
+	if (!Array.isArray(params.raw)) return [];
+	return params.raw.map((raw) => compileGlobPattern({
+		raw,
+		normalize: params.normalize
+	})).filter((pattern) => pattern.kind !== "exact" || pattern.value);
+}
+function matchesAnyGlobPattern(value, patterns) {
+	for (const pattern of patterns) {
+		if (pattern.kind === "all") return true;
+		if (pattern.kind === "exact" && value === pattern.value) return true;
+		if (pattern.kind === "regex" && pattern.value.test(value)) return true;
+	}
+	return false;
+}
+//#endregion
+//#region src/agents/sandbox/tool-policy.ts
+function normalizeGlob(value) {
+	return value.trim().toLowerCase();
+}
+function isToolAllowed(policy, name) {
+	const normalized = normalizeGlob(name);
+	if (matchesAnyGlobPattern(normalized, compileGlobPatterns({
+		raw: expandToolGroups(policy.deny ?? []),
+		normalize: normalizeGlob
+	}))) return false;
+	const allow = compileGlobPatterns({
+		raw: expandToolGroups(policy.allow ?? []),
+		normalize: normalizeGlob
+	});
+	if (allow.length === 0) return true;
+	return matchesAnyGlobPattern(normalized, allow);
+}
+function resolveSandboxToolPolicyForAgent(cfg, agentId) {
+	const agentConfig = cfg && agentId ? resolveAgentConfig(cfg, agentId) : void 0;
+	const agentAllow = agentConfig?.tools?.sandbox?.tools?.allow;
+	const agentDeny = agentConfig?.tools?.sandbox?.tools?.deny;
+	const globalAllow = cfg?.tools?.sandbox?.tools?.allow;
+	const globalDeny = cfg?.tools?.sandbox?.tools?.deny;
+	const allowSource = Array.isArray(agentAllow) ? {
+		source: "agent",
+		key: "agents.list[].tools.sandbox.tools.allow"
+	} : Array.isArray(globalAllow) ? {
+		source: "global",
+		key: "tools.sandbox.tools.allow"
+	} : {
+		source: "default",
+		key: "tools.sandbox.tools.allow"
+	};
+	const denySource = Array.isArray(agentDeny) ? {
+		source: "agent",
+		key: "agents.list[].tools.sandbox.tools.deny"
+	} : Array.isArray(globalDeny) ? {
+		source: "global",
+		key: "tools.sandbox.tools.deny"
+	} : {
+		source: "default",
+		key: "tools.sandbox.tools.deny"
+	};
+	const deny = Array.isArray(agentDeny) ? agentDeny : Array.isArray(globalDeny) ? globalDeny : [...DEFAULT_TOOL_DENY];
+	const allow = Array.isArray(agentAllow) ? agentAllow : Array.isArray(globalAllow) ? globalAllow : [...DEFAULT_TOOL_ALLOW];
+	const expandedDeny = expandToolGroups(deny);
+	let expandedAllow = expandToolGroups(allow);
+	if (expandedAllow.length > 0 && !expandedDeny.map((v) => v.toLowerCase()).includes("image") && !expandedAllow.map((v) => v.toLowerCase()).includes("image")) expandedAllow = [...expandedAllow, "image"];
+	return {
+		allow: expandedAllow,
+		deny: expandedDeny,
+		sources: {
+			allow: allowSource,
+			deny: denySource
+		}
+	};
+}
+//#endregion
+//#region src/agents/sandbox/config.ts
+const DANGEROUS_SANDBOX_DOCKER_BOOLEAN_KEYS = [
+	"dangerouslyAllowReservedContainerTargets",
+	"dangerouslyAllowExternalBindSources",
+	"dangerouslyAllowContainerNamespaceJoin"
+];
+const DEFAULT_SANDBOX_SSH_COMMAND = "ssh";
+const DEFAULT_SANDBOX_SSH_WORKSPACE_ROOT = "/tmp/openclaw-sandboxes";
+function resolveDangerousSandboxDockerBooleans(agentDocker, globalDocker) {
+	const resolved = {};
+	for (const key of DANGEROUS_SANDBOX_DOCKER_BOOLEAN_KEYS) resolved[key] = agentDocker?.[key] ?? globalDocker?.[key];
+	return resolved;
+}
+function resolveSandboxBrowserDockerCreateConfig(params) {
+	const browserNetwork = params.browser.network.trim();
+	const base = {
+		...params.docker,
+		network: browserNetwork || "openclaw-sandbox-browser",
+		image: params.browser.image
+	};
+	return params.browser.binds !== void 0 ? {
+		...base,
+		binds: params.browser.binds
+	} : base;
+}
+function resolveSandboxScope(params) {
+	if (params.scope) return params.scope;
+	if (typeof params.perSession === "boolean") return params.perSession ? "session" : "shared";
+	return "agent";
+}
+function resolveSandboxDockerConfig(params) {
+	const agentDocker = params.scope === "shared" ? void 0 : params.agentDocker;
+	const globalDocker = params.globalDocker;
+	const env = agentDocker?.env ? {
+		...globalDocker?.env ?? { LANG: "C.UTF-8" },
+		...agentDocker.env
+	} : globalDocker?.env ?? { LANG: "C.UTF-8" };
+	const ulimits = agentDocker?.ulimits ? {
+		...globalDocker?.ulimits,
+		...agentDocker.ulimits
+	} : globalDocker?.ulimits;
+	const binds = [...globalDocker?.binds ?? [], ...agentDocker?.binds ?? []];
+	return {
+		image: agentDocker?.image ?? globalDocker?.image ?? "openclaw-sandbox:bookworm-slim",
+		containerPrefix: agentDocker?.containerPrefix ?? globalDocker?.containerPrefix ?? "openclaw-sbx-",
+		workdir: agentDocker?.workdir ?? globalDocker?.workdir ?? "/workspace",
+		readOnlyRoot: agentDocker?.readOnlyRoot ?? globalDocker?.readOnlyRoot ?? true,
+		tmpfs: agentDocker?.tmpfs ?? globalDocker?.tmpfs ?? [
+			"/tmp",
+			"/var/tmp",
+			"/run"
+		],
+		network: agentDocker?.network ?? globalDocker?.network ?? "none",
+		user: agentDocker?.user ?? globalDocker?.user,
+		capDrop: agentDocker?.capDrop ?? globalDocker?.capDrop ?? ["ALL"],
+		env,
+		setupCommand: agentDocker?.setupCommand ?? globalDocker?.setupCommand,
+		pidsLimit: agentDocker?.pidsLimit ?? globalDocker?.pidsLimit,
+		memory: agentDocker?.memory ?? globalDocker?.memory,
+		memorySwap: agentDocker?.memorySwap ?? globalDocker?.memorySwap,
+		cpus: agentDocker?.cpus ?? globalDocker?.cpus,
+		ulimits,
+		seccompProfile: agentDocker?.seccompProfile ?? globalDocker?.seccompProfile,
+		apparmorProfile: agentDocker?.apparmorProfile ?? globalDocker?.apparmorProfile,
+		dns: agentDocker?.dns ?? globalDocker?.dns,
+		extraHosts: agentDocker?.extraHosts ?? globalDocker?.extraHosts,
+		binds: binds.length ? binds : void 0,
+		...resolveDangerousSandboxDockerBooleans(agentDocker, globalDocker)
+	};
+}
+function resolveSandboxBrowserConfig(params) {
+	const agentBrowser = params.scope === "shared" ? void 0 : params.agentBrowser;
+	const globalBrowser = params.globalBrowser;
+	const binds = [...globalBrowser?.binds ?? [], ...agentBrowser?.binds ?? []];
+	const bindsConfigured = globalBrowser?.binds !== void 0 || agentBrowser?.binds !== void 0;
+	return {
+		enabled: agentBrowser?.enabled ?? globalBrowser?.enabled ?? false,
+		image: agentBrowser?.image ?? globalBrowser?.image ?? "openclaw-sandbox-browser:bookworm-slim",
+		containerPrefix: agentBrowser?.containerPrefix ?? globalBrowser?.containerPrefix ?? "openclaw-sbx-browser-",
+		network: agentBrowser?.network ?? globalBrowser?.network ?? "openclaw-sandbox-browser",
+		cdpPort: agentBrowser?.cdpPort ?? globalBrowser?.cdpPort ?? 9222,
+		cdpSourceRange: agentBrowser?.cdpSourceRange ?? globalBrowser?.cdpSourceRange,
+		vncPort: agentBrowser?.vncPort ?? globalBrowser?.vncPort ?? 5900,
+		noVncPort: agentBrowser?.noVncPort ?? globalBrowser?.noVncPort ?? 6080,
+		headless: agentBrowser?.headless ?? globalBrowser?.headless ?? false,
+		enableNoVnc: agentBrowser?.enableNoVnc ?? globalBrowser?.enableNoVnc ?? true,
+		allowHostControl: agentBrowser?.allowHostControl ?? globalBrowser?.allowHostControl ?? false,
+		autoStart: agentBrowser?.autoStart ?? globalBrowser?.autoStart ?? true,
+		autoStartTimeoutMs: agentBrowser?.autoStartTimeoutMs ?? globalBrowser?.autoStartTimeoutMs ?? 12e3,
+		binds: bindsConfigured ? binds : void 0
+	};
+}
+function resolveSandboxPruneConfig(params) {
+	const agentPrune = params.scope === "shared" ? void 0 : params.agentPrune;
+	const globalPrune = params.globalPrune;
+	return {
+		idleHours: agentPrune?.idleHours ?? globalPrune?.idleHours ?? 24,
+		maxAgeDays: agentPrune?.maxAgeDays ?? globalPrune?.maxAgeDays ?? 7
+	};
+}
+function normalizeOptionalString(value) {
+	const trimmed = value?.trim();
+	return trimmed ? trimmed : void 0;
+}
+function normalizeRemoteRoot(value, fallback) {
+	const normalized = normalizeOptionalString(value) ?? fallback;
+	const posix = normalized.replaceAll("\\", "/");
+	if (!posix.startsWith("/")) throw new Error(`Sandbox SSH workspaceRoot must be an absolute POSIX path: ${normalized}`);
+	return posix.replace(/\/+$/g, "") || "/";
+}
+function resolveSandboxSshConfig(params) {
+	const agentSsh = params.scope === "shared" ? void 0 : params.agentSsh;
+	const globalSsh = params.globalSsh;
+	return {
+		target: normalizeOptionalString(agentSsh?.target ?? globalSsh?.target),
+		command: normalizeOptionalString(agentSsh?.command ?? globalSsh?.command) ?? DEFAULT_SANDBOX_SSH_COMMAND,
+		workspaceRoot: normalizeRemoteRoot(agentSsh?.workspaceRoot ?? globalSsh?.workspaceRoot, DEFAULT_SANDBOX_SSH_WORKSPACE_ROOT),
+		strictHostKeyChecking: agentSsh?.strictHostKeyChecking ?? globalSsh?.strictHostKeyChecking ?? true,
+		updateHostKeys: agentSsh?.updateHostKeys ?? globalSsh?.updateHostKeys ?? true,
+		identityFile: normalizeOptionalString(agentSsh?.identityFile ?? globalSsh?.identityFile),
+		certificateFile: normalizeOptionalString(agentSsh?.certificateFile ?? globalSsh?.certificateFile),
+		knownHostsFile: normalizeOptionalString(agentSsh?.knownHostsFile ?? globalSsh?.knownHostsFile),
+		identityData: normalizeSecretInputString(agentSsh?.identityData ?? globalSsh?.identityData),
+		certificateData: normalizeSecretInputString(agentSsh?.certificateData ?? globalSsh?.certificateData),
+		knownHostsData: normalizeSecretInputString(agentSsh?.knownHostsData ?? globalSsh?.knownHostsData)
+	};
+}
+function resolveSandboxConfigForAgent(cfg, agentId) {
+	const agent = cfg?.agents?.defaults?.sandbox;
+	let agentSandbox;
+	const agentConfig = cfg && agentId ? resolveAgentConfig(cfg, agentId) : void 0;
+	if (agentConfig?.sandbox) agentSandbox = agentConfig.sandbox;
+	const scope = resolveSandboxScope({
+		scope: agentSandbox?.scope ?? agent?.scope,
+		perSession: agentSandbox?.perSession ?? agent?.perSession
+	});
+	const toolPolicy = resolveSandboxToolPolicyForAgent(cfg, agentId);
+	return {
+		mode: agentSandbox?.mode ?? agent?.mode ?? "off",
+		backend: agentSandbox?.backend?.trim() || agent?.backend?.trim() || "docker",
+		scope,
+		workspaceAccess: agentSandbox?.workspaceAccess ?? agent?.workspaceAccess ?? "none",
+		workspaceRoot: agentSandbox?.workspaceRoot ?? agent?.workspaceRoot ?? DEFAULT_SANDBOX_WORKSPACE_ROOT,
+		docker: resolveSandboxDockerConfig({
+			scope,
+			globalDocker: agent?.docker,
+			agentDocker: agentSandbox?.docker
+		}),
+		ssh: resolveSandboxSshConfig({
+			scope,
+			globalSsh: agent?.ssh,
+			agentSsh: agentSandbox?.ssh
+		}),
+		browser: resolveSandboxBrowserConfig({
+			scope,
+			globalBrowser: agent?.browser,
+			agentBrowser: agentSandbox?.browser
+		}),
+		tools: {
+			allow: toolPolicy.allow,
+			deny: toolPolicy.deny
+		},
+		prune: resolveSandboxPruneConfig({
+			scope,
+			globalPrune: agent?.prune,
+			agentPrune: agentSandbox?.prune
+		})
+	};
+}
+//#endregion
+//#region src/agents/sandbox/hash.ts
+function hashTextSha256(value) {
+	return crypto.createHash("sha256").update(value).digest("hex");
+}
+//#endregion
+//#region src/agents/sandbox/config-hash.ts
+function normalizeForHash(value) {
+	if (value === void 0) return;
+	if (Array.isArray(value)) return value.map(normalizeForHash).filter((item) => item !== void 0);
+	if (value && typeof value === "object") {
+		const entries = Object.entries(value).toSorted(([a], [b]) => a.localeCompare(b));
+		const normalized = {};
+		for (const [key, entryValue] of entries) {
+			const next = normalizeForHash(entryValue);
+			if (next !== void 0) normalized[key] = next;
+		}
+		return normalized;
+	}
+	return value;
+}
+function computeSandboxConfigHash(input) {
+	return computeHash(input);
+}
+function computeSandboxBrowserConfigHash(input) {
+	return computeHash(input);
+}
+function computeHash(input) {
+	const payload = normalizeForHash(input);
+	return hashTextSha256(JSON.stringify(payload));
+}
+//#endregion
+//#region src/agents/sandbox/registry.ts
+function isRecord(value) {
+	return Boolean(value) && typeof value === "object";
+}
+function isRegistryEntry(value) {
+	return isRecord(value) && typeof value.containerName === "string";
+}
+function normalizeSandboxRegistryEntry(entry) {
+	return {
+		...entry,
+		backendId: entry.backendId?.trim() || "docker",
+		runtimeLabel: entry.runtimeLabel?.trim() || entry.containerName,
+		configLabelKind: entry.configLabelKind?.trim() || "Image"
+	};
+}
+function isRegistryFile(value) {
+	if (!isRecord(value)) return false;
+	const maybeEntries = value.entries;
+	return Array.isArray(maybeEntries) && maybeEntries.every(isRegistryEntry);
+}
+async function withRegistryLock(registryPath, fn) {
+	const lock = await acquireSessionWriteLock({
+		sessionFile: registryPath,
+		allowReentrant: false
+	});
+	try {
+		return await fn();
+	} finally {
+		await lock.release();
+	}
+}
+async function readRegistryFromFile(registryPath, mode) {
+	try {
+		const raw = await fs.readFile(registryPath, "utf-8");
+		const parsed = JSON.parse(raw);
+		if (isRegistryFile(parsed)) return parsed;
+		if (mode === "fallback") return { entries: [] };
+		throw new Error(`Invalid sandbox registry format: ${registryPath}`);
+	} catch (error) {
+		if (error?.code === "ENOENT") return { entries: [] };
+		if (mode === "fallback") return { entries: [] };
+		if (error instanceof Error) throw error;
+		throw new Error(`Failed to read sandbox registry file: ${registryPath}`, { cause: error });
+	}
+}
+async function writeRegistryFile(registryPath, registry) {
+	await writeJsonAtomic(registryPath, registry, { trailingNewline: true });
+}
+async function readRegistry() {
+	return { entries: (await readRegistryFromFile(SANDBOX_REGISTRY_PATH, "fallback")).entries.map((entry) => normalizeSandboxRegistryEntry(entry)) };
+}
+function upsertEntry(entries, entry) {
+	const existing = entries.find((item) => item.containerName === entry.containerName);
+	const next = entries.filter((item) => item.containerName !== entry.containerName);
+	next.push({
+		...entry,
+		backendId: entry.backendId ?? existing?.backendId,
+		runtimeLabel: entry.runtimeLabel ?? existing?.runtimeLabel,
+		createdAtMs: existing?.createdAtMs ?? entry.createdAtMs,
+		image: existing?.image ?? entry.image,
+		configLabelKind: entry.configLabelKind ?? existing?.configLabelKind,
+		configHash: entry.configHash ?? existing?.configHash
+	});
+	return next;
+}
+function removeEntry(entries, containerName) {
+	return entries.filter((entry) => entry.containerName !== containerName);
+}
+async function withRegistryMutation(registryPath, mutate) {
+	await withRegistryLock(registryPath, async () => {
+		const next = mutate((await readRegistryFromFile(registryPath, "strict")).entries);
+		if (next === null) return;
+		await writeRegistryFile(registryPath, { entries: next });
+	});
+}
+async function updateRegistry(entry) {
+	await withRegistryMutation(SANDBOX_REGISTRY_PATH, (entries) => upsertEntry(entries, entry));
+}
+async function removeRegistryEntry(containerName) {
+	await withRegistryMutation(SANDBOX_REGISTRY_PATH, (entries) => {
+		const next = removeEntry(entries, containerName);
+		if (next.length === entries.length) return null;
+		return next;
+	});
+}
+async function readBrowserRegistry() {
+	return await readRegistryFromFile(SANDBOX_BROWSER_REGISTRY_PATH, "fallback");
+}
+async function updateBrowserRegistry(entry) {
+	await withRegistryMutation(SANDBOX_BROWSER_REGISTRY_PATH, (entries) => upsertEntry(entries, entry));
+}
+async function removeBrowserRegistryEntry(containerName) {
+	await withRegistryMutation(SANDBOX_BROWSER_REGISTRY_PATH, (entries) => {
+		const next = removeEntry(entries, containerName);
+		if (next.length === entries.length) return null;
+		return next;
+	});
+}
+//#endregion
+//#region src/agents/sandbox/shared.ts
+function slugifySessionKey(value) {
+	const trimmed = value.trim() || "session";
+	const hash = hashTextSha256(trimmed).slice(0, 8);
+	return `${trimmed.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 32) || "session"}-${hash}`;
+}
+function resolveSandboxWorkspaceDir(root, sessionKey) {
+	const resolvedRoot = resolveUserPath(root);
+	const slug = slugifySessionKey(sessionKey);
+	return path.join(resolvedRoot, slug);
+}
+function resolveSandboxScopeKey(scope, sessionKey) {
+	const trimmed = sessionKey.trim() || "main";
+	if (scope === "shared") return "shared";
+	if (scope === "session") return trimmed;
+	return `agent:${resolveAgentIdFromSessionKey(trimmed)}`;
+}
+function resolveSandboxAgentId(scopeKey) {
+	const trimmed = scopeKey.trim();
+	if (!trimmed || trimmed === "shared") return;
+	const parts = trimmed.split(":").filter(Boolean);
+	if (parts[0] === "agent" && parts[1]) return normalizeAgentId(parts[1]);
+	return resolveAgentIdFromSessionKey(trimmed);
+}
+//#endregion
+//#region src/agents/sandbox/bind-spec.ts
+function splitSandboxBindSpec(spec) {
+	const separator = getHostContainerSeparatorIndex(spec);
+	if (separator === -1) return null;
+	const host = spec.slice(0, separator);
+	const rest = spec.slice(separator + 1);
+	const optionsStart = rest.indexOf(":");
+	if (optionsStart === -1) return {
+		host,
+		container: rest,
+		options: ""
+	};
+	return {
+		host,
+		container: rest.slice(0, optionsStart),
+		options: rest.slice(optionsStart + 1)
+	};
+}
+function getHostContainerSeparatorIndex(spec) {
+	const hasDriveLetterPrefix = /^[A-Za-z]:[\\/]/.test(spec);
+	for (let i = hasDriveLetterPrefix ? 2 : 0; i < spec.length; i += 1) if (spec[i] === ":") return i;
+	return -1;
+}
+//#endregion
+//#region src/agents/sandbox/host-paths.ts
+function stripWindowsNamespacePrefix(input) {
+	if (input.startsWith("\\\\?\\")) {
+		const withoutPrefix = input.slice(4);
+		if (withoutPrefix.toUpperCase().startsWith("UNC\\")) return `\\\\${withoutPrefix.slice(4)}`;
+		return withoutPrefix;
+	}
+	if (input.startsWith("//?/")) {
+		const withoutPrefix = input.slice(4);
+		if (withoutPrefix.toUpperCase().startsWith("UNC/")) return `//${withoutPrefix.slice(4)}`;
+		return withoutPrefix;
+	}
+	return input;
+}
+/**
+* Normalize a POSIX host path: resolve `.`, `..`, collapse `//`, strip trailing `/`.
+*/
+function normalizeSandboxHostPath(raw) {
+	const trimmed = stripWindowsNamespacePrefix(raw.trim());
+	if (!trimmed) return "/";
+	return posix.normalize(trimmed.replaceAll("\\", "/")).replace(/\/+$/, "") || "/";
+}
+/**
+* Resolve a path through the deepest existing ancestor so parent symlinks are honored
+* even when the final source leaf does not exist yet.
+*/
+function resolveSandboxHostPathViaExistingAncestor(sourcePath) {
+	if (!sourcePath.startsWith("/")) return sourcePath;
+	return normalizeSandboxHostPath(resolvePathViaExistingAncestorSync(sourcePath));
+}
+//#endregion
+//#region src/agents/sandbox/validate-sandbox-security.ts
+/**
+* Sandbox security validation — blocks dangerous Docker configurations.
+*
+* Threat model: local-trusted config, but protect against foot-guns and config injection.
+* Enforced at runtime when creating sandbox containers.
+*/
+const BLOCKED_HOST_PATHS = [
+	"/etc",
+	"/private/etc",
+	"/proc",
+	"/sys",
+	"/dev",
+	"/root",
+	"/boot",
+	"/run",
+	"/var/run",
+	"/private/var/run",
+	"/var/run/docker.sock",
+	"/private/var/run/docker.sock",
+	"/run/docker.sock"
+];
+const BLOCKED_SECCOMP_PROFILES = new Set(["unconfined"]);
+const BLOCKED_APPARMOR_PROFILES = new Set(["unconfined"]);
+const RESERVED_CONTAINER_TARGET_PATHS = ["/workspace", SANDBOX_AGENT_WORKSPACE_MOUNT];
+function parseBindSpec(bind) {
+	const trimmed = bind.trim();
+	const parsed = splitSandboxBindSpec(trimmed);
+	if (!parsed) return {
+		source: trimmed,
+		target: ""
+	};
+	return {
+		source: parsed.host,
+		target: parsed.container
+	};
+}
+/**
+* Parse the host/source path from a Docker bind mount string.
+* Format: `source:target[:mode]`
+*/
+function parseBindSourcePath(bind) {
+	return parseBindSpec(bind).source.trim();
+}
+function parseBindTargetPath(bind) {
+	return parseBindSpec(bind).target.trim();
+}
+/**
+* Normalize a POSIX path: resolve `.`, `..`, collapse `//`, strip trailing `/`.
+*/
+function normalizeHostPath(raw) {
+	return normalizeSandboxHostPath(raw);
+}
+/**
+* String-only blocked-path check (no filesystem I/O).
+* Blocks:
+* - binds that target blocked paths (equal or under)
+* - binds that cover the system root (mounting "/" is never safe)
+* - non-absolute source paths (relative / volume names) because they are hard to validate safely
+*/
+function getBlockedBindReason(bind) {
+	const sourceRaw = parseBindSourcePath(bind);
+	if (!sourceRaw.startsWith("/")) return {
+		kind: "non_absolute",
+		sourcePath: sourceRaw
+	};
+	return getBlockedReasonForSourcePath(normalizeHostPath(sourceRaw));
+}
+function getBlockedReasonForSourcePath(sourceNormalized) {
+	if (sourceNormalized === "/") return {
+		kind: "covers",
+		blockedPath: "/"
+	};
+	for (const blocked of BLOCKED_HOST_PATHS) if (sourceNormalized === blocked || sourceNormalized.startsWith(blocked + "/")) return {
+		kind: "targets",
+		blockedPath: blocked
+	};
+	return null;
+}
+function normalizeAllowedRoots(roots) {
+	if (!roots?.length) return [];
+	const normalized = roots.map((entry) => entry.trim()).filter((entry) => entry.startsWith("/")).map(normalizeHostPath);
+	const expanded = /* @__PURE__ */ new Set();
+	for (const root of normalized) {
+		expanded.add(root);
+		const real = resolveSandboxHostPathViaExistingAncestor(root);
+		if (real !== root) expanded.add(real);
+	}
+	return [...expanded];
+}
+function isPathInsidePosix(root, target) {
+	if (root === "/") return true;
+	return target === root || target.startsWith(`${root}/`);
+}
+function getOutsideAllowedRootsReason(sourceNormalized, allowedRoots) {
+	if (allowedRoots.length === 0) return null;
+	for (const root of allowedRoots) if (isPathInsidePosix(root, sourceNormalized)) return null;
+	return {
+		kind: "outside_allowed_roots",
+		sourcePath: sourceNormalized,
+		allowedRoots
+	};
+}
+function getReservedTargetReason(bind) {
+	const targetRaw = parseBindTargetPath(bind);
+	if (!targetRaw || !targetRaw.startsWith("/")) return null;
+	const target = normalizeHostPath(targetRaw);
+	for (const reserved of RESERVED_CONTAINER_TARGET_PATHS) if (isPathInsidePosix(reserved, target)) return {
+		kind: "reserved_target",
+		targetPath: target,
+		reservedPath: reserved
+	};
+	return null;
+}
+function enforceSourcePathPolicy(params) {
+	const blockedReason = getBlockedReasonForSourcePath(params.sourcePath);
+	if (blockedReason) throw formatBindBlockedError({
+		bind: params.bind,
+		reason: blockedReason
+	});
+	if (params.allowSourcesOutsideAllowedRoots) return;
+	const allowedReason = getOutsideAllowedRootsReason(params.sourcePath, params.allowedRoots);
+	if (allowedReason) throw formatBindBlockedError({
+		bind: params.bind,
+		reason: allowedReason
+	});
+}
+function formatBindBlockedError(params) {
+	if (params.reason.kind === "non_absolute") return /* @__PURE__ */ new Error(`Sandbox security: bind mount "${params.bind}" uses a non-absolute source path "${params.reason.sourcePath}". Only absolute POSIX paths are supported for sandbox binds.`);
+	if (params.reason.kind === "outside_allowed_roots") return /* @__PURE__ */ new Error(`Sandbox security: bind mount "${params.bind}" source "${params.reason.sourcePath}" is outside allowed roots (${params.reason.allowedRoots.join(", ")}). Use a dangerous override only when you fully trust this runtime.`);
+	if (params.reason.kind === "reserved_target") return /* @__PURE__ */ new Error(`Sandbox security: bind mount "${params.bind}" targets reserved container path "${params.reason.reservedPath}" (resolved target: "${params.reason.targetPath}"). This can shadow OpenClaw sandbox mounts. Use a dangerous override only when you fully trust this runtime.`);
+	const verb = params.reason.kind === "covers" ? "covers" : "targets";
+	return /* @__PURE__ */ new Error(`Sandbox security: bind mount "${params.bind}" ${verb} blocked path "${params.reason.blockedPath}". Mounting system directories (or Docker socket paths) into sandbox containers is not allowed. Use project-specific paths instead (e.g. /home/user/myproject).`);
+}
+/**
+* Validate bind mounts — throws if any source path is dangerous.
+* Includes a symlink/realpath pass via existing ancestors so non-existent leaf
+* paths cannot bypass source-root and blocked-path checks.
+*/
+function validateBindMounts(binds, options) {
+	if (!binds?.length) return;
+	const allowedRoots = normalizeAllowedRoots(options?.allowedSourceRoots);
+	for (const rawBind of binds) {
+		const bind = rawBind.trim();
+		if (!bind) continue;
+		const blocked = getBlockedBindReason(bind);
+		if (blocked) throw formatBindBlockedError({
+			bind,
+			reason: blocked
+		});
+		if (!options?.allowReservedContainerTargets) {
+			const reservedTarget = getReservedTargetReason(bind);
+			if (reservedTarget) throw formatBindBlockedError({
+				bind,
+				reason: reservedTarget
+			});
+		}
+		const sourceNormalized = normalizeHostPath(parseBindSourcePath(bind));
+		enforceSourcePathPolicy({
+			bind,
+			sourcePath: sourceNormalized,
+			allowedRoots,
+			allowSourcesOutsideAllowedRoots: options?.allowSourcesOutsideAllowedRoots === true
+		});
+		enforceSourcePathPolicy({
+			bind,
+			sourcePath: resolveSandboxHostPathViaExistingAncestor(sourceNormalized),
+			allowedRoots,
+			allowSourcesOutsideAllowedRoots: options?.allowSourcesOutsideAllowedRoots === true
+		});
+	}
+}
+function validateNetworkMode(network, options) {
+	const blockedReason = getBlockedNetworkModeReason({
+		network,
+		allowContainerNamespaceJoin: options?.allowContainerNamespaceJoin
+	});
+	if (blockedReason === "host") throw new Error(`Sandbox security: network mode "${network}" is blocked. Network "host" mode bypasses container network isolation. Use "bridge" or "none" instead.`);
+	if (blockedReason === "container_namespace_join") throw new Error(`Sandbox security: network mode "${network}" is blocked by default. Network "container:*" joins another container namespace and bypasses sandbox network isolation. Use a custom bridge network, or set dangerouslyAllowContainerNamespaceJoin=true only when you fully trust this runtime.`);
+}
+function validateSeccompProfile(profile) {
+	if (profile && BLOCKED_SECCOMP_PROFILES.has(profile.trim().toLowerCase())) throw new Error(`Sandbox security: seccomp profile "${profile}" is blocked. Disabling seccomp removes syscall filtering and weakens sandbox isolation. Use a custom seccomp profile file or omit this setting.`);
+}
+function validateApparmorProfile(profile) {
+	if (profile && BLOCKED_APPARMOR_PROFILES.has(profile.trim().toLowerCase())) throw new Error(`Sandbox security: apparmor profile "${profile}" is blocked. Disabling AppArmor removes mandatory access controls and weakens sandbox isolation. Use a named AppArmor profile or omit this setting.`);
+}
+function validateSandboxSecurity(cfg) {
+	validateBindMounts(cfg.binds, cfg);
+	validateNetworkMode(cfg.network, { allowContainerNamespaceJoin: cfg.dangerouslyAllowContainerNamespaceJoin === true });
+	validateSeccompProfile(cfg.seccompProfile);
+	validateApparmorProfile(cfg.apparmorProfile);
+}
+//#endregion
+//#region src/agents/sandbox/workspace-mounts.ts
+function mainWorkspaceMountSuffix(access) {
+	return access === "rw" ? "" : ":ro";
+}
+function agentWorkspaceMountSuffix(access) {
+	return access === "ro" ? ":ro" : "";
+}
+function appendWorkspaceMountArgs(params) {
+	const { args, workspaceDir, agentWorkspaceDir, workdir, workspaceAccess } = params;
+	args.push("-v", `${workspaceDir}:${workdir}${mainWorkspaceMountSuffix(workspaceAccess)}`);
+	if (workspaceAccess !== "none" && workspaceDir !== agentWorkspaceDir) args.push("-v", `${agentWorkspaceDir}:${SANDBOX_AGENT_WORKSPACE_MOUNT}${agentWorkspaceMountSuffix(workspaceAccess)}`);
+}
+//#endregion
+//#region src/agents/sandbox/docker.ts
+function createAbortError() {
+	const err = /* @__PURE__ */ new Error("Aborted");
+	err.name = "AbortError";
+	return err;
+}
+const DEFAULT_DOCKER_SPAWN_RUNTIME = {
+	platform: process.platform,
+	env: process.env,
+	execPath: process.execPath
+};
+function resolveDockerSpawnInvocation(args, runtime = DEFAULT_DOCKER_SPAWN_RUNTIME) {
+	const resolved = materializeWindowsSpawnProgram(resolveWindowsSpawnProgram({
+		command: "docker",
+		platform: runtime.platform,
+		env: runtime.env,
+		execPath: runtime.execPath,
+		packageName: "docker",
+		allowShellFallback: false
+	}), args);
+	return {
+		command: resolved.command,
+		args: resolved.argv,
+		shell: resolved.shell,
+		windowsHide: resolved.windowsHide
+	};
+}
+function execDockerRaw(args, opts) {
+	return new Promise((resolve, reject) => {
+		const spawnInvocation = resolveDockerSpawnInvocation(args);
+		const child = spawn(spawnInvocation.command, spawnInvocation.args, {
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			shell: spawnInvocation.shell,
+			windowsHide: spawnInvocation.windowsHide
+		});
+		const stdoutChunks = [];
+		const stderrChunks = [];
+		let aborted = false;
+		const signal = opts?.signal;
+		const handleAbort = () => {
+			if (aborted) return;
+			aborted = true;
+			child.kill("SIGTERM");
+		};
+		if (signal) if (signal.aborted) handleAbort();
+		else signal.addEventListener("abort", handleAbort);
+		child.stdout?.on("data", (chunk) => {
+			stdoutChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+		});
+		child.stderr?.on("data", (chunk) => {
+			stderrChunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+		});
+		child.on("error", (error) => {
+			if (signal) signal.removeEventListener("abort", handleAbort);
+			if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+				reject(Object.assign(/* @__PURE__ */ new Error("Sandbox mode requires Docker, but the \"docker\" command was not found in PATH. Install Docker (and ensure \"docker\" is available), or set `agents.defaults.sandbox.mode=off` to disable sandboxing."), {
+					code: "INVALID_CONFIG",
+					cause: error
+				}));
+				return;
+			}
+			reject(error);
+		});
+		child.on("close", (code) => {
+			if (signal) signal.removeEventListener("abort", handleAbort);
+			const stdout = Buffer.concat(stdoutChunks);
+			const stderr = Buffer.concat(stderrChunks);
+			if (aborted || signal?.aborted) {
+				reject(createAbortError());
+				return;
+			}
+			const exitCode = code ?? 0;
+			if (exitCode !== 0 && !opts?.allowFailure) {
+				const message = stderr.length > 0 ? stderr.toString("utf8").trim() : "";
+				reject(Object.assign(new Error(message || `docker ${args.join(" ")} failed`), {
+					code: exitCode,
+					stdout,
+					stderr
+				}));
+				return;
+			}
+			resolve({
+				stdout,
+				stderr,
+				code: exitCode
+			});
+		});
+		const stdin = child.stdin;
+		if (stdin) if (opts?.input !== void 0) stdin.end(opts.input);
+		else stdin.end();
+	});
+}
+const log = createSubsystemLogger("docker");
+const HOT_CONTAINER_WINDOW_MS = 300 * 1e3;
+async function execDocker(args, opts) {
+	const result = await execDockerRaw(args, opts);
+	return {
+		stdout: result.stdout.toString("utf8"),
+		stderr: result.stderr.toString("utf8"),
+		code: result.code
+	};
+}
+async function readDockerContainerLabel(containerName, label) {
+	const result = await execDocker([
+		"inspect",
+		"-f",
+		`{{ index .Config.Labels "${label}" }}`,
+		containerName
+	], { allowFailure: true });
+	if (result.code !== 0) return null;
+	const raw = result.stdout.trim();
+	if (!raw || raw === "<no value>") return null;
+	return raw;
+}
+async function readDockerContainerEnvVar(containerName, envVar) {
+	const result = await execDocker([
+		"inspect",
+		"-f",
+		"{{range .Config.Env}}{{println .}}{{end}}",
+		containerName
+	], { allowFailure: true });
+	if (result.code !== 0) return null;
+	for (const line of result.stdout.split(/\r?\n/)) if (line.startsWith(`${envVar}=`)) return line.slice(envVar.length + 1);
+	return null;
+}
+async function readDockerPort(containerName, port) {
+	const result = await execDocker([
+		"port",
+		containerName,
+		`${port}/tcp`
+	], { allowFailure: true });
+	if (result.code !== 0) return null;
+	const match = (result.stdout.trim().split(/\r?\n/)[0] ?? "").match(/:(\d+)\s*$/);
+	if (!match) return null;
+	const mapped = Number.parseInt(match[1] ?? "", 10);
+	return Number.isFinite(mapped) ? mapped : null;
+}
+async function dockerImageExists(image) {
+	const result = await execDocker([
+		"image",
+		"inspect",
+		image
+	], { allowFailure: true });
+	if (result.code === 0) return true;
+	const stderr = result.stderr.trim();
+	if (stderr.includes("No such image")) return false;
+	throw new Error(`Failed to inspect sandbox image: ${stderr}`);
+}
+async function ensureDockerImage(image) {
+	if (await dockerImageExists(image)) return;
+	if (image === "openclaw-sandbox:bookworm-slim") {
+		await execDocker(["pull", "debian:bookworm-slim"]);
+		await execDocker([
+			"tag",
+			"debian:bookworm-slim",
+			DEFAULT_SANDBOX_IMAGE
+		]);
+		return;
+	}
+	throw new Error(`Sandbox image not found: ${image}. Build or pull it first.`);
+}
+async function dockerContainerState(name) {
+	const result = await execDocker([
+		"inspect",
+		"-f",
+		"{{.State.Running}}",
+		name
+	], { allowFailure: true });
+	if (result.code !== 0) return {
+		exists: false,
+		running: false
+	};
+	return {
+		exists: true,
+		running: result.stdout.trim() === "true"
+	};
+}
+function normalizeDockerLimit(value) {
+	if (value === void 0 || value === null) return;
+	if (typeof value === "number") return Number.isFinite(value) ? String(value) : void 0;
+	const trimmed = value.trim();
+	return trimmed ? trimmed : void 0;
+}
+function formatUlimitValue(name, value) {
+	if (!name.trim()) return null;
+	if (typeof value === "number" || typeof value === "string") {
+		const raw = String(value).trim();
+		return raw ? `${name}=${raw}` : null;
+	}
+	const soft = typeof value.soft === "number" ? Math.max(0, value.soft) : void 0;
+	const hard = typeof value.hard === "number" ? Math.max(0, value.hard) : void 0;
+	if (soft === void 0 && hard === void 0) return null;
+	if (soft === void 0) return `${name}=${hard}`;
+	if (hard === void 0) return `${name}=${soft}`;
+	return `${name}=${soft}:${hard}`;
+}
+function buildSandboxCreateArgs(params) {
+	validateSandboxSecurity({
+		...params.cfg,
+		allowedSourceRoots: params.bindSourceRoots,
+		allowSourcesOutsideAllowedRoots: params.allowSourcesOutsideAllowedRoots ?? params.cfg.dangerouslyAllowExternalBindSources === true,
+		allowReservedContainerTargets: params.allowReservedContainerTargets ?? params.cfg.dangerouslyAllowReservedContainerTargets === true,
+		dangerouslyAllowContainerNamespaceJoin: params.allowContainerNamespaceJoin ?? params.cfg.dangerouslyAllowContainerNamespaceJoin === true
+	});
+	const createdAtMs = params.createdAtMs ?? Date.now();
+	const args = [
+		"create",
+		"--name",
+		params.name
+	];
+	args.push("--label", "openclaw.sandbox=1");
+	args.push("--label", `openclaw.sessionKey=${params.scopeKey}`);
+	args.push("--label", `openclaw.createdAtMs=${createdAtMs}`);
+	if (params.configHash) args.push("--label", `openclaw.configHash=${params.configHash}`);
+	for (const [key, value] of Object.entries(params.labels ?? {})) if (key && value) args.push("--label", `${key}=${value}`);
+	if (params.cfg.readOnlyRoot) args.push("--read-only");
+	for (const entry of params.cfg.tmpfs) args.push("--tmpfs", entry);
+	if (params.cfg.network) args.push("--network", params.cfg.network);
+	if (params.cfg.user) args.push("--user", params.cfg.user);
+	const envSanitization = sanitizeEnvVars(params.cfg.env ?? {}, params.envSanitizationOptions);
+	if (envSanitization.blocked.length > 0) log.warn(`Blocked sensitive environment variables: ${envSanitization.blocked.join(", ")}`);
+	if (envSanitization.warnings.length > 0) log.warn(`Suspicious environment variables: ${envSanitization.warnings.join(", ")}`);
+	for (const [key, value] of Object.entries(markOpenClawExecEnv(envSanitization.allowed))) args.push("--env", `${key}=${value}`);
+	for (const cap of params.cfg.capDrop) args.push("--cap-drop", cap);
+	args.push("--security-opt", "no-new-privileges");
+	if (params.cfg.seccompProfile) args.push("--security-opt", `seccomp=${params.cfg.seccompProfile}`);
+	if (params.cfg.apparmorProfile) args.push("--security-opt", `apparmor=${params.cfg.apparmorProfile}`);
+	for (const entry of params.cfg.dns ?? []) if (entry.trim()) args.push("--dns", entry);
+	for (const entry of params.cfg.extraHosts ?? []) if (entry.trim()) args.push("--add-host", entry);
+	if (typeof params.cfg.pidsLimit === "number" && params.cfg.pidsLimit > 0) args.push("--pids-limit", String(params.cfg.pidsLimit));
+	const memory = normalizeDockerLimit(params.cfg.memory);
+	if (memory) args.push("--memory", memory);
+	const memorySwap = normalizeDockerLimit(params.cfg.memorySwap);
+	if (memorySwap) args.push("--memory-swap", memorySwap);
+	if (typeof params.cfg.cpus === "number" && params.cfg.cpus > 0) args.push("--cpus", String(params.cfg.cpus));
+	for (const [name, value] of Object.entries(params.cfg.ulimits ?? {})) {
+		const formatted = formatUlimitValue(name, value);
+		if (formatted) args.push("--ulimit", formatted);
+	}
+	if (params.includeBinds !== false && params.cfg.binds?.length) for (const bind of params.cfg.binds) args.push("-v", bind);
+	return args;
+}
+function appendCustomBinds(args, cfg) {
+	if (!cfg.binds?.length) return;
+	for (const bind of cfg.binds) args.push("-v", bind);
+}
+async function createSandboxContainer(params) {
+	const { name, cfg, workspaceDir, scopeKey } = params;
+	await ensureDockerImage(cfg.image);
+	const args = buildSandboxCreateArgs({
+		name,
+		cfg,
+		scopeKey,
+		configHash: params.configHash,
+		includeBinds: false,
+		bindSourceRoots: [workspaceDir, params.agentWorkspaceDir]
+	});
+	args.push("--workdir", cfg.workdir);
+	appendWorkspaceMountArgs({
+		args,
+		workspaceDir,
+		agentWorkspaceDir: params.agentWorkspaceDir,
+		workdir: cfg.workdir,
+		workspaceAccess: params.workspaceAccess
+	});
+	appendCustomBinds(args, cfg);
+	args.push(cfg.image, "sleep", "infinity");
+	await execDocker(args);
+	await execDocker(["start", name]);
+	if (cfg.setupCommand?.trim()) await execDocker([
+		"exec",
+		"-i",
+		name,
+		"/bin/sh",
+		"-lc",
+		cfg.setupCommand
+	]);
+}
+async function readContainerConfigHash(containerName) {
+	return await readDockerContainerLabel(containerName, "openclaw.configHash");
+}
+function formatSandboxRecreateHint(params) {
+	if (params.scope === "session") return formatCliCommand(`openclaw sandbox recreate --session ${params.sessionKey}`);
+	if (params.scope === "agent") return formatCliCommand(`openclaw sandbox recreate --agent ${resolveSandboxAgentId(params.sessionKey) ?? "main"}`);
+	return formatCliCommand("openclaw sandbox recreate --all");
+}
+async function ensureSandboxContainer(params) {
+	const scopeKey = resolveSandboxScopeKey(params.cfg.scope, params.sessionKey);
+	const slug = params.cfg.scope === "shared" ? "shared" : slugifySessionKey(scopeKey);
+	const containerName = `${params.cfg.docker.containerPrefix}${slug}`.slice(0, 63);
+	const expectedHash = computeSandboxConfigHash({
+		docker: params.cfg.docker,
+		workspaceAccess: params.cfg.workspaceAccess,
+		workspaceDir: params.workspaceDir,
+		agentWorkspaceDir: params.agentWorkspaceDir
+	});
+	const now = Date.now();
+	const state = await dockerContainerState(containerName);
+	let hasContainer = state.exists;
+	let running = state.running;
+	let currentHash = null;
+	let hashMismatch = false;
+	let registryEntry;
+	if (hasContainer) {
+		registryEntry = (await readRegistry()).entries.find((entry) => entry.containerName === containerName);
+		currentHash = await readContainerConfigHash(containerName);
+		if (!currentHash) currentHash = registryEntry?.configHash ?? null;
+		hashMismatch = !currentHash || currentHash !== expectedHash;
+		if (hashMismatch) {
+			const lastUsedAtMs = registryEntry?.lastUsedAtMs;
+			if (running && (typeof lastUsedAtMs !== "number" || now - lastUsedAtMs < HOT_CONTAINER_WINDOW_MS)) {
+				const hint = formatSandboxRecreateHint({
+					scope: params.cfg.scope,
+					sessionKey: scopeKey
+				});
+				defaultRuntime.log(`Sandbox config changed for ${containerName} (recently used). Recreate to apply: ${hint}`);
+			} else {
+				await execDocker([
+					"rm",
+					"-f",
+					containerName
+				], { allowFailure: true });
+				hasContainer = false;
+				running = false;
+			}
+		}
+	}
+	if (!hasContainer) await createSandboxContainer({
+		name: containerName,
+		cfg: params.cfg.docker,
+		workspaceDir: params.workspaceDir,
+		workspaceAccess: params.cfg.workspaceAccess,
+		agentWorkspaceDir: params.agentWorkspaceDir,
+		scopeKey,
+		configHash: expectedHash
+	});
+	else if (!running) await execDocker(["start", containerName]);
+	await updateRegistry({
+		containerName,
+		backendId: "docker",
+		runtimeLabel: containerName,
+		sessionKey: scopeKey,
+		createdAtMs: now,
+		lastUsedAtMs: now,
+		image: params.cfg.docker.image,
+		configLabelKind: "Image",
+		configHash: hashMismatch && running ? currentHash ?? void 0 : expectedHash
+	});
+	return containerName;
+}
+//#endregion
+export { compileGlobPatterns as A, expandPolicyWithPluginGroups as B, updateRegistry as C, resolveSandboxScope as D, resolveSandboxConfigForAgent as E, SANDBOX_AGENT_WORKSPACE_MOUNT as F, resolveToolProfilePolicy as G, stripPluginOnlyAllowlist as H, SANDBOX_BROWSER_SECURITY_HASH_EPOCH as I, applyOwnerOnlyToolPolicy as L, DEFAULT_SANDBOX_BROWSER_IMAGE as M, DEFAULT_SANDBOX_COMMON_IMAGE as N, isToolAllowed as O, DEFAULT_SANDBOX_IMAGE as P, buildPluginToolGroups as R, updateBrowserRegistry as S, resolveSandboxBrowserDockerCreateConfig as T, expandToolGroups as U, mergeAlsoAllowPolicy as V, normalizeToolName as W, slugifySessionKey as _, execDockerRaw as a, removeBrowserRegistryEntry as b, readDockerPort as c, validateNetworkMode as d, resolveSandboxHostPathViaExistingAncestor as f, resolveSandboxWorkspaceDir as g, resolveSandboxScopeKey as h, execDocker as i, matchesAnyGlobPattern as j, resolveSandboxToolPolicyForAgent as k, appendWorkspaceMountArgs as l, resolveSandboxAgentId as m, dockerContainerState as n, readDockerContainerEnvVar as o, splitSandboxBindSpec as p, ensureSandboxContainer as r, readDockerContainerLabel as s, buildSandboxCreateArgs as t, getBlockedBindReason as u, readBrowserRegistry as v, computeSandboxBrowserConfigHash as w, removeRegistryEntry as x, readRegistry as y, collectExplicitAllowlist as z };