paperclip-plugin-telegram 0.2.1 → 0.2.2

package/dist/formatters.d.ts

@@ -0,0 +1,13 @@
+import type { PluginEvent } from "@paperclipai/plugin-sdk";
+import type { SendMessageOptions } from "./telegram-api.js";
+type FormattedMessage = {
+    text: string;
+    options: SendMessageOptions;
+};
+export declare function formatIssueCreated(event: PluginEvent): FormattedMessage;
+export declare function formatIssueDone(event: PluginEvent): FormattedMessage;
+export declare function formatApprovalCreated(event: PluginEvent): FormattedMessage;
+export declare function formatAgentError(event: PluginEvent): FormattedMessage;
+export declare function formatAgentRunStarted(event: PluginEvent): FormattedMessage;
+export declare function formatAgentRunFinished(event: PluginEvent): FormattedMessage;
+export {};

package/dist/formatters.js

@@ -0,0 +1,130 @@
+import { escapeMarkdownV2, truncateAtWord } from "./telegram-api.js";
+function esc(s) {
+    return escapeMarkdownV2(s);
+}
+function bold(s) {
+    return `*${esc(s)}*`;
+}
+function code(s) {
+    return `\`${esc(s)}\``;
+}
+export function formatIssueCreated(event) {
+    const p = event.payload;
+    const identifier = String(p.identifier ?? event.entityId);
+    const title = String(p.title ?? "Untitled");
+    const status = p.status ? String(p.status) : null;
+    const priority = p.priority ? String(p.priority) : null;
+    const assigneeName = p.assigneeName ? String(p.assigneeName) : null;
+    const projectName = p.projectName ? String(p.projectName) : null;
+    const lines = [
+        `${esc("📋")} ${bold("Issue Created")}: ${bold(identifier)}`,
+        bold(title),
+    ];
+    const meta = [];
+    if (status)
+        meta.push(`Status: ${code(status)}`);
+    if (priority)
+        meta.push(`Priority: ${code(priority)}`);
+    if (assigneeName)
+        meta.push(`Assignee: ${esc(assigneeName)}`);
+    if (projectName)
+        meta.push(`Project: ${esc(projectName)}`);
+    if (meta.length > 0)
+        lines.push(meta.join(" \\| "));
+    if (p.description) {
+        const desc = truncateAtWord(String(p.description), 200);
+        lines.push(`\n${esc(">")} ${esc(desc)}`);
+    }
+    return {
+        text: lines.join("\n"),
+        options: { parseMode: "MarkdownV2" },
+    };
+}
+export function formatIssueDone(event) {
+    const p = event.payload;
+    const identifier = String(p.identifier ?? event.entityId);
+    const title = String(p.title ?? "");
+    return {
+        text: [
+            `${esc("✅")} ${bold("Issue Completed")}: ${bold(identifier)}`,
+            `${bold(title)} ${esc("is now done.")}`,
+        ].join("\n"),
+        options: { parseMode: "MarkdownV2" },
+    };
+}
+export function formatApprovalCreated(event) {
+    const p = event.payload;
+    const approvalType = String(p.type ?? "unknown");
+    const approvalId = String(p.approvalId ?? event.entityId);
+    const title = String(p.title ?? "Approval Requested");
+    const description = p.description ? String(p.description) : null;
+    const agentName = p.agentName ? String(p.agentName) : null;
+    const lines = [
+        `${esc("🔔")} ${bold("Approval Requested")}`,
+        bold(title),
+    ];
+    if (agentName)
+        lines.push(`Agent: ${esc(agentName)} \\| Type: ${code(approvalType)}`);
+    if (description)
+        lines.push(`\n${esc(truncateAtWord(description, 300))}`);
+    // Add linked issues if present
+    const linkedIssues = Array.isArray(p.linkedIssues) ? p.linkedIssues : [];
+    if (linkedIssues.length > 0) {
+        lines.push(`\n${bold(`Linked Issues (${String(linkedIssues.length)})`)}`);
+        for (const issue of linkedIssues.slice(0, 5)) {
+            const issueParts = [`${bold(String(issue.identifier ?? "?"))} ${esc(String(issue.title ?? ""))}`];
+            const issueMeta = [];
+            if (issue.status)
+                issueMeta.push(String(issue.status));
+            if (issue.priority)
+                issueMeta.push(String(issue.priority));
+            if (issue.assignee)
+                issueMeta.push(`-> ${String(issue.assignee)}`);
+            if (issueMeta.length > 0)
+                issueParts.push(`\\(${esc(issueMeta.join(" | "))}\\)`);
+            lines.push(issueParts.join(" "));
+        }
+    }
+    return {
+        text: lines.join("\n"),
+        options: {
+            parseMode: "MarkdownV2",
+            inlineKeyboard: [
+                [
+                    { text: "Approve", callback_data: `approve_${approvalId}` },
+                    { text: "Reject", callback_data: `reject_${approvalId}` },
+                ],
+            ],
+        },
+    };
+}
+export function formatAgentError(event) {
+    const p = event.payload;
+    const agentName = String(p.agentName ?? p.name ?? event.entityId);
+    const errorMessage = String(p.error ?? p.message ?? "Unknown error");
+    return {
+        text: [
+            `${esc("❌")} ${bold("Agent Error")}`,
+            `${bold(agentName)} ${esc("encountered an error")}`,
+            `\n${code(truncateAtWord(errorMessage, 500))}`,
+        ].join("\n"),
+        options: { parseMode: "MarkdownV2" },
+    };
+}
+export function formatAgentRunStarted(event) {
+    const p = event.payload;
+    const agentName = String(p.agentName ?? event.entityId);
+    return {
+        text: `${esc("▶️")} ${bold(agentName)} ${esc("started a new run")}`,
+        options: { parseMode: "MarkdownV2", disableNotification: true },
+    };
+}
+export function formatAgentRunFinished(event) {
+    const p = event.payload;
+    const agentName = String(p.agentName ?? event.entityId);
+    return {
+        text: `${esc("⏹️")} ${bold(agentName)} ${esc("completed successfully")}`,
+        options: { parseMode: "MarkdownV2", disableNotification: true },
+    };
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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

package/dist/index.js

@@ -0,0 +1,4 @@
+export { default as manifest } from "./manifest.js";
+export { TelegramAdapter } from "./adapter.js";
+export { EscalationManager } from "./escalation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { PaperclipPluginManifestV1 } from "@paperclipai/plugin-sdk";
+declare const manifest: PaperclipPluginManifestV1;
+export default manifest;

package/dist/manifest.js

@@ -0,0 +1,230 @@
+import { DEFAULT_CONFIG, PLUGIN_ID, PLUGIN_VERSION, MAX_AGENTS_PER_THREAD } from "./constants.js";
+const manifest = {
+    id: PLUGIN_ID,
+    apiVersion: 1,
+    version: PLUGIN_VERSION,
+    displayName: "Telegram Bot",
+    description: "Bidirectional Telegram integration: push notifications, bot commands, escalation to humans, multi-agent sessions (native + ACP), media pipeline with transcription, custom workflow commands, and proactive suggestion watches.",
+    author: "mvanhorn",
+    categories: ["connector", "automation"],
+    capabilities: [
+        "companies.read",
+        "issues.read",
+        "issues.create",
+        "agents.read",
+        "agents.invoke",
+        "agent.sessions.create",
+        "agent.sessions.list",
+        "agent.sessions.send",
+        "agent.sessions.close",
+        "agent.tools.register",
+        "events.subscribe",
+        "events.emit",
+        "plugin.state.read",
+        "plugin.state.write",
+        "http.outbound",
+        "secrets.read-ref",
+        "activity.log.write",
+        "metrics.write",
+        "jobs.schedule",
+    ],
+    entrypoints: {
+        worker: "./dist/worker.js",
+    },
+    instanceConfigSchema: {
+        type: "object",
+        properties: {
+            telegramBotTokenRef: {
+                type: "string",
+                title: "Telegram Bot Token (secret reference)",
+                description: "Reference to the Telegram Bot token stored in your secret provider. Get one from @BotFather.",
+                default: DEFAULT_CONFIG.telegramBotTokenRef,
+            },
+            defaultChatId: {
+                type: "string",
+                title: "Default Chat ID",
+                description: "Telegram chat ID to send notifications to. Use a group chat ID (negative number) or a user chat ID.",
+                default: DEFAULT_CONFIG.defaultChatId,
+            },
+            approvalsChatId: {
+                type: "string",
+                title: "Approvals Chat ID",
+                description: "Chat ID for approval requests. Falls back to default chat.",
+                default: DEFAULT_CONFIG.approvalsChatId,
+            },
+            errorsChatId: {
+                type: "string",
+                title: "Errors Chat ID",
+                description: "Chat ID for agent error notifications. Falls back to default chat.",
+                default: DEFAULT_CONFIG.errorsChatId,
+            },
+            notifyOnIssueCreated: {
+                type: "boolean",
+                title: "Notify on issue created",
+                default: DEFAULT_CONFIG.notifyOnIssueCreated,
+            },
+            notifyOnIssueDone: {
+                type: "boolean",
+                title: "Notify on issue completed",
+                default: DEFAULT_CONFIG.notifyOnIssueDone,
+            },
+            notifyOnApprovalCreated: {
+                type: "boolean",
+                title: "Notify on approval requested",
+                default: DEFAULT_CONFIG.notifyOnApprovalCreated,
+            },
+            notifyOnAgentError: {
+                type: "boolean",
+                title: "Notify on agent error",
+                default: DEFAULT_CONFIG.notifyOnAgentError,
+            },
+            enableCommands: {
+                type: "boolean",
+                title: "Enable bot commands",
+                description: "Allow users to interact with Paperclip via Telegram bot commands (/status, /issues, /agents).",
+                default: DEFAULT_CONFIG.enableCommands,
+            },
+            enableInbound: {
+                type: "boolean",
+                title: "Enable inbound message routing",
+                description: "Route Telegram messages to Paperclip issue comments. Messages sent in reply to a notification get attached to that issue.",
+                default: DEFAULT_CONFIG.enableInbound,
+            },
+            dailyDigestEnabled: {
+                type: "boolean",
+                title: "Daily digest",
+                description: "Send a daily summary of agent activity.",
+                default: DEFAULT_CONFIG.dailyDigestEnabled,
+            },
+            dailyDigestTime: {
+                type: "string",
+                title: "Digest time (HH:MM UTC)",
+                description: "Time to send the daily digest in UTC.",
+                default: DEFAULT_CONFIG.dailyDigestTime,
+            },
+            topicRouting: {
+                type: "boolean",
+                title: "Forum topic routing",
+                description: "Map Telegram forum topics to Paperclip projects. Requires the bot to be in a group with forum topics enabled.",
+                default: DEFAULT_CONFIG.topicRouting,
+            },
+            paperclipBaseUrl: {
+                type: "string",
+                title: "Paperclip Base URL",
+                description: "Base URL of the Paperclip API server.",
+                default: DEFAULT_CONFIG.paperclipBaseUrl,
+            },
+            escalationChatId: {
+                type: "string",
+                title: "Escalation Chat ID",
+                description: "Telegram chat ID where escalations are sent for human review. If empty, escalations are logged but not forwarded.",
+                default: DEFAULT_CONFIG.escalationChatId,
+            },
+            escalationTimeoutMs: {
+                type: "number",
+                title: "Escalation Timeout (ms)",
+                description: "How long to wait for a human response before taking the default action. Default: 900000 (15 minutes).",
+                default: DEFAULT_CONFIG.escalationTimeoutMs,
+            },
+            escalationDefaultAction: {
+                type: "string",
+                title: "Escalation Default Action",
+                description: "What to do when an escalation times out: defer (do nothing), auto_reply (send suggested reply), or close.",
+                enum: ["defer", "auto_reply", "close"],
+                default: DEFAULT_CONFIG.escalationDefaultAction,
+            },
+            escalationHoldMessage: {
+                type: "string",
+                title: "Escalation Hold Message",
+                description: "Message sent to the user when their conversation is escalated to a human.",
+                default: DEFAULT_CONFIG.escalationHoldMessage,
+            },
+            maxAgentsPerThread: {
+                type: "number",
+                title: "Max Agents Per Thread",
+                description: "Maximum number of concurrent agent sessions allowed in a single thread.",
+                default: MAX_AGENTS_PER_THREAD,
+            },
+            briefAgentId: {
+                type: "string",
+                title: "Brief Agent ID",
+                description: "Agent ID for processing media intake briefs. Leave empty to disable media pipeline.",
+                default: DEFAULT_CONFIG.briefAgentId,
+            },
+            briefAgentChatIds: {
+                type: "array",
+                items: { type: "string" },
+                title: "Brief Agent Intake Chat IDs",
+                description: "Telegram chat IDs where media is routed to the Brief Agent. Media in other chats goes to active agent sessions.",
+                default: DEFAULT_CONFIG.briefAgentChatIds,
+            },
+            transcriptionApiKeyRef: {
+                type: "string",
+                title: "Transcription API Key (secret reference)",
+                description: "Reference to OpenAI API key for Whisper transcription of voice/audio messages.",
+                default: DEFAULT_CONFIG.transcriptionApiKeyRef,
+            },
+            maxSuggestionsPerHourPerCompany: {
+                type: "number",
+                title: "Max Suggestions per Hour per Company",
+                description: "Rate limit for proactive watch suggestions.",
+                default: DEFAULT_CONFIG.maxSuggestionsPerHourPerCompany,
+            },
+            watchDeduplicationWindowMs: {
+                type: "number",
+                title: "Watch Deduplication Window (ms)",
+                description: "Suppress duplicate watch suggestions for the same entity within this window. Default: 86400000 (24 hours).",
+                default: DEFAULT_CONFIG.watchDeduplicationWindowMs,
+            },
+        },
+        required: ["telegramBotTokenRef", "defaultChatId"],
+    },
+    jobs: [
+        {
+            jobKey: "telegram-daily-digest",
+            displayName: "Telegram Daily Digest",
+            description: "Send a daily summary of agent activity to Telegram.",
+            schedule: "0 9 * * *",
+        },
+        {
+            jobKey: "check-escalation-timeouts",
+            displayName: "Check Escalation Timeouts",
+            description: "Check for timed-out escalations and apply default actions.",
+            schedule: "* * * * *",
+        },
+        {
+            jobKey: "check-watches",
+            displayName: "Check Proactive Watches",
+            description: "Evaluate registered watches and send suggestions when conditions are met.",
+            schedule: "*/15 * * * *",
+        },
+    ],
+    tools: [
+        {
+            name: "escalate_to_human",
+            displayName: "Escalate to Human",
+            description: "Escalate a conversation to a human when you cannot handle it confidently",
+            parametersSchema: { type: "object" },
+        },
+        {
+            name: "handoff_to_agent",
+            displayName: "Handoff to Agent",
+            description: "Hand off work to another agent in this thread",
+            parametersSchema: { type: "object" },
+        },
+        {
+            name: "discuss_with_agent",
+            displayName: "Discuss with Agent",
+            description: "Start a back-and-forth conversation with another agent",
+            parametersSchema: { type: "object" },
+        },
+        {
+            name: "register_watch",
+            displayName: "Register Watch",
+            description: "Register a proactive watch that monitors entities and sends suggestions",
+            parametersSchema: { type: "object" },
+        },
+    ],
+};
+export default manifest;
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/media-pipeline.d.ts

@@ -0,0 +1,46 @@
+import type { PluginContext } from "@paperclipai/plugin-sdk";
+type MediaConfig = {
+    briefAgentId: string;
+    briefAgentChatIds: string[];
+    transcriptionApiKeyRef: string;
+};
+type TelegramMediaMessage = {
+    message_id: number;
+    chat: {
+        id: number;
+    };
+    message_thread_id?: number;
+    from?: {
+        id: number;
+        username?: string;
+        first_name?: string;
+    };
+    voice?: {
+        file_id: string;
+        duration: number;
+        mime_type?: string;
+    };
+    audio?: {
+        file_id: string;
+        duration: number;
+        title?: string;
+        mime_type?: string;
+    };
+    video_note?: {
+        file_id: string;
+        duration: number;
+    };
+    document?: {
+        file_id: string;
+        file_name?: string;
+        mime_type?: string;
+    };
+    photo?: Array<{
+        file_id: string;
+        width: number;
+        height: number;
+    }>;
+    caption?: string;
+};
+export declare function handleMediaMessage(ctx: PluginContext, token: string, msg: TelegramMediaMessage, config: MediaConfig, companyId: string): Promise<boolean>;
+export {};

package/dist/media-pipeline.js

@@ -0,0 +1,161 @@
+import { sendMessage, escapeMarkdownV2, sendChatAction } from "./telegram-api.js";
+import { METRIC_NAMES } from "./constants.js";
+import { getSessions } from "./acp-bridge.js";
+const TELEGRAM_API = "https://api.telegram.org";
+export async function handleMediaMessage(ctx, token, msg, config, companyId) {
+    const chatId = String(msg.chat.id);
+    const threadId = msg.message_thread_id;
+    // Determine if this is an intake channel (brief agent) or an agent thread
+    const isIntakeChannel = config.briefAgentChatIds.includes(chatId);
+    const hasActiveSession = threadId
+        ? (await getSessions(ctx, chatId, threadId)).some((s) => s.status === "active")
+        : false;
+    if (!isIntakeChannel && !hasActiveSession) {
+        return false; // Not a media-relevant context
+    }
+    await sendChatAction(ctx, token, chatId);
+    // Extract media file info
+    const fileId = extractFileId(msg);
+    if (!fileId)
+        return false;
+    const isAudio = !!(msg.voice || msg.audio || msg.video_note);
+    let textContent = msg.caption ?? "";
+    // Transcribe audio/voice if applicable
+    if (isAudio && config.transcriptionApiKeyRef) {
+        try {
+            const transcription = await transcribeAudio(ctx, token, fileId, config.transcriptionApiKeyRef);
+            if (transcription) {
+                textContent = transcription;
+                // Send transcription preview
+                await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("\ud83c\udfa4")} *Transcription:*\n${escapeMarkdownV2(textContent.slice(0, 500))}${textContent.length > 500 ? escapeMarkdownV2("...") : ""}`, {
+                    parseMode: "MarkdownV2",
+                    messageThreadId: threadId,
+                    replyToMessageId: msg.message_id,
+                });
+            }
+        }
+        catch (err) {
+            ctx.logger.error("Transcription failed", { error: String(err) });
+            textContent = msg.caption ?? "[Audio - transcription failed]";
+        }
+    }
+    if (isIntakeChannel && config.briefAgentId) {
+        // Route to Brief Agent via one-shot invocation
+        try {
+            const prompt = buildBriefPrompt(msg, textContent);
+            const { runId } = await ctx.agents.invoke(config.briefAgentId, companyId, {
+                prompt,
+                reason: "media_intake",
+            });
+            await sendMessage(ctx, token, chatId, `${escapeMarkdownV2("\ud83d\udcdd")} Media sent to Brief Agent \\(run: \`${escapeMarkdownV2(runId)}\`\\)`, {
+                parseMode: "MarkdownV2",
+                messageThreadId: threadId,
+                replyToMessageId: msg.message_id,
+            });
+            ctx.logger.info("Media routed to brief agent", { runId, briefAgentId: config.briefAgentId });
+        }
+        catch (err) {
+            ctx.logger.error("Failed to invoke brief agent", { error: String(err) });
+            await sendMessage(ctx, token, chatId, `Failed to route media to brief agent: ${String(err)}`, { messageThreadId: threadId });
+        }
+    }
+    else if (hasActiveSession && threadId) {
+        // Route to the active agent in the thread
+        const sessions = await getSessions(ctx, chatId, threadId);
+        const activeSessions = sessions.filter((s) => s.status === "active");
+        const target = activeSessions.sort((a, b) => new Date(b.lastActivityAt).getTime() - new Date(a.lastActivityAt).getTime())[0];
+        if (target) {
+            const mediaLabel = isAudio ? "Audio message" : msg.photo ? "Photo" : "Document";
+            const prompt = `[${mediaLabel}] ${textContent || "(no caption)"}`;
+            if (target.transport === "native") {
+                try {
+                    await ctx.agents.sessions.sendMessage(target.sessionId, companyId, {
+                        prompt,
+                        reason: "media_message",
+                    });
+                }
+                catch (err) {
+                    ctx.logger.error("Failed to send media to native session", { error: String(err) });
+                }
+            }
+            else {
+                ctx.events.emit("acp-spawn", companyId, {
+                    type: "message",
+                    sessionId: target.sessionId,
+                    chatId,
+                    threadId,
+                    text: prompt,
+                });
+            }
+        }
+    }
+    await ctx.metrics.write(METRIC_NAMES.mediaProcessed, 1);
+    return true;
+}
+function extractFileId(msg) {
+    if (msg.voice)
+        return msg.voice.file_id;
+    if (msg.audio)
+        return msg.audio.file_id;
+    if (msg.video_note)
+        return msg.video_note.file_id;
+    if (msg.document)
+        return msg.document.file_id;
+    if (msg.photo && msg.photo.length > 0) {
+        // Use the largest photo
+        return msg.photo.sort((a, b) => b.width * b.height - a.width * a.height)[0].file_id;
+    }
+    return null;
+}
+async function transcribeAudio(ctx, botToken, fileId, transcriptionApiKeyRef) {
+    // 1. Get file path from Telegram
+    const fileRes = await ctx.http.fetch(`${TELEGRAM_API}/bot${botToken}/getFile?file_id=${fileId}`, { method: "GET" });
+    const fileData = (await fileRes.json());
+    if (!fileData.ok || !fileData.result?.file_path) {
+        ctx.logger.error("Failed to get file path from Telegram", { fileId });
+        return null;
+    }
+    // 2. Download the file
+    const downloadUrl = `${TELEGRAM_API}/file/bot${botToken}/${fileData.result.file_path}`;
+    const audioRes = await ctx.http.fetch(downloadUrl, { method: "GET" });
+    const audioBlob = await audioRes.blob();
+    // 3. Send to Whisper API
+    const apiKey = await ctx.secrets.resolve(transcriptionApiKeyRef);
+    const formData = new FormData();
+    formData.append("file", audioBlob, "audio.ogg");
+    formData.append("model", "whisper-1");
+    const whisperRes = await ctx.http.fetch("https://api.openai.com/v1/audio/transcriptions", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: formData,
+    });
+    const whisperData = (await whisperRes.json());
+    return whisperData.text ?? null;
+}
+function buildBriefPrompt(msg, textContent) {
+    const parts = [];
+    if (msg.voice) {
+        parts.push(`[Voice message, ${msg.voice.duration}s]`);
+    }
+    else if (msg.audio) {
+        parts.push(`[Audio: ${msg.audio.title ?? "untitled"}, ${msg.audio.duration}s]`);
+    }
+    else if (msg.video_note) {
+        parts.push(`[Video note, ${msg.video_note.duration}s]`);
+    }
+    else if (msg.document) {
+        parts.push(`[Document: ${msg.document.file_name ?? "unknown"}]`);
+    }
+    else if (msg.photo) {
+        parts.push("[Photo]");
+    }
+    if (textContent) {
+        parts.push(textContent);
+    }
+    const sender = msg.from?.username ?? msg.from?.first_name ?? "unknown";
+    parts.push(`\nFrom: ${sender}`);
+    return parts.join("\n");
+}
+//# sourceMappingURL=media-pipeline.js.map

package/dist/media-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-pipeline.js","sourceRoot":"","sources":["../src/media-pipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAqBhD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAkB,EAClB,KAAa,EACb,GAAyB,EACzB,MAAmB,EACnB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,iBAAiB,CAAC;IAEvC,0EAA0E;IAC1E,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,QAAQ;QAC/B,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;QAC/E,CAAC,CAAC,KAAK,CAAC;IAEV,IAAI,CAAC,eAAe,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC,CAAC,+BAA+B;IAC/C,CAAC;IAED,MAAM,cAAc,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEzC,0BAA0B;IAC1B,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAE7D,IAAI,WAAW,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAEpC,uCAAuC;IACvC,IAAI,OAAO,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC/F,IAAI,aAAa,EAAE,CAAC;gBAClB,WAAW,GAAG,aAAa,CAAC;gBAE5B,6BAA6B;gBAC7B,MAAM,WAAW,CACf,GAAG,EACH,KAAK,EACL,MAAM,EACN,GAAG,gBAAgB,CAAC,cAAc,CAAC,sBAAsB,gBAAgB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAChK;oBACE,SAAS,EAAE,YAAY;oBACvB,eAAe,EAAE,QAAQ;oBACzB,gBAAgB,EAAE,GAAG,CAAC,UAAU;iBACjC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjE,WAAW,GAAG,GAAG,CAAC,OAAO,IAAI,gCAAgC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,IAAI,eAAe,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QAC3C,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAClD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE;gBACxE,MAAM;gBACN,MAAM,EAAE,cAAc;aACvB,CAAC,CAAC;YAEH,MAAM,WAAW,CACf,GAAG,EACH,KAAK,EACL,MAAM,EACN,GAAG,gBAAgB,CAAC,cAAc,CAAC,wCAAwC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EACzG;gBACE,SAAS,EAAE,YAAY;gBACvB,eAAe,EAAE,QAAQ;gBACzB,gBAAgB,EAAE,GAAG,CAAC,UAAU;aACjC,CACF,CAAC;YAEF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzE,MAAM,WAAW,CACf,GAAG,EACH,KAAK,EACL,MAAM,EACN,yCAAyC,MAAM,CAAC,GAAG,CAAC,EAAE,EACtD,EAAE,eAAe,EAAE,QAAQ,EAAE,CAC9B,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,IAAI,gBAAgB,IAAI,QAAQ,EAAE,CAAC;QACxC,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CACtF,CAAC,CAAC,CAAC,CAAC;QAEL,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;YAChF,MAAM,MAAM,GAAG,IAAI,UAAU,KAAK,WAAW,IAAI,cAAc,EAAE,CAAC;YAElE,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE;wBACjE,MAAM;wBACN,MAAM,EAAE,eAAe;qBACxB,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE;oBACtC,IAAI,EAAE,SAAS;oBACf,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,MAAM;oBACN,QAAQ;oBACR,IAAI,EAAE,MAAM;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,GAAyB;IAC9C,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IACxC,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;IACxC,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;IAClD,IAAI,GAAG,CAAC,QAAQ;QAAE,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;IAC9C,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,wBAAwB;QACxB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC;IACvF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,GAAkB,EAClB,QAAgB,EAChB,MAAc,EACd,sBAA8B;IAE9B,iCAAiC;IACjC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAClC,GAAG,YAAY,OAAO,QAAQ,oBAAoB,MAAM,EAAE,EAC1D,EAAE,MAAM,EAAE,KAAK,EAAE,CAClB,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAGrC,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QAChD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uBAAuB;IACvB,MAAM,WAAW,GAAG,GAAG,YAAY,YAAY,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IACvF,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAExC,yBAAyB;IACzB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEtC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CACrC,gDAAgD,EAChD;QACE,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;SAClC;QACD,IAAI,EAAE,QAAQ;KACf,CACF,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,MAAM,UAAU,CAAC,IAAI,EAAE,CAAsB,CAAC;IACnE,OAAO,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAyB,EAAE,WAAmB;IACtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,UAAU,KAAK,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IAClF,CAAC;SAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAC;IAC1D,CAAC;SAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC;IACnE,CAAC;SAAM,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,IAAI,SAAS,CAAC;IACvE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IAEhC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/telegram-api.d.ts

@@ -0,0 +1,28 @@
+import type { PluginContext } from "@paperclipai/plugin-sdk";
+type InlineButton = {
+    text: string;
+    callback_data?: string;
+    url?: string;
+};
+type InlineKeyboard = InlineButton[][];
+export type SendMessageOptions = {
+    parseMode?: "MarkdownV2" | "HTML";
+    replyToMessageId?: number;
+    messageThreadId?: number;
+    inlineKeyboard?: InlineKeyboard;
+    disableNotification?: boolean;
+};
+export declare function sendMessage(ctx: PluginContext, token: string, chatId: string, text: string, options?: SendMessageOptions): Promise<number | null>;
+export declare function editMessage(ctx: PluginContext, token: string, chatId: string, messageId: number, text: string, options?: {
+    parseMode?: "MarkdownV2" | "HTML";
+    inlineKeyboard?: InlineKeyboard;
+}): Promise<boolean>;
+export declare function answerCallbackQuery(ctx: PluginContext, token: string, callbackQueryId: string, text: string): Promise<void>;
+export declare function setMyCommands(ctx: PluginContext, token: string, commands: Array<{
+    command: string;
+    description: string;
+}>): Promise<boolean>;
+export declare function sendChatAction(ctx: PluginContext, token: string, chatId: string, action?: "typing"): Promise<void>;
+export declare function escapeMarkdownV2(text: string): string;
+export declare function truncateAtWord(text: string, maxLen: number): string;
+export {};