@unclick/mcp-server 0.1.0

package/dist/slack-tool.js

@@ -0,0 +1,316 @@
+// ── Slack Web API tool ─────────────────────────────────────────────────────────
+// Calls the official Slack Web API over HTTPS using fetch (no SDK needed).
+// All actions require a Bot Token (xoxb-...) with the appropriate OAuth scopes.
+//
+// Required scopes per action:
+//   slack_send          - chat:write
+//   slack_read          - channels:history, groups:history, im:history, mpim:history
+//   slack_search        - search:read
+//   slack_thread_reply  - chat:write
+//   slack_channels      - channels:read, groups:read, im:read, mpim:read
+//   slack_react         - reactions:write
+//   slack_upload        - files:write
+const SLACK_API = "https://slack.com/api";
+// ── HTTP helpers ───────────────────────────────────────────────────────────────
+async function slackGet(token, method, params) {
+    const qs = new URLSearchParams();
+    for (const [k, v] of Object.entries(params)) {
+        qs.set(k, String(v));
+    }
+    const res = await fetch(`${SLACK_API}/${method}?${qs}`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) {
+        throw new Error(`Slack HTTP ${res.status}: ${res.statusText}`);
+    }
+    return res.json();
+}
+async function slackPost(token, method, body) {
+    const res = await fetch(`${SLACK_API}/${method}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json; charset=utf-8",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        throw new Error(`Slack HTTP ${res.status}: ${res.statusText}`);
+    }
+    return res.json();
+}
+// ── Slack error translator ─────────────────────────────────────────────────────
+function translateError(code) {
+    const known = {
+        channel_not_found: "Channel not found. Check the channel ID or name.",
+        not_in_channel: "Bot is not in that channel. Invite it first: /invite @bot.",
+        is_archived: "Channel is archived and cannot receive messages.",
+        msg_too_long: "Message exceeds Slack's 40,000 character limit.",
+        no_text: "Message text is required.",
+        not_authed: "Missing or invalid bot token (xoxb-...).",
+        invalid_auth: "Bot token is invalid or revoked.",
+        account_inactive: "Bot account has been deactivated.",
+        token_revoked: "Bot token has been revoked.",
+        token_expired: "Bot token has expired.",
+        missing_scope: "Bot token is missing a required OAuth scope.",
+        cant_invite_self: "Cannot invite the bot to a channel it already occupies.",
+        message_not_found: "Message not found. Verify the channel and timestamp (ts).",
+        invalid_timestamp: "Invalid message timestamp. Use the exact ts value from Slack.",
+        already_reacted: "Bot has already added that reaction to this message.",
+        invalid_name: "Invalid emoji name. Use a standard Slack emoji name without colons.",
+        too_many_reactions: "Message has reached the reaction limit.",
+        file_not_found: "File not found.",
+        posting_to_general_channel_denied: "Workspace settings block posting to #general.",
+        ratelimited: "Rate limited by Slack. Wait a moment and retry.",
+    };
+    return known[code] ?? `Slack error: ${code}`;
+}
+function handleSlackResponse(data) {
+    if (!data.ok) {
+        const code = String(data.error ?? "unknown_error");
+        return { error: translateError(code), slack_error: code };
+    }
+    return data;
+}
+// ── Action implementations ─────────────────────────────────────────────────────
+async function actionSend(token, args) {
+    const channel = String(args.channel ?? "").trim();
+    if (!channel)
+        return { error: "channel is required." };
+    const text = String(args.text ?? "").trim();
+    if (!text && !args.blocks)
+        return { error: "text or blocks is required." };
+    const body = { channel };
+    if (text)
+        body.text = text;
+    if (args.blocks)
+        body.blocks = args.blocks;
+    if (args.thread_ts)
+        body.thread_ts = String(args.thread_ts);
+    if (args.username)
+        body.username = String(args.username);
+    const data = await slackPost(token, "chat.postMessage", body);
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    return {
+        ok: true,
+        channel: data.channel,
+        ts: data.ts,
+        message: data.message?.text ?? text,
+    };
+}
+async function actionRead(token, args) {
+    const channel = String(args.channel ?? "").trim();
+    if (!channel)
+        return { error: "channel is required." };
+    const limit = Math.min(200, Math.max(1, Number(args.limit ?? 20)));
+    const params = { channel, limit };
+    if (args.oldest)
+        params.oldest = String(args.oldest);
+    if (args.latest)
+        params.latest = String(args.latest);
+    const data = await slackGet(token, "conversations.history", params);
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    const messages = data.messages.map((m) => ({
+        ts: m.ts,
+        user: m.user,
+        bot_id: m.bot_id,
+        text: m.text,
+        type: m.type,
+        thread_ts: m.thread_ts,
+        reply_count: m.reply_count,
+    }));
+    return {
+        ok: true,
+        channel,
+        count: messages.length,
+        has_more: data.has_more,
+        messages,
+    };
+}
+async function actionSearch(token, args) {
+    const query = String(args.query ?? "").trim();
+    if (!query)
+        return { error: "query is required." };
+    const count = Math.min(100, Math.max(1, Number(args.count ?? 20)));
+    const params = {
+        query,
+        count,
+        sort: String(args.sort ?? "timestamp"),
+        sort_dir: String(args.sort_dir ?? "desc"),
+    };
+    const data = await slackGet(token, "search.messages", params);
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    const matches = data.messages;
+    const items = (matches.matches ?? []).map((m) => ({
+        ts: m.ts,
+        channel: m.channel?.id,
+        channel_name: m.channel?.name,
+        user: m.username,
+        text: m.text,
+        permalink: m.permalink,
+    }));
+    return {
+        ok: true,
+        query,
+        total: matches.total ?? items.length,
+        count: items.length,
+        messages: items,
+    };
+}
+async function actionThreadReply(token, args) {
+    const channel = String(args.channel ?? "").trim();
+    const thread_ts = String(args.thread_ts ?? "").trim();
+    const text = String(args.text ?? "").trim();
+    if (!channel)
+        return { error: "channel is required." };
+    if (!thread_ts)
+        return { error: "thread_ts is required." };
+    if (!text && !args.blocks)
+        return { error: "text or blocks is required." };
+    const body = { channel, thread_ts };
+    if (text)
+        body.text = text;
+    if (args.blocks)
+        body.blocks = args.blocks;
+    const data = await slackPost(token, "chat.postMessage", body);
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    return {
+        ok: true,
+        channel: data.channel,
+        ts: data.ts,
+        thread_ts: data.message?.thread_ts ?? thread_ts,
+        text,
+    };
+}
+async function actionChannels(token, args) {
+    const types = String(args.types ?? "public_channel");
+    const limit = Math.min(1000, Math.max(1, Number(args.limit ?? 100)));
+    const params = {
+        types,
+        limit,
+        exclude_archived: args.exclude_archived !== false,
+    };
+    const data = await slackGet(token, "conversations.list", params);
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    const channels = data.channels.map((c) => ({
+        id: c.id,
+        name: c.name,
+        is_private: c.is_private,
+        is_archived: c.is_archived,
+        is_member: c.is_member,
+        num_members: c.num_members,
+        topic: c.topic?.value,
+        purpose: c.purpose?.value,
+    }));
+    return {
+        ok: true,
+        types,
+        count: channels.length,
+        channels,
+    };
+}
+async function actionReact(token, args) {
+    const channel = String(args.channel ?? "").trim();
+    const ts = String(args.timestamp ?? "").trim();
+    const name = String(args.emoji ?? "").trim().replace(/^:|:$/g, "");
+    if (!channel)
+        return { error: "channel is required." };
+    if (!ts)
+        return { error: "timestamp is required." };
+    if (!name)
+        return { error: "emoji is required." };
+    const data = await slackPost(token, "reactions.add", { channel, timestamp: ts, name });
+    const result = handleSlackResponse(data);
+    if (result.error)
+        return result;
+    return { ok: true, channel, timestamp: ts, emoji: name };
+}
+async function actionUpload(token, args) {
+    const channels = String(args.channels ?? "").trim();
+    const filename = String(args.filename ?? "file.txt").trim();
+    const content = String(args.content ?? "").trim();
+    if (!channels)
+        return { error: "channels is required (channel ID or comma-separated IDs)." };
+    if (!content)
+        return { error: "content is required." };
+    // Use the v2 upload flow: get upload URL, upload, then finalize.
+    // Step 1: request an upload URL
+    const urlRes = await slackGet(token, "files.getUploadURLExternal", {
+        filename,
+        length: Buffer.byteLength(content, "utf8"),
+    });
+    const urlResult = handleSlackResponse(urlRes);
+    if (urlResult.error)
+        return urlResult;
+    const uploadUrl = String(urlRes.upload_url ?? "");
+    const fileId = String(urlRes.file_id ?? "");
+    // Step 2: POST the file content to the upload URL
+    const uploadRes = await fetch(uploadUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/octet-stream" },
+        body: content,
+    });
+    if (!uploadRes.ok) {
+        return { error: `File upload to Slack storage failed: HTTP ${uploadRes.status}` };
+    }
+    // Step 3: finalize and share to the channel(s)
+    const finalBody = {
+        files: [{ id: fileId }],
+        channel_id: channels.split(",")[0].trim(),
+    };
+    if (args.initial_comment)
+        finalBody.initial_comment = String(args.initial_comment);
+    const finalRes = await slackPost(token, "files.completeUploadExternal", finalBody);
+    const finalResult = handleSlackResponse(finalRes);
+    if (finalResult.error)
+        return finalResult;
+    const files = finalRes.files;
+    const file = files?.[0];
+    return {
+        ok: true,
+        file_id: file?.id,
+        filename: file?.name ?? filename,
+        permalink: file?.permalink,
+        channels: channels.split(",").map((c) => c.trim()),
+    };
+}
+// ── Public dispatcher ──────────────────────────────────────────────────────────
+export async function slackAction(action, args) {
+    const token = String(args.bot_token ?? "").trim();
+    if (!token)
+        return { error: "bot_token is required." };
+    if (!token.startsWith("xoxb-"))
+        return { error: "bot_token must start with xoxb-. Check your Slack app's Bot Token." };
+    try {
+        switch (action) {
+            case "slack_send": return actionSend(token, args);
+            case "slack_read": return actionRead(token, args);
+            case "slack_search": return actionSearch(token, args);
+            case "slack_thread_reply": return actionThreadReply(token, args);
+            case "slack_channels": return actionChannels(token, args);
+            case "slack_react": return actionReact(token, args);
+            case "slack_upload": return actionUpload(token, args);
+            default:
+                return {
+                    error: `Unknown slack action: "${action}". ` +
+                        "Valid actions: slack_send, slack_read, slack_search, " +
+                        "slack_thread_reply, slack_channels, slack_react, slack_upload.",
+                };
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { error: message };
+    }
+}
+//# sourceMappingURL=slack-tool.js.map

package/dist/slack-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-tool.js","sourceRoot":"","sources":["../src/slack-tool.ts"],"names":[],"mappings":"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"}

package/dist/telegram-tool.d.ts

@@ -0,0 +1,7 @@
+export declare function telegramSend(args: Record<string, unknown>): Promise<unknown>;
+export declare function telegramRead(args: Record<string, unknown>): Promise<unknown>;
+export declare function telegramSearch(args: Record<string, unknown>): Promise<unknown>;
+export declare function telegramSendMedia(args: Record<string, unknown>): Promise<unknown>;
+export declare function telegramGetUpdates(args: Record<string, unknown>): Promise<unknown>;
+export declare function telegramManageChat(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=telegram-tool.d.ts.map

package/dist/telegram-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-tool.d.ts","sourceRoot":"","sources":["../src/telegram-tool.ts"],"names":[],"mappings":"AA4HA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiClF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BlF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAoCpF;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CvF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAyCxF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAuExF"}

package/dist/telegram-tool.js

@@ -0,0 +1,297 @@
+// Telegram Bot API integration for the UnClick MCP server.
+// Uses the official Telegram Bot API via fetch - no external dependencies.
+// Users must create a bot via @BotFather on Telegram to get a token.
+const TELEGRAM_API_BASE = "https://api.telegram.org";
+// ─── API helper ──────────────────────────────────────────────────────────────
+async function telegramCall(token, method, params = {}) {
+    const url = `${TELEGRAM_API_BASE}/bot${token}/${method}`;
+    const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(params),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} from Telegram API`);
+    }
+    const data = (await response.json());
+    if (!data.ok) {
+        const code = data.error_code ? ` (code ${data.error_code})` : "";
+        throw new Error(`Telegram API error${code}: ${data.description ?? "Unknown error"}`);
+    }
+    return data.result;
+}
+// ─── Message normalization ────────────────────────────────────────────────────
+function normalizeMessage(msg) {
+    const sender = msg.from
+        ? {
+            id: msg.from.id,
+            name: [msg.from.first_name, msg.from.last_name].filter(Boolean).join(" "),
+            username: msg.from.username,
+            is_bot: msg.from.is_bot,
+        }
+        : msg.sender_chat
+            ? { id: msg.sender_chat.id, name: msg.sender_chat.title ?? "Channel", username: msg.sender_chat.username }
+            : null;
+    return {
+        message_id: msg.message_id,
+        date: new Date(msg.date * 1000).toISOString(),
+        sender,
+        chat: {
+            id: msg.chat.id,
+            type: msg.chat.type,
+            name: msg.chat.title ?? msg.chat.username ?? msg.chat.first_name ?? String(msg.chat.id),
+        },
+        text: msg.text ?? msg.caption ?? null,
+        has_media: Array.isArray(msg.photo) || msg.document !== undefined,
+        document_name: msg.document?.file_name ?? null,
+        reply_to: msg.reply_to_message?.message_id ?? null,
+    };
+}
+// ─── Token validation ─────────────────────────────────────────────────────────
+function requireToken(token) {
+    const t = String(token ?? "").trim();
+    if (!t)
+        throw new Error("bot_token is required. Create a bot at @BotFather on Telegram.");
+    return t;
+}
+// ─── Operations ──────────────────────────────────────────────────────────────
+export async function telegramSend(args) {
+    const token = requireToken(args.bot_token);
+    const chatId = args.chat_id;
+    if (!chatId)
+        throw new Error("chat_id is required.");
+    const text = String(args.text ?? "").trim();
+    if (!text)
+        throw new Error("text is required.");
+    const params = {
+        chat_id: chatId,
+        text,
+    };
+    const parseMode = args.parse_mode;
+    if (parseMode === "Markdown" || parseMode === "HTML" || parseMode === "MarkdownV2") {
+        params.parse_mode = parseMode;
+    }
+    if (args.reply_to_message_id) {
+        params.reply_to_message_id = Number(args.reply_to_message_id);
+    }
+    if (args.disable_notification === true) {
+        params.disable_notification = true;
+    }
+    const msg = await telegramCall(token, "sendMessage", params);
+    return {
+        success: true,
+        message_id: msg.message_id,
+        chat_id: msg.chat.id,
+        date: new Date(msg.date * 1000).toISOString(),
+        text: msg.text,
+    };
+}
+export async function telegramRead(args) {
+    const token = requireToken(args.bot_token);
+    const chatId = args.chat_id !== undefined ? String(args.chat_id) : null;
+    const limit = Math.min(100, Math.max(1, Number(args.limit ?? 20)));
+    const offset = args.offset !== undefined ? Number(args.offset) : undefined;
+    // getUpdates returns messages received by the bot (since last checked or from offset)
+    const params = { limit: 100 };
+    if (offset !== undefined)
+        params.offset = offset;
+    const updates = await telegramCall(token, "getUpdates", params);
+    // Extract messages from updates
+    let messages = updates
+        .map((u) => u.message ?? u.channel_post ?? u.edited_message ?? u.edited_channel_post)
+        .filter((m) => m !== undefined);
+    // Filter by chat_id if provided
+    if (chatId !== null) {
+        messages = messages.filter((m) => String(m.chat.id) === chatId);
+    }
+    // Return last N messages (most recent)
+    const recent = messages.slice(-limit).reverse();
+    const nextOffset = updates.length > 0 ? updates[updates.length - 1].update_id + 1 : offset;
+    return {
+        count: recent.length,
+        next_offset: nextOffset,
+        messages: recent.map(normalizeMessage),
+    };
+}
+export async function telegramSearch(args) {
+    const token = requireToken(args.bot_token);
+    const chatId = args.chat_id !== undefined ? String(args.chat_id) : null;
+    const query = String(args.query ?? "").toLowerCase().trim();
+    if (!query)
+        throw new Error("query is required.");
+    const limit = Math.min(50, Math.max(1, Number(args.limit ?? 10)));
+    const offset = args.offset !== undefined ? Number(args.offset) : undefined;
+    // Fetch all available updates and filter by keyword
+    const params = { limit: 100 };
+    if (offset !== undefined)
+        params.offset = offset;
+    const updates = await telegramCall(token, "getUpdates", params);
+    let messages = updates
+        .map((u) => u.message ?? u.channel_post ?? u.edited_message ?? u.edited_channel_post)
+        .filter((m) => m !== undefined);
+    if (chatId !== null) {
+        messages = messages.filter((m) => String(m.chat.id) === chatId);
+    }
+    // Filter by keyword in text or caption
+    const matched = messages.filter((m) => {
+        const content = (m.text ?? m.caption ?? "").toLowerCase();
+        return content.includes(query);
+    });
+    const results = matched.slice(0, limit).reverse();
+    return {
+        query,
+        count: results.length,
+        messages: results.map(normalizeMessage),
+        note: "Search covers messages received by the bot since last getUpdates call. For full history search, use a Telegram client.",
+    };
+}
+export async function telegramSendMedia(args) {
+    const token = requireToken(args.bot_token);
+    const chatId = args.chat_id;
+    if (!chatId)
+        throw new Error("chat_id is required.");
+    const mediaType = String(args.media_type ?? "photo").toLowerCase();
+    const mediaUrl = String(args.media_url ?? "").trim();
+    if (!mediaUrl)
+        throw new Error("media_url is required (URL to the file).");
+    const supportedTypes = ["photo", "document", "audio", "video", "animation"];
+    if (!supportedTypes.includes(mediaType)) {
+        throw new Error(`Unsupported media_type "${mediaType}". Supported: ${supportedTypes.join(", ")}.`);
+    }
+    const params = {
+        chat_id: chatId,
+        [mediaType]: mediaUrl,
+    };
+    if (args.caption) {
+        params.caption = String(args.caption);
+        if (args.parse_mode)
+            params.parse_mode = args.parse_mode;
+    }
+    if (args.disable_notification === true) {
+        params.disable_notification = true;
+    }
+    const methodMap = {
+        photo: "sendPhoto",
+        document: "sendDocument",
+        audio: "sendAudio",
+        video: "sendVideo",
+        animation: "sendAnimation",
+    };
+    const msg = await telegramCall(token, methodMap[mediaType], params);
+    return {
+        success: true,
+        message_id: msg.message_id,
+        chat_id: msg.chat.id,
+        date: new Date(msg.date * 1000).toISOString(),
+        media_type: mediaType,
+        caption: msg.caption ?? null,
+    };
+}
+export async function telegramGetUpdates(args) {
+    const token = requireToken(args.bot_token);
+    const limit = Math.min(100, Math.max(1, Number(args.limit ?? 20)));
+    const timeout = Math.min(30, Math.max(0, Number(args.timeout ?? 0)));
+    const offset = args.offset !== undefined ? Number(args.offset) : undefined;
+    const params = { limit, timeout };
+    if (offset !== undefined)
+        params.offset = offset;
+    // Filter to specific update types if requested
+    const allowedUpdates = args.allowed_updates;
+    if (Array.isArray(allowedUpdates) && allowedUpdates.length > 0) {
+        params.allowed_updates = allowedUpdates;
+    }
+    const updates = await telegramCall(token, "getUpdates", params);
+    const nextOffset = updates.length > 0 ? updates[updates.length - 1].update_id + 1 : offset;
+    const formatted = updates.map((u) => {
+        const msg = u.message ?? u.channel_post ?? u.edited_message ?? u.edited_channel_post;
+        return {
+            update_id: u.update_id,
+            type: u.message
+                ? "message"
+                : u.channel_post
+                    ? "channel_post"
+                    : u.edited_message
+                        ? "edited_message"
+                        : u.edited_channel_post
+                            ? "edited_channel_post"
+                            : "other",
+            message: msg ? normalizeMessage(msg) : null,
+        };
+    });
+    return {
+        count: updates.length,
+        next_offset: nextOffset,
+        updates: formatted,
+    };
+}
+export async function telegramManageChat(args) {
+    const token = requireToken(args.bot_token);
+    const action = String(args.action ?? "").trim();
+    const chatId = args.chat_id;
+    if (!chatId)
+        throw new Error("chat_id is required.");
+    const validActions = ["info", "members", "pin", "unpin"];
+    if (!action)
+        throw new Error(`action is required. Valid values: ${validActions.join(", ")}.`);
+    if (!validActions.includes(action)) {
+        throw new Error(`Unknown action "${action}". Valid values: ${validActions.join(", ")}.`);
+    }
+    if (action === "info") {
+        const chat = await telegramCall(token, "getChat", {
+            chat_id: chatId,
+        });
+        return {
+            id: chat.id,
+            type: chat.type,
+            title: chat.title ?? null,
+            username: chat.username ?? null,
+            first_name: chat.first_name ?? null,
+            description: chat.description ?? null,
+            invite_link: chat.invite_link ?? null,
+            member_count: chat.member_count ?? null,
+        };
+    }
+    if (action === "members") {
+        const members = await telegramCall(token, "getChatAdministrators", {
+            chat_id: chatId,
+        });
+        return {
+            count: members.length,
+            administrators: members.map((m) => ({
+                status: m.status,
+                user_id: m.user.id,
+                name: [m.user.first_name, m.user.last_name].filter(Boolean).join(" "),
+                username: m.user.username ?? null,
+                is_bot: m.user.is_bot,
+            })),
+        };
+    }
+    if (action === "pin") {
+        const messageId = Number(args.message_id);
+        if (!messageId)
+            throw new Error("message_id is required for pin action.");
+        const disableNotification = args.disable_notification === true;
+        await telegramCall(token, "pinChatMessage", {
+            chat_id: chatId,
+            message_id: messageId,
+            disable_notification: disableNotification,
+        });
+        return { success: true, action: "pin", message_id: messageId, chat_id: chatId };
+    }
+    if (action === "unpin") {
+        const messageId = args.message_id !== undefined ? Number(args.message_id) : undefined;
+        const params = { chat_id: chatId };
+        if (messageId !== undefined)
+            params.message_id = messageId;
+        await telegramCall(token, "unpinChatMessage", params);
+        return {
+            success: true,
+            action: "unpin",
+            message_id: messageId ?? "most recent pinned",
+            chat_id: chatId,
+        };
+    }
+    // Should not reach here
+    throw new Error(`Unhandled action: ${action}`);
+}
+//# sourceMappingURL=telegram-tool.js.map