506bed5aed
Add support for receiving and sending Telegram stickers:
Inbound:
- Receive static WEBP stickers (skip animated/video)
- Process stickers through dedicated vision call for descriptions
- Cache vision descriptions to avoid repeated API calls
- Graceful error handling for fetch failures
Outbound:
- Add sticker action to send stickers by fileId
- Add sticker-search action to find cached stickers by query
- Accept stickerId from shared schema, convert to fileId
Cache:
- Store sticker metadata (fileId, emoji, setName, description)
- Fuzzy search by description, emoji, and set name
- Persist to ~/.clawdbot/telegram/sticker-cache.json
Config:
- Single `channels.telegram.actions.sticker` option enables both
send and search actions
🤖 AI-assisted: Built with Claude Code (claude-opus-4-5)
Testing: Fully tested - unit tests pass, live tested on dev gateway
The contributor understands and has reviewed all code changes.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
90 lines
2.6 KiB
TypeScript
90 lines
2.6 KiB
TypeScript
import type { ChannelMessageActionName } from "../../channels/plugins/types.js";
|
|
|
|
export type MessageActionTargetMode = "to" | "channelId" | "none";
|
|
|
|
export const MESSAGE_ACTION_TARGET_MODE: Record<ChannelMessageActionName, MessageActionTargetMode> =
|
|
{
|
|
send: "to",
|
|
broadcast: "none",
|
|
poll: "to",
|
|
react: "to",
|
|
reactions: "to",
|
|
read: "to",
|
|
edit: "to",
|
|
unsend: "to",
|
|
reply: "to",
|
|
sendWithEffect: "to",
|
|
renameGroup: "to",
|
|
setGroupIcon: "to",
|
|
addParticipant: "to",
|
|
removeParticipant: "to",
|
|
leaveGroup: "to",
|
|
sendAttachment: "to",
|
|
delete: "to",
|
|
pin: "to",
|
|
unpin: "to",
|
|
"list-pins": "to",
|
|
permissions: "to",
|
|
"thread-create": "to",
|
|
"thread-list": "none",
|
|
"thread-reply": "to",
|
|
search: "none",
|
|
sticker: "to",
|
|
"sticker-search": "none",
|
|
"member-info": "none",
|
|
"role-info": "none",
|
|
"emoji-list": "none",
|
|
"emoji-upload": "none",
|
|
"sticker-upload": "none",
|
|
"role-add": "none",
|
|
"role-remove": "none",
|
|
"channel-info": "channelId",
|
|
"channel-list": "none",
|
|
"channel-create": "none",
|
|
"channel-edit": "channelId",
|
|
"channel-delete": "channelId",
|
|
"channel-move": "channelId",
|
|
"category-create": "none",
|
|
"category-edit": "none",
|
|
"category-delete": "none",
|
|
"voice-status": "none",
|
|
"event-list": "none",
|
|
"event-create": "none",
|
|
timeout: "none",
|
|
kick: "none",
|
|
ban: "none",
|
|
};
|
|
|
|
const ACTION_TARGET_ALIASES: Partial<Record<ChannelMessageActionName, string[]>> = {
|
|
unsend: ["messageId"],
|
|
edit: ["messageId"],
|
|
react: ["chatGuid", "chatIdentifier", "chatId"],
|
|
renameGroup: ["chatGuid", "chatIdentifier", "chatId"],
|
|
setGroupIcon: ["chatGuid", "chatIdentifier", "chatId"],
|
|
addParticipant: ["chatGuid", "chatIdentifier", "chatId"],
|
|
removeParticipant: ["chatGuid", "chatIdentifier", "chatId"],
|
|
leaveGroup: ["chatGuid", "chatIdentifier", "chatId"],
|
|
};
|
|
|
|
export function actionRequiresTarget(action: ChannelMessageActionName): boolean {
|
|
return MESSAGE_ACTION_TARGET_MODE[action] !== "none";
|
|
}
|
|
|
|
export function actionHasTarget(
|
|
action: ChannelMessageActionName,
|
|
params: Record<string, unknown>,
|
|
): boolean {
|
|
const to = typeof params.to === "string" ? params.to.trim() : "";
|
|
if (to) return true;
|
|
const channelId = typeof params.channelId === "string" ? params.channelId.trim() : "";
|
|
if (channelId) return true;
|
|
const aliases = ACTION_TARGET_ALIASES[action];
|
|
if (!aliases) return false;
|
|
return aliases.some((alias) => {
|
|
const value = params[alias];
|
|
if (typeof value === "string") return value.trim().length > 0;
|
|
if (typeof value === "number") return Number.isFinite(value);
|
|
return false;
|
|
});
|
|
}
|