@openclaw/clickclack 2026.7.2-beta.7 → 2026.8.1-beta.2

package/dist/{setup-claim-CP-QZ5bt.js → setup-claim-CQjgPGxU.js}

@@ -1,4 +1,4 @@
-import { a as buildClickClackSetupClaimUrl, o as isClickClackSetupLoopbackHost, s as requireClickClackSetupApiBaseUrl } from "./setup-surface-DAy8vDJK.js";
+import { a as isClickClackSetupLoopbackHost, i as buildClickClackSetupClaimUrl, o as requireClickClackSetupApiBaseUrl } from "./setup-surface-DjT-gmMe.js";
 import { createProviderOperationDeadline, readProviderJsonResponse, readResponseTextLimited, resolveProviderOperationTimeoutMs } from "openclaw/plugin-sdk/provider-http";
 import { fetchWithSsrFGuard, resolvePinnedHostnameWithPolicy, ssrfPolicyFromHttpBaseUrlAllowedHostname } from "openclaw/plugin-sdk/ssrf-runtime";
 import { withTimeout } from "openclaw/plugin-sdk/text-utility-runtime";

package/dist/setup-plugin-api.js

@@ -1,4 +1,4 @@
-import { _ as clickClackMeta, g as clickClackConfigAdapter, m as clickClackConfigSchema, n as clickClackSetupAdapter, r as clickClackSetupContract, t as clickClackSetupWizard } from "./setup-surface-DAy8vDJK.js";
+import { g as clickClackMeta, h as clickClackConfigAdapter, n as clickClackSetupContract, p as clickClackConfigSchema, t as clickClackSetupWizard } from "./setup-surface-DjT-gmMe.js";
 //#region extensions/clickclack/src/channel.setup.ts
 const clickClackSetupPlugin = {
 	id: "clickclack",
@@ -11,7 +11,6 @@ const clickClackSetupPlugin = {
 	reload: { configPrefixes: ["channels.clickclack"] },
 	configSchema: clickClackConfigSchema,
 	config: clickClackConfigAdapter,
-	setup: clickClackSetupAdapter,
 	setupContract: clickClackSetupContract,
 	setupWizard: clickClackSetupWizard
 };

package/dist/{setup-surface-DAy8vDJK.js → setup-surface-DjT-gmMe.js}

@@ -2,12 +2,13 @@ import { createAccountListHelpers, hasConfiguredAccountValue } from "openclaw/pl
 import { DEFAULT_ACCOUNT_ID, DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$2, normalizeAccountId } from "openclaw/plugin-sdk/account-id";
 import { resolveNormalizedAccountEntry } from "openclaw/plugin-sdk/account-resolution-runtime";
 import { resolveIntegerOption } from "openclaw/plugin-sdk/number-runtime";
+import { mergePairLoopGuardConfig } from "openclaw/plugin-sdk/pair-loop-guard-runtime";
 import { resolveDefaultSecretProviderAlias } from "openclaw/plugin-sdk/provider-auth";
 import { tryReadSecretFileSync } from "openclaw/plugin-sdk/secret-file-runtime";
 import { buildSecretInputSchema, normalizeResolvedSecretInputString, normalizeSecretInputString, resolveSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { getChatChannelMeta } from "openclaw/plugin-sdk/channel-plugin-common";
-import { buildChannelConfigSchema, buildMultiAccountChannelSchema } from "openclaw/plugin-sdk/channel-config-schema";
+import { ChannelBotLoopProtectionSchema, buildChannelAllowBotsSchema, buildChannelConfigSchema, buildMultiAccountChannelSchema } from "openclaw/plugin-sdk/channel-config-schema";
 import { z } from "zod";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { redactToolPayloadText } from "openclaw/plugin-sdk/logging-core";
@@ -41,7 +42,7 @@ const DEFAULT_DISCUSSIONS_SECTION = "Sessions";
 const { listAccountIds: listClickClackAccountIds, resolveDefaultAccountId: resolveDefaultClickClackAccountId, resolveAccountConfig: resolveMergedClickClackAccountConfig } = createAccountListHelpers("clickclack", {
 	normalizeAccountId,
 	omitKeys: ["defaultAccount"],
-	nestedObjectKeys: ["discussions"],
+	nestedObjectKeys: ["botLoopProtection", "discussions"],
 	hasImplicitDefaultAccount: (cfg) => {
 		const channel = cfg.channels?.clickclack;
 		return Boolean(channel?.baseUrl?.trim() && (hasConfiguredAccountValue(channel.token) || Boolean(channel.tokenFile?.trim()) || Boolean(process.env.CLICKCLACK_BOT_TOKEN?.trim())) && channel.workspace?.trim());
@@ -52,10 +53,13 @@ function mergeClickClackGroups(...sources) {
 	for (const source of sources) for (const [rawKey, value] of Object.entries(source ?? {})) {
 		const key = rawKey.trim();
 		if (!key) continue;
+		const mergedBotLoopProtection = mergePairLoopGuardConfig(merged.get(key)?.botLoopProtection, value.botLoopProtection);
 		merged.set(key, {
 			...merged.get(key),
 			...value.requireMention !== void 0 ? { requireMention: value.requireMention } : {},
-			...value.mentionPatterns !== void 0 ? { mentionPatterns: value.mentionPatterns } : {}
+			...value.mentionPatterns !== void 0 ? { mentionPatterns: value.mentionPatterns } : {},
+			...value.allowBots !== void 0 ? { allowBots: value.allowBots } : {},
+			...mergedBotLoopProtection ? { botLoopProtection: mergedBotLoopProtection } : {}
 		});
 	}
 	return Object.fromEntries(merged);
@@ -148,6 +152,7 @@ function resolveClickClackAccount(params) {
 			max: MAX_RECONNECT_MS
 		}),
 		agentActivity: merged.agentActivity === true,
+		nativeProgress: merged.nativeProgress === true,
 		commandMenu: merged.commandMenu !== false,
 		discussions: {
 			enabled: merged.discussions?.enabled === true,
@@ -157,6 +162,8 @@ function resolveClickClackAccount(params) {
 		},
 		requireMention: merged.requireMention === true,
 		mentionPatterns: merged.mentionPatterns ?? [],
+		allowBots: merged.allowBots ?? false,
+		botLoopProtection: merged.botLoopProtection,
 		groups: mergeClickClackGroups(merged.groups),
 		config: {
 			...merged,
@@ -204,6 +211,7 @@ const clickClackConfigAdapter = {
 const ClickClackAccountConfigSchema = z.object({
 	name: z.string().optional(),
 	enabled: z.boolean().optional(),
+	configWrites: z.boolean().optional(),
 	baseUrl: z.string().url().optional(),
 	apiBaseUrl: z.string().url().optional(),
 	token: buildSecretInputSchema().optional(),
@@ -217,14 +225,19 @@ const ClickClackAccountConfigSchema = z.object({
 	toolsAllow: z.array(z.string()).optional(),
 	defaultTo: z.string().optional(),
 	allowFrom: z.array(z.string()).optional(),
+	allowBots: buildChannelAllowBotsSchema({ allowMentions: true }),
+	botLoopProtection: ChannelBotLoopProtectionSchema.optional(),
 	reconnectMs: z.number().int().min(100).max(6e4).optional(),
 	agentActivity: z.boolean().optional(),
+	nativeProgress: z.boolean().optional(),
 	commandMenu: z.boolean().optional(),
 	requireMention: z.boolean().optional(),
 	mentionPatterns: z.array(z.string()).optional(),
 	groups: z.record(z.string(), z.object({
 		requireMention: z.boolean().optional(),
-		mentionPatterns: z.array(z.string()).optional()
+		mentionPatterns: z.array(z.string()).optional(),
+		allowBots: buildChannelAllowBotsSchema({ allowMentions: true }),
+		botLoopProtection: ChannelBotLoopProtectionSchema.optional()
 	}).strict()).optional(),
 	discussions: z.object({
 		enabled: z.boolean().optional(),
@@ -262,6 +275,7 @@ const CLICKCLACK_CORRELATION_ID_PATTERN = /^[A-Za-z0-9._:-]+$/u;
 const CLICKCLACK_CORRELATION_ID_HEADER = "X-Correlation-ID";
 const CLICKCLACK_INBOUND_JSON_LIMIT_BYTES = 16 * 1024 * 1024;
 const CLICKCLACK_WEBSOCKET_HANDSHAKE_TIMEOUT_MS = 3e4;
+const CLICKCLACK_EPHEMERAL_REQUEST_TIMEOUT_MS = 15e3;
 const CLICKCLACK_MESSAGE_PAGE_LIMIT = 200;
 const CLICKCLACK_DISCUSSION_ROOT_PAGE_LIMIT = 8;
 const CLICKCLACK_DISCUSSION_THREAD_REQUEST_LIMIT = 24;
@@ -302,20 +316,33 @@ function createClickClackClient(options) {
 		Authorization: `Bearer ${options.token}`,
 		Accept: "application/json"
 	};
-	async function request(path, init = {}) {
+	async function request(path, init = {}, requestOptions = {}) {
 		const requestHeaders = new Headers(init.headers);
 		for (const [key, value] of Object.entries(headers)) requestHeaders.set(key, value);
 		if (correlationId) requestHeaders.set(CLICKCLACK_CORRELATION_ID_HEADER, correlationId);
 		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 ClickClackHttpError(response.status, redactToolPayloadText(detail), new Headers(response.headers));
+		const controller = requestOptions.timeoutMs !== void 0 && !init.signal ? new AbortController() : void 0;
+		const timeout = controller ? setTimeout(() => controller.abort(), requestOptions.timeoutMs) : void 0;
+		try {
+			const response = await fetcher(`${baseUrl}${path}`, {
+				...init,
+				...controller ? { signal: controller.signal } : {},
+				headers: requestHeaders
+			});
+			if (!response.ok) {
+				const detail = await readResponseTextLimited(response, CLICKCLACK_ERROR_BODY_LIMIT_BYTES);
+				throw new ClickClackHttpError(response.status, redactToolPayloadText(detail), new Headers(response.headers));
+			}
+			if (requestOptions.responseMode === "none") {
+				try {
+					await response.body?.cancel();
+				} catch {}
+				return;
+			}
+			return await readProviderJsonResponse(response, "ClickClack response", { maxBytes: CLICKCLACK_INBOUND_JSON_LIMIT_BYTES });
+		} finally {
+			if (timeout) clearTimeout(timeout);
 		}
-		return await readProviderJsonResponse(response, "ClickClack response", { maxBytes: CLICKCLACK_INBOUND_JSON_LIMIT_BYTES });
 	}
 	async function fetchEventPage(workspaceId, pageOptions = {}) {
 		const query = new URLSearchParams({ workspace_id: workspaceId });
@@ -509,6 +536,25 @@ function createClickClackClient(options) {
 				body: JSON.stringify({ body })
 			})).message;
 		},
+		/**
+		* Publishes an ephemeral realtime signal such as native agent progress.
+		* These frames are intentionally not persisted as messages.
+		*/
+		publishEphemeral: async (params) => {
+			await request("/api/realtime/ephemeral", {
+				method: "POST",
+				body: JSON.stringify({
+					workspace_id: params.workspaceId,
+					...params.channelId ? { channel_id: params.channelId } : {},
+					...params.conversationId ? { direct_conversation_id: params.conversationId } : {},
+					type: params.type,
+					payload: params.payload ?? {}
+				})
+			}, {
+				timeoutMs: CLICKCLACK_EPHEMERAL_REQUEST_TIMEOUT_MS,
+				responseMode: "none"
+			});
+		},
 		createDirectMessage: async (conversationId, body, opts) => {
 			return (await request(`/api/dms/${encodeURIComponent(conversationId)}/messages`, {
 				method: "POST",
@@ -733,7 +779,7 @@ const clickClackSetupAdapter = {
 		const claimUrl = setup.exactClaimUrl && !privateApiBaseUrl ? setup.exactClaimUrl : buildClickClackSetupClaimUrl(privateApiBaseUrl ?? setup.baseUrl);
 		let claim;
 		try {
-			const { claimClickClackSetupCode } = await import("./setup-claim-CP-QZ5bt.js");
+			const { claimClickClackSetupCode } = await import("./setup-claim-CQjgPGxU.js");
 			claim = await claimClickClackSetupCode({
 				claimUrl,
 				code: setup.code,
@@ -893,7 +939,8 @@ const clickClackSetupContract = defineChannelSetupContract({
 			cli: {
 				flags: "--use-env",
 				description: "Use CLICKCLACK_BOT_TOKEN"
-			}
+			},
+			envVars: ["CLICKCLACK_BOT_TOKEN"]
 		}
 	},
 	legacyAdapter: clickClackSetupAdapter
@@ -1128,4 +1175,4 @@ const clickClackSetupWizard = {
 	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false)
 };
 //#endregion
-export { resolveDefaultClickClackAccountId as S, clickClackMeta as _, buildClickClackSetupClaimUrl as a, listEnabledClickClackAccounts as b, resolveChannelId as c, createClickClackClient as d, isClickClackChannelNameConflict as f, clickClackConfigAdapter as g, CLICKCLACK_CHANNEL_ID as h, CLICKCLACK_SETUP_CODE_CLAIM_PATH as i, resolveWorkspaceId as l, clickClackConfigSchema as m, clickClackSetupAdapter as n, isClickClackSetupLoopbackHost as o, normalizeClickClackCorrelationId as p, clickClackSetupContract as r, requireClickClackSetupApiBaseUrl as s, clickClackSetupWizard as t, ClickClackHttpError as u, DEFAULT_ACCOUNT_ID$2 as v, resolveClickClackAccount as x, listClickClackAccountIds as y };
+export { DEFAULT_ACCOUNT_ID$2 as _, isClickClackSetupLoopbackHost as a, resolveClickClackAccount as b, resolveWorkspaceId as c, isClickClackChannelNameConflict as d, normalizeClickClackCorrelationId as f, clickClackMeta as g, clickClackConfigAdapter as h, buildClickClackSetupClaimUrl as i, ClickClackHttpError as l, CLICKCLACK_CHANNEL_ID as m, clickClackSetupContract as n, requireClickClackSetupApiBaseUrl as o, clickClackConfigSchema as p, CLICKCLACK_SETUP_CODE_CLAIM_PATH as r, resolveChannelId as s, clickClackSetupWizard as t, createClickClackClient as u, listClickClackAccountIds as v, resolveDefaultClickClackAccountId as x, listEnabledClickClackAccounts as y };

package/openclaw.plugin.json

@@ -1,5 +1,8 @@
 {
   "id": "clickclack",
+  "doctorContract": {
+    "configRepair": true
+  },
   "activation": {
     "onStartup": false
   },
@@ -18,6 +21,9 @@
           "enabled": {
             "type": "boolean"
           },
+          "configWrites": {
+            "type": "boolean"
+          },
           "baseUrl": {
             "type": "string",
             "format": "uri"
@@ -56,6 +62,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {
@@ -144,6 +173,41 @@
               "type": "string"
             }
           },
+          "allowBots": {
+            "anyOf": [
+              {
+                "type": "boolean"
+              },
+              {
+                "type": "string",
+                "const": "mentions"
+              }
+            ]
+          },
+          "botLoopProtection": {
+            "type": "object",
+            "properties": {
+              "enabled": {
+                "type": "boolean"
+              },
+              "maxEventsPerWindow": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "windowSeconds": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              },
+              "cooldownSeconds": {
+                "type": "integer",
+                "exclusiveMinimum": 0,
+                "maximum": 9007199254740991
+              }
+            },
+            "additionalProperties": false
+          },
           "reconnectMs": {
             "type": "integer",
             "minimum": 100,
@@ -152,6 +216,9 @@
           "agentActivity": {
             "type": "boolean"
           },
+          "nativeProgress": {
+            "type": "boolean"
+          },
           "commandMenu": {
             "type": "boolean"
           },
@@ -180,6 +247,41 @@
                   "items": {
                     "type": "string"
                   }
+                },
+                "allowBots": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "string",
+                      "const": "mentions"
+                    }
+                  ]
+                },
+                "botLoopProtection": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "maxEventsPerWindow": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "windowSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "cooldownSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "additionalProperties": false
                 }
               },
               "additionalProperties": false
@@ -218,6 +320,9 @@
                 "enabled": {
                   "type": "boolean"
                 },
+                "configWrites": {
+                  "type": "boolean"
+                },
                 "baseUrl": {
                   "type": "string",
                   "format": "uri"
@@ -256,6 +361,29 @@
                           ],
                           "additionalProperties": false
                         },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "source": {
+                              "type": "string",
+                              "const": "store"
+                            },
+                            "provider": {
+                              "type": "string",
+                              "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                            },
+                            "id": {
+                              "type": "string",
+                              "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                            }
+                          },
+                          "required": [
+                            "source",
+                            "provider",
+                            "id"
+                          ],
+                          "additionalProperties": false
+                        },
                         {
                           "type": "object",
                           "properties": {
@@ -344,6 +472,41 @@
                     "type": "string"
                   }
                 },
+                "allowBots": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "string",
+                      "const": "mentions"
+                    }
+                  ]
+                },
+                "botLoopProtection": {
+                  "type": "object",
+                  "properties": {
+                    "enabled": {
+                      "type": "boolean"
+                    },
+                    "maxEventsPerWindow": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "windowSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    },
+                    "cooldownSeconds": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0,
+                      "maximum": 9007199254740991
+                    }
+                  },
+                  "additionalProperties": false
+                },
                 "reconnectMs": {
                   "type": "integer",
                   "minimum": 100,
@@ -352,6 +515,9 @@
                 "agentActivity": {
                   "type": "boolean"
                 },
+                "nativeProgress": {
+                  "type": "boolean"
+                },
                 "commandMenu": {
                   "type": "boolean"
                 },
@@ -380,6 +546,41 @@
                         "items": {
                           "type": "string"
                         }
+                      },
+                      "allowBots": {
+                        "anyOf": [
+                          {
+                            "type": "boolean"
+                          },
+                          {
+                            "type": "string",
+                            "const": "mentions"
+                          }
+                        ]
+                      },
+                      "botLoopProtection": {
+                        "type": "object",
+                        "properties": {
+                          "enabled": {
+                            "type": "boolean"
+                          },
+                          "maxEventsPerWindow": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "windowSeconds": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          },
+                          "cooldownSeconds": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0,
+                            "maximum": 9007199254740991
+                          }
+                        },
+                        "additionalProperties": false
                       }
                     },
                     "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/clickclack",
-  "version": "2026.7.2-beta.7",
+  "version": "2026.8.1-beta.2",
   "description": "OpenClaw ClickClack channel plugin",
   "type": "module",
   "exports": {
@@ -13,7 +13,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -123,7 +123,10 @@
             "cli": {
               "flags": "--use-env",
               "description": "Use CLICKCLACK_BOT_TOKEN"
-            }
+            },
+            "envVars": [
+              "CLICKCLACK_BOT_TOKEN"
+            ]
           }
         ]
       }
@@ -136,10 +139,10 @@
       "allowInvalidConfigRecovery": true
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7",
+      "openclawVersion": "2026.8.1-beta.2",
       "bundledDist": false
     },
     "release": {