clawgram 2.14.0 → 2.17.0

package/dist/normalize.js

@@ -4,6 +4,7 @@ exports.toStringId = toStringId;
 exports.toPeerChatId = toPeerChatId;
 exports.toPeerChannelId = toPeerChannelId;
 exports.normalizeTelegramEvent = normalizeTelegramEvent;
+const helpers_1 = require("./helpers");
 function toStringId(value) {
     if (value === null || value === undefined)
         return undefined;
@@ -106,11 +107,10 @@ function normalizeTelegramEvent(event, accountId) {
             ? msg.text
             : undefined;
     const chatType = inferTelegramChatType(msg, chatId);
-    const senderUsername = typeof msg.sender?.username === "string"
-        ? msg.sender.username
-        : typeof msg._sender?.username === "string"
-            ? msg._sender.username
-            : undefined;
+    // Not the raw field: a sender holding several handles (or a collectible one)
+    // keeps them in `usernames[]` and leaves `username` empty, so an allowFrom
+    // entry written as `@handle` would silently never match that person.
+    const senderUsername = (0, helpers_1.resolveActiveUsername)(msg.sender) ?? (0, helpers_1.resolveActiveUsername)(msg._sender);
     const senderDisplay = typeof msg.sender?.firstName === "string"
         ? [msg.sender.firstName, msg.sender.lastName].filter(Boolean).join(" ").trim()
         : typeof msg._sender?.firstName === "string"

package/dist/topics.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOPICS_MAX_LIMIT = exports.TOPICS_DEFAULT_LIMIT = void 0;
+exports.parseTopicsParams = parseTopicsParams;
+exports.normalizeForumTopics = normalizeForumTopics;
+/**
+ * Forum topics — the names a supergroup organises itself by.
+ *
+ * A forum chat addresses replies by topic, and `chatInfo` can only say *that*
+ * a chat is a forum. Everything else about a topic reached the assistant as a
+ * bare number lifted off an inbound message, so a person could ask it to work
+ * in "Визитка - представление" and it had no way to turn that name into an id —
+ * or to know the topic existed before somebody wrote in it.
+ *
+ * Parsing and shaping are pure so they can be tested without a Telegram
+ * client; the transport lives in `GramJsClientManager.listTopics`.
+ */
+const normalize_js_1 = require("./normalize.js");
+exports.TOPICS_DEFAULT_LIMIT = 100;
+exports.TOPICS_MAX_LIMIT = 500;
+function parseTopicsParams(params) {
+    const rawTarget = params.chatId ?? params.target ?? params.to ?? params.chat;
+    const target = typeof rawTarget === "string" ? rawTarget.trim() : "";
+    if (!target) {
+        throw new Error("clawgram: topics requires a chatId");
+    }
+    const rawQuery = params.query ?? params.search ?? params.title;
+    const trimmedQuery = typeof rawQuery === "string" ? rawQuery.trim() : "";
+    const query = trimmedQuery.length > 0 ? trimmedQuery : undefined;
+    const rawLimit = params.limit;
+    if (rawLimit === undefined || rawLimit === null || rawLimit === "") {
+        return { target, limit: exports.TOPICS_DEFAULT_LIMIT, query };
+    }
+    const parsed = Number(rawLimit);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error("clawgram: topics limit must be a positive number");
+    }
+    return { target, limit: Math.min(Math.floor(parsed), exports.TOPICS_MAX_LIMIT), query };
+}
+/** Telegram sends flags only when they are set; an absent flag is not `false`. */
+function optionalFlag(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+function matchesQuery(title, query) {
+    if (!query)
+        return true;
+    return title.toLocaleLowerCase().includes(query.toLocaleLowerCase());
+}
+/**
+ * `channels.getForumTopics` returns live topics and tombstones in one list.
+ * A `ForumTopicDeleted` carries an id and nothing else: it cannot be named,
+ * so it is dropped rather than surfaced as a topic with a blank title.
+ */
+function normalizeForumTopics(raw, options = {}) {
+    if (!Array.isArray(raw))
+        return [];
+    const topics = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== "object")
+            continue;
+        const candidate = entry;
+        const title = typeof candidate.title === "string" ? candidate.title : undefined;
+        const topicId = (0, normalize_js_1.toStringId)(candidate.id);
+        if (!title || !topicId)
+            continue;
+        if (!matchesQuery(title, options.query))
+            continue;
+        const topic = { topicId, title };
+        const topMessageId = (0, normalize_js_1.toStringId)(candidate.topMessage);
+        if (topMessageId !== undefined)
+            topic.topMessageId = topMessageId;
+        const closed = optionalFlag(candidate.closed);
+        if (closed !== undefined)
+            topic.closed = closed;
+        const hidden = optionalFlag(candidate.hidden);
+        if (hidden !== undefined)
+            topic.hidden = hidden;
+        const pinned = optionalFlag(candidate.pinned);
+        if (pinned !== undefined)
+            topic.pinned = pinned;
+        topics.push(topic);
+    }
+    return topics;
+}

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.14.0",
+  "version": "2.17.0",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -69,6 +69,69 @@
                       }
                     ]
                   }
+                },
+                "tools": {
+                  "type": "object",
+                  "additionalProperties": false,
+                  "properties": {
+                    "allow": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "alsoAllow": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "deny": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  }
+                },
+                "toolsBySender": {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "properties": {
+                      "allow": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "alsoAllow": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "deny": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      }
+                    }
+                  }
+                },
+                "skills": {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "systemPrompt": {
+                  "type": "string"
                 }
               }
             }
@@ -311,6 +374,69 @@
                             }
                           ]
                         }
+                      },
+                      "tools": {
+                        "type": "object",
+                        "additionalProperties": false,
+                        "properties": {
+                          "allow": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "alsoAllow": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "deny": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        }
+                      },
+                      "toolsBySender": {
+                        "type": "object",
+                        "propertyNames": {
+                          "type": "string"
+                        },
+                        "additionalProperties": {
+                          "type": "object",
+                          "additionalProperties": false,
+                          "properties": {
+                            "allow": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "alsoAllow": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            },
+                            "deny": {
+                              "type": "array",
+                              "items": {
+                                "type": "string"
+                              }
+                            }
+                          }
+                        }
+                      },
+                      "skills": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        }
+                      },
+                      "systemPrompt": {
+                        "type": "string"
                       }
                     }
                   }
@@ -329,6 +455,10 @@
                   },
                   "description": "Chat ids the account may MANAGE (2.12.0): add/remove members, promote/demote admins, transfer ownership, export invite links; a non-empty list also unlocks createGroup. Opposite default to readChats: absent or empty means chat management is off, [\"*\"] allows every chat."
                 },
+                "discoverChats": {
+                  "type": "boolean",
+                  "description": "Allow the `dialogs` action (2.16.0) to list the group chats this account belongs to — id, title and type only, never direct chats and never message content. Off unless set: it is the one read that deliberately reaches past readChats, because its job is to find chats nobody has configured yet."
+                },
                 "twoFaPassword": {
                   "description": "The account's Telegram 2FA (cloud) password — needed only by transferOwnership, which Telegram guards with an SRP proof. Literal value, or a SecretRef resolved at account start-up.",
                   "anyOf": [
@@ -382,9 +512,10 @@
                   "enum": [
                     "markdown",
                     "md",
-                    "html"
+                    "html",
+                    "none"
                   ],
-                  "description": "Parse mode for replies (2.3.1). The send action takes parseMode per call; the reply pipeline has no per-call slot, so the reply format is configured here. Absent means plain text."
+                  "description": "Outbound format for replies, core-delivered text, captions and send calls that omit parseMode. html (2.15.0) renders agent markdown and Telegram HTML into entities; markdown is GramJS's five-delimiter parser; none disables parsing entirely. Absent keeps GramJS's historical default, which is its markdown parser — not plain text."
                 }
               },
               "required": [
@@ -402,6 +533,26 @@
           "help": "Chat ids the assistant may manage (create groups, add/remove members, admins, ownership, invite links). Leave empty to keep chat management off; use * to allow every chat.",
           "advanced": true
         },
+        "accounts.*.groups.*.tools": {
+          "label": "Group Tool Policy",
+          "help": "Tool allow/alsoAllow/deny for this group. Applies to gateway tools (message, sessions_*, cron, memory_*, …). Under CLI backends such as claude-cli the native exec/read/write tools are not filtered per group — bind the group to a separate agent for that.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.toolsBySender": {
+          "label": "Group Tool Policy by Sender",
+          "help": "Per-sender tool policy inside this group. Keys use core's typed grammar: id:<telegram id>, username:<handle>, name:<display name>, or * as the fallback.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.skills": {
+          "label": "Group Skills",
+          "help": "Skill allowlist for this group. Omit to inherit the agent's skills; [] means no skills in this group.",
+          "advanced": true
+        },
+        "accounts.*.groups.*.systemPrompt": {
+          "label": "Group System Prompt",
+          "help": "Trusted prompt block appended for messages from this group — the place to state what this chat is about and what stays out of it.",
+          "advanced": true
+        },
         "accounts.*.twoFaPassword": {
           "label": "2FA Password",
           "help": "The account's Telegram two-step verification password. Only needed for ownership transfer.",

package/package.json

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