@openclaw/clickclack 0.0.0 → 2026.6.11-beta.2

package/dist/channel-B8wm8lOk.js

@@ -0,0 +1,876 @@
+import { createAccountListHelpers, hasConfiguredAccountValue } from "openclaw/plugin-sdk/account-helpers";
+import { DEFAULT_ACCOUNT_ID, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
+import { resolveMergedAccountConfig } from "openclaw/plugin-sdk/account-resolution";
+import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
+import { resolveDefaultSecretProviderAlias } from "openclaw/plugin-sdk/provider-auth";
+import { buildSecretInputSchema, normalizeResolvedSecretInputString, normalizeSecretInputString, resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
+import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { buildChannelOutboundSessionRoute, buildThreadAwareOutboundSessionRoute, createChatChannelPlugin } from "openclaw/plugin-sdk/channel-core";
+import { createMessageReceiptFromOutboundResults, defineChannelMessageAdapter } from "openclaw/plugin-sdk/channel-outbound";
+import { getChatChannelMeta } from "openclaw/plugin-sdk/channel-plugin-common";
+import { createComputedAccountStatusAdapter, createDefaultChannelRuntimeState } from "openclaw/plugin-sdk/status-helpers";
+import { buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
+import { z } from "zod";
+import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
+import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
+import { readResponseTextLimited } from "openclaw/plugin-sdk/provider-http";
+import { WebSocket } from "ws";
+//#region extensions/clickclack/src/accounts.ts
+/**
+* Resolves ClickClack account configuration from root channel config, named
+* account overrides, and secret-provider references.
+*/
+const DEFAULT_RECONNECT_MS = 1500;
+const MIN_RECONNECT_MS = 100;
+const MAX_RECONNECT_MS = 6e4;
+const { listAccountIds: listClickClackAccountIds, resolveDefaultAccountId: resolveDefaultClickClackAccountId } = createAccountListHelpers("clickclack", {
+	normalizeAccountId,
+	hasImplicitDefaultAccount: (cfg) => {
+		const channel = cfg.channels?.clickclack;
+		return Boolean(channel?.baseUrl?.trim() && hasConfiguredAccountValue(channel.token) && channel.workspace?.trim());
+	}
+});
+function resolveMergedClickClackAccountConfig(cfg, accountId) {
+	return resolveMergedAccountConfig({
+		channelConfig: cfg.channels?.clickclack,
+		accounts: cfg.channels?.clickclack?.accounts,
+		accountId,
+		omitKeys: ["defaultAccount"],
+		normalizeAccountId
+	});
+}
+function resolveClickClackToken(params) {
+	const resolved = resolveSecretInputString({
+		value: params.value,
+		path: params.accountId === DEFAULT_ACCOUNT_ID ? "channels.clickclack.token" : `channels.clickclack.accounts.${params.accountId}.token`,
+		defaults: params.cfg.secrets?.defaults,
+		mode: "inspect"
+	});
+	if (resolved.status !== "available") {
+		if (resolved.status === "configured_unavailable" && resolved.ref.source === "env") {
+			const providerConfig = params.cfg.secrets?.providers?.[resolved.ref.provider];
+			if (providerConfig) {
+				if (providerConfig.source !== "env") throw new Error(`Secret provider "${resolved.ref.provider}" has source "${providerConfig.source}" but ref requests "env".`);
+				if (providerConfig.allowlist && !providerConfig.allowlist.includes(resolved.ref.id)) throw new Error(`Environment variable "${resolved.ref.id}" is not allowlisted in secrets.providers.${resolved.ref.provider}.allowlist.`);
+			} else if (resolved.ref.provider !== resolveDefaultSecretProviderAlias({ secrets: params.cfg.secrets }, "env")) throw new Error(`Secret provider "${resolved.ref.provider}" is not configured (ref: env:${resolved.ref.provider}:${resolved.ref.id}).`);
+			return normalizeSecretInputString((params.env ?? process.env)[resolved.ref.id]) ?? "";
+		}
+		return "";
+	}
+	return normalizeResolvedSecretInputString({
+		value: resolved.value,
+		path: "channels.clickclack.token"
+	}) ?? "";
+}
+/**
+* Builds the normalized account snapshot used by gateway, outbound delivery,
+* status reporting, and channel routing.
+*/
+function resolveClickClackAccount(params) {
+	const accountId = normalizeAccountId(params.accountId);
+	const merged = resolveMergedClickClackAccountConfig(params.cfg, accountId);
+	const enabled = params.cfg.channels?.clickclack?.enabled !== false && merged.enabled !== false;
+	const baseUrl = merged.baseUrl?.trim().replace(/\/$/, "") ?? "";
+	const token = resolveClickClackToken({
+		cfg: params.cfg,
+		value: merged.token,
+		accountId,
+		env: params.env
+	});
+	const workspace = merged.workspace?.trim() ?? "";
+	return {
+		accountId,
+		enabled,
+		configured: Boolean(baseUrl && token && workspace),
+		name: normalizeOptionalString(merged.name),
+		baseUrl,
+		token,
+		workspace,
+		botUserId: normalizeOptionalString(merged.botUserId),
+		agentId: normalizeOptionalString(merged.agentId),
+		replyMode: merged.replyMode === "model" ? "model" : "agent",
+		model: normalizeOptionalString(merged.model),
+		systemPrompt: normalizeOptionalString(merged.systemPrompt),
+		timeoutSeconds: merged.timeoutSeconds,
+		toolsAllow: merged.toolsAllow,
+		defaultTo: merged.defaultTo?.trim() || "channel:general",
+		allowFrom: merged.allowFrom ?? ["*"],
+		reconnectMs: resolveIntegerOption(merged.reconnectMs, DEFAULT_RECONNECT_MS, {
+			min: MIN_RECONNECT_MS,
+			max: MAX_RECONNECT_MS
+		}),
+		config: {
+			...merged,
+			allowFrom: merged.allowFrom ?? ["*"]
+		}
+	};
+}
+/**
+* Returns all enabled accounts, including the implicit default account when
+* legacy top-level ClickClack config is present.
+*/
+function listEnabledClickClackAccounts(cfg) {
+	return listClickClackAccountIds(cfg).map((accountId) => resolveClickClackAccount({
+		cfg,
+		accountId
+	})).filter((account) => account.enabled);
+}
+//#endregion
+//#region extensions/clickclack/src/config-schema.ts
+/**
+* Zod-backed config schema for ClickClack channel accounts.
+*/
+const ClickClackAccountConfigSchema = z.object({
+	name: z.string().optional(),
+	enabled: z.boolean().optional(),
+	baseUrl: z.string().url().optional(),
+	token: buildSecretInputSchema().optional(),
+	workspace: z.string().optional(),
+	botUserId: z.string().optional(),
+	agentId: z.string().optional(),
+	replyMode: z.enum(["agent", "model"]).optional(),
+	model: z.string().optional(),
+	systemPrompt: z.string().optional(),
+	timeoutSeconds: z.number().int().min(1).max(3600).optional(),
+	toolsAllow: z.array(z.string()).optional(),
+	defaultTo: z.string().optional(),
+	allowFrom: z.array(z.string()).optional(),
+	reconnectMs: z.number().int().min(100).max(6e4).optional()
+}).strict();
+/**
+* Config schema exported to core so `openclaw doctor` and config validation
+* understand both default and named ClickClack accounts.
+*/
+const clickClackConfigSchema = buildChannelConfigSchema(ClickClackAccountConfigSchema.extend({
+	accounts: z.record(z.string(), ClickClackAccountConfigSchema.partial()).optional(),
+	defaultAccount: z.string().optional()
+}).strict());
+//#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/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"
+};
+/**
+* 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
+	});
+	return {
+		shouldDispatch: resolved.ingress.admission === "dispatch",
+		commandAuthorized: resolved.commandAccess.requested ? resolved.commandAccess.authorized : resolved.senderAccess.allowed
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/http-client.ts
+/**
+* Thin ClickClack REST/websocket client used by gateway, resolver, and outbound
+* delivery code.
+*/
+const CLICKCLACK_ERROR_BODY_LIMIT_BYTES = 8 * 1024;
+/**
+* Creates a typed client for the ClickClack API using bearer-token auth.
+*/
+function createClickClackClient(options) {
+	const baseUrl = options.baseUrl.replace(/\/$/, "");
+	const fetcher = options.fetch ?? fetch;
+	const headers = {
+		Authorization: `Bearer ${options.token}`,
+		Accept: "application/json"
+	};
+	async function request(path, init = {}) {
+		const requestHeaders = new Headers(init.headers);
+		for (const [key, value] of Object.entries(headers)) requestHeaders.set(key, value);
+		if (init.body && !(init.body instanceof FormData)) requestHeaders.set("Content-Type", "application/json");
+		const response = await fetcher(`${baseUrl}${path}`, {
+			...init,
+			headers: requestHeaders
+		});
+		if (!response.ok) {
+			const detail = await readResponseTextLimited(response, CLICKCLACK_ERROR_BODY_LIMIT_BYTES);
+			throw new Error(`ClickClack ${response.status}: ${detail}`);
+		}
+		return await response.json();
+	}
+	return {
+		me: async () => {
+			return (await request("/api/me")).user;
+		},
+		workspaces: async () => {
+			return (await request("/api/workspaces")).workspaces;
+		},
+		channels: async (workspaceId) => {
+			return (await request(`/api/workspaces/${encodeURIComponent(workspaceId)}/channels`)).channels;
+		},
+		channelMessages: async (channelId, afterSeq, limit = 20) => {
+			return (await request(`/api/channels/${encodeURIComponent(channelId)}/messages?after_seq=${afterSeq}&limit=${limit}`)).messages;
+		},
+		directMessages: async (conversationId, afterSeq, limit = 20) => {
+			return (await request(`/api/dms/${encodeURIComponent(conversationId)}/messages?after_seq=${afterSeq}&limit=${limit}`)).messages;
+		},
+		thread: async (messageId) => await request(`/api/messages/${encodeURIComponent(messageId)}/thread`),
+		createChannelMessage: async (channelId, body) => {
+			return (await request(`/api/channels/${encodeURIComponent(channelId)}/messages`, {
+				method: "POST",
+				body: JSON.stringify({ body })
+			})).message;
+		},
+		createThreadReply: async (messageId, body) => {
+			return (await request(`/api/messages/${encodeURIComponent(messageId)}/thread/replies`, {
+				method: "POST",
+				body: JSON.stringify({ body })
+			})).message;
+		},
+		createDirectConversation: async (workspaceId, memberIds) => {
+			return (await request("/api/dms", {
+				method: "POST",
+				body: JSON.stringify({
+					workspace_id: workspaceId,
+					member_ids: memberIds
+				})
+			})).conversation;
+		},
+		createDirectMessage: async (conversationId, body) => {
+			return (await request(`/api/dms/${encodeURIComponent(conversationId)}/messages`, {
+				method: "POST",
+				body: JSON.stringify({ body })
+			})).message;
+		},
+		events: async (workspaceId, afterCursor) => {
+			const query = new URLSearchParams({ workspace_id: workspaceId });
+			if (afterCursor) query.set("after_cursor", afterCursor);
+			return (await request(`/api/realtime/events?${query.toString()}`)).events;
+		},
+		websocket: (workspaceId, afterCursor) => {
+			const url = new URL(`${baseUrl}/api/realtime/ws`);
+			url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+			url.searchParams.set("workspace_id", workspaceId);
+			if (afterCursor) url.searchParams.set("after_cursor", afterCursor);
+			return new WebSocket(url, { headers: { Authorization: `Bearer ${options.token}` } });
+		}
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/resolve.ts
+/**
+* Resolves a workspace slug/name/id from config to a ClickClack workspace id.
+*/
+async function resolveWorkspaceId(client, workspace) {
+	if (workspace.startsWith("wsp_")) return workspace;
+	const found = (await client.workspaces()).find((candidate) => candidate.id === workspace || candidate.slug === workspace || candidate.name === workspace);
+	if (!found) throw new Error(`ClickClack workspace not found: ${workspace}`);
+	return found.id;
+}
+/**
+* Resolves a channel name/id from config or target input to a ClickClack
+* channel id.
+*/
+async function resolveChannelId(client, workspaceId, channel) {
+	if (channel.startsWith("chn_")) return channel;
+	const found = (await client.channels(workspaceId)).find((candidate) => candidate.id === channel || candidate.name === channel);
+	if (!found) throw new Error(`ClickClack channel not found: ${channel}`);
+	return found.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
+	};
+	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/outbound.ts
+/**
+* Outbound ClickClack delivery helpers for channel messages, thread replies,
+* and direct messages.
+*/
+/**
+* Sends text to a normalized ClickClack target and returns the created message
+* id for receipt/session tracking.
+*/
+async function sendClickClackText(params) {
+	const account = resolveClickClackAccount({
+		cfg: params.cfg,
+		accountId: params.accountId
+	});
+	const client = createClickClackClient({
+		baseUrl: account.baseUrl,
+		token: account.token
+	});
+	const workspaceId = await resolveWorkspaceId(client, account.workspace);
+	const parsed = parseClickClackTarget(params.to);
+	const explicitThreadId = params.threadId == null ? "" : String(params.threadId);
+	const replyToId = params.replyToId == null ? "" : String(params.replyToId);
+	if (explicitThreadId || replyToId || parsed.kind === "thread") {
+		const rootId = explicitThreadId || replyToId || parsed.id;
+		const message = await client.createThreadReply(rootId, params.text);
+		return {
+			to: params.to,
+			messageId: message.id
+		};
+	}
+	if (parsed.kind === "dm") {
+		const dm = await client.createDirectConversation(workspaceId, [parsed.id]);
+		const message = await client.createDirectMessage(dm.id, params.text);
+		return {
+			to: params.to,
+			messageId: message.id
+		};
+	}
+	const channelId = await resolveChannelId(client, workspaceId, parsed.id);
+	const message = await client.createChannelMessage(channelId, params.text);
+	return {
+		to: params.to,
+		messageId: message.id
+	};
+}
+//#endregion
+//#region extensions/clickclack/src/inbound.ts
+const CHANNEL_ID$1 = "clickclack";
+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 = params.account.agentId ?? route.agentId;
+	if (agentId === route.agentId) return route;
+	return {
+		...route,
+		agentId,
+		sessionKey: runtime.channel.routing.buildAgentSessionKey({
+			agentId,
+			channel: CHANNEL_ID$1,
+			accountId: params.account.accountId,
+			peer: {
+				kind: params.isDirect ? "direct" : "channel",
+				id: params.target
+			}
+		})
+	};
+}
+async function dispatchModelReply(params) {
+	const text = (await getClickClackRuntime().llm.complete({
+		agentId: params.route.agentId,
+		model: params.account.model,
+		maxTokens: 96,
+		purpose: "clickclack bot reply",
+		systemPrompt: params.account.systemPrompt,
+		messages: [{
+			role: "user",
+			content: params.message.body
+		}]
+	})).text.trim();
+	if (!text) return;
+	await sendClickClackText({
+		cfg: params.cfg,
+		accountId: params.account.accountId,
+		to: params.target,
+		text,
+		threadId: params.message.parent_message_id ? params.message.thread_root_id : void 0,
+		replyToId: params.message.id
+	});
+}
+/**
+* Dispatches one already-fetched ClickClack message through the configured
+* reply mode for its account.
+*/
+async function handleClickClackInbound(params) {
+	const runtime = getClickClackRuntime();
+	const message = params.message;
+	const access = params.access ?? await resolveClickClackInboundAccess({
+		account: params.account,
+		config: params.config,
+		message
+	});
+	if (!access.shouldDispatch) 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 route = resolveAccountAgentRoute({
+		cfg: params.config,
+		account: params.account,
+		target,
+		isDirect
+	});
+	if (params.account.replyMode === "model") {
+		await dispatchModelReply({
+			account: params.account,
+			cfg: params.config,
+			message,
+			route,
+			target
+		});
+		return;
+	}
+	const senderName = message.author?.display_name || message.author_id;
+	const previousTimestamp = runtime.channel.session.readSessionUpdatedAt({
+		storePath: runtime.channel.session.resolveStorePath(params.config.session?.store, { agentId: route.agentId }),
+		sessionKey: route.sessionKey
+	});
+	const body = runtime.channel.reply.formatAgentEnvelope({
+		channel: "ClickClack",
+		from: senderName,
+		timestamp: new Date(message.created_at),
+		previousTimestamp,
+		envelope: runtime.channel.reply.resolveEnvelopeFormatOptions(params.config),
+		body: message.body
+	});
+	const storePath = runtime.channel.session.resolveStorePath(params.config.session?.store, { agentId: route.agentId });
+	const ctxPayload = runtime.channel.reply.finalizeInboundContext({
+		Body: body,
+		BodyForAgent: message.body,
+		RawBody: message.body,
+		CommandBody: message.body,
+		From: target,
+		To: target,
+		SessionKey: route.sessionKey,
+		AccountId: route.accountId ?? params.account.accountId,
+		ChatType: isDirect ? "direct" : "group",
+		WasMentioned: isDirect ? void 0 : true,
+		ConversationLabel: isDirect ? senderName : message.channel_id,
+		GroupChannel: message.channel_id,
+		NativeChannelId: message.channel_id || message.direct_conversation_id,
+		MessageThreadId: message.parent_message_id ? message.thread_root_id : void 0,
+		ThreadParentId: message.parent_message_id ? message.thread_root_id : void 0,
+		SenderName: senderName,
+		SenderId: message.author_id,
+		Provider: CHANNEL_ID$1,
+		Surface: CHANNEL_ID$1,
+		MessageSid: message.id,
+		MessageSidFull: message.id,
+		ReplyToId: message.id,
+		Timestamp: message.created_at,
+		OriginatingChannel: CHANNEL_ID$1,
+		OriginatingTo: target,
+		CommandAuthorized: access.commandAuthorized
+	});
+	await runtime.channel.inbound.dispatchReply({
+		cfg: params.config,
+		channel: CHANNEL_ID$1,
+		accountId: params.account.accountId,
+		agentId: route.agentId,
+		routeSessionKey: route.sessionKey,
+		storePath,
+		ctxPayload,
+		recordInboundSession: runtime.channel.session.recordInboundSession,
+		dispatchReplyWithBufferedBlockDispatcher: runtime.channel.reply.dispatchReplyWithBufferedBlockDispatcher,
+		toolsAllow: params.account.toolsAllow,
+		delivery: {
+			deliver: async (payload) => {
+				const text = payload && typeof payload === "object" && "text" in payload ? payload.text ?? "" : "";
+				if (!text.trim()) return;
+				await sendClickClackText({
+					cfg: params.config,
+					accountId: params.account.accountId,
+					to: target,
+					text,
+					threadId: message.parent_message_id ? message.thread_root_id : void 0,
+					replyToId: message.id
+				});
+			},
+			onError: (error) => {
+				throw error instanceof Error ? error : /* @__PURE__ */ new Error(`clickclack dispatch failed: ${String(error)}`);
+			}
+		},
+		replyPipeline: {},
+		record: { onRecordError: (error) => {
+			throw error instanceof Error ? error : /* @__PURE__ */ new Error(`clickclack session record failed: ${String(error)}`);
+		} }
+	});
+}
+//#endregion
+//#region extensions/clickclack/src/gateway.ts
+function payloadString(event, key) {
+	const value = event.payload?.[key];
+	return typeof value === "string" ? value : "";
+}
+async function resolveEventMessage(params) {
+	const messageId = payloadString(params.event, "message_id");
+	if (!messageId) return null;
+	const directConversationId = payloadString(params.event, "direct_conversation_id");
+	if (directConversationId && typeof params.event.seq === "number") return (await params.client.directMessages(directConversationId, params.event.seq - 1, 10)).find((message) => message.id === messageId) ?? null;
+	if (params.event.type === "thread.reply_created") {
+		const rootId = payloadString(params.event, "root_message_id");
+		if (!rootId) return null;
+		return (await params.client.thread(rootId)).replies.find((message) => message.id === messageId) ?? null;
+	}
+	if (params.event.channel_id && typeof params.event.seq === "number") return (await params.client.channelMessages(params.event.channel_id, params.event.seq - 1, 10)).find((message) => message.id === messageId) ?? null;
+	return null;
+}
+function decodeSocketMessage(data) {
+	if (typeof data === "string") return data;
+	if (Buffer.isBuffer(data)) return data.toString("utf8");
+	if (data instanceof ArrayBuffer) return Buffer.from(data).toString("utf8");
+	return Buffer.concat(data).toString("utf8");
+}
+function parseSocketEvent(data) {
+	try {
+		return JSON.parse(decodeSocketMessage(data));
+	} catch {
+		return null;
+	}
+}
+async function processEvent(params) {
+	if (params.event.type !== "message.created" && params.event.type !== "thread.reply_created") return;
+	if (payloadString(params.event, "author_id") === params.botUserId) return;
+	const message = await resolveEventMessage({
+		client: params.client,
+		event: params.event
+	});
+	if (!message || message.author_id === params.botUserId) return;
+	if (message.author?.kind === "bot") return;
+	const access = await resolveClickClackInboundAccess({
+		account: params.account,
+		config: params.config,
+		message
+	});
+	if (!access.shouldDispatch) return;
+	await handleClickClackInbound({
+		account: params.account,
+		config: params.config,
+		message,
+		access
+	});
+}
+async function startClickClackGatewayAccount(ctx) {
+	const configuredAccount = resolveClickClackAccount({
+		cfg: ctx.cfg,
+		accountId: ctx.account.accountId
+	});
+	if (!configuredAccount.configured) throw new Error(`ClickClack is not configured for account "${configuredAccount.accountId}"`);
+	const client = createClickClackClient({
+		baseUrl: configuredAccount.baseUrl,
+		token: configuredAccount.token
+	});
+	const workspaceId = await resolveWorkspaceId(client, configuredAccount.workspace);
+	const me = await client.me();
+	const account = {
+		...configuredAccount,
+		workspace: workspaceId,
+		botUserId: configuredAccount.botUserId ?? me.id
+	};
+	ctx.setStatus({
+		accountId: account.accountId,
+		running: true,
+		configured: true,
+		enabled: account.enabled,
+		baseUrl: account.baseUrl
+	});
+	let afterCursor = "";
+	let initialized = false;
+	try {
+		while (!ctx.abortSignal.aborted) {
+			const backlog = await client.events(workspaceId, afterCursor);
+			if (!initialized) {
+				for (const event of backlog) afterCursor = event.cursor || afterCursor;
+				initialized = true;
+			} else for (const event of backlog) {
+				afterCursor = event.cursor || afterCursor;
+				await processEvent({
+					account,
+					config: ctx.cfg,
+					client,
+					event,
+					botUserId: account.botUserId
+				});
+			}
+			const socket = client.websocket(workspaceId, afterCursor);
+			await new Promise((resolve, reject) => {
+				let settled = false;
+				let removeAbortListener;
+				const finishSocketCycle = () => {
+					if (settled) return;
+					settled = true;
+					removeAbortListener?.();
+					removeAbortListener = void 0;
+					resolve();
+				};
+				const abort = () => {
+					socket.close();
+					finishSocketCycle();
+				};
+				ctx.abortSignal.addEventListener("abort", abort, { once: true });
+				removeAbortListener = () => ctx.abortSignal.removeEventListener("abort", abort);
+				socket.on("message", (data) => {
+					(async () => {
+						const event = parseSocketEvent(data);
+						if (!event) {
+							ctx.log?.warn?.(`[${account.accountId}] skipped malformed ClickClack websocket event`);
+							return;
+						}
+						afterCursor = event.cursor || afterCursor;
+						await processEvent({
+							account,
+							config: ctx.cfg,
+							client,
+							event,
+							botUserId: account.botUserId ?? ""
+						});
+					})().catch(reject);
+				});
+				socket.on("close", finishSocketCycle);
+				socket.on("error", (error) => {
+					if (settled || ctx.abortSignal.aborted) {
+						finishSocketCycle();
+						return;
+					}
+					ctx.log?.warn?.(`[${account.accountId}] ClickClack websocket error; reconnecting: ${error instanceof Error ? error.message : String(error)}`);
+					finishSocketCycle();
+					socket.close();
+				});
+			});
+			if (!ctx.abortSignal.aborted) await new Promise((resolve) => {
+				setTimeout(resolve, account.reconnectMs);
+			});
+		}
+	} finally {
+		ctx.setStatus({
+			accountId: account.accountId,
+			running: false
+		});
+	}
+}
+//#endregion
+//#region extensions/clickclack/src/channel.ts
+/**
+* ClickClack channel plugin definition: target parsing, account config, status,
+* gateway startup, and outbound delivery wiring.
+*/
+const CHANNEL_ID = "clickclack";
+const meta = { ...getChatChannelMeta(CHANNEL_ID) };
+const clickClackMessageAdapter = defineChannelMessageAdapter({
+	id: CHANNEL_ID,
+	durableFinal: { capabilities: {
+		text: true,
+		replyTo: true,
+		thread: true,
+		messageSendingHooks: true
+	} },
+	send: { text: async (ctx) => {
+		const result = await sendClickClackText({
+			cfg: ctx.cfg,
+			accountId: ctx.accountId,
+			to: ctx.to,
+			text: ctx.text,
+			threadId: ctx.threadId,
+			replyToId: ctx.replyToId
+		});
+		const threadId = ctx.threadId == null ? void 0 : String(ctx.threadId);
+		const replyToId = ctx.replyToId ?? void 0;
+		return {
+			messageId: result.messageId,
+			receipt: createMessageReceiptFromOutboundResults({
+				results: [{
+					channel: CHANNEL_ID,
+					messageId: result.messageId
+				}],
+				threadId,
+				replyToId,
+				kind: "text"
+			})
+		};
+	} }
+});
+/**
+* Channel plugin instance registered by the bundled ClickClack entry.
+*/
+const clickClackPlugin = createChatChannelPlugin({
+	base: {
+		id: CHANNEL_ID,
+		meta,
+		capabilities: {
+			chatTypes: ["direct", "group"],
+			threads: true,
+			blockStreaming: true
+		},
+		reload: { configPrefixes: ["channels.clickclack"] },
+		configSchema: clickClackConfigSchema,
+		config: {
+			listAccountIds: (cfg) => listClickClackAccountIds(cfg),
+			resolveAccount: (cfg, accountId) => resolveClickClackAccount({
+				cfg,
+				accountId
+			}),
+			defaultAccountId: (cfg) => resolveDefaultClickClackAccountId(cfg),
+			isConfigured: (account) => account.configured,
+			resolveAllowFrom: ({ cfg, accountId }) => resolveClickClackAccount({
+				cfg,
+				accountId
+			}).allowFrom,
+			resolveDefaultTo: ({ cfg, accountId }) => resolveClickClackAccount({
+				cfg,
+				accountId
+			}).defaultTo
+		},
+		messaging: {
+			targetPrefixes: ["clickclack", "cc"],
+			normalizeTarget: normalizeClickClackTarget,
+			inferTargetChatType: ({ to }) => parseClickClackTarget(to).chatType,
+			targetResolver: {
+				looksLikeId: looksLikeClickClackTarget,
+				hint: "<channel:name|dm:usr_id|thread:msg_id>"
+			},
+			resolveOutboundSessionRoute: ({ cfg, agentId, accountId, target, replyToId, threadId, currentSessionKey }) => {
+				const parsed = parseClickClackTarget(target);
+				return buildThreadAwareOutboundSessionRoute({
+					route: buildChannelOutboundSessionRoute({
+						cfg,
+						agentId,
+						channel: CHANNEL_ID,
+						accountId,
+						peer: {
+							kind: parsed.chatType === "direct" ? "direct" : "channel",
+							id: buildClickClackTarget(parsed)
+						},
+						chatType: parsed.chatType,
+						from: `clickclack:${accountId ?? DEFAULT_ACCOUNT_ID}`,
+						to: buildClickClackTarget(parsed)
+					}),
+					replyToId,
+					threadId: threadId ?? (parsed.kind === "thread" ? parsed.id : void 0),
+					currentSessionKey,
+					canRecoverCurrentThread: () => true
+				});
+			},
+			resolveSessionConversation: ({ rawId }) => {
+				const parsed = parseClickClackTarget(rawId);
+				if (parsed.kind === "dm") return null;
+				return {
+					id: parsed.id,
+					threadId: parsed.kind === "thread" ? parsed.id : void 0,
+					baseConversationId: parsed.id,
+					parentConversationCandidates: [parsed.id]
+				};
+			}
+		},
+		status: createComputedAccountStatusAdapter({
+			defaultRuntime: createDefaultChannelRuntimeState(DEFAULT_ACCOUNT_ID),
+			buildChannelSummary: ({ snapshot }) => ({
+				ok: snapshot.configured,
+				label: snapshot.configured ? "configured" : "missing config",
+				detail: snapshot.baseUrl ?? ""
+			}),
+			resolveAccountSnapshot: ({ account }) => ({
+				accountId: account.accountId,
+				name: account.name,
+				enabled: account.enabled,
+				configured: account.configured,
+				baseUrl: account.baseUrl
+			})
+		}),
+		gateway: { startAccount: startClickClackGatewayAccount },
+		message: clickClackMessageAdapter
+	},
+	outbound: {
+		base: { deliveryMode: "direct" },
+		attachedResults: {
+			channel: CHANNEL_ID,
+			sendText: async ({ cfg, to, text, accountId, threadId, replyToId }) => await sendClickClackText({
+				cfg,
+				accountId,
+				to,
+				text,
+				threadId,
+				replyToId
+			})
+		}
+	}
+});
+//#endregion
+export { getClickClackRuntime as a, DEFAULT_ACCOUNT_ID as c, resolveClickClackAccount as d, resolveDefaultClickClackAccountId as f, createClickClackClient as i, listClickClackAccountIds as l, buildClickClackTarget as n, setClickClackRuntime as o, parseClickClackTarget as r, clickClackConfigSchema as s, clickClackPlugin as t, listEnabledClickClackAccounts as u };