@elizaos/plugin-telegram 1.0.10 → 1.6.2

package/dist/messageManager.d.ts

@@ -1,7 +1,19 @@
-import { type Content, type IAgentRuntime } from '@elizaos/core';
+import { type Content, type IAgentRuntime, type Media } from '@elizaos/core';
 import type { Message, Update } from '@telegraf/types';
 import type { Context, NarrowedContext, Telegraf } from 'telegraf';
-import { TelegramContent } from './types';
+import { type TelegramContent } from './types';
+/**
+ * Interface for structured document processing results.
+ */
+interface DocumentProcessingResult {
+    title: string;
+    fullText: string;
+    formattedDescription: string;
+    fileName: string;
+    mimeType: string | undefined;
+    fileSize: number | undefined;
+    error?: string;
+}
 /**
  * Enum representing different types of media.
  * @enum { string }
@@ -37,6 +49,37 @@ export declare class MessageManager {
     processImage(message: Message): Promise<{
         description: string;
     } | null>;
+    /**
+     * Process a document from a Telegram message to extract the document URL and description.
+     * Handles PDFs and other document types by converting them to text when possible.
+     *
+     * @param {Message} message - The Telegram message object containing the document.
+     * @returns {Promise<{ description: string } | null>} The description of the processed document or null if no document found.
+     */
+    processDocument(message: Message): Promise<DocumentProcessingResult | null>;
+    /**
+     * Get the appropriate document processor based on MIME type.
+     */
+    private getDocumentProcessor;
+    /**
+     * Process PDF documents by converting them to text.
+     */
+    private processPdfDocument;
+    /**
+     * Process text documents by fetching their content.
+     */
+    private processTextDocument;
+    /**
+     * Processes the message content, documents, and images to generate
+     * processed content and media attachments.
+     *
+     * @param {Message} message The message to process
+     * @returns {Promise<{ processedContent: string; attachments: Media[] }>} Processed content and media attachments
+     */
+    processMessage(message: Message): Promise<{
+        processedContent: string;
+        attachments: Media[];
+    }>;
     /**
      * Sends a message in chunks, handling attachments and splitting the message if necessary
      *
@@ -85,3 +128,4 @@ export declare class MessageManager {
      */
     sendMessage(chatId: number | string, content: Content, replyToMessageId?: number): Promise<Message.TextMessage[]>;
 }
+export {};

package/dist/utils.d.ts

@@ -1,5 +1,5 @@
-import { InlineKeyboardButton } from '@telegraf/types';
-import { Button } from './types';
+import type { Button } from './types';
+import type { InlineKeyboardButton } from '@telegraf/types';
 /**
  * This function converts standard markdown to Telegram MarkdownV2.
  *
@@ -27,3 +27,9 @@ export declare function splitMessage(text: string, maxLength?: number): string[]
  * @returns {InlineKeyboardButton[]} Array of Telegram buttons
  */
 export declare function convertToTelegramButtons(buttons?: Button[] | null): InlineKeyboardButton[];
+/**
+ * Clean text by removing all NULL (\u0000) characters
+ * @param {string | undefined | null} text - The text to clean
+ * @returns {string} The cleaned text
+ */
+export declare function cleanText(text: string | undefined | null): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-telegram",
-  "version": "1.0.10",
+  "version": "1.6.2",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,7 +18,7 @@
     "dist"
   ],
   "dependencies": {
-    "@elizaos/core": "^1.0.19",
+    "@elizaos/core": "^1.6.2",
     "@telegraf/types": "7.1.0",
     "@types/node": "^24.0.10",
     "strip-literal": "^3.0.0",