@openclaw/clickclack 2026.9.5 → 2026.9.6

package/dist/.setup/{channel-yIQ_PUDD.mjs → channel-CT4CVd4d.mjs}

@@ -5,13 +5,12 @@ import { parseDateStringTimestampMs } from "openclaw/plugin-sdk/number-runtime";
 import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { readStringField } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
-import { buildChannelProgressDraftLine, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, deriveDurableFinalDeliveryRequirements } from "openclaw/plugin-sdk/channel-outbound";
+import { buildChannelProgressDraftLine, createChannelMessageReplyPipeline, createMessageReceiptFromOutboundResults, defineChannelMessageAdapter, deriveDurableFinalDeliveryRequirements, formatChannelProgressDraftLineForEntry, isCompleteAgentPreamble } from "openclaw/plugin-sdk/channel-outbound";
 import { createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { channelReadyPatch, channelStoppedPatch } from "openclaw/plugin-sdk/gateway-runtime";
 import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { rawDataToString } from "openclaw/plugin-sdk/webhook-ingress";
-import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import { normalizeAgentId } from "openclaw/plugin-sdk/routing";
 import { createHash, randomUUID } from "node:crypto";
 import { truncateCodePoints } from "openclaw/plugin-sdk/text-utility-runtime";
@@ -23,84 +22,135 @@ import { extensionForMime } from "openclaw/plugin-sdk/media-mime";
 import { loadOutboundMediaFromUrl } from "openclaw/plugin-sdk/outbound-media";
 import { FormatCapabilityProfile, renderMarkdownWithMarkers, sanitizeAssistantVisibleText } from "openclaw/plugin-sdk/text-chunking";
 //#region extensions/clickclack/src/discussions/binding-generation.ts
-const DISCUSSION_GENERATIONS_NAMESPACE = "discussion-binding-generations";
-const MAX_PENDING_DISCUSSION_GENERATIONS = 1e4;
+const GENERATION_STORE_OPTIONS = {
+	namespace: "discussion-binding-generations",
+	maxEntries: 1e4,
+	overflowPolicy: "reject-new"
+};
 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"
+function withGenerationStore(runtime, run) {
+	let owner = storesByRuntime$2.get(runtime);
+	if (!owner) {
+		const store = runtime.state.openKeyedStore(GENERATION_STORE_OPTIONS);
+		owner = {
+			store,
+			...!store.observe || !store.compareAndApply ? { native: runtime.state.openSyncKeyedStore(GENERATION_STORE_OPTIONS) } : {},
+			tail: Promise.resolve()
+		};
+		storesByRuntime$2.set(runtime, owner);
+	}
+	const currentOwner = owner;
+	const current = owner.tail.then(() => run(currentOwner));
+	owner.tail = current.then(() => void 0, () => void 0);
+	return current;
+}
+function mutateGeneration(runtime, sessionKey, decide) {
+	return withGenerationStore(runtime, async ({ store, native }) => {
+		if (native) {
+			const current = native.lookup(sessionKey);
+			const next = decide(current);
+			if (next.value !== current) {
+				if (next.value) native.register(sessionKey, next.value);
+				else native.delete(sessionKey);
+			}
+			return next.result;
+		}
+		const { observe, compareAndApply } = store;
+		if (!observe || !compareAndApply) throw new Error("ClickClack generation comparison capabilities changed");
+		let observed = await observe(sessionKey);
+		for (;;) {
+			const next = decide(observed.value);
+			const outcome = await compareAndApply(sessionKey, observed.comparison, next.value === observed.value ? {
+				operation: "update",
+				action: "keep"
+			} : next.value ? {
+				operation: "update",
+				action: "set",
+				value: next.value
+			} : {
+				operation: "delete",
+				action: "delete"
+			});
+			if (outcome.status !== "conflict") return next.result;
+			observed = outcome.current;
+		}
 	});
-	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);
-	const existingAccountId = existing?.accountId ?? existing?.pending?.accountId;
-	const existingCredentialFingerprint = existing?.credentialFingerprint ?? existing?.pending?.credentialFingerprint;
-	if (existing?.destinationIdentity === params.destinationIdentity && existingAccountId === params.accountId && existingCredentialFingerprint === params.credentialFingerprint) {
-		if (!existing.accountId || !existing.credentialFingerprint) store.register(params.sessionKey, {
-			...existing,
-			accountId: params.accountId,
-			credentialFingerprint: params.credentialFingerprint
-		});
-		return existing.generation;
-	}
-	const generation = (params.createGeneration ?? randomUUID)();
-	store.register(params.sessionKey, {
-		accountId: params.accountId,
-		credentialFingerprint: params.credentialFingerprint,
-		destinationIdentity: params.destinationIdentity,
-		generation
+	let generation;
+	return mutateGeneration(params.runtime, params.sessionKey, (existing) => {
+		const existingAccountId = existing?.accountId ?? existing?.pending?.accountId;
+		const existingCredentialFingerprint = existing?.credentialFingerprint ?? existing?.pending?.credentialFingerprint;
+		if (existing?.destinationIdentity === params.destinationIdentity && existingAccountId === params.accountId && existingCredentialFingerprint === params.credentialFingerprint) return {
+			value: existing.accountId && existing.credentialFingerprint ? existing : {
+				...existing,
+				accountId: params.accountId,
+				credentialFingerprint: params.credentialFingerprint
+			},
+			result: existing.generation
+		};
+		generation ??= (params.createGeneration ?? randomUUID)();
+		return {
+			value: {
+				accountId: params.accountId,
+				credentialFingerprint: params.credentialFingerprint,
+				destinationIdentity: params.destinationIdentity,
+				generation
+			},
+			result: 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);
+	return mutateGeneration(params.runtime, params.sessionKey, (existing) => ({
+		value: existing && params.expectedGeneration && existing.generation !== params.expectedGeneration ? existing : void 0,
+		result: void 0
+	}));
 }
 /** 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");
-	if (existing.accountId !== params.pending.accountId || existing.credentialFingerprint !== params.pending.credentialFingerprint) throw new Error("ClickClack discussion ownership changed before channel creation");
-	store.register(params.sessionKey, {
-		...existing,
-		pending: params.pending
+	return mutateGeneration(params.runtime, params.sessionKey, (existing) => {
+		if (!existing || existing.generation !== params.generation) throw new Error("ClickClack discussion generation changed before channel creation");
+		if (existing.accountId !== params.pending.accountId || existing.credentialFingerprint !== params.pending.credentialFingerprint) throw new Error("ClickClack discussion ownership changed before channel creation");
+		return {
+			value: {
+				...existing,
+				pending: params.pending
+			},
+			result: void 0
+		};
 	});
 }
 function listPendingDiscussionOpens(runtime) {
-	return getGenerationStore(runtime).entries().flatMap((entry) => entry.value.pending ? [{
+	return withGenerationStore(runtime, async ({ store }) => (await store.entries()).flatMap((entry) => entry.value.pending ? [{
 		sessionKey: entry.key,
 		generation: entry.value.generation,
 		...entry.value.pending
-	}] : []);
+	}] : []));
 }
 /** Stops destination-wide quarantine after the exact remote channel is known. */
 function clearPendingDiscussionOpen(params) {
-	const store = getGenerationStore(params.runtime);
-	const existing = store.lookup(params.sessionKey);
-	if (!existing || existing.generation !== params.expectedGeneration || !existing.pending) return;
-	store.register(params.sessionKey, {
-		accountId: existing.accountId ?? existing.pending.accountId,
-		credentialFingerprint: existing.credentialFingerprint ?? existing.pending.credentialFingerprint,
-		destinationIdentity: existing.destinationIdentity,
-		generation: existing.generation
+	return mutateGeneration(params.runtime, params.sessionKey, (existing) => {
+		if (!existing || existing.generation !== params.expectedGeneration || !existing.pending) return {
+			value: existing,
+			result: void 0
+		};
+		return {
+			value: {
+				accountId: existing.accountId ?? existing.pending.accountId,
+				credentialFingerprint: existing.credentialFingerprint ?? existing.pending.credentialFingerprint,
+				destinationIdentity: existing.destinationIdentity,
+				generation: existing.generation
+			},
+			result: void 0
+		};
 	});
 }
-function hasPendingDiscussionOpenForDestination(params) {
+async function hasPendingDiscussionOpenForDestination(params) {
 	const serverBaseUrl = params.serverBaseUrl.replace(/\/+$/u, "");
-	return listPendingDiscussionOpens(params.runtime).some((pending) => pending.serverBaseUrl === serverBaseUrl && pending.workspaceId === params.workspaceId);
+	return (await listPendingDiscussionOpens(params.runtime)).some((pending) => pending.serverBaseUrl === serverBaseUrl && pending.workspaceId === params.workspaceId);
 }
 //#endregion
 //#region extensions/clickclack/src/discussions/naming.ts
@@ -402,14 +452,19 @@ function isClickClackDiscussionChannelRevoked(params) {
 }
 //#endregion
 //#region extensions/clickclack/src/discussions/routing.ts
-function resolveClickClackDiscussionRoute(params) {
-	if (isClickClackDiscussionChannelRevoked(params)) return { state: "revoked" };
+async function resolveClickClackDiscussionRoute(params) {
 	const store = getClickClackDiscussionBindingStore(params.runtime);
-	const matched = store.getByChannel(params.serverBaseUrl, params.channelId);
-	if (!matched) return { state: hasPendingDiscussionOpenForDestination(params) ? "revoked" : "unbound" };
+	let matched = store.getByChannel(params.serverBaseUrl, params.channelId);
+	let pending = false;
+	if (!matched) {
+		pending = await hasPendingDiscussionOpenForDestination(params);
+		matched = store.getByChannel(params.serverBaseUrl, params.channelId);
+	}
+	if (isClickClackDiscussionChannelRevoked(params)) return { state: "revoked" };
+	if (!matched) return { state: pending ? "revoked" : "unbound" };
 	if (matched.binding.accountId !== params.accountId) return { state: "revoked" };
 	if (matched.binding.serverBaseUrl !== params.serverBaseUrl.replace(/\/+$/u, "")) return { state: "revoked" };
-	if (resolveDiscussionBindingAccount(params.config, matched.binding).state !== "active") return { state: "revoked" };
+	if (resolveDiscussionBindingAccount(params.runtime.config.current(), matched.binding).state !== "active") return { state: "revoked" };
 	let binding;
 	try {
 		binding = attachBindingToCurrentActiveSession({
@@ -622,10 +677,6 @@ function looksLikeClickClackTarget(raw) {
 }
 //#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();
@@ -684,7 +735,7 @@ function resolveAccountAgentRoute(params) {
 		lastRoutePolicy: sessionKey === mainSessionKey ? "main" : "session"
 	};
 }
-function resolvePreparedInboundRoute(params) {
+async function resolvePreparedInboundRoute(params) {
 	const runtime = getClickClackRuntime();
 	const isDirect = Boolean(params.message.direct_conversation_id);
 	const target = buildClickClackTarget(isDirect ? {
@@ -702,9 +753,8 @@ function resolvePreparedInboundRoute(params) {
 		target,
 		isDirect
 	});
-	const discussionResolution = !isDirect && params.message.channel_id ? resolveClickClackDiscussionRoute({
+	const discussionResolution = !isDirect && params.message.channel_id ? await resolveClickClackDiscussionRoute({
 		runtime,
-		config: params.config,
 		accountId: params.account.accountId,
 		serverBaseUrl: params.account.baseUrl,
 		workspaceId: params.message.workspace_id,
@@ -731,7 +781,7 @@ function resolvePreparedInboundRoute(params) {
 async function resolveClickClackInboundAccess(params) {
 	const runtime = getClickClackRuntime();
 	const cfg = params.config;
-	const preparedRoute = resolvePreparedInboundRoute(params);
+	const preparedRoute = await resolvePreparedInboundRoute(params);
 	const shouldCheckCommand = runtime.channel.commands.shouldComputeCommandAuthorized(params.message.body, cfg);
 	const effectiveGroupPolicy = resolveClickClackGroupPolicy({
 		account: params.account,
@@ -786,7 +836,7 @@ async function resolveClickClackInboundAccess(params) {
 		surface: CHANNEL_ID$2,
 		commandSource: "text"
 	});
-	const resolved = await resolveStableChannelMessageIngress({
+	const resolved = await runtime.channel.inbound.ingress.resolveStable({
 		channelId: CHANNEL_ID$2,
 		accountId: params.account.accountId,
 		identity: clickClackIngressIdentity,
@@ -799,6 +849,7 @@ async function resolveClickClackInboundAccess(params) {
 		contextBinding: {
 			agentId: preparedRoute.route.agentId,
 			sessionKey: preparedRoute.route.sessionKey,
+			nativeChannelId: params.message.channel_id || params.message.direct_conversation_id,
 			messageId: params.message.id,
 			inboundEventKind: "user_request"
 		},
@@ -938,7 +989,7 @@ function commentaryBody(payload) {
 	return text;
 }
 function activityBody(payload) {
-	const line = buildChannelProgressDraftLine({
+	const line = formatChannelProgressDraftLineForEntry(void 0, {
 		event: "item",
 		itemId: payload.itemId,
 		toolCallId: payload.toolCallId,
@@ -951,7 +1002,7 @@ function activityBody(payload) {
 		progressText: payload.progressText,
 		meta: payload.meta,
 		commandBearing: payload.commandBearing
-	})?.text?.trim();
+	})?.trim();
 	if (line) return line;
 	const head = payload.name?.trim() || payload.title?.trim();
 	const text = payload.progressText?.trim() || payload.summary?.trim();
@@ -1009,9 +1060,19 @@ function createClickClackActivityPublisher(params) {
 	};
 	const handleCommentary = (payload) => {
 		const body = commentaryBody(payload);
-		if (!body.trim()) return;
 		const key = payload.itemId?.trim() || "turn";
 		let segment = commentaryByItem.get(key);
+		if (!body.trim()) {
+			if (segment) {
+				clearTimeout(segment.timer);
+				commentaryByItem.delete(key);
+				const retracted = segment;
+				enqueue(async () => {
+					if (retracted.messageId) await params.client.updateMessageBody(retracted.messageId, "");
+				});
+			}
+			return;
+		}
 		if (!segment) {
 			segment = {
 				body: "",
@@ -1019,7 +1080,7 @@ function createClickClackActivityPublisher(params) {
 			};
 			commentaryByItem.set(key, segment);
 		}
-		if (body.length < segment.body.length || body === segment.body) return;
+		if (body === segment.body) return;
 		segment.body = body;
 		segment.dirty = true;
 		if (!segment.timer) segment.timer = setTimeout(() => {
@@ -1028,9 +1089,7 @@ function createClickClackActivityPublisher(params) {
 		}, flushMs);
 	};
 	const toolRowKey = (payload) => {
-		const toolCallId = payload.toolCallId?.trim();
-		if (toolCallId) return toolCallId;
-		return (payload.itemId?.trim() ?? "").replace(/^(tool|command):/, "");
+		return payload.itemId?.trim() || payload.toolCallId?.trim() || "";
 	};
 	const handleDiscreteItem = (payload) => {
 		const body = activityBody(payload);
@@ -1049,7 +1108,7 @@ function createClickClackActivityPublisher(params) {
 			});
 			return;
 		}
-		if (body.length <= existing.body.length) return;
+		if (body === existing.body) return;
 		existing.body = body;
 		enqueue(async () => {
 			if (existing.messageId && existing.body !== existing.sentBody) {
@@ -1060,6 +1119,18 @@ function createClickClackActivityPublisher(params) {
 	};
 	return {
 		onItemEvent: (payload) => {
+			if (payload.hideFromChannelProgress || payload.suppressChannelProgress || payload.suppressDurableProgress) {
+				const key = toolRowKey(payload);
+				const row = key ? toolRows.get(`agent_tool:${key}`) : void 0;
+				if (row) {
+					toolRows.delete(`agent_tool:${key}`);
+					enqueue(async () => {
+						if (row.messageId) await params.client.updateMessageBody(row.messageId, "");
+					});
+				}
+				return false;
+			}
+			if (payload.kind === "preamble" && !isCompleteAgentPreamble(payload)) return false;
 			const kind = normalizedItemKind(payload);
 			if (STREAMING_COMMENTARY_ITEM_KINDS.has(kind)) {
 				handleCommentary(payload);
@@ -1410,6 +1481,7 @@ function normalizedKind(payload) {
 	return kind;
 }
 function progressText(payload) {
+	if (payload.kind !== "preamble" && payload.title) return payload.title;
 	const line = buildChannelProgressDraftLine({
 		event: "item",
 		itemId: payload.itemId,
@@ -1433,21 +1505,11 @@ function isFinal(payload) {
 	return phase === "end" || status === "completed" || status === "failed" || status === "blocked";
 }
 function createLineIdResolver() {
-	const lineIdsByIdentity = /* @__PURE__ */ new Map();
 	const anonymousLinesByKind = /* @__PURE__ */ new Map();
 	let anonymousSequence = 0;
 	return (payload) => {
-		const identities = [payload.itemId?.replace(/^(tool|command):/, ""), payload.toolCallId].map((value) => value?.trim()).filter((value) => Boolean(value));
-		const existingId = identities.map((identity) => lineIdsByIdentity.get(identity)).find(Boolean);
-		if (existingId) {
-			for (const identity of identities) lineIdsByIdentity.set(identity, existingId);
-			return existingId;
-		}
-		if (identities.length > 0) {
-			const id = `item:${identities[0]}`;
-			for (const identity of identities) lineIdsByIdentity.set(identity, id);
-			return id;
-		}
+		const identity = payload.itemId?.trim() || payload.toolCallId?.trim();
+		if (identity) return `item:${identity}`;
 		const kind = normalizedKind(payload);
 		const anonymousLines = anonymousLinesByKind.get(kind) ?? [];
 		const line = (payload.phase?.trim().toLowerCase() === "start" ? void 0 : anonymousLines.toReversed().find((line) => line.active)) ?? (() => {
@@ -1574,7 +1636,19 @@ function createClickClackAgentProgressPublisher(params) {
 		},
 		onItemEvent(payload) {
 			if (!started || cleared) return false;
+			if (payload.suppressChannelProgress || payload.kind === "preamble" && !isCompleteAgentPreamble(payload)) return false;
 			const id = resolveLineId(payload);
+			if (payload.hideFromChannelProgress) {
+				if (seenLines.delete(id)) enqueueLine(id, {
+					op: "update",
+					line: {
+						id,
+						kind: normalizedKind(payload),
+						text: ""
+					}
+				});
+				return false;
+			}
 			const final = isFinal(payload);
 			const kind = normalizedKind(payload);
 			const retractsExistingCommentary = kind === "commentary" && seenLines.has(id) && payload.progressText !== void 0 && payload.progressText.trim() === "";
@@ -1587,7 +1661,7 @@ function createClickClackAgentProgressPublisher(params) {
 				id,
 				kind,
 				text: retractsExistingCommentary ? "" : progressText(payload),
-				status: payload.status?.trim() || (final ? "completed" : "running")
+				status: payload.status?.trim() || (final ? "blocked" : "running")
 			};
 			if (payload.name?.trim()) line.tool_name = payload.name.trim();
 			enqueueLine(id, {