@coffer-org/plugin-telegram 2.1.0 → 2.2.0

package/dist/runtime/bot.js

@@ -7,6 +7,7 @@ import { NewMessage } from 'teleproto/events/index.js';
 import { handleIncoming, loadGatePolicy, makeLiveChannel, chunk } from '@coffer-org/plugin-orchestrator/runtime';
 import { recordUser, recordAssistant, buildChain } from "./chain-store.js";
 import { loadBotConfig, hasCredentials, loadReasoningDisplay } from "./config.js";
+import { saveUploadBytes } from '@coffer-org/server/uploads';
 import { getLogger } from '@coffer-org/sdk/logger';
 const log = getLogger('telegram');
 const FALLBACK_REPLY_WINDOW_MS = 1_800_000;
@@ -77,6 +78,25 @@ export function makeReplyFactory(t, display) {
         return display === 'separate' ? ch : { ...ch, segment() { } };
     };
 }
+function mediaInfo(message) {
+    const media = message.media;
+    if (!media)
+        return null;
+    const documentName = media.document?.attributes?.find((a) => typeof a.fileName === 'string')?.fileName;
+    if (media.document)
+        return { mime: media.document.mimeType, label: documentName ? path.basename(documentName) : 'attachment' };
+    if (media.photo)
+        return { mime: 'image/jpeg', label: 'photo.jpg' };
+    return null;
+}
+async function downloadAttachment(tg, message, info) {
+    const downloaded = await tg.downloadMedia(message, {});
+    if (!downloaded || typeof downloaded === 'string')
+        throw new Error('Telegram returned no in-memory media bytes');
+    const bytes = Buffer.isBuffer(downloaded) ? downloaded : Buffer.from(downloaded);
+    const stored = await saveUploadBytes(bytes, { originalName: info.label, mime: info.mime });
+    return { name: stored.name, ...(stored.mime ? { mime: stored.mime } : {}), size: stored.size, label: info.label };
+}
 function loadSessionString(file) {
     try {
         return fs.readFileSync(file, 'utf-8');
@@ -182,7 +202,8 @@ export async function startBot(opts = {}) {
             if (message.senderId && meId && message.senderId.toString() === meId)
                 return;
             const text = (message.text || message.message || '').trim();
-            if (!text)
+            const attachmentInfo = mediaInfo(message);
+            if (!text && !attachmentInfo)
                 return;
             let chatLabel = String(event.chatId ?? '?');
             let peer = event.chatId;
@@ -194,7 +215,7 @@ export async function startBot(opts = {}) {
             }
             catch {
             }
-            log.info(`msg [${chatLabel}]: ${text.slice(0, 80)}`);
+            log.info(`msg [${chatLabel}]: ${(text || `[${attachmentInfo?.label ?? 'attachment'}]`).slice(0, 80)}`);
             const stopTyping = startTypingPeer(peer);
             try {
                 const chatId = String(event.chatId ?? '?');
@@ -235,6 +256,25 @@ export async function startBot(opts = {}) {
                     }
                 };
                 const messages = await buildChain(incomingMsgId, { chatId, fetch, botId: meId ?? '' });
+                let preparedMessages;
+                const prepareAttachments = attachmentInfo
+                    ? async () => {
+                        if (preparedMessages)
+                            return preparedMessages;
+                        const attachment = await downloadAttachment(tg, message, attachmentInfo);
+                        await recordUser({
+                            chatId,
+                            msgId: incomingMsgId,
+                            sender: displayName,
+                            text,
+                            attachments: [attachment],
+                            ts: message.date ?? 0,
+                            replyToId,
+                        });
+                        preparedMessages = messages.map((m, i) => i === messages.length - 1 ? { ...m, attachments: [attachment] } : m);
+                        return preparedMessages;
+                    }
+                    : undefined;
                 const reasoningDisplay = await loadReasoningDisplay();
                 const connector = {
                     id: 'telegram',
@@ -259,6 +299,7 @@ export async function startBot(opts = {}) {
                     channelSystem: TELEGRAM_FORMAT,
                     sender: { id: userId, displayName },
                     messages,
+                    ...(prepareAttachments ? { prepareAttachments } : {}),
                 });
             }
             finally {

package/dist/runtime/chain-store.d.ts

@@ -10,6 +10,7 @@ export declare function recordUser(m: {
     msgId: string;
     sender?: string | null;
     text: string;
+    attachments?: NonNullable<ConvMessage['attachments']>;
     ts: number;
     replyToId: string | null;
 }): Promise<void>;

package/dist/runtime/chain-store.js

@@ -4,7 +4,7 @@ const log = getLogger('telegram');
 const CONNECTOR = 'telegram';
 const DEFAULT_MAX_DEPTH = 30;
 export async function recordUser(m) {
-    await putThreadMessage({ connector: CONNECTOR, chatId: m.chatId, msgId: m.msgId, role: 'user', sender: m.sender ?? null, text: m.text, ts: m.ts, replyToId: m.replyToId });
+    await putThreadMessage({ connector: CONNECTOR, chatId: m.chatId, msgId: m.msgId, role: 'user', sender: m.sender ?? null, attachments: m.attachments, text: m.text, ts: m.ts, replyToId: m.replyToId });
 }
 export async function recordAssistant(m) {
     if (m.botMsgId == null)
@@ -36,7 +36,14 @@ export async function buildChain(headMsgId, opts) {
             stored = { msgId: cur, role, sender: null, text: fetched.text, ts: fetched.date, replyToId: fetched.replyToId };
         }
         if (stored.role !== 'reasoning') {
-            acc.push({ role: stored.role, content: stored.text, sender: stored.sender, msgId: stored.msgId, ts: stored.ts });
+            acc.push({
+                role: stored.role,
+                content: stored.text,
+                sender: stored.sender,
+                ...(stored.attachments ? { attachments: stored.attachments } : {}),
+                msgId: stored.msgId,
+                ts: stored.ts,
+            });
         }
         cur = stored.replyToId;
     }

package/dist/schema.js

@@ -4391,11 +4391,11 @@ function resolveUnits(u) {
 //#endregion
 //#region ../sdk/src/currencies.ts
 /**
-* Валюти з вбудованого `Intl` (ISO 4217) — БЕЗ hand-list і без npm-залежності.
-* Коди — `Intl.supportedValuesOf('currency')`; символи/назви локалізовані через
+* Currencies from built-in `Intl` (ISO 4217), with NO hand list or npm dependency.
+* Codes come from `Intl.supportedValuesOf('currency')`; symbols/names are localized through
 * `Intl.NumberFormat`/`Intl.DisplayNames`.
 */
-/** Усі ISO 4217 коди. Fallback — кілька основних (на випадок старого рантайму). */
+/** All ISO 4217 codes. Fallback: several major codes for older runtimes. */
 var CURRENCY_CODES = (() => {
 	try {
 		return Intl.supportedValuesOf("currency");
@@ -4410,26 +4410,26 @@ var CURRENCY_CODES = (() => {
 	}
 })();
 var CODE_SET = new Set(CURRENCY_CODES);
-/** Чи валідний ISO 4217 код. */
+/** Whether an ISO 4217 code is valid. */
 var isCurrencyCode = (c) => CODE_SET.has(c);
 //#endregion
 //#region ../sdk/src/fields/validation.ts
-/** Структуроване повідомлення для zod: JSON {code, params}. Декодує mutate.ts. */
+/** Structured message for zod: JSON {code, params}. Decoded by mutate.ts. */
 function vmsg(code, params) {
 	return JSON.stringify(params ? {
 		code,
 		params
 	} : { code });
 }
-/** v4 error-map: повідомлення для відсутнього значення (колишній required_error). */
+/** v4 error-map: message for a missing value (formerly required_error). */
 function reqErr(code = "required") {
 	return { error: (iss) => iss.input === void 0 ? vmsg(code) : void 0 };
 }
-/** v4 error-map: повідомлення для невалідного типу (колишній invalid_type_error). */
+/** v4 error-map: message for an invalid type (formerly invalid_type_error). */
 function typeErr(code = "invalid_type") {
 	return { error: (iss) => iss.code === "invalid_type" ? vmsg(code) : void 0 };
 }
-/** v4 error-map: required + invalid_type разом (колишні required_error + invalid_type_error). */
+/** v4 error-map: required + invalid_type together (formerly required_error + invalid_type_error). */
 function reqTypeErr() {
 	return { error: (iss) => iss.code === "invalid_type" ? iss.input === void 0 ? vmsg("required") : vmsg("invalid_type") : void 0 };
 }
@@ -4447,10 +4447,10 @@ function jsonValue(raw) {
 	return raw;
 }
 /**
-* Фабрика для полів, що зберігають JSON і валідуються вкладеною zod-схемою.
-* Приймає нативне object/array (native form-state) АБО JSON-рядок (legacy).
-* Single-parse через jsonValue → inner.safeParse → issue `code`; рядок, що не
-* розпарсився, лишається рядком → код 'json'.
+* Factory for fields that store JSON and validate it with a nested zod schema.
+* Accepts a native object/array (native form state) OR a JSON string (legacy).
+* Single parse through jsonValue → inner.safeParse → issue `code`; an unparseable
+* string remains a string → code 'json'.
 */
 function jsonRefined(inner, code) {
 	return unknown().superRefine((raw, ctx) => {
@@ -4522,16 +4522,16 @@ function normalizeOpts(rawIn) {
 //#endregion
 //#region ../sdk/src/field-presets.ts
 /**
-* Пресети полів — тонкі обгортки над базовими примітивами з fields.ts.
+* Field presets are thin wrappers around the primitives in fields.ts.
 *
-* Кожен пресет = один kind (один віджет). Пресети не приймають `format` —
-* вони самі є семантичними типами. min/max/step — через `config`.
+* Each preset = one kind (one widget). Presets do not accept `format`;
+* they are semantic types themselves. min/max/step go through `config`.
 *
-* Пресети додаються до `f` через `composeF`, який гарантує, що жоден пресет
-* не перебиває примітив.
+* Presets are added to `f` through `composeF`, which guarantees no preset
+* overrides a primitive.
 *
-* Циклічний імпорт з fields.ts безпечний: фабрики/хелпери — hoisted-декларації,
-* а пресети викликають їх лише в тілі своїх функцій.
+* The cyclic import from fields.ts is safe: factories/helpers are hoisted declarations,
+* and presets call them only inside their function bodies.
 */
 function email(raw) {
 	const o = normalizeOpts(raw);
@@ -4705,9 +4705,9 @@ function link(raw) {
 	}, o.multiple ?? false));
 }
 var TEL_RE = /^\+?[\d\s()-]{4,}$/;
-/** Loose URL: будь-який scheme:// АБО host-з-крапкою (+опц. порт/шлях). Без пробілів. */
+/** Loose URL: any scheme:// OR dotted host (optional port/path). No spaces. */
 var LINK_RE = /^([a-z][a-z0-9+.-]*:\/\/\S+|[\w-]+(\.[\w-]+)+(:\d+)?(\/\S*)?)$/i;
-/** CSS named colors (CSS Color Module L4) — для f.colorname. */
+/** CSS named colors (CSS Color Module L4) for f.colorname. */
 var CSS_COLOR_NAMES = /* @__PURE__ */ new Set([
 	"aliceblue",
 	"antiquewhite",
@@ -4966,7 +4966,7 @@ function reminder(raw) {
 }
 var _real = real;
 var _int = int;
-/** Відсоток 0..100 — real з rules:{min:0,max:100}. */
+/** Percentage 0..100 — real with rules:{min:0,max:100}. */
 function percent(o) {
 	return _real({
 		...o,
@@ -4977,7 +4977,7 @@ function percent(o) {
 		}
 	});
 }
-/** Рік — int з rules:{min:1900,max:2100}; межі можна перекрити через rules.min/max. */
+/** Year — int with rules:{min:1900,max:2100}; bounds can be overridden via rules.min/max. */
 function year(o) {
 	return _int({
 		...o,
@@ -6027,13 +6027,6 @@ function wrapKey(opts, meta) {
 			role: opts.role
 		}
 	};
-	if (opts.pinned) m = {
-		...m,
-		hints: {
-			...m.hints,
-			pinned: true
-		}
-	};
 	if (opts.default !== void 0) m = {
 		...m,
 		default: opts.default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-telegram",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -25,9 +25,9 @@
     "test": "node --import tsx --test \"src/runtime/*.test.ts\""
   },
   "dependencies": {
-    "@coffer-org/plugin-orchestrator": "^2.1.0",
-    "@coffer-org/sdk": "^2.1.0",
-    "@coffer-org/server": "^2.2.0",
+    "@coffer-org/plugin-orchestrator": "^2.2.0",
+    "@coffer-org/sdk": "^2.1.1",
+    "@coffer-org/server": "^2.3.0",
     "input": "^1.0.1",
     "teleproto": "^1.228.1"
   },