@openclaw/buzz 2026.9.3 → 2026.9.5

package/assets/activity.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M5 5h14v11H9l-4 4ZM9 8v5M12 7v7M15 8v5" />
+</svg>

package/dist/{adapter.runtime-CaDdxQ2C.js → .setup/adapter.runtime-FIC9NMFI.mjs}

@@ -1,6 +1,6 @@
-import { m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, u as buildBuzzTarget } from "./types-CeupBG0P.js";
-import { c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, o as connectAuthenticatedBuzzRelaySession, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-a8IHfdgL.js";
-import { i as buildBuzzMessageTags, s as parseBuzzMessageEvent } from "./message-event-X_aBiM1X.js";
+import { m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, u as buildBuzzTarget } from "./types-CeupBG0P.mjs";
+import { c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, o as connectAuthenticatedBuzzRelaySession, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-tqLQznFE.mjs";
+import { i as buildBuzzMessageTags, s as parseBuzzMessageEvent } from "./message-event-X_aBiM1X.mjs";
 import { z } from "zod";
 import { finalizeEvent } from "nostr-tools";
 import { isLoopbackHost } from "openclaw/plugin-sdk/ssrf-runtime";

package/dist/{channel-C6rro-f7.js → .setup/channel-BVHkrP3Z.mjs}

@@ -1,9 +1,9 @@
-import { a as resolveBuzzAccountConfig, c as BuzzConfigSchema, d as isConfiguredBuzzChannel, f as looksLikeBuzzTarget, i as resolveBuzzAccount, m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, p as normalizeBuzzTarget, r as listBuzzAccountIds, s as resolveDefaultBuzzAccountId, t as assertBuzzAccountAvailable, u as buildBuzzTarget } from "./types-CeupBG0P.js";
-import { n as listBuzzDirectoryPeersFromConfig, t as listBuzzDirectoryGroupsFromConfig } from "./directory-config-B0shiBa4.js";
-import { a as connectAuthenticatedBuzzRelay, c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, l as queryBuzzRelaySnapshot, n as BUZZ_ROOM_SYSTEM_KIND, o as connectAuthenticatedBuzzRelaySession, r as parseBuzzRoomMembershipChangeEvent, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-a8IHfdgL.js";
-import { a as formatBuzzMessageForAgent, c as inspectBuzzMentionSyntax, i as buildBuzzMessageTags, l as resolveBuzzMessageMentions, n as BUZZ_INBOUND_MESSAGE_KINDS, o as isBuzzInboundMessageKind, r as BUZZ_TYPING_INDICATOR_KIND, s as parseBuzzMessageEvent, t as BUZZ_DIFF_MESSAGE_KIND } from "./message-event-X_aBiM1X.js";
-import { i as startBuzzRoomMembershipNotifications, n as buzzSetupContract, r as discoverBuzzRooms, t as buzzSetupWizard } from "./setup-surface-DDUmAluL.js";
-import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DNuqbK64.js";
+import { a as resolveBuzzAccountConfig, c as BuzzConfigSchema, d as isConfiguredBuzzChannel, f as looksLikeBuzzTarget, i as resolveBuzzAccount, m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, p as normalizeBuzzTarget, r as listBuzzAccountIds, s as resolveDefaultBuzzAccountId, t as assertBuzzAccountAvailable, u as buildBuzzTarget } from "./types-CeupBG0P.mjs";
+import { n as listBuzzDirectoryPeersFromConfig, r as applyBuzzDirectoryQueryAndLimit, t as listBuzzDirectoryGroupsFromConfig } from "./directory-config-CzHz6fzo.mjs";
+import { a as connectAuthenticatedBuzzRelay, c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, l as queryBuzzRelaySnapshot, n as BUZZ_ROOM_SYSTEM_KIND, o as connectAuthenticatedBuzzRelaySession, r as parseBuzzRoomMembershipChangeEvent, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-tqLQznFE.mjs";
+import { a as formatBuzzMessageForAgent, c as inspectBuzzMentionSyntax, i as buildBuzzMessageTags, l as resolveBuzzMessageMentions, n as BUZZ_INBOUND_MESSAGE_KINDS, o as isBuzzInboundMessageKind, r as BUZZ_TYPING_INDICATOR_KIND, s as parseBuzzMessageEvent, t as BUZZ_DIFF_MESSAGE_KIND } from "./message-event-X_aBiM1X.mjs";
+import { i as startBuzzRoomMembershipNotifications, n as buzzSetupContract, r as discoverBuzzRooms, t as buzzSetupWizard } from "./setup-surface-DOHxdPor.mjs";
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-DjibkTDL.mjs";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { createChannelMessageAdapterFromOutbound, waitUntilAbort } from "openclaw/plugin-sdk/channel-outbound";
@@ -43,25 +43,6 @@ function readPreferredString(params) {
 function fallbackPublicKeyLabel(publicKey) {
 	return `${publicKey.slice(0, 8)}...${publicKey.slice(-6)}`;
 }
-function matchesDirectoryQuery(entry, query) {
-	if (!query) return true;
-	return [
-		entry.id,
-		entry.name,
-		entry.handle
-	].some((value) => value?.toLowerCase().includes(query));
-}
-function applyQueryAndLimit(entries, params) {
-	const query = params.query?.trim().toLowerCase() ?? "";
-	const limit = typeof params.limit === "number" && params.limit > 0 ? Math.floor(params.limit) : void 0;
-	const result = [];
-	for (const entry of entries) {
-		if (!matchesDirectoryQuery(entry, query)) continue;
-		result.push(entry);
-		if (limit !== void 0 && result.length >= limit) break;
-	}
-	return result;
-}
 function parseBuzzDirectoryProfileEvent(event) {
 	const publicKey = event.pubkey.trim().toLowerCase();
 	if (event.kind !== 0 || !HEX_PUBLIC_KEY_PATTERN.test(publicKey)) return;
@@ -189,10 +170,12 @@ var BuzzDirectoryState = class {
 			if (!membership) continue;
 			for (const publicKey of membership.members) if (publicKey !== this.#publicKey) peers.add(publicKey);
 		}
-		return applyQueryAndLimit([...peers].map((publicKey) => this.#buildUserEntry(publicKey)).toSorted(compareDirectoryEntries), params);
+		const entries = [...peers].map((publicKey) => this.#buildUserEntry(publicKey)).toSorted(compareDirectoryEntries);
+		return applyBuzzDirectoryQueryAndLimit(entries, params);
 	}
 	listGroups(params) {
-		return applyQueryAndLimit(this.activeRoomIds().map((roomId) => this.#buildRoomEntry(roomId)).toSorted(compareDirectoryEntries), params);
+		const entries = this.activeRoomIds().map((roomId) => this.#buildRoomEntry(roomId)).toSorted(compareDirectoryEntries);
+		return applyBuzzDirectoryQueryAndLimit(entries, params);
 	}
 	listGroupMembers(params) {
 		let roomId;
@@ -204,7 +187,7 @@ var BuzzDirectoryState = class {
 		if (this.#rooms.get(roomId)?.archived) return [];
 		const membership = this.#memberships.get(roomId);
 		if (!membership) return [];
-		return applyQueryAndLimit([...membership.members].map((publicKey) => {
+		const entries = [...membership.members].map((publicKey) => {
 			const entry = this.#buildUserEntry(publicKey);
 			entry.raw = {
 				publicKey,
@@ -212,7 +195,8 @@ var BuzzDirectoryState = class {
 				roomId
 			};
 			return entry;
-		}).toSorted(compareDirectoryEntries), { limit: params.limit });
+		}).toSorted(compareDirectoryEntries);
+		return applyBuzzDirectoryQueryAndLimit(entries, { limit: params.limit });
 	}
 	mentionMembers(roomId) {
 		const normalized = parseBuzzTarget(roomId);
@@ -808,6 +792,7 @@ async function catchUpBuzzRoomHistory(params) {
 		if (!reservation) return "aborted";
 		let page;
 		try {
+			if (params.signal?.aborted) return "aborted";
 			page = await queryBuzzRoomHistoryPage({
 				relay: params.relay,
 				channelId: params.channelId,
@@ -859,7 +844,6 @@ async function catchUpBuzzRoomHistory(params) {
 //#endregion
 //#region extensions/buzz/src/room-membership-tracker.ts
 const MEMBERSHIP_READY_TIMEOUT_MS = 1e4;
-const MEMBERSHIP_TRACKER_SETUP_CLOSE_REASON = "membership tracker setup failed";
 const BUZZ_ROOM_METADATA_EDIT_KIND = 9002;
 const MEMBERSHIP_REFRESH_DELAYS_MS = [
 	100,
@@ -894,8 +878,10 @@ async function createBuzzRoomMembershipTracker(params) {
 	const deniedMembers = /* @__PURE__ */ new Map();
 	const pendingMemberships = /* @__PURE__ */ new Map();
 	const refreshes = /* @__PURE__ */ new Map();
+	const restoringRooms = /* @__PURE__ */ new Map();
 	let membershipQueryTail = Promise.resolve();
 	const memberships = await queryBuzzRoomMemberships(params);
+	params.signal?.throwIfAborted();
 	const effectiveMemberships = () => {
 		if (blockedRooms.size === 0 && deniedMembers.size === 0) return memberships;
 		const effective = /* @__PURE__ */ new Map();
@@ -938,12 +924,15 @@ async function createBuzzRoomMembershipTracker(params) {
 		params.onMembershipsChanged?.(effectiveMemberships());
 	};
 	const queryMembership = (channelId) => {
-		const query = membershipQueryTail.then(async () => (await queryBuzzRoomMemberships({
-			relay: params.relay,
-			relayPublicKey: params.relayPublicKey,
-			channelIds: [channelId],
-			signal: params.signal
-		})).get(channelId));
+		const query = membershipQueryTail.then(async () => {
+			params.signal?.throwIfAborted();
+			return (await queryBuzzRoomMemberships({
+				relay: params.relay,
+				relayPublicKey: params.relayPublicKey,
+				channelIds: [channelId],
+				signal: params.signal
+			})).get(channelId);
+		});
 		membershipQueryTail = query.then(() => void 0, () => void 0);
 		return query;
 	};
@@ -956,6 +945,7 @@ async function createBuzzRoomMembershipTracker(params) {
 			let refreshed;
 			try {
 				refreshed = await queryMembership(channelId);
+				params.signal?.throwIfAborted();
 			} catch (error) {
 				if (params.signal?.aborted) throw error;
 				continue;
@@ -1005,6 +995,9 @@ async function createBuzzRoomMembershipTracker(params) {
 		if (!membership) return;
 		const change = parseBuzzRoomMembershipChangeEvent(event, membership);
 		if (!change) return;
+		const restoring = restoringRooms.get(channelId);
+		if (restoring?.historical) return;
+		if (restoring) restoring.generation += 1;
 		const expected = change.type === "member_joined" ? "present" : "absent";
 		const pending = pendingMemberships.get(channelId) ?? /* @__PURE__ */ new Map();
 		pending.set(change.targetPublicKey, expected);
@@ -1019,6 +1012,13 @@ async function createBuzzRoomMembershipTracker(params) {
 		return refreshMembershipOnce(channelId);
 	};
 	const handleRoomEvent = (event, reservation) => {
+		if (params.signal?.aborted) return;
+		const channelId = event.tags.find((tag) => tag[0] === "h")?.[1];
+		const restoring = channelId ? restoringRooms.get(channelId) : void 0;
+		if (restoring && isBuzzInboundMessageKind(event.kind)) {
+			restoring.until = Math.max(restoring.until ?? event.created_at, event.created_at);
+			return;
+		}
 		if (event.kind === 39002) {
 			const membership = parseBuzzRoomMembershipEvent(event, params.relayPublicKey);
 			if (membership && memberships.has(membership.roomId) && isNewerBuzzRevision(membership, memberships.get(membership.roomId))) try {
@@ -1034,20 +1034,31 @@ async function createBuzzRoomMembershipTracker(params) {
 		}
 		handleSystemEvent(event)?.catch(reportSystemEventError);
 	};
-	for (const channelId of params.channelIds) if (memberships.get(channelId)?.roles.get(params.botPublicKey) !== "bot") throw new Error(`Buzz bot does not have the Bot role in configured room ${channelId}`);
-	let resolveHistorical;
-	let rejectHistorical;
-	const historicalReady = new Promise((resolve, reject) => {
-		resolveHistorical = resolve;
-		rejectHistorical = reject;
-	});
-	const historicalTimeout = setTimeout(() => {
-		rejectHistorical?.(/* @__PURE__ */ new Error("Timed out loading Buzz room membership changes"));
-		params.relay.close();
-	}, MEMBERSHIP_READY_TIMEOUT_MS);
-	const subscriptions = [];
-	try {
-		for (const channelId of params.channelIds) {
+	const skippedRooms = /* @__PURE__ */ new Set();
+	const initialRoomIds = [];
+	for (const channelId of params.channelIds) if (memberships.get(channelId)?.roles.get(params.botPublicKey) !== "bot") {
+		skippedRooms.add(channelId);
+		params.onRoomUnavailable?.(/* @__PURE__ */ new Error(`Buzz bot does not have the Bot role in configured room ${channelId}`));
+	} else initialRoomIds.push(channelId);
+	if (params.channelIds.length > 0 && initialRoomIds.length === 0) throw new Error(`Buzz bot does not have the Bot role in any configured room: ${params.channelIds.join(", ")}`);
+	const subscribeRoom = (channelId) => {
+		params.signal?.throwIfAborted();
+		return new Promise((resolve, reject) => {
+			let settled = false;
+			const finish = (error) => {
+				if (settled) return;
+				settled = true;
+				clearTimeout(timeout);
+				params.signal?.removeEventListener("abort", onAbort);
+				if (error === void 0) resolve();
+				else reject(error instanceof Error ? error : new Error("Buzz room membership loading failed", { cause: error }));
+			};
+			const onAbort = () => finish(params.signal?.reason ?? /* @__PURE__ */ new Error("Buzz membership loading aborted"));
+			const timeout = setTimeout(() => {
+				finish(/* @__PURE__ */ new Error(`Timed out loading Buzz room membership changes for ${channelId}`));
+				params.relay.close();
+			}, MEMBERSHIP_READY_TIMEOUT_MS);
+			params.signal?.addEventListener("abort", onAbort, { once: true });
 			const filters = [
 				{
 					kinds: [BUZZ_ROOM_SYSTEM_KIND, BUZZ_ROOM_METADATA_EDIT_KIND],
@@ -1067,63 +1078,141 @@ async function createBuzzRoomMembershipTracker(params) {
 					limit: params.messageLimit
 				}
 			];
-			subscriptions.push(openBuzzRelaySubscription(params.relay, filters, {
-				onevent: (event) => {
-					if (!historicalRooms.has(channelId) && isBuzzInboundMessageKind(event.kind)) {
-						const page = historyPages.get(channelId);
-						if (page) {
-							page.count += 1;
-							page.oldest = Math.min(page.oldest, event.created_at);
-						} else historyPages.set(channelId, {
-							count: 1,
-							oldest: event.created_at
-						});
+			try {
+				openBuzzRelaySubscription(params.relay, filters, {
+					onevent: (event) => {
+						if (params.signal?.aborted) return;
+						if (!historicalRooms.has(channelId) && isBuzzInboundMessageKind(event.kind)) {
+							const page = historyPages.get(channelId);
+							if (page) {
+								page.count += 1;
+								page.oldest = Math.min(page.oldest, event.created_at);
+							} else historyPages.set(channelId, {
+								count: 1,
+								oldest: event.created_at
+							});
+						}
+						handleRoomEvent(event);
+					},
+					oneose: () => {
+						historicalRooms.add(channelId);
+						const restoring = restoringRooms.get(channelId);
+						if (restoring) restoring.historical = false;
+						finish();
+					},
+					onclose: (reason) => {
+						const error = /* @__PURE__ */ new Error(`Buzz membership subscription closed for ${channelId}: ${reason}`);
+						if (!historicalRooms.has(channelId)) finish(error);
+						else if (reason !== "shutdown" && reason !== "relay connection closed by us" && !params.signal?.aborted) reportSystemEventError(error);
 					}
-					handleRoomEvent(event);
-				},
-				oneose: () => {
-					historicalRooms.add(channelId);
-					if (historicalRooms.size === params.channelIds.length) resolveHistorical?.();
-				},
-				onclose: (reason) => {
-					if (!historicalRooms.has(channelId)) rejectHistorical?.(/* @__PURE__ */ new Error(`Buzz membership subscription closed for ${channelId}: ${reason}`));
-					else if (reason !== "shutdown" && reason !== "relay connection closed by us" && reason !== MEMBERSHIP_TRACKER_SETUP_CLOSE_REASON && !params.signal?.aborted) params.onFatalError?.(/* @__PURE__ */ new Error(`Buzz membership subscription closed for ${channelId}: ${reason}`));
-				}
-			}, filters.map((filter) => Object.assign({}, filter, { "#h": [channelId] }))));
-		}
-		await historicalReady;
+				}, filters.map((filter) => Object.assign({}, filter, { "#h": [channelId] })));
+			} catch (error) {
+				finish(error);
+			}
+		});
+	};
+	const initialSubscriptions = [];
+	try {
+		for (const channelId of initialRoomIds) initialSubscriptions.push(subscribeRoom(channelId));
+		await Promise.all(initialSubscriptions);
 	} catch (error) {
-		if (params.relay.connected) {
-			for (const subscription of subscriptions) if (!subscription.closed) subscription.close(MEMBERSHIP_TRACKER_SETUP_CLOSE_REASON);
-		}
+		params.relay.close();
+		await Promise.allSettled(initialSubscriptions);
 		throw error;
-	} finally {
-		clearTimeout(historicalTimeout);
 	}
-	return {
-		memberships: effectiveMemberships,
-		catchUpHistory: async () => {
-			for (const channelId of params.channelIds) {
+	let historyTail = Promise.resolve();
+	const catchUpHistory = (channelIds, recoveryUntil) => {
+		const task = historyTail.then(async () => {
+			for (const channelId of channelIds) {
 				const page = historyPages.get(channelId);
+				const until = recoveryUntil ?? page?.oldest;
 				if (params.signal?.aborted) return;
-				if (!page || page.count < params.messageLimit) continue;
-				try {
-					if (await catchUpBuzzRoomHistory({
-						relay: params.relay,
-						channelId,
-						since: params.messageSince(channelId),
-						until: page.oldest,
-						limit: params.messageLimit,
-						reserveCapacity: params.reserveDispatchCapacity,
-						onEvent: handleRoomEvent,
-						signal: params.signal
-					}) === "timestamp-over-limit") params.onHistoryError?.(/* @__PURE__ */ new Error(`Buzz room ${channelId} kept more than ${BUZZ_REPLAY_DISPATCH_MAX_PENDING} additional messages at one timestamp; older history was not recovered`));
-				} catch (error) {
-					if (params.signal?.aborted) return;
-					reportSystemEventError(error instanceof Error ? error : new Error(`Buzz room history recovery failed for ${channelId}`, { cause: error }));
-					return;
-				}
+				if (until === void 0 || recoveryUntil === void 0 && page && page.count < params.messageLimit) continue;
+				if (await catchUpBuzzRoomHistory({
+					relay: params.relay,
+					channelId,
+					since: params.messageSince(channelId),
+					until,
+					limit: params.messageLimit,
+					reserveCapacity: params.reserveDispatchCapacity,
+					onEvent: handleRoomEvent,
+					signal: params.signal
+				}) === "timestamp-over-limit") params.onHistoryError?.(/* @__PURE__ */ new Error(`Buzz room ${channelId} kept more than ${BUZZ_REPLAY_DISPATCH_MAX_PENDING} additional messages at one timestamp; older history was not recovered`));
 			}
+		}).catch(reportSystemEventError);
+		historyTail = task;
+		return task;
+	};
+	const restorations = /* @__PURE__ */ new Map();
+	const restoreRoom = async (channelId, state) => {
+		while (!params.signal?.aborted) {
+			const generation = state.generation;
+			let refreshed = await queryMembership(channelId);
+			params.signal?.throwIfAborted();
+			if (generation !== state.generation) continue;
+			const current = memberships.get(channelId);
+			if (current && (!refreshed || isNewerBuzzRevision(current, refreshed))) refreshed = current;
+			if (!refreshed) return;
+			if (refreshed.roles.get(params.botPublicKey) !== "bot") {
+				memberships.set(channelId, refreshed);
+				params.onMembershipsChanged?.(effectiveMemberships());
+				return;
+			}
+			replaceMembership(refreshed);
+			params.signal?.throwIfAborted();
+			skippedRooms.delete(channelId);
+			const restoring = {
+				historical: true,
+				generation: 0
+			};
+			restoringRooms.set(channelId, restoring);
+			await subscribeRoom(channelId);
+			while (!params.signal?.aborted) {
+				const refresh = refreshes.get(channelId);
+				if (refresh) await refresh.promise;
+				params.signal?.throwIfAborted();
+				const reconciliationGeneration = restoring.generation;
+				let confirmed = await queryMembership(channelId);
+				params.signal?.throwIfAborted();
+				if (reconciliationGeneration !== restoring.generation || refreshes.has(channelId)) continue;
+				const latest = memberships.get(channelId);
+				if (latest && confirmed && isNewerBuzzRevision(latest, confirmed)) confirmed = latest;
+				if (!confirmed) throw new Error(`Buzz room membership missing after restoration for ${channelId}`);
+				replaceMembership(confirmed);
+				params.signal?.throwIfAborted();
+				restoringRooms.delete(channelId);
+				await catchUpHistory([channelId], restoring.until);
+				return;
+			}
+			return;
+		}
+	};
+	return {
+		memberships: effectiveMemberships,
+		catchUpHistory: () => catchUpHistory(initialRoomIds),
+		handleNotification: (notification) => {
+			if (params.signal?.aborted || seenEventIds.has(notification.eventId)) return true;
+			if (!skippedRooms.has(notification.roomId)) return false;
+			markSystemEventSeen(notification.eventId);
+			const existing = restorations.get(notification.roomId);
+			if (existing) {
+				existing.generation += 1;
+				return true;
+			}
+			const state = {
+				generation: 1,
+				promise: Promise.resolve()
+			};
+			restorations.set(notification.roomId, state);
+			state.promise = restoreRoom(notification.roomId, state).catch(reportSystemEventError).finally(() => restorations.delete(notification.roomId));
+			return true;
+		},
+		close: async () => {
+			await Promise.allSettled([
+				...[...restorations.values()].map((state) => state.promise),
+				...[...refreshes.values()].map((state) => state.promise),
+				historyTail
+			]);
 		}
 	};
 }
@@ -1307,6 +1396,7 @@ async function startBuzzBus(options) {
 	let directoryRelay;
 	let stopPresenceHeartbeat = () => {};
 	let profileTask;
+	let membershipTracker;
 	const bus = {
 		publicKey,
 		directory,
@@ -1347,6 +1437,7 @@ async function startBuzzBus(options) {
 			directoryRelay?.close();
 			replayGuard.clearMemory();
 			relay.close();
+			await membershipTracker?.close();
 			await profileTask;
 		}
 	};
@@ -1376,9 +1467,10 @@ async function startBuzzBus(options) {
 			configuredRoomIds: options.channelIds,
 			since: sessionStartedAt,
 			signal,
+			onNotification: (notification) => membershipTracker?.handleNotification(notification) ?? false,
 			onFatalError: reportFatalError
 		});
-		const membershipTracker = activeChannelIds.length > 0 ? await createBuzzRoomMembershipTracker({
+		membershipTracker = activeChannelIds.length > 0 ? await createBuzzRoomMembershipTracker({
 			relay,
 			relayPublicKey,
 			channelIds: activeChannelIds,
@@ -1388,6 +1480,7 @@ async function startBuzzBus(options) {
 			messageLimit: resolveBuzzRoomHistoryLimit(activeChannelIds.length),
 			reserveDispatchCapacity: (slots) => dispatchQueue.reserveCapacity(slots),
 			onHistoryError: options.onHistoryError,
+			onRoomUnavailable: options.onRoomUnavailable,
 			onMessageEvent: (event, isMember, reservation) => {
 				if (signal.aborted || event.pubkey === publicKey) return;
 				const message = parseBuzzMessageEvent(event);
@@ -1738,14 +1831,16 @@ function openBuzzRecoveryWatermarkStore(params) {
 async function resolveBuzzRecoverySince(params) {
 	const { store, channelIds, nowSeconds, lookbackSeconds } = params;
 	const configuredKeys = new Set(channelIds.map(roomCursorKey));
-	for (const { key } of await store.entries()) if (key.startsWith("room:") && !configuredKeys.has(key)) await store.delete(key);
+	const activations = new Map((await store.entries()).map(({ key, value }) => [key, value]));
+	for (const key of activations.keys()) if (key.startsWith("room:") && !configuredKeys.has(key)) await store.delete(key);
 	const sinceByRoom = /* @__PURE__ */ new Map();
 	const retentionFloor = nowSeconds - lookbackSeconds;
 	for (const channelId of channelIds) {
 		const key = roomCursorKey(channelId);
-		const activation = await store.lookup(key);
+		const activation = activations.get(key);
 		if (activation === void 0) {
 			await store.register(key, { seconds: nowSeconds });
+			activations.set(key, { seconds: nowSeconds });
 			sinceByRoom.set(channelId, nowSeconds);
 			continue;
 		}
@@ -1858,6 +1953,9 @@ async function startBuzzGatewayAccount(ctx) {
 				onHistoryError: (error) => {
 					ctx.log?.warn?.(`[${account.accountId}] Buzz history recovery incomplete: ${error.message}`);
 				},
+				onRoomUnavailable: (error) => {
+					ctx.log?.warn?.(`[${account.accountId}] Buzz room skipped: ${error.message}`);
+				},
 				onPresenceError: (error) => {
 					ctx.log?.warn?.(`[${account.accountId}] Buzz presence heartbeat failed: ${error.message}`);
 				},

package/dist/.setup/directory-config-CzHz6fzo.mjs

@@ -0,0 +1,43 @@
+import { i as resolveBuzzAccount, m as parseBuzzTarget, u as buildBuzzTarget } from "./types-CeupBG0P.mjs";
+//#region extensions/buzz/src/directory-query.ts
+function matchesDirectoryQuery(entry, query) {
+	if (!query) return true;
+	return [
+		entry.id,
+		entry.name,
+		entry.handle
+	].some((value) => value?.toLowerCase().includes(query));
+}
+function applyBuzzDirectoryQueryAndLimit(entries, params) {
+	const query = params.query?.trim().toLowerCase() ?? "";
+	const limit = typeof params.limit === "number" && params.limit > 0 ? Math.floor(params.limit) : void 0;
+	const result = [];
+	for (const entry of entries) {
+		if (!matchesDirectoryQuery(entry, query)) continue;
+		result.push(entry);
+		if (limit !== void 0 && result.length >= limit) break;
+	}
+	return result;
+}
+//#endregion
+//#region extensions/buzz/src/directory-config.ts
+async function listBuzzDirectoryPeersFromConfig(_params) {
+	return [];
+}
+async function listBuzzDirectoryGroupsFromConfig(params) {
+	const account = resolveBuzzAccount({
+		cfg: params.cfg,
+		accountId: params.accountId
+	});
+	return applyBuzzDirectoryQueryAndLimit(Object.entries(account.config.groups ?? {}).filter(([, config]) => config.enabled !== false).map(([roomId]) => {
+		const id = parseBuzzTarget(roomId);
+		return {
+			kind: "group",
+			id: buildBuzzTarget(id),
+			name: id,
+			raw: { roomId: id }
+		};
+	}).toSorted((a, b) => a.id.localeCompare(b.id)), params);
+}
+//#endregion
+export { listBuzzDirectoryPeersFromConfig as n, applyBuzzDirectoryQueryAndLimit as r, listBuzzDirectoryGroupsFromConfig as t };

package/dist/{room-membership-a8IHfdgL.js → .setup/room-membership-tqLQznFE.mjs}

@@ -1,4 +1,4 @@
-import { l as BUZZ_CHANNEL_ID_PATTERN } from "./types-CeupBG0P.js";
+import { l as BUZZ_CHANNEL_ID_PATTERN } from "./types-CeupBG0P.mjs";
 import { Relay, finalizeEvent } from "nostr-tools";
 import { readProviderJsonObjectResponse } from "openclaw/plugin-sdk/provider-http";
 import { fetchWithSsrFGuard, ssrfPolicyFromHttpBaseUrlAllowedOrigin } from "openclaw/plugin-sdk/ssrf-runtime";

package/dist/{secret-contract-DNuqbK64.js → .setup/secret-contract-DjibkTDL.mjs}

@@ -1,4 +1,4 @@
-import { a as resolveBuzzAccountConfig } from "./types-CeupBG0P.js";
+import { a as resolveBuzzAccountConfig } from "./types-CeupBG0P.mjs";
 import { collectSecretInputAssignment, createChannelSecretTargetRegistryEntries, getChannelRecord, isRecord } from "openclaw/plugin-sdk/channel-secret-basic-runtime";
 //#region extensions/buzz/src/secret-contract.ts
 const fields = ["privateKey", "authTag"];

package/dist/.setup/secret-contract-api-DcFDI-eR.mjs

@@ -0,0 +1,3 @@
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries, t as channelSecrets } from "./secret-contract-DjibkTDL.mjs";
+import "../secret-contract-api.js";
+export { channelSecrets, collectRuntimeConfigAssignments, secretTargetRegistryEntries };

package/dist/.setup/setup-plugin-api-DI8WfvKQ.mjs

@@ -0,0 +1,47 @@
+import { c as BuzzConfigSchema, i as resolveBuzzAccount, r as listBuzzAccountIds, s as resolveDefaultBuzzAccountId } from "./types-CeupBG0P.mjs";
+import { n as buzzSetupContract, t as buzzSetupWizard } from "./setup-surface-DOHxdPor.mjs";
+import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
+//#region extensions/buzz/src/channel.setup.ts
+const buzzSetupPlugin = {
+	id: "buzz",
+	meta: {
+		id: "buzz",
+		label: "Buzz",
+		selectionLabel: "Buzz",
+		docsPath: "/channels/buzz",
+		docsLabel: "buzz",
+		blurb: "Connect OpenClaw agents to Buzz team rooms.",
+		markdownCapable: true,
+		order: 56
+	},
+	capabilities: {
+		chatTypes: ["group"],
+		threads: true
+	},
+	reload: {
+		configPrefixes: ["channels.buzz"],
+		accountScopedRestart: true
+	},
+	configSchema: BuzzConfigSchema,
+	setupContract: buzzSetupContract,
+	setupWizard: buzzSetupWizard,
+	config: {
+		listAccountIds: listBuzzAccountIds,
+		resolveAccount: (cfg, accountId) => resolveBuzzAccount({
+			cfg,
+			accountId
+		}),
+		defaultAccountId: resolveDefaultBuzzAccountId,
+		isConfigured: (account) => account.configured,
+		describeAccount: (account) => describeAccountSnapshot({
+			account,
+			configured: account.configured,
+			extra: {
+				baseUrl: account.relayUrl,
+				publicKey: account.publicKey
+			}
+		})
+	}
+};
+//#endregion
+export { buzzSetupPlugin as t };

package/dist/.setup/setup-plugin-api-H-XWBzaF.mjs

@@ -0,0 +1,2 @@
+import { t as buzzSetupPlugin } from "./setup-plugin-api-DI8WfvKQ.mjs";
+export { buzzSetupPlugin };

package/dist/{setup-surface-DDUmAluL.js → .setup/setup-surface-DOHxdPor.mjs}

@@ -1,5 +1,5 @@
-import { a as resolveBuzzAccountConfig, i as resolveBuzzAccount, l as BUZZ_CHANNEL_ID_PATTERN, m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, r as listBuzzAccountIds } from "./types-CeupBG0P.js";
-import { c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, l as queryBuzzRelaySnapshot, o as connectAuthenticatedBuzzRelaySession, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-a8IHfdgL.js";
+import { a as resolveBuzzAccountConfig, i as resolveBuzzAccount, l as BUZZ_CHANNEL_ID_PATTERN, m as parseBuzzTarget, n as decodeBuzzPrivateKey, o as resolveBuzzPublicKey, r as listBuzzAccountIds } from "./types-CeupBG0P.mjs";
+import { c as openBuzzRelaySubscription, i as parseBuzzRoomMembershipEvent, l as queryBuzzRelaySnapshot, o as connectAuthenticatedBuzzRelaySession, s as parseBuzzAuthTag, t as BUZZ_ROOM_MEMBERSHIP_KIND, u as isNewerBuzzRevision } from "./room-membership-tqLQznFE.mjs";
 import { generateSecretKey, nip19 } from "nostr-tools";
 import { sleep } from "openclaw/plugin-sdk/runtime-env";
 import { defineChannelSetupContract } from "openclaw/plugin-sdk/channel-setup";
@@ -34,7 +34,7 @@ function startBuzzRoomMembershipNotifications(params) {
 				relayPublicKey: params.relayPublicKey,
 				botPublicKey: params.botPublicKey
 			});
-			if (notification && configuredRoomIds.has(notification.roomId)) params.onFatalError(/* @__PURE__ */ new Error(`Buzz room ${notification.roomId} membership changed; rebuilding subscriptions`));
+			if (notification && configuredRoomIds.has(notification.roomId) && !params.onNotification?.(notification)) params.onFatalError(/* @__PURE__ */ new Error(`Buzz room ${notification.roomId} membership changed; rebuilding subscriptions`));
 		},
 		onclose: (reason) => {
 			if (reason !== MEMBERSHIP_NOTIFICATION_CLOSE_REASON && reason !== "relay connection closed by us" && reason !== "shutdown" && !params.signal?.aborted) params.onFatalError(/* @__PURE__ */ new Error(`Buzz membership notification subscription closed: ${reason}`));

package/dist/api.js

@@ -1,3 +1,3 @@
-import { i as resolveBuzzAccount, r as listBuzzAccountIds, s as resolveDefaultBuzzAccountId } from "./types-CeupBG0P.js";
-import { n as getBuzzRuntime, r as setBuzzRuntime, t as buzzPlugin } from "./channel-C6rro-f7.js";
+import { i as resolveBuzzAccount, r as listBuzzAccountIds, s as resolveDefaultBuzzAccountId } from "./.setup/types-CeupBG0P.mjs";
+import { n as getBuzzRuntime, r as setBuzzRuntime, t as buzzPlugin } from "./.setup/channel-BVHkrP3Z.mjs";
 export { buzzPlugin, getBuzzRuntime, listBuzzAccountIds, resolveBuzzAccount, resolveDefaultBuzzAccountId, setBuzzRuntime };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as buzzPlugin } from "./channel-C6rro-f7.js";
+import { t as buzzPlugin } from "./.setup/channel-BVHkrP3Z.mjs";
 export { buzzPlugin };

package/dist/directory-contract-api.js

@@ -1,4 +1,4 @@
-import { n as listBuzzDirectoryPeersFromConfig, t as listBuzzDirectoryGroupsFromConfig } from "./directory-config-B0shiBa4.js";
+import { n as listBuzzDirectoryPeersFromConfig, t as listBuzzDirectoryGroupsFromConfig } from "./.setup/directory-config-CzHz6fzo.mjs";
 //#region extensions/buzz/directory-contract-api.ts
 const buzzDirectoryContractPlugin = {
 	id: "buzz",

package/dist/qa-runner-api.js

@@ -1,7 +1,7 @@
 import { createLazyCliRuntimeLoader, createLiveTransportQaCliRegistration, runLiveTransportQaSuiteCommand } from "openclaw/plugin-sdk/qa-runner-runtime";
 //#region extensions/buzz/src/qa/cli.ts
 const DEFAULT_BUZZ_QA_SCENARIOS = ["channel-canary", "channel-mention-gating"];
-const loadBuzzQaAdapterRuntime = createLazyCliRuntimeLoader(() => import("./adapter.runtime-CaDdxQ2C.js"));
+const loadBuzzQaAdapterRuntime = createLazyCliRuntimeLoader(() => import("./.setup/adapter.runtime-FIC9NMFI.mjs"));
 async function runQaBuzz(options) {
 	await runLiveTransportQaSuiteCommand({
 		channelId: "buzz",

package/dist/secret-contract-api.js

@@ -1,2 +1,2 @@
-import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries, t as channelSecrets } from "./secret-contract-DNuqbK64.js";
+import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries, t as channelSecrets } from "./.setup/secret-contract-DjibkTDL.mjs";
 export { channelSecrets, collectRuntimeConfigAssignments, secretTargetRegistryEntries };