@iletai/nzb 1.4.4 → 1.4.6

package/dist/copilot/orchestrator.js

@@ -215,9 +215,11 @@ async function createOrResumeSession() {
     const recentHistory = getRecentConversation(10);
     if (recentHistory) {
         console.log(`[nzb] Injecting recent conversation context into new session (non-blocking)`);
-        session.sendAndWait({
+        session
+            .sendAndWait({
             prompt: `[System: Session recovered] Your previous session was lost. Here's the recent conversation for context — do NOT respond to these messages, just absorb the context silently:\n\n${recentHistory}\n\n(End of recovery context. Wait for the next real message.)`,
-        }, 20_000).catch((err) => {
+        }, 20_000)
+            .catch((err) => {
             console.log(`[nzb] Context recovery injection failed (non-fatal): ${err instanceof Error ? err.message : err}`);
         });
     }
@@ -262,7 +264,12 @@ async function executeOnSession(prompt, callback, onToolEvent, onUsage) {
     const unsubToolStart = session.on("tool.execution_start", (event) => {
         const toolName = event?.data?.toolName || event?.data?.name || "tool";
         const args = event?.data?.arguments;
-        const detail = args?.description || args?.command?.slice(0, 80) || args?.intent || args?.pattern || args?.prompt?.slice(0, 80) || undefined;
+        const detail = args?.description ||
+            args?.command?.slice(0, 80) ||
+            args?.intent ||
+            args?.pattern ||
+            args?.prompt?.slice(0, 80) ||
+            undefined;
         onToolEvent?.({ type: "tool_start", toolName, detail });
     });
     const unsubToolDone = session.on("tool.execution_complete", (event) => {
@@ -377,7 +384,15 @@ export async function sendToOrchestrator(prompt, source, callback, onToolEvent,
         for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
             try {
                 const finalContent = await new Promise((resolve, reject) => {
-                    const item = { prompt: taggedPrompt, callback, onToolEvent, onUsage, sourceChannel, resolve, reject };
+                    const item = {
+                        prompt: taggedPrompt,
+                        callback,
+                        onToolEvent,
+                        onUsage,
+                        sourceChannel,
+                        resolve,
+                        reject,
+                    };
                     if (source.type === "background") {
                         // Background results go to the back of the queue
                         messageQueue.push(item);
@@ -416,7 +431,7 @@ export async function sendToOrchestrator(prompt, source, callback, onToolEvent,
                 catch {
                     /* best-effort */
                 }
-                callback(finalContent, true, { assistantLogId });
+                await callback(finalContent, true, { assistantLogId });
                 // Auto-continue: if the response was cut short by timeout, automatically
                 // send a follow-up "Continue" message so the user doesn't have to
                 if (finalContent.includes("⏱ Response was cut short (timeout)")) {
@@ -454,7 +469,7 @@ export async function sendToOrchestrator(prompt, source, callback, onToolEvent,
                     continue;
                 }
                 console.error(`[nzb] Error processing message: ${msg}`);
-                callback(`Error: ${msg}`, true);
+                await callback(`Error: ${msg}`, true);
                 return;
             }
         }

package/dist/store/db.js

@@ -136,7 +136,8 @@ export function getConversationContext(telegramMsgId) {
     if (!row)
         return undefined;
     // Fetch 4 rows before + the target + 4 rows after (handles ID gaps from pruning)
-    const rows = db.prepare(`
+    const rows = db
+        .prepare(`
 		SELECT role, content, source, ts FROM (
 			SELECT * FROM conversation_log WHERE id < ? ORDER BY id DESC LIMIT 4
 		)
@@ -146,7 +147,8 @@ export function getConversationContext(telegramMsgId) {
 		SELECT role, content, source, ts FROM (
 			SELECT * FROM conversation_log WHERE id > ? ORDER BY id ASC LIMIT 4
 		)
-	`).all(row.id, row.id, row.id);
+	`)
+        .all(row.id, row.id, row.id);
     if (rows.length === 0)
         return undefined;
     return rows

package/dist/telegram/bot.js

@@ -2,13 +2,15 @@ import { autoRetry } from "@grammyjs/auto-retry";
 import { Menu } from "@grammyjs/menu";
 import { Bot, InlineKeyboard, Keyboard } from "grammy";
 import { Agent as HttpsAgent } from "https";
-import { rmSync } from "fs";
 import { config, persistEnvVar, persistModel } from "../config.js";
 import { cancelCurrentMessage, getQueueSize, getWorkers, sendToOrchestrator } from "../copilot/orchestrator.js";
 import { listSkills } from "../copilot/skills.js";
 import { restartDaemon } from "../daemon.js";
 import { searchMemories } from "../store/db.js";
 import { chunkMessage, escapeHtml, formatToolSummaryExpandable, toTelegramHTML } from "./formatter.js";
+import { registerCallbackHandlers } from "./handlers/callbacks.js";
+import { sendFormattedReply } from "./handlers/helpers.js";
+import { registerMediaHandlers } from "./handlers/media.js";
 import { initLogChannel, logDebug, logError, logInfo } from "./log-channel.js";
 let bot;
 const startedAt = Date.now();
@@ -20,61 +22,6 @@ function getUptimeStr() {
     const seconds = uptime % 60;
     return hours > 0 ? `${hours}h ${minutes}m ${seconds}s` : minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
 }
-/**
- * Send a formatted HTML reply with multi-chunk support and fallback to plain text.
- * Consolidates the repeated toTelegramHTML → chunkMessage → fallback → send pattern.
- */
-async function sendFormattedReply(botInstance, chatId, text, opts) {
-    const formatted = toTelegramHTML(text);
-    const chunks = chunkMessage(formatted);
-    const fallbackChunks = chunkMessage(text);
-    let firstMsgId;
-    for (let i = 0; i < chunks.length; i++) {
-        if (i > 0)
-            await new Promise((r) => setTimeout(r, 300));
-        const pageTag = chunks.length > 1 ? `📄 ${i + 1}/${chunks.length}\n` : "";
-        const replyParams = i === 0 && opts?.replyTo ? { message_id: opts.replyTo } : undefined;
-        try {
-            const sent = await botInstance.api.sendMessage(chatId, pageTag + chunks[i], {
-                parse_mode: "HTML",
-                reply_parameters: replyParams,
-            });
-            if (i === 0)
-                firstMsgId = sent.message_id;
-        }
-        catch {
-            try {
-                const sent = await botInstance.api.sendMessage(chatId, pageTag + (fallbackChunks[i] ?? chunks[i]), {
-                    reply_parameters: replyParams,
-                });
-                if (i === 0)
-                    firstMsgId = sent.message_id;
-            }
-            catch { }
-        }
-    }
-    if (opts?.assistantLogId && firstMsgId) {
-        try {
-            const { setConversationTelegramMsgId } = await import("../store/db.js");
-            setConversationTelegramMsgId(opts.assistantLogId, firstMsgId);
-        }
-        catch { }
-    }
-    try {
-        await botInstance.api.setMessageReaction(chatId, opts?.replyTo ?? 0, [{ type: "emoji", emoji: "👍" }]);
-    }
-    catch { }
-    return firstMsgId;
-}
-/** Remove a temp directory after a delay (gives orchestrator time to use the file). */
-function scheduleTempCleanup(dirPath, delayMs = 5 * 60_000) {
-    setTimeout(() => {
-        try {
-            rmSync(dirPath, { recursive: true, force: true });
-        }
-        catch { }
-    }, delayMs);
-}
 // Settings sub-menu
 const settingsMenu = new Menu("settings-menu")
     .text((ctx) => `${config.showReasoning ? "✅" : "❌"} Show Reasoning`, async (ctx) => {
@@ -211,47 +158,15 @@ export function createBot() {
     });
     // Register interactive menu plugin
     bot.use(mainMenu);
-    // Callback handlers for contextual inline buttons
-    bot.callbackQuery("retry", async (ctx) => {
-        await ctx.answerCallbackQuery({ text: "Retrying..." });
-        const originalMsg = ctx.callbackQuery.message;
-        if (originalMsg?.reply_to_message && "text" in originalMsg.reply_to_message && originalMsg.reply_to_message.text) {
-            const retryPrompt = originalMsg.reply_to_message.text;
-            const chatId = ctx.chat.id;
-            sendToOrchestrator(retryPrompt, { type: "telegram", chatId, messageId: originalMsg.message_id }, (text, done) => {
-                if (done) {
-                    void (async () => {
-                        try {
-                            const formatted = toTelegramHTML(text);
-                            const chunks = chunkMessage(formatted);
-                            await bot.api.editMessageText(chatId, originalMsg.message_id, chunks[0], { parse_mode: "HTML" });
-                        }
-                        catch {
-                            try {
-                                await ctx.reply(text);
-                            }
-                            catch { }
-                        }
-                    })();
-                }
-            });
-        }
-    });
-    bot.callbackQuery("explain_error", async (ctx) => {
-        await ctx.answerCallbackQuery({ text: "Explaining..." });
-        const originalMsg = ctx.callbackQuery.message;
-        if (originalMsg && "text" in originalMsg && originalMsg.text) {
-            const chatId = ctx.chat.id;
-            sendToOrchestrator(`Explain this error in simple terms and suggest a fix:\n${originalMsg.text}`, { type: "telegram", chatId, messageId: originalMsg.message_id }, (text, done) => {
-                if (done)
-                    void sendFormattedReply(bot, chatId, text);
-            });
-        }
-    });
+    // Register callback + media handlers from extracted modules
+    registerCallbackHandlers(bot);
     // Persistent reply keyboard — quick actions always visible below chat input
     const replyKeyboard = new Keyboard()
-        .text("📊 Status").text("❌ Cancel").row()
-        .text("🧠 Memory").text("🔄 Restart")
+        .text("📊 Status")
+        .text("❌ Cancel")
+        .row()
+        .text("🧠 Memory")
+        .text("🔄 Restart")
         .resized()
         .persistent();
     // /start and /help — with inline menu + reply keyboard
@@ -393,7 +308,9 @@ export function createBot() {
     });
     bot.hears("🔄 Restart", async (ctx) => {
         await ctx.reply("Restarting NZB...");
-        setTimeout(() => { restartDaemon().catch(console.error); }, 500);
+        setTimeout(() => {
+            restartDaemon().catch(console.error);
+        }, 500);
     });
     // Handle all text messages — progressive streaming with tool event feedback
     bot.on("message:text", async (ctx) => {
@@ -406,7 +323,9 @@ export function createBot() {
         try {
             await ctx.react("👀");
         }
-        catch { /* reactions may not be available */ }
+        catch {
+            /* reactions may not be available */
+        }
         // Typing indicator — keeps sending "typing" action every 4s until the final
         // response is delivered. We use bot.api directly for reliability, and await the
         // first call so the user sees typing immediately before any async work begins.
@@ -561,8 +480,8 @@ export function createBot() {
                 const assistantLogId = meta?.assistantLogId;
                 const elapsed = ((Date.now() - handlerStartTime) / 1000).toFixed(1);
                 void logInfo(`✅ Response done (${elapsed}s, ${toolHistory.length} tools, ${text.length} chars)`);
-                // Wait for in-flight edits to finish before sending the final response
-                void editChain.then(async () => {
+                // Return the edit chain so callers can await final delivery
+                return editChain.then(async () => {
                     // Format error messages with a distinct visual
                     const isError = text.startsWith("Error:");
                     if (isError) {
@@ -588,7 +507,7 @@ export function createBot() {
                     }
                     let textWithMeta = text;
                     if (usageInfo) {
-                        const fmtTokens = (n) => n >= 1000 ? `${(n / 1000).toFixed(1)}K` : String(n);
+                        const fmtTokens = (n) => (n >= 1000 ? `${(n / 1000).toFixed(1)}K` : String(n));
                         const parts = [];
                         if (usageInfo.model)
                             parts.push(usageInfo.model);
@@ -708,7 +627,9 @@ export function createBot() {
                     try {
                         await bot.api.setMessageReaction(chatId, userMessageId, [{ type: "emoji", emoji: "👍" }]);
                     }
-                    catch { /* reactions may not be available */ }
+                    catch {
+                        /* reactions may not be available */
+                    }
                 });
             }
             else {
@@ -731,183 +652,8 @@ export function createBot() {
             }
         }, onToolEvent, onUsage);
     });
-    // Handle photo messages — download and pass to AI as image description request
-    bot.on("message:photo", async (ctx) => {
-        const chatId = ctx.chat.id;
-        const userMessageId = ctx.message.message_id;
-        const caption = ctx.message.caption || "Describe this image and analyze what you see.";
-        void logInfo(`📸 Photo received: ${caption.slice(0, 80)}`);
-        try {
-            await ctx.react("👀");
-        }
-        catch { }
-        const photo = ctx.message.photo[ctx.message.photo.length - 1];
-        try {
-            const file = await ctx.api.getFile(photo.file_id);
-            const filePath = file.file_path;
-            if (!filePath) {
-                await ctx.reply("❌ Could not download photo.", { reply_parameters: { message_id: userMessageId } });
-                return;
-            }
-            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
-            const { mkdtempSync, writeFileSync } = await import("fs");
-            const { join } = await import("path");
-            const { tmpdir } = await import("os");
-            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-photo-"));
-            const ext = filePath.split(".").pop() || "jpg";
-            const localPath = join(tmpDir, `photo.${ext}`);
-            const response = await fetch(url);
-            const buffer = Buffer.from(await response.arrayBuffer());
-            writeFileSync(localPath, buffer);
-            scheduleTempCleanup(tmpDir);
-            const prompt = `[User sent a photo saved at: ${localPath}]\n\nCaption: ${caption}\n\nPlease analyze this image. The file is at ${localPath} — you can use bash to view it with tools if needed.`;
-            sendToOrchestrator(prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done) => {
-                if (done)
-                    void sendFormattedReply(bot, chatId, text, { replyTo: userMessageId });
-            });
-        }
-        catch (err) {
-            await ctx.reply(`❌ Error processing photo: ${err instanceof Error ? err.message : String(err)}`, {
-                reply_parameters: { message_id: userMessageId },
-            });
-        }
-    });
-    // Handle document/file messages — download and pass to AI
-    bot.on("message:document", async (ctx) => {
-        const chatId = ctx.chat.id;
-        const userMessageId = ctx.message.message_id;
-        const doc = ctx.message.document;
-        const caption = ctx.message.caption || `Analyze this file: ${doc.file_name || "unknown"}`;
-        void logInfo(`📄 Document received: ${doc.file_name || "unknown"} (${doc.file_size || 0} bytes)`);
-        try {
-            await ctx.react("👀");
-        }
-        catch { }
-        // Limit file size to 10MB
-        if (doc.file_size && doc.file_size > 10 * 1024 * 1024) {
-            await ctx.reply("❌ File too large (max 10MB).", { reply_parameters: { message_id: userMessageId } });
-            return;
-        }
-        try {
-            const file = await ctx.api.getFile(doc.file_id);
-            const filePath = file.file_path;
-            if (!filePath) {
-                await ctx.reply("❌ Could not download file.", { reply_parameters: { message_id: userMessageId } });
-                return;
-            }
-            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
-            const { mkdtempSync, writeFileSync } = await import("fs");
-            const { join } = await import("path");
-            const { tmpdir } = await import("os");
-            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-doc-"));
-            const localPath = join(tmpDir, doc.file_name || "file");
-            const response = await fetch(url);
-            const buffer = Buffer.from(await response.arrayBuffer());
-            writeFileSync(localPath, buffer);
-            scheduleTempCleanup(tmpDir);
-            const prompt = `[User sent a file: ${doc.file_name || "unknown"} (${doc.file_size || 0} bytes), saved at: ${localPath}]\n\nCaption: ${caption}\n\nPlease analyze this file. You can read it with bash tools.`;
-            sendToOrchestrator(prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done) => {
-                if (done)
-                    void sendFormattedReply(bot, chatId, text, { replyTo: userMessageId });
-            });
-        }
-        catch (err) {
-            await ctx.reply(`❌ Error processing file: ${err instanceof Error ? err.message : String(err)}`, {
-                reply_parameters: { message_id: userMessageId },
-            });
-        }
-    });
-    // Handle voice messages — download, transcribe via Whisper, send to AI
-    bot.on("message:voice", async (ctx) => {
-        const chatId = ctx.chat.id;
-        const userMessageId = ctx.message.message_id;
-        const duration = ctx.message.voice.duration;
-        void logInfo(`🎤 Voice received: ${duration}s`);
-        try {
-            await ctx.react("👀");
-        }
-        catch { }
-        // Limit voice duration to 5 minutes
-        if (duration > 300) {
-            await ctx.reply("❌ Voice too long (max 5 min).", { reply_parameters: { message_id: userMessageId } });
-            return;
-        }
-        // If voice is a reply, include context
-        let voiceReplyContext = "";
-        const voiceReplyMsg = ctx.message.reply_to_message;
-        if (voiceReplyMsg && "text" in voiceReplyMsg && voiceReplyMsg.text) {
-            const { getConversationContext } = await import("../store/db.js");
-            const context = getConversationContext(voiceReplyMsg.message_id);
-            if (context) {
-                voiceReplyContext = `[Continuing from earlier conversation:]\n---\n${context}\n---\n\n`;
-            }
-            else {
-                const quoted = voiceReplyMsg.text.length > 500 ? voiceReplyMsg.text.slice(0, 500) + "…" : voiceReplyMsg.text;
-                voiceReplyContext = `[Replying to: "${quoted}"]\n\n`;
-            }
-        }
-        try {
-            const file = await ctx.api.getFile(ctx.message.voice.file_id);
-            const filePath = file.file_path;
-            if (!filePath) {
-                await ctx.reply("❌ Could not download voice.", { reply_parameters: { message_id: userMessageId } });
-                return;
-            }
-            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
-            const { mkdtempSync, writeFileSync } = await import("fs");
-            const { join } = await import("path");
-            const { tmpdir } = await import("os");
-            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-voice-"));
-            const ext = filePath.split(".").pop() || "oga";
-            const localPath = join(tmpDir, `voice.${ext}`);
-            const response = await fetch(url);
-            const buffer = Buffer.from(await response.arrayBuffer());
-            writeFileSync(localPath, buffer);
-            scheduleTempCleanup(tmpDir);
-            let prompt;
-            if (config.openaiApiKey) {
-                // Transcribe using OpenAI Whisper API
-                try {
-                    const formData = new FormData();
-                    formData.append("file", new Blob([buffer], { type: "audio/ogg" }), `voice.${ext}`);
-                    formData.append("model", "whisper-1");
-                    const whisperResp = await fetch("https://api.openai.com/v1/audio/transcriptions", {
-                        method: "POST",
-                        headers: { Authorization: `Bearer ${config.openaiApiKey}` },
-                        body: formData,
-                    });
-                    if (!whisperResp.ok) {
-                        const errText = await whisperResp.text();
-                        throw new Error(`Whisper API ${whisperResp.status}: ${errText.slice(0, 200)}`);
-                    }
-                    const result = (await whisperResp.json());
-                    const transcript = result.text?.trim();
-                    if (!transcript) {
-                        prompt = `[User sent a voice message (${duration}s) but transcription was empty. File saved at: ${localPath}]`;
-                    }
-                    else {
-                        prompt = `[Voice message transcribed (${duration}s)]: ${transcript}`;
-                    }
-                }
-                catch (whisperErr) {
-                    console.error("[nzb] Whisper transcription failed:", whisperErr instanceof Error ? whisperErr.message : whisperErr);
-                    prompt = `[User sent a voice message (${duration}s), saved at: ${localPath}. Transcription failed: ${whisperErr instanceof Error ? whisperErr.message : String(whisperErr)}]`;
-                }
-            }
-            else {
-                prompt = `[User sent a voice message (${duration}s), saved at: ${localPath}. No OPENAI_API_KEY configured for transcription. You can tell the user to set it up in ~/.nzb/.env]`;
-            }
-            sendToOrchestrator(voiceReplyContext + prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done, meta) => {
-                if (done)
-                    void sendFormattedReply(bot, chatId, text, { replyTo: userMessageId, assistantLogId: meta?.assistantLogId });
-            });
-        }
-        catch (err) {
-            await ctx.reply(`❌ Error processing voice: ${err instanceof Error ? err.message : String(err)}`, {
-                reply_parameters: { message_id: userMessageId },
-            });
-        }
-    });
+    // Register media handlers (photo, document, voice) from extracted module
+    registerMediaHandlers(bot);
     // Global error handler — prevents unhandled errors from crashing the bot
     bot.catch((err) => {
         const ctx = err.ctx;

package/dist/telegram/handlers/callbacks.js

@@ -0,0 +1,43 @@
+import { sendToOrchestrator } from "../../copilot/orchestrator.js";
+import { chunkMessage, toTelegramHTML } from "../formatter.js";
+import { sendFormattedReply } from "./helpers.js";
+/** Register inline keyboard callback handlers (Retry, Explain). */
+export function registerCallbackHandlers(bot) {
+    bot.callbackQuery("retry", async (ctx) => {
+        await ctx.answerCallbackQuery({ text: "Retrying..." });
+        const originalMsg = ctx.callbackQuery.message;
+        if (originalMsg?.reply_to_message && "text" in originalMsg.reply_to_message && originalMsg.reply_to_message.text) {
+            const retryPrompt = originalMsg.reply_to_message.text;
+            const chatId = ctx.chat.id;
+            sendToOrchestrator(retryPrompt, { type: "telegram", chatId, messageId: originalMsg.message_id }, (text, done) => {
+                if (done) {
+                    void (async () => {
+                        try {
+                            const formatted = toTelegramHTML(text);
+                            const chunks = chunkMessage(formatted);
+                            await bot.api.editMessageText(chatId, originalMsg.message_id, chunks[0], { parse_mode: "HTML" });
+                        }
+                        catch {
+                            try {
+                                await ctx.reply(text);
+                            }
+                            catch { }
+                        }
+                    })();
+                }
+            });
+        }
+    });
+    bot.callbackQuery("explain_error", async (ctx) => {
+        await ctx.answerCallbackQuery({ text: "Explaining..." });
+        const originalMsg = ctx.callbackQuery.message;
+        if (originalMsg && "text" in originalMsg && originalMsg.text) {
+            const chatId = ctx.chat.id;
+            sendToOrchestrator(`Explain this error in simple terms and suggest a fix:\n${originalMsg.text}`, { type: "telegram", chatId, messageId: originalMsg.message_id }, (text, done) => {
+                if (done)
+                    void sendFormattedReply(bot, chatId, text);
+            });
+        }
+    });
+}
+//# sourceMappingURL=callbacks.js.map

package/dist/telegram/handlers/helpers.js

@@ -0,0 +1,58 @@
+import { rmSync } from "fs";
+import { chunkMessage, toTelegramHTML } from "../formatter.js";
+/**
+ * Send a formatted HTML reply with multi-chunk support and fallback to plain text.
+ * Consolidates the repeated toTelegramHTML → chunkMessage → fallback → send pattern.
+ */
+export async function sendFormattedReply(botInstance, chatId, text, opts) {
+    const formatted = toTelegramHTML(text);
+    const chunks = chunkMessage(formatted);
+    const fallbackChunks = chunkMessage(text);
+    let firstMsgId;
+    for (let i = 0; i < chunks.length; i++) {
+        if (i > 0)
+            await new Promise((r) => setTimeout(r, 300));
+        const pageTag = chunks.length > 1 ? `📄 ${i + 1}/${chunks.length}\n` : "";
+        const replyParams = i === 0 && opts?.replyTo ? { message_id: opts.replyTo } : undefined;
+        try {
+            const sent = await botInstance.api.sendMessage(chatId, pageTag + chunks[i], {
+                parse_mode: "HTML",
+                reply_parameters: replyParams,
+            });
+            if (i === 0)
+                firstMsgId = sent.message_id;
+        }
+        catch {
+            try {
+                const sent = await botInstance.api.sendMessage(chatId, pageTag + (fallbackChunks[i] ?? chunks[i]), {
+                    reply_parameters: replyParams,
+                });
+                if (i === 0)
+                    firstMsgId = sent.message_id;
+            }
+            catch { }
+        }
+    }
+    if (opts?.assistantLogId && firstMsgId) {
+        try {
+            const { setConversationTelegramMsgId } = await import("../../store/db.js");
+            setConversationTelegramMsgId(opts.assistantLogId, firstMsgId);
+        }
+        catch { }
+    }
+    try {
+        await botInstance.api.setMessageReaction(chatId, opts?.replyTo ?? 0, [{ type: "emoji", emoji: "👍" }]);
+    }
+    catch { }
+    return firstMsgId;
+}
+/** Remove a temp directory after a delay (gives orchestrator time to use the file). */
+export function scheduleTempCleanup(dirPath, delayMs = 5 * 60_000) {
+    setTimeout(() => {
+        try {
+            rmSync(dirPath, { recursive: true, force: true });
+        }
+        catch { }
+    }, delayMs);
+}
+//# sourceMappingURL=helpers.js.map

package/dist/telegram/handlers/media.js

@@ -0,0 +1,185 @@
+import { config } from "../../config.js";
+import { sendToOrchestrator } from "../../copilot/orchestrator.js";
+import { logInfo } from "../log-channel.js";
+import { sendFormattedReply, scheduleTempCleanup } from "./helpers.js";
+/** Register photo, document, and voice message handlers on the bot. */
+export function registerMediaHandlers(bot) {
+    // Handle photo messages — download and pass to AI
+    bot.on("message:photo", async (ctx) => {
+        const chatId = ctx.chat.id;
+        const userMessageId = ctx.message.message_id;
+        const caption = ctx.message.caption || "Describe this image and analyze what you see.";
+        void logInfo(`📸 Photo received: ${caption.slice(0, 80)}`);
+        try {
+            await ctx.react("👀");
+        }
+        catch { }
+        const photo = ctx.message.photo[ctx.message.photo.length - 1];
+        try {
+            const file = await ctx.api.getFile(photo.file_id);
+            const filePath = file.file_path;
+            if (!filePath) {
+                await ctx.reply("❌ Could not download photo.", { reply_parameters: { message_id: userMessageId } });
+                return;
+            }
+            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
+            const { mkdtempSync, writeFileSync } = await import("fs");
+            const { join } = await import("path");
+            const { tmpdir } = await import("os");
+            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-photo-"));
+            const ext = filePath.split(".").pop() || "jpg";
+            const localPath = join(tmpDir, `photo.${ext}`);
+            const response = await fetch(url);
+            const buffer = Buffer.from(await response.arrayBuffer());
+            writeFileSync(localPath, buffer);
+            scheduleTempCleanup(tmpDir);
+            const prompt = `[User sent a photo saved at: ${localPath}]\n\nCaption: ${caption}\n\nPlease analyze this image. The file is at ${localPath} — you can use bash to view it with tools if needed.`;
+            sendToOrchestrator(prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done) => {
+                if (done)
+                    void sendFormattedReply(bot, chatId, text, { replyTo: userMessageId });
+            });
+        }
+        catch (err) {
+            await ctx.reply(`❌ Error processing photo: ${err instanceof Error ? err.message : String(err)}`, {
+                reply_parameters: { message_id: userMessageId },
+            });
+        }
+    });
+    // Handle document/file messages — download and pass to AI
+    bot.on("message:document", async (ctx) => {
+        const chatId = ctx.chat.id;
+        const userMessageId = ctx.message.message_id;
+        const doc = ctx.message.document;
+        const caption = ctx.message.caption || `Analyze this file: ${doc.file_name || "unknown"}`;
+        void logInfo(`📄 Document received: ${doc.file_name || "unknown"} (${doc.file_size || 0} bytes)`);
+        try {
+            await ctx.react("👀");
+        }
+        catch { }
+        if (doc.file_size && doc.file_size > 10 * 1024 * 1024) {
+            await ctx.reply("❌ File too large (max 10MB).", { reply_parameters: { message_id: userMessageId } });
+            return;
+        }
+        try {
+            const file = await ctx.api.getFile(doc.file_id);
+            const filePath = file.file_path;
+            if (!filePath) {
+                await ctx.reply("❌ Could not download file.", { reply_parameters: { message_id: userMessageId } });
+                return;
+            }
+            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
+            const { mkdtempSync, writeFileSync } = await import("fs");
+            const { join } = await import("path");
+            const { tmpdir } = await import("os");
+            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-doc-"));
+            const localPath = join(tmpDir, doc.file_name || "file");
+            const response = await fetch(url);
+            const buffer = Buffer.from(await response.arrayBuffer());
+            writeFileSync(localPath, buffer);
+            scheduleTempCleanup(tmpDir);
+            const prompt = `[User sent a file: ${doc.file_name || "unknown"} (${doc.file_size || 0} bytes), saved at: ${localPath}]\n\nCaption: ${caption}\n\nPlease analyze this file. You can read it with bash tools.`;
+            sendToOrchestrator(prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done) => {
+                if (done)
+                    void sendFormattedReply(bot, chatId, text, { replyTo: userMessageId });
+            });
+        }
+        catch (err) {
+            await ctx.reply(`❌ Error processing file: ${err instanceof Error ? err.message : String(err)}`, {
+                reply_parameters: { message_id: userMessageId },
+            });
+        }
+    });
+    // Handle voice messages — download, transcribe via Whisper, send to AI
+    bot.on("message:voice", async (ctx) => {
+        const chatId = ctx.chat.id;
+        const userMessageId = ctx.message.message_id;
+        const duration = ctx.message.voice.duration;
+        void logInfo(`🎤 Voice received: ${duration}s`);
+        try {
+            await ctx.react("👀");
+        }
+        catch { }
+        if (duration > 300) {
+            await ctx.reply("❌ Voice too long (max 5 min).", { reply_parameters: { message_id: userMessageId } });
+            return;
+        }
+        // If voice is a reply, include context
+        let voiceReplyContext = "";
+        const voiceReplyMsg = ctx.message.reply_to_message;
+        if (voiceReplyMsg && "text" in voiceReplyMsg && voiceReplyMsg.text) {
+            const { getConversationContext } = await import("../../store/db.js");
+            const context = getConversationContext(voiceReplyMsg.message_id);
+            if (context) {
+                voiceReplyContext = `[Continuing from earlier conversation:]\n---\n${context}\n---\n\n`;
+            }
+            else {
+                const quoted = voiceReplyMsg.text.length > 500 ? voiceReplyMsg.text.slice(0, 500) + "…" : voiceReplyMsg.text;
+                voiceReplyContext = `[Replying to: "${quoted}"]\n\n`;
+            }
+        }
+        try {
+            const file = await ctx.api.getFile(ctx.message.voice.file_id);
+            const filePath = file.file_path;
+            if (!filePath) {
+                await ctx.reply("❌ Could not download voice.", { reply_parameters: { message_id: userMessageId } });
+                return;
+            }
+            const url = `https://api.telegram.org/file/bot${config.telegramBotToken}/${filePath}`;
+            const { mkdtempSync, writeFileSync } = await import("fs");
+            const { join } = await import("path");
+            const { tmpdir } = await import("os");
+            const tmpDir = mkdtempSync(join(tmpdir(), "nzb-voice-"));
+            const ext = filePath.split(".").pop() || "oga";
+            const localPath = join(tmpDir, `voice.${ext}`);
+            const response = await fetch(url);
+            const buffer = Buffer.from(await response.arrayBuffer());
+            writeFileSync(localPath, buffer);
+            scheduleTempCleanup(tmpDir);
+            let prompt;
+            if (config.openaiApiKey) {
+                try {
+                    const formData = new FormData();
+                    formData.append("file", new Blob([buffer], { type: "audio/ogg" }), `voice.${ext}`);
+                    formData.append("model", "whisper-1");
+                    const whisperResp = await fetch("https://api.openai.com/v1/audio/transcriptions", {
+                        method: "POST",
+                        headers: { Authorization: `Bearer ${config.openaiApiKey}` },
+                        body: formData,
+                    });
+                    if (!whisperResp.ok) {
+                        const errText = await whisperResp.text();
+                        throw new Error(`Whisper API ${whisperResp.status}: ${errText.slice(0, 200)}`);
+                    }
+                    const result = (await whisperResp.json());
+                    const transcript = result.text?.trim();
+                    if (!transcript) {
+                        prompt = `[User sent a voice message (${duration}s) but transcription was empty. File saved at: ${localPath}]`;
+                    }
+                    else {
+                        prompt = `[Voice message transcribed (${duration}s)]: ${transcript}`;
+                    }
+                }
+                catch (whisperErr) {
+                    console.error("[nzb] Whisper transcription failed:", whisperErr instanceof Error ? whisperErr.message : whisperErr);
+                    prompt = `[User sent a voice message (${duration}s), saved at: ${localPath}. Transcription failed: ${whisperErr instanceof Error ? whisperErr.message : String(whisperErr)}]`;
+                }
+            }
+            else {
+                prompt = `[User sent a voice message (${duration}s), saved at: ${localPath}. No OPENAI_API_KEY configured for transcription. You can tell the user to set it up in ~/.nzb/.env]`;
+            }
+            sendToOrchestrator(voiceReplyContext + prompt, { type: "telegram", chatId, messageId: userMessageId }, (text, done, meta) => {
+                if (done)
+                    void sendFormattedReply(bot, chatId, text, {
+                        replyTo: userMessageId,
+                        assistantLogId: meta?.assistantLogId,
+                    });
+            });
+        }
+        catch (err) {
+            await ctx.reply(`❌ Error processing voice: ${err instanceof Error ? err.message : String(err)}`, {
+                reply_parameters: { message_id: userMessageId },
+            });
+        }
+    });
+}
+//# sourceMappingURL=media.js.map

package/package.json

@@ -1,69 +1,70 @@
 {
-	"name": "@iletai/nzb",
-	"version": "1.4.4",
-	"description": "NZB — a personal AI assistant for developers, built on the GitHub Copilot SDK",
-	"bin": {
-		"nzb": "dist/cli.js"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"files": [
-		"dist/**/*.js",
-		"scripts/fix-esm-imports.cjs",
-		"skills/",
-		"README.md"
-	],
-	"scripts": {
-		"build": "tsc",
-		"test": "vitest run",
-		"test:watch": "vitest",
-		"postinstall": "node scripts/fix-esm-imports.cjs",
-		"daemon": "tsx src/daemon.ts",
-		"tui": "tsx src/tui/index.ts",
-		"dev": "tsx --watch src/cli.ts start",
-		"format": "prettier --write .",
-		"format:check": "prettier --check .",
-		"prepublishOnly": "npm run build"
-	},
-	"engines": {
-		"node": ">=18"
-	},
-	"keywords": [
-		"copilot",
-		"telegram",
-		"orchestrator",
-		"ai",
-		"cli"
-	],
-	"author": "iletai",
-	"license": "MIT",
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/iletai/AI-Agent-Assistant.git"
-	},
-	"homepage": "https://github.com/iletai/AI-Agent-Assistant#readme",
-	"bugs": {
-		"url": "https://github.com/iletai/AI-Agent-Assistant/issues"
-	},
-	"type": "module",
-	"dependencies": {
-		"@github/copilot-sdk": "^0.1.26",
-		"@grammyjs/auto-retry": "^2.0.2",
-		"@grammyjs/menu": "^1.3.1",
-		"better-sqlite3": "^12.6.2",
-		"dotenv": "^17.3.1",
-		"express": "^5.2.1",
-		"grammy": "^1.40.0",
-		"zod": "^4.3.6"
-	},
-	"devDependencies": {
-		"@types/better-sqlite3": "^7.6.13",
-		"@types/express": "^5.0.6",
-		"@types/node": "^25.3.0",
-		"prettier": "^3.8.1",
-		"tsx": "^4.21.0",
-		"typescript": "^5.9.3",
-		"vitest": "^4.1.0"
-	}
+    "name": "@iletai/nzb",
+    "version": "1.4.6",
+    "description": "NZB — a personal AI assistant for developers, built on the GitHub Copilot SDK",
+    "bin": {
+        "nzb": "dist/cli.js"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "dist/**/*.js",
+        "scripts/fix-esm-imports.cjs",
+        "skills/",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "postinstall": "node scripts/fix-esm-imports.cjs",
+        "daemon": "tsx src/daemon.ts",
+        "tui": "tsx src/tui/index.ts",
+        "dev": "tsx --watch src/cli.ts start",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "prepublishOnly": "npm run build"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "keywords": [
+        "copilot",
+        "telegram",
+        "orchestrator",
+        "ai",
+        "cli"
+    ],
+    "author": "iletai",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/iletai/AI-Agent-Assistant.git"
+    },
+    "homepage": "https://github.com/iletai/AI-Agent-Assistant#readme",
+    "bugs": {
+        "url": "https://github.com/iletai/AI-Agent-Assistant/issues"
+    },
+    "type": "module",
+    "dependencies": {
+        "@github/copilot-sdk": "^0.1.26",
+        "@grammyjs/auto-retry": "^2.0.2",
+        "@grammyjs/menu": "^1.3.1",
+        "better-sqlite3": "^12.6.2",
+        "dotenv": "^17.3.1",
+        "express": "^5.2.1",
+        "grammy": "^1.40.0",
+        "zod": "^4.3.6"
+    },
+    "devDependencies": {
+        "@types/better-sqlite3": "^7.6.13",
+        "@types/express": "^5.0.6",
+        "@types/node": "^25.3.0",
+        "@vitest/coverage-v8": "^4.1.0",
+        "prettier": "^3.8.1",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.3",
+        "vitest": "^4.1.0"
+    }
 }