@downcity/plugins 1.0.4

package/bin/chat/channels/telegram/Shared.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Telegram 集成配置。
+ */
+export interface TelegramConfig {
+    botToken?: string;
+    enabled: boolean;
+}
+/**
+ * Telegram Update 结构（仅保留当前项目需要字段）。
+ */
+export interface TelegramUpdate {
+    update_id: number;
+    message?: {
+        message_id?: number;
+        message_thread_id?: number;
+        text?: string;
+        caption?: string;
+        quote?: {
+            text?: string;
+        };
+        chat: {
+            id: number;
+            type?: "private" | "group" | "supergroup" | "channel";
+            title?: string;
+            username?: string;
+            first_name?: string;
+            last_name?: string;
+        };
+        document?: {
+            file_id: string;
+            file_name?: string;
+            mime_type?: string;
+            file_size?: number;
+        };
+        photo?: Array<{
+            file_id: string;
+            width?: number;
+            height?: number;
+            file_size?: number;
+        }>;
+        voice?: {
+            file_id: string;
+            mime_type?: string;
+            file_size?: number;
+            duration?: number;
+        };
+        audio?: {
+            file_id: string;
+            file_name?: string;
+            mime_type?: string;
+            file_size?: number;
+            duration?: number;
+        };
+        video?: {
+            file_id: string;
+            file_name?: string;
+            mime_type?: string;
+            file_size?: number;
+            duration?: number;
+            width?: number;
+            height?: number;
+        };
+        reply_to_message?: {
+            message_id?: number;
+            text?: string;
+            caption?: string;
+            document?: {
+                file_id: string;
+                file_name?: string;
+                mime_type?: string;
+                file_size?: number;
+            };
+            photo?: Array<{
+                file_id: string;
+                width?: number;
+                height?: number;
+                file_size?: number;
+            }>;
+            voice?: {
+                file_id: string;
+                mime_type?: string;
+                file_size?: number;
+                duration?: number;
+            };
+            audio?: {
+                file_id: string;
+                file_name?: string;
+                mime_type?: string;
+                file_size?: number;
+                duration?: number;
+            };
+            video?: {
+                file_id: string;
+                file_name?: string;
+                mime_type?: string;
+                file_size?: number;
+                duration?: number;
+                width?: number;
+                height?: number;
+            };
+            from?: {
+                id: number;
+                username?: string;
+                first_name?: string;
+                last_name?: string;
+            };
+        };
+        from?: {
+            id: number;
+            is_bot?: boolean;
+            username?: string;
+            first_name?: string;
+            last_name?: string;
+        };
+        entities?: Array<{
+            type: string;
+            offset: number;
+            length: number;
+            user?: {
+                id: number;
+                username?: string;
+            };
+        }>;
+        caption_entities?: Array<{
+            type: string;
+            offset: number;
+            length: number;
+            user?: {
+                id: number;
+                username?: string;
+            };
+        }>;
+    };
+    callback_query?: {
+        id: string;
+        data: string;
+        from?: {
+            id: number;
+            username?: string;
+            first_name?: string;
+            last_name?: string;
+        };
+        message: {
+            message_thread_id?: number;
+            chat: {
+                id: number;
+            };
+        };
+    };
+}
+export type TelegramUser = {
+    id: number;
+    is_bot?: boolean;
+    username?: string;
+    first_name?: string;
+    last_name?: string;
+};
+/**
+ * Telegram Bot API 通用响应。
+ */
+export interface TelegramApiResponse<T> {
+    ok: boolean;
+    result?: T;
+    description?: string;
+    error_code?: number;
+}
+export type TelegramAttachmentType = "photo" | "document" | "voice" | "audio" | "video";
+/**
+ * 清洗用户可见文本，避免直接回显冗长工具日志。
+ */
+export declare function sanitizeChatText(text: string): string;
+export declare function guessMimeType(fileName: string): string | undefined;
+/**
+ * 从文本中解析 `<file ...>` 附件标签。
+ *
+ * 说明（中文）
+ * - 返回“清理后的正文 + 附件列表 + 有序 segments”
+ * - `<file>` 标签会从正文中移除，便于自然语言与附件混写
+ * - `segments` 会保留正文与附件的真实顺序，供出站逐段发送
+ */
+export declare function parseTelegramAttachments(text: string): {
+    text: string;
+    attachments: Array<{
+        type: TelegramAttachmentType;
+        pathOrUrl: string;
+        caption?: string;
+    }>;
+    segments: Array<{
+        kind: "text";
+        text: string;
+    } | {
+        kind: "attachment";
+        attachment: {
+            type: TelegramAttachmentType;
+            pathOrUrl: string;
+            caption?: string;
+        };
+    }>;
+};
+export declare function getActorName(from?: {
+    first_name?: string;
+    last_name?: string;
+}): string | undefined;
+/**
+ * 提取 Telegram 会话展示名（群名/频道名/私聊对象名）。
+ *
+ * 关键点（中文）
+ * - 群聊/频道优先取 `chat.title`。
+ * - 私聊优先 username，再回退 first/last name。
+ */
+export declare function getTelegramChatTitle(chat?: {
+    title?: string;
+    username?: string;
+    first_name?: string;
+    last_name?: string;
+}): string | undefined;
+/**
+ * 拆分超长消息，避免触发 Telegram 4096 限制。
+ */
+export declare function splitTelegramMessage(text: string): string[];
+//# sourceMappingURL=Shared.d.ts.map

package/bin/chat/channels/telegram/Shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shared.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/telegram/Shared.ts"],"names":[],"mappings":"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"}

package/bin/chat/channels/telegram/Shared.js

@@ -0,0 +1,171 @@
+import path from "path";
+import { parseChatMessageMarkup } from "@downcity/agent/internal/executor/messages/ChatMessageMarkup.js";
+/**
+ * 清洗用户可见文本，避免直接回显冗长工具日志。
+ */
+export function sanitizeChatText(text) {
+    if (!text)
+        return text;
+    let out = text;
+    // Remove/compact tool-log style dumps if present
+    out = out.replace(/(^|\n)Tool Result:[\s\S]*?(?=\n{2,}|$)/g, "\n[工具输出已省略：我已在后台读取并提炼关键信息]\n");
+    return out;
+}
+export function guessMimeType(fileName) {
+    const ext = (path.extname(fileName) || "").toLowerCase();
+    switch (ext) {
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".webp":
+            return "image/webp";
+        case ".gif":
+            return "image/gif";
+        case ".pdf":
+            return "application/pdf";
+        case ".zip":
+            return "application/zip";
+        case ".mp3":
+            return "audio/mpeg";
+        case ".m4a":
+            return "audio/mp4";
+        case ".ogg":
+            return "audio/ogg";
+        case ".opus":
+            return "audio/opus";
+        case ".mp4":
+            return "video/mp4";
+        case ".mov":
+            return "video/quicktime";
+        case ".webm":
+            return "video/webm";
+        case ".m4v":
+            return "video/x-m4v";
+        default:
+            return undefined;
+    }
+}
+/**
+ * 从文本中解析 `<file ...>` 附件标签。
+ *
+ * 说明（中文）
+ * - 返回“清理后的正文 + 附件列表 + 有序 segments”
+ * - `<file>` 标签会从正文中移除，便于自然语言与附件混写
+ * - `segments` 会保留正文与附件的真实顺序，供出站逐段发送
+ */
+export function parseTelegramAttachments(text) {
+    const parsed = parseChatMessageMarkup(text);
+    const attachments = parsed.files.map((file) => {
+        const kindRaw = String(file.type || "").toLowerCase();
+        const type = kindRaw === "image" || kindRaw === "photo"
+            ? "photo"
+            : kindRaw === "file" || kindRaw === "document"
+                ? "document"
+                : kindRaw === "video"
+                    ? "video"
+                    : kindRaw === "audio"
+                        ? "audio"
+                        : "voice";
+        const pathOrUrl = String(file.path || "").trim();
+        const caption = typeof file.caption === "string" ? String(file.caption).trim() : undefined;
+        return {
+            type,
+            pathOrUrl,
+            ...(caption ? { caption } : {}),
+        };
+    }).filter((item) => item.pathOrUrl);
+    const segments = [];
+    for (const segment of parsed.segments) {
+        if (segment.kind === "text") {
+            if (segment.text) {
+                segments.push({
+                    kind: "text",
+                    text: segment.text,
+                });
+            }
+            continue;
+        }
+        const kindRaw = String(segment.file.type || "").toLowerCase();
+        const type = kindRaw === "image" || kindRaw === "photo"
+            ? "photo"
+            : kindRaw === "file" || kindRaw === "document"
+                ? "document"
+                : kindRaw === "video"
+                    ? "video"
+                    : kindRaw === "audio"
+                        ? "audio"
+                        : "voice";
+        const pathOrUrl = String(segment.file.path || "").trim();
+        if (!pathOrUrl)
+            continue;
+        const caption = typeof segment.file.caption === "string"
+            ? String(segment.file.caption).trim()
+            : undefined;
+        segments.push({
+            kind: "attachment",
+            attachment: {
+                type,
+                pathOrUrl,
+                ...(caption ? { caption } : {}),
+            },
+        });
+    }
+    return { text: parsed.bodyText, attachments, segments };
+}
+function formatActorName(name) {
+    return name
+        .replace(/[\r\n\t]+/g, " ")
+        .replace(/\s+/g, " ")
+        .replace(/[\[\]]/g, "")
+        .trim();
+}
+export function getActorName(from) {
+    const first = typeof from?.first_name === "string" ? from.first_name.trim() : "";
+    const last = typeof from?.last_name === "string" ? from.last_name.trim() : "";
+    const raw = [first, last].filter(Boolean).join(" ").trim();
+    if (!raw)
+        return undefined;
+    return formatActorName(raw);
+}
+/**
+ * 提取 Telegram 会话展示名（群名/频道名/私聊对象名）。
+ *
+ * 关键点（中文）
+ * - 群聊/频道优先取 `chat.title`。
+ * - 私聊优先 username，再回退 first/last name。
+ */
+export function getTelegramChatTitle(chat) {
+    const title = typeof chat?.title === "string" ? chat.title.trim() : "";
+    if (title)
+        return title;
+    const username = typeof chat?.username === "string" ? chat.username.trim() : "";
+    if (username)
+        return `@${username.replace(/^@+/, "")}`;
+    const first = typeof chat?.first_name === "string" ? chat.first_name.trim() : "";
+    const last = typeof chat?.last_name === "string" ? chat.last_name.trim() : "";
+    const full = formatActorName([first, last].filter(Boolean).join(" ").trim());
+    return full || undefined;
+}
+/**
+ * 拆分超长消息，避免触发 Telegram 4096 限制。
+ */
+export function splitTelegramMessage(text) {
+    const MAX = 3900; // keep headroom under Telegram's 4096 limit
+    if (text.length <= MAX)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > MAX) {
+        let cut = remaining.lastIndexOf("\n", MAX);
+        if (cut < MAX * 0.6)
+            cut = MAX;
+        chunks.push(remaining.slice(0, cut));
+        remaining = remaining.slice(cut);
+    }
+    if (remaining.length > 0)
+        chunks.push(remaining);
+    return chunks;
+}
+//# sourceMappingURL=Shared.js.map

package/bin/chat/channels/telegram/Shared.js.map

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

package/bin/chat/channels/telegram/StateStore.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Telegram 轮询模式的持久化状态存储。
+ *
+ * 关键点（中文）
+ * - 保存 lastUpdateId，避免重启后重复消费
+ * - 所有 I/O 都是 best-effort，不能阻断主流程
+ *
+ * Persistent state for Telegram polling mode.
+ *
+ * Telegram's getUpdates polling relies on a monotonic `offset`. Persisting the
+ * last processed update id avoids re-processing after restarts.
+ *
+ * All I/O in this module is best-effort: failures should not break the bot.
+ */
+export declare class TelegramStateStore {
+    private readonly lastUpdateIdFile;
+    constructor(projectRoot: string);
+    /**
+     * 读取最后一次处理的 update_id。
+     */
+    loadLastUpdateId(): Promise<number | undefined>;
+    /**
+     * 持久化最后一次处理的 update_id。
+     */
+    saveLastUpdateId(lastUpdateId: number): Promise<void>;
+}
+//# sourceMappingURL=StateStore.d.ts.map

package/bin/chat/channels/telegram/StateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/telegram/StateStore.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAYrD;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAa5D"}

package/bin/chat/channels/telegram/StateStore.js

@@ -0,0 +1,53 @@
+import path from "path";
+import fs from "fs-extra";
+/**
+ * Telegram 轮询模式的持久化状态存储。
+ *
+ * 关键点（中文）
+ * - 保存 lastUpdateId，避免重启后重复消费
+ * - 所有 I/O 都是 best-effort，不能阻断主流程
+ *
+ * Persistent state for Telegram polling mode.
+ *
+ * Telegram's getUpdates polling relies on a monotonic `offset`. Persisting the
+ * last processed update id avoids re-processing after restarts.
+ *
+ * All I/O in this module is best-effort: failures should not break the bot.
+ */
+export class TelegramStateStore {
+    lastUpdateIdFile;
+    constructor(projectRoot) {
+        const dir = path.join(projectRoot, ".downcity", ".cache", "telegram");
+        this.lastUpdateIdFile = path.join(dir, "lastUpdateId.json");
+    }
+    /**
+     * 读取最后一次处理的 update_id。
+     */
+    async loadLastUpdateId() {
+        try {
+            if (!(await fs.pathExists(this.lastUpdateIdFile)))
+                return undefined;
+            const data = (await fs.readJson(this.lastUpdateIdFile));
+            const value = Number(data?.lastUpdateId);
+            if (Number.isFinite(value) && value > 0)
+                return value;
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 持久化最后一次处理的 update_id。
+     */
+    async saveLastUpdateId(lastUpdateId) {
+        try {
+            await fs.ensureDir(path.dirname(this.lastUpdateIdFile));
+            await fs.writeJson(this.lastUpdateIdFile, { lastUpdateId }, { spaces: 2 });
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=StateStore.js.map

package/bin/chat/channels/telegram/StateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.js","sourceRoot":"","sources":["../../../../src/chat/channels/telegram/StateStore.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAG1B;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAkB;IACZ,gBAAgB,CAAS;IAE1C,YAAY,WAAmB;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YACpE,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAe,CAAC;YACtE,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtD,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,YAAoB;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,gBAAgB,EACrB,EAAE,YAAY,EAAE,EAChB,EAAE,MAAM,EAAE,CAAC,EAAE,CACd,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CAEF"}

package/bin/chat/channels/telegram/TelegramInbound.d.ts

@@ -0,0 +1,46 @@
+/**
+ * TelegramInbound：Telegram 入站辅助逻辑。
+ *
+ * 关键点（中文）
+ * - 只负责消息 ID 解析、chatKey 构造、审计文本、mention 清理、附件保存。
+ * - 不承担授权、命令分发、消息入队等主流程职责。
+ */
+import type { TelegramAttachmentType, TelegramUpdate } from "./Shared.js";
+/**
+ * 构建 lane 维度 chatKey。
+ */
+export declare function buildTelegramChatKey(chatId: string, messageThreadId?: number): string;
+/**
+ * 解析 Telegram 消息 ID。
+ */
+export declare function parseTelegramMessageId(messageId?: string): number | undefined;
+/**
+ * 是否为群聊。
+ */
+export declare function isTelegramGroupChat(chatType?: string): boolean;
+/**
+ * 构建可落盘的审计文本。
+ */
+export declare function buildTelegramAuditText(params: {
+    rawText: string;
+    hasIncomingAttachment: boolean;
+    message: TelegramUpdate["message"];
+}): string;
+/**
+ * 清理 bot mention。
+ */
+export declare function stripTelegramBotMention(text: string, botUsername?: string): string;
+/**
+ * 保存入站附件到本地缓存。
+ */
+export declare function saveTelegramIncomingAttachments(params: {
+    downloader: {
+        downloadTelegramFile: (fileId: string, suggestedName?: string) => Promise<string>;
+    };
+    message: TelegramUpdate["message"];
+}): Promise<Array<{
+    type: TelegramAttachmentType;
+    path: string;
+    desc?: string;
+}>>;
+//# sourceMappingURL=TelegramInbound.d.ts.map

package/bin/chat/channels/telegram/TelegramInbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelegramInbound.d.ts","sourceRoot":"","sources":["../../../../src/chat/channels/telegram/TelegramInbound.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1E;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,MAAM,GACvB,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,GAAG,MAAM,CAgBT;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;GAEG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,UAAU,EAAE;QACV,oBAAoB,EAAE,CACpB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;CACpC,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAoEhF"}