@openclaw/clickclack 2026.7.2-beta.5 → 2026.7.2-beta.7

package/dist/{channel-DfcFlLjC.js → channel-CECIpaS0.js}

@@ -1,4 +1,4 @@
-import { _ as clickClackMeta, b as listEnabledClickClackAccounts, c as resolveChannelId, d as createClickClackClient, g as clickClackConfigAdapter, h as CLICKCLACK_CHANNEL_ID, l as resolveWorkspaceId, m as clickClackConfigSchema, n as clickClackSetupAdapter, p as normalizeClickClackCorrelationId, r as clickClackSetupContract, t as clickClackSetupWizard, v as DEFAULT_ACCOUNT_ID, x as resolveClickClackAccount } from "./setup-surface-CD6MUC1g.js";
+import { _ as clickClackMeta, b as listEnabledClickClackAccounts, c as resolveChannelId, d as createClickClackClient, g as clickClackConfigAdapter, h as CLICKCLACK_CHANNEL_ID, l as resolveWorkspaceId, m as clickClackConfigSchema, n as clickClackSetupAdapter, p as normalizeClickClackCorrelationId, r as clickClackSetupContract, t as clickClackSetupWizard, v as DEFAULT_ACCOUNT_ID, x as resolveClickClackAccount } from "./setup-surface-DAy8vDJK.js";
 import { n as collectRuntimeConfigAssignments, r as secretTargetRegistryEntries } from "./secret-contract-BKkzzjBA.js";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
 import { buildChannelProgressDraftLine, createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, deriveDurableFinalDeliveryRequirements } from "openclaw/plugin-sdk/channel-outbound";
@@ -6,490 +6,176 @@ import { createComputedAccountStatusAdapter, createDefaultChannelRuntimeState }
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
+import { normalizeAgentId } from "openclaw/plugin-sdk/routing";
+import { createHash, randomUUID } from "node:crypto";
+import { buildMentionRegexes, normalizeMentionText } from "openclaw/plugin-sdk/channel-mention-gating";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import { listNativeCommandSpecsForConfig } from "openclaw/plugin-sdk/native-command-registry";
 import { createChannelInboundEnvelopeBuilder } from "openclaw/plugin-sdk/channel-inbound";
-import { normalizeAgentId } from "openclaw/plugin-sdk/routing";
-import { createHash, randomUUID } from "node:crypto";
 import { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
 import { FormatCapabilityProfile, renderMarkdownWithMarkers, sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
-//#region extensions/clickclack/src/runtime.ts
-/**
-* Runtime store for host-provided OpenClaw services used by the ClickClack
-* bundled plugin.
-*/
-const { setRuntime: setClickClackRuntime, getRuntime: getClickClackRuntime } = createPluginRuntimeStore({
-	pluginId: "clickclack",
-	errorMessage: "ClickClack runtime not initialized"
-});
-//#endregion
-//#region extensions/clickclack/src/access.ts
-/**
-* Maps ClickClack senders and conversations onto the shared channel ingress
-* allowlist/command authorization contract.
-*/
-const CHANNEL_ID$2 = "clickclack";
-function normalizeClickClackUserId(value) {
-	const trimmed = value.trim();
-	if (!trimmed) return null;
-	const withoutProvider = trimmed.replace(/^(clickclack|cc):/i, "").trim();
-	return withoutProvider.match(/^dm:(.+)$/i)?.[1]?.trim() || withoutProvider || null;
+//#region extensions/clickclack/src/discussions/binding-generation.ts
+const DISCUSSION_GENERATIONS_NAMESPACE = "discussion-binding-generations";
+const MAX_PENDING_DISCUSSION_GENERATIONS = 1e4;
+const storesByRuntime$2 = /* @__PURE__ */ new WeakMap();
+function getGenerationStore(runtime) {
+	const existing = storesByRuntime$2.get(runtime);
+	if (existing) return existing;
+	const created = runtime.state.openSyncKeyedStore({
+		namespace: DISCUSSION_GENERATIONS_NAMESPACE,
+		maxEntries: MAX_PENDING_DISCUSSION_GENERATIONS,
+		overflowPolicy: "reject-new"
+	});
+	storesByRuntime$2.set(runtime, created);
+	return created;
 }
-const clickClackIngressIdentity = {
-	key: "user-id",
-	normalizeEntry: normalizeClickClackUserId,
-	normalizeSubject: normalizeClickClackUserId,
-	isWildcardEntry: (entry) => normalizeClickClackUserId(entry) === "*",
-	entryIdPrefix: "clickclack-user"
-};
-/**
-* Resolves whether a ClickClack message should enter the agent pipeline and
-* whether its command-style body may run tools.
-*/
-async function resolveClickClackInboundAccess(params) {
-	const runtime = getClickClackRuntime();
-	const isDirect = Boolean(params.message.direct_conversation_id);
-	const cfg = params.config;
-	const shouldCheckCommand = runtime.channel.commands.shouldComputeCommandAuthorized(params.message.body, cfg);
-	const resolved = await resolveStableChannelMessageIngress({
-		channelId: CHANNEL_ID$2,
-		accountId: params.account.accountId,
-		identity: clickClackIngressIdentity,
-		cfg,
-		subject: { stableId: params.message.author_id },
-		conversation: {
-			kind: isDirect ? "direct" : "group",
-			id: isDirect ? params.message.direct_conversation_id ?? params.message.author_id : params.message.channel_id ?? params.message.thread_root_id
-		},
-		allowFrom: params.account.allowFrom,
-		dmPolicy: "allowlist",
-		groupPolicy: "allowlist",
-		command: shouldCheckCommand ? {
-			cfg,
-			modeWhenAccessGroupsOff: "configured"
-		} : false
+/** Reserves a generation so an interrupted channel create can be adopted on retry. */
+function reserveDiscussionBindingGeneration(params) {
+	const store = getGenerationStore(params.runtime);
+	const existing = store.lookup(params.sessionKey);
+	if (existing?.destinationIdentity === params.destinationIdentity) return existing.generation;
+	const generation = (params.createGeneration ?? randomUUID)();
+	store.register(params.sessionKey, {
+		destinationIdentity: params.destinationIdentity,
+		generation
 	});
-	return {
-		shouldDispatch: resolved.ingress.admission === "dispatch",
-		commandAuthorized: resolved.commandAccess.requested ? resolved.commandAccess.authorized : resolved.senderAccess.allowed
-	};
+	return generation;
+}
+/** Clears only the completed reservation; future opens must mint a new ownership ref. */
+function clearDiscussionBindingGeneration(params) {
+	const store = getGenerationStore(params.runtime);
+	const existing = store.lookup(params.sessionKey);
+	if (!existing) return;
+	if (params.expectedGeneration && existing.generation !== params.expectedGeneration) return;
+	store.delete(params.sessionKey);
+}
+/** Quarantines a destination before the first fallible channel create. */
+function recordPendingDiscussionOpen(params) {
+	const store = getGenerationStore(params.runtime);
+	const existing = store.lookup(params.sessionKey);
+	if (!existing || existing.generation !== params.generation) throw new Error("ClickClack discussion generation changed before channel creation");
+	store.register(params.sessionKey, {
+		...existing,
+		pending: params.pending
+	});
+}
+function listPendingDiscussionOpens(runtime) {
+	return getGenerationStore(runtime).entries().flatMap((entry) => entry.value.pending ? [{
+		sessionKey: entry.key,
+		generation: entry.value.generation,
+		...entry.value.pending
+	}] : []);
+}
+function hasPendingDiscussionOpenForDestination(params) {
+	const serverBaseUrl = params.serverBaseUrl.replace(/\/+$/u, "");
+	return listPendingDiscussionOpens(params.runtime).some((pending) => pending.serverBaseUrl === serverBaseUrl && pending.workspaceId === params.workspaceId);
 }
 //#endregion
-//#region extensions/clickclack/src/command-menu.ts
-const CLICKCLACK_COMMAND_PATTERN = /^[a-z0-9_-]{1,32}$/u;
-const CLICKCLACK_MAX_COMMANDS = 100;
-const CLICKCLACK_MAX_DESCRIPTION_LENGTH = 100;
-const CLICKCLACK_MAX_ARGS_HINT_LENGTH = 100;
-function truncateCodePoints(value, maxLength) {
-	return Array.from(value).slice(0, maxLength).join("");
+//#region extensions/clickclack/src/discussions/naming.ts
+function shortSessionHash(sessionKey) {
+	return createHash("sha256").update(sessionKey).digest("hex").slice(0, 32);
 }
-function commandArgsHint(spec) {
-	if (spec.args?.length) return truncateCodePoints(spec.args.map((arg) => arg.required ? `<${arg.name}>` : `[${arg.name}]`).join(" "), CLICKCLACK_MAX_ARGS_HINT_LENGTH);
-	return spec.acceptsArgs ? "[args]" : "";
+function slugifyLabel(label) {
+	return label.normalize("NFKD").replace(/[\u0300-\u036f]/gu, "").toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").slice(0, 80).replace(/-+$/gu, "");
 }
-function errorStatus(error) {
-	if (!error || typeof error !== "object" || !("status" in error)) return;
-	const status = error.status;
-	return typeof status === "number" ? status : void 0;
+function fallbackDiscussionLabel(sessionKey, agentId) {
+	const agentSegment = agentId?.trim() ? slugifyLabel(agentId) : "";
+	const hash = shortSessionHash(sessionKey).slice(0, 8);
+	return `s-${agentSegment ? `${agentSegment}-` : ""}${hash}`;
 }
-function mapNativeCommandSpecsToClickClackMenu(specs, log) {
-	const commands = [];
-	const seen = /* @__PURE__ */ new Set();
-	const invalidNames = /* @__PURE__ */ new Set();
-	for (const spec of specs) {
-		if (spec.isAlias) continue;
-		const command = spec.name.trim().toLowerCase();
-		if (!CLICKCLACK_COMMAND_PATTERN.test(command)) {
-			invalidNames.add(spec.name.trim() || "<empty>");
-			continue;
+function resolveDiscussionLabel(entry, sessionKey, agentId) {
+	return entry.label?.trim() || entry.displayName?.trim() || entry.subject?.trim() || fallbackDiscussionLabel(sessionKey, agentId);
+}
+function truncateDiscussionDisplayTitle(label) {
+	return Array.from(label).slice(0, 200).join("").trim();
+}
+function slugifyDiscussionLabel(label, sessionKey) {
+	return slugifyLabel(label) || fallbackDiscussionLabel(sessionKey);
+}
+function discussionSessionPeerId(identity) {
+	return `disc-${createHash("sha256").update([
+		identity.mainSessionKey,
+		identity.sessionId,
+		identity.serverBaseUrl,
+		identity.channelId,
+		identity.externalRef
+	].join("\0")).digest("hex").slice(0, 32)}`;
+}
+function isDiscussionSessionKey(sessionKey) {
+	return sessionKey.includes(":clickclack:") && /:channel:disc-[0-9a-f]{32}$/u.test(sessionKey);
+}
+function discussionExternalRef(installationId, mainSessionKey, sessionId, destinationIdentity, bindingGeneration) {
+	return `openclaw:${installationId}:${shortSessionHash([
+		mainSessionKey,
+		sessionId,
+		destinationIdentity,
+		bindingGeneration
+	].join("\0"))}`;
+}
+function discussionCredentialFingerprint(token) {
+	return createHash("sha256").update(token).digest("hex");
+}
+function discussionSessionKey(params) {
+	return params.runtime.channel.routing.buildAgentSessionKey({
+		agentId: params.agentId,
+		channel: "clickclack",
+		accountId: params.accountId,
+		peer: {
+			kind: "channel",
+			id: discussionSessionPeerId(params)
 		}
-		if (seen.has(command)) continue;
-		seen.add(command);
-		const description = spec.description.trim() || command;
-		commands.push({
-			command,
-			description: truncateCodePoints(description, CLICKCLACK_MAX_DESCRIPTION_LENGTH),
-			args_hint: commandArgsHint(spec)
+	});
+}
+//#endregion
+//#region extensions/clickclack/src/discussions/binding-store.ts
+function bindingMatchesSessionIncarnation(runtime, sessionKey, binding) {
+	const entry = runtime.agent.session.getSessionEntry({
+		sessionKey,
+		readConsistency: "latest"
+	});
+	return Boolean(entry && binding.sessionId && entry.sessionId === binding.sessionId);
+}
+function bindingMatchesActiveSessionIncarnation(runtime, sessionKey, binding) {
+	const entry = runtime.agent.session.getSessionEntry({
+		sessionKey,
+		readConsistency: "latest"
+	});
+	return Boolean(entry && binding.sessionId && entry.sessionId === binding.sessionId && entry.archivedAt === void 0);
+}
+const DISCUSSION_BINDINGS_NAMESPACE = "discussion-bindings";
+const MAX_DISCUSSION_BINDINGS = 1e4;
+const storesByRuntime$1 = /* @__PURE__ */ new WeakMap();
+function channelKey(serverBaseUrl, channelId) {
+	return `${serverBaseUrl.replace(/\/+$/u, "")}\0${channelId}`;
+}
+/** SQLite-backed session/channel bindings with a process-local inbound lookup index. */
+var ClickClackDiscussionBindingStore = class {
+	#store;
+	#sessionByChannel = /* @__PURE__ */ new Map();
+	#mainByDiscussionSession = /* @__PURE__ */ new Map();
+	#runtime;
+	constructor(runtime) {
+		this.#runtime = runtime;
+		this.#store = runtime.state.openSyncKeyedStore({
+			namespace: DISCUSSION_BINDINGS_NAMESPACE,
+			maxEntries: MAX_DISCUSSION_BINDINGS,
+			overflowPolicy: "reject-new"
 		});
+		for (const entry of this.#store.entries()) this.#index(entry.key, entry.value);
 	}
-	if (invalidNames.size > 0) log?.warn?.(`ClickClack command menu skipped invalid native command names: ${[...invalidNames].map((name) => JSON.stringify(name)).join(", ")}`);
-	return commands.slice(0, CLICKCLACK_MAX_COMMANDS);
-}
-async function syncClickClackCommandMenu(params) {
-	try {
-		const commands = mapNativeCommandSpecsToClickClackMenu(listNativeCommandSpecsForConfig(params.cfg, { provider: "clickclack" }), params.log);
-		await params.client.setBotCommands(commands);
-	} catch (error) {
-		const status = errorStatus(error);
-		if (status === 403) {
-			params.log?.warn?.("ClickClack command menu sync skipped: bot token lacks commands:write");
-			return;
-		}
-		if (status === 404) {
-			params.log?.debug?.("ClickClack command menu sync skipped: server does not support /api/bots/self/commands");
-			return;
-		}
-		params.log?.warn?.(`ClickClack command menu sync failed: ${formatErrorMessage(error)}`);
-	}
-}
-//#endregion
-//#region extensions/clickclack/src/activity.ts
-/**
-* Publishes agent activity (streamed commentary + tool progress) into
-* ClickClack as durable `agent_commentary` / `agent_tool` message rows,
-* coalesced so one logical step becomes one row instead of a row per frame.
-*
-* Ported from the clickglass agent-bridge sidecar, adapted from gateway
-* websocket frames to the in-process `replyOptions.onItemEvent` seam:
-*
-* - Commentary/reasoning arrives as cumulative text snapshots per item id.
-*   Each segment becomes one durable row: POSTed when the segment starts
-*   streaming and PATCHed (debounced) as the snapshot grows, so prose
-*   interleaves chronologically with tool rows.
-* - Tool/step items can emit several frames (start/update/complete) for the
-*   same call, sometimes with lane-prefixed ids (`tool:X`, `command:X`).
-*   Normalize the prefix away to one key per call, POST one row on the first
-*   frame, and PATCH it when a later frame carries a strictly longer body.
-*/
-/** Debounce window for PATCHing streaming commentary snapshots. */
-const CLICKCLACK_COMMENTARY_FLUSH_MS = 700;
-/** Item kinds rendered as agent_tool rows; everything else is commentary. */
-const TOOL_ITEM_KINDS = /* @__PURE__ */ new Set([
-	"tool",
-	"command",
-	"command_output",
-	"patch",
-	"search",
-	"api"
-]);
-/** Item kinds that never become durable rows (ephemeral or plumbing lanes). */
-const SKIPPED_ITEM_KINDS = /* @__PURE__ */ new Set(["lifecycle"]);
-/** Item kinds emitted as cumulative commentary snapshots. */
-const STREAMING_COMMENTARY_ITEM_KINDS = /* @__PURE__ */ new Set([
-	"preamble",
-	"commentary",
-	"analysis",
-	"thinking",
-	"reasoning"
-]);
-/** Provider-specific reasoning lanes normalized into one ClickClack label. */
-const THINKING_ITEM_KINDS = /* @__PURE__ */ new Set([
-	"analysis",
-	"thinking",
-	"reasoning"
-]);
-function normalizedItemKind(payload) {
-	return payload.kind?.trim().toLowerCase() ?? "";
-}
-function commentaryBody(payload) {
-	const text = payload.progressText?.trim() || payload.summary?.trim() || payload.meta?.trim() || "";
-	if (!text) return "";
-	const kind = normalizedItemKind(payload);
-	if (THINKING_ITEM_KINDS.has(kind)) return `**Thinking**\n\n${text}`;
-	return text;
-}
-function activityBody(payload) {
-	const line = buildChannelProgressDraftLine({
-		event: "item",
-		itemId: payload.itemId,
-		toolCallId: payload.toolCallId,
-		itemKind: payload.kind,
-		title: payload.title,
-		name: payload.name,
-		phase: payload.phase,
-		status: payload.status,
-		summary: payload.summary,
-		progressText: payload.progressText,
-		meta: payload.meta
-	})?.text?.trim();
-	if (line) return line;
-	const head = payload.name?.trim() || payload.title?.trim();
-	const text = payload.progressText?.trim() || payload.summary?.trim();
-	if (head && text) return `**${head}**\n\n${text}`;
-	if (text) return text;
-	if (head) return head;
-	return payload.status?.trim() || payload.kind?.trim() || "";
-}
-/**
-* Creates a per-turn activity publisher. Publishing is best-effort: transport
-* failures are reported through `onError` and never interrupt the reply turn.
-*/
-function createClickClackActivityPublisher(params) {
-	const flushMs = params.flushMs ?? CLICKCLACK_COMMENTARY_FLUSH_MS;
-	const commentaryByItem = /* @__PURE__ */ new Map();
-	const toolRows = /* @__PURE__ */ new Map();
-	let provenance;
-	let chain = Promise.resolve();
-	const enqueue = (work) => {
-		chain = chain.then(work).catch((error) => {
-			params.onError?.(error);
-		});
-		return chain;
-	};
-	const postRow = (kind, body) => params.client.createActivityMessage({
-		channelId: params.target.channelId,
-		conversationId: params.target.conversationId,
-		body,
-		kind,
-		turnId: params.turnId,
-		provenance
-	});
-	const flushCommentary = (segmentKey) => {
-		const segment = commentaryByItem.get(segmentKey);
-		if (!segment) return Promise.resolve();
-		if (segment.timer) {
-			clearTimeout(segment.timer);
-			segment.timer = void 0;
-		}
-		if (!segment.dirty || !segment.body.trim()) return Promise.resolve();
-		segment.dirty = false;
-		const body = segment.body;
-		return enqueue(async () => {
-			if (segment.messageId) {
-				await params.client.updateMessageBody(segment.messageId, body);
-				return;
-			}
-			const posted = await postRow("agent_commentary", body);
-			segment.messageId = posted.id;
-		});
-	};
-	const flushAllCommentary = () => {
-		const flushes = [...commentaryByItem.keys()].map((key) => flushCommentary(key));
-		return Promise.all(flushes).then(() => void 0);
-	};
-	const handleCommentary = (payload) => {
-		const body = commentaryBody(payload);
-		if (!body.trim()) return;
-		const key = payload.itemId?.trim() || "turn";
-		let segment = commentaryByItem.get(key);
-		if (!segment) {
-			segment = {
-				body: "",
-				dirty: false
-			};
-			commentaryByItem.set(key, segment);
-		}
-		if (body.length < segment.body.length || body === segment.body) return;
-		segment.body = body;
-		segment.dirty = true;
-		if (!segment.timer) segment.timer = setTimeout(() => {
-			segment.timer = void 0;
-			flushCommentary(key);
-		}, flushMs);
-	};
-	const toolRowKey = (payload) => {
-		const toolCallId = payload.toolCallId?.trim();
-		if (toolCallId) return toolCallId;
-		return (payload.itemId?.trim() ?? "").replace(/^(tool|command):/, "");
-	};
-	const handleDiscreteItem = (payload) => {
-		const body = activityBody(payload);
-		if (!body) return;
-		const kind = TOOL_ITEM_KINDS.has(payload.kind?.trim().toLowerCase() ?? "") ? "agent_tool" : "agent_commentary";
-		flushAllCommentary();
-		const key = `${kind}:${toolRowKey(payload)}`;
-		const existing = toolRows.get(key);
-		if (!existing || !toolRowKey(payload)) {
-			const row = { body };
-			if (toolRowKey(payload)) toolRows.set(key, row);
-			enqueue(async () => {
-				const posted = await postRow(kind, row.body);
-				row.messageId = posted.id;
-				row.sentBody = row.body;
-			});
-			return;
-		}
-		if (body.length <= existing.body.length) return;
-		existing.body = body;
-		enqueue(async () => {
-			if (existing.messageId && existing.body !== existing.sentBody) {
-				await params.client.updateMessageBody(existing.messageId, existing.body);
-				existing.sentBody = existing.body;
-			}
-		});
-	};
-	return {
-		onItemEvent: (payload) => {
-			const kind = normalizedItemKind(payload);
-			if (STREAMING_COMMENTARY_ITEM_KINDS.has(kind)) {
-				handleCommentary(payload);
-				return;
-			}
-			if (SKIPPED_ITEM_KINDS.has(kind)) return;
-			handleDiscreteItem(payload);
-		},
-		setProvenance: (next) => {
-			provenance = next;
-		},
-		finalize: async () => {
-			await flushAllCommentary();
-			await chain;
-		}
-	};
-}
-//#endregion
-//#region extensions/clickclack/src/discussions/binding-generation.ts
-const DISCUSSION_GENERATIONS_NAMESPACE = "discussion-binding-generations";
-const MAX_PENDING_DISCUSSION_GENERATIONS = 1e4;
-const storesByRuntime$2 = /* @__PURE__ */ new WeakMap();
-function getGenerationStore(runtime) {
-	const existing = storesByRuntime$2.get(runtime);
-	if (existing) return existing;
-	const created = runtime.state.openSyncKeyedStore({
-		namespace: DISCUSSION_GENERATIONS_NAMESPACE,
-		maxEntries: MAX_PENDING_DISCUSSION_GENERATIONS,
-		overflowPolicy: "reject-new"
-	});
-	storesByRuntime$2.set(runtime, created);
-	return created;
-}
-/** Reserves a generation so an interrupted channel create can be adopted on retry. */
-function reserveDiscussionBindingGeneration(params) {
-	const store = getGenerationStore(params.runtime);
-	const existing = store.lookup(params.sessionKey);
-	if (existing?.destinationIdentity === params.destinationIdentity) return existing.generation;
-	const generation = (params.createGeneration ?? randomUUID)();
-	store.register(params.sessionKey, {
-		destinationIdentity: params.destinationIdentity,
-		generation
-	});
-	return generation;
-}
-/** Clears only the completed reservation; future opens must mint a new ownership ref. */
-function clearDiscussionBindingGeneration(params) {
-	const store = getGenerationStore(params.runtime);
-	const existing = store.lookup(params.sessionKey);
-	if (!existing) return;
-	if (params.expectedGeneration && existing.generation !== params.expectedGeneration) return;
-	store.delete(params.sessionKey);
-}
-/** Quarantines a destination before the first fallible channel create. */
-function recordPendingDiscussionOpen(params) {
-	const store = getGenerationStore(params.runtime);
-	const existing = store.lookup(params.sessionKey);
-	if (!existing || existing.generation !== params.generation) throw new Error("ClickClack discussion generation changed before channel creation");
-	store.register(params.sessionKey, {
-		...existing,
-		pending: params.pending
-	});
-}
-function listPendingDiscussionOpens(runtime) {
-	return getGenerationStore(runtime).entries().flatMap((entry) => entry.value.pending ? [{
-		sessionKey: entry.key,
-		generation: entry.value.generation,
-		...entry.value.pending
-	}] : []);
-}
-function hasPendingDiscussionOpenForDestination(params) {
-	const serverBaseUrl = params.serverBaseUrl.replace(/\/+$/u, "");
-	return listPendingDiscussionOpens(params.runtime).some((pending) => pending.serverBaseUrl === serverBaseUrl && pending.workspaceId === params.workspaceId);
-}
-//#endregion
-//#region extensions/clickclack/src/discussions/naming.ts
-function shortSessionHash(sessionKey) {
-	return createHash("sha256").update(sessionKey).digest("hex").slice(0, 32);
-}
-function slugifyLabel(label) {
-	return label.normalize("NFKD").replace(/[\u0300-\u036f]/gu, "").toLowerCase().replace(/[^a-z0-9]+/gu, "-").replace(/^-+|-+$/gu, "").slice(0, 80).replace(/-+$/gu, "");
-}
-function fallbackDiscussionLabel(sessionKey, agentId) {
-	const agentSegment = agentId?.trim() ? slugifyLabel(agentId) : "";
-	const hash = shortSessionHash(sessionKey).slice(0, 8);
-	return `s-${agentSegment ? `${agentSegment}-` : ""}${hash}`;
-}
-function resolveDiscussionLabel(entry, sessionKey, agentId) {
-	return entry.label?.trim() || entry.displayName?.trim() || entry.subject?.trim() || fallbackDiscussionLabel(sessionKey, agentId);
-}
-function truncateDiscussionDisplayTitle(label) {
-	return Array.from(label).slice(0, 200).join("").trim();
-}
-function slugifyDiscussionLabel(label, sessionKey) {
-	return slugifyLabel(label) || fallbackDiscussionLabel(sessionKey);
-}
-function discussionSessionPeerId(identity) {
-	return `disc-${createHash("sha256").update([
-		identity.mainSessionKey,
-		identity.sessionId,
-		identity.serverBaseUrl,
-		identity.channelId,
-		identity.externalRef
-	].join("\0")).digest("hex").slice(0, 32)}`;
-}
-function isDiscussionSessionKey(sessionKey) {
-	return sessionKey.includes(":clickclack:") && /:channel:disc-[0-9a-f]{32}$/u.test(sessionKey);
-}
-function discussionExternalRef(installationId, mainSessionKey, sessionId, destinationIdentity, bindingGeneration) {
-	return `openclaw:${installationId}:${shortSessionHash([
-		mainSessionKey,
-		sessionId,
-		destinationIdentity,
-		bindingGeneration
-	].join("\0"))}`;
-}
-function discussionCredentialFingerprint(token) {
-	return createHash("sha256").update(token).digest("hex");
-}
-function discussionSessionKey(params) {
-	return params.runtime.channel.routing.buildAgentSessionKey({
-		agentId: params.agentId,
-		channel: "clickclack",
-		accountId: params.accountId,
-		peer: {
-			kind: "channel",
-			id: discussionSessionPeerId(params)
-		}
-	});
-}
-//#endregion
-//#region extensions/clickclack/src/discussions/binding-store.ts
-function bindingMatchesSessionIncarnation(runtime, sessionKey, binding) {
-	const entry = runtime.agent.session.getSessionEntry({
-		sessionKey,
-		readConsistency: "latest"
-	});
-	return Boolean(entry && binding.sessionId && entry.sessionId === binding.sessionId);
-}
-function bindingMatchesActiveSessionIncarnation(runtime, sessionKey, binding) {
-	const entry = runtime.agent.session.getSessionEntry({
-		sessionKey,
-		readConsistency: "latest"
-	});
-	return Boolean(entry && binding.sessionId && entry.sessionId === binding.sessionId && entry.archivedAt === void 0);
-}
-const DISCUSSION_BINDINGS_NAMESPACE = "discussion-bindings";
-const MAX_DISCUSSION_BINDINGS = 1e4;
-const storesByRuntime$1 = /* @__PURE__ */ new WeakMap();
-function channelKey(serverBaseUrl, channelId) {
-	return `${serverBaseUrl.replace(/\/+$/u, "")}\0${channelId}`;
-}
-/** SQLite-backed session/channel bindings with a process-local inbound lookup index. */
-var ClickClackDiscussionBindingStore = class {
-	#store;
-	#sessionByChannel = /* @__PURE__ */ new Map();
-	#mainByDiscussionSession = /* @__PURE__ */ new Map();
-	#runtime;
-	constructor(runtime) {
-		this.#runtime = runtime;
-		this.#store = runtime.state.openSyncKeyedStore({
-			namespace: DISCUSSION_BINDINGS_NAMESPACE,
-			maxEntries: MAX_DISCUSSION_BINDINGS,
-			overflowPolicy: "reject-new"
-		});
-		for (const entry of this.#store.entries()) this.#index(entry.key, entry.value);
-	}
-	get(sessionKey) {
-		return this.#store.lookup(sessionKey);
-	}
-	hasCapacity(sessionKey) {
-		return this.get(sessionKey) !== void 0 || this.#store.entries().length < MAX_DISCUSSION_BINDINGS;
-	}
-	getByChannel(serverBaseUrl, channelId) {
-		const key = channelKey(serverBaseUrl, channelId);
-		const sessionKey = this.#sessionByChannel.get(key);
-		if (!sessionKey) return;
-		const binding = this.get(sessionKey);
-		if (!binding) {
-			this.#sessionByChannel.delete(key);
+	get(sessionKey) {
+		return this.#store.lookup(sessionKey);
+	}
+	hasCapacity(sessionKey) {
+		return this.get(sessionKey) !== void 0 || this.#store.entries().length < MAX_DISCUSSION_BINDINGS;
+	}
+	getByChannel(serverBaseUrl, channelId) {
+		const key = channelKey(serverBaseUrl, channelId);
+		const sessionKey = this.#sessionByChannel.get(key);
+		if (!sessionKey) return;
+		const binding = this.get(sessionKey);
+		if (!binding) {
+			this.#sessionByChannel.delete(key);
 			return;
 		}
 		return {
@@ -579,144 +265,662 @@ function resolveDiscussionBindingAccount(cfg, binding) {
 		account
 	};
 	return {
-		state: "active",
-		account
+		state: "active",
+		account
+	};
+}
+/** Public embed/open URLs for one bound discussion channel. */
+function discussionInfoForBinding(binding, account) {
+	const baseUrl = normalizedServerBaseUrl(account);
+	return {
+		state: "open",
+		embedUrl: `${baseUrl}/embed/channel/${encodeURIComponent(binding.workspaceRouteId)}/${encodeURIComponent(binding.channelRouteId)}?openclawHostTheme=1`,
+		openUrl: `${baseUrl}/app/${encodeURIComponent(binding.workspaceRouteId)}/${encodeURIComponent(binding.channelRouteId)}`
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/discussions/revoked-channel-store.ts
+const REVOKED_CHANNELS_NAMESPACE = "discussion-revoked-channels";
+const MAX_REVOKED_CHANNELS = 1e5;
+const storesByRuntime = /* @__PURE__ */ new WeakMap();
+function revokedChannelKey(params) {
+	return [params.serverBaseUrl.replace(/\/+$/u, ""), params.channelId].join("\0");
+}
+function getStore(runtime) {
+	const existing = storesByRuntime.get(runtime);
+	if (existing) return existing;
+	const created = runtime.state.openSyncKeyedStore({
+		namespace: REVOKED_CHANNELS_NAMESPACE,
+		maxEntries: MAX_REVOKED_CHANNELS,
+		overflowPolicy: "reject-new"
+	});
+	storesByRuntime.set(runtime, created);
+	return created;
+}
+/** Records managed ownership before its live binding is released. */
+function markClickClackDiscussionChannelRevoked(runtime, binding) {
+	const value = {
+		accountId: binding.accountId,
+		serverBaseUrl: binding.serverBaseUrl,
+		channelId: binding.channelId,
+		revokedAt: Date.now()
+	};
+	getStore(runtime).register(revokedChannelKey(value), value);
+}
+function markClickClackDiscussionChannelIdentityRevoked(params) {
+	const value = {
+		accountId: params.accountId,
+		serverBaseUrl: params.serverBaseUrl.replace(/\/+$/u, ""),
+		channelId: params.channelId,
+		revokedAt: Date.now()
+	};
+	getStore(params.runtime).register(revokedChannelKey(value), value);
+}
+function clearClickClackDiscussionChannelRevoked(params) {
+	getStore(params.runtime).delete(revokedChannelKey(params));
+}
+/** Distinguishes a released managed channel from a genuinely ordinary channel. */
+function isClickClackDiscussionChannelRevoked(params) {
+	return Boolean(getStore(params.runtime).lookup(revokedChannelKey(params)));
+}
+//#endregion
+//#region extensions/clickclack/src/discussions/routing.ts
+function resolveClickClackDiscussionRoute(params) {
+	if (isClickClackDiscussionChannelRevoked(params)) return { state: "revoked" };
+	const matched = getClickClackDiscussionBindingStore(params.runtime).getByChannel(params.serverBaseUrl, params.channelId);
+	if (!matched) return { state: hasPendingDiscussionOpenForDestination(params) ? "revoked" : "unbound" };
+	if (matched.binding.accountId !== params.accountId) return { state: "revoked" };
+	if (matched.binding.serverBaseUrl !== params.serverBaseUrl.replace(/\/+$/u, "")) return { state: "revoked" };
+	if (matched.binding.archived) return { state: "revoked" };
+	if (resolveDiscussionBindingAccount(params.config, matched.binding).state !== "active") return { state: "revoked" };
+	if (!bindingMatchesActiveSessionIncarnation(params.runtime, matched.sessionKey, matched.binding)) return { state: "revoked" };
+	const sessionKey = discussionSessionKey({
+		runtime: params.runtime,
+		agentId: matched.binding.agentId,
+		mainSessionKey: matched.sessionKey,
+		sessionId: matched.binding.sessionId,
+		accountId: params.accountId,
+		serverBaseUrl: matched.binding.serverBaseUrl,
+		channelId: matched.binding.channelId,
+		externalRef: matched.binding.externalRef
+	});
+	if (!sessionKey) return { state: "revoked" };
+	return {
+		state: "active",
+		route: {
+			agentId: matched.binding.agentId,
+			sessionKey,
+			systemPrompt: [
+				"You are the side agent for a ClickClack discussion attached to an OpenClaw session.",
+				`The main session key is ${matched.sessionKey}.`,
+				"Observe it with sessions_history and session_status (using changesSince for incremental checks).",
+				"Use sessions_send to relay or steer the main session only when the humans in this discussion ask you to.",
+				"These session tools are host-scoped to the attached main session; do not attempt session discovery or alternate targets."
+			].join(" ")
+		}
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/group-policy.ts
+/**
+* Resolves the effective group policy for a ClickClack channel.
+*
+* Lookup order:
+*  1. Exact channel ID in `groups`
+*  2. Wildcard `'*'` entry in `groups`
+*  3. Account-level `requireMention` / `mentionPatterns`
+*  4. Backward-compatible default: { requireMention: false, mentionPatterns: [] }
+*/
+function resolveClickClackGroupPolicy(params) {
+	const { account, channelId } = params;
+	const accountPolicy = {
+		requireMention: account.requireMention === true,
+		mentionPatterns: account.mentionPatterns ?? []
+	};
+	const wildcard = account.groups?.["*"];
+	const channelKey = channelId?.trim();
+	const exact = channelKey ? account.groups?.[channelKey] : void 0;
+	return {
+		requireMention: exact?.requireMention ?? wildcard?.requireMention ?? accountPolicy.requireMention,
+		mentionPatterns: exact?.mentionPatterns ?? wildcard?.mentionPatterns ?? accountPolicy.mentionPatterns
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/mention-facts.ts
+/**
+* Detects whether a ClickClack group message contains a direct mention of the
+* current account.
+*
+* Pure helper – no side effects, no runtime imports.
+*/
+const CLICKCLACK_MENTION_PATTERN = /(?:^|[^a-z0-9_@-])@([a-z0-9][a-z0-9_-]{1,31})(?![a-z0-9_-])/giu;
+function buildLocalMentionRegexes(params) {
+	if (params.mentionPatterns.length === 0) return [];
+	const cfg = params.cfg;
+	return buildMentionRegexes({
+		...cfg,
+		messages: {
+			...cfg?.messages,
+			groupChat: {
+				...cfg?.messages?.groupChat,
+				mentionPatterns: params.mentionPatterns
+			}
+		}
+	}, void 0, {
+		provider: "clickclack",
+		conversationId: params.channelId
+	});
+}
+function resolveMentionHandles(body) {
+	return [...body.matchAll(CLICKCLACK_MENTION_PATTERN)].map((match) => match[1]?.toLowerCase()).filter((handle) => Boolean(handle));
+}
+/**
+* Builds mention facts for a ClickClack message.
+*
+* Rules:
+* - DMs always have canDetectMention: false, wasMentioned: false
+*   (DMs bypass mention gating).
+* - Group messages: canDetectMention: true when body text is available.
+* - Checks the message body against shared and account-local mention patterns.
+* - If botHandle is provided and the message body contains its ClickClack
+*   `@handle`, treat it as a mention.
+* - Plain display names do not count unless explicitly configured as a pattern.
+*/
+function resolveClickClackMentionFacts(params) {
+	const { isDirect, body, mentionPatterns, botHandle, cfg, agentId, channelId } = params;
+	if (isDirect) return {
+		canDetectMention: false,
+		wasMentioned: false
+	};
+	if (!body) return {
+		canDetectMention: true,
+		wasMentioned: false,
+		hasAnyMention: false
+	};
+	const sharedMentionRegexes = buildMentionRegexes(cfg, agentId, {
+		provider: "clickclack",
+		conversationId: channelId
+	});
+	const localMentionRegexes = buildLocalMentionRegexes({
+		cfg,
+		mentionPatterns,
+		channelId
+	});
+	const mentionRegexes = [...sharedMentionRegexes, ...localMentionRegexes];
+	const bodyForRegex = normalizeMentionText(body);
+	const hasConfiguredMention = mentionRegexes.some((regex) => regex.test(bodyForRegex));
+	const mentionHandles = resolveMentionHandles(body);
+	const normalizedBotHandle = botHandle?.replace(/^@/u, "").trim().toLowerCase();
+	return {
+		canDetectMention: true,
+		wasMentioned: (normalizedBotHandle ? mentionHandles.includes(normalizedBotHandle) : false) || hasConfiguredMention,
+		hasAnyMention: mentionHandles.length > 0 || hasConfiguredMention
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/runtime.ts
+/**
+* Runtime store for host-provided OpenClaw services used by the ClickClack
+* bundled plugin.
+*/
+const { setRuntime: setClickClackRuntime, getRuntime: getClickClackRuntime } = createPluginRuntimeStore({
+	pluginId: "clickclack",
+	errorMessage: "ClickClack runtime not initialized"
+});
+//#endregion
+//#region extensions/clickclack/src/target.ts
+/**
+* Parses `channel:name`, `thread:msg_id`, `dm:usr_id`, or a bare channel name.
+*/
+function parseClickClackTarget(raw) {
+	const value = raw.trim();
+	if (!value) throw new Error("ClickClack target is required");
+	const [prefix, ...rest] = value.split(":");
+	const body = rest.join(":").trim();
+	if (prefix === "channel" && body) return {
+		chatType: "group",
+		kind: "channel",
+		id: body
+	};
+	if (prefix === "thread" && body) return {
+		chatType: "group",
+		kind: "thread",
+		id: body
+	};
+	if (prefix === "dm" && body) return {
+		chatType: "direct",
+		kind: "dm",
+		id: body
+	};
+	if (!body) return {
+		chatType: "group",
+		kind: "channel",
+		id: value
+	};
+	throw new Error(`Unsupported ClickClack target: ${raw}`);
+}
+/** Formats a parsed ClickClack target back into canonical target syntax. */
+function buildClickClackTarget(target) {
+	return `${target.kind}:${target.id}`;
+}
+/** Normalizes user-entered ClickClack target text for channel routing. */
+function normalizeClickClackTarget(raw) {
+	return buildClickClackTarget(parseClickClackTarget(raw));
+}
+/** Reports whether a target string can be offered to the ClickClack parser. */
+function looksLikeClickClackTarget(raw) {
+	return /^(channel|thread|dm):/i.test(raw.trim()) || raw.trim().length > 0;
+}
+//#endregion
+//#region extensions/clickclack/src/access.ts
+/**
+* Maps ClickClack senders and conversations onto the shared channel ingress
+* allowlist/command authorization contract.
+*/
+const CHANNEL_ID$2 = "clickclack";
+function normalizeClickClackUserId(value) {
+	const trimmed = value.trim();
+	if (!trimmed) return null;
+	const withoutProvider = trimmed.replace(/^(clickclack|cc):/i, "").trim();
+	return withoutProvider.match(/^dm:(.+)$/i)?.[1]?.trim() || withoutProvider || null;
+}
+const clickClackIngressIdentity = {
+	key: "user-id",
+	normalizeEntry: normalizeClickClackUserId,
+	normalizeSubject: normalizeClickClackUserId,
+	isWildcardEntry: (entry) => normalizeClickClackUserId(entry) === "*",
+	entryIdPrefix: "clickclack-user"
+};
+function resolveAccountAgentRoute(params) {
+	const runtime = getClickClackRuntime();
+	const peer = {
+		kind: params.isDirect ? "direct" : "channel",
+		id: params.target
+	};
+	const route = runtime.channel.routing.resolveAgentRoute({
+		cfg: params.cfg,
+		channel: CHANNEL_ID$2,
+		accountId: params.account.accountId,
+		peer
+	});
+	const agentId = normalizeAgentId(params.account.agentId ?? route.agentId);
+	if (agentId === route.agentId) return route;
+	const dmScope = params.cfg.session?.dmScope ?? "main";
+	const sessionKey = runtime.channel.routing.buildAgentSessionKey({
+		agentId,
+		mainKey: params.cfg.session?.mainKey,
+		channel: CHANNEL_ID$2,
+		accountId: params.account.accountId,
+		peer,
+		dmScope,
+		identityLinks: params.cfg.session?.identityLinks
+	});
+	const mainSessionKey = runtime.channel.routing.buildAgentSessionKey({
+		agentId,
+		mainKey: params.cfg.session?.mainKey,
+		channel: CHANNEL_ID$2,
+		accountId: params.account.accountId,
+		dmScope: "main"
+	});
+	return {
+		...route,
+		agentId,
+		dmScope,
+		sessionKey,
+		mainSessionKey,
+		lastRoutePolicy: sessionKey === mainSessionKey ? "main" : "session"
 	};
 }
-/** Public embed/open URLs for one bound discussion channel. */
-function discussionInfoForBinding(binding, account) {
-	const baseUrl = normalizedServerBaseUrl(account);
+function resolvePreparedInboundRoute(params) {
+	const runtime = getClickClackRuntime();
+	const isDirect = Boolean(params.message.direct_conversation_id);
+	const target = buildClickClackTarget(isDirect ? {
+		chatType: "direct",
+		kind: "dm",
+		id: params.message.author_id
+	} : {
+		chatType: "group",
+		kind: "channel",
+		id: params.message.channel_id ?? ""
+	});
+	const accountRoute = resolveAccountAgentRoute({
+		cfg: params.config,
+		account: params.account,
+		target,
+		isDirect
+	});
+	const discussionResolution = !isDirect && params.message.channel_id ? resolveClickClackDiscussionRoute({
+		runtime,
+		config: params.config,
+		accountId: params.account.accountId,
+		serverBaseUrl: params.account.baseUrl,
+		workspaceId: params.message.workspace_id,
+		channelId: params.message.channel_id
+	}) : { state: "unbound" };
+	const discussionRoute = discussionResolution.state === "active" ? discussionResolution.route : void 0;
 	return {
-		state: "open",
-		embedUrl: `${baseUrl}/embed/channel/${encodeURIComponent(binding.workspaceRouteId)}/${encodeURIComponent(binding.channelRouteId)}?openclawHostTheme=1`,
-		openUrl: `${baseUrl}/app/${encodeURIComponent(binding.workspaceRouteId)}/${encodeURIComponent(binding.channelRouteId)}`
+		isDirect,
+		target,
+		route: discussionRoute ? {
+			...accountRoute,
+			agentId: discussionRoute.agentId,
+			sessionKey: discussionRoute.sessionKey,
+			lastRoutePolicy: "session"
+		} : accountRoute,
+		discussionRoute,
+		revoked: discussionResolution.state === "revoked"
+	};
+}
+/**
+* Resolves whether a ClickClack message should enter the agent pipeline and
+* whether its command-style body may run tools.
+*/
+async function resolveClickClackInboundAccess(params) {
+	const runtime = getClickClackRuntime();
+	const cfg = params.config;
+	const preparedRoute = resolvePreparedInboundRoute(params);
+	const shouldCheckCommand = runtime.channel.commands.shouldComputeCommandAuthorized(params.message.body, cfg);
+	const effectiveGroupPolicy = resolveClickClackGroupPolicy({
+		account: params.account,
+		channelId: params.message.channel_id
+	});
+	const mentionFacts = resolveClickClackMentionFacts({
+		isDirect: preparedRoute.isDirect,
+		body: params.message.body,
+		mentionPatterns: effectiveGroupPolicy.mentionPatterns,
+		botHandle: params.account.botHandle,
+		cfg,
+		agentId: preparedRoute.route.agentId,
+		channelId: params.message.channel_id
+	});
+	const allowTextCommands = params.account.replyMode === "agent" && runtime.channel.commands.shouldHandleTextCommands({
+		cfg,
+		surface: CHANNEL_ID$2,
+		commandSource: "text"
+	});
+	const resolved = await resolveStableChannelMessageIngress({
+		channelId: CHANNEL_ID$2,
+		accountId: params.account.accountId,
+		identity: clickClackIngressIdentity,
+		cfg,
+		subject: { stableId: params.message.author_id },
+		conversation: {
+			kind: preparedRoute.isDirect ? "direct" : "group",
+			id: preparedRoute.isDirect ? params.message.direct_conversation_id ?? params.message.author_id : params.message.channel_id ?? params.message.thread_root_id
+		},
+		allowFrom: params.account.allowFrom,
+		dmPolicy: "allowlist",
+		groupPolicy: "allowlist",
+		mentionFacts,
+		policy: { activation: {
+			requireMention: effectiveGroupPolicy.requireMention,
+			allowTextCommands
+		} },
+		command: shouldCheckCommand ? {
+			cfg,
+			modeWhenAccessGroupsOff: "configured"
+		} : false
+	});
+	return {
+		shouldDispatch: !preparedRoute.revoked && resolved.ingress.admission === "dispatch",
+		commandAuthorized: resolved.commandAccess.requested ? resolved.commandAccess.authorized : resolved.senderAccess.allowed,
+		requireMention: effectiveGroupPolicy.requireMention,
+		mentionFacts,
+		preparedRoute
 	};
 }
 //#endregion
-//#region extensions/clickclack/src/discussions/revoked-channel-store.ts
-const REVOKED_CHANNELS_NAMESPACE = "discussion-revoked-channels";
-const MAX_REVOKED_CHANNELS = 1e5;
-const storesByRuntime = /* @__PURE__ */ new WeakMap();
-function revokedChannelKey(params) {
-	return [params.serverBaseUrl.replace(/\/+$/u, ""), params.channelId].join("\0");
+//#region extensions/clickclack/src/command-menu.ts
+const CLICKCLACK_COMMAND_PATTERN = /^[a-z0-9_-]{1,32}$/u;
+const CLICKCLACK_MAX_COMMANDS = 100;
+const CLICKCLACK_MAX_DESCRIPTION_LENGTH = 100;
+const CLICKCLACK_MAX_ARGS_HINT_LENGTH = 100;
+function truncateCodePoints(value, maxLength) {
+	return Array.from(value).slice(0, maxLength).join("");
 }
-function getStore(runtime) {
-	const existing = storesByRuntime.get(runtime);
-	if (existing) return existing;
-	const created = runtime.state.openSyncKeyedStore({
-		namespace: REVOKED_CHANNELS_NAMESPACE,
-		maxEntries: MAX_REVOKED_CHANNELS,
-		overflowPolicy: "reject-new"
-	});
-	storesByRuntime.set(runtime, created);
-	return created;
+function commandArgsHint(spec) {
+	if (spec.args?.length) return truncateCodePoints(spec.args.map((arg) => arg.required ? `<${arg.name}>` : `[${arg.name}]`).join(" "), CLICKCLACK_MAX_ARGS_HINT_LENGTH);
+	return spec.acceptsArgs ? "[args]" : "";
 }
-/** Records managed ownership before its live binding is released. */
-function markClickClackDiscussionChannelRevoked(runtime, binding) {
-	const value = {
-		accountId: binding.accountId,
-		serverBaseUrl: binding.serverBaseUrl,
-		channelId: binding.channelId,
-		revokedAt: Date.now()
-	};
-	getStore(runtime).register(revokedChannelKey(value), value);
+function errorStatus(error) {
+	if (!error || typeof error !== "object" || !("status" in error)) return;
+	const status = error.status;
+	return typeof status === "number" ? status : void 0;
 }
-function markClickClackDiscussionChannelIdentityRevoked(params) {
-	const value = {
-		accountId: params.accountId,
-		serverBaseUrl: params.serverBaseUrl.replace(/\/+$/u, ""),
-		channelId: params.channelId,
-		revokedAt: Date.now()
-	};
-	getStore(params.runtime).register(revokedChannelKey(value), value);
+function mapNativeCommandSpecsToClickClackMenu(specs, log) {
+	const commands = [];
+	const seen = /* @__PURE__ */ new Set();
+	const invalidNames = /* @__PURE__ */ new Set();
+	for (const spec of specs) {
+		if (spec.isAlias) continue;
+		const command = spec.name.trim().toLowerCase();
+		if (!CLICKCLACK_COMMAND_PATTERN.test(command)) {
+			invalidNames.add(spec.name.trim() || "<empty>");
+			continue;
+		}
+		if (seen.has(command)) continue;
+		seen.add(command);
+		const description = spec.description.trim() || command;
+		commands.push({
+			command,
+			description: truncateCodePoints(description, CLICKCLACK_MAX_DESCRIPTION_LENGTH),
+			args_hint: commandArgsHint(spec)
+		});
+	}
+	if (invalidNames.size > 0) log?.warn?.(`ClickClack command menu skipped invalid native command names: ${[...invalidNames].map((name) => JSON.stringify(name)).join(", ")}`);
+	return commands.slice(0, CLICKCLACK_MAX_COMMANDS);
 }
-function clearClickClackDiscussionChannelRevoked(params) {
-	getStore(params.runtime).delete(revokedChannelKey(params));
+async function syncClickClackCommandMenu(params) {
+	try {
+		const commands = mapNativeCommandSpecsToClickClackMenu(listNativeCommandSpecsForConfig(params.cfg, { provider: "clickclack" }), params.log);
+		await params.client.setBotCommands(commands);
+	} catch (error) {
+		const status = errorStatus(error);
+		if (status === 403) {
+			params.log?.warn?.("ClickClack command menu sync skipped: bot token lacks commands:write");
+			return;
+		}
+		if (status === 404) {
+			params.log?.debug?.("ClickClack command menu sync skipped: server does not support /api/bots/self/commands");
+			return;
+		}
+		params.log?.warn?.(`ClickClack command menu sync failed: ${formatErrorMessage(error)}`);
+	}
 }
-/** Distinguishes a released managed channel from a genuinely ordinary channel. */
-function isClickClackDiscussionChannelRevoked(params) {
-	return Boolean(getStore(params.runtime).lookup(revokedChannelKey(params)));
+//#endregion
+//#region extensions/clickclack/src/activity.ts
+/**
+* Publishes agent activity (streamed commentary + tool progress) into
+* ClickClack as durable `agent_commentary` / `agent_tool` message rows,
+* coalesced so one logical step becomes one row instead of a row per frame.
+*
+* Ported from the clickglass agent-bridge sidecar, adapted from gateway
+* websocket frames to the in-process `replyOptions.onItemEvent` seam:
+*
+* - Commentary/reasoning arrives as cumulative text snapshots per item id.
+*   Each segment becomes one durable row: POSTed when the segment starts
+*   streaming and PATCHed (debounced) as the snapshot grows, so prose
+*   interleaves chronologically with tool rows.
+* - Tool/step items can emit several frames (start/update/complete) for the
+*   same call, sometimes with lane-prefixed ids (`tool:X`, `command:X`).
+*   Normalize the prefix away to one key per call, POST one row on the first
+*   frame, and PATCH it when a later frame carries a strictly longer body.
+*/
+/** Debounce window for PATCHing streaming commentary snapshots. */
+const CLICKCLACK_COMMENTARY_FLUSH_MS = 700;
+/** Item kinds rendered as agent_tool rows; everything else is commentary. */
+const TOOL_ITEM_KINDS = /* @__PURE__ */ new Set([
+	"tool",
+	"command",
+	"command_output",
+	"patch",
+	"search",
+	"api"
+]);
+/** Item kinds that never become durable rows (ephemeral or plumbing lanes). */
+const SKIPPED_ITEM_KINDS = /* @__PURE__ */ new Set(["lifecycle"]);
+/** Item kinds emitted as cumulative commentary snapshots. */
+const STREAMING_COMMENTARY_ITEM_KINDS = /* @__PURE__ */ new Set([
+	"preamble",
+	"commentary",
+	"analysis",
+	"thinking",
+	"reasoning"
+]);
+/** Provider-specific reasoning lanes normalized into one ClickClack label. */
+const THINKING_ITEM_KINDS = /* @__PURE__ */ new Set([
+	"analysis",
+	"thinking",
+	"reasoning"
+]);
+function normalizedItemKind(payload) {
+	return payload.kind?.trim().toLowerCase() ?? "";
+}
+function commentaryBody(payload) {
+	const text = payload.progressText?.trim() || payload.summary?.trim() || payload.meta?.trim() || "";
+	if (!text) return "";
+	const kind = normalizedItemKind(payload);
+	if (THINKING_ITEM_KINDS.has(kind)) return `**Thinking**\n\n${text}`;
+	return text;
+}
+function activityBody(payload) {
+	const line = buildChannelProgressDraftLine({
+		event: "item",
+		itemId: payload.itemId,
+		toolCallId: payload.toolCallId,
+		itemKind: payload.kind,
+		title: payload.title,
+		name: payload.name,
+		phase: payload.phase,
+		status: payload.status,
+		summary: payload.summary,
+		progressText: payload.progressText,
+		meta: payload.meta
+	})?.text?.trim();
+	if (line) return line;
+	const head = payload.name?.trim() || payload.title?.trim();
+	const text = payload.progressText?.trim() || payload.summary?.trim();
+	if (head && text) return `**${head}**\n\n${text}`;
+	if (text) return text;
+	if (head) return head;
+	return payload.status?.trim() || payload.kind?.trim() || "";
 }
-//#endregion
-//#region extensions/clickclack/src/discussions/routing.ts
-function resolveClickClackDiscussionRoute(params) {
-	if (isClickClackDiscussionChannelRevoked(params)) return { state: "revoked" };
-	const matched = getClickClackDiscussionBindingStore(params.runtime).getByChannel(params.serverBaseUrl, params.channelId);
-	if (!matched) return { state: hasPendingDiscussionOpenForDestination(params) ? "revoked" : "unbound" };
-	if (matched.binding.accountId !== params.accountId) return { state: "revoked" };
-	if (matched.binding.serverBaseUrl !== params.serverBaseUrl.replace(/\/+$/u, "")) return { state: "revoked" };
-	if (matched.binding.archived) return { state: "revoked" };
-	if (resolveDiscussionBindingAccount(params.config, matched.binding).state !== "active") return { state: "revoked" };
-	if (!bindingMatchesActiveSessionIncarnation(params.runtime, matched.sessionKey, matched.binding)) return { state: "revoked" };
-	const sessionKey = discussionSessionKey({
-		runtime: params.runtime,
-		agentId: matched.binding.agentId,
-		mainSessionKey: matched.sessionKey,
-		sessionId: matched.binding.sessionId,
-		accountId: params.accountId,
-		serverBaseUrl: matched.binding.serverBaseUrl,
-		channelId: matched.binding.channelId,
-		externalRef: matched.binding.externalRef
+/**
+* Creates a per-turn activity publisher. Publishing is best-effort: transport
+* failures are reported through `onError` and never interrupt the reply turn.
+*/
+function createClickClackActivityPublisher(params) {
+	const flushMs = params.flushMs ?? CLICKCLACK_COMMENTARY_FLUSH_MS;
+	const commentaryByItem = /* @__PURE__ */ new Map();
+	const toolRows = /* @__PURE__ */ new Map();
+	let provenance;
+	let chain = Promise.resolve();
+	const enqueue = (work) => {
+		chain = chain.then(work).catch((error) => {
+			params.onError?.(error);
+		});
+		return chain;
+	};
+	const postRow = (kind, body) => params.client.createActivityMessage({
+		channelId: params.target.channelId,
+		conversationId: params.target.conversationId,
+		body,
+		kind,
+		turnId: params.turnId,
+		provenance
 	});
-	if (!sessionKey) return { state: "revoked" };
-	return {
-		state: "active",
-		route: {
-			agentId: matched.binding.agentId,
-			sessionKey,
-			systemPrompt: [
-				"You are the side agent for a ClickClack discussion attached to an OpenClaw session.",
-				`The main session key is ${matched.sessionKey}.`,
-				"Observe it with sessions_history and session_status (using changesSince for incremental checks).",
-				"Use sessions_send to relay or steer the main session only when the humans in this discussion ask you to.",
-				"These session tools are host-scoped to the attached main session; do not attempt session discovery or alternate targets."
-			].join(" ")
+	const flushCommentary = (segmentKey) => {
+		const segment = commentaryByItem.get(segmentKey);
+		if (!segment) return Promise.resolve();
+		if (segment.timer) {
+			clearTimeout(segment.timer);
+			segment.timer = void 0;
 		}
+		if (!segment.dirty || !segment.body.trim()) return Promise.resolve();
+		segment.dirty = false;
+		const body = segment.body;
+		return enqueue(async () => {
+			if (segment.messageId) {
+				await params.client.updateMessageBody(segment.messageId, body);
+				return;
+			}
+			const posted = await postRow("agent_commentary", body);
+			segment.messageId = posted.id;
+		});
 	};
-}
-//#endregion
-//#region extensions/clickclack/src/target.ts
-/**
-* Parses `channel:name`, `thread:msg_id`, `dm:usr_id`, or a bare channel name.
-*/
-function parseClickClackTarget(raw) {
-	const value = raw.trim();
-	if (!value) throw new Error("ClickClack target is required");
-	const [prefix, ...rest] = value.split(":");
-	const body = rest.join(":").trim();
-	if (prefix === "channel" && body) return {
-		chatType: "group",
-		kind: "channel",
-		id: body
+	const flushAllCommentary = () => {
+		const flushes = [...commentaryByItem.keys()].map((key) => flushCommentary(key));
+		return Promise.all(flushes).then(() => void 0);
 	};
-	if (prefix === "thread" && body) return {
-		chatType: "group",
-		kind: "thread",
-		id: body
+	const handleCommentary = (payload) => {
+		const body = commentaryBody(payload);
+		if (!body.trim()) return;
+		const key = payload.itemId?.trim() || "turn";
+		let segment = commentaryByItem.get(key);
+		if (!segment) {
+			segment = {
+				body: "",
+				dirty: false
+			};
+			commentaryByItem.set(key, segment);
+		}
+		if (body.length < segment.body.length || body === segment.body) return;
+		segment.body = body;
+		segment.dirty = true;
+		if (!segment.timer) segment.timer = setTimeout(() => {
+			segment.timer = void 0;
+			flushCommentary(key);
+		}, flushMs);
 	};
-	if (prefix === "dm" && body) return {
-		chatType: "direct",
-		kind: "dm",
-		id: body
+	const toolRowKey = (payload) => {
+		const toolCallId = payload.toolCallId?.trim();
+		if (toolCallId) return toolCallId;
+		return (payload.itemId?.trim() ?? "").replace(/^(tool|command):/, "");
 	};
-	if (!body) return {
-		chatType: "group",
-		kind: "channel",
-		id: value
+	const handleDiscreteItem = (payload) => {
+		const body = activityBody(payload);
+		if (!body) return;
+		const kind = TOOL_ITEM_KINDS.has(payload.kind?.trim().toLowerCase() ?? "") ? "agent_tool" : "agent_commentary";
+		flushAllCommentary();
+		const key = `${kind}:${toolRowKey(payload)}`;
+		const existing = toolRows.get(key);
+		if (!existing || !toolRowKey(payload)) {
+			const row = { body };
+			if (toolRowKey(payload)) toolRows.set(key, row);
+			enqueue(async () => {
+				const posted = await postRow(kind, row.body);
+				row.messageId = posted.id;
+				row.sentBody = row.body;
+			});
+			return;
+		}
+		if (body.length <= existing.body.length) return;
+		existing.body = body;
+		enqueue(async () => {
+			if (existing.messageId && existing.body !== existing.sentBody) {
+				await params.client.updateMessageBody(existing.messageId, existing.body);
+				existing.sentBody = existing.body;
+			}
+		});
+	};
+	return {
+		onItemEvent: (payload) => {
+			const kind = normalizedItemKind(payload);
+			if (STREAMING_COMMENTARY_ITEM_KINDS.has(kind)) {
+				handleCommentary(payload);
+				return;
+			}
+			if (SKIPPED_ITEM_KINDS.has(kind)) return;
+			handleDiscreteItem(payload);
+		},
+		setProvenance: (next) => {
+			provenance = next;
+		},
+		finalize: async () => {
+			await flushAllCommentary();
+			await chain;
+		}
 	};
-	throw new Error(`Unsupported ClickClack target: ${raw}`);
-}
-/** Formats a parsed ClickClack target back into canonical target syntax. */
-function buildClickClackTarget(target) {
-	return `${target.kind}:${target.id}`;
-}
-/** Normalizes user-entered ClickClack target text for channel routing. */
-function normalizeClickClackTarget(raw) {
-	return buildClickClackTarget(parseClickClackTarget(raw));
-}
-/** Reports whether a target string can be offered to the ClickClack parser. */
-function looksLikeClickClackTarget(raw) {
-	return /^(channel|thread|dm):/i.test(raw.trim()) || raw.trim().length > 0;
 }
 //#endregion
 //#region extensions/clickclack/src/outbound.ts
@@ -1020,49 +1224,6 @@ function hasClickClackReplyMedia(payload) {
 function resolveClickClackAgentRunId(messageId) {
 	return CLICKCLACK_MESSAGE_ID_PATTERN.test(messageId) ? `${CHANNEL_ID$1}:${messageId}` : void 0;
 }
-function resolveAccountAgentRoute(params) {
-	const runtime = getClickClackRuntime();
-	const route = runtime.channel.routing.resolveAgentRoute({
-		cfg: params.cfg,
-		channel: CHANNEL_ID$1,
-		accountId: params.account.accountId,
-		peer: {
-			kind: params.isDirect ? "direct" : "channel",
-			id: params.target
-		}
-	});
-	const agentId = normalizeAgentId(params.account.agentId ?? route.agentId);
-	if (agentId === route.agentId) return route;
-	const peer = {
-		kind: params.isDirect ? "direct" : "channel",
-		id: params.target
-	};
-	const dmScope = params.cfg.session?.dmScope ?? "main";
-	const sessionKey = runtime.channel.routing.buildAgentSessionKey({
-		agentId,
-		mainKey: params.cfg.session?.mainKey,
-		channel: CHANNEL_ID$1,
-		accountId: params.account.accountId,
-		peer,
-		dmScope,
-		identityLinks: params.cfg.session?.identityLinks
-	});
-	const mainSessionKey = runtime.channel.routing.buildAgentSessionKey({
-		agentId,
-		mainKey: params.cfg.session?.mainKey,
-		channel: CHANNEL_ID$1,
-		accountId: params.account.accountId,
-		dmScope: "main"
-	});
-	return {
-		...route,
-		agentId,
-		dmScope,
-		sessionKey,
-		mainSessionKey,
-		lastRoutePolicy: sessionKey === mainSessionKey ? "main" : "session"
-	};
-}
 async function dispatchModelReply(params) {
 	const runtime = getClickClackRuntime();
 	const text = (await runtime.llm.complete({
@@ -1107,38 +1268,7 @@ async function handleClickClackInbound(params) {
 	if (!access.shouldDispatch) return;
 	const conversationId = message.channel_id || message.direct_conversation_id;
 	if (!conversationId) return;
-	const isDirect = Boolean(message.direct_conversation_id);
-	const target = buildClickClackTarget(isDirect ? {
-		chatType: "direct",
-		kind: "dm",
-		id: message.author_id
-	} : {
-		chatType: "group",
-		kind: "channel",
-		id: message.channel_id ?? ""
-	});
-	const accountRoute = resolveAccountAgentRoute({
-		cfg: params.config,
-		account: params.account,
-		target,
-		isDirect
-	});
-	const discussionResolution = !isDirect && message.channel_id ? resolveClickClackDiscussionRoute({
-		runtime,
-		config: params.config,
-		accountId: params.account.accountId,
-		serverBaseUrl: params.account.baseUrl,
-		workspaceId: message.workspace_id,
-		channelId: message.channel_id
-	}) : { state: "unbound" };
-	if (discussionResolution.state === "revoked") return;
-	const discussionRoute = discussionResolution.state === "active" ? discussionResolution.route : void 0;
-	const route = discussionRoute ? {
-		...accountRoute,
-		agentId: discussionRoute.agentId,
-		sessionKey: discussionRoute.sessionKey,
-		lastRoutePolicy: "session"
-	} : accountRoute;
+	const { discussionRoute, isDirect, route, target } = access.preparedRoute;
 	if (params.account.replyMode === "model" && !discussionRoute) {
 		await dispatchModelReply({
 			account: params.account,
@@ -1216,10 +1346,7 @@ async function handleClickClackInbound(params) {
 		},
 		access: {
 			commands: { authorized: access.commandAuthorized },
-			mentions: {
-				canDetectMention: !isDirect,
-				wasMentioned: !isDirect
-			}
+			mentions: access.mentionFacts
 		},
 		extra: {
 			GroupChannel: message.channel_id,
@@ -1356,7 +1483,10 @@ async function processEvent(params) {
 		config: params.config,
 		message
 	});
-	if (!access.shouldDispatch) return;
+	if (!access.shouldDispatch) {
+		params.log?.info(`[${params.account.accountId}] skipped ClickClack message before agent dispatch: kind=${message.direct_conversation_id ? "dm" : "group"} requireMention=${access.requireMention ?? "unknown"} wasMentioned=${access.mentionFacts.wasMentioned} hasAnyMention=${access.mentionFacts.hasAnyMention ?? "unknown"} commandAuthorized=${access.commandAuthorized}`);
+		return;
+	}
 	await handleClickClackInbound({
 		account: params.account,
 		config: params.config,
@@ -1397,14 +1527,16 @@ async function startClickClackGatewayAccount(ctx) {
 	const account = {
 		...configuredAccount,
 		workspace: workspaceId,
-		botUserId: configuredAccount.botUserId ?? me.id
+		botUserId: configuredAccount.botUserId ?? me.id,
+		botHandle: me.handle
 	};
 	const processIncomingEvent = (event) => processEvent({
 		account,
 		config: ctx.cfg,
 		client,
 		event,
-		botUserId: account.botUserId
+		botUserId: account.botUserId,
+		log: ctx.log
 	});
 	if (account.commandMenu) await syncClickClackCommandMenu({
 		cfg: ctx.cfg,
@@ -1717,4 +1849,4 @@ const clickClackPlugin = createChatChannelPlugin({
 	}
 });
 //#endregion
-export { listPendingDiscussionOpens as C, setClickClackRuntime as D, getClickClackRuntime as E, clearDiscussionBindingGeneration as S, reserveDiscussionBindingGeneration as T, fallbackDiscussionLabel as _, isClickClackDiscussionChannelRevoked as a, slugifyDiscussionLabel as b, discussionAccounts as c, resolveDiscussionBindingAccount as d, bindingMatchesActiveSessionIncarnation as f, discussionExternalRef as g, discussionCredentialFingerprint as h, clearClickClackDiscussionChannelRevoked as i, discussionInfoForBinding as l, getClickClackDiscussionBindingStore as m, buildClickClackTarget as n, markClickClackDiscussionChannelIdentityRevoked as o, bindingMatchesSessionIncarnation as p, parseClickClackTarget as r, markClickClackDiscussionChannelRevoked as s, clickClackPlugin as t, normalizedServerBaseUrl as u, isDiscussionSessionKey as v, recordPendingDiscussionOpen as w, truncateDiscussionDisplayTitle as x, resolveDiscussionLabel as y };
+export { truncateDiscussionDisplayTitle as C, reserveDiscussionBindingGeneration as D, recordPendingDiscussionOpen as E, slugifyDiscussionLabel as S, listPendingDiscussionOpens as T, discussionCredentialFingerprint as _, setClickClackRuntime as a, isDiscussionSessionKey as b, markClickClackDiscussionChannelIdentityRevoked as c, discussionInfoForBinding as d, normalizedServerBaseUrl as f, getClickClackDiscussionBindingStore as g, bindingMatchesSessionIncarnation as h, getClickClackRuntime as i, markClickClackDiscussionChannelRevoked as l, bindingMatchesActiveSessionIncarnation as m, buildClickClackTarget as n, clearClickClackDiscussionChannelRevoked as o, resolveDiscussionBindingAccount as p, parseClickClackTarget as r, isClickClackDiscussionChannelRevoked as s, clickClackPlugin as t, discussionAccounts as u, discussionExternalRef as v, clearDiscussionBindingGeneration as w, resolveDiscussionLabel as x, fallbackDiscussionLabel as y };