@openclaw/facetime 2026.9.6 → 2026.9.7

package/dist/.setup/{setup-DUgC9yE7.mjs → setup-CoxvlB5L.mjs}

@@ -218,67 +218,117 @@ async function ensureHelperArtifacts(params) {
 const XCODE_APP = "/Applications/Xcode.app";
 const XCODE_CLANG = `${XCODE_APP}/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/clang`;
 const XCODE_MACOS_SDK = `${XCODE_APP}/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk`;
-const NATIVE_PACKAGE_ACTION = {
-	id: "install-native-package",
-	kind: "command",
-	label: "Install or reinstall the FaceTime native package with Homebrew",
-	command: "if brew list --versions openclaw-facetime >/dev/null 2>&1; then brew reinstall openclaw/tap/openclaw-facetime; else brew install openclaw/tap/openclaw-facetime; fi"
-};
-const PRECHECK_ACTIONS = {
-	"capture-binary": {
-		id: NATIVE_PACKAGE_ACTION.id,
+const SETUP_ACTIONS = {
+	"install-native-package": {
 		kind: "command",
-		label: NATIVE_PACKAGE_ACTION.label,
-		command: NATIVE_PACKAGE_ACTION.command
+		label: "Install or reinstall the FaceTime native package with Homebrew",
+		command: "if brew list --versions openclaw-facetime >/dev/null 2>&1; then brew reinstall openclaw/tap/openclaw-facetime; else brew install openclaw/tap/openclaw-facetime; fi"
 	},
-	"paired-driver-mic": {
-		id: "install-driver",
-		kind: "gateway",
-		label: "Install or update the paired FaceTime audio driver",
-		gatewayMethod: "facetime.installDriver"
+	"install-xcode-tools": {
+		kind: "command",
+		label: "Install full Xcode in /Applications",
+		command: "open 'https://apps.apple.com/us/app/xcode/id497799835'"
+	},
+	"enable-developer-tools": {
+		kind: "command",
+		label: "Enable developer tools access",
+		command: "sudo /usr/sbin/DevToolsSecurity -enable"
+	},
+	"disable-sip-debugging": {
+		kind: "recovery",
+		label: "Disable SIP debugging restrictions from macOS Recovery, then reboot and rerun setup",
+		command: "csrutil enable --without debug",
+		settingsPath: "macOS Recovery > Utilities > Terminal"
+	},
+	"verify-sip-status": {
+		kind: "command",
+		label: "Verify SIP status, then rerun setup",
+		command: "/usr/bin/csrutil status"
+	},
+	"configure-owner-handles": {
+		kind: "command",
+		label: "Configure ownerHandles",
+		command: "openclaw configure"
+	},
+	"restart-gateway": {
+		kind: "command",
+		label: "Stop the stale gateway process, then restart OpenClaw",
+		command: "openclaw gateway restart"
+	},
+	"wait-for-helper": {
+		kind: "automatic",
+		label: "Wait for automatic helper injection to finish"
 	},
-	"paired-driver-feed": {
-		id: "install-driver",
+	"restart-call-apps": {
+		kind: "manual-test",
+		label: "Quit and reopen FaceTime and Phone, then let OpenClaw reinject the helper"
+	},
+	"install-driver": {
 		kind: "gateway",
 		label: "Install or update the paired FaceTime audio driver",
 		gatewayMethod: "facetime.installDriver"
 	},
-	"physical-output": {
-		id: "select-physical-output",
+	"select-physical-output": {
 		kind: "system-settings",
 		label: "Select MacBook Speakers or another physical output",
 		settingsPath: "System Settings > Sound > Output"
 	},
-	"process-tap": {
-		id: "grant-system-audio",
+	"grant-system-audio": {
 		kind: "system-settings",
 		label: "Allow OpenClaw to capture FaceTime app audio",
 		settingsPath: "System Settings > Privacy & Security > Screen & System Audio Recording"
 	},
-	"realtime-provider": {
-		id: "configure-realtime-provider",
+	"configure-realtime-provider": {
 		kind: "command",
 		label: "Configure authentication for a registered realtime voice provider",
 		command: "openclaw configure"
+	},
+	"verify-focus": {
+		kind: "system-settings",
+		label: "Verify Focus is off or allows the expected caller",
+		settingsPath: "Control Center > Focus"
+	},
+	"allow-sharing-notifications": {
+		kind: "system-settings",
+		label: "Allow notifications while mirroring or sharing the display",
+		settingsPath: "System Settings > Notifications"
+	},
+	"live-outbound-test": {
+		kind: "manual-test",
+		label: "Place one outbound FaceTime audio call with facetime.dial",
+		gatewayMethod: "facetime.dial"
+	},
+	"live-audio-test": {
+		kind: "manual-test",
+		label: "Run one inbound and one outbound FaceTime audio call"
+	},
+	"review-live-voicemail": {
+		kind: "system-settings",
+		label: "Review Live Voicemail if inbound audio calls are screened",
+		settingsPath: "Phone > Settings > Live Voicemail"
 	}
 };
+const PRECHECK_ACTIONS = {
+	"capture-binary": "install-native-package",
+	"paired-driver-mic": "install-driver",
+	"paired-driver-feed": "install-driver",
+	"physical-output": "select-physical-output",
+	"process-tap": "grant-system-audio",
+	"realtime-provider": "configure-realtime-provider"
+};
 function firstLine(value) {
 	return typeof value === "string" ? value.trim().split(/\r?\n/u)[0] || void 0 : void 0;
 }
-function addAction(actions, action) {
-	if (!actions.some((candidate) => candidate.id === action.id)) actions.push(action);
-}
-function addPreflightCheck(checks, actions, check) {
+function addPreflightCheck(checks, check) {
 	if (check.id === "call-app-running") return;
-	const action = PRECHECK_ACTIONS[check.id];
-	if (!check.ok && action) addAction(actions, action);
+	const actionId = PRECHECK_ACTIONS[check.id];
 	checks.push({
 		id: check.id,
 		label: check.label,
 		status: check.ok ? "ready" : check.required ? "action-required" : "recommended",
 		required: check.required,
 		message: check.message ?? (check.ok ? "ready" : "not ready"),
-		...!check.ok && action ? { actionId: action.id } : {}
+		...!check.ok && actionId ? { actionId } : {}
 	});
 }
 function hasActiveFocusAssertion(raw) {
@@ -379,7 +429,6 @@ async function inspectDriver(params) {
 }
 async function runFaceTimeSetup(params) {
 	const checks = [];
-	const actions = [];
 	const [xcodeCompiler, xcodeSdk] = await Promise.all([checkCommand(params.runCommandWithTimeout, [
 		"/bin/test",
 		"-x",
@@ -400,12 +449,6 @@ async function runFaceTimeSetup(params) {
 		message: xcodeReady ? `Full Xcode compiler and macOS SDK are available at ${XCODE_APP}` : `Full Xcode is required at ${XCODE_APP}; Command Line Tools alone cannot perform protected-app injection or build the local audio driver`,
 		...!xcodeReady ? { actionId: "install-xcode-tools" } : {}
 	});
-	if (!xcodeReady) addAction(actions, {
-		id: "install-xcode-tools",
-		kind: "command",
-		label: "Install full Xcode in /Applications",
-		command: "open 'https://apps.apple.com/us/app/xcode/id497799835'"
-	});
 	const developerSecurity = await checkCommand(params.runCommandWithTimeout, ["/usr/sbin/DevToolsSecurity", "-status"], (stdout) => firstLine(stdout) ?? "Developer tools access enabled");
 	const developerSecurityEnabled = developerSecurity.ok && /enabled/iu.test(developerSecurity.message);
 	checks.push({
@@ -416,12 +459,6 @@ async function runFaceTimeSetup(params) {
 		message: developerSecurityEnabled ? developerSecurity.message : "Developer tools access is disabled; helper injection cannot attach to FaceTime or Phone",
 		...!developerSecurityEnabled ? { actionId: "enable-developer-tools" } : {}
 	});
-	if (!developerSecurityEnabled) addAction(actions, {
-		id: "enable-developer-tools",
-		kind: "command",
-		label: "Enable developer tools access",
-		command: "sudo /usr/sbin/DevToolsSecurity -enable"
-	});
 	const sip = await checkCommand(params.runCommandWithTimeout, ["/usr/bin/csrutil", "status"], (stdout) => stdout.trim());
 	const debuggingRestrictionsDisabled = sip.ok && /^[\t ]*(?:System Integrity Protection status:|Debugging Restrictions:)[\t ]*disabled\.?[\t ]*\r?$/imu.test(sip.message);
 	const debuggingRestrictionsEnabled = sip.ok && /^[\t ]*(?:System Integrity Protection status:|Debugging Restrictions:)[\t ]*enabled\.?[\t ]*\r?$/imu.test(sip.message);
@@ -434,19 +471,6 @@ async function runFaceTimeSetup(params) {
 		message: debuggingRestrictionsDisabled ? "SIP permits debugger attachment to FaceTime and Phone; a connected helper must still be verified separately" : debuggingRestrictionsEnabled ? "SIP debugging restrictions block LLDB helper injection into protected Apple apps" : "Could not verify SIP debugging restrictions; run csrutil status before changing protection settings",
 		...!debuggingRestrictionsDisabled ? { actionId: sipActionId } : {}
 	});
-	if (!debuggingRestrictionsDisabled && debuggingRestrictionsEnabled) addAction(actions, {
-		id: "disable-sip-debugging",
-		kind: "recovery",
-		label: "Disable SIP debugging restrictions from macOS Recovery, then reboot and rerun setup",
-		command: "csrutil enable --without debug",
-		settingsPath: "macOS Recovery > Utilities > Terminal"
-	});
-	else if (!debuggingRestrictionsDisabled) addAction(actions, {
-		id: "verify-sip-status",
-		kind: "command",
-		label: "Verify SIP status, then rerun setup",
-		command: "/usr/bin/csrutil status"
-	});
 	checks.push({
 		id: "owner-handles",
 		label: "Owner FaceTime handles",
@@ -455,21 +479,14 @@ async function runFaceTimeSetup(params) {
 		message: params.config.ownerHandles.length > 0 ? `${params.config.ownerHandles.length} owner handle${params.config.ownerHandles.length === 1 ? "" : "s"} configured` : "Configure at least one owner email address or phone number",
 		...params.config.ownerHandles.length === 0 ? { actionId: "configure-owner-handles" } : {}
 	});
-	if (params.config.ownerHandles.length === 0) addAction(actions, {
-		id: "configure-owner-handles",
-		kind: "command",
-		label: "Configure ownerHandles",
-		command: "openclaw configure"
-	});
 	checks.push({
 		id: "native-package",
 		label: "FaceTime native package",
 		status: params.nativePackageReady ? "ready" : "action-required",
 		required: true,
 		message: params.nativePackageReady ? "Compatible FaceTime capture and helper artifacts are installed" : "Compatible FaceTime native helpers are not installed",
-		...!params.nativePackageReady ? { actionId: NATIVE_PACKAGE_ACTION.id } : {}
+		...!params.nativePackageReady ? { actionId: "install-native-package" } : {}
 	});
-	if (!params.nativePackageReady) addAction(actions, NATIVE_PACKAGE_ACTION);
 	const runtimeStatus = params.nativePackageReady && params.runtimeStatus ? await params.runtimeStatus : void 0;
 	checks.push({
 		id: "runtime",
@@ -477,13 +494,7 @@ async function runFaceTimeSetup(params) {
 		status: runtimeStatus ? "ready" : "action-required",
 		required: true,
 		message: runtimeStatus ? "Runtime activated on the local UID-derived helper endpoint" : params.runtimeError ?? "FaceTime runtime is not running",
-		...!runtimeStatus ? { actionId: params.nativePackageReady ? "restart-gateway" : NATIVE_PACKAGE_ACTION.id } : {}
-	});
-	if (!runtimeStatus && params.nativePackageReady) addAction(actions, {
-		id: "restart-gateway",
-		kind: "command",
-		label: "Stop the stale gateway process, then restart OpenClaw",
-		command: "openclaw gateway restart"
+		...!runtimeStatus ? { actionId: params.nativePackageReady ? "restart-gateway" : "install-native-package" } : {}
 	});
 	if (runtimeStatus) for (const target of runtimeStatus.helperTargets) {
 		const status = target.connected ? "ready" : target.stale ? "action-required" : target.injecting || target.queued || target.retryScheduled ? "repairing" : "action-required";
@@ -495,16 +506,6 @@ async function runFaceTimeSetup(params) {
 			message: target.connected ? "Authenticated helper connected" : target.stale ? `Restart ${target.target} so it can load the current helper` : status === "repairing" && target.lastError ? `Automatic retry scheduled after: ${target.lastError}` : target.lastError ? target.lastError : "OpenClaw is launching the app and injecting the helper",
 			...status === "repairing" ? { actionId: "wait-for-helper" } : status === "action-required" ? { actionId: "restart-call-apps" } : {}
 		});
-		if (status === "repairing") addAction(actions, {
-			id: "wait-for-helper",
-			kind: "automatic",
-			label: "Wait for automatic helper injection to finish"
-		});
-		else if (status === "action-required") addAction(actions, {
-			id: "restart-call-apps",
-			kind: "manual-test",
-			label: "Quit and reopen FaceTime and Phone, then let OpenClaw reinject the helper"
-		});
 	}
 	const driver = params.nativePackageReady ? await inspectDriver(params) : {};
 	const driverReady = driver.status === "current";
@@ -514,37 +515,17 @@ async function runFaceTimeSetup(params) {
 		status: driverReady ? "ready" : "action-required",
 		required: true,
 		message: driverReady ? "OpenClaw-Mic and OpenClaw-Feed driver is current" : !params.nativePackageReady ? "Install the FaceTime native package before setting up the audio driver" : driver.error ? `Could not inspect driver: ${driver.error}` : `Driver status: ${driver.status ?? "unknown"}`,
-		...!driverReady ? { actionId: params.nativePackageReady ? "install-driver" : NATIVE_PACKAGE_ACTION.id } : {}
-	});
-	if (!driverReady && params.nativePackageReady) addAction(actions, {
-		id: "install-driver",
-		kind: "gateway",
-		label: "Install or update the paired FaceTime audio driver",
-		gatewayMethod: "facetime.installDriver"
+		...!driverReady ? { actionId: params.nativePackageReady ? "install-driver" : "install-native-package" } : {}
 	});
 	if (params.preflight) {
 		const preflight = await params.preflight;
 		for (const check of preflight.checks) {
 			if (check.id === "helper-connected" && runtimeStatus?.helperTargets.length) continue;
-			addPreflightCheck(checks, actions, check);
+			addPreflightCheck(checks, check);
 		}
 	}
-	const focus = await checkFocusMode(params);
-	checks.push(focus);
-	if (focus.status === "verify-on-call") addAction(actions, {
-		id: "verify-focus",
-		kind: "system-settings",
-		label: "Verify Focus is off or allows the expected caller",
-		settingsPath: "Control Center > Focus"
-	});
-	const sharingNotifications = await checkNotificationsDuringSharing(params.runCommandWithTimeout);
-	checks.push(sharingNotifications);
-	if (sharingNotifications.status === "action-required") addAction(actions, {
-		id: "allow-sharing-notifications",
-		kind: "system-settings",
-		label: "Allow notifications while mirroring or sharing the display",
-		settingsPath: "System Settings > Notifications"
-	});
+	checks.push(await checkFocusMode(params));
+	checks.push(await checkNotificationsDuringSharing(params.runCommandWithTimeout));
 	checks.push({
 		id: "facetime-sign-in",
 		label: "FaceTime account",
@@ -553,12 +534,6 @@ async function runFaceTimeSetup(params) {
 		message: "macOS does not expose a supported sign-in readiness API; verify with one outbound call",
 		actionId: "live-outbound-test"
 	});
-	addAction(actions, {
-		id: "live-outbound-test",
-		kind: "manual-test",
-		label: "Place one outbound FaceTime audio call with facetime.dial",
-		gatewayMethod: "facetime.dial"
-	});
 	const internalMediaStage = runtimeStatus?.calls.find((call) => call.audioReady && call.realtimeActive && call.audioTransport?.processInputVerified === true && call.audioTransport.processOutputSuppressed);
 	checks.push({
 		id: "internal-media-stage",
@@ -568,11 +543,6 @@ async function runFaceTimeSetup(params) {
 		message: internalMediaStage ? "Process capture, model session, SoX playback, and local suppression reached the internal media stage; remote audibility is not proven" : "Internal media stages require an active call; remote audibility still needs a separate live check",
 		...!internalMediaStage ? { actionId: "live-audio-test" } : {}
 	});
-	if (!internalMediaStage) addAction(actions, {
-		id: "live-audio-test",
-		kind: "manual-test",
-		label: "Run one inbound and one outbound FaceTime audio call"
-	});
 	checks.push({
 		id: "live-voicemail",
 		label: "Live Voicemail call screening",
@@ -581,20 +551,13 @@ async function runFaceTimeSetup(params) {
 		message: "If incoming FaceTime Audio rings are intercepted, turn off Live Voicemail on this unattended Mac",
 		actionId: "review-live-voicemail"
 	});
-	addAction(actions, {
-		id: "review-live-voicemail",
-		kind: "system-settings",
-		label: "Review Live Voicemail if inbound audio calls are screened",
-		settingsPath: "Phone > Settings > Live Voicemail"
-	});
-	const requiredReady = checks.every((check) => !check.required || check.status === "ready" || check.status === "repairing");
-	const repairsPending = checks.some((check) => check.required && check.status === "repairing");
+	const ready = checks.every((check) => !check.required || check.status === "ready");
 	return {
-		ok: requiredReady && !repairsPending,
-		readyForTest: requiredReady && !repairsPending,
+		ok: ready,
+		readyForTest: ready,
 		liveCallProofRequired: true,
 		checks,
-		actions
+		actions: [...new Set(checks.flatMap((check) => check.actionId ? [check.actionId] : []))].map((id) => Object.assign({ id }, SETUP_ACTIONS[id]))
 	};
 }
 //#endregion

package/dist/doctor-contract-api.js

@@ -1,5 +1,187 @@
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
-import { asObjectRecord } from "openclaw/plugin-sdk/runtime-doctor-migrations";
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+//#endregion
+//#region packages/normalization-core/src/record-coerce.ts
+/** Type guard for non-array object records at browser-safe boundaries. */
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Returns a non-array record or null. */
+function asNullableRecord(value) {
+	return isRecord(value) ? value : null;
+}
+//#endregion
+//#region src/config/channel-config-normalization.ts
+/** Applies one channel-specific doctor migration to every object-shaped account. */
+function normalizeChannelAccounts(params) {
+	const rawAccounts = asNullableRecord(params.entry.accounts);
+	if (!rawAccounts) return {
+		entry: params.entry,
+		changed: false
+	};
+	let changed = false;
+	const accounts = { ...rawAccounts };
+	for (const [accountId, value] of Object.entries(rawAccounts)) {
+		const account = asNullableRecord(value);
+		if (!account) continue;
+		const normalized = params.normalizeAccount({
+			account,
+			accountId,
+			pathPrefix: `${params.pathPrefix}.accounts.${accountId}`,
+			changes: params.changes
+		});
+		if (normalized.changed) {
+			accounts[accountId] = normalized.entry;
+			changed = true;
+		}
+	}
+	return changed ? {
+		entry: {
+			...params.entry,
+			accounts
+		},
+		changed: true
+	} : {
+		entry: params.entry,
+		changed: false
+	};
+}
+/** Applies the same channel-specific doctor migration at root and account scope. */
+function normalizeChannelConfigEntries(params) {
+	const changes = params.changes ?? [];
+	const channels = params.cfg.channels;
+	const entry = asNullableRecord(channels?.[params.channelId]);
+	if (!entry) return {
+		config: params.cfg,
+		changes
+	};
+	const channelPath = `channels.${params.channelId}`;
+	const root = params.normalizeEntry({
+		entry,
+		pathPrefix: channelPath,
+		changes
+	});
+	const accounts = normalizeChannelAccounts({
+		entry: root.entry,
+		pathPrefix: channelPath,
+		changes,
+		normalizeAccount: (accountParams) => params.normalizeEntry({
+			entry: accountParams.account,
+			accountId: accountParams.accountId,
+			pathPrefix: accountParams.pathPrefix,
+			changes: accountParams.changes
+		})
+	});
+	if (!root.changed && !accounts.changed) return {
+		config: params.cfg,
+		changes
+	};
+	return {
+		config: {
+			...params.cfg,
+			channels: {
+				...channels,
+				[params.channelId]: accounts.entry
+			}
+		},
+		changes
+	};
+}
+//#endregion
+//#region src/plugin-sdk/legacy-webhook-listener-migration.ts
+/** Preserve explicitly configured webhook listeners while moving ingress onto Gateway routes. */
+function createLegacyWebhookListenerDoctorContract(params) {
+	const portKey = params.portKey ?? "webhookPort";
+	const hostKey = params.hostKey === void 0 ? "webhookHost" : params.hostKey;
+	const source = (entry) => params.webhookKey ? asNullableRecord(entry[params.webhookKey]) : entry;
+	const hasLegacy = (value) => {
+		const entry = asNullableRecord(value);
+		const listener = entry && source(entry);
+		return Boolean(listener && (Object.hasOwn(listener, portKey) || hostKey && Object.hasOwn(listener, hostKey)));
+	};
+	const prefix = `channels.${params.channelKey}`;
+	return {
+		legacyConfigRules: [{
+			path: ["channels", params.channelKey],
+			message: `${prefix} webhook listeners moved to Gateway routes. Run "openclaw doctor --fix" to preserve explicitly configured listener settings as legacyWebhook.`,
+			match: (value) => {
+				const accounts = asNullableRecord(asNullableRecord(value)?.accounts);
+				return hasLegacy(value) || Object.values(accounts ?? {}).some(hasLegacy);
+			}
+		}],
+		normalizeCompatibilityConfig: ({ cfg }) => {
+			const root = asNullableRecord(asNullableRecord(cfg.channels)?.[params.channelKey]);
+			const inherited = root && source(root);
+			const canonicalRoot = asNullableRecord(root?.legacyWebhook);
+			return normalizeChannelConfigEntries({
+				cfg,
+				channelId: params.channelKey,
+				normalizeEntry: ({ entry, accountId, pathPrefix, changes }) => {
+					const listener = source(entry);
+					if (!listener || !hasLegacy(entry)) return {
+						entry,
+						changed: false
+					};
+					const next = { ...entry };
+					const port = Object.hasOwn(listener, portKey) ? listener[portKey] : (accountId ? canonicalRoot?.port ?? inherited?.[portKey] : void 0) ?? params.defaultPort;
+					const inheritedHost = accountId ? canonicalRoot ? canonicalRoot.host : (hostKey ? inherited?.[hostKey] : void 0) ?? params.defaultHost : params.defaultHost;
+					const host = hostKey ? listener[hostKey] ?? inheritedHost : inheritedHost;
+					const legacyPath = [pathPrefix, params.webhookKey].filter(Boolean).join(".");
+					if (Object.hasOwn(entry, "legacyWebhook")) changes.push(`Removed ${legacyPath} legacy listener keys; ${pathPrefix}.legacyWebhook is already configured.`);
+					else if (accountId && root?.legacyWebhook === false) changes.push(`Removed ${legacyPath} legacy listener keys; ${prefix}.legacyWebhook: false keeps this account's inherited listener disabled.`);
+					else {
+						next.legacyWebhook = {
+							port,
+							...host !== void 0 ? { host } : {}
+						};
+						changes.push(`Moved ${legacyPath} listener settings to ${pathPrefix}.legacyWebhook. Point the external callback or reverse proxy at the Gateway port and webhook path, verify delivery, then set legacyWebhook: false to disable legacy forwarding.`);
+					}
+					const updated = params.webhookKey ? { ...listener } : next;
+					delete updated[portKey];
+					if (hostKey) delete updated[hostKey];
+					if (params.webhookKey) {
+						if (Object.keys(updated).length) next[params.webhookKey] = updated;
+						else delete next[params.webhookKey];
+					}
+					return {
+						entry: next,
+						changed: true
+					};
+				}
+			});
+		}
+	};
+}
+//#endregion
+//#region \0openclaw:bundled-sdk:openclaw/plugin-sdk/runtime-doctor-migrations
+var runtime_doctor_migrations_exports = /* @__PURE__ */ __exportAll({ createLegacyWebhookListenerDoctorContract: () => createLegacyWebhookListenerDoctorContract });
+import * as import_openclaw_plugin_sdk_runtime_doctor_migrations from "openclaw/plugin-sdk/runtime-doctor-migrations";
+__reExport(runtime_doctor_migrations_exports, import_openclaw_plugin_sdk_runtime_doctor_migrations);
+//#endregion
 //#region extensions/facetime/doctor-contract-api.ts
 const CONFIG_PATH = [
 	"plugins",
@@ -32,23 +214,23 @@ function normalizeLegacyOwnerHandles(value) {
 }
 /** Moves or removes retired prototype keys so runtime sees only the canonical config shape. */
 function normalizeCompatibilityConfig({ cfg }) {
-	const entry = asObjectRecord(cfg.plugins?.entries?.facetime);
-	const pluginConfig = asObjectRecord(entry?.config);
+	const entry = (0, runtime_doctor_migrations_exports.asObjectRecord)(cfg.plugins?.entries?.facetime);
+	const pluginConfig = (0, runtime_doctor_migrations_exports.asObjectRecord)(entry?.config);
 	if (!pluginConfig) return {
 		config: cfg,
 		changes: []
 	};
 	const hasLegacyOwnerHandles = Object.hasOwn(pluginConfig, "whitelistHandles");
 	const retiredKeys = RETIRED_CONFIG_KEYS.filter((key) => Object.hasOwn(pluginConfig, key));
-	const realtime = asObjectRecord(pluginConfig.realtime);
+	const realtime = (0, runtime_doctor_migrations_exports.asObjectRecord)(pluginConfig.realtime);
 	const hasRetiredBrain = Boolean(realtime && Object.hasOwn(realtime, "brain"));
 	if (!hasLegacyOwnerHandles && retiredKeys.length === 0 && !hasRetiredBrain) return {
 		config: cfg,
 		changes: []
 	};
 	const nextConfig = structuredClone(cfg);
-	const nextEntry = asObjectRecord(nextConfig.plugins?.entries?.facetime);
-	const nextPluginConfig = asObjectRecord(nextEntry?.config);
+	const nextEntry = (0, runtime_doctor_migrations_exports.asObjectRecord)(nextConfig.plugins?.entries?.facetime);
+	const nextPluginConfig = (0, runtime_doctor_migrations_exports.asObjectRecord)(nextEntry?.config);
 	if (!nextPluginConfig) return {
 		config: cfg,
 		changes: []
@@ -71,7 +253,7 @@ function normalizeCompatibilityConfig({ cfg }) {
 		delete nextPluginConfig[key];
 		changes.push(`Removed retired ${[...CONFIG_PATH, key].join(".")}.`);
 	}
-	const nextRealtime = asObjectRecord(nextPluginConfig.realtime);
+	const nextRealtime = (0, runtime_doctor_migrations_exports.asObjectRecord)(nextPluginConfig.realtime);
 	if (hasRetiredBrain && nextRealtime) {
 		delete nextRealtime.brain;
 		changes.push(`Removed retired ${[

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as inspectFaceTimeNativePackage, c as uninstallFaceTimeDriver, i as inspectFaceTimeArtifacts, l as resolveFaceTimeConfig, o as inspectFaceTimeDriver, t as runFaceTimeSetup, u as validateFaceTimeConfig } from "./.setup/setup-DUgC9yE7.mjs";
+import { a as inspectFaceTimeNativePackage, c as uninstallFaceTimeDriver, i as inspectFaceTimeArtifacts, l as resolveFaceTimeConfig, o as inspectFaceTimeDriver, t as runFaceTimeSetup, u as validateFaceTimeConfig } from "./.setup/setup-CoxvlB5L.mjs";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { ErrorCodes, errorShape } from "openclaw/plugin-sdk/gateway-runtime";
 import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";