@craftsamo/telegram-tools 0.1.0 → 0.2.0

package/dist/mcp.js

@@ -29341,6 +29341,7 @@ function lockHolder(path) {
 }
 
 // src/core/time.ts
+var MS_PER_S = 1e3;
 var MS_PER_MINUTE = 6e4;
 var MINUTES_PER_HOUR = 60;
 var localOffsetMinutes = (ms) => -new Date(ms).getTimezoneOffset();
@@ -30055,7 +30056,6 @@ async function callService(socketPath, method, params, options) {
 // src/core/chat/live.ts
 var REFRESH_TIMEOUT_MS = 12e4;
 var FETCH_TIMEOUT_MS = 18e4;
-var MS_PER_S = 1e3;
 function requestHistory(socket, params, signal) {
   return callService(socket, SERVICE_REQUESTS.history, params, { effect: "read", signal });
 }
@@ -30183,113 +30183,6 @@ var messageEntry = external_exports.object({
   private_note: external_exports.string().optional()
 });
 
-// src/core/chat/schema.ts
-var METHODS = ["list", "view", "topics", "search", "around", "fetch"];
-var GENERAL_TOPIC2 = 1;
-var LIMITS = {
-  list: { default: 30, max: 200 },
-  view: { default: 50, max: 300 },
-  topics: { default: 30, max: TOPICS_LIMIT },
-  search: { default: 30, max: 200 }
-};
-var AROUND_COUNT = { default: 5, max: AROUND_LIMIT };
-var FETCH_PAGES = { default: 1, max: FETCH_PAGE_LIMIT };
-var accountArgument = external_exports.string().optional().describe("The account label; may be left out when only one account is logged in.");
-var input3 = external_exports.object({
-  method: external_exports.enum(METHODS).describe(
-    "`list` finds chats; `view` reads the newest messages of one chat between two times, oldest first; `topics` lists the topics of a forum chat; `search` finds messages in the mirror by words; `around` reads the messages around one; `fetch` adds older history of a mirrored chat to the mirror."
-  ),
-  account: accountArgument,
-  query: external_exports.string().optional().describe(
-    "list: only chats whose name or username holds this text; a leading @ is ignored. search (required): the words to look for, all of which a message must hold in its text, caption or file name, in any order. Both ignore case and letter width."
-  ),
-  unread: external_exports.boolean().optional().describe("list: only chats with unread messages."),
-  last: external_exports.boolean().optional().describe("list: add each chat's newest mirrored message as `last_message`."),
-  refresh: external_exports.boolean().optional().describe(
-    "list: first take the chat list from Telegram (needs the sync service), then read it, and report when in `refreshed_at`."
-  ),
-  chat: external_exports.string().optional().describe(
-    "view, topics, around, fetch (required) and search (optional, to search one chat): the chat id, from `list`, such as 123456789 or -1001234567890. A name, username or phone number is not a chat."
-  ),
-  topic: external_exports.number().int().positive().optional().describe(
-    `view, around: only messages of this topic of a forum chat (ids from \`topics\`); the General topic is ${GENERAL_TOPIC2}. Refused for a chat without topics.`
-  ),
-  after: external_exports.string().optional().describe(
-    "view, search: only messages after this time (exclusive): RFC 3339 with an offset, or a date or time without one, read as local time, such as 2026-11-07 or 2026-11-07T14:03."
-  ),
-  before: external_exports.string().optional().describe("view, search: only messages before this time (exclusive); the same forms as `after`."),
-  limit: external_exports.number().int().optional().describe(
-    `How many to return. list: default ${LIMITS.list.default}, at most ${LIMITS.list.max}. view: default ${LIMITS.view.default}, at most ${LIMITS.view.max} (${HISTORY_LIMIT} for a chat read live). topics: default ${LIMITS.topics.default}, at most ${LIMITS.topics.max}. search: default ${LIMITS.search.default}, at most ${LIMITS.search.max}. A larger value is lowered to the most; a result may hold fewer to stay a size a model can read.`
-  ),
-  cursor: external_exports.string().optional().describe("The `next` of the previous result, to continue where it stopped."),
-  id: external_exports.number().int().positive().optional().describe("around (required): the id of the message to read around."),
-  before_count: external_exports.number().int().optional().describe(
-    `around: how many older messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
-  ),
-  after_count: external_exports.number().int().optional().describe(
-    `around: how many newer messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
-  ),
-  pages: external_exports.number().int().optional().describe(
-    `fetch: how many pages of ${FETCH_PAGE_SIZE} older messages to add, default ${FETCH_PAGES.default}, at most ${FETCH_PAGES.max}.`
-  )
-});
-var nameCut = external_exports.literal(true).optional().describe("Set when the name was longer than the most a result carries and was cut.");
-var chatEntry2 = external_exports.object({
-  id: external_exports.string().describe("The chat id: Telegram's signed id as text, such as `123456789` or `-1001234567890`."),
-  kind: external_exports.enum(CHAT_KINDS).describe("`self` is Saved Messages."),
-  name: external_exports.string().nullable().describe("The person's or chat's name; null when none is known."),
-  name_cut: nameCut,
-  username: external_exports.string().optional(),
-  mirrored: external_exports.boolean().describe("Whether the mirror keeps this chat's messages."),
-  unread: external_exports.number().int().describe("Incoming messages not read yet."),
-  last_activity_at: localTimeSchema.nullable().describe("The latest message's time, in local time with offset; null when none is known."),
-  forum: external_exports.literal(true).optional().describe("Set for a supergroup with topics."),
-  archived: external_exports.literal(true).optional(),
-  left: external_exports.literal(true).optional().describe("Set for a group or channel the user has left or been removed from."),
-  can_send: external_exports.literal(false).optional().describe("Set when the user is known not to be able to write here."),
-  auto_delete_seconds: external_exports.number().int().optional().describe("The chat's auto-delete period, when on."),
-  last_message: messageEntry.nullable().optional().describe("With `last`: the newest mirrored message of the chat, or null when none is mirrored.")
-});
-var topicEntry = external_exports.object({
-  id: external_exports.number().int().describe(`The topic id, to pass as \`topic\` to \`view\`; ${GENERAL_TOPIC2} is the General topic.`),
-  title: external_exports.string().nullable().describe("The topic's title; null when none is known."),
-  closed: external_exports.literal(true).optional().describe("Set for a topic that is closed."),
-  pinned: external_exports.literal(true).optional().describe("Set for a topic that is pinned."),
-  unread: external_exports.number().int().describe("Messages in it not read yet."),
-  last_activity_at: localTimeSchema.nullable().describe("The newest message's time, in local time with offset; null when none is known.")
-});
-var output3 = external_exports.object({
-  chats: external_exports.array(chatEntry2).optional().describe("list: the chats, newest activity first."),
-  refreshed_at: localTimeSchema.optional().describe("list with `refresh`: when the chat list was taken from Telegram, in local time with offset."),
-  chat: chatEntry2.optional().describe("view, topics, around, fetch: the chat read."),
-  messages: external_exports.array(messageEntry).optional().describe("view, around: the messages, oldest first. search: the hits, newest first."),
-  live: external_exports.literal(true).optional().describe(
-    "view, around: set when the chat is not mirrored, so the messages were read from Telegram and stored nowhere."
-  ),
-  topics: external_exports.array(topicEntry).optional().describe("topics: the topics, most recently active first."),
-  anchor: external_exports.number().int().optional().describe("around: the id of the message read around, among `messages`."),
-  trimmed_before: external_exports.number().int().optional().describe(
-    "around: how many older messages were left out, farthest first, to keep the result a size that can be read."
-  ),
-  trimmed_after: external_exports.number().int().optional().describe(
-    "around: how many newer messages were left out, farthest first, to keep the result a size that can be read."
-  ),
-  scanned_to: localTimeSchema.optional().describe(
-    "search: set when the search stopped before the end of the history it covers: the time of the oldest message looked at, in local time with offset. `next` continues from there."
-  ),
-  scope: external_exports.string().optional().describe("search: what the search covers and what it does not."),
-  fetched: external_exports.object({
-    added: external_exports.number().int().describe("How many messages the mirror gained."),
-    pages: external_exports.number().int().describe("How many pages were read."),
-    complete: external_exports.boolean().describe("Whether Telegram has nothing older for this chat."),
-    oldest_at: localTimeSchema.nullable().describe(
-      "The time of the oldest message the mirror now holds of this chat, in local time with offset; null when none."
-    )
-  }).optional().describe("fetch: what the history fetch stored."),
-  next: external_exports.string().optional().describe("Pass back as `cursor` to continue; absent when there is no more."),
-  note: external_exports.string().describe("Says that what the result carries is data written by other people.")
-});
-
 // src/core/chat/message-rows.ts
 var MESSAGE_COLUMNS = "chat, id, topic, ts, from_me, sender, sender_name, kind, body, entities, media, action, reply, forward, grouped, reactions, edited, expires, view_once, self_destruct";
 function liveMessages(now) {
@@ -30297,7 +30190,7 @@ function liveMessages(now) {
 }
 function inTopic(topic) {
   return {
-    condition: topic === GENERAL_TOPIC2 ? "(topic IS NULL OR topic = ?)" : "topic = ?",
+    condition: topic === GENERAL_TOPIC ? "(topic IS NULL OR topic = ?)" : "topic = ?",
     params: [topic]
   };
 }
@@ -30522,6 +30415,112 @@ var cuttableMessage = {
   drop: dropMetadata
 };
 
+// src/core/chat/schema.ts
+var METHODS = ["list", "view", "topics", "search", "around", "fetch"];
+var LIMITS = {
+  list: { default: 30, max: 200 },
+  view: { default: 50, max: 300 },
+  topics: { default: 30, max: TOPICS_LIMIT },
+  search: { default: 30, max: 200 }
+};
+var AROUND_COUNT = { default: 5, max: AROUND_LIMIT };
+var FETCH_PAGES = { default: 1, max: FETCH_PAGE_LIMIT };
+var accountArgument = external_exports.string().optional().describe("The account label; may be left out when only one account is logged in.");
+var input3 = external_exports.object({
+  method: external_exports.enum(METHODS).describe(
+    "`list` finds chats; `view` reads the newest messages of one chat between two times, oldest first; `topics` lists the topics of a forum chat; `search` finds messages in the mirror by words; `around` reads the messages around one; `fetch` adds older history of a mirrored chat to the mirror."
+  ),
+  account: accountArgument,
+  query: external_exports.string().optional().describe(
+    "list: only chats whose name or username holds this text; a leading @ is ignored. search (required): the words to look for, all of which a message must hold in its text, caption or file name, in any order. Both ignore case and letter width."
+  ),
+  unread: external_exports.boolean().optional().describe("list: only chats with unread messages."),
+  last: external_exports.boolean().optional().describe("list: add each chat's newest mirrored message as `last_message`."),
+  refresh: external_exports.boolean().optional().describe(
+    "list: first take the chat list from Telegram (needs the sync service), then read it, and report when in `refreshed_at`."
+  ),
+  chat: external_exports.string().optional().describe(
+    "view, topics, around, fetch (required) and search (optional, to search one chat): the chat id, from `list`, such as 123456789 or -1001234567890. A name, username or phone number is not a chat."
+  ),
+  topic: external_exports.number().int().positive().optional().describe(
+    `view, around: only messages of this topic of a forum chat (ids from \`topics\`); the General topic is ${GENERAL_TOPIC}. Refused for a chat without topics.`
+  ),
+  after: external_exports.string().optional().describe(
+    "view, search: only messages after this time (exclusive): RFC 3339 with an offset, or a date or time without one, read as local time, such as 2026-11-07 or 2026-11-07T14:03."
+  ),
+  before: external_exports.string().optional().describe("view, search: only messages before this time (exclusive); the same forms as `after`."),
+  limit: external_exports.number().int().optional().describe(
+    `How many to return. list: default ${LIMITS.list.default}, at most ${LIMITS.list.max}. view: default ${LIMITS.view.default}, at most ${LIMITS.view.max} (${HISTORY_LIMIT} for a chat read live). topics: default ${LIMITS.topics.default}, at most ${LIMITS.topics.max}. search: default ${LIMITS.search.default}, at most ${LIMITS.search.max}. A larger value is lowered to the most; a result may hold fewer to stay a size a model can read.`
+  ),
+  cursor: external_exports.string().optional().describe("The `next` of the previous result, to continue where it stopped."),
+  id: external_exports.number().int().positive().optional().describe("around (required): the id of the message to read around."),
+  before_count: external_exports.number().int().optional().describe(
+    `around: how many older messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
+  ),
+  after_count: external_exports.number().int().optional().describe(
+    `around: how many newer messages to return, default ${AROUND_COUNT.default}, at most ${AROUND_COUNT.max}; 0 asks for none.`
+  ),
+  pages: external_exports.number().int().optional().describe(
+    `fetch: how many pages of ${FETCH_PAGE_SIZE} older messages to add, default ${FETCH_PAGES.default}, at most ${FETCH_PAGES.max}.`
+  )
+});
+var nameCut = external_exports.literal(true).optional().describe("Set when the name was longer than the most a result carries and was cut.");
+var chatEntry2 = external_exports.object({
+  id: external_exports.string().describe("The chat id: Telegram's signed id as text, such as `123456789` or `-1001234567890`."),
+  kind: external_exports.enum(CHAT_KINDS).describe("`self` is Saved Messages."),
+  name: external_exports.string().nullable().describe("The person's or chat's name; null when none is known."),
+  name_cut: nameCut,
+  username: external_exports.string().optional(),
+  mirrored: external_exports.boolean().describe("Whether the mirror keeps this chat's messages."),
+  unread: external_exports.number().int().describe("Incoming messages not read yet."),
+  last_activity_at: localTimeSchema.nullable().describe("The latest message's time, in local time with offset; null when none is known."),
+  forum: external_exports.literal(true).optional().describe("Set for a supergroup with topics."),
+  archived: external_exports.literal(true).optional(),
+  left: external_exports.literal(true).optional().describe("Set for a group or channel the user has left or been removed from."),
+  can_send: external_exports.literal(false).optional().describe("Set when the user is known not to be able to write here."),
+  auto_delete_seconds: external_exports.number().int().optional().describe("The chat's auto-delete period, when on."),
+  last_message: messageEntry.nullable().optional().describe("With `last`: the newest mirrored message of the chat, or null when none is mirrored.")
+});
+var topicEntry = external_exports.object({
+  id: external_exports.number().int().describe(`The topic id, to pass as \`topic\` to \`view\`; ${GENERAL_TOPIC} is the General topic.`),
+  title: external_exports.string().nullable().describe("The topic's title; null when none is known."),
+  closed: external_exports.literal(true).optional().describe("Set for a topic that is closed."),
+  pinned: external_exports.literal(true).optional().describe("Set for a topic that is pinned."),
+  unread: external_exports.number().int().describe("Messages in it not read yet."),
+  last_activity_at: localTimeSchema.nullable().describe("The newest message's time, in local time with offset; null when none is known.")
+});
+var output3 = external_exports.object({
+  chats: external_exports.array(chatEntry2).optional().describe("list: the chats, newest activity first."),
+  refreshed_at: localTimeSchema.optional().describe("list with `refresh`: when the chat list was taken from Telegram, in local time with offset."),
+  chat: chatEntry2.optional().describe("view, topics, around, fetch: the chat read."),
+  messages: external_exports.array(messageEntry).optional().describe("view, around: the messages, oldest first. search: the hits, newest first."),
+  live: external_exports.literal(true).optional().describe(
+    "view, around: set when the chat is not mirrored, so the messages were read from Telegram and stored nowhere."
+  ),
+  topics: external_exports.array(topicEntry).optional().describe("topics: the topics, most recently active first."),
+  anchor: external_exports.number().int().optional().describe("around: the id of the message read around, among `messages`."),
+  trimmed_before: external_exports.number().int().optional().describe(
+    "around: how many older messages were left out, farthest first, to keep the result a size that can be read."
+  ),
+  trimmed_after: external_exports.number().int().optional().describe(
+    "around: how many newer messages were left out, farthest first, to keep the result a size that can be read."
+  ),
+  scanned_to: localTimeSchema.optional().describe(
+    "search: set when the search stopped before the end of the history it covers: the time of the oldest message looked at, in local time with offset. `next` continues from there."
+  ),
+  scope: external_exports.string().optional().describe("search: what the search covers and what it does not."),
+  fetched: external_exports.object({
+    added: external_exports.number().int().describe("How many messages the mirror gained."),
+    pages: external_exports.number().int().describe("How many pages were read."),
+    complete: external_exports.boolean().describe("Whether Telegram has nothing older for this chat."),
+    oldest_at: localTimeSchema.nullable().describe(
+      "The time of the oldest message the mirror now holds of this chat, in local time with offset; null when none."
+    )
+  }).optional().describe("fetch: what the history fetch stored."),
+  next: external_exports.string().optional().describe("Pass back as `cursor` to continue; absent when there is no more."),
+  note: external_exports.string().describe("Says that what the result carries is data written by other people.")
+});
+
 // src/core/chat/around.ts
 var TRIMMED_RESERVE = 100;
 var NO_MESSAGE = "No message with this id in this chat.";
@@ -30724,7 +30723,7 @@ function listChats(mirror, args, now) {
   return result;
 }
 
-// src/core/chat/open.ts
+// src/core/open.ts
 async function pickPaths(ctx, account2) {
   if (!ctx.stateDir) throw new ToolError("internal_error", "The entry point did not supply a state directory.");
   return pickLabel(ctx.stateDir, account2);
@@ -31133,6 +31132,32 @@ function chatFact(kind) {
   return { label: "Chat", value: { text: CHAT_KIND_WORDS[kind] } };
 }
 
+// src/core/chat/media-facts.ts
+var MEDIA_KIND_WORDS = {
+  photo: "Photo",
+  document: "Document",
+  audio: "Audio",
+  voice: "Voice message",
+  video: "Video",
+  sticker: "Sticker",
+  dice: "Dice",
+  contact: "Contact",
+  venue: "Venue",
+  geo: "Location",
+  geo_live: "Live location",
+  game: "Game",
+  invoice: "Invoice",
+  webpage: "Link preview",
+  poll: "Poll",
+  todo: "Checklist",
+  story: "Story",
+  paid: "Paid media",
+  unsupported: "Unsupported media"
+};
+function mediaKindValue(type) {
+  return Object.hasOwn(MEDIA_KIND_WORDS, type) ? { text: MEDIA_KIND_WORDS[type] } : type;
+}
+
 // src/core/file/constants.ts
 var FILE_SAVE_TOOL_ID = "telegram_file_save";
 var FILE_SEND_TOOL_ID = "telegram_file_send";
@@ -33055,14 +33080,6 @@ function namesOf(file2, id) {
   const name = safeFileName(file2.name, { kind: file2.kind, id, type: file2.type });
   return { name, shown: file2.name === null ? file2.kind : name };
 }
-var FILE_KIND_WORDS = {
-  photo: "Photo",
-  document: "Document",
-  audio: "Audio",
-  voice: "Voice message",
-  video: "Video",
-  sticker: "Sticker"
-};
 function saveHeadline(file2, chat) {
   if (file2 !== void 0 && chat !== null) return { text: "About to save {file} from {chat}", values: { file: file2, chat } };
   if (chat !== null) return { text: "About to save a file from {chat}", values: { chat } };
@@ -33070,9 +33087,8 @@ function saveHeadline(file2, chat) {
   return void 0;
 }
 function fileFacts(media, unpack) {
-  const kind = media && Object.hasOwn(FILE_KIND_WORDS, media.type) ? FILE_KIND_WORDS[media.type] : void 0;
   return [
-    ...media ? [{ label: "File", value: kind ? { text: kind } : media.type }] : [],
+    ...media ? [{ label: "File", value: mediaKindValue(media.type) }] : [],
     ...unpack ? [{ label: "Unpack", value: { text: "Yes" } }] : [],
     ...media?.size !== void 0 && Number.isSafeInteger(media.size) && media.size > 0 ? [sizeFact(media.size)] : []
   ];
@@ -33587,9 +33603,8 @@ async function checkArchive(path, format, limits, signal) {
 }
 
 // src/core/outgoing/limits.ts
-var BYTES_PER_MB2 = 1024 * 1024;
 var MAX_FILES = 10;
-var MAX_TOTAL_BYTES = 100 * BYTES_PER_MB2;
+var MAX_TOTAL_BYTES = 100 * BYTES_PER_MB;
 
 // src/core/file/send/constants.ts
 var SEND_FILES_TIMEOUT_MS = 30 * 60 * 1e3;
@@ -34164,39 +34179,46 @@ var telegramFileSend = createFileSend();
 // src/core/message/action-describe.ts
 var EDIT_HEADLINES = {
   named: "About to edit message {id} in {chat}",
-  saved: "About to edit message {id} in Saved Messages"
+  saved: "About to edit message {id} in Saved Messages",
+  bare: "About to edit message {id}"
 };
 var DELETE_HEADLINES = {
-  named: "About to delete message {id} from {chat}",
-  saved: "About to delete message {id} from Saved Messages"
+  named: "About to delete message {id} from {chat} for everyone",
+  saved: "About to delete message {id} from Saved Messages",
+  bare: "About to delete message {id} for everyone"
 };
 var REACT_HEADLINES = {
   named: "About to react {emoji} to message {id} in {chat}",
-  saved: "About to react {emoji} to message {id} in Saved Messages"
+  saved: "About to react {emoji} to message {id} in Saved Messages",
+  bare: "About to react {emoji} to message {id}"
 };
 var UNREACT_HEADLINES = {
   named: "About to remove your reaction from message {id} in {chat}",
-  saved: "About to remove your reaction from message {id} in Saved Messages"
+  saved: "About to remove your reaction from message {id} in Saved Messages",
+  bare: "About to remove your reaction from message {id}"
 };
 var PIN_HEADLINES = {
   named: "About to pin message {id} in {chat}",
-  saved: "About to pin message {id} in Saved Messages"
+  saved: "About to pin message {id} in Saved Messages",
+  bare: "About to pin message {id}"
 };
 var UNPIN_HEADLINES = {
   named: "About to unpin message {id} in {chat}",
-  saved: "About to unpin message {id} in Saved Messages"
+  saved: "About to unpin message {id} in Saved Messages",
+  bare: "About to unpin message {id}"
 };
 var MARK_READ_HEADLINES = {
   named: "About to mark {chat} read up to message {id}",
-  saved: "About to mark Saved Messages read up to message {id}"
+  saved: "About to mark Saved Messages read up to message {id}",
+  bare: "About to mark messages read up to message {id}"
 };
 function actionHeadline(headlines, { kind, name }, id, values) {
   if (kind === "self") return { text: headlines.saved, values: { id: String(id), ...values } };
-  return name === null ? void 0 : { text: headlines.named, values: { id: String(id), chat: name, ...values } };
+  return name === null ? { text: headlines.bare, values: { id: String(id), ...values } } : { text: headlines.named, values: { id: String(id), chat: name, ...values } };
 }
 function currentFacts({ body, media }) {
-  const shown = body || media?.type;
-  return shown ? [{ label: "Current", value: cut(shown, MAX_VALUE_LENGTH) }] : [];
+  if (body) return [{ label: "Current", value: cut(body, MAX_VALUE_LENGTH) }];
+  return media ? [{ label: "Media", value: mediaKindValue(media.type) }] : [];
 }
 function describeAction(headlines, chat, id, message, extras = {}) {
   const headline = actionHeadline(headlines, chat, id, extras.values ?? {});
@@ -34432,7 +34454,7 @@ var telegramMessageDelete = defineTool({
     "A result means Telegram deleted the message for everyone. `already` means it was gone before this call.",
     "A failure `uncertain` means the delete may have gone through: check the chat in Telegram and never ask for it again without the user checking."
   ].join(" "),
-  intent: "About to delete a message",
+  intent: "About to delete a message for everyone",
   toolset: "actions",
   class: "administrative",
   input: deleteInput,
@@ -36853,7 +36875,7 @@ async function main() {
     const settings = parseSettings(process.argv.slice(2), process.env);
     server = createServer(ALL_TOOLS, settings, {
       ownDir: packageRoot(import.meta.url),
-      version: true ? "0.1.0" : void 0
+      version: true ? "0.2.0" : void 0
     });
   } catch (error62) {
     if (!isToolError(error62)) throw error62;