@openclaw/crabline 0.1.9 → 0.1.10

package/dist/src/openclaw/bridges/slack.js

@@ -1,4 +1,4 @@
-import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readString, } from "../shared.js";
+import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readNonBlankString, readString, } from "../shared.js";
 import { slackTargetKey, SLACK_CHANNEL_ID_RULE, SLACK_SEND_TARGET_ID_RULE, SLACK_TS_RULE, SLACK_USER_ID_RULE, } from "../../providers/slack-ids.js";
 function requireSlackSendTargetId(value, label) {
     const trimmed = value.trim();
@@ -7,6 +7,15 @@ function requireSlackSendTargetId(value, label) {
     }
     return trimmed;
 }
+function requireSlackTargetKind(parsed, targetId) {
+    if (parsed.native || parsed.threadId !== undefined) {
+        return;
+    }
+    const nativeKind = /^[DUW]/u.test(targetId) ? "direct" : "group";
+    if (parsed.kind !== nativeKind) {
+        throw new Error("Slack target kind does not match the native conversation id.");
+    }
+}
 function requireSlackChannelId(value, label) {
     const trimmed = value.trim();
     if (!SLACK_CHANNEL_ID_RULE.pattern.test(trimmed)) {
@@ -31,19 +40,85 @@ function requireSlackThreadTs(value, label) {
     }
     return trimmed;
 }
+function slackConversationKind(channel) {
+    return channel.startsWith("D") ? "direct" : "group";
+}
+function structuredSlackValues(value) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    if (typeof value !== "string") {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function collectSlackFallbackText(value, output) {
+    if (Array.isArray(value)) {
+        for (const entry of value) {
+            collectSlackFallbackText(entry, output);
+        }
+        return;
+    }
+    if (!isRecord(value)) {
+        return;
+    }
+    for (const key of ["fallback", "title", "alt_text"]) {
+        const text = readNonBlankString(value[key]);
+        if (text) {
+            output.push(text);
+        }
+    }
+    const text = value.text;
+    if (typeof text === "string" && text.trim()) {
+        output.push(text);
+    }
+    else if (isRecord(text)) {
+        collectSlackFallbackText(text, output);
+    }
+    for (const key of ["blocks", "elements", "fields"]) {
+        collectSlackFallbackText(value[key], output);
+    }
+}
+function slackOutboundText(body) {
+    if (typeof body.text === "string") {
+        if (body.text.trim()) {
+            return body.text;
+        }
+        if (body.text.length > 0) {
+            return undefined;
+        }
+    }
+    const fallback = [];
+    collectSlackFallbackText(structuredSlackValues(body.blocks), fallback);
+    collectSlackFallbackText(structuredSlackValues(body.attachments), fallback);
+    const unique = [...new Set(fallback)];
+    return unique.length > 0 ? unique.join("\n") : undefined;
+}
 export const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablineProviderBridge({
     provider: "slack",
     createAdapter(slack) {
         return {
-            async probe() {
+            async probe(signal) {
                 const response = await fetch(`${slack.endpoints.apiRoot}auth.test`, {
                     headers: { authorization: `Bearer ${slack.botToken}` },
                     method: "POST",
+                    ...(signal ? { signal } : {}),
                 });
                 if (!response.ok) {
                     throw new Error(`Crabline Slack auth.test probe failed with HTTP ${response.status}.`);
                 }
-                return await response.json();
+                const result = await response.json();
+                if (!isRecord(result) || result.ok !== true) {
+                    const error = isRecord(result) ? readString(result.error) : undefined;
+                    throw new Error(`Crabline Slack auth.test probe failed: ${error ?? "unknown_error"}.`);
+                }
+                return result;
             },
             createBinding() {
                 return {
@@ -90,6 +165,7 @@ export const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablinePro
             },
             createAgentDelivery(parsed) {
                 const to = requireSlackSendTargetId(parsed.id, "Slack target");
+                requireSlackTargetKind(parsed, to);
                 const threadTs = requireSlackThreadTs(parsed.threadId, "Slack target thread");
                 return {
                     channel: "slack",
@@ -100,6 +176,10 @@ export const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablinePro
             },
             createInbound(input) {
                 const channel = requireSlackChannelId(input.conversation.id, "Slack conversation");
+                const kind = slackConversationKind(channel);
+                if (input.conversation.kind !== kind) {
+                    throw new Error("Slack inbound conversation kind does not match the native channel id.");
+                }
                 const user = requireSlackUserId(input.senderId, "Slack sender");
                 const threadTs = requireSlackThreadTs(input.threadId, "Slack thread");
                 return {
@@ -115,7 +195,7 @@ export const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablinePro
                     qaTarget: qaTargetForInbound(input),
                     stateConversation: {
                         id: channel,
-                        kind: channel.startsWith("D") ? "direct" : "group",
+                        kind,
                     },
                     ...(threadTs ? { threadId: threadTs } : {}),
                 };
@@ -128,9 +208,7 @@ export const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablinePro
                     return null;
                 }
                 const channel = readString(event.body.channel);
-                const text = typeof event.body.text === "string" && event.body.text.trim()
-                    ? event.body.text
-                    : undefined;
+                const text = slackOutboundText(event.body);
                 if (!channel || !text) {
                     return null;
                 }

package/dist/src/openclaw/bridges/slack.js.map

@@ -1 +1 @@
-{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../../src/openclaw/bridges/slack.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../../src/openclaw/bridges/slack.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  createAdminInboundRequest,\n  createOpenClawCrablineProviderBridge,\n  DEFAULT_ACCOUNT_ID,\n  isRecord,\n  qaTargetForInbound,\n  readNonBlankString,\n  readString,\n} from \"../shared.js\";\nimport {\n  slackTargetKey,\n  SLACK_CHANNEL_ID_RULE,\n  SLACK_SEND_TARGET_ID_RULE,\n  SLACK_TS_RULE,\n  SLACK_USER_ID_RULE,\n} from \"../../providers/slack-ids.js\";\n\nfunction requireSlackSendTargetId(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (!SLACK_SEND_TARGET_ID_RULE.pattern.test(trimmed)) {\n    throw new Error(`${label} must be a native Slack conversation or user id.`);\n  }\n  return trimmed;\n}\n\nfunction requireSlackTargetKind(\n  parsed: { kind: \"direct\" | \"group\"; native: boolean; threadId?: string },\n  targetId: string,\n): void {\n  if (parsed.native || parsed.threadId !== undefined) {\n    return;\n  }\n  const nativeKind = /^[DUW]/u.test(targetId) ? \"direct\" : \"group\";\n  if (parsed.kind !== nativeKind) {\n    throw new Error(\"Slack target kind does not match the native conversation id.\");\n  }\n}\n\nfunction requireSlackChannelId(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (!SLACK_CHANNEL_ID_RULE.pattern.test(trimmed)) {\n    throw new Error(`${label} must be a native Slack conversation id.`);\n  }\n  return trimmed;\n}\n\nfunction requireSlackUserId(value: string, label: string): string {\n  const trimmed = value.trim();\n  if (!SLACK_USER_ID_RULE.pattern.test(trimmed)) {\n    throw new Error(`${label} must be a native Slack user id.`);\n  }\n  return trimmed;\n}\n\nfunction requireSlackThreadTs(value: string | undefined, label: string): string | undefined {\n  const trimmed = value?.trim();\n  if (!trimmed) {\n    return undefined;\n  }\n  if (!SLACK_TS_RULE.pattern.test(trimmed)) {\n    throw new Error(`${label} must be a native Slack timestamp.`);\n  }\n  return trimmed;\n}\n\nfunction slackConversationKind(channel: string): \"direct\" | \"group\" {\n  return channel.startsWith(\"D\") ? \"direct\" : \"group\";\n}\n\nfunction structuredSlackValues(value: unknown): unknown[] {\n  if (Array.isArray(value)) {\n    return value;\n  }\n  if (typeof value !== \"string\") {\n    return [];\n  }\n  try {\n    const parsed: unknown = JSON.parse(value);\n    return Array.isArray(parsed) ? parsed : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction collectSlackFallbackText(value: unknown, output: string[]): void {\n  if (Array.isArray(value)) {\n    for (const entry of value) {\n      collectSlackFallbackText(entry, output);\n    }\n    return;\n  }\n  if (!isRecord(value)) {\n    return;\n  }\n  for (const key of [\"fallback\", \"title\", \"alt_text\"] as const) {\n    const text = readNonBlankString(value[key]);\n    if (text) {\n      output.push(text);\n    }\n  }\n  const text = value.text;\n  if (typeof text === \"string\" && text.trim()) {\n    output.push(text);\n  } else if (isRecord(text)) {\n    collectSlackFallbackText(text, output);\n  }\n  for (const key of [\"blocks\", \"elements\", \"fields\"] as const) {\n    collectSlackFallbackText(value[key], output);\n  }\n}\n\nfunction slackOutboundText(body: Record<string, unknown>): string | undefined {\n  if (typeof body.text === \"string\") {\n    if (body.text.trim()) {\n      return body.text;\n    }\n    if (body.text.length > 0) {\n      return undefined;\n    }\n  }\n  const fallback: string[] = [];\n  collectSlackFallbackText(structuredSlackValues(body.blocks), fallback);\n  collectSlackFallbackText(structuredSlackValues(body.attachments), fallback);\n  const unique = [...new Set(fallback)];\n  return unique.length > 0 ? unique.join(\"\\n\") : undefined;\n}\n\nexport const SLACK_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablineProviderBridge({\n  provider: \"slack\",\n  createAdapter(slack) {\n    return {\n      async probe(signal) {\n        const response = await fetch(`${slack.endpoints.apiRoot}auth.test`, {\n          headers: { authorization: `Bearer ${slack.botToken}` },\n          method: \"POST\",\n          ...(signal ? { signal } : {}),\n        });\n        if (!response.ok) {\n          throw new Error(`Crabline Slack auth.test probe failed with HTTP ${response.status}.`);\n        }\n        const result: unknown = await response.json();\n        if (!isRecord(result) || result.ok !== true) {\n          const error = isRecord(result) ? readString(result.error) : undefined;\n          throw new Error(`Crabline Slack auth.test probe failed: ${error ?? \"unknown_error\"}.`);\n        }\n        return result;\n      },\n      createBinding() {\n        return {\n          accountId: DEFAULT_ACCOUNT_ID,\n          channel: \"slack\",\n          createChannelDriverSmokeEnv: (env) => ({\n            ...env,\n            SLACK_API_URL: slack.endpoints.apiRoot,\n            SLACK_BOT_TOKEN: slack.botToken,\n            SLACK_SIGNING_SECRET: slack.signingSecret,\n          }),\n          createGatewayConfig: (openclawConfig = {}) => {\n            const channels = isRecord(openclawConfig.channels) ? openclawConfig.channels : {};\n            const slackConfig = isRecord(channels.slack) ? channels.slack : {};\n            const slackChannels = isRecord(slackConfig.channels) ? slackConfig.channels : {};\n            const defaultSlackChannel = isRecord(slackChannels[\"*\"]) ? slackChannels[\"*\"] : {};\n\n            return {\n              ...openclawConfig,\n              channels: {\n                ...channels,\n                slack: {\n                  ...slackConfig,\n                  enabled: true,\n                  mode: \"http\",\n                  botToken: slack.botToken,\n                  signingSecret: slack.signingSecret,\n                  webhookPath: \"/slack/events\",\n                  dmPolicy: \"open\",\n                  allowFrom: [\"*\"],\n                  groupPolicy: \"open\",\n                  channels: {\n                    ...slackChannels,\n                    \"*\": {\n                      ...defaultSlackChannel,\n                      requireMention: false,\n                    },\n                  },\n                },\n              },\n            };\n          },\n          requiredPluginIds: [\"slack\"],\n        };\n      },\n      createAgentDelivery(parsed) {\n        const to = requireSlackSendTargetId(parsed.id, \"Slack target\");\n        requireSlackTargetKind(parsed, to);\n        const threadTs = requireSlackThreadTs(parsed.threadId, \"Slack target thread\");\n        return {\n          channel: \"slack\",\n          to,\n          replyChannel: \"slack\",\n          replyTo: slackTargetKey(to, threadTs),\n        };\n      },\n      createInbound(input) {\n        const channel = requireSlackChannelId(input.conversation.id, \"Slack conversation\");\n        const kind = slackConversationKind(channel);\n        if (input.conversation.kind !== kind) {\n          throw new Error(\"Slack inbound conversation kind does not match the native channel id.\");\n        }\n        const user = requireSlackUserId(input.senderId, \"Slack sender\");\n        const threadTs = requireSlackThreadTs(input.threadId, \"Slack thread\");\n        return {\n          ...createAdminInboundRequest(slack),\n          providerBody: {\n            channel,\n            user,\n            ...(input.senderName ? { username: input.senderName } : {}),\n            ...(threadTs ? { threadTs } : {}),\n            text: input.text,\n          },\n          providerTargetKey: slackTargetKey(channel, threadTs),\n          qaTarget: qaTargetForInbound(input),\n          stateConversation: {\n            id: channel,\n            kind,\n          },\n          ...(threadTs ? { threadId: threadTs } : {}),\n        };\n      },\n      createOutboundFromRecorderEvent({ event, targetByProviderTarget }) {\n        if (!isRecord(event) || event.type !== \"api\" || typeof event.path !== \"string\") {\n          return null;\n        }\n        if (!event.path.endsWith(\"/api/chat.postMessage\") || !isRecord(event.body)) {\n          return null;\n        }\n        const channel = readString(event.body.channel);\n        const text = slackOutboundText(event.body);\n        if (!channel || !text) {\n          return null;\n        }\n        const threadTs = readString(event.body.thread_ts);\n        const providerTargetKey = slackTargetKey(channel, threadTs);\n        return {\n          accountId: DEFAULT_ACCOUNT_ID,\n          senderId: \"openclaw\",\n          senderName: \"OpenClaw QA\",\n          text,\n          to: targetByProviderTarget.get(providerTargetKey) ?? providerTargetKey,\n        };\n      },\n    };\n  },\n});\n"]}

package/dist/src/openclaw/bridges/telegram.js

@@ -1,28 +1,118 @@
-import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readInteger, readString, } from "../shared.js";
-const TELEGRAM_DIRECT_CHAT_ID = "100001";
-const TELEGRAM_GROUP_CHAT_ID = "-1001234567890";
-const TELEGRAM_DEFAULT_SENDER_ID = 100001;
-const TELEGRAM_OUTBOUND_METHOD_RE = /\/(sendAnimation|sendDocument|sendMessage|sendPhoto|sendVideo)$/u;
+import { createHash } from "node:crypto";
+import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readNonBlankString, readString, } from "../shared.js";
+const TELEGRAM_SYMBOLIC_DIRECT_ID_BASE = 1n << 51n;
+const TELEGRAM_SYMBOLIC_DIRECT_ID_MASK = TELEGRAM_SYMBOLIC_DIRECT_ID_BASE - 1n;
+const TELEGRAM_SYMBOLIC_GROUP_ID_BASE = 1000000000000n;
+const TELEGRAM_SYMBOLIC_GROUP_ID_RANGE = 10000000000n;
+const TELEGRAM_OUTBOUND_METHOD_RE = /\/(sendAnimation|sendAudio|sendDocument|sendMessage|sendPhoto|sendVideo)$/iu;
+const TELEGRAM_USERNAME_RE = /^@[A-Za-z][A-Za-z0-9_]{3,31}$/u;
 function normalizeTelegramChatId(kind, id) {
-    return /^-?\d+$/u.test(id.trim())
-        ? id.trim()
-        : kind === "group"
-            ? TELEGRAM_GROUP_CHAT_ID
-            : TELEGRAM_DIRECT_CHAT_ID;
+    const value = id.trim();
+    if (!value) {
+        throw new Error("Telegram target is required.");
+    }
+    if (/^-?\d+$/u.test(value)) {
+        const numericId = BigInt(value);
+        if (numericId === 0n || (kind === "direct" ? numericId < 0n : numericId > 0n)) {
+            throw new Error("Telegram numeric target sign does not match the declared target kind.");
+        }
+        if (numericId < BigInt(Number.MIN_SAFE_INTEGER) ||
+            numericId > BigInt(Number.MAX_SAFE_INTEGER)) {
+            throw new Error("Telegram numeric target must be a safe integer.");
+        }
+        return numericId.toString();
+    }
+    if (kind === "group" && TELEGRAM_USERNAME_RE.test(value)) {
+        return value;
+    }
+    if (value.startsWith("@")) {
+        throw new Error("Telegram usernames must contain 4-32 letters, digits, or underscores.");
+    }
+    const hash = createHash("sha256").update(`${kind}:${value}`).digest().readBigUInt64BE();
+    if (kind === "group") {
+        return String(-(TELEGRAM_SYMBOLIC_GROUP_ID_BASE + (hash % TELEGRAM_SYMBOLIC_GROUP_ID_RANGE)));
+    }
+    return String(TELEGRAM_SYMBOLIC_DIRECT_ID_BASE + (hash & TELEGRAM_SYMBOLIC_DIRECT_ID_MASK));
 }
 function telegramTargetKey(chatId, threadId) {
     return threadId === undefined ? chatId : `${chatId}:topic:${threadId}`;
 }
+function canonicalTelegramRecorderChatId(value) {
+    const chatId = readString(value);
+    if (!chatId) {
+        return undefined;
+    }
+    if (/^-?\d+$/u.test(chatId)) {
+        const numericId = BigInt(chatId);
+        if (numericId === 0n ||
+            numericId < BigInt(Number.MIN_SAFE_INTEGER) ||
+            numericId > BigInt(Number.MAX_SAFE_INTEGER)) {
+            return undefined;
+        }
+        return numericId.toString();
+    }
+    return TELEGRAM_USERNAME_RE.test(chatId) ? chatId : undefined;
+}
+function telegramBotCommandEntity(text, commandName) {
+    if (!/^[a-z0-9_]{1,32}$/u.test(commandName)) {
+        throw new Error("Telegram native command names must contain 1-32 lowercase letters, digits, or underscores.");
+    }
+    const commandPrefix = `/${commandName}`;
+    const token = text.match(/^\S+/u)?.[0];
+    if (!token ||
+        (token.toLowerCase() !== commandPrefix &&
+            !new RegExp(`^/${commandName}@[A-Za-z][A-Za-z0-9_]{4,31}$`, "iu").test(token))) {
+        throw new Error(`Telegram native command text must start with ${commandPrefix}.`);
+    }
+    return {
+        length: token.length,
+        offset: 0,
+        type: "bot_command",
+    };
+}
+function parseTelegramThreadTargetId(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const trimmed = readString(value);
+    if (!trimmed || !/^[1-9]\d*$/u.test(trimmed)) {
+        throw new Error("Telegram thread target must be a safe positive integer.");
+    }
+    const threadId = Number(trimmed);
+    if (!Number.isSafeInteger(threadId)) {
+        throw new Error("Telegram thread target must be a safe positive integer.");
+    }
+    return threadId;
+}
 export const TELEGRAM_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablineProviderBridge({
     provider: "telegram",
     createAdapter(telegram) {
         return {
-            async probe() {
-                const response = await fetch(`${telegram.endpoints.apiRoot}/bot${telegram.botToken}/getMe`);
+            async probe(signal) {
+                const response = await fetch(`${telegram.endpoints.apiRoot}/bot${telegram.botToken}/getMe`, signal ? { signal } : {});
                 if (!response.ok) {
                     throw new Error(`Crabline Telegram getMe probe failed with HTTP ${response.status}.`);
                 }
-                return await response.json();
+                const payload = await response.json();
+                if (!isRecord(payload) || payload.ok !== true) {
+                    const errorCode = readString(isRecord(payload) ? payload.error_code : undefined);
+                    const description = readNonBlankString(isRecord(payload) ? payload.description : undefined);
+                    const detail = description ?? (errorCode ? `error ${errorCode}` : "invalid response");
+                    throw new Error(`Crabline Telegram getMe probe failed: ${detail}.`);
+                }
+                const result = payload.result;
+                if (!isRecord(result) ||
+                    typeof result.id !== "number" ||
+                    !Number.isSafeInteger(result.id) ||
+                    result.id <= 0 ||
+                    result.is_bot !== true ||
+                    !readNonBlankString(result.first_name) ||
+                    (result.username !== undefined &&
+                        (typeof result.username !== "string" ||
+                            !TELEGRAM_USERNAME_RE.test(`@${result.username}`)))) {
+                    throw new Error("Crabline Telegram getMe probe failed: invalid response.");
+                }
+                return payload;
             },
             createBinding() {
                 return {
@@ -75,8 +165,12 @@ export const TELEGRAM_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                 };
             },
             createAgentDelivery(parsed) {
-                const chatId = normalizeTelegramChatId(parsed.kind, parsed.id);
-                const threadId = readInteger(parsed.threadId);
+                const kind = parsed.native &&
+                    (/^-\d+$/u.test(parsed.id.trim()) || TELEGRAM_USERNAME_RE.test(parsed.id.trim()))
+                    ? "group"
+                    : parsed.kind;
+                const chatId = normalizeTelegramChatId(kind, parsed.id);
+                const threadId = parseTelegramThreadTargetId(parsed.threadId);
                 const to = telegramTargetKey(chatId, threadId);
                 return {
                     channel: "telegram",
@@ -88,23 +182,17 @@ export const TELEGRAM_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
             createInbound(input) {
                 const kind = input.conversation.kind === "direct" ? "direct" : "group";
                 const chatId = normalizeTelegramChatId(kind, input.conversation.id);
-                const threadId = readInteger(input.threadId);
+                const threadId = parseTelegramThreadTargetId(input.threadId);
                 return {
                     ...createAdminInboundRequest(telegram),
                     providerBody: {
                         chatId,
-                        fromId: readInteger(input.senderId) ?? TELEGRAM_DEFAULT_SENDER_ID,
+                        fromId: Number(normalizeTelegramChatId("direct", input.senderId)),
                         fromName: input.senderName ?? input.senderId,
                         ...(threadId !== undefined ? { messageThreadId: threadId } : {}),
                         ...(input.nativeCommand
                             ? {
-                                entities: [
-                                    {
-                                        length: input.nativeCommand.name.length + 1,
-                                        offset: 0,
-                                        type: "bot_command",
-                                    },
-                                ],
+                                entities: [telegramBotCommandEntity(input.text, input.nativeCommand.name)],
                             }
                             : {}),
                         text: input.text,
@@ -122,18 +210,24 @@ export const TELEGRAM_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                 if (!isRecord(event) || event.type !== "api" || typeof event.path !== "string") {
                     return null;
                 }
-                const method = TELEGRAM_OUTBOUND_METHOD_RE.exec(event.path)?.[1];
+                const method = TELEGRAM_OUTBOUND_METHOD_RE.exec(event.path)?.[1]?.toLowerCase();
                 if (!method || !isRecord(event.body)) {
                     return null;
                 }
-                const chatId = readString(event.body.chat_id);
-                const text = method === "sendMessage" && typeof event.body.text === "string" && event.body.text.trim()
-                    ? event.body.text
-                    : readString(event.body.caption);
+                const chatId = canonicalTelegramRecorderChatId(event.body.chat_id);
+                const text = method === "sendmessage"
+                    ? readNonBlankString(event.body.text)
+                    : readNonBlankString(event.body.caption);
                 if (!chatId || !text) {
                     return null;
                 }
-                const threadId = readInteger(event.body.message_thread_id);
+                let threadId;
+                try {
+                    threadId = parseTelegramThreadTargetId(event.body.message_thread_id);
+                }
+                catch {
+                    return null;
+                }
                 const providerTargetKey = telegramTargetKey(chatId, threadId);
                 return {
                     accountId: DEFAULT_ACCOUNT_ID,

package/dist/src/openclaw/bridges/telegram.js.map

@@ -1 +1 @@
-{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../../src/openclaw/bridges/telegram.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../../src/openclaw/bridges/telegram.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  createAdminInboundRequest,\n  createOpenClawCrablineProviderBridge,\n  DEFAULT_ACCOUNT_ID,\n  isRecord,\n  qaTargetForInbound,\n  readNonBlankString,\n  readString,\n} from \"../shared.js\";\n\nconst TELEGRAM_SYMBOLIC_DIRECT_ID_BASE = 1n << 51n;\nconst TELEGRAM_SYMBOLIC_DIRECT_ID_MASK = TELEGRAM_SYMBOLIC_DIRECT_ID_BASE - 1n;\nconst TELEGRAM_SYMBOLIC_GROUP_ID_BASE = 1_000_000_000_000n;\nconst TELEGRAM_SYMBOLIC_GROUP_ID_RANGE = 10_000_000_000n;\nconst TELEGRAM_OUTBOUND_METHOD_RE =\n  /\\/(sendAnimation|sendAudio|sendDocument|sendMessage|sendPhoto|sendVideo)$/iu;\nconst TELEGRAM_USERNAME_RE = /^@[A-Za-z][A-Za-z0-9_]{3,31}$/u;\n\nfunction normalizeTelegramChatId(kind: \"direct\" | \"group\", id: string): string {\n  const value = id.trim();\n  if (!value) {\n    throw new Error(\"Telegram target is required.\");\n  }\n  if (/^-?\\d+$/u.test(value)) {\n    const numericId = BigInt(value);\n    if (numericId === 0n || (kind === \"direct\" ? numericId < 0n : numericId > 0n)) {\n      throw new Error(\"Telegram numeric target sign does not match the declared target kind.\");\n    }\n    if (\n      numericId < BigInt(Number.MIN_SAFE_INTEGER) ||\n      numericId > BigInt(Number.MAX_SAFE_INTEGER)\n    ) {\n      throw new Error(\"Telegram numeric target must be a safe integer.\");\n    }\n    return numericId.toString();\n  }\n  if (kind === \"group\" && TELEGRAM_USERNAME_RE.test(value)) {\n    return value;\n  }\n  if (value.startsWith(\"@\")) {\n    throw new Error(\"Telegram usernames must contain 4-32 letters, digits, or underscores.\");\n  }\n  const hash = createHash(\"sha256\").update(`${kind}:${value}`).digest().readBigUInt64BE();\n  if (kind === \"group\") {\n    return String(-(TELEGRAM_SYMBOLIC_GROUP_ID_BASE + (hash % TELEGRAM_SYMBOLIC_GROUP_ID_RANGE)));\n  }\n  return String(TELEGRAM_SYMBOLIC_DIRECT_ID_BASE + (hash & TELEGRAM_SYMBOLIC_DIRECT_ID_MASK));\n}\n\nfunction telegramTargetKey(chatId: string, threadId?: number) {\n  return threadId === undefined ? chatId : `${chatId}:topic:${threadId}`;\n}\n\nfunction canonicalTelegramRecorderChatId(value: unknown): string | undefined {\n  const chatId = readString(value);\n  if (!chatId) {\n    return undefined;\n  }\n  if (/^-?\\d+$/u.test(chatId)) {\n    const numericId = BigInt(chatId);\n    if (\n      numericId === 0n ||\n      numericId < BigInt(Number.MIN_SAFE_INTEGER) ||\n      numericId > BigInt(Number.MAX_SAFE_INTEGER)\n    ) {\n      return undefined;\n    }\n    return numericId.toString();\n  }\n  return TELEGRAM_USERNAME_RE.test(chatId) ? chatId : undefined;\n}\n\nfunction telegramBotCommandEntity(text: string, commandName: string) {\n  if (!/^[a-z0-9_]{1,32}$/u.test(commandName)) {\n    throw new Error(\n      \"Telegram native command names must contain 1-32 lowercase letters, digits, or underscores.\",\n    );\n  }\n  const commandPrefix = `/${commandName}`;\n  const token = text.match(/^\\S+/u)?.[0];\n  if (\n    !token ||\n    (token.toLowerCase() !== commandPrefix &&\n      !new RegExp(`^/${commandName}@[A-Za-z][A-Za-z0-9_]{4,31}$`, \"iu\").test(token))\n  ) {\n    throw new Error(`Telegram native command text must start with ${commandPrefix}.`);\n  }\n  return {\n    length: token.length,\n    offset: 0,\n    type: \"bot_command\",\n  } as const;\n}\n\nfunction parseTelegramThreadTargetId(value: unknown): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n  const trimmed = readString(value);\n  if (!trimmed || !/^[1-9]\\d*$/u.test(trimmed)) {\n    throw new Error(\"Telegram thread target must be a safe positive integer.\");\n  }\n  const threadId = Number(trimmed);\n  if (!Number.isSafeInteger(threadId)) {\n    throw new Error(\"Telegram thread target must be a safe positive integer.\");\n  }\n  return threadId;\n}\n\nexport const TELEGRAM_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablineProviderBridge({\n  provider: \"telegram\",\n  createAdapter(telegram) {\n    return {\n      async probe(signal) {\n        const response = await fetch(\n          `${telegram.endpoints.apiRoot}/bot${telegram.botToken}/getMe`,\n          signal ? { signal } : {},\n        );\n        if (!response.ok) {\n          throw new Error(`Crabline Telegram getMe probe failed with HTTP ${response.status}.`);\n        }\n        const payload: unknown = await response.json();\n        if (!isRecord(payload) || payload.ok !== true) {\n          const errorCode = readString(isRecord(payload) ? payload.error_code : undefined);\n          const description = readNonBlankString(\n            isRecord(payload) ? payload.description : undefined,\n          );\n          const detail = description ?? (errorCode ? `error ${errorCode}` : \"invalid response\");\n          throw new Error(`Crabline Telegram getMe probe failed: ${detail}.`);\n        }\n        const result = payload.result;\n        if (\n          !isRecord(result) ||\n          typeof result.id !== \"number\" ||\n          !Number.isSafeInteger(result.id) ||\n          result.id <= 0 ||\n          result.is_bot !== true ||\n          !readNonBlankString(result.first_name) ||\n          (result.username !== undefined &&\n            (typeof result.username !== \"string\" ||\n              !TELEGRAM_USERNAME_RE.test(`@${result.username}`)))\n        ) {\n          throw new Error(\"Crabline Telegram getMe probe failed: invalid response.\");\n        }\n        return payload;\n      },\n      createBinding() {\n        return {\n          accountId: DEFAULT_ACCOUNT_ID,\n          channel: \"telegram\",\n          createChannelDriverSmokeEnv: (env) => ({\n            ...env,\n            TELEGRAM_BOT_TOKEN: telegram.botToken,\n          }),\n          createGatewayConfig: (openclawConfig = {}) => {\n            const channels = isRecord(openclawConfig.channels) ? openclawConfig.channels : {};\n            const telegramConfig = isRecord(channels.telegram) ? channels.telegram : {};\n            const groups = isRecord(telegramConfig.groups) ? telegramConfig.groups : {};\n            const defaultGroup = isRecord(groups[\"*\"]) ? groups[\"*\"] : {};\n            const messages = isRecord(openclawConfig.messages) ? openclawConfig.messages : {};\n            const groupChat = isRecord(messages.groupChat) ? messages.groupChat : {};\n\n            return {\n              ...openclawConfig,\n              channels: {\n                ...channels,\n                telegram: {\n                  ...telegramConfig,\n                  enabled: true,\n                  botToken: telegram.botToken,\n                  apiRoot: telegram.endpoints.apiRoot,\n                  dmPolicy: \"open\",\n                  groupPolicy: \"open\",\n                  allowFrom: [\"*\"],\n                  groupAllowFrom: [\"*\"],\n                  groups: {\n                    ...groups,\n                    \"*\": {\n                      ...defaultGroup,\n                      requireMention: false,\n                    },\n                  },\n                },\n              },\n              messages: {\n                ...messages,\n                groupChat: {\n                  ...groupChat,\n                  mentionPatterns: [\"\\\\b@?openclaw\\\\b\"],\n                  visibleReplies: \"automatic\",\n                },\n              },\n            };\n          },\n          requiredPluginIds: [\"telegram\"],\n        };\n      },\n      createAgentDelivery(parsed) {\n        const kind =\n          parsed.native &&\n          (/^-\\d+$/u.test(parsed.id.trim()) || TELEGRAM_USERNAME_RE.test(parsed.id.trim()))\n            ? \"group\"\n            : parsed.kind;\n        const chatId = normalizeTelegramChatId(kind, parsed.id);\n        const threadId = parseTelegramThreadTargetId(parsed.threadId);\n        const to = telegramTargetKey(chatId, threadId);\n        return {\n          channel: \"telegram\",\n          to,\n          replyChannel: \"telegram\",\n          replyTo: to,\n        };\n      },\n      createInbound(input) {\n        const kind = input.conversation.kind === \"direct\" ? \"direct\" : \"group\";\n        const chatId = normalizeTelegramChatId(kind, input.conversation.id);\n        const threadId = parseTelegramThreadTargetId(input.threadId);\n        return {\n          ...createAdminInboundRequest(telegram),\n          providerBody: {\n            chatId,\n            fromId: Number(normalizeTelegramChatId(\"direct\", input.senderId)),\n            fromName: input.senderName ?? input.senderId,\n            ...(threadId !== undefined ? { messageThreadId: threadId } : {}),\n            ...(input.nativeCommand\n              ? {\n                  entities: [telegramBotCommandEntity(input.text, input.nativeCommand.name)],\n                }\n              : {}),\n            text: input.text,\n          },\n          providerTargetKey: telegramTargetKey(chatId, threadId),\n          qaTarget: qaTargetForInbound(input),\n          stateConversation: {\n            id: chatId,\n            kind: kind === \"group\" ? \"group\" : \"direct\",\n          },\n          ...(threadId !== undefined ? { threadId: String(threadId) } : {}),\n        };\n      },\n      createOutboundFromRecorderEvent({ event, targetByProviderTarget }) {\n        if (!isRecord(event) || event.type !== \"api\" || typeof event.path !== \"string\") {\n          return null;\n        }\n        const method = TELEGRAM_OUTBOUND_METHOD_RE.exec(event.path)?.[1]?.toLowerCase();\n        if (!method || !isRecord(event.body)) {\n          return null;\n        }\n        const chatId = canonicalTelegramRecorderChatId(event.body.chat_id);\n        const text =\n          method === \"sendmessage\"\n            ? readNonBlankString(event.body.text)\n            : readNonBlankString(event.body.caption);\n        if (!chatId || !text) {\n          return null;\n        }\n        let threadId: number | undefined;\n        try {\n          threadId = parseTelegramThreadTargetId(event.body.message_thread_id);\n        } catch {\n          return null;\n        }\n        const providerTargetKey = telegramTargetKey(chatId, threadId);\n        return {\n          accountId: DEFAULT_ACCOUNT_ID,\n          senderId: \"openclaw\",\n          senderName: \"OpenClaw QA\",\n          text,\n          to:\n            targetByProviderTarget.get(providerTargetKey) ??\n            (threadId === undefined ? chatId : providerTargetKey),\n        };\n      },\n    };\n  },\n});\n"]}

package/dist/src/openclaw/bridges/whatsapp.js

@@ -1,22 +1,49 @@
-import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readString, } from "../shared.js";
-const WHATSAPP_JID_RE = /^(?:\d{7,15}(?::\d+)?@s\.whatsapp\.net|\d{7,15}@c\.us|\d{5,}@g\.us|\d{7,15}@lid)$/iu;
-function requireWhatsAppJid(value, label) {
-    const trimmed = value.trim();
-    if (!WHATSAPP_JID_RE.test(trimmed)) {
+import { createAdminInboundRequest, createOpenClawCrablineProviderBridge, DEFAULT_ACCOUNT_ID, isRecord, qaTargetForInbound, readNonBlankString, readString, } from "../shared.js";
+import { canonicalizeWhatsAppChatJid, canonicalizeWhatsAppUserCorrelationJid, canonicalizeWhatsAppUserJid, } from "../../servers/whatsapp-jid.js";
+function requireWhatsAppJid(value, label, userOnly = false) {
+    const canonical = userOnly
+        ? canonicalizeWhatsAppUserJid(value)
+        : canonicalizeWhatsAppChatJid(value);
+    if (!canonical) {
         throw new Error(`${label} must be a native WhatsApp JID.`);
     }
-    return trimmed;
+    return canonical;
+}
+function requireWhatsAppTargetKind(parsed, targetId) {
+    if (parsed.native) {
+        return;
+    }
+    const nativeKind = targetId.endsWith("@g.us") ? "group" : "direct";
+    if (parsed.kind !== nativeKind) {
+        throw new Error("WhatsApp target kind does not match the native JID.");
+    }
+}
+function requireWhatsAppConversationKind(kind, targetId) {
+    const nativeKind = targetId.endsWith("@g.us") ? "group" : "direct";
+    if (kind !== nativeKind) {
+        throw new Error("WhatsApp inbound conversation kind does not match the native JID.");
+    }
 }
 export const WHATSAPP_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrablineProviderBridge({
     provider: "whatsapp",
     createAdapter(whatsapp) {
+        const messagesPath = new URL(whatsapp.endpoints.messagesUrl).pathname;
         return {
-            async probe() {
-                const response = await fetch(`${whatsapp.endpoints.apiRoot}/health`);
+            async probe(signal) {
+                const response = await fetch(whatsapp.endpoints.phoneNumberUrl, {
+                    headers: {
+                        authorization: `Bearer ${whatsapp.accessToken}`,
+                    },
+                    ...(signal ? { signal } : {}),
+                });
                 if (!response.ok) {
-                    throw new Error(`Crabline WhatsApp health probe failed with HTTP ${response.status}.`);
+                    throw new Error(`Crabline WhatsApp probe failed with HTTP ${response.status}.`);
                 }
-                return await response.json();
+                const payload = await response.json();
+                if (!isRecord(payload) || readString(payload.id) !== whatsapp.phoneNumberId) {
+                    throw new Error("Crabline WhatsApp probe returned an unexpected phone number.");
+                }
+                return payload;
             },
             createBinding() {
                 return {
@@ -60,7 +87,14 @@ export const WHATSAPP_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                 };
             },
             createAgentDelivery(parsed) {
+                if (parsed.threadId !== undefined) {
+                    throw new Error("WhatsApp does not support thread targets.");
+                }
                 const to = requireWhatsAppJid(parsed.id, "WhatsApp target");
+                requireWhatsAppTargetKind(parsed, to);
+                if (to.endsWith("@g.us")) {
+                    throw new Error("WhatsApp Crabline WebSocket outbound supports direct targets only.");
+                }
                 return {
                     channel: "whatsapp",
                     to,
@@ -69,8 +103,12 @@ export const WHATSAPP_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                 };
             },
             createInbound(input) {
+                if (input.threadId !== undefined) {
+                    throw new Error("WhatsApp does not support thread targets.");
+                }
                 const chatJid = requireWhatsAppJid(input.conversation.id, "WhatsApp conversation");
-                const senderJid = requireWhatsAppJid(input.senderId, "WhatsApp sender");
+                requireWhatsAppConversationKind(input.conversation.kind, chatJid);
+                const senderJid = requireWhatsAppJid(input.senderId, "WhatsApp sender", true);
                 return {
                     ...createAdminInboundRequest(whatsapp),
                     providerBody: {
@@ -80,7 +118,10 @@ export const WHATSAPP_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                         text: input.text,
                     },
                     providerTargetKey: chatJid,
-                    qaTarget: qaTargetForInbound(input),
+                    qaTarget: qaTargetForInbound({
+                        ...input,
+                        conversation: { ...input.conversation, id: chatJid },
+                    }),
                     stateConversation: {
                         id: chatJid,
                         kind: chatJid.endsWith("@g.us") ? "group" : "direct",
@@ -88,24 +129,44 @@ export const WHATSAPP_OPENCLAW_CRABLINE_PROVIDER_BRIDGE = createOpenClawCrabline
                 };
             },
             createOutboundFromRecorderEvent({ event, targetByProviderTarget }) {
-                if (!isRecord(event) || event.type !== "api" || typeof event.path !== "string") {
+                if (!isRecord(event) ||
+                    event.type !== "api" ||
+                    event.accepted !== true ||
+                    typeof event.path !== "string") {
                     return null;
                 }
-                if (!event.path.endsWith("/crabline/whatsapp/messages") || !isRecord(event.body)) {
+                if (!isRecord(event.body)) {
                     return null;
                 }
-                const to = readString(event.body.to ?? event.body.jid);
+                const baileysKey = isRecord(event.body.key) ? event.body.key : undefined;
+                const baileysMessage = isRecord(event.body.message) ? event.body.message : undefined;
+                const isBaileysSend = event.method === "WEBSOCKET" && event.path === "/ws/chat";
+                if (!isBaileysSend && event.path !== messagesPath) {
+                    return null;
+                }
+                const to = isBaileysSend ? readString(baileysKey?.remoteJid) : readString(event.body.to);
                 const textPayload = event.body.text;
-                const text = isRecord(textPayload) ? readString(textPayload.body) : readString(textPayload);
+                const text = isBaileysSend
+                    ? readNonBlankString(baileysMessage?.conversation)
+                    : isRecord(textPayload)
+                        ? readNonBlankString(textPayload.body)
+                        : undefined;
                 if (!to || !text) {
                     return null;
                 }
+                const providerTarget = isBaileysSend
+                    ? canonicalizeWhatsAppUserCorrelationJid(to)
+                    : (canonicalizeWhatsAppChatJid(to) ??
+                        (/^\d{7,15}$/u.test(to) ? `${to}@s.whatsapp.net` : to));
+                if (!providerTarget) {
+                    return null;
+                }
                 return {
                     accountId: DEFAULT_ACCOUNT_ID,
                     senderId: "openclaw",
                     senderName: "OpenClaw QA",
                     text,
-                    to: targetByProviderTarget.get(to) ?? to,
+                    to: targetByProviderTarget.get(providerTarget) ?? providerTarget,
                 };
             },
         };