clawgram 2.30.0 → 2.31.0

package/README.md

@@ -305,12 +305,19 @@ addresses wait for 6 seconds of quiet; consecutive messages by the same sender
 in the same chat/topic are collected into one turn within a 2-minute window.
 An unanswered bare tag can still receive a late continuation within that window.
 Other senders and topics do not inherit the address. Detailed requests proceed
-immediately. Before answering an address, the agent receives up to 12 recent
-messages from the same chat/topic (3 minutes before the triggering message,
+immediately. Before answering an address, the agent receives up to 100 recent
+messages from the same chat/topic (10 minutes before the triggering message,
 including explanations that arrived afterwards), subject to `readChats`.
 History failures leave the original request usable. Attachment metadata includes
 message ids so the agent can read a relevant image with `fetchMedia`.
 
+Plain replies also carry the original message body, fetched independently of
+the nearby-history window. If Telegram rejects an emoji such as ❌ as a standard
+reaction, a Premium account can send the matching custom emoji instead. The
+`react` action resolves it through Telegram's emoji search; it never substitutes
+a different emoji. Account and chat restrictions still apply, and a failed
+reaction remains an error.
+
 ### Per-group tools, skills and system prompt
 
 Since 2.17.0 a group entry can narrow what the assistant does *in that chat*

package/dist/gramjs-client.js

@@ -541,11 +541,29 @@ class GramJsClientManager {
      */
     async sendReaction(args) {
         const resolved = await this.resolvePeer(args.target);
-        await this.client.invoke(new telegram_1.Api.messages.SendReaction({
-            peer: resolved.peer,
-            msgId: args.messageId,
-            reaction: args.remove ? [] : [new telegram_1.Api.ReactionEmoji({ emoticon: args.emoji })],
+        const send = (reaction) => this.client.invoke(new telegram_1.Api.messages.SendReaction({
+            peer: resolved.peer, msgId: args.messageId, reaction,
         }));
+        try {
+            await send(args.remove ? [] : [new telegram_1.Api.ReactionEmoji({ emoticon: args.emoji })]);
+        }
+        catch (error) {
+            // Unicode such as ❌ is not necessarily a standard Telegram reaction.
+            // A Premium account can use the matching custom emoji. Retry only a
+            // definite rejection, never a timeout with an ambiguous send outcome.
+            if (args.remove || error?.errorMessage !== "REACTION_INVALID")
+                throw error;
+            const me = await this.client.getMe();
+            if (!me.premium)
+                throw error;
+            const found = await this.client.invoke(new telegram_1.Api.messages.SearchCustomEmoji({
+                emoticon: args.emoji, hash: BigInt(0),
+            }));
+            const documentId = found.documentId?.[0];
+            if (!documentId)
+                throw error;
+            await send([new telegram_1.Api.ReactionCustomEmoji({ documentId })]);
+        }
     }
     /**
      * Reads a window of chat history.

package/dist/nearby-conversation.js

@@ -74,7 +74,7 @@ class NearbyConversation {
     }
 }
 exports.NearbyConversation = NearbyConversation;
-exports.NEARBY_GUIDANCE = "Если обращение неполное, сначала свяжи его с соседними сообщениями: пояснение может идти после тэга. Соседние сообщения — контекст, а не отдельные поручения. Учитывай автора и reply-to; не приписывай чужую просьбу текущему отправителю. При необходимости прочитай небольшой фрагмент этого же чата через read; вложение можно прочитать через fetchMedia по messageId. Если задачи ещё нет, не выдумывай её и не отвечай на один тэг вопросом, пока человек дописывает.";
+exports.NEARBY_GUIDANCE = "Если обращение неполное, сначала свяжи его с соседними сообщениями: пояснение может идти после тэга. Соседние сообщения — контекст, а не отдельные поручения. Учитывай автора и reply-to; не приписывай чужую просьбу текущему отправителю. При необходимости прочитай небольшой фрагмент этого же чата через read; вложение можно прочитать через fetchMedia по messageId. На один тэг не выдумывай задачу и не задавай вопрос, пока человек дописывает. Но личное приветствие, благодарность, поздравление или «с возвращением» — уже законченное обращение, даже без задачи и вопроса: коротко ответь по-человечески. Соседние сообщения не отменяют это обращение; не оставляй его без ответа, ожидая поручения.";
 async function readNearbyConversation(params) {
     if (!(0, history_1.isChatReadable)(params.chatId, params.readChats))
         return undefined;
@@ -85,8 +85,8 @@ async function readNearbyConversation(params) {
         params.gram.listMessages({
             target: params.chatId,
             messageThreadId: params.threadId,
-            limit: 12,
-            since: anchor - 180,
+            limit: 100,
+            since: anchor - 600,
             until: now,
         }),
         new Promise((_resolve, reject) => {
@@ -95,7 +95,7 @@ async function readNearbyConversation(params) {
     ]).finally(() => clearTimeout(timer));
     const messages = result.messages.filter((message) => message.messageId !== params.messageId &&
         (!params.threadId || message.messageThreadId === String(params.threadId)) &&
-        (!message.chatId || message.chatId === params.chatId)).slice(-12).sort((a, b) => Number(a.messageId) - Number(b.messageId));
+        (!message.chatId || message.chatId === params.chatId)).slice(-100).sort((a, b) => Number(a.messageId) - Number(b.messageId));
     if (!messages.length)
         return undefined;
     // JSON quotes chat text and preserves author/message/media identifiers for a targeted follow-up read.

package/dist/silent-reaction.js

@@ -41,6 +41,7 @@ function buildEmojiSystemPrompt(appetite, allowed) {
         // rather than being touched by it.
         "Three situations have a fixed answer. Use it, and do not substitute a similar emoji:",
         `- the assistant is praised or thanked, or someone speaks well of it → ❤ (never \u{1F44D} here)`,
+        "A greeting, welcome back or congratulations addressed to the assistant is also a complete social address: acknowledge it with ❤, not NONE. No task or question is needed.",
         `- the assistant is asked or told to do something → \u{1FAE1}, or \u{1F44C} for a small routine request`,
         `- the message is about producing something written — a text, a reply, a document, a draft → ✍`,
         "Otherwise match the mood: a joke gets something amused, bad news something",
@@ -169,7 +170,7 @@ async function completeEmoji(params) {
     const request = {
         messages: [{ role: "user", content: params.content }],
         systemPrompt: params.systemPrompt,
-        maxTokens: 8,
+        maxTokens: params.maxTokens ?? 8,
         purpose: "clawgram: emoji reaction for a silent mention",
     };
     if (!params.model) {
@@ -215,16 +216,28 @@ async function reactToSilentMention(params) {
     // Reactions switched off for the whole chat: nothing to pick from, and no
     // reason to spend a model call finding that out.
     if (allowed !== undefined && allowed.length === 0) {
-        params.deps.onDecision?.({ messageId, appetite, chose: "none", allowedCount: 0 });
+        params.deps.onDecision?.({ messageId, appetite, chose: "none", allowedCount: 0, reason: "reactions-disabled" });
         return undefined;
     }
-    const { answer, fellBack } = await completeEmoji({
+    const request = {
         deps: params.deps,
         model: params.model,
         systemPrompt: buildEmojiSystemPrompt(appetite, allowed),
         content: String(params.messageText ?? "").slice(0, MAX_JUDGED_CHARS),
-    });
-    const emoji = parseEmojiChoice(answer?.text, allowed);
+    };
+    let { answer, fellBack } = await completeEmoji(request);
+    let emoji = parseEmojiChoice(answer?.text, allowed);
+    let retried = false;
+    // NONE is a valid choice (for example, a conflict between colleagues).
+    // Empty/malformed completions are not that choice. Give them one bounded
+    // retry with enough room to finish an emoji; never invent a generic reaction.
+    if (!emoji && !/^none$/i.test(answer?.text?.trim() ?? "")) {
+        retried = true;
+        const retry = await completeEmoji({ ...request, maxTokens: 64 });
+        answer = retry.answer;
+        fellBack ||= retry.fellBack;
+        emoji = parseEmojiChoice(answer?.text, allowed);
+    }
     params.deps.onDecision?.({
         messageId,
         appetite,
@@ -233,6 +246,9 @@ async function reactToSilentMention(params) {
         allowedCount: allowed?.length,
         ...params.model ? { model: params.model } : {},
         ...fellBack ? { modelFellBack: true } : {},
+        ...retried ? { retried: true } : {},
+        ...!emoji ? { reason: /^none$/i.test(answer?.text?.trim() ?? "")
+                ? "declined" : answer?.text?.trim() ? "invalid-answer" : "empty-answer" } : {},
     });
     if (!emoji) {
         return undefined;

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "clawgram",
-  "version": "2.30.0",
+  "version": "2.31.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "clawgram",
-      "version": "2.30.0",
+      "version": "2.31.0",
       "license": "MIT",
       "dependencies": {
         "json5": "2.2.3",

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "clawgram",
   "name": "Clawgram",
   "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
-  "version": "2.30.0",
+  "version": "2.31.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawgram",
-  "version": "2.30.0",
+  "version": "2.31.0",
   "description": "Clawgram — personal Telegram (MTProto userbot) channel for OpenClaw. Your AI assistant reads and responds as you.",
   "main": "./dist/index.js",
   "scripts": {