openclaw/dist/config-BbEpd-O_.mjs

Multi-channel AI gateway with extensible messaging integrations

import { c as isRecord } from "./record-coerce-TIsquoVR.mjs";
import { d as normalizeStringEntries } from "./string-normalization-CECOqf64.mjs";
import { n as formatConfigIssueLines } from "./issue-format-L1jxHK43.mjs";
import { y as redactToolDetail } from "./redact-DJ8j6ADa.mjs";
import { t as isPlainObject } from "./plain-object-BFvGATnd.mjs";
import "./utils-DgZn2dLu.mjs";
import { t as formatErrorMessage } from "./errors-O33D01XW.mjs";
import { r as restoreRedactedValues, t as redactConfigObject } from "./redact-snapshot-Ds6C-7Ba.mjs";
import { n as normalizeAgentId } from "./agent-id-D1-Q6vR4.mjs";
import "./agent-scope-config-CDYpzA0r.mjs";
import "./session-key-C09ow4h0.mjs";
import { a as readAgentRosterProperty } from "./agent-roster-BXD1uMJD.mjs";
import { p as resolveConfigSnapshotHash, s as parseConfigJson5 } from "./io.read-helpers-Bvdjf9tk.mjs";
import { T as writeRestartSentinel, c as formatDoctorNonInteractiveHint } from "./restart-sentinel-CWHFSDjo.mjs";
import { t as createConfigIO } from "./io.factory-0ZgSoWaa.mjs";
import { n as normalizeSubmittedConfigModelRefs } from "./model-input-normalization-C54uHM0N.mjs";
import { t as ConfigMutationConflictError } from "./mutation-conflict-Be0wSyDG.mjs";
import { i as normalizeConfigPatchReplacePaths, n as formatConfigPatchPath, r as isMergePatchObjectKeyAllowed, t as collectBaseArrayPaths } from "./patch-replace-paths-C78doaBn.mjs";
import { i as projectRuntimeChangesOntoSource } from "./runtime-source-projection-rvQFgz1Z.mjs";
import { d as getActivePluginRegistryVersion } from "./runtime-NsVZTERq.mjs";
import { G as isBuiltInModelProviderOverlayId } from "./zod-schema.core-MaNAY9dn.mjs";
import { n as validateConfigObjectRawWithPlugins, r as validateConfigObjectWithPlugins } from "./validation-CiziKiqX.mjs";
import { t as ConfigWritePostCommitError } from "./io.write-errors-DuSgsySH.mjs";
import { C as attachRuntimeConfigWriteApplication, T as createRuntimeConfigWriteApplication, u as readConfigFileSnapshotForWrite } from "./io.runtime-BsUXSsD4.mjs";
import "./io-BYWYXJXl.mjs";
import { n as createMergePatch, t as applyMergePatch } from "./merge-patch-C4XTCka4.mjs";
import { r as replaceConfigFile } from "./mutate-DJq1JylX.mjs";
import "./config-DLycWFvB.mjs";
import { h as redactSecretDegradationReason, l as isRetryableSecretDegradationReason } from "./runtime-degraded-state-oevwKU3u.mjs";
import { at as validateConfigSchemaParams, et as validateConfigApplyParams, it as validateConfigSchemaLookupResult, nt as validateConfigPatchParams, ot as validateConfigSetParams, rt as validateConfigSchemaLookupParams, tt as validateConfigGetParams } from "./src-l2dWvEsN.mjs";
import { i as captureGatewayRootWorkAdmissionContinuationScope } from "./gateway-work-admission-rc4ZgKq_.mjs";
import { u as getActiveSecretsRuntimeSnapshotState } from "./runtime-state-DtxmQnWt.mjs";
import { t as ErrorCodes } from "./gateway-error-details-DIefe7Zy.mjs";
import { f as errorShape } from "./error-codes-Dh56LniQ.mjs";
import { w as formatValidationErrors } from "./worker-protocol-primitives-BajTgPT4.mjs";
import { r as resolveGatewayAuth } from "./auth-resolve-BmUDP1m_.mjs";
import { u as scheduleGatewayRestart } from "./restart-bgglYgQb.mjs";
import "./sessions-DQtCC-5j.mjs";
import { t as extractDeliveryInfo } from "./delivery-info-Cbanwqua.mjs";
import { t as resolveGatewayReloadSettings } from "./config-reload-settings-McXSFzXR.mjs";
import { n as holdGatewayPolicyResponse } from "./ws-policy-close-BgtfQbi3.mjs";
import { r as lookupConfigSchema } from "./schema-BBhEexxB.mjs";
import "./auth-BfNXsaOg.mjs";
import { n as loadGatewayRuntimeConfigSchema } from "./runtime-schema-B9K3TKK7.mjs";
import { i as resolveConfigReloadMetadata, n as isNoopGatewayReloadPlan, o as diffConfigPaths, r as listConfigReloadRefinementPrefixes, s as diffGatewayReloadPaths, t as buildGatewayReloadPlan } from "./config-reload-plan-Dh4XTS8o.mjs";
import { t as resolveSharedGatewaySessionGeneration } from "./ws-shared-generation-BeRsGF9T.mjs";
import { t as assertValidParams } from "./validation-Bu27N0nv.mjs";
import { i as summarizeChangedPaths, r as resolveControlPlaneActor, t as formatControlPlaneActor } from "./control-plane-audit-DhEbrRsy.mjs";
import { n as parseRestartRequestParams } from "./restart-request-Cq5MrcJD.mjs";
import { a as sanitizePathForLog, i as resolveOpenPathCommand, n as formatOpenPathError, r as isHeadlessOpenPathError, t as execOpenPath } from "./open-path-DSWZKVD0.mjs";
import { c as prepareSecretsRuntimeSnapshot } from "./runtime-Cs6wKpAq.mjs";
import { n as readConfigGetResponse, t as invalidateConfigGetResponseCache } from "./config-get-response-C-AjSxxg.mjs";
import { t as resolveBaseHashParam } from "./base-hash-DxpcXxxb.mjs";
import { isDeepStrictEqual } from "node:util";
//#region src/gateway/server-methods/config-submission-validation.ts
const MAX_CONFIG_ISSUES_IN_ERROR_SUMMARY = 3;
function summarizeConfigValidationIssues(issues) {
	const trimmed = issues.slice(0, MAX_CONFIG_ISSUES_IN_ERROR_SUMMARY);
	const lines = normalizeStringEntries(formatConfigIssueLines(trimmed, "", { normalizeRoot: true }));
	if (lines.length === 0) return "invalid config";
	const hiddenCount = Math.max(0, issues.length - lines.length);
	return `invalid config: ${lines.join("; ")}${hiddenCount > 0 ? ` (+${hiddenCount} more issue${hiddenCount === 1 ? "" : "s"})` : ""}`;
}
function validateSubmittedConfigOrRespond(params) {
	const normalizationCandidate = params.candidate;
	const validationCandidate = normalizeSubmittedConfigModelRefs(normalizationCandidate, params.pluginMetadataSnapshot?.owners.modelIdNormalizationPolicies);
	const respondInvalid = (issues) => {
		params.respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, summarizeConfigValidationIssues(issues), { details: { issues } }));
	};
	const validationParams = { pluginMetadataSnapshot: params.pluginMetadataSnapshot };
	const sourceValidated = validateConfigObjectRawWithPlugins(validationCandidate, validationParams);
	if (!sourceValidated.ok) {
		respondInvalid(sourceValidated.issues);
		return null;
	}
	const validated = validateConfigObjectWithPlugins(validationCandidate, validationParams);
	if (!validated.ok) {
		respondInvalid(validated.issues);
		return null;
	}
	return {
		validationCandidate,
		config: validated.config
	};
}
//#endregion
//#region src/gateway/server-methods/config-write-flow.ts
function resolveGatewayConfigPath(snapshot) {
	return snapshot?.path ?? createConfigIO().configPath;
}
/** Compares the effective shared Gateway auth surface that active clients use. */
function didSharedGatewayAuthChange(prev, next) {
	const prevResolvedAuth = resolveGatewayAuth({
		authConfig: prev.gateway?.auth,
		env: process.env,
		tailscaleMode: prev.gateway?.tailscale?.mode
	});
	const nextResolvedAuth = resolveGatewayAuth({
		authConfig: next.gateway?.auth,
		env: process.env,
		tailscaleMode: next.gateway?.tailscale?.mode
	});
	return prevResolvedAuth.mode !== nextResolvedAuth.mode || prevResolvedAuth.mode !== "trusted-proxy" && resolveSharedGatewaySessionGeneration(prevResolvedAuth, prev.gateway?.trustedProxies) !== resolveSharedGatewaySessionGeneration(nextResolvedAuth, next.gateway?.trustedProxies);
}
function projectAuthoredValuesOntoRuntimeOverlay(params) {
	const { source, active } = params;
	if (active === void 0) return structuredClone(params.fallback);
	if (!isRecord(source) || !isRecord(active)) return structuredClone(isDeepStrictEqual(source, params.activeSource) ? active : params.fallback);
	const fallback = isRecord(params.fallback) ? params.fallback : {};
	const activeSource = isRecord(params.activeSource) ? params.activeSource : {};
	const sourceKeys = new Set(Object.keys(source));
	return Object.fromEntries([...Object.entries(fallback).filter(([key]) => !sourceKeys.has(key)), ...Object.keys(source).map((key) => [key, projectAuthoredValuesOntoRuntimeOverlay({
		source: source[key],
		activeSource: activeSource[key],
		active: active[key],
		fallback: fallback[key]
	})])]);
}
/** Compares against the active secrets-expanded config when one is available. */
function didActiveSharedGatewayAuthChange(params) {
	const active = getActiveSecretsRuntimeSnapshotState();
	if (!active) return didSharedGatewayAuthChange(params.fallbackPrev, params.next);
	const currentSourceGateway = (params.fallbackSource ?? active.sourceConfig).gateway;
	const activeSourceGateway = active.sourceConfig.gateway;
	const activeGateway = active.config.gateway;
	const fallbackGateway = params.fallbackPrev.gateway;
	const selectOwnedGatewayValue = (key) => currentSourceGateway && Object.hasOwn(currentSourceGateway, key) ? projectAuthoredValuesOntoRuntimeOverlay({
		source: currentSourceGateway[key],
		activeSource: activeSourceGateway?.[key],
		active: activeGateway?.[key],
		fallback: fallbackGateway?.[key]
	}) : fallbackGateway?.[key];
	return didSharedGatewayAuthChange({
		...params.fallbackPrev,
		gateway: {
			...fallbackGateway,
			auth: selectOwnedGatewayValue("auth"),
			tailscale: selectOwnedGatewayValue("tailscale"),
			trustedProxies: selectOwnedGatewayValue("trustedProxies")
		}
	}, params.next);
}
function resolveConfigRestartRequirement(params) {
	const reloadSettings = resolveGatewayReloadSettings(params.nextConfig);
	const plan = buildGatewayReloadPlan(params.changedPaths, {
		previousConfig: params.previousConfig,
		candidateConfig: params.nextConfig
	});
	const requiresRestart = !isNoopGatewayReloadPlan(plan) && (reloadSettings.mode === "off" || plan.restartGateway);
	return {
		requiresRestart,
		scheduleDirectRestart: requiresRestart && reloadSettings.mode === "off"
	};
}
/** Returns whether a managed config write can settle without restarting the Gateway. */
function shouldAwaitGatewayConfigApplication(params) {
	return !resolveConfigRestartRequirement(params).requiresRestart;
}
function resolveConfigRestartRequest(params) {
	const { sessionKey, deliveryContext: requestedDeliveryContext, threadId: requestedThreadId, note, restartDelayMs } = parseRestartRequestParams(params);
	const { deliveryContext: sessionDeliveryContext, threadId: sessionThreadId } = extractDeliveryInfo(sessionKey);
	return {
		sessionKey,
		note,
		restartDelayMs,
		deliveryContext: requestedDeliveryContext ?? sessionDeliveryContext,
		threadId: requestedThreadId ?? sessionThreadId
	};
}
/** Persists a gateway config write and returns follow-up work that must run after response. */
async function commitGatewayConfigWrite(params) {
	const previousRuntimeConfig = params.context?.getCommittedRuntimeConfig?.() ?? params.snapshot.config;
	const application = params.awaitRuntimeApplication ? createRuntimeConfigWriteApplication(captureGatewayRootWorkAdmissionContinuationScope()?.run) : void 0;
	holdGatewayPolicyResponse(params.respond);
	const result = await replaceConfigFile({
		sourceConfig: params.nextConfig,
		baseHash: resolveConfigSnapshotHash(params.snapshot) ?? void 0,
		writeOptions: attachRuntimeConfigWriteApplication({
			...params.writeOptions,
			auditOrigin: "config-rpc",
			runtimeRefresh: {
				...params.writeOptions.runtimeRefresh,
				includeAuthStoreRefs: false
			}
		}, application),
		afterWrite: { mode: "auto" }
	});
	return {
		path: resolveGatewayConfigPath(params.snapshot),
		config: result.nextConfig,
		hash: result.persistedHash,
		...application ? { application: application.claimed ? application.result : Promise.resolve("unclaimed") } : {},
		queueFollowUp: () => {
			if (!application?.claimed) queueMicrotask(() => {
				params.context?.enforceSharedGatewayAuthGenerationForConfigWrite?.(result.nextConfig, previousRuntimeConfig);
				if (params.disconnectSharedAuthClients) params.context?.disconnectClientsUsingSharedGatewayAuth?.();
			});
		}
	};
}
async function resolveGatewayConfigRestartWriteResult(params) {
	const { sessionKey, note, restartDelayMs, deliveryContext, threadId } = resolveConfigRestartRequest(params.requestParams);
	const restartRequirement = resolveConfigRestartRequirement({
		changedPaths: params.changedPaths,
		previousConfig: params.previousConfig,
		nextConfig: params.nextConfig
	});
	const payload = {
		kind: params.kind,
		status: "ok",
		ts: Date.now(),
		sessionKey,
		deliveryContext,
		threadId,
		message: note ?? null,
		doctorHint: formatDoctorNonInteractiveHint(),
		stats: {
			mode: params.mode,
			root: params.configPath,
			requiresRestart: restartRequirement.requiresRestart
		}
	};
	const sentinelPersisted = await writeRestartSentinel(payload).then(() => true, () => false);
	const restart = restartRequirement.scheduleDirectRestart ? scheduleGatewayRestart({
		delayMs: restartDelayMs,
		reason: params.mode,
		audit: {
			actor: params.actor.actor,
			deviceId: params.actor.deviceId,
			clientIp: params.actor.clientIp,
			changedPaths: params.changedPaths
		}
	}) : void 0;
	if (restart?.coalesced) params.context?.logGateway?.warn(`${params.mode} restart coalesced ${formatControlPlaneActor(params.actor)} delayMs=${restart.delayMs}`);
	return {
		payload,
		sentinelPersisted,
		restart
	};
}
//#endregion
//#region src/gateway/server-methods/config.ts
let configSchemaResponseCache = null;
const configWriteRecovery = /* @__PURE__ */ new WeakMap();
function requireConfigBaseHash(params, snapshot, respond, revisionProjector) {
	if (!snapshot.exists) return true;
	const snapshotHash = resolveConfigSnapshotHash(snapshot);
	const baseHash = resolveBaseHashParam(params);
	if (!snapshotHash || !baseHash) {
		respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `config base hash ${snapshotHash ? "required" : "unavailable"}; re-run config.get and retry`));
		return false;
	}
	if (baseHash !== revisionProjector.projectRawHash(snapshotHash)) {
		invalidateConfigGetResponseCache();
		respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, "config changed since last load; re-run config.get and retry"));
		return false;
	}
	return true;
}
function collectDestructiveArrayPatchPaths(params) {
	if (!isPlainObject(params.patch) || !isPlainObject(params.base)) return [];
	const merged = isPlainObject(params.merged) ? params.merged : {};
	const paths = [];
	for (const [key, patchValue] of Object.entries(params.patch)) {
		const path = formatConfigPatchPath(params.path ?? "", key);
		if (!isMergePatchObjectKeyAllowed(key, params.path)) continue;
		const baseValue = params.base[key];
		const mergedValue = merged[key];
		if (Array.isArray(baseValue)) {
			if (patchValue === null || !Array.isArray(patchValue)) {
				paths.push(path);
				continue;
			}
			if (Array.isArray(mergedValue)) {
				if (isConfigPatchIdKeyedArray(baseValue)) {
					if (!idKeyedArrayPreservesBaseIds(baseValue, mergedValue)) {
						paths.push(path);
						continue;
					}
					paths.push(...collectDestructiveIdKeyedArrayEntryPatchPaths({
						base: baseValue,
						patch: patchValue,
						merged: mergedValue,
						path
					}));
				} else if (!arrayPreservesBaseEntries(baseValue, mergedValue)) {
					paths.push(path);
					continue;
				}
			}
		} else if (isPlainObject(baseValue) && !isPlainObject(patchValue)) {
			paths.push(...collectBaseArrayPaths(baseValue, path));
			continue;
		}
		if (isPlainObject(patchValue)) paths.push(...collectDestructiveArrayPatchPaths({
			base: baseValue,
			patch: patchValue,
			merged: mergedValue,
			path
		}));
	}
	return paths;
}
function isConfigPatchObjectWithStringId(value) {
	return isPlainObject(value) && typeof value.id === "string" && value.id.length > 0;
}
function assertNoDuplicateConfigPatchIds(params) {
	const path = params.path ?? "";
	if (Array.isArray(params.patch)) {
		if (!Array.isArray(params.current) || params.replacePaths.has(path) || !isConfigPatchIdKeyedArray(params.current)) return;
		const currentIds = /* @__PURE__ */ new Set();
		for (const entry of params.current) {
			if (currentIds.has(entry.id)) throw new Error(`Cannot ID-merge array at ${path || "<root>"}: current config contains duplicate ID ${entry.id}; use replacePaths for an explicit replacement.`);
			currentIds.add(entry.id);
		}
		const ids = /* @__PURE__ */ new Set();
		for (const entry of params.patch) {
			if (!isConfigPatchObjectWithStringId(entry)) continue;
			if (ids.has(entry.id)) throw new Error(`Ambiguous duplicate ID ${entry.id} in array at ${path || "<root>"}.`);
			ids.add(entry.id);
		}
		const currentById = new Map(params.current.map((entry) => [entry.id, entry]));
		for (const entry of params.patch) {
			if (!isConfigPatchObjectWithStringId(entry)) continue;
			const currentEntry = currentById.get(entry.id);
			if (currentEntry) assertNoDuplicateConfigPatchIds({
				patch: entry,
				current: currentEntry,
				replacePaths: params.replacePaths,
				path: `${path}[]`
			});
		}
		return;
	}
	if (!isRecord(params.patch) || !isRecord(params.current)) return;
	for (const [key, child] of Object.entries(params.patch)) assertNoDuplicateConfigPatchIds({
		patch: child,
		current: params.current[key],
		replacePaths: params.replacePaths,
		path: formatConfigPatchPath(path, key)
	});
}
function isConfigPatchIdKeyedArray(value) {
	return value.every(isConfigPatchObjectWithStringId);
}
function idKeyedArrayPreservesBaseIds(base, merged) {
	const mergedIds = new Set(merged.filter(isConfigPatchObjectWithStringId).map((entry) => entry.id));
	return base.every((entry) => mergedIds.has(entry.id));
}
function arrayPreservesBaseEntries(base, merged) {
	const unmatchedMerged = [...merged];
	for (const baseEntry of base) {
		const matchIndex = unmatchedMerged.findIndex((mergedEntry) => isDeepStrictEqual(mergedEntry, baseEntry));
		if (matchIndex === -1) return false;
		unmatchedMerged.splice(matchIndex, 1);
	}
	return true;
}
function collectDestructiveIdKeyedArrayEntryPatchPaths(params) {
	const baseById = new Map(params.base.map((entry) => [entry.id, entry]));
	const mergedById = new Map(params.merged.filter(isConfigPatchObjectWithStringId).map((entry) => [entry.id, entry]));
	const paths = [];
	for (const patchEntry of params.patch) {
		if (!isConfigPatchObjectWithStringId(patchEntry)) continue;
		const baseEntry = baseById.get(patchEntry.id);
		const mergedEntry = mergedById.get(patchEntry.id);
		if (!baseEntry || !mergedEntry) continue;
		paths.push(...collectDestructiveArrayPatchPaths({
			base: baseEntry,
			patch: patchEntry,
			merged: mergedEntry,
			path: `${params.path}[]`
		}));
	}
	return paths;
}
function rejectDestructiveArrayPatchWithoutIntent(params) {
	const unconfirmedPaths = collectDestructiveArrayPatchPaths({
		base: params.currentConfig,
		patch: params.patch,
		merged: params.mergedConfig
	}).filter((path) => !params.replacePaths.has(path));
	if (unconfirmedPaths.length === 0) return false;
	params.respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `config.patch would remove entries from array path(s): ${unconfirmedPaths.join(", ")}. Pass replacePaths with the exact path(s) when this is intentional, or use config.apply for full-config replacement.`));
	return true;
}
async function readConfigWriteSnapshotOrRespond(params, respond, revisionProjector) {
	const result = await readConfigFileSnapshotForWrite();
	if (!requireConfigBaseHash(params, result.snapshot, respond, revisionProjector)) return null;
	return result;
}
function hasOwnRecordValue(value, key) {
	return isRecord(value) && Object.hasOwn(value, key);
}
function stripBundledProviderRuntimeDefaults(params) {
	if (!isRecord(params.candidate)) return params.candidate;
	const models = params.candidate.models;
	if (!isRecord(models) || !isRecord(models.providers)) return params.candidate;
	const sourceModels = isRecord(params.sourceConfig) ? params.sourceConfig.models : void 0;
	const sourceProviders = isRecord(sourceModels) ? sourceModels.providers : void 0;
	let nextProviders;
	for (const [providerId, provider] of Object.entries(models.providers)) {
		if (!isBuiltInModelProviderOverlayId(providerId) || !isRecord(provider)) continue;
		const sourceProvider = isRecord(sourceProviders) ? sourceProviders[providerId] : void 0;
		let nextProvider;
		if (provider.baseUrl === "" && !hasOwnRecordValue(sourceProvider, "baseUrl")) {
			nextProvider = { ...provider };
			delete nextProvider.baseUrl;
		}
		if (Array.isArray(provider.models) && provider.models.length === 0 && !hasOwnRecordValue(sourceProvider, "models")) {
			nextProvider ??= { ...provider };
			delete nextProvider.models;
		}
		if (nextProvider) {
			nextProviders ??= { ...models.providers };
			nextProviders[providerId] = nextProvider;
		}
	}
	if (!nextProviders) return params.candidate;
	return {
		...params.candidate,
		models: {
			...models,
			providers: nextProviders
		}
	};
}
async function prepareConfigReplacementOrRespond(params, respond, revisionProjector) {
	const writeSnapshot = await readConfigWriteSnapshotOrRespond(params, respond, revisionProjector);
	if (!writeSnapshot) return null;
	const { snapshot, writeOptions } = writeSnapshot;
	const parsedRes = parseConfigJson5(params.raw);
	if (!parsedRes.ok) {
		respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, parsedRes.error));
		return null;
	}
	const schema = loadSchemaWithPlugins();
	const restored = restoreRedactedValues(parsedRes.parsed, snapshot.config, schema.uiHints);
	if (!restored.ok) {
		respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, restored.humanReadableMessage ?? "invalid config"));
		return null;
	}
	const validatedSubmission = validateSubmittedConfigOrRespond({
		candidate: stripBundledProviderRuntimeDefaults({
			candidate: snapshot.valid ? projectRuntimeChangesOntoSource(snapshot.resolved, snapshot.config, restored.result) : restored.result,
			sourceConfig: snapshot.sourceConfig
		}),
		pluginMetadataSnapshot: writeOptions.basePluginMetadataSnapshot,
		respond
	});
	if (!validatedSubmission) return null;
	return {
		writeSnapshot,
		config: validatedSubmission.config,
		writeConfig: validatedSubmission.validationCandidate,
		schema
	};
}
function listExplicitAgentRosterIds(config) {
	const roster = readAgentRosterProperty(config);
	if (roster?.kind === "entries" && isRecord(roster.value)) return Object.keys(roster.value);
	if (roster?.kind !== "list" || !Array.isArray(roster.value)) return [];
	return roster.value.flatMap((entry) => isRecord(entry) && typeof entry.id === "string" ? [entry.id] : []);
}
function rejectDroppedAgentRosterEntries(params) {
	const submittedIds = new Set(listExplicitAgentRosterIds(params.submittedConfig).map((agentId) => normalizeAgentId(agentId)));
	const droppedIds = listExplicitAgentRosterIds(params.currentConfig).filter((agentId) => !submittedIds.has(normalizeAgentId(agentId))).toSorted();
	if (droppedIds.length === 0) return false;
	params.respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `config.set would remove existing agent entries: ${droppedIds.join(", ")}. Use the agents.delete RPC or \`openclaw agents delete <id>\` for intentional deletion.`));
	return true;
}
async function ensureResolvableSecretRefsOrRespond(params) {
	try {
		const snapshot = await prepareSecretsRuntimeSnapshot({
			config: params.config,
			includeAuthStoreRefs: false,
			allowUnavailableSecretOwners: true
		});
		for (const owner of snapshot.degradedOwners ?? []) {
			const reason = redactSecretDegradationReason(owner.reason);
			if (!isRetryableSecretDegradationReason(reason)) throw new Error(reason);
		}
		return snapshot;
	} catch (error) {
		const details = formatErrorMessage(error);
		params.respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `invalid config: active SecretRef resolution failed (${details})`));
		return null;
	}
}
function preparedSecretDegradationPayload(snapshot) {
	const degradedSecretOwners = (snapshot.degradedOwners ?? []).map((owner) => ({
		ownerKind: owner.ownerKind,
		ownerId: owner.ownerId,
		state: owner.degradationState ?? "cold",
		paths: [...owner.paths],
		reason: redactSecretDegradationReason(owner.reason)
	}));
	return degradedSecretOwners.length > 0 ? { degradedSecretOwners } : {};
}
async function commitConfigRestartWrite(params) {
	const { snapshot, writeOptions } = params.writeSnapshot;
	const changedPaths = diffGatewayReloadPaths(snapshot.config, params.nextConfig, listConfigReloadRefinementPrefixes());
	params.context?.logGateway?.info(`${params.mode} write ${formatControlPlaneActor(params.actor)} changedPaths=${summarizeChangedPaths(changedPaths)} restartReason=${params.mode}`);
	const disconnectSharedAuthClients = didSharedGatewayAuthChange(snapshot.config, params.nextConfig) || didActiveSharedGatewayAuthChange({
		fallbackPrev: snapshot.config,
		fallbackSource: snapshot.sourceConfig,
		next: params.preparedSecretsSnapshot.config
	});
	const writeResult = await commitGatewayConfigWriteOrRespond({
		snapshot,
		writeOptions,
		nextConfig: params.writeConfig,
		context: params.context,
		disconnectSharedAuthClients,
		awaitRuntimeApplication: shouldAwaitGatewayConfigApplication({
			changedPaths,
			previousConfig: snapshot.config,
			nextConfig: params.nextConfig
		}),
		respond: params.respond
	});
	if (!writeResult) return;
	const persistedConfig = {
		...writeResult.hash ? { hash: params.context.configRevisionProjector.projectRawHash(writeResult.hash) } : {},
		config: redactConfigObject(writeResult.config, params.uiHints)
	};
	if (writeResult.application) {
		const outcome = await writeResult.application;
		if (outcome !== "applied") {
			const message = outcome === "applied-restart-required" ? `${params.mode} persisted and updated the active Gateway, but a recovery restart is required; wait for the Gateway to restart, then run config.get to confirm the active revision` : outcome === "restart-pending" ? `${params.mode} persisted and was accepted for restart; wait for the Gateway to restart, then run config.get to confirm the active revision` : `${params.mode} persisted but was not applied to the active Gateway (${outcome}); run config.get, then use config.apply to reapply the saved config or restart the Gateway`;
			params.respond(false, void 0, errorShape(ErrorCodes.UNAVAILABLE, message, { details: { persistedConfig } }));
			writeResult.queueFollowUp();
			return;
		}
	}
	configSchemaResponseCache = null;
	const { payload, sentinelPersisted, restart } = await resolveGatewayConfigRestartWriteResult({
		requestParams: params.requestParams,
		kind: params.mode === "config.patch" ? "config-patch" : "config-apply",
		mode: params.mode,
		configPath: writeResult.path,
		changedPaths,
		previousConfig: snapshot.config,
		nextConfig: params.nextConfig,
		actor: params.actor,
		context: params.context
	});
	params.respond(true, {
		ok: true,
		path: writeResult.path,
		...persistedConfig,
		...params.mode === "config.patch" ? { changedPaths } : {},
		...preparedSecretDegradationPayload(params.preparedSecretsSnapshot),
		restart,
		sentinel: {
			persisted: sentinelPersisted,
			payload
		}
	}, void 0);
	writeResult.queueFollowUp();
}
function loadSchemaWithPlugins() {
	const pluginRegistryVersion = getActivePluginRegistryVersion();
	if (configSchemaResponseCache && configSchemaResponseCache.pluginRegistryVersion === pluginRegistryVersion) return configSchemaResponseCache.response;
	const response = loadGatewayRuntimeConfigSchema();
	configSchemaResponseCache = {
		pluginRegistryVersion,
		response
	};
	return response;
}
async function commitGatewayConfigWriteOrRespond(params) {
	const gateway = params.context.configRevisionProjector;
	const recoveryAtStart = configWriteRecovery.get(gateway);
	try {
		const result = await commitGatewayConfigWrite(params);
		if (configWriteRecovery.get(gateway) === recoveryAtStart) configWriteRecovery.delete(gateway);
		return result;
	} catch (error) {
		if (error instanceof ConfigWritePostCommitError) {
			const outcome = errorShape(ErrorCodes.UNAVAILABLE, redactToolDetail(formatErrorMessage(error)), { details: {
				publication: error.publication,
				rollbackStatus: error.rollbackStatus,
				configPath: error.configPath,
				...error.recoveryBackupPath !== void 0 ? { recoveryBackupPath: error.recoveryBackupPath } : {}
			} });
			if (error.rollbackStatus !== "restored") {
				configWriteRecovery.set(gateway, {
					configPath: error.configPath,
					error: outcome
				});
				invalidateConfigGetResponseCache();
			}
			params.respond(false, void 0, outcome);
			return null;
		}
		if (!(error instanceof ConfigMutationConflictError)) throw error;
		if (error.retryable) invalidateConfigGetResponseCache();
		params.respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, error.retryable ? `${error.message}; re-run config.get and retry` : error.message));
		return null;
	}
}
function isHashlessPatchLwwPath(path) {
	return path === "ui.prefs" || path.startsWith("ui.prefs.");
}
function hasHashlessPatchLwwStructure(patch) {
	if (!isPlainObject(patch)) return false;
	if (!Object.hasOwn(patch, "ui")) return true;
	const ui = patch.ui;
	return isPlainObject(ui) && (!Object.hasOwn(ui, "prefs") || isPlainObject(ui.prefs));
}
function diffConfigLeafPaths(prev, next, prefix = "") {
	if (isPlainObject(prev) || isPlainObject(next)) {
		const prevRecord = isPlainObject(prev) ? prev : {};
		const nextRecord = isPlainObject(next) ? next : {};
		const keys = [.../* @__PURE__ */ new Set([...Object.keys(prevRecord), ...Object.keys(nextRecord)])];
		if (keys.length === 0) return isDeepStrictEqual(prev, next) ? [] : [prefix || "<root>"];
		return keys.flatMap((key) => diffConfigLeafPaths(prevRecord[key], nextRecord[key], prefix ? `${prefix}.${key}` : key));
	}
	return diffConfigPaths(prev, next, prefix);
}
const configHandlers = {
	"config.get": async ({ params, respond, context }) => {
		if (!assertValidParams(params, validateConfigGetParams, "config.get", respond)) return;
		const gateway = context.configRevisionProjector;
		const recoveryAtStart = configWriteRecovery.get(gateway);
		const snapshot = await readConfigGetResponse({
			getHotReloadStatus: context.getConfigReloaderHotReloadStatus,
			loadUiHints: () => loadSchemaWithPlugins().uiHints,
			revisionProjector: context.configRevisionProjector
		});
		const recovery = configWriteRecovery.get(gateway);
		if (recovery?.configPath === snapshot.path) {
			if (recovery === recoveryAtStart && snapshot.exists && snapshot.valid) configWriteRecovery.delete(gateway);
			else {
				respond(true, {
					...snapshot,
					writeError: recovery.error
				}, void 0);
				return;
			}
		}
		respond(true, snapshot, void 0);
	},
	"config.schema": ({ params, respond }) => {
		if (!assertValidParams(params, validateConfigSchemaParams, "config.schema", respond)) return;
		respond(true, loadSchemaWithPlugins(), void 0);
	},
	"config.schema.lookup": ({ params, respond, context }) => {
		if (!assertValidParams(params, validateConfigSchemaLookupParams, "config.schema.lookup", respond)) return;
		const { path } = params;
		const schema = loadSchemaWithPlugins();
		const result = lookupConfigSchema(schema, path, resolveConfigReloadMetadata);
		if (!result) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, "config schema path not found"));
			return;
		}
		if (!validateConfigSchemaLookupResult(result)) {
			const errors = validateConfigSchemaLookupResult.errors ?? [];
			context.logGateway.warn(`config.schema.lookup produced invalid payload for ${sanitizePathForLog(path)}: ${formatValidationErrors(errors)}`);
			respond(false, void 0, errorShape(ErrorCodes.UNAVAILABLE, "config.schema.lookup returned invalid payload", { details: { errors } }));
			return;
		}
		respond(true, result, void 0);
	},
	"config.set": async ({ params, respond, context }) => {
		if (!assertValidParams(params, validateConfigSetParams, "config.set", respond)) return;
		const parsed = await prepareConfigReplacementOrRespond(params, respond, context.configRevisionProjector);
		if (!parsed) return;
		const { snapshot, writeOptions } = parsed.writeSnapshot;
		if (rejectDroppedAgentRosterEntries({
			currentConfig: snapshot.config,
			submittedConfig: parsed.config,
			respond
		})) return;
		const preparedSecretsSnapshot = await ensureResolvableSecretRefsOrRespond({
			config: parsed.config,
			respond
		});
		if (!preparedSecretsSnapshot) return;
		const writeResult = await commitGatewayConfigWriteOrRespond({
			snapshot,
			writeOptions,
			nextConfig: parsed.writeConfig,
			context,
			respond
		});
		if (!writeResult) return;
		configSchemaResponseCache = null;
		respond(true, {
			ok: true,
			path: writeResult.path,
			...writeResult.hash ? { hash: context.configRevisionProjector.projectRawHash(writeResult.hash) } : {},
			config: redactConfigObject(writeResult.config, parsed.schema.uiHints),
			...preparedSecretDegradationPayload(preparedSecretsSnapshot)
		}, void 0);
		writeResult.queueFollowUp();
	},
	"config.patch": async ({ params, respond, client, context }) => {
		if (!assertValidParams(params, validateConfigPatchParams, "config.patch", respond)) return;
		const hashlessPatch = resolveBaseHashParam(params) === null;
		const writeSnapshot = hashlessPatch ? await readConfigFileSnapshotForWrite() : await readConfigWriteSnapshotOrRespond(params, respond, context.configRevisionProjector);
		if (!writeSnapshot) return;
		const { snapshot, writeOptions } = writeSnapshot;
		const modelIdNormalizationPolicies = writeOptions.basePluginMetadataSnapshot?.owners.modelIdNormalizationPolicies;
		if (!snapshot.valid) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `${summarizeConfigValidationIssues(snapshot.issues)}; fix (openclaw doctor) before patching`, { details: { issues: snapshot.issues } }));
			return;
		}
		const parsedRes = parseConfigJson5(params.raw);
		if (!parsedRes.ok) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, parsedRes.error));
			return;
		}
		if (!isRecord(parsedRes.parsed)) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, "config.patch raw must be an object"));
			return;
		}
		const normalizedPatch = normalizeSubmittedConfigModelRefs(parsedRes.parsed, modelIdNormalizationPolicies);
		if (hashlessPatch && !hasHashlessPatchLwwStructure(normalizedPatch)) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, "config base hash required; re-run config.get and retry"));
			return;
		}
		const replacePaths = normalizeConfigPatchReplacePaths(params.replacePaths);
		try {
			assertNoDuplicateConfigPatchIds({
				patch: normalizedPatch,
				current: snapshot.config,
				replacePaths
			});
		} catch (error) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, formatErrorMessage(error)));
			return;
		}
		const sourceConfig = normalizeSubmittedConfigModelRefs(snapshot.sourceConfig, modelIdNormalizationPolicies);
		const mergedSource = applyMergePatch(sourceConfig, normalizedPatch, {
			mergeObjectArraysById: true,
			replaceArrayPaths: replacePaths
		});
		const schemaPatch = loadSchemaWithPlugins();
		const restoredMerge = restoreRedactedValues(mergedSource, snapshot.config, schemaPatch.uiHints);
		if (!restoredMerge.ok) {
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, restoredMerge.humanReadableMessage ?? "invalid config"));
			return;
		}
		if (rejectDestructiveArrayPatchWithoutIntent({
			currentConfig: snapshot.config,
			mergedConfig: applyMergePatch(snapshot.config, createMergePatch(sourceConfig, restoredMerge.result)),
			patch: normalizedPatch,
			replacePaths,
			respond
		})) return;
		const restoredChangedPaths = diffConfigLeafPaths(sourceConfig, restoredMerge.result);
		if (hashlessPatch && !restoredChangedPaths.every(isHashlessPatchLwwPath)) {
			const guardedPaths = restoredChangedPaths.filter((path) => !isHashlessPatchLwwPath(path));
			respond(false, void 0, errorShape(ErrorCodes.INVALID_REQUEST, `config base hash required for ${guardedPaths.join(", ")}; re-run config.get and retry with baseHash`));
			return;
		}
		const actor = resolveControlPlaneActor(client);
		if (restoredChangedPaths.length === 0) {
			context?.logGateway?.info(`config.patch noop ${formatControlPlaneActor(actor)} (no changed paths)`);
			respond(true, {
				ok: true,
				noop: true,
				changedPaths: [],
				path: resolveGatewayConfigPath(snapshot),
				config: redactConfigObject(snapshot.config, schemaPatch.uiHints)
			}, void 0);
			return;
		}
		const validatedSubmission = validateSubmittedConfigOrRespond({
			candidate: restoredMerge.result,
			pluginMetadataSnapshot: writeOptions.basePluginMetadataSnapshot,
			respond
		});
		if (!validatedSubmission) return;
		const writeConfig = validatedSubmission.validationCandidate;
		const validatedConfig = validatedSubmission.config;
		const preparedSecretsSnapshot = await ensureResolvableSecretRefsOrRespond({
			config: validatedConfig,
			respond
		});
		if (!preparedSecretsSnapshot) return;
		await commitConfigRestartWrite({
			requestParams: params,
			mode: "config.patch",
			writeSnapshot,
			writeConfig,
			nextConfig: validatedConfig,
			actor,
			context,
			respond,
			uiHints: schemaPatch.uiHints,
			preparedSecretsSnapshot
		});
	},
	"config.apply": async ({ params, respond, client, context }) => {
		if (!assertValidParams(params, validateConfigApplyParams, "config.apply", respond)) return;
		const parsed = await prepareConfigReplacementOrRespond(params, respond, context.configRevisionProjector);
		if (!parsed) return;
		const preparedSecretsSnapshot = await ensureResolvableSecretRefsOrRespond({
			config: parsed.config,
			respond
		});
		if (!preparedSecretsSnapshot) return;
		const actor = resolveControlPlaneActor(client);
		await commitConfigRestartWrite({
			requestParams: params,
			mode: "config.apply",
			writeSnapshot: parsed.writeSnapshot,
			writeConfig: parsed.writeConfig,
			nextConfig: parsed.config,
			actor,
			context,
			respond,
			uiHints: parsed.schema.uiHints,
			preparedSecretsSnapshot
		});
	},
	"config.openFile": async ({ params, respond, context }) => {
		if (!assertValidParams(params, validateConfigGetParams, "config.openFile", respond)) return;
		const configPath = createConfigIO().configPath;
		const command = resolveOpenPathCommand(configPath);
		try {
			await execOpenPath(command);
			respond(true, {
				ok: true,
				path: configPath
			}, void 0);
		} catch (error) {
			const errorMessage = formatOpenPathError(error);
			const detailedError = isHeadlessOpenPathError(error, command) ? `Cannot open file in headless environment. File path: ${configPath}. This environment appears to lack a graphical or terminal browser handler.` : `Failed to open config file: ${errorMessage}`;
			context?.logGateway?.warn(`config.openFile failed path=${sanitizePathForLog(configPath)}: ${errorMessage}`);
			respond(true, {
				ok: false,
				path: configPath,
				error: detailedError
			}, void 0);
		}
	}
};
//#endregion
export { configHandlers };