@hijarvis/plugin-telegram 0.0.0

package/dist/plugin.d.mts

@@ -0,0 +1,7 @@
+import { PluginFactory } from "@hijarvis/core";
+
+//#region src/plugin.d.ts
+declare const createPlugin: PluginFactory;
+//#endregion
+export { createPlugin };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/plugin.mjs

@@ -0,0 +1,685 @@
+import { buildThreadIdFromScope, createLogger, executeIngressCommand, getFaultEnvelope, maybeExecuteSideQuestionIngress, parseSideQuestionCommand } from "@hijarvis/core";
+import process from "node:process";
+import { autoRetry } from "@grammyjs/auto-retry";
+import { run } from "@grammyjs/runner";
+import { stream } from "@grammyjs/stream";
+import { Bot, GrammyError, HttpError } from "grammy";
+import { z } from "zod";
+//#region src/prompt.ts
+const formatTelegramReplyContextBlock = (replyTo) => {
+	if (!replyTo) return "";
+	return ["Telegram reply context for the current message:", `- [${replyTo.sentAt.toISOString()}] ${replyTo.authorName || replyTo.authorId}: ${replyTo.text}`].join("\n");
+};
+const formatTelegramQueuedMessagesBlock = (skipped) => {
+	if (skipped.length === 0) return "";
+	return ["Additional Telegram messages that arrived while you were still processing the previous turn:", ...skipped.map((message) => {
+		return `- ${message.authorName || message.authorId}: ${message.text}`;
+	})].join("\n");
+};
+const formatTelegramCurrentMessageBlock = (message) => {
+	return ["Current Telegram user request:", `- ${message.authorName || message.authorId}: ${message.text}`].join("\n");
+};
+const buildTelegramPrompt = (options) => {
+	const header = options.chatType === "private" ? ["You are replying inside a Telegram private chat.", "Your Jar session history is the source of truth for earlier turns."] : ["You are replying inside a Telegram group or supergroup conversation.", "Telegram Bot API does not provide full history here, so only use the explicit reply context, queued messages, and your Jar session history."];
+	const chatTitleLine = options.message.chatTitle ? `Telegram chat title: ${options.message.chatTitle}` : "";
+	return [
+		...header,
+		chatTitleLine,
+		"",
+		formatTelegramReplyContextBlock(options.message.replyTo),
+		"",
+		formatTelegramQueuedMessagesBlock(options.skipped),
+		"",
+		formatTelegramCurrentMessageBlock(options.message)
+	].filter((segment) => segment.trim().length > 0).join("\n");
+};
+//#endregion
+//#region src/config.ts
+const nonEmptyString = z.string().trim().min(1);
+const telegramIdentitySchema = z.object({
+	entity: nonEmptyString,
+	bot_token: nonEmptyString.optional(),
+	allowed_chat_ids: z.array(z.union([z.number().int(), nonEmptyString])).optional(),
+	allowed_usernames: z.array(nonEmptyString).optional()
+}).strict();
+const telegramPlatformSchema = z.object({ identities: z.record(nonEmptyString, telegramIdentitySchema) }).strict();
+const parseTelegramPlatformConfig = (platform) => {
+	const parsed = telegramPlatformSchema.parse(platform.telegram ?? {});
+	return Object.fromEntries(Object.entries(parsed.identities).map(([id, identity]) => [id, {
+		id,
+		entityId: identity.entity,
+		botToken: identity.bot_token,
+		allowedChatIds: identity.allowed_chat_ids?.map((value) => String(value)),
+		allowedUsernames: identity.allowed_usernames?.map((value) => value.replace(/^@/, "").toLowerCase())
+	}]));
+};
+//#endregion
+//#region src/runtime.ts
+const telegramGatewayEnvSchema = z.object({
+	TELEGRAM_BOT_TOKEN: z.string().trim().min(1).optional(),
+	JARVIS_TELEGRAM_ALLOWED_CHAT_IDS: z.string().trim().min(1).optional(),
+	JARVIS_TELEGRAM_ALLOWED_USERNAMES: z.string().trim().min(1).optional()
+});
+const queueEntryTtlMs = 6e4;
+const maxQueueSize = 20;
+const startTelegramIdentities = async (config, hooks, services, logger) => {
+	const env = loadTelegramGatewayEnv(process.env);
+	const telegramConfigs = parseTelegramPlatformConfig(config.platform);
+	const identities = Object.values(config.platformIdentities).filter((identity) => identity.platform === "telegram");
+	const stops = [];
+	for (const identityConfig of identities) {
+		const telegramConfig = telegramConfigs[identityConfig.id];
+		if (telegramConfig === void 0) throw new Error(`Missing Telegram runtime config for identity "${identityConfig.id}"`);
+		const bot = new Bot(resolveTelegramBotToken(telegramConfig, env));
+		bot.api.config.use(autoRetry());
+		bot.use(stream());
+		const me = await bot.api.getMe();
+		const allowedChatIds = resolveAllowedChatIds(telegramConfig, env);
+		const allowedUsernames = resolveAllowedUsernames(telegramConfig, env);
+		const identityLogger = logger.child({
+			identityId: identityConfig.id,
+			entityId: identityConfig.entityId
+		});
+		const state = {
+			identityConfig,
+			runtime: config,
+			hooks,
+			services,
+			telegramConfig,
+			logger: identityLogger,
+			identity: {
+				botId: me.id,
+				username: me.username
+			},
+			allowedChatIds,
+			allowedUsernames,
+			queues: /* @__PURE__ */ new Map()
+		};
+		identityLogger.info("telegram.gateway_initialized", {
+			botId: me.id,
+			botUsername: me.username,
+			allowedChatCount: allowedChatIds?.size ?? 0,
+			allowedUsernameCount: allowedUsernames?.size ?? 0
+		});
+		registerTelegramHandlers(bot, state);
+		const runner = run(bot);
+		process.stdout.write(`Jar Telegram identity ${identityConfig.id} running in long polling mode\n`);
+		identityLogger.info("telegram.gateway_started");
+		stops.push(async () => {
+			identityLogger.info("telegram.gateway_stopping");
+			runner.stop();
+		});
+	}
+	return stops;
+};
+const registerTelegramHandlers = (bot, state) => {
+	bot.command("btw", async (context) => {
+		const messageContext = context;
+		if (!isAllowedChat(messageContext.chat.id, state)) return;
+		if (!isAllowedUsername(messageContext.msg.from?.username, state)) return;
+		const text = readTelegramMessageText(messageContext.msg);
+		const parsed = text ? parseSideQuestionCommand({
+			input: text,
+			parentThreadId: "preview",
+			source: {
+				platform: "telegram",
+				identityId: state.identityConfig.id
+			}
+		}) : null;
+		if (parsed === null) {
+			await messageContext.reply("Usage: /btw <question>", createReplyOptions(messageContext));
+			return;
+		}
+		const normalized = normalizeTelegramMessageSeed(messageContext, state.identity);
+		if (!normalized) {
+			await messageContext.reply("I could not read that /btw question.", createReplyOptions(messageContext));
+			return;
+		}
+		const threadId = buildThreadIdFromScope({
+			platform: "telegram",
+			identityId: state.identityConfig.id,
+			scope: normalized.threadId === void 0 ? {
+				kind: "telegram",
+				chatId: normalized.chatId
+			} : {
+				kind: "telegram",
+				chatId: normalized.chatId,
+				messageThreadId: String(normalized.threadId)
+			}
+		});
+		const requestLogger = state.logger.child({
+			conversationKey: buildConversationKey(normalized.chatId, normalized.threadId),
+			threadId,
+			entityId: state.identityConfig.entityId,
+			chatId: normalized.chatId,
+			messageId: normalized.messageId,
+			trigger: "side_question"
+		});
+		try {
+			const result = await executeIngressCommand({
+				config: state.runtime,
+				hooks: state.hooks,
+				logger: requestLogger,
+				command: {
+					kind: "side_question",
+					source: {
+						platform: "telegram",
+						identityId: state.identityConfig.id
+					},
+					parentThreadId: threadId,
+					question: { text: parsed.question.text }
+				}
+			});
+			if (result.kind !== "side_question") throw new Error("Telegram /btw expected a side-question execution result.");
+			await messageContext.reply(result.outputText.trim().length > 0 ? result.outputText : "I do not have a side-question reply.", createReplyOptions(messageContext));
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			requestLogger.error("telegram.side_question_failed", {
+				threadId,
+				chatId: normalized.chatId,
+				messageId: normalized.messageId,
+				message
+			});
+			await messageContext.reply(message.includes("No live parent thread available") ? "No active live thread is available for /btw in this chat yet." : "I ran into an error while answering that /btw question.", createReplyOptions(messageContext));
+		}
+	});
+	bot.command(["start", "help"], async (context) => {
+		const messageContext = context;
+		if (!isAllowedChat(messageContext.chat.id, state)) return;
+		await messageContext.reply("Jar Telegram gateway is ready. Send a private message, or mention/reply to the bot in a group.", createReplyOptions(messageContext));
+	});
+	bot.on("message", async (context) => {
+		const messageContext = context;
+		if (!isAllowedChat(messageContext.chat.id, state)) {
+			state.logger.debug("telegram.event_ignored", {
+				reason: "chat_not_allowed",
+				chatId: String(messageContext.chat.id)
+			});
+			return;
+		}
+		if (!isAllowedUsername(messageContext.msg.from?.username, state)) {
+			state.logger.debug("telegram.event_ignored", {
+				reason: "username_not_allowed",
+				chatId: String(messageContext.chat.id),
+				username: messageContext.msg.from?.username
+			});
+			return;
+		}
+		if (isTelegramSideQuestionCommand(readTelegramMessageText(messageContext.msg))) {
+			state.logger.debug("telegram.event_ignored", {
+				reason: "side_question_command",
+				chatId: String(messageContext.chat.id),
+				messageId: messageContext.msg.message_id
+			});
+			return;
+		}
+		const trigger = classifyMessageTrigger(messageContext, state.identity);
+		if (!trigger) {
+			state.logger.debug("telegram.event_ignored", {
+				reason: "not_triggered",
+				chatId: String(messageContext.chat.id),
+				messageId: messageContext.msg.message_id
+			});
+			return;
+		}
+		const normalized = normalizeTelegramMessageSeed(messageContext, state.identity);
+		if (!normalized) {
+			state.logger.debug("telegram.event_ignored", {
+				reason: "unsupported_message",
+				chatId: String(messageContext.chat.id),
+				messageId: messageContext.msg.message_id
+			});
+			return;
+		}
+		const conversationKey = buildConversationKey(normalized.chatId, normalized.threadId);
+		state.logger.info("telegram.event_received", {
+			trigger,
+			conversationKey,
+			chatId: normalized.chatId,
+			messageId: normalized.messageId,
+			textChars: normalized.text.length
+		});
+		enqueueMessage(state, conversationKey, {
+			context: messageContext,
+			kind: trigger,
+			message: normalized,
+			receivedAt: Date.now()
+		});
+	});
+	bot.catch((error) => {
+		const context = error.ctx;
+		if (error.error instanceof GrammyError) {
+			state.logger.error("telegram.middleware_failed", {
+				chatId: context.chat?.id !== void 0 ? String(context.chat.id) : void 0,
+				messageId: context.msg?.message_id,
+				message: error.error.description
+			});
+			return;
+		}
+		if (error.error instanceof HttpError) {
+			state.logger.error("telegram.middleware_failed", {
+				chatId: context.chat?.id !== void 0 ? String(context.chat.id) : void 0,
+				messageId: context.msg?.message_id,
+				message: error.error.message
+			});
+			return;
+		}
+		const message = error.error instanceof Error ? error.error.message : String(error.error);
+		state.logger.error("telegram.middleware_failed", {
+			chatId: context.chat?.id !== void 0 ? String(context.chat.id) : void 0,
+			messageId: context.msg?.message_id,
+			message
+		});
+	});
+};
+const resolveTelegramBotToken = (telegramConfig, env) => {
+	const botToken = env.TELEGRAM_BOT_TOKEN ?? telegramConfig.botToken ?? "";
+	if (!botToken) throw new Error("Missing Telegram credentials: TELEGRAM_BOT_TOKEN");
+	return botToken;
+};
+const resolveAllowedChatIds = (telegramConfig, env) => {
+	if (env.JARVIS_TELEGRAM_ALLOWED_CHAT_IDS) {
+		const values = env.JARVIS_TELEGRAM_ALLOWED_CHAT_IDS.split(",").map((value) => value.trim()).filter((value) => value.length > 0);
+		return values.length > 0 ? new Set(values) : void 0;
+	}
+	const configured = telegramConfig.allowedChatIds;
+	if (!configured || configured.length === 0) return;
+	return new Set(configured);
+};
+const resolveAllowedUsernames = (telegramConfig, env) => {
+	if (env.JARVIS_TELEGRAM_ALLOWED_USERNAMES) {
+		const values = env.JARVIS_TELEGRAM_ALLOWED_USERNAMES.split(",").map((value) => value.trim().replace(/^@/, "").toLowerCase()).filter((value) => value.length > 0);
+		return values.length > 0 ? new Set(values) : void 0;
+	}
+	const configured = telegramConfig.allowedUsernames;
+	if (!configured || configured.length === 0) return;
+	return new Set(configured);
+};
+const isAllowedChat = (chatId, state) => {
+	if (!state.allowedChatIds) return true;
+	return state.allowedChatIds.has(String(chatId));
+};
+const isAllowedUsername = (username, state) => {
+	if (!state.allowedUsernames) return true;
+	if (!username) return false;
+	return state.allowedUsernames.has(username.toLowerCase());
+};
+const classifyMessageTrigger = (context, identity) => {
+	if (context.chat.type === "private") return "private_chat";
+	if (context.msg.reply_to_message?.from?.id === identity.botId) return "reply_to_bot";
+	const text = readTelegramMessageText(context.msg);
+	if (!text) return null;
+	const username = identity.username;
+	if (!username) return null;
+	const normalizedMention = `@${username.toLowerCase()}`;
+	return text.toLowerCase().includes(normalizedMention) ? "mention" : null;
+};
+const normalizeTelegramMessageSeed = (context, identity) => {
+	const text = readTelegramMessageText(context.msg);
+	const from = context.msg.from;
+	if (!text || !from) return null;
+	const sentAt = /* @__PURE__ */ new Date(context.msg.date * 1e3);
+	const normalizedText = stripBotMention(text, identity.username);
+	if (!normalizedText) return null;
+	const chatTitle = readChatTitle(context.chat);
+	const replyTo = readReplyContext(context.msg.reply_to_message);
+	return {
+		id: String(context.msg.message_id),
+		messageId: context.msg.message_id,
+		text: normalizedText,
+		authorId: String(from.id),
+		authorName: formatTelegramAuthorName(from),
+		sentAt,
+		chatId: String(context.chat.id),
+		chatType: context.chat.type === "private" ? "private" : "group",
+		chatTitle,
+		threadId: context.msg.message_thread_id,
+		replyTo
+	};
+};
+const readTelegramMessageText = (message) => {
+	return message?.text ?? message?.caption;
+};
+const isTelegramSideQuestionCommand = (text) => {
+	return text !== void 0 && parseSideQuestionCommand({
+		input: text,
+		parentThreadId: "preview",
+		source: { platform: "telegram" }
+	}) !== null;
+};
+const stripBotMention = (text, username) => {
+	if (!username) return text.trim();
+	return text.replaceAll(`@${username}`, "").trim();
+};
+const formatTelegramAuthorName = (from) => {
+	const parts = [from.first_name, from.last_name].filter((part) => Boolean(part));
+	if (parts.length > 0) return parts.join(" ");
+	return from.username ?? String(from.id);
+};
+const readChatTitle = (chat) => {
+	switch (chat.type) {
+		case "group":
+		case "supergroup": return chat.title;
+		case "private": return;
+	}
+};
+const readReplyContext = (replyTo) => {
+	const text = replyTo ? readTelegramMessageText(replyTo) : void 0;
+	const from = replyTo?.from;
+	if (!replyTo || !text || !from) return;
+	return {
+		authorId: String(from.id),
+		authorName: formatTelegramAuthorName(from),
+		text,
+		sentAt: /* @__PURE__ */ new Date(replyTo.date * 1e3)
+	};
+};
+const enqueueMessage = (state, conversationKey, entry) => {
+	const queue = getConversationQueue(state, conversationKey);
+	const now = Date.now();
+	queue.entries = queue.entries.filter((queued) => now - queued.receivedAt <= queueEntryTtlMs);
+	queue.entries.push(entry);
+	if (queue.entries.length > maxQueueSize) queue.entries.splice(0, queue.entries.length - maxQueueSize);
+	state.logger.info("telegram.queue_enqueued", {
+		conversationKey,
+		trigger: entry.kind,
+		queueSize: queue.entries.length,
+		chatId: entry.message.chatId,
+		messageId: entry.message.messageId
+	});
+	if (!queue.running) {
+		queue.running = true;
+		drainQueue(state, conversationKey, queue);
+	}
+};
+const drainQueue = async (state, conversationKey, queue) => {
+	try {
+		while (queue.entries.length > 0) {
+			const now = Date.now();
+			queue.entries = queue.entries.filter((queued) => now - queued.receivedAt <= queueEntryTtlMs);
+			if (queue.entries.length === 0) break;
+			const batch = queue.entries.splice(0, queue.entries.length);
+			if (batch.length === 0) continue;
+			const current = batch[batch.length - 1];
+			const skipped = batch.slice(0, -1).map((item) => item.message);
+			state.logger.info("telegram.queue_draining", {
+				conversationKey,
+				batchSize: batch.length,
+				skippedCount: skipped.length,
+				trigger: current.kind
+			});
+			try {
+				await handleQueueEntry(state, conversationKey, current, skipped);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				state.logger.error("telegram.queue_entry_failed", {
+					conversationKey,
+					message
+				});
+			}
+		}
+	} finally {
+		queue.running = false;
+	}
+};
+const handleQueueEntry = async (state, conversationKey, entry, skipped) => {
+	const threadId = buildThreadIdFromScope({
+		platform: "telegram",
+		identityId: state.identityConfig.id,
+		scope: entry.message.threadId === void 0 ? {
+			kind: "telegram",
+			chatId: entry.message.chatId
+		} : {
+			kind: "telegram",
+			chatId: entry.message.chatId,
+			messageThreadId: String(entry.message.threadId)
+		}
+	});
+	const requestLogger = state.logger.child({
+		conversationKey,
+		threadId,
+		entityId: state.identityConfig.entityId,
+		chatId: entry.message.chatId,
+		messageId: entry.message.messageId,
+		trigger: entry.kind
+	});
+	const current = materializeTelegramMessage(entry.message);
+	const skippedMessages = skipped.map(materializeTelegramMessage);
+	const prompt = buildTelegramPrompt({
+		message: current,
+		skipped: skippedMessages,
+		chatType: current.chatTitle || entry.message.chatType === "group" ? "group" : "private"
+	});
+	requestLogger.info("telegram.request_started", {
+		skippedCount: skippedMessages.length,
+		currentAuthor: current.authorName,
+		promptChars: prompt.length
+	});
+	const sideQuestion = await maybeExecuteSideQuestionIngress({
+		config: state.runtime,
+		parentThreadId: threadId,
+		input: current.text,
+		source: {
+			platform: "telegram",
+			identityId: state.identityConfig.id
+		},
+		logger: requestLogger
+	});
+	if (sideQuestion.handled) {
+		await entry.context.reply(sideQuestion.result.outputText.trim().length > 0 ? sideQuestion.result.outputText : "I do not have a side-question reply.", createReplyOptions(entry.context));
+		return;
+	}
+	await respondInTelegramConversation({
+		state,
+		context: entry.context,
+		conversationKey,
+		threadId,
+		prompt,
+		skillTriggerText: buildTelegramSkillTriggerText(current, skippedMessages),
+		logger: requestLogger
+	});
+};
+const materializeTelegramMessage = (seed) => {
+	return {
+		id: seed.id,
+		text: seed.text,
+		authorId: seed.authorId,
+		authorName: seed.authorName,
+		sentAt: seed.sentAt,
+		chatTitle: seed.chatTitle,
+		replyTo: seed.replyTo
+	};
+};
+const respondInTelegramConversation = async (options) => {
+	const startedAt = Date.now();
+	const textStream = new AsyncTextDeltaQueue();
+	let emittedText = false;
+	let turnId;
+	let runId;
+	const contributions = options.state.services.get("pluginContributions");
+	const responseTask = executeIngressCommand({
+		config: options.state.runtime,
+		hooks: options.state.hooks,
+		logger: options.logger,
+		pluginOverrides: contributions ?? {
+			skillRoots: [],
+			overlays: [],
+			tools: []
+		},
+		command: {
+			kind: "message",
+			source: { platform: "telegram" },
+			routing: {
+				platform: "telegram",
+				scope: options.context.msg.message_thread_id === void 0 ? {
+					kind: "telegram",
+					chatId: String(options.context.chat.id)
+				} : {
+					kind: "telegram",
+					chatId: String(options.context.chat.id),
+					messageThreadId: String(options.context.msg.message_thread_id)
+				}
+			},
+			message: {
+				text: options.skillTriggerText,
+				id: String(options.context.msg.message_id)
+			},
+			prompt: options.prompt,
+			skillTriggerText: options.skillTriggerText,
+			audit: {
+				trigger: "platform_event",
+				triggerKind: "telegram_message",
+				metadata: {
+					conversationKey: options.conversationKey,
+					chatId: String(options.context.chat.id),
+					messageId: options.context.msg.message_id
+				}
+			},
+			execution: { onEvent(event) {
+				if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
+					emittedText = true;
+					textStream.push(event.assistantMessageEvent.delta);
+				}
+			} }
+		}
+	}).then((result) => {
+		const { outputText } = result;
+		if (!emittedText) textStream.push(outputText.trim().length > 0 ? outputText : "I finished processing that, but I do not have a textual reply to send.");
+		textStream.close();
+		return result;
+	}).catch((error) => {
+		textStream.fail(toError(error));
+		throw error;
+	});
+	try {
+		await options.context.replyWithStream(textStream, createReplyOptions(options.context));
+		const result = await responseTask;
+		if (result.kind !== "message") throw new Error("Telegram reply generation expected a message execution result.");
+		turnId = result.turnId;
+		runId = result.runId;
+		const outputText = result.outputText;
+		options.logger.info("telegram.reply_posted", {
+			durationMs: Date.now() - startedAt,
+			replyChars: outputText.trim().length,
+			threadId: options.threadId,
+			turnId: result.turnId,
+			runId: result.runId,
+			conversationKey: options.conversationKey,
+			streamed: true
+		});
+	} catch (error) {
+		const settledResult = await responseTask.catch(() => void 0);
+		if (settledResult?.kind === "message") {
+			turnId = turnId ?? settledResult.turnId;
+			runId = runId ?? settledResult.runId;
+		}
+		const normalizedError = toError(error);
+		const envelope = getFaultEnvelope(error);
+		options.logger.error("telegram.reply_failed", {
+			durationMs: Date.now() - startedAt,
+			message: normalizedError.message,
+			threadId: options.threadId,
+			turnId: turnId ?? envelope?.turnId,
+			runId: runId ?? envelope?.runId,
+			conversationKey: options.conversationKey,
+			fault: envelope?.fault,
+			phase: envelope?.phase
+		});
+		if (!emittedText) await options.context.reply("I ran into an error while processing that request. Please try again in the same chat.", createReplyOptions(options.context));
+	}
+};
+const buildTelegramSkillTriggerText = (currentMessage, skipped) => {
+	return [...skipped, currentMessage].map((message) => message.text.trim()).filter((text) => text.length > 0).join("\n");
+};
+const createReplyOptions = (context) => {
+	const options = { reply_parameters: { message_id: context.msg.message_id } };
+	if (context.msg.message_thread_id !== void 0) options.message_thread_id = context.msg.message_thread_id;
+	return options;
+};
+const getConversationQueue = (state, conversationKey) => {
+	const existing = state.queues.get(conversationKey);
+	if (existing) return existing;
+	const created = {
+		running: false,
+		entries: []
+	};
+	state.queues.set(conversationKey, created);
+	return created;
+};
+const buildConversationKey = (chatId, threadId) => {
+	return threadId === void 0 ? chatId : `${chatId}:${threadId}`;
+};
+const loadTelegramGatewayEnv = (rawEnv) => {
+	return telegramGatewayEnvSchema.parse(rawEnv);
+};
+const toError = (error) => {
+	return error instanceof Error ? error : new Error(String(error));
+};
+var AsyncTextDeltaQueue = class {
+	chunks = [];
+	waiters = [];
+	completed = false;
+	failure = null;
+	push(chunk) {
+		if (!chunk) return;
+		const waiter = this.waiters.shift();
+		if (waiter) {
+			waiter.resolve({
+				done: false,
+				value: chunk
+			});
+			return;
+		}
+		this.chunks.push(chunk);
+	}
+	close() {
+		this.completed = true;
+		while (this.waiters.length > 0) this.waiters.shift()?.resolve({
+			done: true,
+			value: void 0
+		});
+	}
+	fail(error) {
+		this.failure = error;
+		while (this.waiters.length > 0) this.waiters.shift()?.reject(error);
+	}
+	[Symbol.asyncIterator]() {
+		return { next: async () => {
+			if (this.chunks.length > 0) return {
+				done: false,
+				value: this.chunks.shift()
+			};
+			if (this.failure) throw this.failure;
+			if (this.completed) return {
+				done: true,
+				value: void 0
+			};
+			return new Promise((resolve, reject) => {
+				this.waiters.push({
+					resolve,
+					reject
+				});
+			});
+		} };
+	}
+};
+//#endregion
+//#region src/plugin.ts
+const createPlugin = (_pluginConfig) => {
+	return {
+		name: "jar-gateway-telegram",
+		async install({ config, hooks, services, logger }) {
+			const stops = await startTelegramIdentities(config, hooks, services, logger ?? createLogger({
+				level: "info",
+				stderr: true
+			}));
+			return { cleanup: async () => {
+				for (const stop of stops) await stop();
+			} };
+		}
+	};
+};
+//#endregion
+export { createPlugin };
+
+//# sourceMappingURL=plugin.mjs.map

package/dist/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../src/prompt.ts","../src/config.ts","../src/runtime.ts","../src/plugin.ts"],"sourcesContent":["export type TelegramReplyContext = {\n  authorId: string;\n  authorName: string;\n  text: string;\n  sentAt: Date;\n};\n\nexport type TelegramMessage = {\n  id: string;\n  text: string;\n  authorId: string;\n  authorName: string;\n  sentAt: Date;\n  chatTitle?: string;\n  replyTo?: TelegramReplyContext;\n};\n\nexport const createTelegramSessionId = (conversationId: string): string => {\n  return conversationId.replaceAll(\":\", \"__\").replaceAll(\"/\", \"_\");\n};\n\nexport const formatTelegramReplyContextBlock = (\n  replyTo: TelegramReplyContext | undefined,\n): string => {\n  if (!replyTo) {\n    return \"\";\n  }\n\n  return [\n    \"Telegram reply context for the current message:\",\n    `- [${replyTo.sentAt.toISOString()}] ${replyTo.authorName || replyTo.authorId}: ${replyTo.text}`,\n  ].join(\"\\n\");\n};\n\nexport const formatTelegramQueuedMessagesBlock = (\n  skipped: TelegramMessage[],\n): string => {\n  if (skipped.length === 0) {\n    return \"\";\n  }\n\n  const lines = skipped.map((message) => {\n    return `- ${message.authorName || message.authorId}: ${message.text}`;\n  });\n\n  return [\n    \"Additional Telegram messages that arrived while you were still processing the previous turn:\",\n    ...lines,\n  ].join(\"\\n\");\n};\n\nexport const formatTelegramCurrentMessageBlock = (\n  message: TelegramMessage,\n): string => {\n  return [\n    \"Current Telegram user request:\",\n    `- ${message.authorName || message.authorId}: ${message.text}`,\n  ].join(\"\\n\");\n};\n\nexport const buildTelegramPrompt = (options: {\n  message: TelegramMessage;\n  skipped: TelegramMessage[];\n  chatType: \"private\" | \"group\";\n}): string => {\n  const header = options.chatType === \"private\"\n    ? [\n      \"You are replying inside a Telegram private chat.\",\n      \"Your Jar session history is the source of truth for earlier turns.\",\n    ]\n    : [\n      \"You are replying inside a Telegram group or supergroup conversation.\",\n      \"Telegram Bot API does not provide full history here, so only use the explicit reply context, queued messages, and your Jar session history.\",\n    ];\n\n  const chatTitleLine = options.message.chatTitle\n    ? `Telegram chat title: ${options.message.chatTitle}`\n    : \"\";\n\n  return [\n    ...header,\n    chatTitleLine,\n    \"\",\n    formatTelegramReplyContextBlock(options.message.replyTo),\n    \"\",\n    formatTelegramQueuedMessagesBlock(options.skipped),\n    \"\",\n    formatTelegramCurrentMessageBlock(options.message),\n  ]\n    .filter((segment) => segment.trim().length > 0)\n    .join(\"\\n\");\n};\n","import { z } from \"zod\";\n\nconst nonEmptyString = z.string().trim().min(1);\n\nconst telegramIdentitySchema = z.object({\n  entity: nonEmptyString,\n  bot_token: nonEmptyString.optional(),\n  allowed_chat_ids: z.array(z.union([z.number().int(), nonEmptyString])).optional(),\n  allowed_usernames: z.array(nonEmptyString).optional(),\n}).strict();\n\nconst telegramPlatformSchema = z.object({\n  identities: z.record(nonEmptyString, telegramIdentitySchema),\n}).strict();\n\nexport type TelegramPlatformIdentityConfig = {\n  id: string;\n  entityId: string;\n  botToken?: string;\n  allowedChatIds?: string[];\n  allowedUsernames?: string[];\n};\n\nexport const parseTelegramPlatformConfig = (\n  platform: Record<string, unknown>,\n): Record<string, TelegramPlatformIdentityConfig> => {\n  const parsed = telegramPlatformSchema.parse(platform.telegram ?? {});\n\n  return Object.fromEntries(Object.entries(parsed.identities).map(([id, identity]) => [id, {\n    id,\n    entityId: identity.entity,\n    botToken: identity.bot_token,\n    allowedChatIds: identity.allowed_chat_ids?.map((value) => String(value)),\n    allowedUsernames: identity.allowed_usernames?.map((value) =>\n      value.replace(/^@/, \"\").toLowerCase()\n    ),\n  } satisfies TelegramPlatformIdentityConfig]));\n};\n","import process from \"node:process\";\n\nimport { autoRetry } from \"@grammyjs/auto-retry\";\nimport { run, type RunnerHandle } from \"@grammyjs/runner\";\nimport { stream, type StreamFlavor } from \"@grammyjs/stream\";\nimport {\n  buildThreadIdFromScope,\n  executeIngressCommand,\n  getFaultEnvelope,\n  maybeExecuteSideQuestionIngress,\n  parseSideQuestionCommand,\n  type MessageIngressCommand,\n  type LoadedRuntimeConfig,\n  type Logger,\n  type PlatformIdentityRef,\n  type PluginContribution,\n  type HookRegistry,\n  type ServiceRegistry,\n} from \"@hijarvis/core\";\nimport {\n  Bot,\n  type Context,\n  GrammyError,\n  HttpError,\n} from \"grammy\";\nimport { z } from \"zod\";\n\nimport {\n  buildTelegramPrompt,\n  type TelegramMessage,\n  type TelegramReplyContext,\n} from \"./prompt.js\";\nimport {\n  parseTelegramPlatformConfig,\n  type TelegramPlatformIdentityConfig,\n} from \"./config.js\";\n\nconst telegramGatewayEnvSchema = z.object({\n  TELEGRAM_BOT_TOKEN: z.string().trim().min(1).optional(),\n  JARVIS_TELEGRAM_ALLOWED_CHAT_IDS: z.string().trim().min(1).optional(),\n  JARVIS_TELEGRAM_ALLOWED_USERNAMES: z.string().trim().min(1).optional(),\n});\n\ntype TelegramGatewayEnv = z.infer<typeof telegramGatewayEnvSchema>;\ntype TelegramGatewayContext = StreamFlavor<Context>;\ntype TelegramMessageContext = TelegramGatewayContext & {\n  chat: NonNullable<TelegramGatewayContext[\"chat\"]>;\n  msg: NonNullable<TelegramGatewayContext[\"msg\"]>;\n};\ntype TelegramUserLike = {\n  id: number;\n  first_name: string;\n  last_name?: string;\n  username?: string;\n};\ntype TelegramReadableMessage = {\n  text?: string;\n  caption?: string;\n};\n\ntype TelegramIdentity = {\n  botId: number;\n  username?: string;\n};\n\ntype TriggerKind = \"private_chat\" | \"reply_to_bot\" | \"mention\";\n\ntype TelegramMessageSeed = {\n  id: string;\n  messageId: number;\n  text: string;\n  authorId: string;\n  authorName: string;\n  sentAt: Date;\n  chatId: string;\n  chatType: \"private\" | \"group\";\n  chatTitle?: string;\n  threadId?: number;\n  replyTo?: TelegramReplyContext;\n};\n\ntype QueueEntry = {\n  context: TelegramMessageContext;\n  kind: TriggerKind;\n  message: TelegramMessageSeed;\n  receivedAt: number;\n};\n\ntype ConversationQueueState = {\n  running: boolean;\n  entries: QueueEntry[];\n};\n\ntype TelegramGatewayState = {\n  identityConfig: PlatformIdentityRef;\n  runtime: LoadedRuntimeConfig;\n  hooks: HookRegistry;\n  services: ServiceRegistry;\n  telegramConfig: TelegramPlatformIdentityConfig;\n  logger: Logger;\n  identity: TelegramIdentity;\n  allowedChatIds?: Set<string>;\n  allowedUsernames?: Set<string>;\n  queues: Map<string, ConversationQueueState>;\n};\n\ntype AsyncIteratorWaiter = {\n  resolve: (value: IteratorResult<string>) => void;\n  reject: (error: Error) => void;\n};\n\nconst queueEntryTtlMs = 60_000;\nconst maxQueueSize = 20;\n\nexport type StopFn = () => Promise<void>;\n\nexport const startTelegramIdentities = async (\n  config: LoadedRuntimeConfig,\n  hooks: HookRegistry,\n  services: ServiceRegistry,\n  logger: Logger,\n): Promise<StopFn[]> => {\n  const env = loadTelegramGatewayEnv(process.env);\n  const telegramConfigs = parseTelegramPlatformConfig(config.platform);\n  const identities = Object.values(config.platformIdentities).filter(\n    (identity): identity is PlatformIdentityRef => identity.platform === \"telegram\",\n  );\n\n  const stops: StopFn[] = [];\n\n  for (const identityConfig of identities) {\n    const telegramConfig = telegramConfigs[identityConfig.id];\n    if (telegramConfig === undefined) {\n      throw new Error(`Missing Telegram runtime config for identity \"${identityConfig.id}\"`);\n    }\n\n    const botToken = resolveTelegramBotToken(telegramConfig, env);\n    const bot = new Bot<TelegramGatewayContext>(botToken);\n    bot.api.config.use(autoRetry());\n    bot.use(stream());\n\n    const me = await bot.api.getMe();\n    const allowedChatIds = resolveAllowedChatIds(telegramConfig, env);\n    const allowedUsernames = resolveAllowedUsernames(telegramConfig, env);\n    const identityLogger = logger.child({ identityId: identityConfig.id, entityId: identityConfig.entityId });\n    const state: TelegramGatewayState = {\n      identityConfig,\n      runtime: config,\n      hooks,\n      services,\n      telegramConfig,\n      logger: identityLogger,\n      identity: {\n        botId: me.id,\n        username: me.username,\n      },\n      allowedChatIds,\n      allowedUsernames,\n      queues: new Map<string, ConversationQueueState>(),\n    };\n\n    identityLogger.info(\"telegram.gateway_initialized\", {\n      botId: me.id,\n      botUsername: me.username,\n      allowedChatCount: allowedChatIds?.size ?? 0,\n      allowedUsernameCount: allowedUsernames?.size ?? 0,\n    });\n\n    registerTelegramHandlers(bot, state);\n    const runner = run(bot);\n\n    process.stdout.write(\n      `Jar Telegram identity ${identityConfig.id} running in long polling mode\\n`,\n    );\n    identityLogger.info(\"telegram.gateway_started\");\n\n    stops.push(async () => {\n      identityLogger.info(\"telegram.gateway_stopping\");\n      runner.stop();\n    });\n  }\n\n  return stops;\n};\n\nconst registerTelegramHandlers = (\n  bot: Bot<TelegramGatewayContext>,\n  state: TelegramGatewayState,\n): void => {\n  bot.command(\"btw\", async (context) => {\n    const messageContext = context as TelegramMessageContext;\n    if (!isAllowedChat(messageContext.chat.id, state)) {\n      return;\n    }\n\n    if (!isAllowedUsername(messageContext.msg.from?.username, state)) {\n      return;\n    }\n\n    const text = readTelegramMessageText(messageContext.msg);\n    const parsed = text ? parseSideQuestionCommand({\n      input: text,\n      parentThreadId: \"preview\",\n      source: {\n        platform: \"telegram\",\n        identityId: state.identityConfig.id,\n      },\n    }) : null;\n    if (parsed === null) {\n      await messageContext.reply(\"Usage: /btw <question>\", createReplyOptions(messageContext));\n      return;\n    }\n\n    const normalized = normalizeTelegramMessageSeed(messageContext, state.identity);\n    if (!normalized) {\n      await messageContext.reply(\n        \"I could not read that /btw question.\",\n        createReplyOptions(messageContext),\n      );\n      return;\n    }\n\n    const threadId = buildThreadIdFromScope({\n      platform: \"telegram\",\n      identityId: state.identityConfig.id,\n      scope: normalized.threadId === undefined\n        ? {\n          kind: \"telegram\",\n          chatId: normalized.chatId,\n        }\n        : {\n          kind: \"telegram\",\n          chatId: normalized.chatId,\n          messageThreadId: String(normalized.threadId),\n        },\n    });\n    const requestLogger = state.logger.child({\n      conversationKey: buildConversationKey(normalized.chatId, normalized.threadId),\n      threadId,\n      entityId: state.identityConfig.entityId,\n      chatId: normalized.chatId,\n      messageId: normalized.messageId,\n      trigger: \"side_question\",\n    });\n\n    try {\n      const result = await executeIngressCommand({\n        config: state.runtime,\n        hooks: state.hooks,\n        logger: requestLogger,\n        command: {\n          kind: \"side_question\",\n          source: {\n            platform: \"telegram\",\n            identityId: state.identityConfig.id,\n          },\n          parentThreadId: threadId,\n          question: {\n            text: parsed.question.text,\n          },\n        },\n      });\n      if (result.kind !== \"side_question\") {\n        throw new Error(\"Telegram /btw expected a side-question execution result.\");\n      }\n      await messageContext.reply(\n        result.outputText.trim().length > 0\n          ? result.outputText\n          : \"I do not have a side-question reply.\",\n        createReplyOptions(messageContext),\n      );\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      requestLogger.error(\"telegram.side_question_failed\", {\n        threadId,\n        chatId: normalized.chatId,\n        messageId: normalized.messageId,\n        message,\n      });\n      await messageContext.reply(\n        message.includes(\"No live parent thread available\")\n          ? \"No active live thread is available for /btw in this chat yet.\"\n          : \"I ran into an error while answering that /btw question.\",\n        createReplyOptions(messageContext),\n      );\n    }\n  });\n\n  bot.command([\"start\", \"help\"], async (context) => {\n    const messageContext = context as TelegramMessageContext;\n    if (!isAllowedChat(messageContext.chat.id, state)) {\n      return;\n    }\n\n    await messageContext.reply(\n      \"Jar Telegram gateway is ready. Send a private message, or mention/reply to the bot in a group.\",\n      createReplyOptions(messageContext),\n    );\n  });\n\n  bot.on(\"message\", async (context) => {\n    const messageContext = context as TelegramMessageContext;\n\n    if (!isAllowedChat(messageContext.chat.id, state)) {\n      state.logger.debug(\"telegram.event_ignored\", {\n        reason: \"chat_not_allowed\",\n        chatId: String(messageContext.chat.id),\n      });\n      return;\n    }\n\n    if (!isAllowedUsername(messageContext.msg.from?.username, state)) {\n      state.logger.debug(\"telegram.event_ignored\", {\n        reason: \"username_not_allowed\",\n        chatId: String(messageContext.chat.id),\n        username: messageContext.msg.from?.username,\n      });\n      return;\n    }\n\n    if (isTelegramSideQuestionCommand(readTelegramMessageText(messageContext.msg))) {\n      state.logger.debug(\"telegram.event_ignored\", {\n        reason: \"side_question_command\",\n        chatId: String(messageContext.chat.id),\n        messageId: messageContext.msg.message_id,\n      });\n      return;\n    }\n\n    const trigger = classifyMessageTrigger(messageContext, state.identity);\n    if (!trigger) {\n      state.logger.debug(\"telegram.event_ignored\", {\n        reason: \"not_triggered\",\n        chatId: String(messageContext.chat.id),\n        messageId: messageContext.msg.message_id,\n      });\n      return;\n    }\n\n    const normalized = normalizeTelegramMessageSeed(messageContext, state.identity);\n    if (!normalized) {\n      state.logger.debug(\"telegram.event_ignored\", {\n        reason: \"unsupported_message\",\n        chatId: String(messageContext.chat.id),\n        messageId: messageContext.msg.message_id,\n      });\n      return;\n    }\n\n    const conversationKey = buildConversationKey(\n      normalized.chatId,\n      normalized.threadId,\n    );\n\n    state.logger.info(\"telegram.event_received\", {\n      trigger,\n      conversationKey,\n      chatId: normalized.chatId,\n      messageId: normalized.messageId,\n      textChars: normalized.text.length,\n    });\n\n    enqueueMessage(state, conversationKey, {\n      context: messageContext,\n      kind: trigger,\n      message: normalized,\n      receivedAt: Date.now(),\n    });\n  });\n\n  bot.catch((error) => {\n    const context = error.ctx;\n    if (error.error instanceof GrammyError) {\n      state.logger.error(\"telegram.middleware_failed\", {\n        chatId: context.chat?.id !== undefined ? String(context.chat.id) : undefined,\n        messageId: context.msg?.message_id,\n        message: error.error.description,\n      });\n      return;\n    }\n\n    if (error.error instanceof HttpError) {\n      state.logger.error(\"telegram.middleware_failed\", {\n        chatId: context.chat?.id !== undefined ? String(context.chat.id) : undefined,\n        messageId: context.msg?.message_id,\n        message: error.error.message,\n      });\n      return;\n    }\n\n    const message = error.error instanceof Error\n      ? error.error.message\n      : String(error.error);\n\n    state.logger.error(\"telegram.middleware_failed\", {\n      chatId: context.chat?.id !== undefined ? String(context.chat.id) : undefined,\n      messageId: context.msg?.message_id,\n      message,\n    });\n  });\n};\n\nconst resolveTelegramBotToken = (\n  telegramConfig: TelegramPlatformIdentityConfig,\n  env: TelegramGatewayEnv,\n): string => {\n  const botToken =\n    env.TELEGRAM_BOT_TOKEN ?? telegramConfig.botToken ?? \"\";\n\n  if (!botToken) {\n    throw new Error(\"Missing Telegram credentials: TELEGRAM_BOT_TOKEN\");\n  }\n\n  return botToken;\n};\n\nconst resolveAllowedChatIds = (\n  telegramConfig: TelegramPlatformIdentityConfig,\n  env: TelegramGatewayEnv,\n): Set<string> | undefined => {\n  if (env.JARVIS_TELEGRAM_ALLOWED_CHAT_IDS) {\n    const values = env.JARVIS_TELEGRAM_ALLOWED_CHAT_IDS\n      .split(\",\")\n      .map((value) => value.trim())\n      .filter((value) => value.length > 0);\n\n    return values.length > 0 ? new Set(values) : undefined;\n  }\n\n  const configured = telegramConfig.allowedChatIds;\n  if (!configured || configured.length === 0) {\n    return undefined;\n  }\n\n  return new Set(configured);\n};\n\nconst resolveAllowedUsernames = (\n  telegramConfig: TelegramPlatformIdentityConfig,\n  env: TelegramGatewayEnv,\n): Set<string> | undefined => {\n  if (env.JARVIS_TELEGRAM_ALLOWED_USERNAMES) {\n    const values = env.JARVIS_TELEGRAM_ALLOWED_USERNAMES\n      .split(\",\")\n      .map((value) => value.trim().replace(/^@/, \"\").toLowerCase())\n      .filter((value) => value.length > 0);\n\n    return values.length > 0 ? new Set(values) : undefined;\n  }\n\n  const configured = telegramConfig.allowedUsernames;\n  if (!configured || configured.length === 0) {\n    return undefined;\n  }\n\n  return new Set(configured);\n};\n\nconst isAllowedChat = (\n  chatId: number,\n  state: TelegramGatewayState,\n): boolean => {\n  if (!state.allowedChatIds) {\n    return true;\n  }\n\n  return state.allowedChatIds.has(String(chatId));\n};\n\nconst isAllowedUsername = (\n  username: string | undefined,\n  state: TelegramGatewayState,\n): boolean => {\n  if (!state.allowedUsernames) {\n    return true;\n  }\n\n  if (!username) {\n    return false;\n  }\n\n  return state.allowedUsernames.has(username.toLowerCase());\n};\n\nconst classifyMessageTrigger = (\n  context: TelegramMessageContext,\n  identity: TelegramIdentity,\n): TriggerKind | null => {\n  if (context.chat.type === \"private\") {\n    return \"private_chat\";\n  }\n\n  const replyTo = context.msg.reply_to_message;\n  if (replyTo?.from?.id === identity.botId) {\n    return \"reply_to_bot\";\n  }\n\n  const text = readTelegramMessageText(context.msg);\n  if (!text) {\n    return null;\n  }\n\n  const username = identity.username;\n  if (!username) {\n    return null;\n  }\n\n  const normalizedMention = `@${username.toLowerCase()}`;\n  return text.toLowerCase().includes(normalizedMention) ? \"mention\" : null;\n};\n\nconst normalizeTelegramMessageSeed = (\n  context: TelegramMessageContext,\n  identity: TelegramIdentity,\n): TelegramMessageSeed | null => {\n  const text = readTelegramMessageText(context.msg);\n  const from = context.msg.from;\n\n  if (!text || !from) {\n    return null;\n  }\n\n  const sentAt = new Date(context.msg.date * 1000);\n  const normalizedText = stripBotMention(text, identity.username);\n\n  if (!normalizedText) {\n    return null;\n  }\n\n  const chatTitle = readChatTitle(context.chat);\n  const replyTo = readReplyContext(context.msg.reply_to_message);\n\n  return {\n    id: String(context.msg.message_id),\n    messageId: context.msg.message_id,\n    text: normalizedText,\n    authorId: String(from.id),\n    authorName: formatTelegramAuthorName(from),\n    sentAt,\n    chatId: String(context.chat.id),\n    chatType: context.chat.type === \"private\" ? \"private\" : \"group\",\n    chatTitle,\n    threadId: context.msg.message_thread_id,\n    replyTo,\n  };\n};\n\nconst readTelegramMessageText = (\n  message: TelegramReadableMessage | undefined,\n): string | undefined => {\n  return message?.text ?? message?.caption;\n};\n\nexport const isTelegramSideQuestionCommand = (text: string | undefined): boolean => {\n  return text !== undefined && parseSideQuestionCommand({\n    input: text,\n    parentThreadId: \"preview\",\n    source: { platform: \"telegram\" },\n  }) !== null;\n};\n\nconst stripBotMention = (\n  text: string,\n  username: string | undefined,\n): string => {\n  if (!username) {\n    return text.trim();\n  }\n\n  return text.replaceAll(`@${username}`, \"\").trim();\n};\n\nconst formatTelegramAuthorName = (\n  from: TelegramUserLike,\n): string => {\n  const parts = [from.first_name, from.last_name].filter(\n    (part): part is string => Boolean(part),\n  );\n\n  if (parts.length > 0) {\n    return parts.join(\" \");\n  }\n\n  return from.username ?? String(from.id);\n};\n\nconst readChatTitle = (\n  chat: TelegramMessageContext[\"chat\"],\n): string | undefined => {\n  switch (chat.type) {\n    case \"group\":\n    case \"supergroup\":\n      return chat.title;\n    case \"private\":\n      return undefined;\n  }\n};\n\nconst readReplyContext = (\n  replyTo: TelegramMessageContext[\"msg\"][\"reply_to_message\"],\n): TelegramReplyContext | undefined => {\n  const text = replyTo ? readTelegramMessageText(replyTo) : undefined;\n  const from = replyTo?.from;\n  if (!replyTo || !text || !from) {\n    return undefined;\n  }\n\n  return {\n    authorId: String(from.id),\n    authorName: formatTelegramAuthorName(from),\n    text,\n    sentAt: new Date(replyTo.date * 1000),\n  };\n};\n\nconst enqueueMessage = (\n  state: TelegramGatewayState,\n  conversationKey: string,\n  entry: QueueEntry,\n): void => {\n  const queue = getConversationQueue(state, conversationKey);\n  const now = Date.now();\n\n  queue.entries = queue.entries.filter(\n    (queued) => now - queued.receivedAt <= queueEntryTtlMs,\n  );\n  queue.entries.push(entry);\n\n  if (queue.entries.length > maxQueueSize) {\n    queue.entries.splice(0, queue.entries.length - maxQueueSize);\n  }\n\n  state.logger.info(\"telegram.queue_enqueued\", {\n    conversationKey,\n    trigger: entry.kind,\n    queueSize: queue.entries.length,\n    chatId: entry.message.chatId,\n    messageId: entry.message.messageId,\n  });\n\n  if (!queue.running) {\n    queue.running = true;\n    void drainQueue(state, conversationKey, queue);\n  }\n};\n\nconst drainQueue = async (\n  state: TelegramGatewayState,\n  conversationKey: string,\n  queue: ConversationQueueState,\n): Promise<void> => {\n  try {\n    while (queue.entries.length > 0) {\n      const now = Date.now();\n      queue.entries = queue.entries.filter(\n        (queued) => now - queued.receivedAt <= queueEntryTtlMs,\n      );\n\n      if (queue.entries.length === 0) {\n        break;\n      }\n\n      const batch = queue.entries.splice(0, queue.entries.length);\n      if (batch.length === 0) {\n        continue;\n      }\n\n      const current = batch[batch.length - 1]!;\n      const skipped = batch.slice(0, -1).map((item) => item.message);\n\n      state.logger.info(\"telegram.queue_draining\", {\n        conversationKey,\n        batchSize: batch.length,\n        skippedCount: skipped.length,\n        trigger: current.kind,\n      });\n\n      try {\n        await handleQueueEntry(state, conversationKey, current, skipped);\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        state.logger.error(\"telegram.queue_entry_failed\", {\n          conversationKey,\n          message,\n        });\n      }\n    }\n  } finally {\n    queue.running = false;\n  }\n};\n\nconst handleQueueEntry = async (\n  state: TelegramGatewayState,\n  conversationKey: string,\n  entry: QueueEntry,\n  skipped: TelegramMessageSeed[],\n): Promise<void> => {\n  const threadId = buildThreadIdFromScope({\n    platform: \"telegram\",\n    identityId: state.identityConfig.id,\n    scope: entry.message.threadId === undefined\n      ? {\n        kind: \"telegram\",\n        chatId: entry.message.chatId,\n      }\n      : {\n        kind: \"telegram\",\n        chatId: entry.message.chatId,\n        messageThreadId: String(entry.message.threadId),\n      },\n  });\n  const requestLogger = state.logger.child({\n    conversationKey,\n    threadId,\n    entityId: state.identityConfig.entityId,\n    chatId: entry.message.chatId,\n    messageId: entry.message.messageId,\n    trigger: entry.kind,\n  });\n  const current = materializeTelegramMessage(entry.message);\n  const skippedMessages = skipped.map(materializeTelegramMessage);\n  const prompt = buildTelegramPrompt({\n    message: current,\n    skipped: skippedMessages,\n    chatType: current.chatTitle || entry.message.chatType === \"group\"\n      ? \"group\"\n      : \"private\",\n  });\n\n  requestLogger.info(\"telegram.request_started\", {\n    skippedCount: skippedMessages.length,\n    currentAuthor: current.authorName,\n    promptChars: prompt.length,\n  });\n\n  const sideQuestion = await maybeExecuteSideQuestionIngress({\n    config: state.runtime,\n    parentThreadId: threadId,\n    input: current.text,\n    source: {\n      platform: \"telegram\",\n      identityId: state.identityConfig.id,\n    },\n    logger: requestLogger,\n  });\n\n  if (sideQuestion.handled) {\n    await entry.context.reply(\n      sideQuestion.result.outputText.trim().length > 0\n        ? sideQuestion.result.outputText\n        : \"I do not have a side-question reply.\",\n      createReplyOptions(entry.context),\n    );\n    return;\n  }\n\n  await respondInTelegramConversation({\n    state,\n    context: entry.context,\n    conversationKey,\n    threadId,\n    prompt,\n    skillTriggerText: buildTelegramSkillTriggerText(current, skippedMessages),\n    logger: requestLogger,\n  });\n};\n\nconst materializeTelegramMessage = (\n  seed: TelegramMessageSeed,\n): TelegramMessage => {\n  return {\n    id: seed.id,\n    text: seed.text,\n    authorId: seed.authorId,\n    authorName: seed.authorName,\n    sentAt: seed.sentAt,\n    chatTitle: seed.chatTitle,\n    replyTo: seed.replyTo,\n  };\n};\n\nconst respondInTelegramConversation = async (options: {\n  state: TelegramGatewayState;\n  context: TelegramMessageContext;\n  conversationKey: string;\n  threadId: string;\n  prompt: string;\n  skillTriggerText: string;\n  logger: Logger;\n}): Promise<void> => {\n  const startedAt = Date.now();\n  const textStream = new AsyncTextDeltaQueue();\n  let emittedText = false;\n  let turnId: string | undefined;\n  let runId: string | undefined;\n\n  // Retrieve contributions lazily — by the time events fire, jar-runtime has\n  // already registered them in the services registry after manager.load().\n  const contributions = options.state.services.get<PluginContribution>(\"pluginContributions\");\n\n  const responseTask = executeIngressCommand({\n    config: options.state.runtime,\n    hooks: options.state.hooks,\n    logger: options.logger,\n    pluginOverrides: contributions ?? { skillRoots: [], overlays: [], tools: [] },\n    command: {\n      kind: \"message\",\n      source: {\n        platform: \"telegram\",\n      },\n      routing: {\n        platform: \"telegram\",\n        scope: options.context.msg.message_thread_id === undefined\n          ? {\n            kind: \"telegram\",\n            chatId: String(options.context.chat.id),\n          }\n          : {\n            kind: \"telegram\",\n            chatId: String(options.context.chat.id),\n            messageThreadId: String(options.context.msg.message_thread_id),\n          },\n      },\n      message: {\n        text: options.skillTriggerText,\n        id: String(options.context.msg.message_id),\n      },\n      prompt: options.prompt,\n      skillTriggerText: options.skillTriggerText,\n      audit: {\n        trigger: \"platform_event\",\n        triggerKind: \"telegram_message\",\n        metadata: {\n          conversationKey: options.conversationKey,\n          chatId: String(options.context.chat.id),\n          messageId: options.context.msg.message_id,\n        },\n      },\n      execution: {\n        onEvent(event) {\n          if (\n            event.type === \"message_update\" &&\n            event.assistantMessageEvent.type === \"text_delta\"\n          ) {\n            emittedText = true;\n            textStream.push(event.assistantMessageEvent.delta);\n          }\n        },\n      },\n    } satisfies MessageIngressCommand,\n  })\n    .then((result) => {\n      const { outputText } = result;\n      if (!emittedText) {\n        textStream.push(\n          outputText.trim().length > 0\n            ? outputText\n            : \"I finished processing that, but I do not have a textual reply to send.\",\n        );\n      }\n\n      textStream.close();\n      return result;\n    })\n    .catch((error: unknown) => {\n      textStream.fail(toError(error));\n      throw error;\n    });\n\n  try {\n    await options.context.replyWithStream(\n      textStream,\n      createReplyOptions(options.context),\n    );\n    const result = await responseTask;\n    if (result.kind !== \"message\") {\n      throw new Error(\"Telegram reply generation expected a message execution result.\");\n    }\n    turnId = result.turnId;\n    runId = result.runId;\n    const outputText = result.outputText;\n\n    options.logger.info(\"telegram.reply_posted\", {\n      durationMs: Date.now() - startedAt,\n      replyChars: outputText.trim().length,\n      threadId: options.threadId,\n      turnId: result.turnId,\n      runId: result.runId,\n      conversationKey: options.conversationKey,\n      streamed: true,\n    });\n  } catch (error) {\n    const settledResult = await responseTask.catch(() => undefined);\n    if (settledResult?.kind === \"message\") {\n      turnId = turnId ?? settledResult.turnId;\n      runId = runId ?? settledResult.runId;\n    }\n    const normalizedError = toError(error);\n    const envelope = getFaultEnvelope(error);\n    options.logger.error(\"telegram.reply_failed\", {\n      durationMs: Date.now() - startedAt,\n      message: normalizedError.message,\n      threadId: options.threadId,\n      turnId: turnId ?? envelope?.turnId,\n      runId: runId ?? envelope?.runId,\n      conversationKey: options.conversationKey,\n      fault: envelope?.fault,\n      phase: envelope?.phase,\n    });\n\n    if (!emittedText) {\n      await options.context.reply(\n        \"I ran into an error while processing that request. Please try again in the same chat.\",\n        createReplyOptions(options.context),\n      );\n    }\n  }\n};\n\nconst buildTelegramSkillTriggerText = (\n  currentMessage: TelegramMessage,\n  skipped: TelegramMessage[],\n): string => {\n  return [...skipped, currentMessage]\n    .map((message) => message.text.trim())\n    .filter((text) => text.length > 0)\n    .join(\"\\n\");\n};\n\nconst createReplyOptions = (\n  context: TelegramMessageContext,\n): Record<string, number | { message_id: number }> => {\n  const options: Record<string, number | { message_id: number }> = {\n    reply_parameters: {\n      message_id: context.msg.message_id,\n    },\n  };\n\n  if (context.msg.message_thread_id !== undefined) {\n    options.message_thread_id = context.msg.message_thread_id;\n  }\n\n  return options;\n};\n\nconst getConversationQueue = (\n  state: TelegramGatewayState,\n  conversationKey: string,\n): ConversationQueueState => {\n  const existing = state.queues.get(conversationKey);\n  if (existing) {\n    return existing;\n  }\n\n  const created: ConversationQueueState = {\n    running: false,\n    entries: [],\n  };\n  state.queues.set(conversationKey, created);\n  return created;\n};\n\nconst buildConversationKey = (\n  chatId: string,\n  threadId: number | undefined,\n): string => {\n  return threadId === undefined ? chatId : `${chatId}:${threadId}`;\n};\n\nconst loadTelegramGatewayEnv = (\n  rawEnv: NodeJS.ProcessEnv,\n): TelegramGatewayEnv => {\n  return telegramGatewayEnvSchema.parse(rawEnv);\n};\n\nconst toError = (error: unknown): Error => {\n  return error instanceof Error ? error : new Error(String(error));\n};\n\nclass AsyncTextDeltaQueue implements AsyncIterable<string> {\n  private readonly chunks: string[] = [];\n  private readonly waiters: AsyncIteratorWaiter[] = [];\n  private completed = false;\n  private failure: Error | null = null;\n\n  push(chunk: string): void {\n    if (!chunk) {\n      return;\n    }\n\n    const waiter = this.waiters.shift();\n    if (waiter) {\n      waiter.resolve({\n        done: false,\n        value: chunk,\n      });\n      return;\n    }\n\n    this.chunks.push(chunk);\n  }\n\n  close(): void {\n    this.completed = true;\n\n    while (this.waiters.length > 0) {\n      const waiter = this.waiters.shift();\n      waiter?.resolve({\n        done: true,\n        value: undefined,\n      });\n    }\n  }\n\n  fail(error: Error): void {\n    this.failure = error;\n\n    while (this.waiters.length > 0) {\n      this.waiters.shift()?.reject(error);\n    }\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<string> {\n    return {\n      next: async (): Promise<IteratorResult<string>> => {\n        if (this.chunks.length > 0) {\n          return {\n            done: false,\n            value: this.chunks.shift()!,\n          };\n        }\n\n        if (this.failure) {\n          throw this.failure;\n        }\n\n        if (this.completed) {\n          return {\n            done: true,\n            value: undefined,\n          };\n        }\n\n        return new Promise<IteratorResult<string>>((resolve, reject) => {\n          this.waiters.push({\n            resolve,\n            reject,\n          });\n        });\n      },\n    };\n  }\n}\n","import type {\n  JarPlugin,\n  PluginFactory,\n  PluginInstallContext,\n  PluginInstallResult,\n  Logger,\n} from \"@hijarvis/core\";\nimport { createLogger } from \"@hijarvis/core\";\nimport { startTelegramIdentities, type StopFn } from \"./runtime.js\";\n\nexport const createPlugin: PluginFactory = (_pluginConfig) => {\n  const plugin: JarPlugin = {\n    name: \"jar-gateway-telegram\",\n    async install({ config, hooks, services, logger }: PluginInstallContext): Promise<PluginInstallResult> {\n      const effectiveLogger: Logger = logger ?? createLogger({ level: \"info\", stderr: true });\n      const stops: StopFn[] = await startTelegramIdentities(config, hooks, services, effectiveLogger);\n      return {\n        cleanup: async () => {\n          for (const stop of stops) {\n            await stop();\n          }\n        },\n      };\n    },\n  };\n  return plugin;\n};\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hijarvis/plugin-telegram",
+  "version": "0.0.0",
+  "type": "module",
+  "license": "MIT",
+  "author": "wibus-wee",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wibus-wee/HiJarvis.git",
+    "directory": "packages/jar-plugin-telegram"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/plugin.d.mts",
+      "import": "./dist/plugin.mjs"
+    }
+  },
+  "main": "./dist/plugin.mjs",
+  "types": "./dist/plugin.d.mts",
+  "dependencies": {
+    "@grammyjs/auto-retry": "^2.0.2",
+    "@grammyjs/runner": "^2.0.3",
+    "@grammyjs/stream": "^1.0.1",
+    "grammy": "^1.42.0",
+    "zod": "^4.3.6",
+    "@hijarvis/core": "0.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc --noEmit",
+    "test": "tsx --test src/*.test.ts src/**/*.test.ts"
+  }
+}