@openclaw/discord 2026.7.2-beta.7 → 2026.7.34

package/dist/.setup/manager.runtime-CSLNIAh-.mjs

@@ -0,0 +1,3269 @@
+import { E as isUnknownDiscordVoiceStateError, Ft as getGuildVoiceState, Kt as parseDiscordTarget, _ as ReadyListener, b as VoiceStateUpdateListener, d as discord_exports, v as ResumedListener } from "./send.receipt-BWF_jBih.mjs";
+import { c as resolveDiscordAccountAllowFrom } from "./accounts-CetktX10.mjs";
+import { a as normalizeDiscordSlug, b as formatDiscordUserTag, m as resolveDiscordOwnerAccess } from "./allow-list-aF0WK_xB.mjs";
+import { a as formatMention } from "./send.outbound-C9AU-oWi.mjs";
+import { t as getDiscordRuntime } from "./runtime-DgnVQ7zW.mjs";
+import { c as authorizeDiscordVoiceIngress, f as resolveDiscordVoiceEnabled, m as buildDiscordGroupSystemPrompt } from "./provider-jQ_M-zQG.mjs";
+import { createRequire } from "node:module";
+import { asBoolean, normalizeOptionalString, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { resolveAgentRoute } from "openclaw/plugin-sdk/routing";
+import { asDateTimestampMs, resolveExpiresAtMsFromDurationMs } from "openclaw/plugin-sdk/number-runtime";
+import path from "node:path";
+import { resolveFfmpegBin } from "openclaw/plugin-sdk/media-runtime";
+import { createSubsystemLogger, logVerbose, shouldLogVerbose } from "openclaw/plugin-sdk/runtime-env";
+import { escapeRegExp, truncateUtf16Safe } from "openclaw/plugin-sdk/text-utility-runtime";
+import { stripInlineDirectiveTagsForDisplay } from "openclaw/plugin-sdk/text-chunking";
+import fs from "node:fs/promises";
+import { resolvePreferredOpenClawTmpDir, tempWorkspace } from "openclaw/plugin-sdk/temp-path";
+import { formatErrorMessage } from "openclaw/plugin-sdk/ssrf-runtime";
+import { REALTIME_VOICE_AGENT_CONSULT_TOOL_NAME, REALTIME_VOICE_AGENT_CONTROL_TOOL, REALTIME_VOICE_AGENT_CONTROL_TOOL_NAME, REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ, buildRealtimeVoiceAgentConsultChatMessage, buildRealtimeVoiceAgentConsultPolicyInstructions, classifySkippableRealtimeVoiceConsultTranscript, controlRealtimeVoiceAgentRun, createRealtimeVoiceAgentTalkbackQueue, createRealtimeVoiceBridgeSession, createRealtimeVoiceForcedConsultCoordinator, createRealtimeVoiceOutputActivityTracker, createRealtimeVoiceTurnContextTracker, matchRealtimeVoiceActivationName, matchRealtimeVoiceConsultQuestions, normalizeSupportedRealtimeVoiceActivationName, parseRealtimeVoiceAgentControlToolArgs, resamplePcm, resolveConfiguredRealtimeVoiceProvider, resolveRealtimeVoiceAgentConsultToolPolicy, resolveRealtimeVoiceAgentConsultTools, resolveRealtimeVoiceAgentConsultToolsAllow, shouldAutoControlRealtimeVoiceAgentText, sortRealtimeVoiceActivationNames } from "openclaw/plugin-sdk/realtime-voice";
+import { agentCommandFromIngress, getTtsProvider, resolveAgentDir, resolveTtsConfig, resolveTtsPrefsPath } from "openclaw/plugin-sdk/agent-runtime";
+import { spawn } from "node:child_process";
+import { PassThrough, Readable, Transform, pipeline } from "node:stream";
+import { StringDecoder } from "node:string_decoder";
+import { Application, OpusError, createDecoder, createEncoder } from "libopus-wasm";
+import { resolveRealtimeBootstrapContextInstructions } from "openclaw/plugin-sdk/realtime-bootstrap-context";
+import { parseTtsDirectives } from "openclaw/plugin-sdk/speech";
+//#region extensions/discord/src/voice/audio.ts
+const SAMPLE_RATE = 48e3;
+const CHANNELS = 2;
+const BIT_DEPTH = 16;
+const FFMPEG_ERROR_OUTPUT_BYTES = 8192;
+const DISCORD_OPUS_FRAME_SIZE = 960;
+const DISCORD_OPUS_FRAME_BYTES = DISCORD_OPUS_FRAME_SIZE * CHANNELS * (BIT_DEPTH / 8);
+const FFMPEG_PCM_ARGUMENTS = [
+	"-analyzeduration",
+	"0",
+	"-loglevel",
+	"error",
+	"-vn",
+	"-sn",
+	"-dn",
+	"-f",
+	"s16le",
+	"-ar",
+	String(SAMPLE_RATE),
+	"-ac",
+	String(CHANNELS)
+];
+let warnedOpusMissing = false;
+function buildWavBuffer(pcm) {
+	const blockAlign = 4;
+	const byteRate = SAMPLE_RATE * blockAlign;
+	const header = Buffer.alloc(44);
+	header.write("RIFF", 0);
+	header.writeUInt32LE(36 + pcm.length, 4);
+	header.write("WAVE", 8);
+	header.write("fmt ", 12);
+	header.writeUInt32LE(16, 16);
+	header.writeUInt16LE(1, 20);
+	header.writeUInt16LE(CHANNELS, 22);
+	header.writeUInt32LE(SAMPLE_RATE, 24);
+	header.writeUInt32LE(byteRate, 28);
+	header.writeUInt16LE(blockAlign, 32);
+	header.writeUInt16LE(BIT_DEPTH, 34);
+	header.write("data", 36);
+	header.writeUInt32LE(pcm.length, 40);
+	return Buffer.concat([header, pcm]);
+}
+async function createOpusDecoder(params) {
+	let decoder;
+	try {
+		decoder = await createDecoder({
+			channels: CHANNELS,
+			sampleRate: SAMPLE_RATE
+		});
+	} catch (err) {
+		const failure = formatErrorMessage(err);
+		if (!warnedOpusMissing) {
+			warnedOpusMissing = true;
+			params.onWarn(`discord voice: no usable opus decoder available (libopus-wasm: ${failure}); cannot decode voice audio`);
+		}
+		return null;
+	}
+	return {
+		name: "libopus-wasm",
+		decoder: {
+			decode: (buffer) => pcmInt16ToBuffer(decoder.decode(buffer, { maxFrameSize: DISCORD_OPUS_FRAME_SIZE })),
+			free: () => decoder.free()
+		}
+	};
+}
+function createDiscordOpusEncodeStream() {
+	return new DiscordOpusEncodeStream();
+}
+function createDiscordOpusPlaybackStream(input) {
+	const inputSource = typeof input === "string" ? input : "pipe:0";
+	const ffmpeg = spawn(resolveFfmpegBin(), [
+		"-i",
+		inputSource,
+		...FFMPEG_PCM_ARGUMENTS,
+		"pipe:1"
+	], {
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		],
+		windowsHide: true
+	});
+	const opusStream = createDiscordOpusEncodeStream();
+	const stderr = Buffer.alloc(FFMPEG_ERROR_OUTPUT_BYTES);
+	let stderrBytes = 0;
+	let ffmpegClosed = false;
+	const killFfmpeg = (signal = "SIGTERM") => {
+		if (!ffmpegClosed && !ffmpeg.killed) ffmpeg.kill(signal);
+	};
+	ffmpeg.stderr.on("data", (chunk) => {
+		if (stderrBytes < FFMPEG_ERROR_OUTPUT_BYTES) stderrBytes += chunk.copy(stderr, stderrBytes, 0, FFMPEG_ERROR_OUTPUT_BYTES - stderrBytes);
+	});
+	ffmpeg.once("error", (err) => {
+		opusStream.destroy(err);
+	});
+	ffmpeg.once("close", (code, signal) => {
+		ffmpegClosed = true;
+		if (code && code !== 0) {
+			const stderrText = new StringDecoder("utf8").write(stderr.subarray(0, stderrBytes)).trim();
+			const suffix = stderrText ? `: ${stderrText}` : "";
+			opusStream.destroy(/* @__PURE__ */ new Error(`ffmpeg exited with code ${code}${suffix}`));
+			return;
+		}
+		if (signal) opusStream.destroy(/* @__PURE__ */ new Error(`ffmpeg exited with signal ${signal}`));
+	});
+	for (const readable of [ffmpeg.stdout, ffmpeg.stderr]) readable.on("error", (err) => {
+		killFfmpeg("SIGKILL");
+		opusStream.destroy(err);
+	});
+	ffmpeg.stdin.on("error", (err) => {
+		if (err.code !== "EPIPE") opusStream.destroy(err);
+	});
+	ffmpeg.stdout.pipe(opusStream);
+	opusStream.once("close", () => {
+		if (!opusStream.readableEnded) killFfmpeg();
+	});
+	if (typeof input !== "string") {
+		input.on("error", (err) => {
+			ffmpeg.stdin.destroy(err);
+			opusStream.destroy(err);
+		});
+		input.pipe(ffmpeg.stdin);
+	} else ffmpeg.stdin.end();
+	return opusStream;
+}
+var DiscordOpusEncodeStream = class extends Transform {
+	#buffer = Buffer.alloc(0);
+	#encoder = null;
+	#encoderPromise = null;
+	constructor() {
+		super({ readableObjectMode: true });
+	}
+	async #getEncoder() {
+		if (!this.#encoderPromise) this.#encoderPromise = createEncoder({
+			application: Application.Audio,
+			channels: CHANNELS,
+			sampleRate: SAMPLE_RATE
+		});
+		if (!this.#encoder) this.#encoder = await this.#encoderPromise;
+		return this.#encoder;
+	}
+	_transform(chunk, _encoding, done) {
+		(async () => {
+			try {
+				const encoder = await this.#getEncoder();
+				this.#buffer = this.#buffer.length > 0 ? Buffer.concat([this.#buffer, chunk]) : Buffer.from(chunk);
+				while (this.#buffer.length >= DISCORD_OPUS_FRAME_BYTES) {
+					const frame = this.#buffer.subarray(0, DISCORD_OPUS_FRAME_BYTES);
+					this.#buffer = this.#buffer.subarray(DISCORD_OPUS_FRAME_BYTES);
+					this.push(Buffer.from(encoder.encode(frame, { frameSize: DISCORD_OPUS_FRAME_SIZE })));
+				}
+				done();
+			} catch (err) {
+				done(err instanceof Error ? err : new Error(formatErrorMessage(err)));
+			}
+		})();
+	}
+	_final(done) {
+		(async () => {
+			try {
+				if (this.#buffer.length > 0) {
+					const encoder = await this.#getEncoder();
+					const frame = Buffer.alloc(DISCORD_OPUS_FRAME_BYTES);
+					this.#buffer.copy(frame);
+					this.#buffer = Buffer.alloc(0);
+					this.push(Buffer.from(encoder.encode(frame, { frameSize: DISCORD_OPUS_FRAME_SIZE })));
+				}
+				this.#freeEncoder();
+				done();
+			} catch (err) {
+				done(err instanceof Error ? err : new Error(formatErrorMessage(err)));
+			}
+		})();
+	}
+	_destroy(err, done) {
+		this.#freeEncoder();
+		done(err);
+	}
+	#freeEncoder() {
+		this.#encoder?.free();
+		this.#encoder = null;
+	}
+};
+function pcmInt16ToBuffer(pcm) {
+	return Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength);
+}
+async function decodeOpusStream(stream, params) {
+	const selected = await createOpusDecoder({ onWarn: params.onWarn });
+	if (!selected) return Buffer.alloc(0);
+	params.onVerbose(`opus decoder: ${selected.name}`);
+	const chunks = [];
+	try {
+		for await (const chunk of stream) {
+			if (!chunk || !(chunk instanceof Buffer) || chunk.length === 0) continue;
+			const decoded = await selected.decoder.decode(chunk);
+			if (decoded && decoded.length > 0) chunks.push(Buffer.from(decoded));
+		}
+	} catch (err) {
+		params.onError?.(err);
+		if (shouldLogVerbose()) logVerbose(`discord voice: opus decode failed: ${formatErrorMessage(err)}`);
+	} finally {
+		await selected.decoder.free?.();
+	}
+	return chunks.length > 0 ? Buffer.concat(chunks) : Buffer.alloc(0);
+}
+async function decodeOpusStreamChunks(stream, params) {
+	const selected = await createOpusDecoder({ onWarn: params.onWarn });
+	if (!selected) return;
+	params.onVerbose(`opus decoder: ${selected.name}`);
+	try {
+		for await (const chunk of stream) {
+			if (!chunk || !(chunk instanceof Buffer) || chunk.length === 0) continue;
+			const decoded = await selected.decoder.decode(chunk);
+			if (decoded && decoded.length > 0) params.onChunk(Buffer.from(decoded));
+		}
+	} catch (err) {
+		params.onError?.(err);
+		if (shouldLogVerbose()) logVerbose(`discord voice: opus decode failed: ${formatErrorMessage(err)}`);
+	} finally {
+		await selected.decoder.free?.();
+	}
+}
+function convertDiscordPcm48kStereoToRealtimePcm24kMono(pcm) {
+	const frameCount = Math.floor(pcm.length / 4);
+	if (frameCount === 0) return Buffer.alloc(0);
+	const mono48k = Buffer.alloc(frameCount * 2);
+	for (let frame = 0; frame < frameCount; frame += 1) {
+		const offset = frame * 4;
+		const left = pcm.readInt16LE(offset);
+		const right = pcm.readInt16LE(offset + 2);
+		mono48k.writeInt16LE(Math.round((left + right) / 2), frame * 2);
+	}
+	return resamplePcm(mono48k, SAMPLE_RATE, 24e3);
+}
+function convertRealtimePcm24kMonoToDiscordPcm48kStereo(pcm) {
+	const mono48k = resamplePcm(pcm, 24e3, SAMPLE_RATE);
+	const sampleCount = Math.floor(mono48k.length / 2);
+	if (sampleCount === 0) return Buffer.alloc(0);
+	const stereo = Buffer.alloc(sampleCount * 4);
+	for (let sampleIndex = 0; sampleIndex < sampleCount; sampleIndex += 1) {
+		const sample = mono48k.readInt16LE(sampleIndex * 2);
+		const offset = sampleIndex * 4;
+		stereo.writeInt16LE(sample, offset);
+		stereo.writeInt16LE(sample, offset + 2);
+	}
+	return stereo;
+}
+function estimateDurationSeconds(pcm) {
+	const bytesPerSample = BIT_DEPTH / 8 * CHANNELS;
+	return pcm.length / (bytesPerSample * SAMPLE_RATE);
+}
+async function writeVoiceWavFile(pcm) {
+	const workspace = await tempWorkspace({
+		rootDir: resolvePreferredOpenClawTmpDir(),
+		prefix: "discord-voice-"
+	});
+	const wav = buildWavBuffer(pcm);
+	const filePath = await workspace.write("segment.wav", wav);
+	scheduleTempCleanup(workspace.dir);
+	return {
+		path: filePath,
+		durationSeconds: estimateDurationSeconds(pcm)
+	};
+}
+function scheduleTempCleanup(tempDir, delayMs = 18e5) {
+	setTimeout(() => {
+		fs.rm(tempDir, {
+			recursive: true,
+			force: true
+		}).catch((err) => {
+			if (shouldLogVerbose()) logVerbose(`discord voice: temp cleanup failed for ${tempDir}: ${formatErrorMessage(err)}`);
+		});
+	}, delayMs).unref();
+}
+//#endregion
+//#region extensions/discord/src/voice/capture-state.ts
+function createVoiceCaptureState() {
+	return {
+		activeSpeakers: /* @__PURE__ */ new Set(),
+		activeCaptureStreams: /* @__PURE__ */ new Map(),
+		captureFinalizeTimers: /* @__PURE__ */ new Map(),
+		captureGenerations: /* @__PURE__ */ new Map()
+	};
+}
+function stopVoiceCaptureState(state) {
+	for (const { timer } of state.captureFinalizeTimers.values()) clearTimeout(timer);
+	state.captureFinalizeTimers.clear();
+	for (const { stream } of state.activeCaptureStreams.values()) stream.destroy();
+	state.activeCaptureStreams.clear();
+	state.captureGenerations.clear();
+	state.activeSpeakers.clear();
+}
+function getActiveVoiceCapture(state, userId) {
+	return state.activeCaptureStreams.get(userId);
+}
+function isVoiceCaptureActive(state, userId) {
+	return state.activeSpeakers.has(userId);
+}
+function clearVoiceCaptureFinalizeTimer(state, userId, generation) {
+	const scheduled = state.captureFinalizeTimers.get(userId);
+	if (!scheduled || generation !== void 0 && scheduled.generation !== generation) return false;
+	clearTimeout(scheduled.timer);
+	state.captureFinalizeTimers.delete(userId);
+	return true;
+}
+function beginVoiceCapture(state, userId, stream) {
+	const generation = (state.captureGenerations.get(userId) ?? 0) + 1;
+	state.captureGenerations.set(userId, generation);
+	state.activeSpeakers.add(userId);
+	state.activeCaptureStreams.set(userId, {
+		generation,
+		stream
+	});
+	clearVoiceCaptureFinalizeTimer(state, userId, generation);
+	return generation;
+}
+function finishVoiceCapture(state, userId, generation) {
+	clearVoiceCaptureFinalizeTimer(state, userId, generation);
+	if (state.activeCaptureStreams.get(userId)?.generation !== generation) return false;
+	state.activeCaptureStreams.delete(userId);
+	state.activeSpeakers.delete(userId);
+	return true;
+}
+function scheduleVoiceCaptureFinalize(params) {
+	const { state, userId, delayMs, onFinalize } = params;
+	const capture = state.activeCaptureStreams.get(userId);
+	if (!capture) return false;
+	clearVoiceCaptureFinalizeTimer(state, userId, capture.generation);
+	const timer = setTimeout(() => {
+		const activeCapture = state.activeCaptureStreams.get(userId);
+		if (!activeCapture || activeCapture.generation !== capture.generation) return;
+		state.captureFinalizeTimers.delete(userId);
+		state.activeCaptureStreams.delete(userId);
+		state.activeSpeakers.delete(userId);
+		onFinalize?.(activeCapture);
+		activeCapture.stream.destroy();
+	}, delayMs);
+	state.captureFinalizeTimers.set(userId, {
+		generation: capture.generation,
+		timer
+	});
+	return true;
+}
+//#endregion
+//#region extensions/discord/src/voice/ingress.ts
+const DISCORD_VOICE_MESSAGE_PROVIDER = "discord-voice";
+const logger$3 = createSubsystemLogger("discord/voice");
+function summarizeAgentTurnPayloads(payloads) {
+	let textPayloads = 0;
+	let nonEmptyTextPayloads = 0;
+	let reasoningPayloads = 0;
+	let errorPayloads = 0;
+	let mediaPayloads = 0;
+	for (const payload of payloads) {
+		if (!payload || typeof payload !== "object") continue;
+		const record = payload;
+		const text = record.text;
+		if (typeof text === "string") {
+			textPayloads += 1;
+			if (text.trim()) nonEmptyTextPayloads += 1;
+		}
+		if (record.isReasoning === true) reasoningPayloads += 1;
+		if (record.isError === true) errorPayloads += 1;
+		if (typeof record.mediaUrl === "string" || Array.isArray(record.mediaUrls) && record.mediaUrls.length > 0) mediaPayloads += 1;
+	}
+	return `payloadCount=${payloads.length} textPayloads=${textPayloads} nonEmptyTextPayloads=${nonEmptyTextPayloads} reasoningPayloads=${reasoningPayloads} errorPayloads=${errorPayloads} mediaPayloads=${mediaPayloads}`;
+}
+async function resolveDiscordVoiceIngressContext(params) {
+	const { entry, userId } = params;
+	if (!entry.guildName) entry.guildName = await params.fetchGuildName(entry.guildId);
+	const speaker = await params.speakerContext.resolveContext(entry.guildId, userId);
+	const speakerIdentity = await params.speakerContext.resolveIdentity(entry.guildId, userId);
+	const access = await authorizeDiscordVoiceIngress({
+		cfg: params.cfg,
+		discordConfig: params.discordConfig,
+		guildName: entry.guildName,
+		guildId: entry.guildId,
+		channelId: entry.channelId,
+		channelName: entry.channelName,
+		channelSlug: entry.channelName ? normalizeDiscordSlug(entry.channelName) : "",
+		channelLabel: formatMention({ channelId: entry.channelId }),
+		memberRoleIds: speakerIdentity.memberRoleIds,
+		ownerAllowFrom: params.ownerAllowFrom,
+		sender: {
+			id: speakerIdentity.id,
+			name: speakerIdentity.name,
+			tag: speakerIdentity.tag
+		}
+	});
+	if (!access.ok) return null;
+	return {
+		extraSystemPrompt: buildDiscordGroupSystemPrompt(access.channelConfig),
+		senderIsOwner: speaker.senderIsOwner,
+		speakerLabel: speaker.label
+	};
+}
+async function runDiscordVoiceAgentTurn(params) {
+	const context = params.context ?? await resolveDiscordVoiceIngressContext({
+		entry: params.entry,
+		userId: params.userId,
+		cfg: params.cfg,
+		discordConfig: params.discordConfig,
+		ownerAllowFrom: params.ownerAllowFrom,
+		fetchGuildName: params.fetchGuildName,
+		speakerContext: params.speakerContext
+	});
+	if (!context) return null;
+	const voiceModel = normalizeOptionalString(params.discordConfig.voice?.model);
+	const payloads = (await agentCommandFromIngress({
+		message: params.message,
+		sessionKey: params.entry.route.sessionKey,
+		agentId: params.entry.route.agentId,
+		messageChannel: "discord",
+		messageProvider: DISCORD_VOICE_MESSAGE_PROVIDER,
+		extraSystemPrompt: context.extraSystemPrompt,
+		allowModelOverride: Boolean(voiceModel),
+		model: voiceModel,
+		toolsAllow: params.toolsAllow,
+		deliver: false
+	}, params.runtime)).payloads ?? [];
+	const text = payloads.map((payload) => payload.text).filter((entry) => typeof entry === "string" && entry.trim()).join("\n").trim();
+	if (!text) logger$3.info(`discord voice: agent turn produced no speakable payloads guild=${params.entry.guildId} channel=${params.entry.channelId} voiceSession=${params.entry.voiceSessionKey} supervisorSession=${params.entry.route.sessionKey} agent=${params.entry.route.agentId} user=${params.userId} ${summarizeAgentTurnPayloads(payloads)}`);
+	return {
+		context,
+		text
+	};
+}
+async function resolveDiscordVoiceRealtimeBootstrapContext(params) {
+	const files = (params.discordConfig.voice?.realtime)?.bootstrapContextFiles;
+	if (files?.length === 0) return;
+	try {
+		return await resolveRealtimeBootstrapContextInstructions({
+			config: params.cfg,
+			agentId: params.entry.route.agentId,
+			sessionKey: params.entry.route.sessionKey,
+			files,
+			warn: (message) => logger$3.warn(`discord voice: realtime bootstrap context: ${message}`)
+		});
+	} catch (error) {
+		logger$3.warn(`discord voice: realtime bootstrap context unavailable: ${error instanceof Error ? error.message : String(error)}`);
+		return;
+	}
+}
+//#endregion
+//#region extensions/discord/src/voice/log-preview.ts
+const DISCORD_VOICE_LOG_PREVIEW_CHARS = 500;
+function formatVoiceLogPreview(text) {
+	const oneLine = text.replace(/\s+/g, " ").trim();
+	if (oneLine.length <= DISCORD_VOICE_LOG_PREVIEW_CHARS) return oneLine;
+	return `${truncateUtf16Safe(oneLine, DISCORD_VOICE_LOG_PREVIEW_CHARS)}...`;
+}
+//#endregion
+//#region extensions/discord/src/voice/agent-control.ts
+async function maybeControlDiscordVoiceAgentRun(params) {
+	if (!shouldAutoControlRealtimeVoiceAgentText(params.text)) return { handled: false };
+	const result = await controlRealtimeVoiceAgentRun({
+		sessionKey: params.entry.route.sessionKey,
+		text: params.text
+	});
+	if (!result.active) return {
+		handled: false,
+		result
+	};
+	return {
+		handled: true,
+		result,
+		...result.speak && !result.suppress ? { speakText: result.message } : {}
+	};
+}
+//#endregion
+//#region extensions/discord/src/voice/prompt.ts
+const DISCORD_VOICE_SPOKEN_OUTPUT_CONTRACT = [
+	"You are OpenClaw's Discord voice interface in a live voice channel.",
+	"Discord voice reply requirements:",
+	"- Return only the concise text that should be spoken aloud in the voice channel.",
+	"- Treat the transcript as speech-to-text from a live conversation; repair obvious transcription artifacts and ignore repeated partial fragments caused by voice buffering.",
+	"- If the transcript is garbled, incomplete, or missing the user's intent, ask one brief clarifying question instead of guessing.",
+	"- If the request needs deeper reasoning, current information, or tools, use the available tools before answering.",
+	"- Do not call the tts tool; Discord voice will synthesize and play the returned text.",
+	"- Do not reply with NO_REPLY unless no spoken response is appropriate.",
+	"- Keep the response brief, natural, and conversational. Prefer one to three short sentences.",
+	"- Avoid markdown tables, code fences, citations, and visual formatting unless the user explicitly asks for something that cannot be spoken naturally."
+].join("\n");
+function formatVoiceIngressPrompt(transcript, speakerLabel) {
+	const cleanedTranscript = transcript.trim();
+	const cleanedLabel = speakerLabel?.trim();
+	const voiceInput = cleanedLabel ? [`Voice transcript from speaker "${cleanedLabel}":`, cleanedTranscript].join("\n") : cleanedTranscript;
+	return [DISCORD_VOICE_SPOKEN_OUTPUT_CONTRACT, voiceInput].join("\n\n");
+}
+//#endregion
+//#region extensions/discord/src/voice/sdk-runtime.ts
+let cachedDiscordVoiceSdk = null;
+function loadDiscordVoiceSdk() {
+	if (cachedDiscordVoiceSdk) return cachedDiscordVoiceSdk;
+	cachedDiscordVoiceSdk = createRequire(import.meta.url)("@discordjs/voice");
+	return cachedDiscordVoiceSdk;
+}
+const CAPTURE_FINALIZE_GRACE_MS = 2e3;
+const VOICE_CONNECT_READY_TIMEOUT_MS = 3e4;
+const VOICE_RECONNECT_GRACE_MS = 15e3;
+const PLAYBACK_READY_TIMEOUT_MS = 6e4;
+const SPEAKING_READY_TIMEOUT_MS = 6e4;
+function resolveVoiceTimeoutMs(value, fallbackMs) {
+	if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) return fallbackMs;
+	return Math.floor(value);
+}
+function logVoiceVerbose(message) {
+	logVerbose(`discord voice: ${message}`);
+}
+function isVoiceChannel(type) {
+	return type === discord_exports.ChannelType.GuildVoice || type === discord_exports.ChannelType.GuildStageVoice;
+}
+//#endregion
+//#region extensions/discord/src/voice/realtime.ts
+const logger$2 = createSubsystemLogger("discord/voice");
+function resolveDiscordRealtimeVoiceAgentConsultTools(policy) {
+	const tools = resolveRealtimeVoiceAgentConsultTools(policy);
+	if (policy !== "none" && !tools.some((tool) => tool.name === REALTIME_VOICE_AGENT_CONTROL_TOOL.name)) return [...tools, REALTIME_VOICE_AGENT_CONTROL_TOOL];
+	return tools;
+}
+const DISCORD_REALTIME_TALKBACK_DEBOUNCE_MS = 350;
+const DISCORD_REALTIME_FALLBACK_TEXT = "I hit an error while checking that. Please try again.";
+const DISCORD_REALTIME_PENDING_SPEAKER_CONTEXT_LIMIT = 32;
+const DISCORD_REALTIME_RECENT_AGENT_PROXY_CONSULT_LIMIT = 16;
+const DISCORD_REALTIME_RECENT_AGENT_PROXY_CONSULT_TTL_MS = 15e3;
+const DISCORD_REALTIME_IGNORED_WAKE_NAME_CONTEXT_TTL_MS = 1e4;
+const DISCORD_REALTIME_WAKE_NAME_FOLLOWUP_TTL_MS = 1e4;
+const DISCORD_REALTIME_DEFAULT_MIN_BARGE_IN_AUDIO_END_MS = 250;
+const DISCORD_REALTIME_FORCED_CONSULT_FALLBACK_DELAY_MS = 200;
+const DISCORD_REALTIME_DUPLICATE_ERROR_SUPPRESS_MS = 6e4;
+const DISCORD_REALTIME_CONTROL_SPEECH_DEDUPE_MS = 5e3;
+const DISCORD_REALTIME_OUTPUT_PLAYBACK_WATCHDOG_MARGIN_MS = 1500;
+const DISCORD_REALTIME_WAKE_ACKS = [
+	"Yeah.",
+	"Mm-hmm.",
+	"Got it.",
+	"One sec."
+];
+const REALTIME_PCM16_BYTES_PER_SAMPLE = 2;
+const DISCORD_RAW_PCM_FRAME_BYTES = 3840;
+const DISCORD_REALTIME_OUTPUT_PREROLL_FRAMES = 25;
+const DISCORD_REALTIME_TRAILING_SILENCE_MIN_MS = 700;
+const DISCORD_REALTIME_TRAILING_SILENCE_MAX_MS = 3e3;
+const DISCORD_REALTIME_FORCED_CONSULT_REASON = "provider_final_transcript_without_openclaw_agent_consult";
+const DISCORD_REALTIME_VERBOSE_OMITTED_EVENTS = /* @__PURE__ */ new Set([
+	"conversation.output_audio.delta",
+	"input_audio_buffer.append",
+	"response.audio.delta",
+	"response.output_audio.delta"
+]);
+function formatRealtimeInterruptionLog(event) {
+	const detail = event.detail ? ` ${event.detail}` : "";
+	if (event.direction === "client") {
+		if (event.type === "response.cancel") return `discord voice: realtime model interrupt requested ${event.direction}:${event.type}${detail}`;
+		if (event.type === "conversation.item.truncate.skipped") return `discord voice: realtime model interrupt ignored ${event.direction}:${event.type}${detail}`;
+		if (event.type === "conversation.item.truncate") return `discord voice: realtime model audio truncated ${event.direction}:${event.type}${detail}`;
+	}
+	if (event.direction === "server") {
+		if (event.type === "response.cancelled") return `discord voice: realtime model interrupt confirmed ${event.direction}:${event.type}${detail}`;
+		if (event.type === "response.done" && event.detail?.includes("status=cancelled")) return `discord voice: realtime model interrupt confirmed ${event.direction}:${event.type}${detail}`;
+		if (event.type === "error" && event.detail === "Cancellation failed: no active response found") return `discord voice: realtime model interrupt raced ${event.direction}:${event.type}${detail}`;
+	}
+}
+function formatRealtimeLifecycleLog(event) {
+	if (!event.type.startsWith("session.")) return;
+	const detail = event.detail ? ` ${event.detail}` : "";
+	return `discord voice: realtime lifecycle ${event.direction}:${event.type}${detail}`;
+}
+function isRealtimeResponseCancelled(event) {
+	return event.direction === "server" && (event.type === "response.cancelled" || event.type === "response.done" && event.detail?.includes("status=cancelled") === true);
+}
+function shouldLogRealtimeVerboseEvent(event) {
+	return !DISCORD_REALTIME_VERBOSE_OMITTED_EVENTS.has(event.type);
+}
+function readProviderConfigString(config, key) {
+	const value = config[key];
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readProviderConfigBoolean(config, key) {
+	return asBoolean(config?.[key]);
+}
+function resolveDiscordVoiceMode(voice) {
+	const mode = voice?.mode;
+	if (mode === "stt-tts" || mode === "bidi") return mode;
+	return "agent-proxy";
+}
+function isDiscordRealtimeVoiceMode(mode) {
+	return mode === "agent-proxy" || mode === "bidi";
+}
+function isDiscordAgentProxyVoiceMode(mode) {
+	return mode === "agent-proxy";
+}
+function resolveDiscordRealtimeInterruptResponseOnInputAudio(params) {
+	const providerConfig = params.realtimeConfig?.providers?.[params.providerId];
+	return readProviderConfigBoolean(providerConfig, "interruptResponseOnInputAudio") ?? true;
+}
+function resolveDiscordRealtimeBargeIn(params) {
+	const configured = params.realtimeConfig?.bargeIn;
+	if (typeof configured === "boolean") return configured;
+	return resolveDiscordRealtimeInterruptResponseOnInputAudio(params);
+}
+function buildDiscordSpeakExactUserMessage(text) {
+	return [
+		"Internal OpenClaw voice playback result.",
+		"Do not call openclaw_agent_consult or any other tool for this message.",
+		"Speak this exact OpenClaw answer to the Discord voice channel, without adding, removing, or rephrasing words.",
+		`Answer: ${JSON.stringify(text)}`
+	].join("\n");
+}
+function isEscapedQuote(text, quoteIndex) {
+	let backslashes = 0;
+	for (let index = quoteIndex - 1; index >= 0 && text[index] === "\\"; index -= 1) backslashes += 1;
+	return backslashes % 2 === 1;
+}
+function readJsonStringAfterLabel(text, label) {
+	const labelIndex = text.indexOf(label);
+	if (labelIndex < 0) return;
+	const quoteIndex = text.indexOf("\"", labelIndex + label.length);
+	if (quoteIndex < 0) return;
+	for (let index = quoteIndex + 1; index < text.length; index += 1) {
+		if (text[index] !== "\"" || isEscapedQuote(text, index)) continue;
+		try {
+			const parsed = JSON.parse(text.slice(quoteIndex, index + 1));
+			return typeof parsed === "string" ? parsed : void 0;
+		} catch {
+			return;
+		}
+	}
+}
+function collectRealtimeConsultArgStrings(args) {
+	if (!args || typeof args !== "object") return typeof args === "string" ? [args] : [];
+	const values = [];
+	for (const key of [
+		"question",
+		"prompt",
+		"query",
+		"task",
+		"context",
+		"responseStyle"
+	]) {
+		const value = args[key];
+		if (typeof value === "string") values.push(value);
+	}
+	return values;
+}
+function extractDiscordExactSpeechConsultText(args) {
+	const message = collectRealtimeConsultArgStrings(args).join("\n");
+	if (!message.includes("Speak this exact OpenClaw answer") && !message.includes("Speak the provided exact answer verbatim")) return;
+	return readJsonStringAfterLabel(message, "Answer:") ?? readJsonStringAfterLabel(message, "Provided answer text:");
+}
+function normalizeControlSpeechText(text) {
+	return text.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function mergeRealtimePartialTranscript(previous, next) {
+	const trimmed = next.trim();
+	if (!trimmed) return previous;
+	return (trimmed.startsWith(previous) ? trimmed : `${previous}${next}`).slice(-240);
+}
+function resolveDiscordRealtimeWakeNames(params) {
+	const rawConfigured = params.config?.wakeNames;
+	if (rawConfigured) {
+		const configured = rawConfigured.map((name) => normalizeSupportedRealtimeVoiceActivationName(name)).filter((name) => Boolean(name));
+		return sortRealtimeVoiceActivationNames(uniqueStrings(configured));
+	}
+	const agent = params.cfg.agents?.list?.find((candidate) => candidate.id === params.agentId);
+	const configuredAgentNames = [agent?.name, agent?.identity?.name].map((name) => normalizeSupportedRealtimeVoiceActivationName(name)).filter((name) => Boolean(name));
+	const productWakeNames = [normalizeSupportedRealtimeVoiceActivationName("OpenClaw")].filter((name) => Boolean(name));
+	const defaults = configuredAgentNames.length > 0 ? [...configuredAgentNames, ...productWakeNames] : [normalizeSupportedRealtimeVoiceActivationName(params.agentId), ...productWakeNames].filter((name) => Boolean(name));
+	return sortRealtimeVoiceActivationNames(uniqueStrings(defaults));
+}
+function matchesPendingAgentProxyQuestion(consultMessage, question) {
+	return matchRealtimeVoiceConsultQuestions(consultMessage, question);
+}
+var DiscordRealtimeVoiceSession = class {
+	constructor(params) {
+		this.params = params;
+		this.bridge = null;
+		this.outputStream = null;
+		this.stopped = false;
+		this.consultToolPolicy = "safe-read-only";
+		this.consultPolicy = "auto";
+		this.requireWakeName = false;
+		this.wakeNames = [];
+		this.forcedConsults = createRealtimeVoiceForcedConsultCoordinator({
+			limit: DISCORD_REALTIME_RECENT_AGENT_PROXY_CONSULT_LIMIT,
+			nativeDedupeMs: DISCORD_REALTIME_RECENT_AGENT_PROXY_CONSULT_TTL_MS,
+			questionsMatch: matchesPendingAgentProxyQuestion
+		});
+		this.speakerTurns = createRealtimeVoiceTurnContextTracker({
+			limit: DISCORD_REALTIME_PENDING_SPEAKER_CONTEXT_LIMIT,
+			ignoredContextTtlMs: DISCORD_REALTIME_IGNORED_WAKE_NAME_CONTEXT_TTL_MS,
+			deferUntilAudio: true
+		});
+		this.outputActivity = createRealtimeVoiceOutputActivityTracker();
+		this.outputPacedBuffer = Buffer.alloc(0);
+		this.queuedExactSpeechMessages = [];
+		this.exactSpeechResponseActive = false;
+		this.exactSpeechAudioStarted = false;
+		this.partialUserTranscript = "";
+		this.wakeNameAckedForTurn = false;
+		this.wakeNameAckIndex = 0;
+		this.playerIdleHandler = () => {
+			const hadOutputAudio = this.isOutputAudioActive();
+			this.resetOutputStream("player-idle");
+			if (hadOutputAudio) this.completeExactSpeechResponse("player-idle");
+		};
+		this.talkback = createRealtimeVoiceAgentTalkbackQueue({
+			debounceMs: this.realtimeConfig?.debounceMs ?? DISCORD_REALTIME_TALKBACK_DEBOUNCE_MS,
+			isStopped: () => this.stopped,
+			logger: logger$2,
+			logPrefix: "[discord] realtime agent",
+			responseStyle: "Brief, natural spoken answer for a Discord voice channel.",
+			fallbackText: DISCORD_REALTIME_FALLBACK_TEXT,
+			consult: async ({ question, responseStyle, metadata }) => {
+				const context = isDiscordRealtimeSpeakerContext(metadata) ? metadata : void 0;
+				return { text: await this.runAgentTurn({
+					context,
+					message: formatVoiceIngressPrompt([question, responseStyle ? `Spoken style: ${responseStyle}` : void 0].filter(Boolean).join("\n\n"), context?.speakerLabel ?? "Discord voice speaker")
+				}) };
+			},
+			deliver: (text) => this.enqueueExactSpeechMessage(text)
+		});
+	}
+	async connect() {
+		const resolved = resolveConfiguredRealtimeVoiceProvider({
+			configuredProviderId: this.realtimeConfig?.provider,
+			providerConfigs: buildProviderConfigs(this.realtimeConfig),
+			providerConfigOverrides: buildProviderConfigOverrides(this.realtimeConfig),
+			cfg: this.params.cfg,
+			defaultModel: this.realtimeConfig?.model,
+			noRegisteredProviderMessage: "No configured realtime voice provider registered"
+		});
+		this.realtimeProviderId = resolved.provider.id;
+		const isAgentProxy = isDiscordAgentProxyVoiceMode(this.params.mode);
+		const defaultToolPolicy = isAgentProxy ? "owner" : "safe-read-only";
+		const toolPolicy = resolveRealtimeVoiceAgentConsultToolPolicy(this.realtimeConfig?.toolPolicy, defaultToolPolicy);
+		this.consultToolPolicy = toolPolicy;
+		this.consultToolsAllow = resolveRealtimeVoiceAgentConsultToolsAllow(toolPolicy);
+		const consultPolicy = this.realtimeConfig?.consultPolicy ?? (isAgentProxy ? "always" : "auto");
+		this.consultPolicy = consultPolicy;
+		const supportsWakeNameGate = resolved.provider.id === "openai";
+		this.requireWakeName = this.realtimeConfig?.requireWakeName === true && isAgentProxy && supportsWakeNameGate;
+		this.wakeNames = this.requireWakeName ? resolveDiscordRealtimeWakeNames({
+			config: this.realtimeConfig,
+			cfg: this.params.cfg,
+			agentId: this.params.entry.route.agentId
+		}) : [];
+		const usesRealtimeAgentHandoff = this.params.mode === "bidi" || toolPolicy !== "none";
+		const autoRespondToAudio = !this.requireWakeName && (!isAgentProxy || consultPolicy !== "always");
+		const interruptResponseOnInputAudio = !this.requireWakeName && resolveDiscordRealtimeInterruptResponseOnInputAudio({
+			realtimeConfig: this.realtimeConfig,
+			providerId: resolved.provider.id
+		});
+		const instructions = buildDiscordRealtimeInstructions({
+			mode: this.params.mode,
+			instructions: this.realtimeConfig?.instructions,
+			bootstrapContextInstructions: this.params.bootstrapContextInstructions,
+			toolPolicy,
+			consultPolicy
+		});
+		this.bridge = createRealtimeVoiceBridgeSession({
+			provider: resolved.provider,
+			cfg: this.params.cfg,
+			providerConfig: resolved.providerConfig,
+			audioFormat: REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ,
+			instructions,
+			autoRespondToAudio,
+			interruptResponseOnInputAudio,
+			markStrategy: "ack-immediately",
+			tools: usesRealtimeAgentHandoff ? resolveDiscordRealtimeVoiceAgentConsultTools(toolPolicy) : [],
+			audioSink: {
+				isOpen: () => !this.stopped,
+				sendAudio: (audio) => this.sendOutputAudio(audio),
+				clearAudio: () => this.clearOutputAudio("provider-clear-audio")
+			},
+			onTranscript: (role, text, isFinal) => {
+				if (isFinal && text.trim()) logger$2.info(`discord voice: realtime ${role} transcript (${text.length} chars): ${formatVoiceLogPreview(text)}`);
+				if (isFinal && role === "assistant") this.suppressDuplicateControlSpeech(text);
+				if (role !== "user") return;
+				if (!isFinal) {
+					this.handlePartialUserTranscript(text);
+					return;
+				}
+				this.handleFinalUserTranscript(text, { usesRealtimeAgentHandoff });
+			},
+			onToolCall: (event, session) => this.handleToolCall(event, session),
+			onEvent: (event) => {
+				const detail = event.detail ? ` ${event.detail}` : "";
+				if (event.direction === "server" && event.type === "input_audio_buffer.speech_started") this.resetPartialWakeNameTracking();
+				if (shouldLogRealtimeVerboseEvent(event)) logVoiceVerbose(`realtime ${event.direction}:${event.type}${detail}`);
+				if (event.direction === "server" && (event.type === "response.done" || event.type === "response.cancelled")) {
+					if (this.exactSpeechResponseActive && !this.exactSpeechAudioStarted) this.completeExactSpeechResponse(event.type);
+					this.finishOutputAudioStream(event.type, { playBuffered: !isRealtimeResponseCancelled(event) });
+				}
+				const interruptionLog = formatRealtimeInterruptionLog(event);
+				if (interruptionLog) logger$2.info(interruptionLog);
+				const lifecycleLog = formatRealtimeLifecycleLog(event);
+				if (lifecycleLog) logger$2.info(lifecycleLog);
+			},
+			onError: (error) => this.logRealtimeError(formatErrorMessage(error)),
+			onClose: (reason) => {
+				this.flushSuppressedRealtimeErrors();
+				logVoiceVerbose(`realtime closed: ${reason}`);
+			}
+		});
+		const resolvedModel = readProviderConfigString(resolved.providerConfig, "model") ?? resolved.provider.defaultModel;
+		const resolvedVoice = readProviderConfigString(resolved.providerConfig, "voice");
+		logger$2.info(`discord voice: realtime bridge starting mode=${this.params.mode} provider=${resolved.provider.id} model=${resolvedModel ?? "default"} voice=${resolvedVoice ?? "default"} consultPolicy=${consultPolicy} toolPolicy=${toolPolicy} autoRespond=${autoRespondToAudio} requireWakeName=${this.requireWakeName} wakeNames=${this.wakeNames.join(",") || "none"} interruptResponse=${interruptResponseOnInputAudio} bargeIn=${resolveDiscordRealtimeBargeIn({
+			realtimeConfig: this.realtimeConfig,
+			providerId: resolved.provider.id
+		})} minBargeInAudioEndMs=${resolveDiscordRealtimeMinBargeInAudioEndMs(this.realtimeConfig)}`);
+		const voiceSdk = loadDiscordVoiceSdk();
+		this.params.entry.player.on(voiceSdk.AudioPlayerStatus.Idle, this.playerIdleHandler);
+		await this.bridge.connect();
+		logger$2.info(`discord voice: realtime bridge ready mode=${this.params.mode} provider=${resolved.provider.id} model=${resolvedModel ?? "default"} voice=${resolvedVoice ?? "default"}`);
+	}
+	close() {
+		this.stopped = true;
+		this.flushSuppressedRealtimeErrors();
+		this.talkback.close();
+		this.forcedConsults.clear();
+		this.speakerTurns.clear();
+		this.queuedExactSpeechMessages = [];
+		this.exactSpeechResponseActive = false;
+		this.exactSpeechAudioStarted = false;
+		this.resetPartialWakeNameTracking();
+		this.pendingWakeNameFollowup = void 0;
+		this.clearOutputAudio("session-close");
+		this.bridge?.close();
+		this.bridge = null;
+		this.realtimeProviderId = void 0;
+		const voiceSdk = loadDiscordVoiceSdk();
+		this.params.entry.player.off(voiceSdk.AudioPlayerStatus.Idle, this.playerIdleHandler);
+	}
+	logRealtimeError(message) {
+		const now = Date.now();
+		if (this.lastRealtimeError?.message === message && now - this.lastRealtimeError.lastLoggedAt < DISCORD_REALTIME_DUPLICATE_ERROR_SUPPRESS_MS) {
+			this.lastRealtimeError.suppressed += 1;
+			return;
+		}
+		this.flushSuppressedRealtimeErrors();
+		this.lastRealtimeError = {
+			message,
+			suppressed: 0,
+			lastLoggedAt: now
+		};
+		logger$2.warn(`discord voice: realtime error: ${message}`);
+	}
+	flushSuppressedRealtimeErrors() {
+		if (!this.lastRealtimeError || this.lastRealtimeError.suppressed === 0) return;
+		logger$2.warn(`discord voice: suppressed ${this.lastRealtimeError.suppressed} duplicate realtime errors: ${this.lastRealtimeError.message}`);
+		this.lastRealtimeError.suppressed = 0;
+	}
+	beginSpeakerTurn(context, userId) {
+		this.resetPartialWakeNameTracking();
+		const turn = this.speakerTurns.open({
+			...context,
+			userId
+		}, {
+			inputDiscordBytes: 0,
+			inputRealtimeBytes: 0,
+			inputChunks: 0,
+			interruptedPlayback: false
+		});
+		return {
+			sendInputAudio: (discordPcm48kStereo) => this.sendInputAudioForTurn(turn, discordPcm48kStereo),
+			close: () => {
+				this.sendRealtimeTrailingSilenceForTurn(turn);
+				this.logSpeakerTurnClosed(turn);
+				this.speakerTurns.close(turn);
+			}
+		};
+	}
+	sendInputAudioForTurn(turn, discordPcm48kStereo) {
+		if (!this.bridge || this.stopped) return;
+		const realtimePcm = convertDiscordPcm48kStereoToRealtimePcm24kMono(discordPcm48kStereo);
+		if (realtimePcm.length > 0) {
+			this.registerSpeakerTurnAudioStarted(turn);
+			turn.inputDiscordBytes += discordPcm48kStereo.length;
+			turn.inputRealtimeBytes += realtimePcm.length;
+			turn.inputChunks += 1;
+			if (turn.inputChunks === 1) logger$2.info(`discord voice: realtime input audio started guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} user=${turn.context.userId} speaker=${turn.context.speakerLabel} discordBytes=${discordPcm48kStereo.length} realtimeBytes=${realtimePcm.length} outputAudioMs=${this.outputAudioMs()} outputActive=${this.isOutputAudioActive()}`);
+			const outputActive = this.hasInterruptibleOutputAudio();
+			if (!turn.interruptedPlayback && this.isBargeInEnabled() && outputActive) {
+				turn.interruptedPlayback = true;
+				logVoiceVerbose(`realtime barge-in from active speaker audio: guild ${this.params.entry.guildId} channel ${this.params.entry.channelId} user ${turn.context.userId}`);
+				logger$2.info(`discord voice: realtime barge-in detected source=active-speaker-audio guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} user=${turn.context.userId} speaker=${turn.context.speakerLabel} outputAudioMs=${this.outputAudioMs()} outputActive=${this.isOutputAudioActive()} discordBytes=${discordPcm48kStereo.length} realtimeBytes=${realtimePcm.length}`);
+				this.handleBargeIn("active-speaker-audio");
+			}
+			this.bridge.sendAudio(realtimePcm);
+		}
+	}
+	registerSpeakerTurnAudioStarted(turn) {
+		if (turn.hasAudio) return;
+		this.speakerTurns.markAudio(turn);
+		logger$2.info(`discord voice: realtime speaker turn opened guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} user=${turn.context.userId} speaker=${turn.context.speakerLabel} owner=${turn.context.senderIsOwner} pendingTurns=${this.speakerTurns.size()}`);
+	}
+	handleBargeIn(reason = "barge-in") {
+		if (!this.isBargeInEnabled()) {
+			logger$2.info(`discord voice: realtime barge-in ignored reason=${reason} bargeIn=false guild=${this.params.entry.guildId} channel=${this.params.entry.channelId}`);
+			return;
+		}
+		if (!this.hasInterruptibleOutputAudio()) {
+			logger$2.info(`discord voice: realtime barge-in ignored reason=${reason} outputActive=false guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} playbackChunks=${this.outputAudioChunks()}`);
+			return;
+		}
+		logger$2.info(`discord voice: realtime barge-in requested reason=${reason} guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} outputAudioMs=${this.outputAudioMs()} outputActive=${this.isOutputAudioActive()} playbackChunks=${this.outputAudioChunks()}`);
+		this.bridge?.handleBargeIn({ audioPlaybackActive: true });
+	}
+	isBargeInEnabled() {
+		if (this.requireWakeName) return false;
+		const providerId = this.realtimeProviderId ?? this.realtimeConfig?.provider ?? "openai";
+		return resolveDiscordRealtimeBargeIn({
+			realtimeConfig: this.realtimeConfig,
+			providerId
+		});
+	}
+	hasInterruptibleOutputAudio() {
+		this.syncOutputAudioTimestamp();
+		return this.outputActivity.isInterruptible(this.isOutputStreamActive());
+	}
+	get realtimeConfig() {
+		return this.params.discordConfig.voice?.realtime;
+	}
+	sendOutputAudio(realtimePcm24kMono) {
+		const discordPcm = convertRealtimePcm24kMonoToDiscordPcm48kStereo(realtimePcm24kMono);
+		if (discordPcm.length === 0) return;
+		this.syncOutputAudioTimestamp();
+		if (this.outputActivity.snapshot().streamEnding) {
+			logVoiceVerbose(`realtime output audio ignored after stream ending: guild ${this.params.entry.guildId} channel ${this.params.entry.channelId}`);
+			return;
+		}
+		const stream = this.ensureOutputStream();
+		if (this.exactSpeechResponseActive) this.exactSpeechAudioStarted = true;
+		this.outputActivity.markAudio({
+			audioMs: pcm16MonoDurationMs(realtimePcm24kMono, REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ.sampleRateHz),
+			sourceAudioBytes: realtimePcm24kMono.length,
+			sinkAudioBytes: discordPcm.length
+		});
+		this.queueOutputAudio(stream, discordPcm);
+	}
+	ensureOutputStream() {
+		if (this.outputStream && !this.outputStream.destroyed && !this.outputStream.writableEnded) return this.outputStream;
+		const stream = new PassThrough({ highWaterMark: DISCORD_RAW_PCM_FRAME_BYTES * 128 });
+		this.outputStream = stream;
+		this.outputPacedBuffer = Buffer.alloc(0);
+		this.outputActivity.markStreamOpened();
+		stream.once("close", () => {
+			if (this.outputActivity.snapshot().playbackStarted) return;
+			this.handleOutputStreamClosed(stream, "stream-close");
+		});
+		return stream;
+	}
+	handleOutputStreamClosed(stream, reason) {
+		if (this.outputStream !== stream) return;
+		this.logOutputAudioStopped(reason);
+		this.clearOutputPlaybackWatchdog();
+		this.outputStream = null;
+		this.resetOutputAudioStats();
+		this.completeExactSpeechResponse(reason);
+	}
+	queueOutputAudio(stream, discordPcm) {
+		if (this.outputActivity.snapshot().playbackStarted) {
+			stream.write(discordPcm);
+			return;
+		}
+		this.outputPacedBuffer = this.outputPacedBuffer.length > 0 ? Buffer.concat([this.outputPacedBuffer, discordPcm]) : discordPcm;
+		if (this.outputPacedBuffer.length >= DISCORD_RAW_PCM_FRAME_BYTES * DISCORD_REALTIME_OUTPUT_PREROLL_FRAMES) this.startOutputPlayback(stream);
+	}
+	startOutputPlayback(stream) {
+		if (this.outputActivity.snapshot().playbackStarted || stream.destroyed) return;
+		const voiceSdk = loadDiscordVoiceSdk();
+		const opusStream = createDiscordOpusEncodeStream();
+		opusStream.on("error", (err) => {
+			logger$2.warn(`discord voice: realtime opus encode failed guild=${this.params.entry.guildId} channel=${this.params.entry.channelId}: ${formatErrorMessage(err)}`);
+			this.resetOutputStream("opus-encode-error");
+		});
+		opusStream.once("close", () => this.handleOutputStreamClosed(stream, "stream-close"));
+		pipeline(stream, opusStream, (err) => {
+			if (!err) return;
+			logger$2.warn(`discord voice: realtime output pipeline failed guild=${this.params.entry.guildId} channel=${this.params.entry.channelId}: ${formatErrorMessage(err)}`);
+			this.resetOutputStream("output-pipeline-error");
+		});
+		if (this.outputPacedBuffer.length > 0) {
+			stream.write(this.outputPacedBuffer);
+			this.outputPacedBuffer = Buffer.alloc(0);
+		}
+		const resource = voiceSdk.createAudioResource(opusStream, { inputType: voiceSdk.StreamType.Opus });
+		this.params.entry.player.play(resource);
+		this.outputActivity.markPlaybackStarted();
+		const realtimeConfig = this.realtimeConfig;
+		logger$2.info(`discord voice: realtime audio playback started guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} mode=${this.params.mode} model=${realtimeConfig?.model ?? "provider-default"} voice=${realtimeConfig?.voice ?? "provider-default"}`);
+	}
+	clearOutputAudio(reason = "clear") {
+		this.resetOutputStream(reason);
+		this.params.entry.player.stop(true);
+	}
+	resetOutputStream(reason = "reset") {
+		const stream = this.outputStream;
+		this.clearOutputPlaybackWatchdog();
+		this.logOutputAudioStopped(reason);
+		this.outputStream = null;
+		this.outputPacedBuffer = Buffer.alloc(0);
+		this.resetOutputAudioStats();
+		stream?.end();
+		stream?.destroy();
+	}
+	finishOutputAudioStream(reason, { playBuffered = true } = {}) {
+		const stream = this.outputStream;
+		if (!stream || stream.destroyed || this.outputActivity.snapshot().streamEnding) return;
+		this.outputActivity.markStreamEnding();
+		logger$2.info(`discord voice: realtime audio playback finishing reason=${reason} guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} audioMs=${this.outputAudioMs()} chunks=${this.outputAudioChunks()}`);
+		if (playBuffered) {
+			this.startOutputPlayback(stream);
+			this.scheduleOutputPlaybackWatchdog(reason, stream);
+		} else {
+			this.resetOutputStream(reason);
+			this.params.entry.player.stop(true);
+			this.completeExactSpeechResponse(reason);
+			return;
+		}
+		stream.end();
+	}
+	scheduleOutputPlaybackWatchdog(reason, stream) {
+		this.clearOutputPlaybackWatchdog();
+		const timeoutMs = this.outputActivity.playbackWatchdogDelayMs({ marginMs: DISCORD_REALTIME_OUTPUT_PLAYBACK_WATCHDOG_MARGIN_MS });
+		if (timeoutMs === void 0) return;
+		this.outputPlaybackWatchdog = setTimeout(() => {
+			this.outputPlaybackWatchdog = void 0;
+			if (this.outputStream && this.outputStream !== stream) return;
+			if (!this.outputStream && !this.isOutputAudioActive()) {
+				this.completeExactSpeechResponse("playback-watchdog");
+				return;
+			}
+			logger$2.warn(`discord voice: realtime audio playback watchdog fired reason=${reason} guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} audioMs=${this.outputAudioMs()} elapsedMs=${this.outputActivity.elapsedPlaybackMs()}`);
+			this.clearOutputAudio("playback-watchdog");
+			this.completeExactSpeechResponse("playback-watchdog");
+		}, timeoutMs);
+	}
+	clearOutputPlaybackWatchdog() {
+		if (!this.outputPlaybackWatchdog) return;
+		clearTimeout(this.outputPlaybackWatchdog);
+		this.outputPlaybackWatchdog = void 0;
+	}
+	enqueueExactSpeechMessage(text) {
+		if (this.stopped || !text.trim()) return;
+		if (this.exactSpeechResponseActive || this.hasInterruptibleOutputAudio()) {
+			this.queuedExactSpeechMessages.push(text);
+			logger$2.info(`discord voice: realtime exact speech queued guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} queued=${this.queuedExactSpeechMessages.length} outputAudioMs=${this.outputAudioMs()} outputActive=${this.isOutputAudioActive()}`);
+			return;
+		}
+		this.sendExactSpeechMessage(text);
+	}
+	sendExactSpeechMessage(text) {
+		if (this.stopped || !text.trim()) return;
+		this.exactSpeechResponseActive = true;
+		this.exactSpeechAudioStarted = false;
+		this.bridge?.sendUserMessage(buildDiscordSpeakExactUserMessage(text));
+	}
+	sendWakeNameAck(result) {
+		if (!result.allowed || this.stopped || this.exactSpeechResponseActive) return;
+		if (this.hasInterruptibleOutputAudio()) {
+			logger$2.info(`discord voice: realtime wake-name ack skipped outputActive=true voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+			return;
+		}
+		const ack = DISCORD_REALTIME_WAKE_ACKS[this.wakeNameAckIndex % DISCORD_REALTIME_WAKE_ACKS.length];
+		this.wakeNameAckIndex += 1;
+		logger$2.info(`discord voice: realtime wake-name ack canonical=${result.activationName} heard=${result.heardName} match=${result.match} voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+		this.sendExactSpeechMessage(ack ?? "Yeah.");
+	}
+	speakControlResult(text) {
+		const trimmed = text.trim();
+		if (this.stopped || !trimmed) return;
+		this.queuedExactSpeechMessages = [];
+		this.completeExactSpeechResponse("active-run-control", { drain: false });
+		this.bridge?.handleBargeIn?.({
+			audioPlaybackActive: true,
+			force: true
+		});
+		this.clearOutputAudio("active-run-control");
+		this.lastControlSpeech = {
+			normalizedText: normalizeControlSpeechText(trimmed),
+			sentAt: Date.now(),
+			assistantTranscriptCount: 0
+		};
+		this.sendExactSpeechMessage(trimmed);
+	}
+	suppressDuplicateControlSpeech(text) {
+		const recent = this.lastControlSpeech;
+		if (!recent) return;
+		if (Date.now() - recent.sentAt > DISCORD_REALTIME_CONTROL_SPEECH_DEDUPE_MS) {
+			this.lastControlSpeech = void 0;
+			return;
+		}
+		if (normalizeControlSpeechText(text) !== recent.normalizedText) return;
+		recent.assistantTranscriptCount += 1;
+		if (recent.assistantTranscriptCount <= 1) return;
+		logger$2.info(`discord voice: realtime duplicate active-run control speech suppressed guild=${this.params.entry.guildId} channel=${this.params.entry.channelId}`);
+		this.bridge?.handleBargeIn?.({
+			audioPlaybackActive: true,
+			force: true
+		});
+		this.clearOutputAudio("duplicate-active-run-control");
+	}
+	completeExactSpeechResponse(reason, options) {
+		if (!this.exactSpeechResponseActive && this.queuedExactSpeechMessages.length === 0) return;
+		this.exactSpeechResponseActive = false;
+		this.exactSpeechAudioStarted = false;
+		if (options?.drain === false) return;
+		this.drainQueuedExactSpeechMessages(reason);
+	}
+	drainQueuedExactSpeechMessages(reason) {
+		if (this.stopped || this.exactSpeechResponseActive || this.queuedExactSpeechMessages.length === 0 || this.hasInterruptibleOutputAudio()) return;
+		const next = this.queuedExactSpeechMessages.shift();
+		if (!next) return;
+		logger$2.info(`discord voice: realtime exact speech dequeued reason=${reason} guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} queued=${this.queuedExactSpeechMessages.length}`);
+		this.sendExactSpeechMessage(next);
+	}
+	logOutputAudioStopped(reason) {
+		const activity = this.outputActivity.snapshot();
+		const audioMs = Math.floor(activity.audioMs);
+		const chunks = activity.chunks;
+		const discordBytes = activity.sinkAudioBytes;
+		const realtimeBytes = activity.sourceAudioBytes;
+		const elapsedMs = this.outputActivity.elapsedPlaybackMs();
+		if (this.outputStream || chunks > 0 || audioMs > 0) logger$2.info(`discord voice: realtime audio playback stopped reason=${reason} guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} audioMs=${audioMs} elapsedMs=${elapsedMs} chunks=${chunks} discordBytes=${discordBytes} realtimeBytes=${realtimeBytes}`);
+	}
+	resetOutputAudioStats() {
+		this.outputPacedBuffer = Buffer.alloc(0);
+		this.outputActivity.reset();
+	}
+	syncOutputAudioTimestamp() {
+		this.bridge?.setMediaTimestamp(this.outputAudioMs());
+	}
+	outputAudioMs() {
+		return Math.floor(this.outputActivity.snapshot().audioMs);
+	}
+	outputAudioChunks() {
+		return this.outputActivity.snapshot().chunks;
+	}
+	isOutputStreamActive() {
+		return Boolean(this.outputStream && !this.outputStream.destroyed);
+	}
+	isOutputAudioActive() {
+		return this.outputActivity.isActive(this.isOutputStreamActive());
+	}
+	logSpeakerTurnClosed(turn) {
+		if (turn.closed || !turn.hasAudio) return;
+		const elapsedMs = Date.now() - turn.startedAt;
+		const sinceLastAudioMs = turn.lastAudioAt ? Date.now() - turn.lastAudioAt : void 0;
+		logger$2.info(`discord voice: realtime speaker turn closed guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} user=${turn.context.userId} speaker=${turn.context.speakerLabel} owner=${turn.context.senderIsOwner} hasAudio=${turn.hasAudio} chunks=${turn.inputChunks} discordBytes=${turn.inputDiscordBytes} realtimeBytes=${turn.inputRealtimeBytes} elapsedMs=${elapsedMs}${sinceLastAudioMs === void 0 ? "" : ` sinceLastAudioMs=${sinceLastAudioMs}`} interruptedPlayback=${turn.interruptedPlayback}`);
+	}
+	sendRealtimeTrailingSilenceForTurn(turn) {
+		if (!this.bridge || this.stopped || turn.closed || !turn.hasAudio) return;
+		const providerId = this.realtimeProviderId ?? this.realtimeConfig?.provider ?? "openai";
+		const rawSilenceDurationMs = (this.realtimeConfig?.providers?.[providerId])?.silenceDurationMs;
+		const silenceMs = Math.min(DISCORD_REALTIME_TRAILING_SILENCE_MAX_MS, Math.max(DISCORD_REALTIME_TRAILING_SILENCE_MIN_MS, typeof rawSilenceDurationMs === "number" && Number.isFinite(rawSilenceDurationMs) ? rawSilenceDurationMs : 0));
+		const silenceBytes = Math.ceil(REALTIME_VOICE_AUDIO_FORMAT_PCM16_24KHZ.sampleRateHz * silenceMs / 1e3) * REALTIME_PCM16_BYTES_PER_SAMPLE;
+		const silence = Buffer.alloc(silenceBytes);
+		this.bridge.sendAudio(silence);
+		logger$2.info(`discord voice: realtime trailing silence sent guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} user=${turn.context.userId} speaker=${turn.context.speakerLabel} silenceMs=${silenceMs} realtimeBytes=${silence.length}`);
+	}
+	handleToolCall(event, session) {
+		const callId = event.callId || event.itemId || "unknown";
+		if (event.name === REALTIME_VOICE_AGENT_CONTROL_TOOL_NAME) {
+			this.handleAgentControlToolCall(event, session, callId);
+			return;
+		}
+		if (event.name !== REALTIME_VOICE_AGENT_CONSULT_TOOL_NAME) {
+			session.submitToolResult(callId, { error: `Tool "${event.name}" not available` });
+			return;
+		}
+		if (this.consultToolPolicy === "none") {
+			session.submitToolResult(callId, { error: `Tool "${event.name}" not available` });
+			return;
+		}
+		const exactSpeechText = extractDiscordExactSpeechConsultText(event.args);
+		if (exactSpeechText !== void 0) {
+			logger$2.info(`discord voice: realtime exact speech consult bypassed call=${callId || "unknown"} answerChars=${exactSpeechText.length}`);
+			session.submitToolResult(callId, { text: exactSpeechText });
+			return;
+		}
+		let consultMessage;
+		try {
+			consultMessage = buildRealtimeVoiceAgentConsultChatMessage(event.args);
+		} catch (error) {
+			const message = formatErrorMessage(error);
+			logger$2.warn(`discord voice: realtime consult rejected malformed args call=${callId || "unknown"}: ${message}`);
+			session.submitToolResult(callId, { error: message });
+			return;
+		}
+		logger$2.info(`discord voice: realtime consult requested call=${callId || "unknown"} voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId} question=${formatVoiceLogPreview(consultMessage)}`);
+		const nativeConsult = this.forcedConsults.recordNativeConsult(event.args, callId);
+		const pendingConsult = nativeConsult.kind === "pending" ? nativeConsult.handle : void 0;
+		if (pendingConsult) this.forcedConsults.rememberQuestion(pendingConsult, consultMessage);
+		let context = pendingConsult?.context?.speaker;
+		let recent = pendingConsult;
+		if (!context) {
+			const recentConsult = nativeConsult.kind === "in_flight" || nativeConsult.kind === "already_delivered" ? nativeConsult.handle : this.findRecentAgentProxyConsultContext(consultMessage);
+			if (recentConsult) {
+				const recentSpeaker = recentConsult.context?.speaker;
+				if (this.hasPendingSpeakerAudioContext()) {
+					logger$2.info(`discord voice: realtime consult matched recent agent result but newer speaker audio is pending call=${callId} speaker=${recentSpeaker?.speakerLabel ?? "unknown"} owner=${recentSpeaker?.senderIsOwner ?? false}`);
+					session.submitToolResult(callId, { error: "Discord speaker context changed before this realtime consult completed" });
+					return;
+				}
+				if (this.submitRecentAgentProxyConsultResult(callId, recentConsult, session)) return;
+			}
+		}
+		if (!context) {
+			context = this.consumePendingSpeakerContext();
+			if (context) recent = this.rememberRecentAgentProxyConsultContext(consultMessage, context, {
+				...callId === "unknown" ? {} : { id: `native-consult:${callId}` },
+				started: true
+			});
+		}
+		if (!context) {
+			logger$2.warn(`discord voice: realtime consult has no speaker context call=${callId || "unknown"}`);
+			session.submitToolResult(callId, { error: "No Discord speaker context available" });
+			return;
+		}
+		const promise = this.runAgentTurn({
+			context,
+			message: consultMessage
+		});
+		if (recent) this.setRecentAgentProxyConsultPromise(recent, promise);
+		promise.then((text) => {
+			logger$2.info(`discord voice: realtime consult answer (${text.length} chars) voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId} speaker=${context.speakerLabel} owner=${context.senderIsOwner}: ${formatVoiceLogPreview(text)}`);
+			session.submitToolResult(callId, { text });
+		}).catch((error) => {
+			logger$2.warn(`discord voice: realtime consult failed call=${callId || "unknown"}: ${formatErrorMessage(error)}`);
+			session.submitToolResult(callId, { error: formatErrorMessage(error) });
+		});
+	}
+	async handleAgentControlToolCall(event, session, callId) {
+		try {
+			const parsed = parseRealtimeVoiceAgentControlToolArgs(event.args);
+			const result = await controlRealtimeVoiceAgentRun({
+				sessionKey: this.params.entry.route.sessionKey,
+				text: parsed.text,
+				mode: parsed.mode
+			});
+			this.logAgentControlResult(result);
+			session.submitToolResult(callId, result);
+		} catch (error) {
+			session.submitToolResult(callId, { error: formatErrorMessage(error) });
+		}
+	}
+	async runAgentTurn(params) {
+		const context = params.context;
+		if (!context) return "";
+		return this.params.runAgentTurn({
+			context,
+			message: params.message,
+			toolsAllow: this.consultToolsAllow,
+			userId: context.userId
+		});
+	}
+	async handleFinalUserTranscript(text, params) {
+		const trimmed = text.trim();
+		if (!trimmed) return;
+		this.partialUserTranscript = "";
+		const transcriptsTurn = this.peekPendingSpeakerTurn();
+		let transcriptAttribution = this.transcriptAttributionFromTurn(transcriptsTurn);
+		const wakeNameResult = this.resolveWakeNameTranscript(trimmed);
+		let forcedSpeakerContext;
+		if (!wakeNameResult.allowed) {
+			const pendingWakeNameFollowup = this.consumePendingWakeNameFollowup();
+			transcriptAttribution ??= pendingWakeNameFollowup;
+			if (!pendingWakeNameFollowup) {
+				this.recordTranscriptUtterance(trimmed, transcriptAttribution);
+				this.rememberIgnoredWakeNameSpeakerContext(this.consumePendingSpeakerContext());
+				logger$2.info(`discord voice: realtime wake-name gate ignored transcript chars=${trimmed.length} voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId} wakeNames=${this.wakeNames.join(",") || "none"}`);
+				return;
+			}
+			forcedSpeakerContext = pendingWakeNameFollowup.context;
+			logger$2.info(`discord voice: realtime wake-name follow-up accepted chars=${trimmed.length} speaker=${forcedSpeakerContext.speakerLabel} voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+		}
+		this.recordTranscriptUtterance(trimmed, transcriptAttribution);
+		const acceptedText = wakeNameResult.allowed ? wakeNameResult.text || trimmed : trimmed;
+		if (wakeNameResult.allowed && !wakeNameResult.text.trim()) {
+			this.armWakeNameFollowup();
+			return;
+		}
+		if (wakeNameResult.allowed) this.pendingWakeNameFollowup = void 0;
+		const usesAgentProxy = isDiscordAgentProxyVoiceMode(this.params.mode);
+		const pendingForcedConsult = usesAgentProxy && params.usesRealtimeAgentHandoff ? this.prepareForcedAgentProxyConsult(acceptedText, forcedSpeakerContext) : void 0;
+		const control = await maybeControlDiscordVoiceAgentRun({
+			entry: this.params.entry,
+			text: acceptedText
+		}).catch((error) => {
+			logger$2.warn(`discord voice: realtime active-run control failed; falling back to normal transcript handling: ${formatErrorMessage(error)}`);
+		});
+		if (control?.handled) {
+			if (pendingForcedConsult) this.forcedConsults.remove(pendingForcedConsult);
+			this.logAgentControlResult(control.result);
+			if (control.speakText) this.speakControlResult(control.speakText);
+			return;
+		}
+		if (!usesAgentProxy) return;
+		if (params.usesRealtimeAgentHandoff) {
+			if (pendingForcedConsult) this.schedulePreparedForcedAgentProxyConsult(pendingForcedConsult);
+			return;
+		}
+		this.talkback.enqueue(acceptedText, forcedSpeakerContext ?? this.consumePendingSpeakerContext());
+	}
+	handlePartialUserTranscript(text) {
+		if (!this.requireWakeName || this.wakeNameAckedForTurn) return;
+		this.partialUserTranscript = mergeRealtimePartialTranscript(this.partialUserTranscript, text);
+		const wakeNameResult = matchRealtimeVoiceActivationName(this.partialUserTranscript, this.wakeNames);
+		if (!wakeNameResult || wakeNameResult.edge !== "leading") return;
+		this.wakeNameAckedForTurn = true;
+		this.sendWakeNameAck(wakeNameResult);
+	}
+	resetPartialWakeNameTracking() {
+		this.partialUserTranscript = "";
+		this.wakeNameAckedForTurn = false;
+	}
+	resolveWakeNameTranscript(text) {
+		if (!this.requireWakeName) return {
+			allowed: true,
+			text,
+			activationName: "",
+			heardName: "",
+			match: "exact",
+			edge: "leading"
+		};
+		const wakeNameResult = matchRealtimeVoiceActivationName(text, this.wakeNames);
+		if (wakeNameResult) {
+			logger$2.info(`discord voice: realtime wake-name gate matched canonical=${wakeNameResult.activationName} heard=${wakeNameResult.heardName} match=${wakeNameResult.match} voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+			return wakeNameResult;
+		}
+		return {
+			allowed: false,
+			text
+		};
+	}
+	transcriptAttributionFromTurn(turn) {
+		return turn ? {
+			context: turn.context,
+			startedAt: turn.startedAt
+		} : void 0;
+	}
+	recordTranscriptUtterance(text, attribution) {
+		const transcripts = this.params.entry.transcripts;
+		if (!transcripts || !attribution) return;
+		const context = attribution.context;
+		const utterance = {
+			sessionId: transcripts.sessionId,
+			startedAt: new Date(attribution.startedAt).toISOString(),
+			final: true,
+			speaker: {
+				id: context.userId,
+				label: context.speakerLabel
+			},
+			text,
+			metadata: {
+				channel: "discord",
+				guildId: this.params.entry.guildId,
+				channelId: this.params.entry.channelId,
+				voiceSessionKey: this.params.entry.voiceSessionKey
+			}
+		};
+		Promise.resolve().then(() => transcripts.onUtterance(utterance)).catch((error) => {
+			logger$2.warn(`discord voice: realtime transcripts utterance failed: ${formatErrorMessage(error)}`);
+		});
+	}
+	logAgentControlResult(result) {
+		logger$2.info(`discord voice: realtime active-run control handled mode=${result.mode} ok=${result.ok} active=${result.active} reason=${result.reason ?? "none"} voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId}`);
+	}
+	prepareForcedAgentProxyConsult(transcript, speakerContext) {
+		if (this.consultPolicy !== "always" && !this.requireWakeName) return;
+		const question = transcript.trim();
+		if (!question) return;
+		const skipReason = classifySkippableRealtimeVoiceConsultTranscript(question);
+		if (skipReason) {
+			const context = this.consumePendingSpeakerContext();
+			logger$2.info(`discord voice: realtime forced agent consult skipped reason=${skipReason} chars=${question.length} speaker=${context?.speakerLabel ?? "unknown"} transcript=${formatVoiceLogPreview(question)}`);
+			return;
+		}
+		let context = speakerContext ?? this.consumePendingSpeakerContext();
+		if (!context) context = this.consumeRecentIgnoredWakeNameSpeakerContext();
+		if (!context) {
+			const recent = this.findRecentAgentProxyConsultContext(question);
+			if (recent) {
+				logVoiceVerbose(`realtime forced agent consult skipped (already delegated): guild ${this.params.entry.guildId} channel ${this.params.entry.channelId} speaker ${recent.context?.speaker.userId ?? "unknown"}`);
+				return;
+			}
+			logger$2.warn("discord voice: realtime forced agent consult has no speaker context");
+			return;
+		}
+		return this.forcedConsults.prepare(question, { context: { speaker: context } });
+	}
+	schedulePreparedForcedAgentProxyConsult(pending) {
+		this.forcedConsults.schedule(pending, DISCORD_REALTIME_FORCED_CONSULT_FALLBACK_DELAY_MS, (handle) => void this.runForcedAgentProxyConsult(handle));
+	}
+	async runForcedAgentProxyConsult(pending) {
+		this.forcedConsults.markStarted(pending);
+		const state = pending.context;
+		if (!state) {
+			this.forcedConsults.markCancelled(pending);
+			return;
+		}
+		const context = state.speaker;
+		const { question } = pending;
+		if (this.stopped) {
+			this.forcedConsults.markCancelled(pending);
+			return;
+		}
+		const startedAt = Date.now();
+		logger$2.info(`discord voice: realtime forced agent consult starting chars=${question.length} voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId} speaker=${context.speakerLabel} owner=${context.senderIsOwner}`);
+		logger$2.debug(`discord voice: realtime forced agent consult reason=${DISCORD_REALTIME_FORCED_CONSULT_REASON} consultPolicy=${this.consultPolicy} requireWakeName=${this.requireWakeName} voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId} speaker=${context.speakerLabel}`);
+		if (this.hasInterruptibleOutputAudio()) logger$2.info(`discord voice: realtime forced agent consult preserving active playback guild=${this.params.entry.guildId} channel=${this.params.entry.channelId} outputAudioMs=${this.outputAudioMs()} outputActive=${this.isOutputAudioActive()} playbackChunks=${this.outputAudioChunks()}`);
+		state.handledByForcedPlayback = true;
+		try {
+			const promise = this.runAgentTurn({
+				context,
+				message: question
+			});
+			this.setRecentAgentProxyConsultPromise(pending, promise);
+			const text = await promise;
+			logger$2.info(`discord voice: realtime forced agent consult answer (${text.length} chars) elapsedMs=${Date.now() - startedAt} voiceSession=${this.params.entry.voiceSessionKey} supervisorSession=${this.params.entry.route.sessionKey} agent=${this.params.entry.route.agentId}: ${formatVoiceLogPreview(text)}`);
+			if (text.trim()) this.enqueueExactSpeechMessage(text);
+		} catch (error) {
+			logger$2.warn(`discord voice: realtime forced agent consult failed elapsedMs=${Date.now() - startedAt}: ${formatErrorMessage(error)}`);
+			this.enqueueExactSpeechMessage(DISCORD_REALTIME_FALLBACK_TEXT);
+		}
+	}
+	consumePendingSpeakerContext() {
+		return this.speakerTurns.consumeAudioContext();
+	}
+	armWakeNameFollowup() {
+		const turn = this.peekPendingSpeakerTurn();
+		const context = this.consumePendingSpeakerContext();
+		if (!context) {
+			logger$2.warn(`discord voice: realtime wake-name follow-up has no speaker context voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+			return;
+		}
+		const expiresAt = resolveExpiresAtMsFromDurationMs(DISCORD_REALTIME_WAKE_NAME_FOLLOWUP_TTL_MS);
+		if (expiresAt === void 0) return;
+		this.pendingWakeNameFollowup = {
+			context,
+			startedAt: turn?.startedAt ?? Date.now(),
+			expiresAt
+		};
+		logger$2.info(`discord voice: realtime wake-name follow-up armed speaker=${context.speakerLabel} voiceSession=${this.params.entry.voiceSessionKey} agent=${this.params.entry.route.agentId}`);
+	}
+	consumePendingWakeNameFollowup() {
+		const pending = this.pendingWakeNameFollowup;
+		this.pendingWakeNameFollowup = void 0;
+		const now = asDateTimestampMs(Date.now());
+		const expiresAt = pending ? asDateTimestampMs(pending.expiresAt) : void 0;
+		if (!pending || now === void 0 || expiresAt === void 0 || now > expiresAt) return;
+		const currentTurn = this.peekPendingSpeakerTurn();
+		if (currentTurn && currentTurn.context.userId !== pending.context.userId) return;
+		if (currentTurn) this.consumePendingSpeakerContext();
+		return {
+			context: pending.context,
+			startedAt: pending.startedAt
+		};
+	}
+	rememberIgnoredWakeNameSpeakerContext(context) {
+		this.speakerTurns.rememberIgnoredContext(context);
+	}
+	consumeRecentIgnoredWakeNameSpeakerContext() {
+		return this.speakerTurns.consumeIgnoredContext();
+	}
+	peekPendingSpeakerTurn() {
+		return this.speakerTurns.peekAudioTurn();
+	}
+	hasPendingSpeakerAudioContext() {
+		return this.speakerTurns.hasAudioContext();
+	}
+	rememberRecentAgentProxyConsultContext(question, context, options = {}) {
+		const handle = this.forcedConsults.prepare(question, {
+			context: { speaker: context },
+			...options.id ? { id: options.id } : {}
+		});
+		if (!handle) throw new Error("Discord realtime consult context requires a non-empty question");
+		if (options.started) this.forcedConsults.markStarted(handle);
+		return handle;
+	}
+	setRecentAgentProxyConsultPromise(recent, promise) {
+		const state = recent.context;
+		if (!state) return;
+		this.forcedConsults.markStarted(recent);
+		state.promise = promise;
+		promise.then((text) => {
+			state.result = {
+				status: "fulfilled",
+				text
+			};
+			this.forcedConsults.markDelivered(recent);
+		}).catch((error) => {
+			state.result = {
+				status: "rejected",
+				error: formatErrorMessage(error)
+			};
+			this.forcedConsults.markDelivered(recent);
+		});
+	}
+	findRecentAgentProxyConsultContext(consultMessage) {
+		return this.forcedConsults.findRecent(consultMessage);
+	}
+	submitRecentAgentProxyConsultResult(callId, recent, session) {
+		const state = recent.context;
+		if (!state) return false;
+		const submitAlreadyDelivered = () => {
+			session.submitToolResult(callId, {
+				status: "already_delivered",
+				message: "OpenClaw already delivered this answer to Discord voice."
+			}, { suppressResponse: true });
+		};
+		const submitResult = (result) => {
+			if (state.handledByForcedPlayback) {
+				submitAlreadyDelivered();
+				return;
+			}
+			if (result.status === "fulfilled") {
+				session.submitToolResult(callId, { text: result.text });
+				return;
+			}
+			session.submitToolResult(callId, { error: result.error });
+		};
+		if (state.result) {
+			logger$2.info(`discord voice: realtime consult reused recent agent result call=${callId || "unknown"} speaker=${state.speaker.speakerLabel} owner=${state.speaker.senderIsOwner}`);
+			submitResult(state.result);
+			return true;
+		}
+		if (!state.promise) return false;
+		logger$2.info(`discord voice: realtime consult joined in-flight agent result call=${callId || "unknown"} speaker=${state.speaker.speakerLabel} owner=${state.speaker.senderIsOwner}`);
+		if (state.handledByForcedPlayback) {
+			state.promise.then(submitAlreadyDelivered, submitAlreadyDelivered);
+			return true;
+		}
+		state.promise.then((text) => session.submitToolResult(callId, { text })).catch((error) => session.submitToolResult(callId, { error: formatErrorMessage(error) }));
+		return true;
+	}
+};
+function isDiscordRealtimeSpeakerContext(value) {
+	return Boolean(value) && typeof value === "object" && typeof value.userId === "string" && typeof value.senderIsOwner === "boolean" && typeof value.speakerLabel === "string";
+}
+function pcm16MonoDurationMs(audio, sampleRate) {
+	if (audio.length === 0 || sampleRate <= 0) return 0;
+	return audio.length / REALTIME_PCM16_BYTES_PER_SAMPLE * 1e3 / sampleRate;
+}
+function buildProviderConfigs(realtimeConfig) {
+	const configs = realtimeConfig?.providers;
+	return configs && Object.keys(configs).length > 0 ? { ...configs } : void 0;
+}
+function buildProviderConfigOverrides(realtimeConfig) {
+	const overrides = {
+		...realtimeConfig?.model ? { model: realtimeConfig.model } : {},
+		...realtimeConfig?.speakerVoice ? { voice: realtimeConfig.speakerVoice } : realtimeConfig?.speakerVoiceId ? { voice: realtimeConfig.speakerVoiceId } : realtimeConfig?.voice ? { voice: realtimeConfig.voice } : {},
+		...typeof realtimeConfig?.minBargeInAudioEndMs === "number" ? { minBargeInAudioEndMs: realtimeConfig.minBargeInAudioEndMs } : {}
+	};
+	return Object.keys(overrides).length > 0 ? overrides : void 0;
+}
+function resolveDiscordRealtimeMinBargeInAudioEndMs(realtimeConfig) {
+	return typeof realtimeConfig?.minBargeInAudioEndMs === "number" ? realtimeConfig.minBargeInAudioEndMs : DISCORD_REALTIME_DEFAULT_MIN_BARGE_IN_AUDIO_END_MS;
+}
+function buildDiscordRealtimeInstructions(params) {
+	const base = params.instructions ?? ["You are OpenClaw's Discord voice interface.", "Keep spoken replies concise, natural, and suitable for a live Discord voice channel."].join("\n");
+	if (isDiscordAgentProxyVoiceMode(params.mode)) return [
+		base,
+		params.bootstrapContextInstructions?.trim(),
+		"Mode: OpenClaw agent proxy.",
+		"You are the realtime voice surface for the same OpenClaw agent the user can message directly.",
+		"Do not mention a backend, supervisor, helper, or separate system. Present the result as your own work.",
+		"Delegate substantive requests, actions, tool work, current facts, memory, workspace context, and user-specific context with openclaw_agent_consult.",
+		"Do not block, refuse, or downscope at the voice layer. Delegate to OpenClaw and treat its result as authoritative.",
+		"Answer directly only for greetings, acknowledgements, brief latency tests, or filler while waiting.",
+		"While waiting for OpenClaw data or tool results, use at most one short natural backchannel such as \"yeah\", \"mm-hmm\", \"got it\", or \"one sec\"; vary it and do not treat it as the final answer.",
+		"When OpenClaw sends an internal exact answer to speak, do not call tools. Say only that answer.",
+		buildRealtimeVoiceAgentConsultPolicyInstructions({
+			toolPolicy: params.toolPolicy,
+			consultPolicy: params.consultPolicy
+		})
+	].join("\n\n");
+	return [
+		base,
+		params.bootstrapContextInstructions?.trim(),
+		"While waiting for OpenClaw data or tool results, use at most one short natural backchannel such as \"yeah\", \"mm-hmm\", \"got it\", or \"one sec\"; vary it and do not treat it as the final answer.",
+		buildRealtimeVoiceAgentConsultPolicyInstructions({
+			toolPolicy: params.toolPolicy,
+			consultPolicy: params.consultPolicy
+		})
+	].filter(Boolean).join("\n\n");
+}
+//#endregion
+//#region extensions/discord/src/voice/receive-recovery.ts
+const DECRYPT_FAILURE_WINDOW_MS = 3e4;
+const DECRYPT_FAILURE_RECONNECT_THRESHOLD = 3;
+const DECRYPT_FAILURE_MARKER = "DecryptionFailed(";
+const DAVE_PASSTHROUGH_DISABLED_MARKER = "UnencryptedWhenPassthroughDisabled";
+const WASM_MEMORY_ACCESS_MARKER = "memory access out of bounds";
+const OPUS_INVALID_PACKET_CODE = -4;
+function createVoiceReceiveRecoveryState() {
+	return {
+		decryptFailureCount: 0,
+		lastDecryptFailureAt: 0,
+		decryptRecoveryInFlight: false
+	};
+}
+function isAbortLikeReceiveError(err) {
+	if (!err || typeof err !== "object") return false;
+	const name = "name" in err && typeof err.name === "string" ? err.name : "";
+	const message = "message" in err && typeof err.message === "string" ? err.message : "";
+	return name === "AbortError" || message === "Premature close" || message.includes("The operation was aborted") || message.includes("aborted");
+}
+function isOpusDecodeInvalidPacketError(err) {
+	if (!err || typeof err !== "object") return false;
+	const maybeOpusError = err;
+	const isDecodeOperation = maybeOpusError.operation === "decode" || maybeOpusError.operation === "decodeFloat";
+	const isInvalidPacket = maybeOpusError.code === OPUS_INVALID_PACKET_CODE || maybeOpusError.codeName === "InvalidPacket";
+	return isDecodeOperation && isInvalidPacket && (err instanceof OpusError || maybeOpusError.name === "OpusError");
+}
+function analyzeVoiceReceiveError(err) {
+	const message = formatErrorMessage(err);
+	const normalizedMessage = message.toLowerCase();
+	const shouldAttemptPassthrough = message.includes(DAVE_PASSTHROUGH_DISABLED_MARKER);
+	const isWasmMemoryAccessFailure = normalizedMessage.includes(WASM_MEMORY_ACCESS_MARKER);
+	return {
+		message,
+		isAbortLike: isAbortLikeReceiveError(err),
+		isDecodeCorruption: isOpusDecodeInvalidPacketError(err),
+		shouldAttemptPassthrough,
+		countsAsDecryptFailure: message.includes(DECRYPT_FAILURE_MARKER) || shouldAttemptPassthrough || isWasmMemoryAccessFailure
+	};
+}
+function noteVoiceDecryptFailure(state, now = Date.now()) {
+	if (now - state.lastDecryptFailureAt > DECRYPT_FAILURE_WINDOW_MS) state.decryptFailureCount = 0;
+	state.lastDecryptFailureAt = now;
+	state.decryptFailureCount += 1;
+	const firstFailure = state.decryptFailureCount === 1;
+	if (state.decryptFailureCount < DECRYPT_FAILURE_RECONNECT_THRESHOLD || state.decryptRecoveryInFlight) return {
+		firstFailure,
+		shouldRecover: false
+	};
+	state.decryptRecoveryInFlight = true;
+	resetVoiceReceiveRecoveryState(state);
+	return {
+		firstFailure,
+		shouldRecover: true
+	};
+}
+function resetVoiceReceiveRecoveryState(state) {
+	state.decryptFailureCount = 0;
+	state.lastDecryptFailureAt = 0;
+}
+function finishVoiceDecryptRecovery(state) {
+	state.decryptRecoveryInFlight = false;
+}
+function enableDaveReceivePassthrough(params) {
+	const { target, sdk, reason, expirySeconds, onVerbose, onWarn } = params;
+	const networkingState = target.connection.state.networking?.state;
+	if (target.connection.state.status !== sdk.VoiceConnectionStatus.Ready || !networkingState || networkingState.code !== sdk.NetworkingStatusCode.Ready && networkingState.code !== sdk.NetworkingStatusCode.Resuming) return false;
+	const daveSession = networkingState.dave?.session;
+	if (!daveSession) return false;
+	try {
+		daveSession.setPassthroughMode(true, expirySeconds);
+		onVerbose(`enabled DAVE receive passthrough: guild ${target.guildId} channel ${target.channelId} expiry=${expirySeconds}s reason=${reason}`);
+		return true;
+	} catch (err) {
+		onWarn(`discord voice: failed to enable DAVE passthrough guild=${target.guildId} channel=${target.channelId} reason=${reason}: ${formatErrorMessage(err)}`);
+		return false;
+	}
+}
+//#endregion
+//#region extensions/discord/src/voice/sanitize.ts
+const SPEECH_EMOJI_RE = /(?:\p{Extended_Pictographic}(?:\uFE0F|\u200D|\p{Extended_Pictographic}|\p{Emoji_Modifier})*)+/gu;
+function stripEmojiForSpeech(text) {
+	return text.replace(SPEECH_EMOJI_RE, " ").replace(/\s+([?!.,:;])/g, "$1").replace(/[ \t]{2,}/g, " ").replace(/ *\n */g, "\n").trim();
+}
+function sanitizeVoiceReplyTextForSpeech(text, speakerLabel) {
+	let cleaned = stripInlineDirectiveTagsForDisplay(text).text.trim();
+	if (!cleaned) return "";
+	const label = speakerLabel?.trim();
+	if (label) {
+		const prefix = new RegExp(`^${escapeRegExp(label)}\\s*:\\s*`, "i");
+		cleaned = cleaned.replace(prefix, "").trim();
+	}
+	return stripEmojiForSpeech(cleaned);
+}
+//#endregion
+//#region extensions/discord/src/voice/tts.ts
+function mergeTtsConfig(base, override) {
+	if (!override) return base;
+	const baseProviders = base.providers ?? {};
+	const overrideProviders = override.providers ?? {};
+	const mergedProviders = Object.fromEntries(uniqueStrings([...Object.keys(baseProviders), ...Object.keys(overrideProviders)]).map((providerId) => {
+		const baseProvider = baseProviders[providerId] ?? {};
+		const overrideProvider = overrideProviders[providerId] ?? {};
+		return [providerId, {
+			...baseProvider,
+			...overrideProvider
+		}];
+	}));
+	return {
+		...base,
+		...override,
+		modelOverrides: {
+			...base.modelOverrides,
+			...override.modelOverrides
+		},
+		...Object.keys(mergedProviders).length === 0 ? {} : { providers: mergedProviders }
+	};
+}
+function resolveVoiceTtsConfig(params) {
+	if (!params.override) return {
+		cfg: params.cfg,
+		resolved: resolveTtsConfig(params.cfg)
+	};
+	const merged = mergeTtsConfig(params.cfg.messages?.tts ?? {}, params.override);
+	const messages = params.cfg.messages ?? {};
+	const cfg = {
+		...params.cfg,
+		messages: {
+			...messages,
+			tts: merged
+		}
+	};
+	return {
+		cfg,
+		resolved: resolveTtsConfig(cfg)
+	};
+}
+async function transcribeVoiceAudio(params) {
+	const result = await getDiscordRuntime().mediaUnderstanding.transcribeAudioFile({
+		filePath: params.filePath,
+		cfg: params.cfg,
+		agentDir: resolveAgentDir(params.cfg, params.agentId),
+		mime: "audio/wav"
+	});
+	return normalizeOptionalString(result.text);
+}
+async function synthesizeVoiceReplyAudio(params) {
+	const { cfg: ttsCfg, resolved: ttsConfig } = resolveVoiceTtsConfig({
+		cfg: params.cfg,
+		override: params.override
+	});
+	const directive = parseTtsDirectives(params.replyText, ttsConfig.modelOverrides, {
+		cfg: ttsCfg,
+		providerConfigs: ttsConfig.providerConfigs,
+		preferredProviderId: getTtsProvider(ttsConfig, resolveTtsPrefsPath(ttsConfig))
+	});
+	const speakText = sanitizeVoiceReplyTextForSpeech(directive.overrides.ttsText ?? directive.cleanedText.trim(), params.speakerLabel);
+	if (!speakText) return { status: "empty" };
+	const runtime = getDiscordRuntime();
+	const streamResult = await runtime.tts.textToSpeechStream?.({
+		text: speakText,
+		cfg: ttsCfg,
+		channel: "discord",
+		overrides: directive.overrides,
+		disableFallback: true
+	});
+	if (streamResult?.success && streamResult.audioStream) return {
+		status: "ok",
+		mode: "stream",
+		audioStream: streamResult.audioStream,
+		release: streamResult.release,
+		speakText
+	};
+	const result = await runtime.tts.textToSpeech({
+		text: speakText,
+		cfg: ttsCfg,
+		channel: "discord",
+		overrides: directive.overrides
+	});
+	if (!result.success || !result.audioPath) return {
+		status: "failed",
+		error: result.error ?? "unknown error"
+	};
+	return {
+		status: "ok",
+		mode: "file",
+		audioPath: result.audioPath,
+		speakText
+	};
+}
+//#endregion
+//#region extensions/discord/src/voice/segment.ts
+const logger$1 = createSubsystemLogger("discord/voice");
+async function processDiscordVoiceSegment(params) {
+	const { entry, wavPath, userId, durationSeconds } = params;
+	logVoiceVerbose(`segment processing (${durationSeconds.toFixed(2)}s): guild ${entry.guildId} channel ${entry.channelId}`);
+	const ingress = await resolveDiscordVoiceIngressContext({
+		entry,
+		userId,
+		cfg: params.cfg,
+		discordConfig: params.discordConfig,
+		ownerAllowFrom: params.ownerAllowFrom,
+		fetchGuildName: params.fetchGuildName,
+		speakerContext: params.speakerContext
+	});
+	if (!ingress) {
+		logVoiceVerbose(`segment unauthorized: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+		return;
+	}
+	const transcript = await transcribeVoiceAudio({
+		cfg: params.cfg,
+		agentId: entry.route.agentId,
+		filePath: wavPath
+	});
+	if (!transcript) {
+		logVoiceVerbose(`transcription empty: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+		return;
+	}
+	logVoiceVerbose(`transcription ok (${transcript.length} chars): guild ${entry.guildId} channel ${entry.channelId}`);
+	logVoiceVerbose(`transcript from ${ingress.speakerLabel} (${userId}) in guild ${entry.guildId} channel ${entry.channelId}: ${formatVoiceLogPreview(transcript)}`);
+	if (params.transcripts) {
+		await params.transcripts.onUtterance({
+			sessionId: params.transcripts.sessionId,
+			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			final: true,
+			speaker: {
+				id: userId,
+				label: ingress.speakerLabel
+			},
+			text: transcript,
+			metadata: {
+				channel: "discord",
+				guildId: entry.guildId,
+				channelId: entry.channelId,
+				voiceSessionKey: entry.voiceSessionKey
+			}
+		});
+		return;
+	}
+	let replyText;
+	const control = await maybeControlDiscordVoiceAgentRun({
+		entry,
+		text: transcript
+	}).catch((error) => {
+		logger$1.warn(`discord voice: active-run control failed; falling back to normal segment handling: ${formatErrorMessage(error)}`);
+	});
+	if (control?.handled) {
+		logger$1.info(`discord voice: active-run control handled mode=${control.result.mode} ok=${control.result.ok} active=${control.result.active} reason=${control.result.reason ?? "none"} session=${entry.route.sessionKey}`);
+		replyText = control.speakText ?? "";
+	} else {
+		const turn = await runDiscordVoiceAgentTurn({
+			entry,
+			userId,
+			message: formatVoiceIngressPrompt(transcript, ingress.speakerLabel),
+			cfg: params.cfg,
+			discordConfig: params.discordConfig,
+			runtime: params.runtime,
+			context: ingress,
+			ownerAllowFrom: params.ownerAllowFrom,
+			fetchGuildName: params.fetchGuildName,
+			speakerContext: params.speakerContext
+		});
+		if (!turn) {
+			logVoiceVerbose(`segment unauthorized before agent turn: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			return;
+		}
+		replyText = turn.text;
+	}
+	if (!replyText) {
+		logVoiceVerbose(`reply empty: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+		return;
+	}
+	logVoiceVerbose(`reply ok (${replyText.length} chars): guild ${entry.guildId} channel ${entry.channelId}`);
+	const voiceReplyAudio = await synthesizeVoiceReplyAudio({
+		cfg: params.cfg,
+		override: params.discordConfig.voice?.tts,
+		replyText,
+		speakerLabel: ingress.speakerLabel
+	});
+	if (voiceReplyAudio.status === "empty") {
+		logVoiceVerbose(`tts skipped (empty): guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+		return;
+	}
+	if (voiceReplyAudio.status === "failed") {
+		logger$1.warn(`discord voice: TTS failed: ${voiceReplyAudio.error ?? "unknown error"}`);
+		return;
+	}
+	logVoiceVerbose(`tts ok (${voiceReplyAudio.speakText.length} chars): guild ${entry.guildId} channel ${entry.channelId}`);
+	params.enqueuePlayback(entry, async () => {
+		const voiceSdk = loadDiscordVoiceSdk();
+		const releaseAudioStream = voiceReplyAudio.mode === "stream" ? voiceReplyAudio.release : void 0;
+		try {
+			if (voiceReplyAudio.mode === "stream") {
+				logVoiceVerbose(`playback start: guild ${entry.guildId} channel ${entry.channelId} stream`);
+				const nodeStream = Readable.fromWeb(voiceReplyAudio.audioStream);
+				const resource = voiceSdk.createAudioResource(createDiscordOpusPlaybackStream(nodeStream), { inputType: voiceSdk.StreamType.Opus });
+				entry.player.play(resource);
+			} else {
+				logVoiceVerbose(`playback start: guild ${entry.guildId} channel ${entry.channelId} file ${path.basename(voiceReplyAudio.audioPath)}`);
+				const resource = voiceSdk.createAudioResource(createDiscordOpusPlaybackStream(voiceReplyAudio.audioPath), { inputType: voiceSdk.StreamType.Opus });
+				entry.player.play(resource);
+			}
+			await voiceSdk.entersState(entry.player, voiceSdk.AudioPlayerStatus.Playing, PLAYBACK_READY_TIMEOUT_MS).catch(() => void 0);
+			await voiceSdk.entersState(entry.player, voiceSdk.AudioPlayerStatus.Idle, SPEAKING_READY_TIMEOUT_MS).catch(() => void 0);
+			logVoiceVerbose(`playback done: guild ${entry.guildId} channel ${entry.channelId}`);
+		} finally {
+			await releaseAudioStream?.();
+		}
+	});
+}
+//#endregion
+//#region extensions/discord/src/voice/speaker-context.ts
+const SPEAKER_CONTEXT_CACHE_TTL_MS = 6e4;
+var DiscordVoiceSpeakerContextResolver = class {
+	constructor(params) {
+		this.params = params;
+		this.cache = /* @__PURE__ */ new Map();
+	}
+	async resolveContext(guildId, userId) {
+		const cached = this.getCachedContext(guildId, userId);
+		if (cached) return cached;
+		const identity = await this.resolveIdentity(guildId, userId);
+		const context = {
+			id: identity.id,
+			label: identity.label,
+			name: identity.name,
+			tag: identity.tag,
+			senderIsOwner: this.resolveIsOwner(identity)
+		};
+		this.setCachedContext(guildId, userId, context);
+		return context;
+	}
+	async resolveIdentity(guildId, userId) {
+		try {
+			const member = await this.params.client.fetchMember(guildId, userId);
+			const username = member.user?.username ?? void 0;
+			return {
+				id: userId,
+				label: member.nickname ?? member.user?.globalName ?? username ?? userId,
+				name: username,
+				tag: member.user ? formatDiscordUserTag(member.user) : void 0,
+				memberRoleIds: Array.isArray(member.roles) ? member.roles.map((role) => typeof role === "string" ? role : typeof role?.id === "string" ? role.id : "").filter(Boolean) : []
+			};
+		} catch {
+			try {
+				const user = await this.params.client.fetchUser(userId);
+				const username = user.username ?? void 0;
+				return {
+					id: userId,
+					label: user.globalName ?? username ?? userId,
+					name: username,
+					tag: formatDiscordUserTag(user),
+					memberRoleIds: []
+				};
+			} catch {
+				return {
+					id: userId,
+					label: userId,
+					memberRoleIds: []
+				};
+			}
+		}
+	}
+	resolveIsOwner(identity) {
+		return resolveDiscordOwnerAccess({
+			allowFrom: this.params.ownerAllowFrom,
+			sender: {
+				id: identity.id,
+				name: identity.name,
+				tag: identity.tag
+			},
+			allowNameMatching: false
+		}).ownerAllowed;
+	}
+	resolveCacheKey(guildId, userId) {
+		return `${guildId}:${userId}`;
+	}
+	getCachedContext(guildId, userId) {
+		const key = this.resolveCacheKey(guildId, userId);
+		const cached = this.cache.get(key);
+		if (!cached) return;
+		const now = asDateTimestampMs(Date.now());
+		const expiresAt = asDateTimestampMs(cached.expiresAt);
+		if (now === void 0 || expiresAt === void 0 || expiresAt <= now) {
+			this.cache.delete(key);
+			return;
+		}
+		return {
+			id: cached.id,
+			label: cached.label,
+			name: cached.name,
+			tag: cached.tag,
+			senderIsOwner: cached.senderIsOwner
+		};
+	}
+	setCachedContext(guildId, userId, context) {
+		const key = this.resolveCacheKey(guildId, userId);
+		const expiresAt = resolveExpiresAtMsFromDurationMs(SPEAKER_CONTEXT_CACHE_TTL_MS);
+		if (expiresAt !== void 0) this.cache.set(key, {
+			...context,
+			expiresAt
+		});
+	}
+};
+//#endregion
+//#region extensions/discord/src/voice/manager.ts
+const logger = createSubsystemLogger("discord/voice");
+const FOLLOW_USERS_RECONCILE_INTERVAL_MS = 1e4;
+const FOLLOW_USERS_RECONCILE_MAX_GUILDS_PER_RUN = 4;
+const FOLLOW_USERS_RECONCILE_MAX_REST_LOOKUPS_PER_RUN = 32;
+const DISCORD_VOICE_FATAL_AUTOJOIN_ERROR_PATTERNS = [
+	"api key missing",
+	"incorrect api key",
+	"invalid api key",
+	"unauthorized",
+	"authentication",
+	"permission denied",
+	"forbidden"
+];
+function logFollowUserReconcileVerbose(reason, message) {
+	if (reason === "interval") {
+		logger.trace(`discord voice: ${message}`);
+		return;
+	}
+	logVoiceVerbose(message);
+}
+function isVoiceConnectionDestroyed(connection, voiceSdk) {
+	return connection.state.status === voiceSdk.VoiceConnectionStatus.Destroyed;
+}
+function destroyVoiceConnectionSafely(params) {
+	if (isVoiceConnectionDestroyed(params.connection, params.voiceSdk)) {
+		logVoiceVerbose(`destroy skipped: ${params.reason}; connection already destroyed`);
+		return;
+	}
+	try {
+		params.connection.destroy();
+	} catch (err) {
+		const message = formatErrorMessage(err);
+		if (message.includes("already been destroyed")) {
+			logVoiceVerbose(`destroy skipped: ${params.reason}; ${message}`);
+			return;
+		}
+		logger.warn(`discord voice: destroy failed: ${params.reason}: ${message}`);
+	}
+}
+function isRetryableVoiceJoinReadyError(error) {
+	return formatErrorMessage(error).toLowerCase().includes("operation was aborted");
+}
+function normalizeVoiceChannelResidencies(entries) {
+	const normalized = [];
+	for (const entry of entries ?? []) {
+		const guildId = entry.guildId?.trim();
+		const channelId = entry.channelId?.trim();
+		if (guildId && channelId) normalized.push({
+			guildId,
+			channelId
+		});
+	}
+	return normalized;
+}
+function normalizeDiscordUserId(value) {
+	const trimmed = value.trim();
+	const withoutDiscordPrefix = trimmed.startsWith("discord:") ? trimmed.slice(8) : trimmed;
+	return (withoutDiscordPrefix.startsWith("user:") ? withoutDiscordPrefix.slice(5) : withoutDiscordPrefix).trim() || void 0;
+}
+function normalizeDiscordUserIds(entries) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const entry of entries ?? []) {
+		const id = normalizeDiscordUserId(entry);
+		if (id) ids.add(id);
+	}
+	return ids;
+}
+function resolveFollowUsersEnabled(voiceConfig) {
+	return voiceConfig?.followUsersEnabled !== false;
+}
+function isVoiceChannelAllowed(params) {
+	return params.allowedChannels === null || params.allowedChannels.some((entry) => entry.guildId === params.guildId && entry.channelId === params.channelId);
+}
+function formatAutoJoinFailureKey(entry) {
+	return `${entry.guildId}:${entry.channelId}`;
+}
+function isFatalAutoJoinFailure(message) {
+	const normalized = message.toLowerCase();
+	return DISCORD_VOICE_FATAL_AUTOJOIN_ERROR_PATTERNS.some((pattern) => normalized.includes(pattern));
+}
+function startAutoJoin(manager) {
+	manager.autoJoin().catch((err) => logger.warn(`discord voice: autoJoin failed: ${formatErrorMessage(err)}`));
+}
+function resolveVoiceConnectionGroup(accountId) {
+	return `openclaw:${accountId}`;
+}
+function resolveDiscordVoiceAgentRoute(params) {
+	const voiceRoute = resolveAgentRoute({
+		cfg: params.cfg,
+		channel: "discord",
+		accountId: params.accountId,
+		guildId: params.guildId,
+		peer: {
+			kind: "channel",
+			id: params.sessionChannelId
+		}
+	});
+	const agentSession = params.voiceConfig?.agentSession;
+	if (agentSession?.mode !== "target") return {
+		route: voiceRoute,
+		voiceRoute,
+		agentSessionMode: "voice",
+		agentSessionTarget: void 0
+	};
+	const target = agentSession.target?.trim();
+	if (!target) throw new Error("channels.discord.voice.agentSession.target is required when mode is \"target\"");
+	const parsed = parseDiscordTarget(target, { defaultKind: "channel" });
+	if (!parsed) throw new Error(`Invalid Discord voice agent session target "${target}"`);
+	return {
+		route: resolveAgentRoute({
+			cfg: params.cfg,
+			channel: "discord",
+			accountId: params.accountId,
+			guildId: params.guildId,
+			peer: {
+				kind: parsed.kind === "user" ? "direct" : "channel",
+				id: parsed.id
+			}
+		}),
+		voiceRoute,
+		agentSessionMode: "target",
+		agentSessionTarget: parsed.normalized
+	};
+}
+var DiscordVoiceManager$1 = class {
+	constructor(params) {
+		this.params = params;
+		this.sessions = /* @__PURE__ */ new Map();
+		this.joinTasks = /* @__PURE__ */ new Map();
+		this.autoJoinTask = null;
+		this.fatalAutoJoinFailures = /* @__PURE__ */ new Map();
+		this.followedUserChannels = /* @__PURE__ */ new Map();
+		this.followedVoiceGuilds = /* @__PURE__ */ new Set();
+		this.followUsersReconcileTimer = null;
+		this.followUsersReconcileTask = null;
+		this.followUsersReconcileGuildCursor = 0;
+		this.followUsersReconcileBotGuildCursor = 0;
+		this.followUsersReconcileUserCursors = /* @__PURE__ */ new Map();
+		this.destroyed = false;
+		this.botUserId = params.botUserId;
+		this.voiceEnabled = resolveDiscordVoiceEnabled(params.discordConfig.voice);
+		this.ownerAllowFrom = resolveDiscordAccountAllowFrom({
+			cfg: params.cfg,
+			accountId: params.accountId
+		}) ?? params.discordConfig.allowFrom ?? params.discordConfig.dm?.allowFrom ?? [];
+		this.allowedChannels = params.discordConfig.voice?.allowedChannels === void 0 ? null : normalizeVoiceChannelResidencies(params.discordConfig.voice.allowedChannels);
+		this.followUserIds = resolveFollowUsersEnabled(params.discordConfig.voice) ? normalizeDiscordUserIds(params.discordConfig.voice?.followUsers) : /* @__PURE__ */ new Set();
+		this.speakerContext = new DiscordVoiceSpeakerContextResolver({
+			client: params.client,
+			ownerAllowFrom: this.ownerAllowFrom
+		});
+	}
+	setBotUserId(id) {
+		if (id) this.botUserId = id;
+	}
+	isEnabled() {
+		return this.voiceEnabled;
+	}
+	async autoJoin() {
+		if (!this.voiceEnabled || this.destroyed) return;
+		if (this.autoJoinTask) return this.autoJoinTask;
+		this.autoJoinTask = (async () => {
+			const entries = this.params.discordConfig.voice?.autoJoin ?? [];
+			const entriesByGuild = /* @__PURE__ */ new Map();
+			const duplicateGuilds = /* @__PURE__ */ new Set();
+			for (const entry of entries) {
+				const guildId = entry.guildId.trim();
+				const channelId = entry.channelId.trim();
+				if (!guildId || !channelId) continue;
+				if (entriesByGuild.has(guildId)) duplicateGuilds.add(guildId);
+				entriesByGuild.set(guildId, {
+					guildId,
+					channelId
+				});
+			}
+			logVoiceVerbose(`autoJoin: ${entries.length} entries, ${entriesByGuild.size} guilds`);
+			for (const guildId of duplicateGuilds) {
+				const selected = entriesByGuild.get(guildId);
+				if (selected) logger.warn(`discord voice: autoJoin has multiple entries for guild ${guildId}; using channel ${selected.channelId}`);
+			}
+			for (const entry of entriesByGuild.values()) {
+				const failureKey = formatAutoJoinFailureKey(entry);
+				const fatalFailure = this.fatalAutoJoinFailures.get(failureKey);
+				if (fatalFailure) {
+					if (!fatalFailure.skipLogged) {
+						logger.warn(`discord voice: autoJoin suppressed guild=${entry.guildId} channel=${entry.channelId} after fatal startup failure; retry with /vc join or reload config after fixing credentials: ${fatalFailure.message}`);
+						fatalFailure.skipLogged = true;
+					}
+					continue;
+				}
+				logVoiceVerbose(`autoJoin: joining guild ${entry.guildId} channel ${entry.channelId}`);
+				const result = await this.join({
+					guildId: entry.guildId,
+					channelId: entry.channelId
+				});
+				if (!result.ok) {
+					logger.warn(`discord voice: autoJoin skipped guild=${entry.guildId} channel=${entry.channelId}: ${result.message}`);
+					if (isFatalAutoJoinFailure(result.message)) this.fatalAutoJoinFailures.set(failureKey, {
+						message: result.message,
+						skipLogged: false
+					});
+				}
+			}
+			this.ensureFollowUsersReconcileTimer();
+			await this.reconcileFollowedUsers("startup");
+		})().finally(() => {
+			this.autoJoinTask = null;
+		});
+		return this.autoJoinTask;
+	}
+	status() {
+		return Array.from(this.sessions.values()).map((session) => ({
+			ok: true,
+			message: `connected: guild ${session.guildId} channel ${session.channelId}`,
+			guildId: session.guildId,
+			channelId: session.channelId
+		}));
+	}
+	isAllowedVoiceChannel(params) {
+		return isVoiceChannelAllowed({
+			allowedChannels: this.allowedChannels,
+			guildId: params.guildId.trim(),
+			channelId: params.channelId.trim()
+		});
+	}
+	async join(params, options) {
+		if (this.destroyed) return {
+			ok: false,
+			message: "Discord voice manager is stopped."
+		};
+		if (!this.voiceEnabled) return {
+			ok: false,
+			message: "Discord voice is disabled (channels.discord.voice.enabled)."
+		};
+		const guildId = params.guildId.trim();
+		const channelId = params.channelId.trim();
+		if (!guildId || !channelId) return {
+			ok: false,
+			message: "Missing guildId or channelId."
+		};
+		if (!this.isAllowedVoiceChannel({
+			guildId,
+			channelId
+		})) {
+			logger.warn(`discord voice: join rejected for non-allowed channel guild=${guildId} channel=${channelId}`);
+			return {
+				ok: false,
+				message: `${formatMention({ channelId })} is not allowed by channels.discord.voice.allowedChannels.`,
+				guildId,
+				channelId
+			};
+		}
+		logVoiceVerbose(`join requested: guild ${guildId} channel ${channelId}`);
+		while (true) {
+			const activeJoinTask = this.joinTasks.get(guildId);
+			if (!activeJoinTask) break;
+			logVoiceVerbose(`join: waiting for active guild join guild ${guildId} channel ${channelId}`);
+			await activeJoinTask.catch(() => void 0);
+			if (this.destroyed) return {
+				ok: false,
+				message: "Discord voice manager is stopped.",
+				guildId,
+				channelId
+			};
+		}
+		const joinTask = this.joinUnlocked({
+			guildId,
+			channelId
+		}, options);
+		this.joinTasks.set(guildId, joinTask);
+		try {
+			return await joinTask;
+		} finally {
+			if (this.joinTasks.get(guildId) === joinTask) this.joinTasks.delete(guildId);
+		}
+	}
+	async joinUnlocked(params, options) {
+		const { guildId, channelId } = params;
+		const voiceConfig = this.params.discordConfig.voice;
+		const voiceMode = resolveDiscordVoiceMode(voiceConfig);
+		const existing = this.sessions.get(guildId);
+		if (existing && existing.channelId === channelId) {
+			if (options?.transcripts) existing.transcripts = options.transcripts;
+			if (!options?.transcripts && isDiscordRealtimeVoiceMode(voiceMode) && !existing.realtime) {
+				const realtimeResult = await this.attachRealtimeSession(existing, voiceMode, { requireLiveEntry: true });
+				if (!realtimeResult.ok) return {
+					ok: false,
+					message: realtimeResult.message,
+					guildId,
+					channelId
+				};
+			}
+			logVoiceVerbose(`join: already connected to guild ${guildId} channel ${channelId}`);
+			return {
+				ok: true,
+				message: `Already connected to ${formatMention({ channelId })}.`,
+				guildId,
+				channelId
+			};
+		}
+		if (existing) {
+			logVoiceVerbose(`join: replacing existing session for guild ${guildId}`);
+			await this.leave({ guildId }, { preserveFollowState: options?.preserveFollowState });
+		}
+		const channelInfo = await this.params.client.fetchChannel(channelId).catch(() => null);
+		if (!channelInfo || "type" in channelInfo && !isVoiceChannel(channelInfo.type)) return {
+			ok: false,
+			message: `Channel ${channelId} is not a voice channel.`
+		};
+		const channelGuildId = "guildId" in channelInfo ? channelInfo.guildId : void 0;
+		if (channelGuildId && channelGuildId !== guildId) return {
+			ok: false,
+			message: "Voice channel is not in this guild."
+		};
+		const voicePlugin = this.params.client.getPlugin("voice");
+		if (!voicePlugin) return {
+			ok: false,
+			message: "Discord voice plugin is not available."
+		};
+		const adapterCreator = voicePlugin.getGatewayAdapterCreator(guildId);
+		const daveEncryption = voiceConfig?.daveEncryption;
+		const decryptionFailureTolerance = voiceConfig?.decryptionFailureTolerance;
+		const connectReadyTimeoutMs = resolveVoiceTimeoutMs(voiceConfig?.connectTimeoutMs, VOICE_CONNECT_READY_TIMEOUT_MS);
+		const reconnectGraceMs = resolveVoiceTimeoutMs(voiceConfig?.reconnectGraceMs, VOICE_RECONNECT_GRACE_MS);
+		logVoiceVerbose(`join: DAVE settings encryption=${daveEncryption === false ? "off" : "on"} tolerance=${decryptionFailureTolerance ?? "default"} connectTimeout=${connectReadyTimeoutMs}ms reconnectGrace=${reconnectGraceMs}ms`);
+		const voiceSdk = loadDiscordVoiceSdk();
+		const existingEntry = this.sessions.get(guildId);
+		if (existingEntry) {
+			existingEntry.stop();
+			this.sessions.delete(guildId);
+		}
+		const voiceConnectionGroup = resolveVoiceConnectionGroup(this.params.accountId);
+		const staleConnection = voiceSdk.getVoiceConnection(guildId, voiceConnectionGroup);
+		if (staleConnection) destroyVoiceConnectionSafely({
+			connection: staleConnection,
+			voiceSdk,
+			reason: `stale connection before join guild ${guildId}`
+		});
+		let connection;
+		const connectReadyDeadlineMs = Date.now() + connectReadyTimeoutMs;
+		for (let attempt = 1; attempt <= 2; attempt += 1) {
+			const joinedConnection = voiceSdk.joinVoiceChannel({
+				channelId,
+				guildId,
+				group: voiceConnectionGroup,
+				adapterCreator,
+				selfDeaf: false,
+				selfMute: false,
+				daveEncryption,
+				decryptionFailureTolerance
+			});
+			const remainingConnectReadyTimeoutMs = Math.max(1, connectReadyDeadlineMs - Date.now());
+			try {
+				await voiceSdk.entersState(joinedConnection, voiceSdk.VoiceConnectionStatus.Ready, remainingConnectReadyTimeoutMs);
+				connection = joinedConnection;
+				logVoiceVerbose(`join: connected to guild ${guildId} channel ${channelId}`);
+				break;
+			} catch (err) {
+				destroyVoiceConnectionSafely({
+					connection: joinedConnection,
+					voiceSdk,
+					reason: `failed join cleanup guild ${guildId} channel ${channelId}`
+				});
+				if (attempt === 1 && isRetryableVoiceJoinReadyError(err) && !this.destroyed && connectReadyDeadlineMs > Date.now()) {
+					logVoiceVerbose(`join: retrying aborted ready wait guild ${guildId} channel ${channelId}`);
+					continue;
+				}
+				logger.warn(`discord voice: join failed before ready: guild ${guildId} channel ${channelId} timeout=${connectReadyTimeoutMs}ms error=${formatErrorMessage(err)}`);
+				return {
+					ok: false,
+					message: `Failed to join voice channel: ${formatErrorMessage(err)}`
+				};
+			}
+		}
+		if (!connection) return {
+			ok: false,
+			message: "Failed to join voice channel."
+		};
+		if (this.destroyed) {
+			destroyVoiceConnectionSafely({
+				connection,
+				voiceSdk,
+				reason: `manager stopped during join guild ${guildId} channel ${channelId}`
+			});
+			return {
+				ok: false,
+				message: "Discord voice manager is stopped.",
+				guildId,
+				channelId
+			};
+		}
+		const sessionChannelId = channelInfo?.id ?? channelId;
+		if (sessionChannelId !== channelId) logVoiceVerbose(`join: using session channel ${sessionChannelId} for voice channel ${channelId}`);
+		let routeInfo;
+		try {
+			routeInfo = resolveDiscordVoiceAgentRoute({
+				cfg: this.params.cfg,
+				accountId: this.params.accountId,
+				guildId,
+				sessionChannelId,
+				voiceConfig
+			});
+		} catch (err) {
+			destroyVoiceConnectionSafely({
+				connection,
+				voiceSdk,
+				reason: `voice agent session route failed guild ${guildId} channel ${channelId}`
+			});
+			return {
+				ok: false,
+				message: `Failed to resolve Discord voice agent session: ${formatErrorMessage(err)}`,
+				guildId,
+				channelId
+			};
+		}
+		const { route, voiceRoute, agentSessionMode, agentSessionTarget } = routeInfo;
+		logger.info(`discord voice: joining guild=${guildId} channel=${channelId} mode=${voiceMode} agent=${route.agentId} voiceSession=${voiceRoute.sessionKey} supervisorSession=${route.sessionKey} agentSessionMode=${agentSessionMode}${agentSessionTarget ? ` agentSessionTarget=${agentSessionTarget}` : ""} voiceModel=${voiceConfig?.model ?? "route-default"} realtimeProvider=${voiceConfig?.realtime?.provider ?? "auto"} realtimeModel=${voiceConfig?.realtime?.model ?? "provider-default"} realtimeVoice=${voiceConfig?.realtime?.voice ?? "provider-default"}`);
+		const player = voiceSdk.createAudioPlayer();
+		connection.subscribe(player);
+		let stopped = false;
+		const clearSessionIfCurrent = () => {
+			if (this.sessions.get(guildId)?.connection === connection) this.sessions.delete(guildId);
+		};
+		const stopEntry = (entry, optionsLocal) => {
+			if (stopped) return;
+			stopped = true;
+			if (speakingHandler) connection.receiver.speaking.off("start", speakingHandler);
+			if (speakingEndHandler) connection.receiver.speaking.off("end", speakingEndHandler);
+			stopVoiceCaptureState(entry.capture);
+			if (disconnectedHandler) connection.off(voiceSdk.VoiceConnectionStatus.Disconnected, disconnectedHandler);
+			if (destroyedHandler) connection.off(voiceSdk.VoiceConnectionStatus.Destroyed, destroyedHandler);
+			if (playerErrorHandler) player.off("error", playerErrorHandler);
+			entry.pendingRealtime?.close();
+			entry.pendingRealtime = void 0;
+			entry.realtime?.close();
+			entry.realtime = void 0;
+			player.stop();
+			if (optionsLocal.destroyConnection) destroyVoiceConnectionSafely({
+				connection,
+				voiceSdk,
+				reason: optionsLocal.reason
+			});
+		};
+		const entry = {
+			guildId,
+			guildName: channelInfo && "guild" in channelInfo && channelInfo.guild && typeof channelInfo.guild.name === "string" ? channelInfo.guild.name : void 0,
+			channelId,
+			channelName: channelInfo && "name" in channelInfo && typeof channelInfo.name === "string" ? channelInfo.name : void 0,
+			sessionChannelId,
+			voiceSessionKey: voiceRoute.sessionKey,
+			route,
+			connection,
+			player,
+			playbackQueue: Promise.resolve(),
+			processingQueue: Promise.resolve(),
+			capture: createVoiceCaptureState(),
+			transcripts: options?.transcripts,
+			receiveRecovery: createVoiceReceiveRecoveryState(),
+			isStopped: () => stopped,
+			stop: () => {
+				stopEntry(entry, {
+					destroyConnection: true,
+					reason: `stop guild ${guildId} channel ${channelId}`
+				});
+			}
+		};
+		if (!options?.transcripts && isDiscordRealtimeVoiceMode(voiceMode)) {
+			const realtimeResult = await this.attachRealtimeSession(entry, voiceMode);
+			if (!realtimeResult.ok) {
+				destroyVoiceConnectionSafely({
+					connection,
+					voiceSdk,
+					reason: `realtime setup failed guild ${guildId} channel ${channelId}`
+				});
+				return {
+					ok: false,
+					message: realtimeResult.message,
+					guildId,
+					channelId
+				};
+			}
+		}
+		if (this.destroyed) {
+			stopEntry(entry, {
+				destroyConnection: true,
+				reason: `manager stopped during setup guild ${guildId} channel ${channelId}`
+			});
+			return {
+				ok: false,
+				message: "Discord voice manager is stopped.",
+				guildId,
+				channelId
+			};
+		}
+		const speakingHandler = (userId) => {
+			this.handleSpeakingStart(entry, userId).catch((err) => {
+				logger.warn(`discord voice: capture failed: ${formatErrorMessage(err)}`);
+			});
+		};
+		const speakingEndHandler = (userId) => {
+			this.scheduleCaptureFinalize(entry, userId, "speaker end");
+		};
+		const disconnectedHandler = () => {
+			(async () => {
+				try {
+					logVoiceVerbose(`disconnected: attempting recovery guild ${guildId} channel ${channelId} grace=${reconnectGraceMs}ms`);
+					await Promise.race([voiceSdk.entersState(connection, voiceSdk.VoiceConnectionStatus.Signalling, reconnectGraceMs), voiceSdk.entersState(connection, voiceSdk.VoiceConnectionStatus.Connecting, reconnectGraceMs)]);
+					logVoiceVerbose(`disconnected: recovery started guild ${guildId} channel ${channelId}`);
+				} catch (err) {
+					logger.warn(`discord voice: disconnect recovery failed: guild ${guildId} channel ${channelId} timeout=${reconnectGraceMs}ms error=${formatErrorMessage(err)}; destroying connection`);
+					clearSessionIfCurrent();
+					stopEntry(entry, {
+						destroyConnection: true,
+						reason: `disconnect recovery failed guild ${guildId} channel ${channelId}`
+					});
+				}
+			})();
+		};
+		const destroyedHandler = () => {
+			clearSessionIfCurrent();
+			stopEntry(entry, {
+				destroyConnection: false,
+				reason: `destroyed guild ${guildId} channel ${channelId}`
+			});
+		};
+		const playerErrorHandler = (err) => {
+			logger.warn(`discord voice: playback error: ${formatErrorMessage(err)}`);
+		};
+		this.enableDaveReceivePassthrough(entry, "post-join warmup", 30);
+		connection.receiver.speaking.on("start", speakingHandler);
+		connection.receiver.speaking.on("end", speakingEndHandler);
+		connection.on(voiceSdk.VoiceConnectionStatus.Disconnected, disconnectedHandler);
+		connection.on(voiceSdk.VoiceConnectionStatus.Destroyed, destroyedHandler);
+		player.on("error", playerErrorHandler);
+		this.sessions.set(guildId, entry);
+		this.fatalAutoJoinFailures.delete(formatAutoJoinFailureKey({
+			guildId,
+			channelId
+		}));
+		logger.info(`discord voice: joined guild=${guildId} channel=${channelId} mode=${voiceMode} agent=${route.agentId} voiceSession=${voiceRoute.sessionKey} supervisorSession=${route.sessionKey} voiceModel=${voiceConfig?.model ?? "route-default"}`);
+		return {
+			ok: true,
+			message: `Joined ${formatMention({ channelId })}.`,
+			guildId,
+			channelId
+		};
+	}
+	async attachRealtimeSession(entry, voiceMode, options) {
+		const bootstrapContextInstructions = await resolveDiscordVoiceRealtimeBootstrapContext({
+			entry,
+			cfg: this.params.cfg,
+			discordConfig: this.params.discordConfig
+		});
+		if (entry.isStopped() || options?.requireLiveEntry === true && this.sessions.get(entry.guildId) !== entry) return {
+			ok: false,
+			message: "Discord realtime voice session stopped before startup completed."
+		};
+		const realtime = new DiscordRealtimeVoiceSession({
+			bootstrapContextInstructions,
+			cfg: this.params.cfg,
+			discordConfig: this.params.discordConfig,
+			entry,
+			mode: voiceMode,
+			runAgentTurn: ({ context, message, toolsAllow, userId }) => this.runDiscordRealtimeAgentTurn({
+				context,
+				entry,
+				message,
+				toolsAllow,
+				userId
+			})
+		});
+		entry.pendingRealtime = realtime;
+		try {
+			await realtime.connect();
+			if (entry.pendingRealtime !== realtime || entry.isStopped() || options?.requireLiveEntry === true && this.sessions.get(entry.guildId) !== entry) {
+				realtime.close();
+				return {
+					ok: false,
+					message: "Discord realtime voice session stopped before startup completed."
+				};
+			}
+			entry.pendingRealtime = void 0;
+			entry.realtime = realtime;
+			return { ok: true };
+		} catch (err) {
+			if (entry.pendingRealtime === realtime) entry.pendingRealtime = void 0;
+			realtime.close();
+			return {
+				ok: false,
+				message: `Failed to start Discord realtime voice: ${formatErrorMessage(err)}`
+			};
+		}
+	}
+	async leave(params, options) {
+		const guildId = params.guildId.trim();
+		logVoiceVerbose(`leave requested: guild ${guildId} channel ${params.channelId ?? "current"}`);
+		const entry = this.sessions.get(guildId);
+		if (!entry) return {
+			ok: false,
+			message: "Not connected to a voice channel."
+		};
+		if (params.channelId && params.channelId !== entry.channelId) return {
+			ok: false,
+			message: "Not connected to that voice channel."
+		};
+		if (options?.transcriptsSessionId) {
+			if (!entry.transcripts || entry.transcripts.sessionId !== options.transcriptsSessionId) return {
+				ok: false,
+				message: "Transcripts session is not active in this voice channel.",
+				guildId,
+				channelId: entry.channelId
+			};
+			if (entry.realtime || entry.pendingRealtime) {
+				entry.transcripts = void 0;
+				return {
+					ok: true,
+					message: `Stopped transcripts for ${formatMention({ channelId: entry.channelId })}.`,
+					guildId,
+					channelId: entry.channelId
+				};
+			}
+		}
+		entry.stop();
+		this.sessions.delete(guildId);
+		if (!options?.preserveFollowState) {
+			this.followedVoiceGuilds.delete(guildId);
+			this.deleteFollowedUserChannelsForGuild(guildId);
+		}
+		logVoiceVerbose(`leave: disconnected from guild ${guildId} channel ${entry.channelId}`);
+		return {
+			ok: true,
+			message: `Left ${formatMention({ channelId: entry.channelId })}.`,
+			guildId,
+			channelId: entry.channelId
+		};
+	}
+	async handleVoiceStateUpdate(data) {
+		const guildId = data.guild_id?.trim();
+		const userId = data.user_id?.trim();
+		const channelId = data.channel_id?.trim();
+		if (!guildId || !userId) return;
+		if (this.botUserId && userId === this.botUserId) {
+			await this.handleBotVoiceStateUpdate({
+				guildId,
+				channelId
+			});
+			return;
+		}
+		if (this.followUserIds.has(userId)) await this.handleFollowedUserVoiceStateUpdate({
+			guildId,
+			channelId,
+			userId
+		});
+	}
+	async handleBotVoiceStateUpdate(params) {
+		const { guildId, channelId } = params;
+		if (!channelId) return;
+		const existing = this.sessions.get(guildId);
+		if (this.isAllowedVoiceChannel({
+			guildId,
+			channelId
+		})) {
+			if (existing && existing.channelId !== channelId) {
+				logger.warn(`discord voice: bot moved to allowed channel guild=${guildId} from=${existing.channelId} to=${channelId}; rebuilding voice session`);
+				await this.join({
+					guildId,
+					channelId
+				}, { preserveFollowState: this.isFollowOwnedGuild(guildId) });
+			}
+			return;
+		}
+		logger.warn(`discord voice: bot moved to non-allowed channel guild=${guildId} channel=${channelId}; leaving`);
+		if (existing) await this.leave({ guildId });
+		else {
+			const voiceSdk = loadDiscordVoiceSdk();
+			const connection = voiceSdk.getVoiceConnection(guildId, resolveVoiceConnectionGroup(this.params.accountId));
+			if (connection) destroyVoiceConnectionSafely({
+				connection,
+				voiceSdk,
+				reason: `non-allowed voice state guild ${guildId} channel ${channelId}`
+			});
+		}
+		const target = this.resolveVoiceResidencyTarget(guildId);
+		if (target) {
+			logger.warn(`discord voice: rejoining allowed voice channel guild=${guildId} channel=${target.channelId}`);
+			await this.join(target);
+		}
+	}
+	async handleFollowedUserVoiceStateUpdate(params) {
+		if (!this.voiceEnabled || this.destroyed) return;
+		const { guildId, channelId, userId } = params;
+		const followKey = this.formatFollowedUserKey({
+			guildId,
+			userId
+		});
+		const existing = this.sessions.get(guildId);
+		const wasFollowedVoiceSession = this.followedUserChannels.has(followKey) || this.followedVoiceGuilds.has(guildId);
+		if (!channelId) {
+			this.followedUserChannels.delete(followKey);
+			if (existing && wasFollowedVoiceSession && !this.hasFollowedUserInChannel(existing)) await this.handoffToAnotherFollowedUserOrLeave({
+				guildId,
+				userId,
+				existing,
+				reason: "disconnected"
+			});
+			return;
+		}
+		if (!this.isAllowedVoiceChannel({
+			guildId,
+			channelId
+		})) {
+			this.followedUserChannels.delete(followKey);
+			logger.warn(`discord voice: followed user joined non-allowed channel guild=${guildId} user=${userId} channel=${channelId}; ignoring`);
+			if (existing && wasFollowedVoiceSession && !this.hasFollowedUserInChannel(existing)) await this.handoffToAnotherFollowedUserOrLeave({
+				guildId,
+				userId,
+				existing,
+				reason: "joined non-allowed channel"
+			});
+			return;
+		}
+		this.followedUserChannels.set(followKey, {
+			guildId,
+			channelId
+		});
+		if (existing?.channelId === channelId) {
+			this.followedVoiceGuilds.add(guildId);
+			return;
+		}
+		logger.info(`discord voice: following user guild=${guildId} user=${userId} channel=${channelId}`);
+		const result = await this.join({
+			guildId,
+			channelId
+		}, { preserveFollowState: true });
+		if (!result.ok) {
+			if (this.sessions.get(guildId)?.channelId === channelId) this.followedVoiceGuilds.add(guildId);
+			else this.followedUserChannels.delete(followKey);
+			logger.warn(`discord voice: failed to follow user guild=${guildId} user=${userId} channel=${channelId}: ${result.message}`);
+			return;
+		}
+		this.followedVoiceGuilds.add(guildId);
+	}
+	async destroy() {
+		this.destroyed = true;
+		if (this.followUsersReconcileTimer) {
+			clearInterval(this.followUsersReconcileTimer);
+			this.followUsersReconcileTimer = null;
+		}
+		for (const entry of this.sessions.values()) entry.stop();
+		this.sessions.clear();
+		this.followedUserChannels.clear();
+		this.followedVoiceGuilds.clear();
+	}
+	resolveFollowGuildIds() {
+		const guildIds = /* @__PURE__ */ new Set();
+		for (const guildId of Object.keys(this.params.discordConfig.guilds ?? {})) {
+			const normalized = guildId.trim();
+			if (normalized) guildIds.add(normalized);
+		}
+		for (const entry of normalizeVoiceChannelResidencies(this.params.discordConfig.voice?.autoJoin)) guildIds.add(entry.guildId);
+		for (const entry of this.allowedChannels ?? []) guildIds.add(entry.guildId);
+		for (const entry of this.sessions.values()) guildIds.add(entry.guildId);
+		return Array.from(guildIds);
+	}
+	ensureFollowUsersReconcileTimer() {
+		if (this.followUserIds.size === 0) return;
+		if (this.followUsersReconcileTimer) return;
+		this.followUsersReconcileTimer = setInterval(() => {
+			this.reconcileFollowedUsers("interval").catch((err) => {
+				logger.warn(`discord voice: follow user reconciliation failed: ${formatErrorMessage(err)}`);
+			});
+		}, FOLLOW_USERS_RECONCILE_INTERVAL_MS);
+		this.followUsersReconcileTimer.unref?.();
+	}
+	async reconcileFollowedUsers(reason) {
+		if (this.followUserIds.size === 0 || this.destroyed) return;
+		if (this.followUsersReconcileTask) return this.followUsersReconcileTask;
+		this.followUsersReconcileTask = this.runFollowedUsersReconcile(reason).finally(() => {
+			this.followUsersReconcileTask = null;
+		});
+		return this.followUsersReconcileTask;
+	}
+	async runFollowedUsersReconcile(reason) {
+		if (this.destroyed) return;
+		const guildIds = this.resolveFollowGuildIds();
+		if (guildIds.length === 0) {
+			logVoiceVerbose(`follow user reconcile skipped reason=${reason}: no Discord guild ids are configured`);
+			return;
+		}
+		logFollowUserReconcileVerbose(reason, `follow user reconcile reason=${reason}: ${this.followUserIds.size} users across ${guildIds.length} guilds`);
+		const plans = this.selectFollowUserReconcilePlans(guildIds, reason);
+		for (const plan of plans) {
+			for (const userId of plan.userIds) {
+				const voiceState = await getGuildVoiceState(this.params.client.rest, plan.guildId, userId).catch((err) => {
+					if (!isUnknownDiscordVoiceStateError(err)) {
+						logger.warn(`discord voice: follow user reconcile skipped transient voice state error guild=${plan.guildId} user=${userId} reason=${reason}: ${formatErrorMessage(err)}`);
+						return "transient-error";
+					}
+					logFollowUserReconcileVerbose(reason, `follow user reconcile reason=${reason}: no voice state guild ${plan.guildId} user ${userId}: ${formatErrorMessage(err)}`);
+				});
+				if (this.destroyed) return;
+				if (voiceState === "transient-error") continue;
+				const channelId = voiceState?.channel_id?.trim();
+				await this.handleFollowedUserVoiceStateUpdate({
+					guildId: plan.guildId,
+					channelId,
+					userId
+				});
+			}
+			if (plan.checkBotVoiceState) {
+				if (this.destroyed) return;
+				await this.disconnectStaleFollowedBotVoiceState({
+					guildId: plan.guildId,
+					reason
+				});
+			}
+		}
+	}
+	selectFollowUserReconcilePlans(guildIds, reason) {
+		const followedUserIds = Array.from(this.followUserIds);
+		if (followedUserIds.length === 0) return [];
+		let remainingLookups = FOLLOW_USERS_RECONCILE_MAX_REST_LOOKUPS_PER_RUN;
+		const guildLimit = Math.min(guildIds.length, FOLLOW_USERS_RECONCILE_MAX_GUILDS_PER_RUN);
+		const start = this.followUsersReconcileGuildCursor % guildIds.length;
+		const plans = [];
+		for (let offset = 0; offset < guildLimit && remainingLookups > 0; offset += 1) {
+			if (this.botUserId && remainingLookups === 1) break;
+			const guildId = guildIds[(start + offset) % guildIds.length];
+			const userLimit = this.resolveFollowUserReconcileUserLookupLimit(followedUserIds.length, remainingLookups);
+			if (userLimit <= 0) break;
+			const selection = this.selectFollowUserReconcileUserIds(guildId, followedUserIds, userLimit);
+			plans.push({
+				guildId,
+				userIds: selection.userIds,
+				checkedAllUsers: selection.completedCycle,
+				checkBotVoiceState: false
+			});
+			remainingLookups -= selection.userIds.length;
+		}
+		this.followUsersReconcileGuildCursor = (start + plans.length) % guildIds.length;
+		this.assignFollowUserReconcileBotChecks(guildIds, plans, remainingLookups);
+		if (plans.length < guildIds.length || plans.some((plan) => plan.userIds.length < followedUserIds.length)) logVoiceVerbose(`follow user reconcile reason=${reason}: sampling ${plans.length}/${guildIds.length} guilds and up to ${FOLLOW_USERS_RECONCILE_MAX_REST_LOOKUPS_PER_RUN} REST lookups`);
+		return plans;
+	}
+	assignFollowUserReconcileBotChecks(guildIds, plans, remainingLookups) {
+		if (!this.botUserId || remainingLookups <= 0 || plans.length === 0) return;
+		const plansByGuild = new Map(plans.map((plan) => [plan.guildId, plan]));
+		const start = this.followUsersReconcileBotGuildCursor % guildIds.length;
+		let scanned = 0;
+		let assigned = 0;
+		for (; scanned < guildIds.length && assigned < remainingLookups; scanned += 1) {
+			const guildId = guildIds[(start + scanned) % guildIds.length];
+			const plan = plansByGuild.get(guildId);
+			if (!plan?.checkedAllUsers) continue;
+			plan.checkBotVoiceState = true;
+			assigned += 1;
+		}
+		this.followUsersReconcileBotGuildCursor = (start + scanned) % guildIds.length;
+	}
+	resolveFollowUserReconcileUserLookupLimit(followedUserCount, remainingLookups) {
+		const userLimit = Math.min(followedUserCount, remainingLookups);
+		if (this.botUserId && followedUserCount > userLimit && remainingLookups > 1) return remainingLookups - 1;
+		return userLimit;
+	}
+	selectFollowUserReconcileUserIds(guildId, followedUserIds, limit) {
+		if (followedUserIds.length <= limit) {
+			this.followUsersReconcileUserCursors.set(guildId, 0);
+			return {
+				userIds: followedUserIds,
+				completedCycle: true
+			};
+		}
+		const start = this.followUsersReconcileUserCursors.get(guildId) ?? 0;
+		const selected = Array.from({ length: limit }, (_, offset) => followedUserIds[(start + offset) % followedUserIds.length]);
+		const completedCycle = start + selected.length >= followedUserIds.length;
+		this.followUsersReconcileUserCursors.set(guildId, (start + selected.length) % followedUserIds.length);
+		return {
+			userIds: selected,
+			completedCycle
+		};
+	}
+	formatFollowedUserKey(params) {
+		return `${params.guildId}:${params.userId}`;
+	}
+	hasFollowedUserInChannel(entry) {
+		return Array.from(this.followedUserChannels.values()).some((candidate) => candidate.guildId === entry.guildId && candidate.channelId === entry.channelId);
+	}
+	resolveFollowedUserHandoffTarget(guildId, currentChannelId) {
+		for (const entry of this.followedUserChannels.values()) if (entry.guildId === guildId && entry.channelId !== currentChannelId && this.isAllowedVoiceChannel(entry)) return entry;
+		return null;
+	}
+	async handoffToAnotherFollowedUserOrLeave(params) {
+		const target = this.resolveFollowedUserHandoffTarget(params.guildId, params.existing.channelId);
+		if (target) {
+			logger.info(`discord voice: followed user ${params.reason} guild=${params.guildId} user=${params.userId}; moving to remaining followed user channel=${target.channelId}`);
+			const result = await this.join(target, { preserveFollowState: true });
+			if (result.ok) this.followedVoiceGuilds.add(params.guildId);
+			else {
+				logger.warn(`discord voice: failed to hand off followed user session guild=${params.guildId} channel=${target.channelId}: ${result.message}`);
+				this.followedVoiceGuilds.delete(params.guildId);
+				this.deleteFollowedUserChannelsForGuild(params.guildId);
+				await this.leave({ guildId: params.guildId });
+			}
+			return;
+		}
+		logger.info(`discord voice: followed user ${params.reason} guild=${params.guildId} user=${params.userId}; leaving channel=${params.existing.channelId}`);
+		await this.leave({ guildId: params.guildId });
+	}
+	isFollowOwnedGuild(guildId) {
+		return this.followedVoiceGuilds.has(guildId) || Array.from(this.followedUserChannels.values()).some((entry) => entry.guildId === guildId);
+	}
+	deleteFollowedUserChannelsForGuild(guildId) {
+		for (const [key, entry] of this.followedUserChannels.entries()) if (entry.guildId === guildId) this.followedUserChannels.delete(key);
+	}
+	async disconnectStaleFollowedBotVoiceState(params) {
+		if (this.destroyed) return;
+		const { guildId, reason } = params;
+		if (Array.from(this.followedUserChannels.values()).some((entry) => entry.guildId === guildId)) return;
+		const existing = this.sessions.get(guildId);
+		if (existing) {
+			if (this.followedVoiceGuilds.has(guildId)) {
+				logger.info(`discord voice: follow reconcile leaving local session guild=${guildId} channel=${existing.channelId} reason=${reason}`);
+				await this.leave({ guildId });
+			}
+			return;
+		}
+		if (!this.botUserId) return;
+		const botVoiceState = await getGuildVoiceState(this.params.client.rest, guildId, this.botUserId).catch((err) => {
+			if (!isUnknownDiscordVoiceStateError(err)) {
+				logger.warn(`discord voice: follow reconcile skipped transient bot voice state error guild=${guildId} reason=${reason}: ${formatErrorMessage(err)}`);
+				return "transient-error";
+			}
+			logFollowUserReconcileVerbose(reason, `follow user reconcile reason=${reason}: no bot voice state guild ${guildId}: ${formatErrorMessage(err)}`);
+		});
+		if (this.destroyed || botVoiceState === "transient-error") return;
+		const botChannelId = botVoiceState?.channel_id?.trim();
+		if (!botChannelId) return;
+		const gateway = this.params.client.getPlugin("voice")?.getGateway(guildId);
+		if (!gateway) {
+			logger.warn(`discord voice: follow reconcile cannot disconnect stale bot voice state guild=${guildId} channel=${botChannelId}; gateway unavailable`);
+			return;
+		}
+		logger.info(`discord voice: follow reconcile disconnecting stale bot voice state guild=${guildId} channel=${botChannelId} reason=${reason}`);
+		gateway.updateVoiceState({
+			guild_id: guildId,
+			channel_id: null,
+			self_mute: false,
+			self_deaf: false
+		});
+	}
+	resolveVoiceResidencyTarget(guildId) {
+		const autoJoinTarget = normalizeVoiceChannelResidencies(this.params.discordConfig.voice?.autoJoin).toReversed().find((entry) => entry.guildId === guildId);
+		if (autoJoinTarget && this.isAllowedVoiceChannel(autoJoinTarget)) return autoJoinTarget;
+		if (this.allowedChannels === null) return null;
+		const guildAllowed = this.allowedChannels.filter((entry) => entry.guildId === guildId);
+		return guildAllowed.length === 1 ? guildAllowed[0] : null;
+	}
+	enqueueProcessing(entry, task) {
+		entry.processingQueue = entry.processingQueue.then(task).catch((err) => logger.warn(`discord voice: processing failed: ${formatErrorMessage(err)}`));
+	}
+	enqueuePlayback(entry, task) {
+		entry.playbackQueue = entry.playbackQueue.then(task).catch((err) => logger.warn(`discord voice: playback failed: ${formatErrorMessage(err)}`));
+	}
+	clearCaptureFinalizeTimer(entry, userId, generation) {
+		return clearVoiceCaptureFinalizeTimer(entry.capture, userId, generation);
+	}
+	scheduleCaptureFinalize(entry, userId, reason) {
+		const graceMs = resolveVoiceTimeoutMs(this.params.discordConfig.voice?.captureSilenceGraceMs, CAPTURE_FINALIZE_GRACE_MS);
+		scheduleVoiceCaptureFinalize({
+			state: entry.capture,
+			userId,
+			delayMs: graceMs,
+			onFinalize: () => {
+				logVoiceVerbose(`capture finalize: guild ${entry.guildId} channel ${entry.channelId} user ${userId} reason=${reason} grace=${graceMs}ms`);
+			}
+		});
+	}
+	async handleSpeakingStart(entry, userId) {
+		if (!userId) return;
+		if (this.botUserId && userId === this.botUserId) return;
+		if (isVoiceCaptureActive(entry.capture, userId)) {
+			const activeCapture = getActiveVoiceCapture(entry.capture, userId);
+			const extended = activeCapture ? this.clearCaptureFinalizeTimer(entry, userId, activeCapture.generation) : false;
+			logVoiceVerbose(`capture start ignored (already active): guild ${entry.guildId} channel ${entry.channelId} user ${userId}${extended ? " (finalize canceled)" : ""}`);
+			return;
+		}
+		logVoiceVerbose(`capture start: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+		const voiceSdk = loadDiscordVoiceSdk();
+		const voiceMode = resolveDiscordVoiceMode(this.params.discordConfig.voice);
+		const realtime = entry.realtime && isDiscordRealtimeVoiceMode(voiceMode) ? entry.realtime : void 0;
+		if (entry.player.state.status === voiceSdk.AudioPlayerStatus.Playing && !realtime) {
+			logVoiceVerbose(`capture ignored during playback: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			return;
+		}
+		const realtimeIngress = realtime ? await this.resolveDiscordVoiceIngressContext(entry, userId) : void 0;
+		if (realtime && !realtimeIngress) {
+			logVoiceVerbose(`realtime capture unauthorized: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			return;
+		}
+		if (entry.player.state.status === voiceSdk.AudioPlayerStatus.Playing && realtime) {
+			if (!realtime.isBargeInEnabled()) {
+				logger.info(`discord voice: realtime capture ignored during playback (barge-in disabled): guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+				return;
+			}
+			logVoiceVerbose(`realtime barge-in: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			logger.info(`discord voice: realtime barge-in detected source=speaker-start guild=${entry.guildId} channel=${entry.channelId} user=${userId} playerStatus=${entry.player.state.status}`);
+			realtime.handleBargeIn("speaker-start");
+		}
+		this.enableDaveReceivePassthrough(entry, `speaker ${userId} start`, 15);
+		const stream = entry.connection.receiver.subscribe(userId, { end: { behavior: voiceSdk.EndBehaviorType.Manual } });
+		const generation = beginVoiceCapture(entry.capture, userId, stream);
+		let streamAborted = false;
+		let receiveFailureHandled = false;
+		let receiveStreamEndHandled = false;
+		const handleStreamError = (err) => {
+			const analysis = analyzeVoiceReceiveError(err);
+			if (analysis.isAbortLike && !analysis.countsAsDecryptFailure) {
+				if (receiveStreamEndHandled) return;
+				receiveStreamEndHandled = true;
+				streamAborted = true;
+				this.handleReceiveError(entry, err);
+				return;
+			}
+			if (receiveFailureHandled) return;
+			receiveFailureHandled = true;
+			this.handleReceiveError(entry, err);
+		};
+		stream.on("error", handleStreamError);
+		try {
+			if (realtime && realtimeIngress) {
+				const turn = realtime.beginSpeakerTurn(realtimeIngress, userId);
+				try {
+					await this.processRealtimeAudioCapture({
+						entry,
+						onReceiveError: handleStreamError,
+						stream,
+						turn
+					});
+				} finally {
+					turn.close();
+				}
+				return;
+			}
+			const pcm = await decodeOpusStream(stream, {
+				onError: handleStreamError,
+				onVerbose: logVoiceVerbose,
+				onWarn: (message) => logger.warn(message)
+			});
+			if (receiveFailureHandled) return;
+			if (pcm.length === 0) {
+				logVoiceVerbose(`capture empty: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+				return;
+			}
+			this.resetDecryptFailureState(entry);
+			const { path: wavPath, durationSeconds } = await writeVoiceWavFile(pcm);
+			if (durationSeconds < (streamAborted ? .2 : .35)) {
+				logVoiceVerbose(`capture too short (${durationSeconds.toFixed(2)}s): guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+				return;
+			}
+			logVoiceVerbose(`capture ready (${durationSeconds.toFixed(2)}s): guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			this.enqueueProcessing(entry, async () => {
+				await this.processSegment({
+					entry,
+					wavPath,
+					userId,
+					durationSeconds
+				});
+			});
+		} catch (err) {
+			if (!receiveFailureHandled) this.handleReceiveError(entry, err);
+			throw err;
+		} finally {
+			stream.off?.("error", handleStreamError);
+			if (finishVoiceCapture(entry.capture, userId, generation) && !stream.destroyed) stream.destroy();
+		}
+	}
+	async processRealtimeAudioCapture(params) {
+		const { entry, onReceiveError, stream, turn } = params;
+		let resetReceiveRecovery = false;
+		await decodeOpusStreamChunks(stream, {
+			onChunk: (pcm) => {
+				if (!resetReceiveRecovery && pcm.length > 0) {
+					resetReceiveRecovery = true;
+					this.resetDecryptFailureState(entry);
+				}
+				turn.sendInputAudio(pcm);
+			},
+			onError: onReceiveError,
+			onVerbose: logVoiceVerbose,
+			onWarn: (message) => logger.warn(message)
+		});
+	}
+	async resolveDiscordVoiceIngressContext(entry, userId) {
+		return await resolveDiscordVoiceIngressContext({
+			entry,
+			userId,
+			cfg: this.params.cfg,
+			discordConfig: this.params.discordConfig,
+			ownerAllowFrom: this.ownerAllowFrom,
+			fetchGuildName: async (guildId) => {
+				const guild = await this.params.client.fetchGuild(guildId).catch(() => null);
+				return guild && typeof guild.name === "string" && guild.name.trim() ? guild.name : void 0;
+			},
+			speakerContext: this.speakerContext
+		});
+	}
+	async runDiscordRealtimeAgentTurn(params) {
+		const { context, entry, message, toolsAllow, userId } = params;
+		logger.info(`discord voice: agent turn start guild=${entry.guildId} channel=${entry.channelId} voiceSession=${entry.voiceSessionKey} supervisorSession=${entry.route.sessionKey} agent=${entry.route.agentId} user=${userId} speaker=${context.speakerLabel} owner=${context.senderIsOwner} model=${this.params.discordConfig.voice?.model ?? "route-default"} message=${formatVoiceLogPreview(message)}`);
+		const turn = await runDiscordVoiceAgentTurn({
+			entry,
+			userId,
+			message,
+			cfg: this.params.cfg,
+			discordConfig: this.params.discordConfig,
+			runtime: this.params.runtime,
+			context,
+			toolsAllow,
+			ownerAllowFrom: this.ownerAllowFrom,
+			fetchGuildName: async (guildId) => {
+				const guild = await this.params.client.fetchGuild(guildId).catch(() => null);
+				return guild && typeof guild.name === "string" && guild.name.trim() ? guild.name : void 0;
+			},
+			speakerContext: this.speakerContext
+		});
+		if (!turn) {
+			logVoiceVerbose(`realtime agent unauthorized: guild ${entry.guildId} channel ${entry.channelId} user ${userId}`);
+			return "";
+		}
+		logger.info(`discord voice: agent turn answer (${turn.text.length} chars) guild=${entry.guildId} channel=${entry.channelId} voiceSession=${entry.voiceSessionKey} supervisorSession=${entry.route.sessionKey} agent=${entry.route.agentId}: ${formatVoiceLogPreview(turn.text)}`);
+		return turn.text;
+	}
+	async processSegment(params) {
+		await processDiscordVoiceSegment({
+			...params,
+			cfg: this.params.cfg,
+			discordConfig: this.params.discordConfig,
+			ownerAllowFrom: this.ownerAllowFrom,
+			runtime: this.params.runtime,
+			speakerContext: this.speakerContext,
+			transcripts: params.entry.transcripts,
+			fetchGuildName: async (guildId) => {
+				const guild = await this.params.client.fetchGuild(guildId).catch(() => null);
+				return guild && typeof guild.name === "string" && guild.name.trim() ? guild.name : void 0;
+			},
+			enqueuePlayback: (entry, task) => {
+				this.enqueuePlayback(entry, task);
+			}
+		});
+	}
+	handleReceiveError(entry, err) {
+		const analysis = analyzeVoiceReceiveError(err);
+		if (analysis.isAbortLike && !analysis.countsAsDecryptFailure) {
+			logVoiceVerbose(`receive stream ended: ${analysis.message}`);
+			return;
+		}
+		if (analysis.isDecodeCorruption && !analysis.countsAsDecryptFailure) {
+			logVoiceVerbose(`receive decode skipped: ${analysis.message}`);
+			return;
+		}
+		logger.warn(`discord voice: receive error: ${analysis.message}`);
+		if (analysis.shouldAttemptPassthrough) this.enableDaveReceivePassthrough(entry, "receive decrypt error", 15);
+		if (!analysis.countsAsDecryptFailure) return;
+		const decryptFailure = noteVoiceDecryptFailure(entry.receiveRecovery);
+		if (decryptFailure.firstFailure) logger.warn("discord voice: DAVE decrypt failures detected; voice receive may be unstable (upstream: discordjs/discord.js#11419)");
+		if (!decryptFailure.shouldRecover) return;
+		this.recoverFromDecryptFailures(entry).catch((recoverErr) => logger.warn(`discord voice: decrypt recovery failed: ${formatErrorMessage(recoverErr)}`)).finally(() => {
+			finishVoiceDecryptRecovery(entry.receiveRecovery);
+		});
+	}
+	enableDaveReceivePassthrough(entry, reason, expirySeconds) {
+		const voiceSdk = loadDiscordVoiceSdk();
+		return enableDaveReceivePassthrough({
+			target: {
+				guildId: entry.guildId,
+				channelId: entry.channelId,
+				connection: entry.connection
+			},
+			sdk: {
+				VoiceConnectionStatus: { Ready: voiceSdk.VoiceConnectionStatus.Ready },
+				NetworkingStatusCode: {
+					Ready: voiceSdk.NetworkingStatusCode.Ready,
+					Resuming: voiceSdk.NetworkingStatusCode.Resuming
+				}
+			},
+			reason,
+			expirySeconds,
+			onVerbose: logVoiceVerbose,
+			onWarn: (message) => logger.warn(message)
+		});
+	}
+	resetDecryptFailureState(entry) {
+		resetVoiceReceiveRecoveryState(entry.receiveRecovery);
+	}
+	async recoverFromDecryptFailures(entry) {
+		const active = this.sessions.get(entry.guildId);
+		if (!active || active.connection !== entry.connection) return;
+		const preserveFollowState = this.isFollowOwnedGuild(entry.guildId);
+		logger.warn(`discord voice: repeated decrypt failures; attempting rejoin for guild ${entry.guildId} channel ${entry.channelId}`);
+		const leaveResult = await this.leave({ guildId: entry.guildId }, { preserveFollowState });
+		if (!leaveResult.ok) {
+			logger.warn(`discord voice: decrypt recovery leave failed: ${leaveResult.message}`);
+			return;
+		}
+		const result = await this.join({
+			guildId: entry.guildId,
+			channelId: entry.channelId
+		}, { preserveFollowState });
+		if (!result.ok) logger.warn(`discord voice: rejoin after decrypt failures failed: ${result.message}`);
+	}
+};
+var DiscordVoiceReadyListener$1 = class extends ReadyListener {
+	constructor(manager) {
+		super();
+		this.manager = manager;
+	}
+	async handle(_data, _client) {
+		startAutoJoin(this.manager);
+	}
+};
+var DiscordVoiceResumedListener$1 = class extends ResumedListener {
+	constructor(manager) {
+		super();
+		this.manager = manager;
+	}
+	async handle(_data, _client) {
+		startAutoJoin(this.manager);
+	}
+};
+var DiscordVoiceStateUpdateListener$1 = class extends VoiceStateUpdateListener {
+	constructor(manager) {
+		super();
+		this.manager = manager;
+	}
+	async handle(data, _client) {
+		await this.manager.handleVoiceStateUpdate(data);
+	}
+};
+//#endregion
+//#region extensions/discord/src/voice/manager.runtime.ts
+var DiscordVoiceManager = class extends DiscordVoiceManager$1 {};
+var DiscordVoiceReadyListener = class extends DiscordVoiceReadyListener$1 {};
+var DiscordVoiceResumedListener = class extends DiscordVoiceResumedListener$1 {};
+var DiscordVoiceStateUpdateListener = class extends DiscordVoiceStateUpdateListener$1 {};
+//#endregion
+export { DiscordVoiceManager, DiscordVoiceReadyListener, DiscordVoiceResumedListener, DiscordVoiceStateUpdateListener };