@gajae-code/coding-agent 0.10.1 → 0.11.0

package/src/sdk/bus/discord-daemon.ts

@@ -0,0 +1,2275 @@
+import { createHash, randomUUID } from "node:crypto";
+import { SdkClientError } from "../client/client";
+import type { ChatDeliveryError } from "./chat-daemon-runtime";
+
+import {
+	type ChatEffect,
+	ChatEffectJournal,
+	type ChatEffectLease,
+	type ChatEffectReceipt,
+} from "./chat-effect-journal";
+import { ConversationStore } from "./conversation-store";
+
+import {
+	type DiscordConversation,
+	type DiscordInboundDispatchReceipt,
+	discordConversationKey,
+	normalizeDiscordConversation,
+} from "./discord-conversation";
+import type { DiscordInboundEvent, DiscordMessageComponent, DiscordProvider, DiscordThread } from "./discord-provider";
+
+const FAILURE = "This conversation is no longer available.";
+
+export class DiscordEndpointBindingError extends Error {
+	constructor(message = "Discord session endpoint changed before outbound publication.") {
+		super(message);
+		this.name = "DiscordEndpointBindingError";
+	}
+}
+
+type DiscordClosingIntent = Readonly<{ nonce: string; at: number }>;
+
+function closingIntent(record: DiscordConversation | undefined): DiscordClosingIntent | undefined {
+	const candidate = record as { state?: unknown; closingNonce?: unknown; closingAt?: unknown } | undefined;
+	return candidate?.state === "closing" &&
+		typeof candidate.closingNonce === "string" &&
+		typeof candidate.closingAt === "number"
+		? { nonce: candidate.closingNonce, at: candidate.closingAt }
+		: undefined;
+}
+
+function withClosingIntent(record: DiscordConversation, nonce: string, at: number): DiscordConversation {
+	return {
+		...record,
+		generation: record.generation + 1,
+		state: "closing",
+		closingNonce: nonce,
+		closingAt: at,
+		pendingActionId: undefined,
+		pendingActionNonce: undefined,
+		pendingActionEffectId: undefined,
+	} as unknown as DiscordConversation;
+}
+
+function withoutClosingIntent(record: DiscordConversation, closedAt: number): DiscordConversation {
+	const {
+		closingNonce: _closingNonce,
+		closingAt: _closingAt,
+		...rest
+	} = record as DiscordConversation & {
+		closingNonce?: unknown;
+		closingAt?: unknown;
+	};
+	return {
+		...rest,
+		generation: record.generation + 1,
+		state: "closed",
+		closedAt,
+		pendingActionId: undefined,
+		pendingActionNonce: undefined,
+		pendingActionEffectId: undefined,
+	};
+}
+
+/** A captured live SDK transport. `isCurrent` must fail closed after replacement or removal. */
+export interface DiscordEndpointBinding {
+	generation: number;
+	isCurrent(): boolean;
+	send(frame: Record<string, unknown>): void | Promise<void>;
+}
+
+export interface DiscordNotificationDaemonOptions {
+	agentDir: string;
+	repo: string;
+	guildId: string;
+	parentChannelId: string;
+	provider: DiscordProvider;
+	now?: () => number;
+	resolveEndpoint: (sessionId: string, expectedGeneration?: number) => Promise<DiscordEndpointBinding | null>;
+	onCommand?: (
+		sessionId: string,
+		content: string,
+		endpoint: DiscordEndpointBinding,
+		idempotencyKey: string,
+	) => Promise<boolean>;
+}
+
+export interface DiscordNotificationInput {
+	sessionId: string;
+	endpointGeneration: number;
+	content: string;
+	threadName?: string;
+	actionId?: string;
+	options?: string[];
+}
+
+type DiscordInboundEffectPayload =
+	| {
+			type: "command";
+			content: string;
+			idempotencyKey: string;
+			routing: DiscordInboundRouting;
+	  }
+	| {
+			type: "reply";
+			id: string;
+			answer: string | number;
+			idempotencyKey: string;
+			routing: DiscordInboundRouting;
+	  };
+
+type DiscordInboundRouting = {
+	guildId: string;
+	parentId: string;
+	threadId: string;
+	eventId: string;
+	interactionId?: string;
+	kind: "command" | "action";
+	actionId?: string;
+	actionNonce?: string;
+};
+
+function backfilledEffectIncarnationId(record: DiscordConversation): string {
+	if (record.effectIncarnationId) return record.effectIncarnationId;
+	if (record.createNonce) return record.createNonce;
+	return `legacy-${createHash("sha256")
+		.update(
+			[record.appId, record.guildId, record.parentChannelId, record.threadId ?? "", record.sessionId ?? ""].join(
+				"\u0000",
+			),
+		)
+		.digest("hex")
+		.slice(0, 32)}`;
+}
+
+type DiscordInboundClaim = {
+	receipt: DiscordInboundDispatchReceipt;
+	liveCallbackEffect?: ChatEffect<DiscordInboundEffectPayload>;
+};
+
+/** SDK-only Discord threaded notification daemon. It owns no AgentSession and never retains endpoint credentials. */
+export class DiscordNotificationDaemon {
+	readonly #store: ConversationStore<DiscordConversation>;
+	readonly #now: () => number;
+	readonly #creates = new Map<string, Promise<DiscordConversation>>();
+	readonly #resumes = new Map<string, Promise<DiscordConversation | undefined>>();
+	readonly #archives = new Map<string, Promise<void>>();
+	readonly #resolveEndpoint: (
+		sessionId: string,
+		expectedGeneration?: number,
+	) => Promise<DiscordEndpointBinding | null>;
+	readonly #effects: ChatEffectJournal;
+	readonly #activeWork = new Set<Promise<unknown>>();
+	readonly #inflightInbound = new Set<string>();
+	#started = false;
+	#lifecycleGeneration = 0;
+	#startTask: Promise<void> | undefined;
+	#stopTask: Promise<void> | undefined;
+	#providerStarting = false;
+
+	#leaseRecoveryTimer: ReturnType<typeof setTimeout> | undefined;
+	#leaseRecoveryAt: number | undefined;
+	#leaseRecoveryFailures = 0;
+
+	readonly #dispatchOwner = randomUUID();
+	readonly #dispatchLeaseMs = 60_000;
+	readonly #providerOwner = randomUUID();
+	readonly #providerLeaseMs = 60_000;
+	constructor(private readonly options: DiscordNotificationDaemonOptions) {
+		this.#store = new ConversationStore({ agentDir: options.agentDir, kind: "discord", now: options.now });
+		this.#effects = new ChatEffectJournal({ agentDir: options.agentDir, transport: "discord", now: options.now });
+		this.#now = options.now ?? Date.now;
+		this.#resolveEndpoint = options.resolveEndpoint;
+	}
+
+	async start(): Promise<void> {
+		if (this.#started && !this.#stopTask) return;
+		if (this.#stopTask) {
+			await this.#stopTask;
+			return await this.start();
+		}
+		if (this.#startTask) return await this.#startTask;
+
+		const lifecycleGeneration = ++this.#lifecycleGeneration;
+		const task = this.#start(lifecycleGeneration);
+		this.#startTask = task;
+		try {
+			await task;
+		} finally {
+			if (this.#startTask === task) this.#startTask = undefined;
+		}
+	}
+
+	async #start(lifecycleGeneration: number): Promise<void> {
+		try {
+			// Provider start is the delivery boundary; complete crash recovery first.
+			await this.#reconcileTerminalInboundReceipts();
+			const closingBeforeProviderRecoveryFailed = await this.#recoverClosingConversations();
+			const providerRecoveryFailed = await this.#drainProviderEffects();
+			await this.#reconcileTerminalInboundReceipts();
+			const closingAfterProviderRecoveryFailed = await this.#recoverClosingConversations();
+			const inboundRecoveryFailed = await this.#drainPendingDispatches();
+			const recoveryFailed =
+				closingBeforeProviderRecoveryFailed ||
+				providerRecoveryFailed ||
+				closingAfterProviderRecoveryFailed ||
+				inboundRecoveryFailed;
+			if (lifecycleGeneration !== this.#lifecycleGeneration) return;
+
+			this.#started = true;
+			await this.#scheduleLeaseRecovery(recoveryFailed);
+			// stop() invalidates this generation before awaiting recovery or start. This
+			// guard is immediately adjacent to the Gateway-open boundary.
+			if (lifecycleGeneration !== this.#lifecycleGeneration) {
+				this.#started = false;
+				return;
+			}
+			this.#providerStarting = true;
+			try {
+				await this.options.provider.start(
+					event => this.#track(this.handleInbound(event)),
+					() => {},
+				);
+			} finally {
+				this.#providerStarting = false;
+			}
+			if (lifecycleGeneration !== this.#lifecycleGeneration) {
+				this.#started = false;
+				await this.options.provider.stop();
+			}
+		} catch (error) {
+			if (lifecycleGeneration === this.#lifecycleGeneration) {
+				this.#started = false;
+				if (this.#leaseRecoveryTimer) clearTimeout(this.#leaseRecoveryTimer);
+				this.#leaseRecoveryTimer = undefined;
+				this.#leaseRecoveryAt = undefined;
+			}
+			throw error;
+		}
+	}
+
+	async stop(): Promise<void> {
+		if (this.#stopTask) return await this.#stopTask;
+
+		const starting = this.#startTask;
+		const stopProvider = this.#started || this.#providerStarting;
+		++this.#lifecycleGeneration;
+		this.#started = false;
+		if (this.#leaseRecoveryTimer) clearTimeout(this.#leaseRecoveryTimer);
+		this.#leaseRecoveryTimer = undefined;
+		this.#leaseRecoveryAt = undefined;
+
+		const task = this.#stop(starting, stopProvider);
+		this.#stopTask = task;
+		try {
+			await task;
+		} finally {
+			if (this.#stopTask === task) this.#stopTask = undefined;
+		}
+	}
+
+	async #stop(starting: Promise<void> | undefined, stopProvider: boolean): Promise<void> {
+		// Calling provider.stop() before awaiting start lets a provider cancel a
+		// Gateway open that is already in flight. #start rechecks the generation
+		// after it resolves and closes any late open.
+		if (stopProvider) await this.options.provider.stop();
+		try {
+			await starting;
+		} catch {
+			// The caller of start() owns its recovery/start error; stop still drains it.
+		}
+		if (this.#providerStarting || this.#started) {
+			this.#started = false;
+			await this.options.provider.stop();
+		}
+		// Drain until quiescent: a tracked task can schedule further tracked work while
+		// we await, and any that outlives stop() would bleed timing pressure into the
+		// next daemon/test. #started is false, so no new recovery timers arm and the
+		// loop terminates.
+		while (this.#activeWork.size > 0) await Promise.all([...this.#activeWork]);
+	}
+
+	async notify(input: DiscordNotificationInput): Promise<DiscordConversation> {
+		await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+		const conversation = await this.#ensureConversation(input);
+		await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+		if (conversation.state !== "active" || !conversation.threadId) throw new Error("Discord thread is unavailable");
+		const pendingActionId = input.actionId;
+		const authoritative = pendingActionId
+			? await this.#ensureActionPublication(conversation, pendingActionId)
+			: conversation;
+		await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+		const components =
+			pendingActionId && authoritative.pendingActionNonce && input.options && input.options.length > 0
+				? actionComponents(
+						authoritative.endpointGeneration!,
+						pendingActionId,
+						authoritative.pendingActionNonce,
+						input.options,
+					)
+				: undefined;
+
+		// The durable action publication intent, rather than this notification call,
+		// owns the provider-visible effect identity. This makes retries reconcile the
+		// original post and preserves the original component route.
+		const effectId = pendingActionId
+			? authoritative.pendingActionEffectId!
+			: `notification:${authoritative.threadId}:${randomUUID()}`;
+		await this.#postEffect(effectId, authoritative, input.content, components, pendingActionId !== undefined);
+
+		return authoritative;
+	}
+
+	/** Posts a safe command outcome to the active mapped conversation. */
+	async postCommandResult(sessionId: string, content: string): Promise<boolean> {
+		const record = await this.#bySession(sessionId);
+		if (record?.state !== "active" || !record.threadId) return false;
+		await this.#postEffect(`command-result:${record.threadId}:${randomUUID()}`, record, content);
+		return true;
+	}
+
+	async close(sessionId: string): Promise<void> {
+		const closing = await this.#markClosing(sessionId);
+		if (closing) await this.#driveClose(closing);
+	}
+
+	async archive(sessionId: string): Promise<void> {
+		const running = this.#archives.get(sessionId);
+		if (running) return await running;
+		const task = this.#archive(sessionId);
+		this.#archives.set(sessionId, task);
+		try {
+			await task;
+		} finally {
+			this.#archives.delete(sessionId);
+		}
+	}
+
+	async #archive(sessionId: string): Promise<void> {
+		const record = await this.#bySession(sessionId);
+		if (!record?.threadId || record.state !== "active") return;
+		await this.#requireLiveBinding(record.sessionId!, record.endpointGeneration!);
+		const archiving = await this.#beginArchive(record);
+		const occurrenceId = archiving.archiveOccurrenceId;
+		if (!occurrenceId || !archiving.archiveEffectId) throw new Error("Discord archive occurrence is unavailable");
+		await this.#threadEffect(archiving.archiveEffectId, archiving, "archive", false, false, occurrenceId);
+		await this.#requireLiveBinding(archiving.sessionId!, archiving.endpointGeneration!);
+		await this.#completeArchive(archiving, occurrenceId);
+	}
+
+	async resume(sessionId: string, endpointGeneration: number): Promise<DiscordConversation | undefined> {
+		const running = this.#resumes.get(sessionId);
+		if (running) return await running;
+		const task = this.#resume(sessionId, endpointGeneration);
+		this.#resumes.set(sessionId, task);
+		try {
+			return await task;
+		} finally {
+			this.#resumes.delete(sessionId);
+		}
+	}
+
+	async #resume(sessionId: string, endpointGeneration: number): Promise<DiscordConversation | undefined> {
+		const record = await this.#bySession(sessionId);
+		if (!record?.threadId || record.state === "closed") return undefined;
+		if (closingIntent(record)) {
+			await this.#driveClose(record);
+			return undefined;
+		}
+		await this.#requireLiveBinding(sessionId, endpointGeneration);
+		const resumeOccurrenceId = randomUUID();
+		const effectIncarnationId = backfilledEffectIncarnationId(record);
+		const resuming = await this.#replace(record, {
+			...record,
+			state: "resuming",
+			endpointGeneration,
+			effectIncarnationId,
+			resumeOccurrenceId,
+			resumeEffectId: `unarchive:${record.threadId}:${effectIncarnationId}:${resumeOccurrenceId}`,
+			pendingActionId: undefined,
+			pendingActionNonce: undefined,
+			pendingActionEffectId: undefined,
+		});
+		try {
+			const occurrenceId = resuming.resumeOccurrenceId;
+			if (!occurrenceId || !resuming.resumeEffectId) throw new Error("Discord resume occurrence is unavailable");
+			await this.#threadEffect(resuming.resumeEffectId, resuming, "unarchive", false, false, occurrenceId);
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+			return await this.#completeResume(resuming, occurrenceId);
+		} catch {
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+			const superseded = await this.#replace(resuming, {
+				...resuming,
+				state: "archived",
+				resumeOccurrenceId: undefined,
+				resumeEffectId: undefined,
+				pendingActionId: undefined,
+				pendingActionNonce: undefined,
+				pendingActionEffectId: undefined,
+			});
+
+			const replacement = await this.#create(sessionId, endpointGeneration, `resume-${randomUUID()}`);
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+			await this.#replace(superseded, { ...superseded, supersededByThreadId: replacement.threadId });
+			return replacement;
+		}
+	}
+
+	async resolveAction(sessionId: string, actionId: string): Promise<void> {
+		const record = await this.#bySession(sessionId);
+		if (record?.pendingActionId === actionId && record.pendingActionNonce)
+			await this.#clearPending(record, actionId, record.pendingActionNonce);
+	}
+
+	async handleInbound(event: DiscordInboundEvent): Promise<void> {
+		if (event.bot || event.authorId === this.options.provider.botUserId) return;
+		await this.#reconcileTerminalInboundReceipts();
+		const record = await this.#byThread(event.guildId, event.parentId, event.threadId);
+		if (!record?.sessionId) {
+			await this.#fail(event.threadId);
+			return;
+		}
+		const claim = await this.#claimInbound(record, event);
+		if (claim === "invalid") {
+			await this.#fail(event.threadId);
+			return;
+		}
+		if (!claim || this.#inflightInbound.has(claim.receipt.effectId)) return;
+		this.#inflightInbound.add(claim.receipt.effectId);
+		try {
+			// Interaction callbacks have a short provider deadline. The mapping and
+			// journal claim are sufficient to acknowledge; endpoint discovery waits.
+			const endpoint = event.interaction
+				? null
+				: await this.#resolveEndpoint(record.sessionId, record.endpointGeneration);
+			if (!event.interaction && !this.#matches(record, endpoint)) {
+				await this.#fail(event.threadId);
+				return;
+			}
+			await this.#dispatchInbound(record, endpoint, claim.receipt, event.interaction, claim.liveCallbackEffect);
+		} finally {
+			this.#inflightInbound.delete(claim.receipt.effectId);
+			await this.#scheduleLeaseRecovery();
+		}
+	}
+
+	#track<T>(work: Promise<T>): Promise<T> {
+		this.#activeWork.add(work);
+		return work.finally(() => this.#activeWork.delete(work));
+	}
+
+	async #claimInbound(
+		record: DiscordConversation,
+		event: DiscordInboundEvent,
+	): Promise<DiscordInboundClaim | "invalid" | undefined> {
+		if (record.state !== "active" || closingIntent(record)) return "invalid";
+		const route = event.interaction ? decodeCustomId(event.interaction.customId) : undefined;
+		const command = !event.interaction && event.content?.startsWith("/sdk ");
+		if (!command && (!route || !event.interaction || route.generation !== record.endpointGeneration))
+			return "invalid";
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		let receipt: DiscordInboundDispatchReceipt | undefined;
+		let valid = false;
+		const effectId = `discord:${record.appId}:${record.guildId}:${record.parentChannelId}:${record.threadId}:${event.id}`;
+		const idempotencyKey = effectId;
+		const routing: DiscordInboundRouting = {
+			guildId: event.guildId,
+			parentId: event.parentId,
+			threadId: event.threadId,
+			eventId: event.id,
+			...(event.interaction ? { interactionId: event.interaction.id } : {}),
+			kind: command ? "command" : "action",
+			...(!command ? { actionId: route!.actionId, actionNonce: route!.actionNonce } : {}),
+		};
+		const payload: DiscordInboundEffectPayload = command
+			? { type: "command", content: event.content!, idempotencyKey, routing }
+			: {
+					type: "reply",
+					id: route!.actionId,
+					answer: componentAnswer(event.interaction!.value ?? ""),
+					idempotencyKey,
+					routing,
+				};
+		let liveCallbackEffect: ChatEffect<DiscordInboundEffectPayload> | undefined;
+		if (event.interaction) {
+			liveCallbackEffect = await this.#rescheduleAfterEffectTransition(
+				this.#effects.enqueueAndClaim(
+					{
+						id: effectId,
+						kind: "discord.inbound.action",
+						transport: "discord",
+						sessionId: record.sessionId,
+						endpointGeneration: record.endpointGeneration!,
+						payload,
+					},
+					this.#dispatchOwner,
+					this.#dispatchLeaseMs,
+				),
+			);
+		} else {
+			await this.#rescheduleAfterEffectTransition(
+				this.#effects.enqueue({
+					id: effectId,
+					kind: "discord.inbound.command",
+					transport: "discord",
+					sessionId: record.sessionId,
+					endpointGeneration: record.endpointGeneration!,
+					payload,
+				}),
+			);
+		}
+
+		await this.#store.transact(key, current => {
+			if (current?.state !== "active" || current.endpointGeneration !== record.endpointGeneration) return current;
+			const interactionId = event.interaction?.id;
+			const existing = (current.inboundDispatches ?? []).find(
+				item => item.eventId === event.id || (interactionId !== undefined && item.interactionId === interactionId),
+			);
+			if (existing) {
+				valid = true;
+				receipt = existing;
+				return current;
+			}
+			if (
+				!command &&
+				(current.pendingActionId !== route!.actionId || current.pendingActionNonce !== route!.actionNonce)
+			)
+				return current;
+			if (
+				!command &&
+				(current.inboundDispatches ?? []).some(
+					item =>
+						item.kind === "action" &&
+						item.actionId === route!.actionId &&
+						item.actionNonce === route!.actionNonce,
+				)
+			)
+				return current;
+			valid = true;
+			receipt = command
+				? {
+						key: event.id,
+						eventId: event.id,
+						kind: "command",
+						endpointGeneration: record.endpointGeneration!,
+						effectId,
+						idempotencyKey,
+					}
+				: {
+						key: event.id,
+						eventId: event.id,
+						interactionId: interactionId!,
+						kind: "action",
+						actionId: route!.actionId,
+						actionNonce: route!.actionNonce,
+						endpointGeneration: record.endpointGeneration!,
+						effectId,
+						idempotencyKey,
+					};
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				inboundDispatches: [...(current.inboundDispatches ?? []), receipt!],
+			});
+		});
+		if (!valid || !receipt) {
+			await this.#terminalizeRejectedInbound(
+				effectId,
+				liveCallbackEffect ? { owner: this.#dispatchOwner, epoch: liveCallbackEffect.epoch } : undefined,
+			);
+			return "invalid";
+		}
+		if (liveCallbackEffect && liveCallbackEffect.id !== receipt.effectId) {
+			await this.#terminalizeRejectedInbound(liveCallbackEffect.id, {
+				owner: this.#dispatchOwner,
+				epoch: liveCallbackEffect.epoch,
+			});
+			liveCallbackEffect = undefined;
+		}
+		return { receipt, liveCallbackEffect };
+	}
+	async #dispatchInbound(
+		record: DiscordConversation,
+		initialEndpoint: DiscordEndpointBinding | null,
+		receipt: DiscordInboundDispatchReceipt,
+		interaction?: DiscordInboundEvent["interaction"],
+		liveCallbackEffect?: ChatEffect<DiscordInboundEffectPayload>,
+	): Promise<void> {
+		const claimedEffect =
+			liveCallbackEffect ??
+			(await this.#rescheduleAfterEffectTransition(
+				this.#effects.claim<DiscordInboundEffectPayload>(
+					receipt.effectId,
+					this.#dispatchOwner,
+					this.#dispatchLeaseMs,
+				),
+			));
+		if (!claimedEffect) return;
+		let effect: ChatEffect<DiscordInboundEffectPayload> = claimedEffect;
+		let lease = { owner: this.#dispatchOwner, epoch: effect.epoch };
+
+		const current = await this.#currentInboundRecord(record, receipt);
+		if (!current) {
+			await this.#terminalizeInbound(record, receipt, "rejected", lease);
+
+			return;
+		}
+		record = current;
+		if (receipt.kind === "action" && !this.#hasDurableDeferIntent(effect)) {
+			// Callback tokens cannot survive a restart. Persist the intent before remote
+			// I/O so recovery can safely resume SDK delivery whether defer reached Discord
+			// or the process stopped first.
+			if (!interaction) {
+				await this.#terminalizeInbound(record, receipt, "callback_token_unavailable", lease);
+
+				return;
+			}
+
+			let callbackLeaseLost = false;
+			let callbackRenewal: Promise<boolean> | undefined;
+			const renewCallbackLease = async (): Promise<boolean> => {
+				if (callbackLeaseLost) return false;
+				if (callbackRenewal) return await callbackRenewal;
+				const renewal = (async (): Promise<boolean> => {
+					if (
+						!(await this.#rescheduleAfterEffectTransition(
+							this.#effects.renew(effect.id, lease, this.#dispatchLeaseMs),
+						))
+					)
+						callbackLeaseLost = true;
+					return !callbackLeaseLost;
+				})();
+				callbackRenewal = renewal;
+				try {
+					return await renewal;
+				} finally {
+					if (callbackRenewal === renewal) callbackRenewal = undefined;
+				}
+			};
+			const timer = setInterval(
+				() => {
+					void renewCallbackLease().catch(() => {});
+				},
+				Math.max(1, Math.floor(this.#dispatchLeaseMs / 3)),
+			);
+			try {
+				if (!(await renewCallbackLease())) return;
+				const prepared = await this.#rescheduleAfterEffectTransition(
+					this.#effects.recordReceipt<DiscordInboundEffectPayload>(effect.id, lease, { status: "defer_intent" }),
+				);
+				if (!prepared) return;
+				effect = prepared;
+				if (!(await renewCallbackLease())) return;
+				await this.options.provider.deferInteraction({ id: interaction.id, token: interaction.token });
+				if (!(await renewCallbackLease())) return;
+				const deferred = await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(effect.id, lease, "accepted", { status: "deferred" }),
+				);
+				if (!deferred) return;
+				const reclaimed = await this.#rescheduleAfterEffectTransition(
+					this.#effects.claim<DiscordInboundEffectPayload>(effect.id, this.#dispatchOwner, this.#dispatchLeaseMs),
+				);
+				if (!reclaimed) return;
+				effect = reclaimed;
+				lease = { owner: this.#dispatchOwner, epoch: effect.epoch };
+			} catch (error) {
+				const definitelyUnsent = this.#isDefiniteCallbackPreSendFailure(error);
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(effect.id, lease, "accepted", {
+						status: definitelyUnsent ? "callback_pre_send_failure" : "defer_intent",
+					}),
+				);
+				throw new Error("Discord interaction callback failed");
+			} finally {
+				clearInterval(timer);
+			}
+		}
+
+		const dispatchable = await this.#currentInboundRecord(record, receipt);
+		if (!dispatchable) {
+			await this.#terminalizeInbound(record, receipt, "stale_binding", lease);
+
+			return;
+		}
+		record = dispatchable;
+		const endpoint = initialEndpoint ?? (await this.#resolveEndpoint(record.sessionId!, receipt.endpointGeneration));
+		if (!this.#matches(record, endpoint) || receipt.endpointGeneration !== endpoint.generation) {
+			await this.#rescheduleAfterEffectTransition(
+				this.#effects.record(effect.id, lease, "accepted", {
+					status: this.#inboundAcceptedStatus(effect, "pre_send_binding_changed"),
+				}),
+			);
+			return;
+		}
+
+		let leaseLost = false;
+		let renewal: Promise<boolean> | undefined;
+		const renew = async (): Promise<boolean> => {
+			if (leaseLost) return false;
+			if (renewal) return await renewal;
+			const currentRenewal = (async (): Promise<boolean> => {
+				if (
+					!(await this.#rescheduleAfterEffectTransition(
+						this.#effects.renew(effect.id, lease, this.#dispatchLeaseMs),
+					))
+				)
+					leaseLost = true;
+				return !leaseLost;
+			})();
+			renewal = currentRenewal;
+			try {
+				return await currentRenewal;
+			} finally {
+				if (renewal === currentRenewal) renewal = undefined;
+			}
+		};
+		const timer = setInterval(
+			() => {
+				void renew().catch(() => {});
+			},
+			Math.max(1, Math.floor(this.#dispatchLeaseMs / 3)),
+		);
+		try {
+			if (!(await renew())) return;
+			if (!this.#matches(record, endpoint) || receipt.endpointGeneration !== endpoint.generation) {
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(effect.id, lease, "accepted", {
+						status: this.#inboundAcceptedStatus(effect, "pre_send_binding_changed"),
+					}),
+				);
+				return;
+			}
+
+			if (!(await renew())) return;
+			const beforeSend = await this.#currentInboundRecord(record, receipt);
+			if (!beforeSend) {
+				await this.#terminalizeInbound(record, receipt, "stale_binding", lease);
+
+				return;
+			}
+			record = beforeSend;
+			if (!this.#matches(record, endpoint) || receipt.endpointGeneration !== endpoint.generation) {
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(effect.id, lease, "accepted", {
+						status: this.#inboundAcceptedStatus(effect, "pre_send_binding_changed"),
+					}),
+				);
+				return;
+			}
+
+			if (effect.payload.type === "command")
+				await this.options.onCommand?.(
+					record.sessionId!,
+					effect.payload.content,
+					endpoint,
+					effect.payload.idempotencyKey,
+				);
+			else await endpoint.send(effect.payload);
+			if (!leaseLost && (await renew()) && (await this.#effects.record(effect.id, lease, "terminal")))
+				await this.#finishInbound(record, receipt);
+		} catch (error) {
+			if (!leaseLost) {
+				const state = this.#isDefiniteSdkPreSendFailure(error) ? "accepted" : "uncertain";
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(effect.id, lease, state, {
+						status: state === "accepted" ? this.#inboundAcceptedStatus(effect, "pre_send_failure") : "uncertain",
+					}),
+				);
+			}
+		} finally {
+			clearInterval(timer);
+		}
+	}
+	#hasDurableDeferIntent(effect: ChatEffect<DiscordInboundEffectPayload>): boolean {
+		return (
+			effect.kind === "discord.inbound.action" &&
+			(effect.receipt?.status === "defer_intent" || effect.receipt?.status === "deferred")
+		);
+	}
+	#inboundAcceptedStatus(effect: ChatEffect<DiscordInboundEffectPayload>, fallback: string): string {
+		return this.#hasDurableDeferIntent(effect) ? (effect.receipt?.status ?? fallback) : fallback;
+	}
+
+	#hasLiveCallbackLease(effect: ChatEffect | undefined): boolean {
+		return (
+			effect?.kind === "discord.inbound.action" &&
+			effect.state === "leased" &&
+			typeof effect.owner === "string" &&
+			(effect.leaseExpiresAt ?? 0) > this.#now()
+		);
+	}
+
+	async #drainPendingDispatches(): Promise<boolean> {
+		await this.#reconcileTerminalInboundReceipts();
+		let recoveryFailed = false;
+		const dispatched = new Set<string>();
+		for (const record of Object.values((await this.#store.load()).conversations)) {
+			if (!record.threadId || !record.sessionId || record.state !== "active") continue;
+			let endpoint: DiscordEndpointBinding | null = null;
+			let endpointResolved = false;
+			for (const [index, receipt] of (record.inboundDispatches ?? []).entries()) {
+				// Never race a foreground handleInbound() dispatch: while an effect is
+				// in-flight it briefly unowns itself (record "accepted"/"deferred" before
+				// reclaiming), a window in which recovery could otherwise claim it and
+				// deliver its reply on the recovery timer instead of the awaited path.
+				if (this.#inflightInbound.has(receipt.effectId)) {
+					dispatched.add(receipt.effectId);
+					continue;
+				}
+				if (
+					receipt.kind === "action" &&
+					(record.inboundDispatches ?? [])
+						.slice(0, index)
+						.some(
+							candidate =>
+								candidate.kind === "action" &&
+								candidate.actionId === receipt.actionId &&
+								candidate.actionNonce === receipt.actionNonce,
+						)
+				) {
+					await this.#terminalizeInbound(record, receipt, "duplicate_action");
+					continue;
+				}
+				const effect = await this.#effects.read(receipt.effectId);
+				if (!effect) {
+					// Referenced effects are retained by terminal pruning. Preserve the
+					// receipt and retry recovery rather than acknowledging lost authority.
+					recoveryFailed = true;
+					continue;
+				}
+				if (effect?.state === "terminal") {
+					await this.#finishInbound(record, receipt);
+					continue;
+				}
+				if (this.#hasLiveCallbackLease(effect)) {
+					dispatched.add(receipt.effectId);
+					continue;
+				}
+				if (!endpointResolved) {
+					endpoint = await this.#resolveEndpoint(record.sessionId, receipt.endpointGeneration);
+					endpointResolved = true;
+				}
+				if (!this.#matches(record, endpoint) || endpoint.generation !== receipt.endpointGeneration) {
+					await this.#terminalizeInbound(record, receipt, "stale_binding");
+					continue;
+				}
+				dispatched.add(receipt.effectId);
+				await this.#dispatchInbound(record, endpoint, receipt);
+			}
+		}
+
+		// Effects are the authority: a crash between enqueue and mapping receipt
+		// publication must not strand a command at restart. Adoption revalidates
+		// the current mapping before an orphan can reach the SDK.
+		for (const effect of await this.#effects.list()) {
+			if (
+				effect.transport !== "discord" ||
+				effect.state === "terminal" ||
+				!effect.kind.startsWith("discord.inbound.") ||
+				dispatched.has(effect.id) ||
+				this.#inflightInbound.has(effect.id) ||
+				this.#hasLiveCallbackLease(effect)
+			)
+				continue;
+			const payload = effect.payload as DiscordInboundEffectPayload;
+			const routing = payload.routing;
+			if (!routing) continue;
+			const adopted = await this.#adoptOrphanInbound(
+				effect.id,
+				effect.sessionId,
+				effect.endpointGeneration,
+				payload,
+				routing,
+			);
+			if (!adopted) continue;
+			const endpoint = await this.#resolveEndpoint(adopted.record.sessionId!, effect.endpointGeneration);
+			if (!this.#matches(adopted.record, endpoint) || endpoint.generation !== effect.endpointGeneration) {
+				await this.#terminalizeInbound(adopted.record, adopted.receipt, "stale_binding");
+				continue;
+			}
+			await this.#dispatchInbound(adopted.record, endpoint, adopted.receipt);
+		}
+		return recoveryFailed;
+	}
+	async #adoptOrphanInbound(
+		effectId: string,
+		sessionId: string | undefined,
+		endpointGeneration: number,
+		payload: DiscordInboundEffectPayload,
+		routing: DiscordInboundRouting,
+	): Promise<{ record: DiscordConversation; receipt: DiscordInboundDispatchReceipt } | undefined> {
+		const key = discordConversationKey({
+			appId: this.options.provider.applicationId,
+			guildId: routing.guildId,
+			parentChannelId: routing.parentId,
+			threadId: routing.threadId,
+		});
+		const expectedId = `discord:${this.options.provider.applicationId}:${routing.guildId}:${routing.parentId}:${routing.threadId}:${routing.eventId}`;
+		let record: DiscordConversation | undefined;
+		let receipt: DiscordInboundDispatchReceipt | undefined;
+		const structurallyValid =
+			effectId === expectedId &&
+			payload.idempotencyKey === effectId &&
+			(payload.type === "command"
+				? routing.kind === "command"
+				: routing.kind === "action" && payload.id === routing.actionId && typeof routing.actionNonce === "string");
+		await this.#store.transact(key, current => {
+			if (
+				!structurallyValid ||
+				!current ||
+				current.state !== "active" ||
+				current.sessionId !== sessionId ||
+				current.endpointGeneration !== endpointGeneration
+			)
+				return current;
+			const existing = (current.inboundDispatches ?? []).find(
+				candidate =>
+					candidate.eventId === routing.eventId ||
+					(routing.interactionId !== undefined && candidate.interactionId === routing.interactionId),
+			);
+			if (existing) {
+				if (
+					existing.effectId !== effectId ||
+					existing.idempotencyKey !== payload.idempotencyKey ||
+					existing.endpointGeneration !== endpointGeneration ||
+					existing.kind !== routing.kind ||
+					(existing.kind === "action" &&
+						(existing.actionId !== routing.actionId ||
+							existing.actionNonce !== routing.actionNonce ||
+							existing.interactionId !== routing.interactionId))
+				)
+					return current;
+
+				record = current;
+				receipt = existing;
+				return current;
+			}
+			if (
+				current.seenEventIds.includes(routing.eventId) ||
+				(routing.interactionId !== undefined && current.seenInteractionIds.includes(routing.interactionId)) ||
+				(routing.kind === "action" &&
+					(current.pendingActionId !== routing.actionId || current.pendingActionNonce !== routing.actionNonce))
+			)
+				return current;
+			if (
+				routing.kind === "action" &&
+				(current.inboundDispatches ?? []).some(
+					candidate =>
+						candidate.kind === "action" &&
+						candidate.actionId === routing.actionId &&
+						candidate.actionNonce === routing.actionNonce,
+				)
+			)
+				return current;
+
+			receipt = this.#receiptFromRouting(effectId, endpointGeneration, payload.idempotencyKey, routing);
+			record = normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				inboundDispatches: [...(current.inboundDispatches ?? []), receipt],
+			});
+			return record;
+		});
+		if (record && receipt) return { record, receipt };
+		await this.#terminalizeRejectedInbound(effectId);
+		return undefined;
+	}
+	#sameInboundReceipt(left: DiscordInboundDispatchReceipt, right: DiscordInboundDispatchReceipt): boolean {
+		return (
+			left.key === right.key &&
+			left.eventId === right.eventId &&
+			left.interactionId === right.interactionId &&
+			left.kind === right.kind &&
+			left.actionId === right.actionId &&
+			left.actionNonce === right.actionNonce &&
+			left.endpointGeneration === right.endpointGeneration &&
+			left.effectId === right.effectId &&
+			left.idempotencyKey === right.idempotencyKey
+		);
+	}
+	#completeInbound(record: DiscordConversation, receipt: DiscordInboundDispatchReceipt): DiscordConversation {
+		const clearsAction =
+			receipt.kind === "action" &&
+			record.pendingActionId === receipt.actionId &&
+			record.pendingActionNonce === receipt.actionNonce;
+		return normalizeDiscordConversation({
+			...record,
+			generation: record.generation + 1,
+			updatedAt: this.#now(),
+			pendingActionId: clearsAction ? undefined : record.pendingActionId,
+			pendingActionNonce: clearsAction ? undefined : record.pendingActionNonce,
+			pendingActionEffectId: clearsAction ? undefined : record.pendingActionEffectId,
+			seenEventIds: [...record.seenEventIds, receipt.eventId],
+			seenInteractionIds:
+				receipt.interactionId === undefined
+					? record.seenInteractionIds
+					: [...record.seenInteractionIds, receipt.interactionId],
+			inboundDispatches: (record.inboundDispatches ?? []).filter(
+				candidate => !this.#sameInboundReceipt(candidate, receipt),
+			),
+		});
+	}
+	#hasLiveEffectLease(effect: ChatEffect | undefined): boolean {
+		return (
+			effect?.state === "leased" && typeof effect.owner === "string" && (effect.leaseExpiresAt ?? 0) > this.#now()
+		);
+	}
+	async #terminalizeEffect(id: string, status: string, lease?: ChatEffectLease): Promise<boolean> {
+		if (lease) {
+			const terminalized = await this.#effects.record(id, lease, "terminal", { status });
+			return terminalized?.state === "terminal";
+		}
+		const effect = await this.#effects.read(id);
+		if (!effect || effect.state === "terminal") return true;
+		if (effect.state === "uncertain" || this.#hasLiveEffectLease(effect)) return false;
+		if (effect.state === "leased") {
+			const claimed = await this.#effects.claim(id, this.#providerOwner, this.#providerLeaseMs);
+			if (!claimed) return false;
+			await this.#effects.record(id, { owner: this.#providerOwner, epoch: claimed.epoch }, "uncertain", {
+				status: "stale_lease_expired",
+			});
+			return false;
+		}
+		return (await this.#effects.terminalize(id, { status }))?.state === "terminal";
+	}
+	async #terminalizeRejectedInbound(effectId: string, lease?: ChatEffectLease): Promise<void> {
+		await this.#terminalizeEffect(effectId, "rejected", lease);
+	}
+	async #terminalizeInbound(
+		record: DiscordConversation,
+		receipt: DiscordInboundDispatchReceipt,
+		status: string,
+		lease?: ChatEffectLease,
+	): Promise<void> {
+		if (!(await this.#terminalizeEffect(receipt.effectId, status, lease))) return;
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		await this.#store.transact(key, current => {
+			const matching = current?.inboundDispatches?.find(candidate => this.#sameInboundReceipt(candidate, receipt));
+			return !current || !matching ? current : this.#completeInbound(current, matching);
+		});
+	}
+	async #currentInboundRecord(
+		record: DiscordConversation,
+		receipt: DiscordInboundDispatchReceipt,
+	): Promise<DiscordConversation | undefined> {
+		const current = await this.#byThread(record.guildId, record.parentChannelId, record.threadId!);
+		const claimed = current?.inboundDispatches?.find(candidate => this.#sameInboundReceipt(candidate, receipt));
+		if (
+			current?.state !== "active" ||
+			current.sessionId !== record.sessionId ||
+			current.endpointGeneration !== receipt.endpointGeneration ||
+			!claimed
+		)
+			return undefined;
+		if (
+			receipt.kind === "action" &&
+			(current.pendingActionId !== receipt.actionId || current.pendingActionNonce !== receipt.actionNonce)
+		)
+			return undefined;
+
+		return current;
+	}
+	#receiptFromRouting(
+		effectId: string,
+		endpointGeneration: number,
+		idempotencyKey: string,
+		routing: DiscordInboundRouting,
+	): DiscordInboundDispatchReceipt {
+		return routing.kind === "command"
+			? {
+					key: routing.eventId,
+					eventId: routing.eventId,
+					kind: "command",
+					endpointGeneration,
+					effectId,
+					idempotencyKey,
+				}
+			: {
+					key: routing.eventId,
+					eventId: routing.eventId,
+					interactionId: routing.interactionId!,
+					kind: "action",
+					actionId: routing.actionId!,
+					actionNonce: routing.actionNonce!,
+					endpointGeneration,
+					effectId,
+					idempotencyKey,
+				};
+	}
+
+	async #finishInbound(record: DiscordConversation, receipt: DiscordInboundDispatchReceipt): Promise<void> {
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		await this.#store.transact(key, current => {
+			const matching = current?.inboundDispatches?.find(candidate => this.#sameInboundReceipt(candidate, receipt));
+			return !current || !matching ? current : this.#completeInbound(current, matching);
+		});
+	}
+	async #reconcileTerminalInboundReceipts(): Promise<void> {
+		for (const effect of await this.#effects.list()) {
+			if (
+				effect.transport !== "discord" ||
+				effect.state !== "terminal" ||
+				(effect.kind !== "discord.inbound.command" && effect.kind !== "discord.inbound.action")
+			)
+				continue;
+			const payload = effect.payload as DiscordInboundEffectPayload;
+			const routing = payload?.routing;
+			if (
+				!routing ||
+				!effect.sessionId ||
+				!routing.guildId ||
+				!routing.parentId ||
+				!routing.threadId ||
+				!routing.eventId ||
+				payload.idempotencyKey !== effect.id ||
+				effect.id !==
+					`discord:${this.options.provider.applicationId}:${routing.guildId}:${routing.parentId}:${routing.threadId}:${routing.eventId}` ||
+				(payload.type === "command"
+					? routing.kind !== "command" || effect.kind !== "discord.inbound.command"
+					: routing.kind !== "action" ||
+						effect.kind !== "discord.inbound.action" ||
+						!routing.interactionId ||
+						!routing.actionId ||
+						!routing.actionNonce ||
+						payload.id !== routing.actionId)
+			)
+				continue;
+			const receipt = this.#receiptFromRouting(
+				effect.id,
+				effect.endpointGeneration,
+				payload.idempotencyKey,
+				routing,
+			);
+			const record = await this.#byThread(routing.guildId, routing.parentId, routing.threadId);
+			if (record?.inboundDispatches?.some(candidate => this.#sameInboundReceipt(candidate, receipt)))
+				await this.#finishInbound(record, receipt);
+		}
+	}
+
+	#matches(record: DiscordConversation, endpoint: DiscordEndpointBinding | null): endpoint is DiscordEndpointBinding {
+		if (!endpoint?.isCurrent()) return false;
+		return record.state === "active" && record.endpointGeneration === endpoint.generation;
+	}
+	async #bindingCurrent(sessionId: string, endpointGeneration: number): Promise<boolean> {
+		try {
+			const endpoint = await this.#resolveEndpoint(sessionId, endpointGeneration);
+			return !!endpoint && endpoint.isCurrent() && endpoint.generation === endpointGeneration;
+		} catch {
+			return false;
+		}
+	}
+	async #requireLiveBinding(sessionId: string, endpointGeneration: number): Promise<void> {
+		if (!(await this.#bindingCurrent(sessionId, endpointGeneration))) throw new DiscordEndpointBindingError();
+	}
+	#isDefiniteSdkPreSendFailure(error: unknown): boolean {
+		if (error instanceof DiscordEndpointBindingError) return true;
+		if (error instanceof SdkClientError) return error.code === "connection_closed";
+		return (
+			error instanceof Error &&
+			error.name === "ChatDeliveryError" &&
+			(error as ChatDeliveryError).phase === "pre_send"
+		);
+	}
+	#isDefiniteCallbackPreSendFailure(error: unknown): boolean {
+		// This is intentionally limited to Discord's received-and-rejected callback
+		// response. Transport errors, connection loss, and arbitrary provider errors
+		// leave the persisted defer intent authoritative because the callback may have
+		// been accepted before its HTTP response was lost.
+		return error instanceof Error && /^Discord API request failed \(4\d\d\)$/.test(error.message);
+	}
+
+	async #ensureConversation(input: DiscordNotificationInput): Promise<DiscordConversation> {
+		const existing = await this.#bySession(input.sessionId);
+		if (existing && closingIntent(existing)) {
+			await this.#driveClose(existing);
+			throw new Error("Discord thread is closing");
+		}
+		if (existing?.state === "active" && existing.threadId) {
+			if (existing.endpointGeneration === input.endpointGeneration) return existing;
+			await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+			return await this.#replace(existing, { ...existing, endpointGeneration: input.endpointGeneration });
+		}
+		const inFlight = this.#creates.get(input.sessionId);
+		if (inFlight) {
+			let created: DiscordConversation;
+			try {
+				created = await inFlight;
+			} catch {
+				await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+				return await this.#ensureConversation(input);
+			}
+			if (created.endpointGeneration === input.endpointGeneration) return created;
+			await this.#requireLiveBinding(input.sessionId, input.endpointGeneration);
+			return await this.#replace(created, { ...created, endpointGeneration: input.endpointGeneration });
+		}
+		const pending = this.#create(input.sessionId, input.endpointGeneration, randomUUID(), input.threadName);
+		this.#creates.set(input.sessionId, pending);
+		try {
+			return await pending;
+		} finally {
+			this.#creates.delete(input.sessionId);
+		}
+	}
+
+	async #create(
+		sessionId: string,
+		endpointGeneration: number,
+		nonce: string,
+		name = "GJC session",
+	): Promise<DiscordConversation> {
+		const intentKey = this.#intentKey(sessionId);
+		const owner = randomUUID();
+		let intent: DiscordConversation | undefined;
+		for (;;) {
+			const active = await this.#bySession(sessionId);
+			if (active && closingIntent(active)) {
+				await this.#driveClose(active);
+				throw new Error("Discord thread is closing");
+			}
+			if (active?.state === "active" && active.threadId) {
+				if (active.endpointGeneration === endpointGeneration) return active;
+				await this.#requireLiveBinding(sessionId, endpointGeneration);
+				return await this.#replace(active, { ...active, endpointGeneration });
+			}
+			const now = this.#now();
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+			intent = await this.#store.transact(intentKey, old => {
+				if (old?.state === "creating" && old.createOwner && (old.createLeaseExpiresAt ?? 0) > now) return old;
+				return {
+					generation: (old?.generation ?? 0) + 1,
+					state: "creating",
+					appId: this.options.provider.applicationId,
+					guildId: this.options.guildId,
+					parentChannelId: this.options.parentChannelId,
+					sessionId,
+					endpointGeneration,
+					createNonce: old?.createNonce ?? nonce,
+					createOwner: owner,
+					createLeaseExpiresAt: now + 60_000,
+					updatedAt: now,
+					seenEventIds: [],
+					seenInteractionIds: [],
+				};
+			});
+			if (!intent) throw new Error("Unable to persist Discord create intent");
+			if (intent.createOwner === owner) break;
+			await Bun.sleep(Math.min(25, Math.max(1, (intent.createLeaseExpiresAt ?? now) - now)));
+		}
+		const active = await this.#bySession(sessionId);
+		if (active?.state === "active" && active.threadId) {
+			if (active.endpointGeneration === endpointGeneration) return active;
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+			return await this.#replace(active, { ...active, endpointGeneration });
+		}
+		let thread: DiscordThread | null;
+		try {
+			thread = await this.#withCreateIntentLease(intent, () => this.#createThreadEffect(intent, name));
+			await this.#requireLiveBinding(sessionId, endpointGeneration);
+		} catch (error) {
+			await this.#abandonCreator(intentKey, intent);
+			throw error;
+		}
+		const currentIntent = await this.#store.read(intentKey);
+		if (
+			currentIntent?.state !== "creating" ||
+			currentIntent.createOwner !== intent.createOwner ||
+			currentIntent.generation !== intent.generation ||
+			(currentIntent.createLeaseExpiresAt ?? 0) <= this.#now()
+		) {
+			throw new Error("Discord create intent lost its fence before mapping commit");
+		}
+		await this.#requireLiveBinding(sessionId, endpointGeneration);
+		const key = discordConversationKey({
+			appId: intent.appId,
+			guildId: intent.guildId,
+			parentChannelId: intent.parentChannelId,
+			threadId: thread.id,
+		});
+		const record = await this.#store.transact(key, old =>
+			normalizeDiscordConversation({
+				generation: (old?.generation ?? 0) + 1,
+				state: "active",
+				appId: intent.appId,
+				guildId: intent.guildId,
+				parentChannelId: intent.parentChannelId,
+				threadId: thread.id,
+				sessionId,
+				endpointGeneration,
+				createNonce: intent.createNonce,
+				effectIncarnationId: old?.effectIncarnationId ?? intent.effectIncarnationId ?? randomUUID(),
+				updatedAt: this.#now(),
+				seenEventIds: old?.seenEventIds ?? [],
+				seenInteractionIds: old?.seenInteractionIds ?? [],
+				inboundDispatches: old?.inboundDispatches,
+			}),
+		);
+		if (!record) throw new Error("Unable to persist Discord thread mapping");
+		await this.#store.delete(intentKey, intent.generation);
+		return record;
+	}
+
+	async #sessionMappings(sessionId: string): Promise<DiscordConversation[]> {
+		return Object.values((await this.#store.load()).conversations).filter(
+			record => record.sessionId === sessionId && record.state !== "creating",
+		);
+	}
+	async #bySession(sessionId: string): Promise<DiscordConversation | undefined> {
+		const document = await this.#store.load();
+		return Object.values(document.conversations)
+			.filter(record => record.sessionId === sessionId && record.state !== "creating")
+			.sort(
+				(left, right) =>
+					stateRank(left.state) - stateRank(right.state) ||
+					right.generation - left.generation ||
+					right.updatedAt - left.updatedAt,
+			)[0];
+	}
+	async #byThread(
+		guildId: string,
+		parentChannelId: string,
+		threadId: string,
+	): Promise<DiscordConversation | undefined> {
+		return await this.#store.read(
+			discordConversationKey({ appId: this.options.provider.applicationId, guildId, parentChannelId, threadId }),
+		);
+	}
+	#closeMarkerEffectId(record: DiscordConversation): string {
+		const intent = closingIntent(record);
+		if (!record.threadId || !intent) throw new Error("Discord close intent is unavailable.");
+		return `close-marker:${record.threadId}:${intent.nonce}`;
+	}
+	#closeArchiveEffectId(record: DiscordConversation): string {
+		const intent = closingIntent(record);
+		if (!record.threadId || !intent) throw new Error("Discord close intent is unavailable.");
+		return `close-archive:${record.threadId}:${intent.nonce}`;
+	}
+	async #markClosing(sessionId: string): Promise<DiscordConversation | undefined> {
+		const record = await this.#bySession(sessionId);
+		if (!record?.threadId || record.state === "closed") return undefined;
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId,
+		});
+		let closing: DiscordConversation | undefined;
+		await this.#store.transact(key, current => {
+			if (!current || current.sessionId !== sessionId || !current.threadId || current.state === "closed")
+				return current;
+			if (closingIntent(current)) {
+				closing = current;
+				return current;
+			}
+			closing = normalizeDiscordConversation(withClosingIntent(current, randomUUID(), this.#now()));
+			return closing;
+		});
+		return closing;
+	}
+	async #driveClose(record: DiscordConversation): Promise<void> {
+		if (!record.threadId) return;
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId,
+		});
+		let current = await this.#store.read(key);
+		if (!current || !closingIntent(current)) return;
+		for (const receipt of current.inboundDispatches ?? [])
+			await this.#terminalizeInbound(current, receipt, "closing");
+		current = await this.#store.read(key);
+		if (!current || !closingIntent(current)) return;
+		const closingRecord = current;
+		const intent = closingIntent(closingRecord)!;
+		await this.#postEffect(
+			this.#closeMarkerEffectId(closingRecord),
+			closingRecord,
+			"This conversation is closed.",
+			undefined,
+			false,
+			true,
+		);
+		await this.#threadEffect(this.#closeArchiveEffectId(closingRecord), closingRecord, "archive", true, true);
+		await this.#store.transact(key, candidate => {
+			const candidateIntent = closingIntent(candidate);
+			return candidate && candidate.sessionId === closingRecord.sessionId && candidateIntent?.nonce === intent.nonce
+				? normalizeDiscordConversation(withoutClosingIntent(candidate, this.#now()))
+				: candidate;
+		});
+	}
+	async #recoverClosingConversations(): Promise<boolean> {
+		let failed = false;
+		for (const record of Object.values((await this.#store.load()).conversations)) {
+			if (!closingIntent(record)) continue;
+			try {
+				await this.#driveClose(record);
+			} catch {
+				failed = true;
+			}
+		}
+		return failed;
+	}
+	async #replace(
+		current: DiscordConversation,
+		next: Omit<DiscordConversation, "generation"> & { generation?: number },
+	): Promise<DiscordConversation> {
+		const key = current.threadId
+			? discordConversationKey({
+					appId: current.appId,
+					guildId: current.guildId,
+					parentChannelId: current.parentChannelId,
+					threadId: current.threadId,
+				})
+			: this.#intentKey(current.sessionId!);
+		const result = await this.#store.write(key, current.generation, {
+			...next,
+			generation: current.generation + 1,
+			updatedAt: this.#now(),
+		});
+		if (!result) {
+			const stored = await this.#store.read(key);
+			throw new Error(
+				`Discord conversation changed concurrently (key=${key}, expected=${current.generation}, actual=${stored?.generation ?? "missing"})`,
+			);
+		}
+		return (await this.#store.read(key))!;
+	}
+	async #beginArchive(record: DiscordConversation): Promise<DiscordConversation> {
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		let archiving: DiscordConversation | undefined;
+		await this.#store.transact(key, current => {
+			if (
+				current?.state !== "active" ||
+				current.sessionId !== record.sessionId ||
+				current.endpointGeneration !== record.endpointGeneration
+			)
+				return current;
+			if (current.archiveOccurrenceId) {
+				archiving = current;
+				return current;
+			}
+			const archiveOccurrenceId = randomUUID();
+			const effectIncarnationId = backfilledEffectIncarnationId(current);
+			archiving = normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				effectIncarnationId,
+				archiveOccurrenceId,
+				archiveEffectId: `archive:${current.threadId}:${effectIncarnationId}:${archiveOccurrenceId}`,
+			});
+
+			return archiving;
+		});
+		if (!archiving) throw new Error("Discord archive intent lost its authority");
+		return archiving;
+	}
+	async #completeArchive(record: DiscordConversation, occurrenceId: string): Promise<void> {
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		await this.#store.transact(key, current => {
+			if (
+				current?.state !== "active" ||
+				current.sessionId !== record.sessionId ||
+				current.archiveOccurrenceId !== occurrenceId
+			)
+				return current;
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				state: "archived",
+				archivedAt: this.#now(),
+				archiveOccurrenceId: undefined,
+				archiveEffectId: undefined,
+			});
+		});
+	}
+	async #completeResume(record: DiscordConversation, occurrenceId: string): Promise<DiscordConversation> {
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		const completed = await this.#store.transact(key, current => {
+			if (
+				!current ||
+				current.sessionId !== record.sessionId ||
+				current.endpointGeneration !== record.endpointGeneration
+			)
+				return current;
+			if (current.state === "active" && current.resumeOccurrenceId === undefined) return current;
+			if (current.state !== "resuming" || current.resumeOccurrenceId !== occurrenceId) return current;
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				state: "active",
+				archivedAt: undefined,
+				resumeOccurrenceId: undefined,
+				resumeEffectId: undefined,
+			});
+		});
+		if (completed?.state !== "active" || completed.sessionId !== record.sessionId)
+			throw new Error("Discord resume occurrence lost its authority");
+		return completed;
+	}
+	async #abandonCreator(intentKey: string, intent: DiscordConversation): Promise<void> {
+		await this.#store.transact(intentKey, current => {
+			if (!current || current.generation !== intent.generation || current.createOwner !== intent.createOwner)
+				return current;
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				createOwner: undefined,
+				createLeaseExpiresAt: undefined,
+			});
+		});
+	}
+	#intentKey(sessionId: string): string {
+		return `${this.options.provider.applicationId}:${this.options.guildId}:${this.options.parentChannelId}:creating:${sessionId}`;
+	}
+	async #withCreateIntentLease<T>(intent: DiscordConversation, work: () => Promise<T>): Promise<T> {
+		let lost = false;
+		let renewal: Promise<boolean> | undefined;
+		let expectedGeneration = intent.generation;
+		const renew = async (): Promise<boolean> => {
+			if (lost) return false;
+			if (renewal) return await renewal;
+			const currentRenewal = (async (): Promise<boolean> => {
+				const now = this.#now();
+				const current = await this.#store.transact(this.#intentKey(intent.sessionId!), candidate => {
+					if (
+						candidate?.state !== "creating" ||
+						candidate.createOwner !== intent.createOwner ||
+						candidate.generation !== expectedGeneration ||
+						(candidate.createLeaseExpiresAt ?? 0) <= now
+					)
+						return candidate;
+					return {
+						...candidate,
+						generation: candidate.generation + 1,
+						createLeaseExpiresAt: now + this.#providerLeaseMs,
+						updatedAt: now,
+					};
+				});
+				if (
+					current?.state !== "creating" ||
+					current.createOwner !== intent.createOwner ||
+					current.generation !== expectedGeneration + 1 ||
+					(current.createLeaseExpiresAt ?? 0) <= now
+				) {
+					lost = true;
+				} else {
+					expectedGeneration = current.generation;
+					intent.generation = current.generation;
+					intent.createLeaseExpiresAt = current.createLeaseExpiresAt;
+				}
+				return !lost;
+			})();
+			renewal = currentRenewal;
+			try {
+				return await currentRenewal;
+			} finally {
+				if (renewal === currentRenewal) renewal = undefined;
+			}
+		};
+		if (!(await renew())) throw new Error("Discord create intent lost its fence");
+		const timer = setInterval(
+			() => {
+				void renew().catch(() => {});
+			},
+			Math.max(1, Math.floor(this.#providerLeaseMs / 3)),
+		);
+		try {
+			const result = await work();
+			if (!(await renew())) throw new Error("Discord create intent lost its fence");
+			return result;
+		} finally {
+			clearInterval(timer);
+		}
+	}
+	async #clearPending(record: DiscordConversation, actionId: string, actionNonce: string): Promise<void> {
+		const key = record.threadId
+			? discordConversationKey({
+					appId: record.appId,
+					guildId: record.guildId,
+					parentChannelId: record.parentChannelId,
+					threadId: record.threadId,
+				})
+			: this.#intentKey(record.sessionId!);
+		await this.#store.transact(key, current => {
+			if (current?.pendingActionId !== actionId || current.pendingActionNonce !== actionNonce) return current;
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				pendingActionId: undefined,
+				pendingActionNonce: undefined,
+				pendingActionEffectId: undefined,
+			});
+		});
+	}
+	async #ensureActionPublication(record: DiscordConversation, actionId: string): Promise<DiscordConversation> {
+		const key = discordConversationKey({
+			appId: record.appId,
+			guildId: record.guildId,
+			parentChannelId: record.parentChannelId,
+			threadId: record.threadId!,
+		});
+		await this.#requireLiveBinding(record.sessionId!, record.endpointGeneration!);
+		const result = await this.#store.transact(key, current => {
+			if (
+				current?.state !== "active" ||
+				current.sessionId !== record.sessionId ||
+				current.endpointGeneration !== record.endpointGeneration
+			)
+				return current;
+			if (current.pendingActionId === actionId && current.pendingActionNonce && current.pendingActionEffectId)
+				return current;
+			const actionNonce =
+				current.pendingActionId === actionId && current.pendingActionNonce
+					? current.pendingActionNonce
+					: randomUUID();
+			return normalizeDiscordConversation({
+				...current,
+				generation: current.generation + 1,
+				updatedAt: this.#now(),
+				pendingActionId: actionId,
+				pendingActionNonce: actionNonce,
+				pendingActionEffectId: `action-publication:${current.threadId}:${actionId}:${actionNonce}`,
+			});
+		});
+		if (
+			result?.state !== "active" ||
+			result.sessionId !== record.sessionId ||
+			result.endpointGeneration !== record.endpointGeneration ||
+			result.pendingActionId !== actionId ||
+			!result.pendingActionNonce ||
+			!result.pendingActionEffectId
+		) {
+			throw new Error("Discord action publication intent lost its authority");
+		}
+		return result;
+	}
+
+	async #runEffect<TPayload>(
+		id: string,
+		kind: string,
+		sessionId: string | undefined,
+		endpointGeneration: number,
+		payload: TPayload,
+		operation: (ensure: () => Promise<void>, beforeProvider: () => void) => Promise<ChatEffectReceipt>,
+		revalidate: () => boolean | Promise<boolean>,
+		terminalizeStaleBeforeProvider = false,
+	): Promise<ChatEffectReceipt> {
+		const claimed = await this.#rescheduleAfterEffectTransition(
+			this.#effects.enqueueAndClaim<TPayload>(
+				{ id, kind, transport: "discord", sessionId, endpointGeneration, payload },
+				this.#providerOwner,
+				this.#providerLeaseMs,
+			),
+		);
+		let effect: ChatEffect<TPayload>;
+		if (claimed) {
+			// Fresh effect atomically inserted into a live lease. This closes the
+			// enqueue→claim window in which the same-process lease-recovery timer could
+			// claim the still-"pending" effect first and make this foreground claim fail
+			// with "owned by another worker" (mirrors the inbound enqueueAndClaim path).
+			effect = claimed;
+		} else {
+			const initial = await this.#effects.read<TPayload>(id);
+			if (initial?.state === "terminal") {
+				if (!initial.receipt) throw new Error(`Discord effect ${id} has no receipt`);
+				if (terminalizeStaleBeforeProvider && initial.receipt.status === "stale_noop")
+					throw new DiscordEndpointBindingError("Discord thread effect is no longer current.");
+				return initial.receipt;
+			}
+			const reclaimed = await this.#rescheduleAfterEffectTransition(
+				this.#effects.claim<TPayload>(id, this.#providerOwner, this.#providerLeaseMs),
+			);
+			if (!reclaimed) throw new Error(`Discord effect ${id} is owned by another worker`);
+			effect = reclaimed;
+		}
+		const lease: ChatEffectLease = { owner: this.#providerOwner, epoch: effect.epoch };
+		let renewalLost = false;
+		let revalidationFailed = false;
+		let providerEffectStarted = false;
+		let renewal: Promise<boolean> | undefined;
+		const renew = async (): Promise<boolean> => {
+			if (renewalLost) return false;
+			if (renewal) return await renewal;
+			const currentRenewal = (async (): Promise<boolean> => {
+				const renewed = await this.#rescheduleAfterEffectTransition(
+					this.#effects.renew(id, lease, this.#providerLeaseMs),
+				);
+				if (!renewed) renewalLost = true;
+				else if (!(await revalidate())) {
+					revalidationFailed = true;
+					renewalLost = true;
+				}
+				return !renewalLost;
+			})();
+			renewal = currentRenewal;
+			try {
+				return await currentRenewal;
+			} finally {
+				if (renewal === currentRenewal) renewal = undefined;
+			}
+		};
+		const timer = setInterval(
+			() => {
+				void renew().catch(() => {});
+			},
+			Math.max(1, Math.floor(this.#providerLeaseMs / 3)),
+		);
+		const ensure = async (): Promise<void> => {
+			if (!(await renew())) throw new Error(`Discord effect ${id} lost its fence`);
+		};
+		try {
+			await ensure();
+			const receipt = await operation(ensure, () => {
+				providerEffectStarted = true;
+			});
+			await ensure();
+			const committed = await this.#effects.record(id, lease, "terminal", receipt);
+			if (!committed) throw new Error(`Discord effect ${id} lost its fence before commit`);
+			return receipt;
+		} catch (error) {
+			if (terminalizeStaleBeforeProvider && revalidationFailed && !providerEffectStarted)
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(id, lease, "terminal", { status: "stale_noop" }),
+				);
+			else if (!renewalLost)
+				await this.#rescheduleAfterEffectTransition(
+					this.#effects.record(id, lease, "uncertain", { status: "uncertain" }),
+				);
+			throw error;
+		} finally {
+			clearInterval(timer);
+		}
+	}
+
+	async #postEffect(
+		id: string,
+		record: DiscordConversation,
+		content: string,
+		components?: DiscordMessageComponent[],
+		actionPublication = false,
+		closing = false,
+		allowInactive = false,
+	): Promise<void> {
+		const nonce = discordEffectNonce(id);
+		const existingEffect = await this.#effects.read<{
+			threadId: string;
+			content: string;
+			nonce: string;
+			components?: DiscordMessageComponent[];
+		}>(id);
+		const payload = existingEffect?.payload ?? {
+			threadId: record.threadId!,
+			content,
+			nonce,
+			...(components ? { components } : {}),
+		};
+		await this.#runEffect(
+			id,
+			"post-message",
+			record.sessionId,
+			record.endpointGeneration!,
+			payload,
+			async ensure => {
+				await ensure();
+				const reconciled = await this.options.provider.findMessageByNonce({
+					threadId: payload.threadId,
+					nonce: payload.nonce,
+				});
+				if (reconciled)
+					return {
+						provider: "discord",
+						messageId: reconciled.id,
+						threadId: record.threadId,
+						status: "reconciled",
+					};
+				await ensure();
+				const posted = await this.options.provider.postMessage({
+					threadId: payload.threadId,
+					content: payload.content,
+					nonce: payload.nonce,
+					...(payload.components ? { components: payload.components } : {}),
+				});
+				return { provider: "discord", messageId: posted.id, threadId: record.threadId, status: "posted" };
+			},
+			async () => {
+				const current = await this.#byThread(record.guildId, record.parentChannelId, record.threadId!);
+				const intent = closingIntent(record);
+				const mappingCurrent = closing
+					? !!current &&
+						intent?.nonce === closingIntent(current)?.nonce &&
+						current.sessionId === record.sessionId &&
+						current.endpointGeneration === record.endpointGeneration
+					: !!current &&
+						(allowInactive || current.state === "active") &&
+						current.generation === record.generation &&
+						current.endpointGeneration === record.endpointGeneration &&
+						(!actionPublication || current.pendingActionEffectId === id);
+				return (
+					mappingCurrent &&
+					(closing || allowInactive || (await this.#bindingCurrent(record.sessionId!, record.endpointGeneration!)))
+				);
+			},
+		);
+	}
+	async #threadEffect(
+		id: string,
+		record: DiscordConversation,
+		operation: "archive" | "unarchive",
+		locked = false,
+		closing = false,
+		occurrenceId?: string,
+	): Promise<void> {
+		await this.#runEffect(
+			id,
+			operation,
+			record.sessionId,
+			record.endpointGeneration!,
+			{ threadId: record.threadId!, locked, ...(occurrenceId === undefined ? {} : { occurrenceId }) },
+
+			async (ensure, beforeProvider) => {
+				await ensure();
+				beforeProvider();
+				if (operation === "archive")
+					await this.options.provider.archiveThread({
+						threadId: record.threadId!,
+						...(locked ? { locked: true } : {}),
+					});
+				else await this.options.provider.unarchiveThread({ threadId: record.threadId! });
+				return { provider: "discord", threadId: record.threadId, status: operation };
+			},
+			async () => {
+				const current = await this.#byThread(record.guildId, record.parentChannelId, record.threadId!);
+				const intent = closingIntent(record);
+				const mappingCurrent = closing
+					? !!current &&
+						intent?.nonce === closingIntent(current)?.nonce &&
+						current.sessionId === record.sessionId &&
+						current.endpointGeneration === record.endpointGeneration
+					: !!current &&
+						current.state === (operation === "archive" ? "active" : "resuming") &&
+						current.generation === record.generation &&
+						current.endpointGeneration === record.endpointGeneration &&
+						(occurrenceId === undefined ||
+							(operation === "archive"
+								? current.archiveEffectId === id && current.archiveOccurrenceId === occurrenceId
+								: current.resumeEffectId === id && current.resumeOccurrenceId === occurrenceId));
+				return (
+					mappingCurrent &&
+					(closing ||
+						(!!record.sessionId && (await this.#bindingCurrent(record.sessionId, record.endpointGeneration!))))
+				);
+			},
+			!closing,
+		);
+	}
+	async #createThreadEffect(intent: DiscordConversation, name: string): Promise<DiscordThread> {
+		const effectId = `create:${intent.sessionId}:${intent.createNonce}`;
+		const nonce = discordEffectNonce(effectId);
+		const receipt = await this.#runEffect(
+			effectId,
+			"create-thread",
+			intent.sessionId,
+			intent.endpointGeneration!,
+			{ guildId: intent.guildId, parentId: intent.parentChannelId, name, nonce },
+			async ensure => {
+				await ensure();
+				const existing = await this.options.provider.findThreadByNonce({
+					guildId: intent.guildId,
+					parentId: intent.parentChannelId,
+					nonce,
+				});
+				await ensure();
+				const thread =
+					existing ??
+					(await this.options.provider.createThread({
+						guildId: intent.guildId,
+						parentId: intent.parentChannelId,
+						name,
+						nonce,
+					}));
+				return {
+					provider: "discord",
+					threadId: thread.id,
+					channelId: thread.parentId,
+					status: existing ? "reconciled" : "created",
+				};
+			},
+			async () => {
+				const current = await this.#store.read(this.#intentKey(intent.sessionId!));
+				return (
+					current?.state === "creating" &&
+					current.createOwner === intent.createOwner &&
+					current.generation === intent.generation &&
+					(current.createLeaseExpiresAt ?? 0) > this.#now() &&
+					(await this.#bindingCurrent(intent.sessionId!, intent.endpointGeneration!))
+				);
+			},
+		);
+		if (!receipt.threadId) throw new Error("Discord create effect has no thread receipt");
+		return { id: receipt.threadId, guildId: intent.guildId, parentId: intent.parentChannelId, archived: false };
+	}
+	async #recoverCreateThread(
+		effect: ChatEffect,
+		payload: { guildId?: string; parentId?: string; name?: string; nonce?: string },
+	): Promise<void> {
+		if (!effect.sessionId || !payload.nonce) return;
+		const intentKey = this.#intentKey(effect.sessionId);
+		const intent = await this.#store.read(intentKey);
+		const matchesIntent =
+			intent?.state === "creating" &&
+			intent.sessionId === effect.sessionId &&
+			intent.guildId === payload.guildId &&
+			intent.parentChannelId === payload.parentId &&
+			discordEffectNonce(`create:${intent.sessionId}:${intent.createNonce}`) === payload.nonce;
+		if (!matchesIntent || !intent) {
+			if (effect.state !== "terminal") await this.#terminalizeEffect(effect.id, "rejected");
+
+			return;
+		}
+		if (!(await this.#bindingCurrent(effect.sessionId, effect.endpointGeneration))) {
+			await this.#store.delete(intentKey, intent.generation);
+			return;
+		}
+		if (effect.state !== "terminal") {
+			await this.#create(effect.sessionId, effect.endpointGeneration, intent.createNonce!, payload.name);
+			return;
+		}
+		const threadId = effect.receipt?.threadId;
+		if (!threadId) return;
+		// Any durable mapping for this session is already session-level authority.
+		// Do not let a terminal receipt reactivate an older remote thread merely
+		// because its exact thread key is absent. Delete only this generation so a
+		// later notification must mint a fresh nonce and provider effect.
+		if ((await this.#sessionMappings(effect.sessionId)).length > 0) {
+			await this.#store.delete(intentKey, intent.generation);
+			return;
+		}
+		await this.#requireLiveBinding(effect.sessionId, effect.endpointGeneration);
+		const key = discordConversationKey({
+			appId: intent.appId,
+			guildId: intent.guildId,
+			parentChannelId: intent.parentChannelId,
+			threadId,
+		});
+		const committed = await this.#store.transact(
+			key,
+			old =>
+				old ??
+				normalizeDiscordConversation({
+					generation: 1,
+					state: "active",
+					appId: intent.appId,
+					guildId: intent.guildId,
+					parentChannelId: intent.parentChannelId,
+					threadId,
+					sessionId: intent.sessionId,
+					endpointGeneration: intent.endpointGeneration,
+					createNonce: intent.createNonce,
+					effectIncarnationId: intent.createNonce,
+					updatedAt: this.#now(),
+					seenEventIds: [],
+					seenInteractionIds: [],
+				}),
+		);
+		if (committed) await this.#store.delete(intentKey, intent.generation);
+	}
+	async #drainProviderEffects(): Promise<boolean> {
+		let failed = false;
+		for (const effect of await this.#effects.list()) {
+			if (
+				effect.transport !== "discord" ||
+				(effect.state === "terminal" &&
+					effect.kind !== "create-thread" &&
+					effect.kind !== "archive" &&
+					effect.kind !== "unarchive")
+			)
+				continue;
+			if (this.#hasLiveEffectLease(effect)) continue;
+
+			const payload = effect.payload as {
+				guildId?: string;
+				parentId?: string;
+				name?: string;
+				nonce?: string;
+				threadId?: string;
+				content?: string;
+				components?: DiscordMessageComponent[];
+				locked?: boolean;
+				occurrenceId?: string;
+			};
+			const providerEffect =
+				effect.kind === "post-message" || effect.kind === "archive" || effect.kind === "unarchive";
+			if (
+				providerEffect &&
+				(!effect.sessionId ||
+					!payload.threadId ||
+					(effect.kind === "post-message" && payload.content === undefined))
+			) {
+				await this.#terminalizeEffect(effect.id, "stale_noop");
+
+				continue;
+			}
+			try {
+				if (effect.kind === "create-thread" && effect.sessionId && payload.nonce) {
+					await this.#recoverCreateThread(effect, payload);
+				}
+				if (effect.kind === "post-message" && payload.threadId && payload.content !== undefined) {
+					const record = await this.#byThread(
+						this.options.guildId,
+						this.options.parentChannelId,
+						payload.threadId,
+					);
+					const closing = closingIntent(record);
+					const closeMarker = !!closing && effect.id === this.#closeMarkerEffectId(record!);
+					const inactiveFailure = effect.id.startsWith("failure:");
+					if (
+						!record ||
+						(record.state !== "active" && !closeMarker && !inactiveFailure) ||
+						record.endpointGeneration !== effect.endpointGeneration ||
+						(effect.id.startsWith("action-publication:") && record.pendingActionEffectId !== effect.id)
+					) {
+						await this.#terminalizeEffect(effect.id, "stale_noop");
+					} else {
+						await this.#postEffect(
+							effect.id,
+							record,
+							payload.content,
+							payload.components,
+							effect.id.startsWith("action-publication:"),
+							closeMarker,
+							inactiveFailure,
+						);
+					}
+				}
+				if ((effect.kind === "archive" || effect.kind === "unarchive") && payload.threadId) {
+					const record = await this.#byThread(
+						this.options.guildId,
+						this.options.parentChannelId,
+						payload.threadId,
+					);
+					const closing = closingIntent(record);
+					const closeArchive =
+						!!closing &&
+						effect.kind === "archive" &&
+						payload.locked === true &&
+						effect.id === this.#closeArchiveEffectId(record!);
+					const occurrenceId = payload.occurrenceId;
+					const occurrenceMatches =
+						closeArchive ||
+						(!!record &&
+							typeof occurrenceId === "string" &&
+							effect.id === (effect.kind === "archive" ? record.archiveEffectId : record.resumeEffectId) &&
+							(effect.kind === "archive"
+								? record.archiveOccurrenceId === occurrenceId
+								: record.resumeOccurrenceId === occurrenceId));
+					if (
+						!record ||
+						(!closeArchive &&
+							(effect.kind === "archive" ? record.state !== "active" : record.state !== "resuming")) ||
+						record.endpointGeneration !== effect.endpointGeneration ||
+						!occurrenceMatches
+					) {
+						await this.#terminalizeEffect(effect.id, "stale_noop");
+					} else {
+						await this.#threadEffect(effect.id, record, effect.kind, payload.locked, closeArchive, occurrenceId);
+						if (!closeArchive && occurrenceId) {
+							if (effect.kind === "archive") await this.#completeArchive(record, occurrenceId);
+							else await this.#completeResume(record, occurrenceId);
+						}
+					}
+				}
+			} catch {
+				failed = true; /* retained for a later journal-authoritative replay */
+			}
+		}
+		return failed;
+	}
+	async #rescheduleAfterEffectTransition<T extends ChatEffect | undefined>(transition: Promise<T>): Promise<T> {
+		const effect = await transition;
+		if (effect?.state !== "terminal") await this.#scheduleLeaseRecovery();
+		return effect;
+	}
+	async #scheduleLeaseRecovery(recoveryFailed = false): Promise<void> {
+		if (!this.#started) return;
+		const now = this.#now();
+		const recoveryAt = (await this.#effects.list())
+			.filter(effect => effect.transport === "discord")
+			.reduce<number | undefined>(
+				(earliest, effect) => {
+					const claimAt =
+						effect.state === "leased" && Number.isFinite(effect.leaseExpiresAt)
+							? effect.leaseExpiresAt
+							: effect.state === "pending" ||
+									effect.state === "accepted" ||
+									(effect.state === "uncertain" && !effect.kind.includes(".inbound."))
+								? now
+								: undefined;
+					return claimAt === undefined || (earliest !== undefined && earliest <= claimAt) ? earliest : claimAt;
+				},
+				recoveryFailed ? now : undefined,
+			);
+		if (recoveryAt === undefined) {
+			if (this.#leaseRecoveryTimer) clearTimeout(this.#leaseRecoveryTimer);
+			this.#leaseRecoveryTimer = undefined;
+			this.#leaseRecoveryAt = undefined;
+			this.#leaseRecoveryFailures = 0;
+			return;
+		}
+		if (this.#leaseRecoveryAt !== undefined && this.#leaseRecoveryAt <= recoveryAt) return;
+		if (this.#leaseRecoveryTimer) clearTimeout(this.#leaseRecoveryTimer);
+		this.#leaseRecoveryAt = recoveryAt;
+		const delay =
+			recoveryAt <= now
+				? Math.min(1_000, 25 * 2 ** Math.min(this.#leaseRecoveryFailures, 5))
+				: Math.min(recoveryAt - now, 2_147_483_647);
+		this.#leaseRecoveryTimer = setTimeout(() => {
+			this.#leaseRecoveryTimer = undefined;
+			this.#leaseRecoveryAt = undefined;
+			void this.#track(this.#recoverLeasedEffects());
+		}, delay);
+	}
+	async #recoverLeasedEffects(): Promise<void> {
+		if (!this.#started) return;
+		let failed = false;
+		try {
+			try {
+				await this.#reconcileTerminalInboundReceipts();
+				failed ||= await this.#recoverClosingConversations();
+				failed ||= await this.#drainProviderEffects();
+				await this.#reconcileTerminalInboundReceipts();
+				failed ||= await this.#recoverClosingConversations();
+			} catch {
+				failed = true;
+			}
+			try {
+				failed = (await this.#drainPendingDispatches()) || failed;
+			} catch {
+				failed = true;
+			}
+		} finally {
+			if (failed) this.#leaseRecoveryFailures = Math.min(this.#leaseRecoveryFailures + 1, 5);
+			else this.#leaseRecoveryFailures = 0;
+			try {
+				await this.#scheduleLeaseRecovery(failed);
+			} catch {
+				/* retained effects are retried by the next trigger */
+			}
+		}
+	}
+
+	async #fail(threadId: string): Promise<void> {
+		try {
+			const record = await this.#byThread(this.options.guildId, this.options.parentChannelId, threadId);
+			if (record)
+				await this.#postEffect(
+					`failure:${threadId}:${randomUUID()}`,
+					record,
+					FAILURE,
+					undefined,
+					false,
+					false,
+					true,
+				);
+		} catch {}
+	}
+}
+
+function decodeCustomId(value: string): { generation: number; actionId: string; actionNonce: string } | undefined {
+	const match = /^gjc:(\d+):([^:]+):([0-9a-f-]{36})$/.exec(value);
+	if (!match) return undefined;
+	const generation = Number(match[1]);
+	return Number.isSafeInteger(generation) && generation >= 0
+		? { generation, actionId: match[2]!, actionNonce: match[3]! }
+		: undefined;
+}
+
+function stateRank(state: string): number {
+	return state === "closing"
+		? -1
+		: state === "active"
+			? 0
+			: state === "resuming"
+				? 1
+				: state === "archived"
+					? 2
+					: state === "closed"
+						? 3
+						: 4;
+}
+
+function actionComponents(
+	generation: number,
+	actionId: string,
+	actionNonce: string,
+	options: string[],
+): DiscordMessageComponent[] {
+	return [
+		{
+			type: 1,
+			components: [
+				{
+					type: 3,
+					customId: `gjc:${generation}:${actionId}:${actionNonce}`,
+					placeholder: "Choose an option",
+					minValues: 1,
+					maxValues: 1,
+					options: options.slice(0, 25).map((option, index) => ({
+						label: option.slice(0, 100) || `Option ${index + 1}`,
+						value: String(index),
+					})),
+				},
+			],
+		},
+	];
+}
+
+function componentAnswer(value: string | number): string | number {
+	if (typeof value === "string" && /^\d+$/.test(value)) {
+		const index = Number(value);
+		if (Number.isSafeInteger(index)) return index;
+	}
+	return value;
+}
+
+function discordEffectNonce(effectId: string): string {
+	// Discord nonces are bounded; hash the durable effect identifier rather than
+	// truncating its potentially shared prefix.
+	return `gjc-${createHash("sha256").update(effectId).digest("hex").slice(0, 21)}`;
+}