@xopcai/xopc 0.0.99 → 0.0.100

package/dist/extensions/telegram/src/polling-session.js

@@ -0,0 +1,112 @@
+import { createLogger } from "../../../src/utils/logger/index.js";
+import { init_logger } from "../../../src/utils/logger.js";
+import { isRecoverableTelegramNetworkError } from "./network-errors.js";
+import { readTelegramUpdateOffset, writeTelegramUpdateOffset } from "./update-offset-store.js";
+import { run } from "@grammyjs/runner";
+//#region extensions/telegram/src/polling-session.ts
+init_logger();
+const log = createLogger("TelegramPolling");
+const DEFAULT_STALL_THRESHOLD_MS = 12e4;
+const MIN_STALL_THRESHOLD_MS = 3e4;
+const MAX_STALL_THRESHOLD_MS = 6e5;
+const WATCHDOG_INTERVAL_MS = 3e4;
+function resolvePollingStallThresholdMs(value) {
+	if (value == null || !Number.isFinite(value)) return DEFAULT_STALL_THRESHOLD_MS;
+	return Math.min(MAX_STALL_THRESHOLD_MS, Math.max(MIN_STALL_THRESHOLD_MS, Math.floor(value)));
+}
+function wireTelegramUpdateOffsetPersistence(bot, params) {
+	const savedOffset = readTelegramUpdateOffset(params);
+	if (savedOffset != null) {
+		let restored = false;
+		bot.api.config.use(async (prev, method, payload, signal) => {
+			if (method === "getUpdates" && !restored) {
+				restored = true;
+				return prev(method, {
+					...payload,
+					offset: savedOffset + 1
+				}, signal);
+			}
+			return prev(method, payload, signal);
+		});
+	}
+	bot.use(async (ctx, next) => {
+		const updateId = ctx.update.update_id;
+		if (Number.isSafeInteger(updateId)) writeTelegramUpdateOffset({
+			...params,
+			lastUpdateId: updateId
+		});
+		await next();
+	});
+}
+function startTelegramPollingSession(options) {
+	const { accountId, botToken, bot } = options;
+	const stallThresholdMs = resolvePollingStallThresholdMs(options.stallThresholdMs);
+	wireTelegramUpdateOffsetPersistence(bot, {
+		accountId,
+		botToken
+	});
+	let lastUpdateAt = Date.now();
+	bot.use(async (_ctx, next) => {
+		lastUpdateAt = Date.now();
+		await next();
+	});
+	const runner = run(bot, { runner: {
+		fetch: { timeout: 30 },
+		silent: true,
+		maxRetryTime: Number.POSITIVE_INFINITY,
+		retryInterval: "exponential"
+	} });
+	const watchdog = setInterval(() => {
+		const idleMs = Date.now() - lastUpdateAt;
+		if (idleMs < stallThresholdMs) return;
+		log.warn({
+			accountId,
+			idleMs,
+			stallThresholdMs
+		}, "Telegram polling stall detected; restarting runner");
+		lastUpdateAt = Date.now();
+		restartRunner(runner, accountId).catch((err) => {
+			log.error({
+				err,
+				accountId
+			}, "Telegram polling restart failed");
+		});
+	}, WATCHDOG_INTERVAL_MS);
+	watchdog.unref?.();
+	attachRunnerExit(runner, accountId, options.onExit);
+	return { stop: async () => {
+		clearInterval(watchdog);
+		await runner.stop();
+	} };
+}
+async function restartRunner(runner, accountId) {
+	try {
+		await runner.stop();
+		runner.start();
+		log.info({ accountId }, "Telegram polling runner restarted");
+	} catch (err) {
+		if (isRecoverableTelegramNetworkError(err)) {
+			log.warn({
+				err,
+				accountId
+			}, "Telegram polling restart hit network error");
+			return;
+		}
+		throw err;
+	}
+}
+async function attachRunnerExit(runner, accountId, onExit) {
+	const task = runner.task();
+	if (!task) return;
+	task.catch((err) => {
+		log.error({
+			err,
+			accountId
+		}, "Telegram polling runner exited");
+		onExit?.(err);
+	});
+}
+//#endregion
+export { resolvePollingStallThresholdMs, startTelegramPollingSession, wireTelegramUpdateOffsetPersistence };
+
+//# sourceMappingURL=polling-session.js.map

package/dist/extensions/telegram/src/polling-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-session.js","names":[],"sources":["../../../../extensions/telegram/src/polling-session.ts"],"sourcesContent":["import type { Bot } from 'grammy';\nimport { run, type RunnerHandle } from '@grammyjs/runner';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\nimport { isRecoverableTelegramNetworkError } from './network-errors.js';\nimport { readTelegramUpdateOffset, writeTelegramUpdateOffset } from './update-offset-store.js';\n\nconst log = createLogger('TelegramPolling');\n\nconst DEFAULT_STALL_THRESHOLD_MS = 120_000;\nconst MIN_STALL_THRESHOLD_MS = 30_000;\nconst MAX_STALL_THRESHOLD_MS = 600_000;\nconst WATCHDOG_INTERVAL_MS = 30_000;\n\nexport function resolvePollingStallThresholdMs(value?: number): number {\n  if (value == null || !Number.isFinite(value)) return DEFAULT_STALL_THRESHOLD_MS;\n  return Math.min(MAX_STALL_THRESHOLD_MS, Math.max(MIN_STALL_THRESHOLD_MS, Math.floor(value)));\n}\n\nexport interface TelegramPollingSessionOptions {\n  accountId: string;\n  botToken: string;\n  bot: Bot;\n  stallThresholdMs?: number;\n  onExit?: (err?: unknown) => void;\n}\n\nexport interface TelegramPollingSession {\n  stop: () => Promise<void>;\n}\n\nexport function wireTelegramUpdateOffsetPersistence(\n  bot: Bot,\n  params: { accountId: string; botToken: string },\n): void {\n  const savedOffset = readTelegramUpdateOffset(params);\n  if (savedOffset != null) {\n    let restored = false;\n    bot.api.config.use(async (prev, method, payload, signal) => {\n      if (method === 'getUpdates' && !restored) {\n        restored = true;\n        const nextPayload = { ...(payload as object), offset: savedOffset + 1 } as typeof payload;\n        return prev(method, nextPayload, signal);\n      }\n      return prev(method, payload, signal);\n    });\n  }\n\n  bot.use(async (ctx, next) => {\n    const updateId = ctx.update.update_id;\n    if (Number.isSafeInteger(updateId)) {\n      writeTelegramUpdateOffset({ ...params, lastUpdateId: updateId });\n    }\n    await next();\n  });\n}\n\nexport function startTelegramPollingSession(\n  options: TelegramPollingSessionOptions,\n): TelegramPollingSession {\n  const { accountId, botToken, bot } = options;\n  const stallThresholdMs = resolvePollingStallThresholdMs(options.stallThresholdMs);\n\n  wireTelegramUpdateOffsetPersistence(bot, { accountId, botToken });\n\n  let lastUpdateAt = Date.now();\n  bot.use(async (_ctx, next) => {\n    lastUpdateAt = Date.now();\n    await next();\n  });\n\n  const runner = run(bot, {\n    runner: {\n      fetch: { timeout: 30 },\n      silent: true,\n      maxRetryTime: Number.POSITIVE_INFINITY,\n      retryInterval: 'exponential',\n    },\n  });\n\n  const watchdog = setInterval(() => {\n    const idleMs = Date.now() - lastUpdateAt;\n    if (idleMs < stallThresholdMs) return;\n    log.warn({ accountId, idleMs, stallThresholdMs }, 'Telegram polling stall detected; restarting runner');\n    lastUpdateAt = Date.now();\n    void restartRunner(runner, accountId).catch((err) => {\n      log.error({ err, accountId }, 'Telegram polling restart failed');\n    });\n  }, WATCHDOG_INTERVAL_MS);\n  watchdog.unref?.();\n\n  void attachRunnerExit(runner, accountId, options.onExit);\n\n  return {\n    stop: async () => {\n      clearInterval(watchdog);\n      await runner.stop();\n    },\n  };\n}\n\nasync function restartRunner(runner: RunnerHandle, accountId: string): Promise<void> {\n  try {\n    await runner.stop();\n    runner.start();\n    log.info({ accountId }, 'Telegram polling runner restarted');\n  } catch (err) {\n    if (isRecoverableTelegramNetworkError(err)) {\n      log.warn({ err, accountId }, 'Telegram polling restart hit network error');\n      return;\n    }\n    throw err;\n  }\n}\n\nasync function attachRunnerExit(\n  runner: RunnerHandle,\n  accountId: string,\n  onExit?: (err?: unknown) => void,\n): Promise<void> {\n  const task = runner.task();\n  if (!task) return;\n  void task.catch((err) => {\n    log.error({ err, accountId }, 'Telegram polling runner exited');\n    onExit?.(err);\n  });\n}\n"],"mappings":";;;;;;aAE4D;AAI5D,MAAM,MAAM,aAAa,kBAAkB;AAE3C,MAAM,6BAA6B;AACnC,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAC/B,MAAM,uBAAuB;AAE7B,SAAgB,+BAA+B,OAAwB;AACrE,KAAI,SAAS,QAAQ,CAAC,OAAO,SAAS,MAAM,CAAE,QAAO;AACrD,QAAO,KAAK,IAAI,wBAAwB,KAAK,IAAI,wBAAwB,KAAK,MAAM,MAAM,CAAC,CAAC;;AAe9F,SAAgB,oCACd,KACA,QACM;CACN,MAAM,cAAc,yBAAyB,OAAO;AACpD,KAAI,eAAe,MAAM;EACvB,IAAI,WAAW;AACf,MAAI,IAAI,OAAO,IAAI,OAAO,MAAM,QAAQ,SAAS,WAAW;AAC1D,OAAI,WAAW,gBAAgB,CAAC,UAAU;AACxC,eAAW;AAEX,WAAO,KAAK,QAAQ;KADE,GAAI;KAAoB,QAAQ,cAAc;KACrC,EAAE,OAAO;;AAE1C,UAAO,KAAK,QAAQ,SAAS,OAAO;IACpC;;AAGJ,KAAI,IAAI,OAAO,KAAK,SAAS;EAC3B,MAAM,WAAW,IAAI,OAAO;AAC5B,MAAI,OAAO,cAAc,SAAS,CAChC,2BAA0B;GAAE,GAAG;GAAQ,cAAc;GAAU,CAAC;AAElE,QAAM,MAAM;GACZ;;AAGJ,SAAgB,4BACd,SACwB;CACxB,MAAM,EAAE,WAAW,UAAU,QAAQ;CACrC,MAAM,mBAAmB,+BAA+B,QAAQ,iBAAiB;AAEjF,qCAAoC,KAAK;EAAE;EAAW;EAAU,CAAC;CAEjE,IAAI,eAAe,KAAK,KAAK;AAC7B,KAAI,IAAI,OAAO,MAAM,SAAS;AAC5B,iBAAe,KAAK,KAAK;AACzB,QAAM,MAAM;GACZ;CAEF,MAAM,SAAS,IAAI,KAAK,EACtB,QAAQ;EACN,OAAO,EAAE,SAAS,IAAI;EACtB,QAAQ;EACR,cAAc,OAAO;EACrB,eAAe;EAChB,EACF,CAAC;CAEF,MAAM,WAAW,kBAAkB;EACjC,MAAM,SAAS,KAAK,KAAK,GAAG;AAC5B,MAAI,SAAS,iBAAkB;AAC/B,MAAI,KAAK;GAAE;GAAW;GAAQ;GAAkB,EAAE,qDAAqD;AACvG,iBAAe,KAAK,KAAK;AACpB,gBAAc,QAAQ,UAAU,CAAC,OAAO,QAAQ;AACnD,OAAI,MAAM;IAAE;IAAK;IAAW,EAAE,kCAAkC;IAChE;IACD,qBAAqB;AACxB,UAAS,SAAS;AAEb,kBAAiB,QAAQ,WAAW,QAAQ,OAAO;AAExD,QAAO,EACL,MAAM,YAAY;AAChB,gBAAc,SAAS;AACvB,QAAM,OAAO,MAAM;IAEtB;;AAGH,eAAe,cAAc,QAAsB,WAAkC;AACnF,KAAI;AACF,QAAM,OAAO,MAAM;AACnB,SAAO,OAAO;AACd,MAAI,KAAK,EAAE,WAAW,EAAE,oCAAoC;UACrD,KAAK;AACZ,MAAI,kCAAkC,IAAI,EAAE;AAC1C,OAAI,KAAK;IAAE;IAAK;IAAW,EAAE,6CAA6C;AAC1E;;AAEF,QAAM;;;AAIV,eAAe,iBACb,QACA,WACA,QACe;CACf,MAAM,OAAO,OAAO,MAAM;AAC1B,KAAI,CAAC,KAAM;AACN,MAAK,OAAO,QAAQ;AACvB,MAAI,MAAM;GAAE;GAAK;GAAW,EAAE,iCAAiC;AAC/D,WAAS,IAAI;GACb"}

package/dist/extensions/telegram/src/proxy-fetch.d.ts

@@ -0,0 +1,2 @@
+/** Build a fetch compatible with grammY client when an HTTP proxy is configured. */
+export declare function createProxyFetch(proxyUrl: string): typeof fetch;

package/dist/extensions/telegram/src/proxy-fetch.js

@@ -0,0 +1,14 @@
+import { ProxyAgent, fetch } from "undici";
+//#region extensions/telegram/src/proxy-fetch.ts
+/** Build a fetch compatible with grammY client when an HTTP proxy is configured. */
+function createProxyFetch(proxyUrl) {
+	const agent = new ProxyAgent(proxyUrl);
+	return ((input, init) => fetch(input, {
+		...init,
+		dispatcher: agent
+	}));
+}
+//#endregion
+export { createProxyFetch };
+
+//# sourceMappingURL=proxy-fetch.js.map

package/dist/extensions/telegram/src/proxy-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-fetch.js","names":["undiciFetch"],"sources":["../../../../extensions/telegram/src/proxy-fetch.ts"],"sourcesContent":["import { ProxyAgent, fetch as undiciFetch } from 'undici';\n\n/** Build a fetch compatible with grammY client when an HTTP proxy is configured. */\nexport function createProxyFetch(proxyUrl: string): typeof fetch {\n  const agent = new ProxyAgent(proxyUrl);\n  return ((input: Parameters<typeof fetch>[0], init?: Parameters<typeof fetch>[1]) =>\n    undiciFetch(input as string, {\n      ...(init as Record<string, unknown>),\n      dispatcher: agent,\n    }) as unknown as Promise<Response>) as typeof fetch;\n}\n"],"mappings":";;;AAGA,SAAgB,iBAAiB,UAAgC;CAC/D,MAAM,QAAQ,IAAI,WAAW,SAAS;AACtC,UAAS,OAAoC,SAC3CA,MAAY,OAAiB;EAC3B,GAAI;EACJ,YAAY;EACb,CAAC"}

package/dist/extensions/telegram/src/reactions.d.ts

@@ -0,0 +1,14 @@
+import type { Bot, Context } from 'grammy';
+import type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';
+export declare function sendTelegramAckReaction(params: {
+    bot: Bot;
+    chatId: number | string;
+    messageId: number;
+    emoji: string;
+}): Promise<void>;
+export declare function handleTelegramMessageReaction(params: {
+    ctx: Context;
+    accountId: string;
+    bus: MessageBus;
+    mode?: 'off' | 'own' | 'all';
+}): Promise<void>;

package/dist/extensions/telegram/src/reactions.js

@@ -0,0 +1,48 @@
+import { createLogger } from "../../../src/utils/logger/index.js";
+import { init_logger } from "../../../src/utils/logger.js";
+import { sentMessageCache } from "./sent-cache.js";
+//#region extensions/telegram/src/reactions.ts
+init_logger();
+const log = createLogger("TelegramReactions");
+async function sendTelegramAckReaction(params) {
+	try {
+		await params.bot.api.setMessageReaction(params.chatId, params.messageId, [{
+			type: "emoji",
+			emoji: params.emoji
+		}]);
+	} catch (err) {
+		log.debug({
+			err,
+			chatId: params.chatId,
+			messageId: params.messageId
+		}, "Ack reaction failed");
+	}
+}
+async function handleTelegramMessageReaction(params) {
+	const { ctx, accountId, bus } = params;
+	const mode = params.mode ?? "own";
+	if (mode === "off") return;
+	const update = ctx.messageReaction ?? ctx.update.message_reaction;
+	if (!update) return;
+	const chatId = update.chat.id;
+	const messageId = update.message_id;
+	if (mode === "own" && !sentMessageCache.wasSentByBot(String(chatId), messageId)) return;
+	const added = update.new_reaction?.map((r) => "emoji" in r ? r.emoji : r.type).join(", ");
+	if (!added) return;
+	await bus.publishInbound({
+		channel: "telegram",
+		chat_id: String(chatId),
+		sender_id: String(update.user?.id ?? update.actor_chat?.id ?? ""),
+		content: `[Reaction] ${added} on message ${messageId}`,
+		metadata: {
+			accountId,
+			messageId: String(messageId),
+			isReaction: true,
+			reaction: added
+		}
+	});
+}
+//#endregion
+export { handleTelegramMessageReaction, sendTelegramAckReaction };
+
+//# sourceMappingURL=reactions.js.map

package/dist/extensions/telegram/src/reactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactions.js","names":[],"sources":["../../../../extensions/telegram/src/reactions.ts"],"sourcesContent":["import type { Bot, Context } from 'grammy';\nimport type { MessageBus } from '@xopcai/xopc/infra/bus/index.js';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\nimport { sentMessageCache } from './sent-cache.js';\n\nconst log = createLogger('TelegramReactions');\n\nexport async function sendTelegramAckReaction(params: {\n  bot: Bot;\n  chatId: number | string;\n  messageId: number;\n  emoji: string;\n}): Promise<void> {\n  try {\n    await params.bot.api.setMessageReaction(params.chatId, params.messageId, [\n      { type: 'emoji', emoji: params.emoji as '👀' },\n    ]);\n  } catch (err) {\n    log.debug({ err, chatId: params.chatId, messageId: params.messageId }, 'Ack reaction failed');\n  }\n}\n\nexport async function handleTelegramMessageReaction(params: {\n  ctx: Context;\n  accountId: string;\n  bus: MessageBus;\n  mode?: 'off' | 'own' | 'all';\n}): Promise<void> {\n  const { ctx, accountId, bus } = params;\n  const mode = params.mode ?? 'own';\n  if (mode === 'off') return;\n\n  const update = ctx.messageReaction ?? (ctx.update as { message_reaction?: typeof ctx.messageReaction }).message_reaction;\n  if (!update) return;\n\n  const chatId = update.chat.id;\n  const messageId = update.message_id;\n  if (mode === 'own' && !sentMessageCache.wasSentByBot(String(chatId), messageId)) {\n    return;\n  }\n\n  const added = update.new_reaction?.map((r) => ('emoji' in r ? r.emoji : r.type)).join(', ');\n  if (!added) return;\n\n  await bus.publishInbound({\n    channel: 'telegram',\n    chat_id: String(chatId),\n    sender_id: String(update.user?.id ?? update.actor_chat?.id ?? ''),\n    content: `[Reaction] ${added} on message ${messageId}`,\n    metadata: {\n      accountId,\n      messageId: String(messageId),\n      isReaction: true,\n      reaction: added,\n    },\n  });\n}\n"],"mappings":";;;;aAE4D;AAG5D,MAAM,MAAM,aAAa,oBAAoB;AAE7C,eAAsB,wBAAwB,QAK5B;AAChB,KAAI;AACF,QAAM,OAAO,IAAI,IAAI,mBAAmB,OAAO,QAAQ,OAAO,WAAW,CACvE;GAAE,MAAM;GAAS,OAAO,OAAO;GAAe,CAC/C,CAAC;UACK,KAAK;AACZ,MAAI,MAAM;GAAE;GAAK,QAAQ,OAAO;GAAQ,WAAW,OAAO;GAAW,EAAE,sBAAsB;;;AAIjG,eAAsB,8BAA8B,QAKlC;CAChB,MAAM,EAAE,KAAK,WAAW,QAAQ;CAChC,MAAM,OAAO,OAAO,QAAQ;AAC5B,KAAI,SAAS,MAAO;CAEpB,MAAM,SAAS,IAAI,mBAAoB,IAAI,OAA6D;AACxG,KAAI,CAAC,OAAQ;CAEb,MAAM,SAAS,OAAO,KAAK;CAC3B,MAAM,YAAY,OAAO;AACzB,KAAI,SAAS,SAAS,CAAC,iBAAiB,aAAa,OAAO,OAAO,EAAE,UAAU,CAC7E;CAGF,MAAM,QAAQ,OAAO,cAAc,KAAK,MAAO,WAAW,IAAI,EAAE,QAAQ,EAAE,KAAM,CAAC,KAAK,KAAK;AAC3F,KAAI,CAAC,MAAO;AAEZ,OAAM,IAAI,eAAe;EACvB,SAAS;EACT,SAAS,OAAO,OAAO;EACvB,WAAW,OAAO,OAAO,MAAM,MAAM,OAAO,YAAY,MAAM,GAAG;EACjE,SAAS,cAAc,MAAM,cAAc;EAC3C,UAAU;GACR;GACA,WAAW,OAAO,UAAU;GAC5B,YAAY;GACZ,UAAU;GACX;EACF,CAAC"}

package/dist/extensions/telegram/src/reply-params.d.ts

@@ -0,0 +1,15 @@
+import type { ReplyToMode } from '@xopcai/xopc/channels/channel-domain.js';
+/** Per-chat tracker so `replyToMode: first` only applies reply once per inbound turn. */
+export declare class TelegramReplyTracker {
+    private firstUsed;
+    private key;
+    reset(accountId: string, chatId: string): void;
+    resolveReplyToMessageId(params: {
+        mode?: ReplyToMode;
+        explicitReplyTo?: string;
+        inboundMessageId?: string;
+        accountId: string;
+        chatId: string;
+    }): string | undefined;
+}
+export declare const telegramReplyTracker: TelegramReplyTracker;

package/dist/extensions/telegram/src/reply-params.js

@@ -0,0 +1,28 @@
+//#region extensions/telegram/src/reply-params.ts
+/** Per-chat tracker so `replyToMode: first` only applies reply once per inbound turn. */
+var TelegramReplyTracker = class {
+	firstUsed = /* @__PURE__ */ new Set();
+	key(accountId, chatId) {
+		return `${accountId}:${chatId}`;
+	}
+	reset(accountId, chatId) {
+		this.firstUsed.delete(this.key(accountId, chatId));
+	}
+	resolveReplyToMessageId(params) {
+		const mode = params.mode ?? "off";
+		if (params.explicitReplyTo?.trim()) return params.explicitReplyTo.trim();
+		const inbound = params.inboundMessageId?.trim();
+		if (!inbound) return void 0;
+		if (mode === "off") return void 0;
+		if (mode === "all") return inbound;
+		const k = this.key(params.accountId, params.chatId);
+		if (this.firstUsed.has(k)) return void 0;
+		this.firstUsed.add(k);
+		return inbound;
+	}
+};
+const telegramReplyTracker = new TelegramReplyTracker();
+//#endregion
+export { TelegramReplyTracker, telegramReplyTracker };
+
+//# sourceMappingURL=reply-params.js.map

package/dist/extensions/telegram/src/reply-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-params.js","names":[],"sources":["../../../../extensions/telegram/src/reply-params.ts"],"sourcesContent":["import type { ReplyToMode } from '@xopcai/xopc/channels/channel-domain.js';\n\n/** Per-chat tracker so `replyToMode: first` only applies reply once per inbound turn. */\nexport class TelegramReplyTracker {\n  private firstUsed = new Set<string>();\n\n  private key(accountId: string, chatId: string): string {\n    return `${accountId}:${chatId}`;\n  }\n\n  reset(accountId: string, chatId: string): void {\n    this.firstUsed.delete(this.key(accountId, chatId));\n  }\n\n  resolveReplyToMessageId(params: {\n    mode?: ReplyToMode;\n    explicitReplyTo?: string;\n    inboundMessageId?: string;\n    accountId: string;\n    chatId: string;\n  }): string | undefined {\n    const mode = params.mode ?? 'off';\n    if (params.explicitReplyTo?.trim()) {\n      return params.explicitReplyTo.trim();\n    }\n    const inbound = params.inboundMessageId?.trim();\n    if (!inbound) return undefined;\n\n    if (mode === 'off') return undefined;\n    if (mode === 'all') return inbound;\n\n    const k = this.key(params.accountId, params.chatId);\n    if (this.firstUsed.has(k)) return undefined;\n    this.firstUsed.add(k);\n    return inbound;\n  }\n}\n\nexport const telegramReplyTracker = new TelegramReplyTracker();\n"],"mappings":";;AAGA,IAAa,uBAAb,MAAkC;CAChC,4BAAoB,IAAI,KAAa;CAErC,IAAY,WAAmB,QAAwB;AACrD,SAAO,GAAG,UAAU,GAAG;;CAGzB,MAAM,WAAmB,QAAsB;AAC7C,OAAK,UAAU,OAAO,KAAK,IAAI,WAAW,OAAO,CAAC;;CAGpD,wBAAwB,QAMD;EACrB,MAAM,OAAO,OAAO,QAAQ;AAC5B,MAAI,OAAO,iBAAiB,MAAM,CAChC,QAAO,OAAO,gBAAgB,MAAM;EAEtC,MAAM,UAAU,OAAO,kBAAkB,MAAM;AAC/C,MAAI,CAAC,QAAS,QAAO,KAAA;AAErB,MAAI,SAAS,MAAO,QAAO,KAAA;AAC3B,MAAI,SAAS,MAAO,QAAO;EAE3B,MAAM,IAAI,KAAK,IAAI,OAAO,WAAW,OAAO,OAAO;AACnD,MAAI,KAAK,UAAU,IAAI,EAAE,CAAE,QAAO,KAAA;AAClC,OAAK,UAAU,IAAI,EAAE;AACrB,SAAO;;;AAIX,MAAa,uBAAuB,IAAI,sBAAsB"}

package/dist/extensions/telegram/src/startup-errors.d.ts

@@ -0,0 +1,3 @@
+/** Detect Telegram Bot API 401 Unauthorized (invalid/revoked token). */
+export declare function isTelegramUnauthorizedTokenError(err: unknown): boolean;
+export declare function formatTelegramStartupError(err: unknown): string;

package/dist/extensions/telegram/src/startup-errors.js

@@ -0,0 +1,27 @@
+//#region extensions/telegram/src/startup-errors.ts
+/** Detect Telegram Bot API 401 Unauthorized (invalid/revoked token). */
+function isTelegramUnauthorizedTokenError(err) {
+	const text = extractErrorText(err);
+	if (!text) return false;
+	if (/401/.test(text) && /unauthorized/i.test(text)) return true;
+	if (/401:\s*Unauthorized/i.test(text)) return true;
+	return false;
+}
+function formatTelegramStartupError(err) {
+	const text = extractErrorText(err);
+	if (isTelegramUnauthorizedTokenError(err)) return "Telegram bot token rejected (401 Unauthorized). Check the token with BotFather or update tokenFile.";
+	return text || "Unknown startup error";
+}
+function extractErrorText(err) {
+	if (typeof err === "string") return err;
+	if (err instanceof Error) return err.message;
+	if (err && typeof err === "object" && "description" in err) {
+		const d = err.description;
+		return typeof d === "string" ? d : "";
+	}
+	return String(err);
+}
+//#endregion
+export { formatTelegramStartupError, isTelegramUnauthorizedTokenError };
+
+//# sourceMappingURL=startup-errors.js.map

package/dist/extensions/telegram/src/startup-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-errors.js","names":[],"sources":["../../../../extensions/telegram/src/startup-errors.ts"],"sourcesContent":["/** Detect Telegram Bot API 401 Unauthorized (invalid/revoked token). */\nexport function isTelegramUnauthorizedTokenError(err: unknown): boolean {\n  const text = extractErrorText(err);\n  if (!text) return false;\n  if (/401/.test(text) && /unauthorized/i.test(text)) return true;\n  if (/401:\\s*Unauthorized/i.test(text)) return true;\n  return false;\n}\n\nexport function formatTelegramStartupError(err: unknown): string {\n  const text = extractErrorText(err);\n  if (isTelegramUnauthorizedTokenError(err)) {\n    return 'Telegram bot token rejected (401 Unauthorized). Check the token with BotFather or update tokenFile.';\n  }\n  return text || 'Unknown startup error';\n}\n\nfunction extractErrorText(err: unknown): string {\n  if (typeof err === 'string') return err;\n  if (err instanceof Error) return err.message;\n  if (err && typeof err === 'object' && 'description' in err) {\n    const d = (err as { description?: unknown }).description;\n    return typeof d === 'string' ? d : '';\n  }\n  return String(err);\n}\n"],"mappings":";;AACA,SAAgB,iCAAiC,KAAuB;CACtE,MAAM,OAAO,iBAAiB,IAAI;AAClC,KAAI,CAAC,KAAM,QAAO;AAClB,KAAI,MAAM,KAAK,KAAK,IAAI,gBAAgB,KAAK,KAAK,CAAE,QAAO;AAC3D,KAAI,uBAAuB,KAAK,KAAK,CAAE,QAAO;AAC9C,QAAO;;AAGT,SAAgB,2BAA2B,KAAsB;CAC/D,MAAM,OAAO,iBAAiB,IAAI;AAClC,KAAI,iCAAiC,IAAI,CACvC,QAAO;AAET,QAAO,QAAQ;;AAGjB,SAAS,iBAAiB,KAAsB;AAC9C,KAAI,OAAO,QAAQ,SAAU,QAAO;AACpC,KAAI,eAAe,MAAO,QAAO,IAAI;AACrC,KAAI,OAAO,OAAO,QAAQ,YAAY,iBAAiB,KAAK;EAC1D,MAAM,IAAK,IAAkC;AAC7C,SAAO,OAAO,MAAM,WAAW,IAAI;;AAErC,QAAO,OAAO,IAAI"}

package/dist/extensions/telegram/src/telegram-actions.d.ts

@@ -0,0 +1,25 @@
+import type { Bot } from 'grammy';
+export declare function telegramSetReaction(params: {
+    bot: Bot;
+    chatId: string;
+    messageId: number;
+    emoji: string;
+}): Promise<boolean>;
+export declare function telegramEditMessage(params: {
+    bot: Bot;
+    chatId: string;
+    messageId: number;
+    text: string;
+}): Promise<boolean>;
+export declare function telegramDeleteMessage(params: {
+    bot: Bot;
+    chatId: string;
+    messageId: number;
+}): Promise<boolean>;
+export declare function telegramSendPoll(params: {
+    bot: Bot;
+    chatId: string;
+    question: string;
+    options: string[];
+    threadId?: number;
+}): Promise<number | undefined>;

package/dist/extensions/telegram/src/telegram-actions.js

@@ -0,0 +1,65 @@
+import { createLogger } from "../../../src/utils/logger/index.js";
+import { init_logger } from "../../../src/utils/logger.js";
+//#region extensions/telegram/src/telegram-actions.ts
+init_logger();
+const log = createLogger("TelegramActions");
+async function telegramSetReaction(params) {
+	try {
+		await params.bot.api.setMessageReaction(params.chatId, params.messageId, [{
+			type: "emoji",
+			emoji: params.emoji
+		}]);
+		return true;
+	} catch (err) {
+		log.warn({
+			err,
+			chatId: params.chatId,
+			messageId: params.messageId
+		}, "setMessageReaction failed");
+		return false;
+	}
+}
+async function telegramEditMessage(params) {
+	try {
+		await params.bot.api.editMessageText(params.chatId, params.messageId, params.text);
+		return true;
+	} catch (err) {
+		log.warn({
+			err,
+			chatId: params.chatId,
+			messageId: params.messageId
+		}, "editMessageText failed");
+		return false;
+	}
+}
+async function telegramDeleteMessage(params) {
+	try {
+		await params.bot.api.deleteMessage(params.chatId, params.messageId);
+		return true;
+	} catch (err) {
+		log.warn({
+			err,
+			chatId: params.chatId,
+			messageId: params.messageId
+		}, "deleteMessage failed");
+		return false;
+	}
+}
+async function telegramSendPoll(params) {
+	try {
+		return (await params.bot.api.sendPoll(params.chatId, params.question, params.options, {
+			...params.threadId ? { message_thread_id: params.threadId } : {},
+			is_anonymous: true
+		})).message_id;
+	} catch (err) {
+		log.warn({
+			err,
+			chatId: params.chatId
+		}, "sendPoll failed");
+		return;
+	}
+}
+//#endregion
+export { telegramDeleteMessage, telegramEditMessage, telegramSendPoll, telegramSetReaction };
+
+//# sourceMappingURL=telegram-actions.js.map

package/dist/extensions/telegram/src/telegram-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-actions.js","names":[],"sources":["../../../../extensions/telegram/src/telegram-actions.ts"],"sourcesContent":["import type { Bot } from 'grammy';\nimport { createLogger } from '@xopcai/xopc/utils/logger.js';\n\nconst log = createLogger('TelegramActions');\n\nexport async function telegramSetReaction(params: {\n  bot: Bot;\n  chatId: string;\n  messageId: number;\n  emoji: string;\n}): Promise<boolean> {\n  try {\n    await params.bot.api.setMessageReaction(params.chatId, params.messageId, [\n      { type: 'emoji', emoji: params.emoji as '👍' },\n    ]);\n    return true;\n  } catch (err) {\n    log.warn({ err, chatId: params.chatId, messageId: params.messageId }, 'setMessageReaction failed');\n    return false;\n  }\n}\n\nexport async function telegramEditMessage(params: {\n  bot: Bot;\n  chatId: string;\n  messageId: number;\n  text: string;\n}): Promise<boolean> {\n  try {\n    await params.bot.api.editMessageText(params.chatId, params.messageId, params.text);\n    return true;\n  } catch (err) {\n    log.warn({ err, chatId: params.chatId, messageId: params.messageId }, 'editMessageText failed');\n    return false;\n  }\n}\n\nexport async function telegramDeleteMessage(params: {\n  bot: Bot;\n  chatId: string;\n  messageId: number;\n}): Promise<boolean> {\n  try {\n    await params.bot.api.deleteMessage(params.chatId, params.messageId);\n    return true;\n  } catch (err) {\n    log.warn({ err, chatId: params.chatId, messageId: params.messageId }, 'deleteMessage failed');\n    return false;\n  }\n}\n\nexport async function telegramSendPoll(params: {\n  bot: Bot;\n  chatId: string;\n  question: string;\n  options: string[];\n  threadId?: number;\n}): Promise<number | undefined> {\n  try {\n    const result = await params.bot.api.sendPoll(params.chatId, params.question, params.options, {\n      ...(params.threadId ? { message_thread_id: params.threadId } : {}),\n      is_anonymous: true,\n    });\n    return result.message_id;\n  } catch (err) {\n    log.warn({ err, chatId: params.chatId }, 'sendPoll failed');\n    return undefined;\n  }\n}\n"],"mappings":";;;aAC4D;AAE5D,MAAM,MAAM,aAAa,kBAAkB;AAE3C,eAAsB,oBAAoB,QAKrB;AACnB,KAAI;AACF,QAAM,OAAO,IAAI,IAAI,mBAAmB,OAAO,QAAQ,OAAO,WAAW,CACvE;GAAE,MAAM;GAAS,OAAO,OAAO;GAAe,CAC/C,CAAC;AACF,SAAO;UACA,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK,QAAQ,OAAO;GAAQ,WAAW,OAAO;GAAW,EAAE,4BAA4B;AAClG,SAAO;;;AAIX,eAAsB,oBAAoB,QAKrB;AACnB,KAAI;AACF,QAAM,OAAO,IAAI,IAAI,gBAAgB,OAAO,QAAQ,OAAO,WAAW,OAAO,KAAK;AAClF,SAAO;UACA,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK,QAAQ,OAAO;GAAQ,WAAW,OAAO;GAAW,EAAE,yBAAyB;AAC/F,SAAO;;;AAIX,eAAsB,sBAAsB,QAIvB;AACnB,KAAI;AACF,QAAM,OAAO,IAAI,IAAI,cAAc,OAAO,QAAQ,OAAO,UAAU;AACnE,SAAO;UACA,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK,QAAQ,OAAO;GAAQ,WAAW,OAAO;GAAW,EAAE,uBAAuB;AAC7F,SAAO;;;AAIX,eAAsB,iBAAiB,QAMP;AAC9B,KAAI;AAKF,UAAO,MAJc,OAAO,IAAI,IAAI,SAAS,OAAO,QAAQ,OAAO,UAAU,OAAO,SAAS;GAC3F,GAAI,OAAO,WAAW,EAAE,mBAAmB,OAAO,UAAU,GAAG,EAAE;GACjE,cAAc;GACf,CAAC,EACY;UACP,KAAK;AACZ,MAAI,KAAK;GAAE;GAAK,QAAQ,OAAO;GAAQ,EAAE,kBAAkB;AAC3D"}

package/dist/extensions/telegram/src/thread-bindings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Thread bindings (/focus) — scaffold for OpenClaw parity (Phase 4).
+ * Full implementation requires subagent spawn + session focus routing.
+ */
+export interface TelegramThreadBinding {
+    sessionKey: string;
+    chatId: string;
+    threadId?: string;
+    createdAtMs: number;
+    lastActivityMs: number;
+}
+export declare function setTelegramThreadBinding(binding: TelegramThreadBinding): void;
+export declare function getTelegramThreadBinding(chatId: string, threadId?: string): TelegramThreadBinding | undefined;
+export declare function clearTelegramThreadBinding(chatId: string, threadId?: string): void;
+export declare function sweepIdleTelegramThreadBindings(idleTimeoutMs: number): void;

package/dist/extensions/telegram/src/thread-bindings.js

@@ -0,0 +1,22 @@
+//#region extensions/telegram/src/thread-bindings.ts
+const bindings = /* @__PURE__ */ new Map();
+function bindingKey(chatId, threadId) {
+	return threadId ? `${chatId}:topic:${threadId}` : chatId;
+}
+function setTelegramThreadBinding(binding) {
+	bindings.set(bindingKey(binding.chatId, binding.threadId), binding);
+}
+function getTelegramThreadBinding(chatId, threadId) {
+	return bindings.get(bindingKey(chatId, threadId));
+}
+function clearTelegramThreadBinding(chatId, threadId) {
+	bindings.delete(bindingKey(chatId, threadId));
+}
+function sweepIdleTelegramThreadBindings(idleTimeoutMs) {
+	const now = Date.now();
+	for (const [key, binding] of bindings) if (now - binding.lastActivityMs > idleTimeoutMs) bindings.delete(key);
+}
+//#endregion
+export { clearTelegramThreadBinding, getTelegramThreadBinding, setTelegramThreadBinding, sweepIdleTelegramThreadBindings };
+
+//# sourceMappingURL=thread-bindings.js.map

package/dist/extensions/telegram/src/thread-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-bindings.js","names":[],"sources":["../../../../extensions/telegram/src/thread-bindings.ts"],"sourcesContent":["/**\n * Thread bindings (/focus) — scaffold for OpenClaw parity (Phase 4).\n * Full implementation requires subagent spawn + session focus routing.\n */\n\nexport interface TelegramThreadBinding {\n  sessionKey: string;\n  chatId: string;\n  threadId?: string;\n  createdAtMs: number;\n  lastActivityMs: number;\n}\n\nconst bindings = new Map<string, TelegramThreadBinding>();\n\nfunction bindingKey(chatId: string, threadId?: string): string {\n  return threadId ? `${chatId}:topic:${threadId}` : chatId;\n}\n\nexport function setTelegramThreadBinding(binding: TelegramThreadBinding): void {\n  bindings.set(bindingKey(binding.chatId, binding.threadId), binding);\n}\n\nexport function getTelegramThreadBinding(chatId: string, threadId?: string): TelegramThreadBinding | undefined {\n  return bindings.get(bindingKey(chatId, threadId));\n}\n\nexport function clearTelegramThreadBinding(chatId: string, threadId?: string): void {\n  bindings.delete(bindingKey(chatId, threadId));\n}\n\nexport function sweepIdleTelegramThreadBindings(idleTimeoutMs: number): void {\n  const now = Date.now();\n  for (const [key, binding] of bindings) {\n    if (now - binding.lastActivityMs > idleTimeoutMs) {\n      bindings.delete(key);\n    }\n  }\n}\n"],"mappings":";AAaA,MAAM,2BAAW,IAAI,KAAoC;AAEzD,SAAS,WAAW,QAAgB,UAA2B;AAC7D,QAAO,WAAW,GAAG,OAAO,SAAS,aAAa;;AAGpD,SAAgB,yBAAyB,SAAsC;AAC7E,UAAS,IAAI,WAAW,QAAQ,QAAQ,QAAQ,SAAS,EAAE,QAAQ;;AAGrE,SAAgB,yBAAyB,QAAgB,UAAsD;AAC7G,QAAO,SAAS,IAAI,WAAW,QAAQ,SAAS,CAAC;;AAGnD,SAAgB,2BAA2B,QAAgB,UAAyB;AAClF,UAAS,OAAO,WAAW,QAAQ,SAAS,CAAC;;AAG/C,SAAgB,gCAAgC,eAA6B;CAC3E,MAAM,MAAM,KAAK,KAAK;AACtB,MAAK,MAAM,CAAC,KAAK,YAAY,SAC3B,KAAI,MAAM,QAAQ,iBAAiB,cACjC,UAAS,OAAO,IAAI"}

package/dist/extensions/telegram/src/token-resolver.d.ts

@@ -0,0 +1,8 @@
+/** Resolve bot token from inline value or tokenFile path. */
+export declare function resolveTelegramBotToken(params: {
+    botToken?: string;
+    tokenFile?: string;
+}): {
+    token: string;
+    source: 'inline' | 'file' | 'none';
+};

package/dist/extensions/telegram/src/token-resolver.js

@@ -0,0 +1,34 @@
+import { readFileSync } from "node:fs";
+//#region extensions/telegram/src/token-resolver.ts
+/** Resolve bot token from inline value or tokenFile path. */
+function resolveTelegramBotToken(params) {
+	const inline = params.botToken?.trim() ?? "";
+	if (inline) return {
+		token: inline,
+		source: "inline"
+	};
+	const filePath = params.tokenFile?.trim();
+	if (!filePath) return {
+		token: "",
+		source: "none"
+	};
+	try {
+		const raw = readFileSync(filePath, "utf8").trim();
+		return raw ? {
+			token: raw,
+			source: "file"
+		} : {
+			token: "",
+			source: "none"
+		};
+	} catch {
+		return {
+			token: "",
+			source: "none"
+		};
+	}
+}
+//#endregion
+export { resolveTelegramBotToken };
+
+//# sourceMappingURL=token-resolver.js.map

package/dist/extensions/telegram/src/token-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-resolver.js","names":[],"sources":["../../../../extensions/telegram/src/token-resolver.ts"],"sourcesContent":["import { readFileSync } from 'node:fs';\n\n/** Resolve bot token from inline value or tokenFile path. */\nexport function resolveTelegramBotToken(params: {\n  botToken?: string;\n  tokenFile?: string;\n}): { token: string; source: 'inline' | 'file' | 'none' } {\n  const inline = params.botToken?.trim() ?? '';\n  if (inline) {\n    return { token: inline, source: 'inline' };\n  }\n  const filePath = params.tokenFile?.trim();\n  if (!filePath) {\n    return { token: '', source: 'none' };\n  }\n  try {\n    const raw = readFileSync(filePath, 'utf8').trim();\n    return raw ? { token: raw, source: 'file' } : { token: '', source: 'none' };\n  } catch {\n    return { token: '', source: 'none' };\n  }\n}\n"],"mappings":";;;AAGA,SAAgB,wBAAwB,QAGkB;CACxD,MAAM,SAAS,OAAO,UAAU,MAAM,IAAI;AAC1C,KAAI,OACF,QAAO;EAAE,OAAO;EAAQ,QAAQ;EAAU;CAE5C,MAAM,WAAW,OAAO,WAAW,MAAM;AACzC,KAAI,CAAC,SACH,QAAO;EAAE,OAAO;EAAI,QAAQ;EAAQ;AAEtC,KAAI;EACF,MAAM,MAAM,aAAa,UAAU,OAAO,CAAC,MAAM;AACjD,SAAO,MAAM;GAAE,OAAO;GAAK,QAAQ;GAAQ,GAAG;GAAE,OAAO;GAAI,QAAQ;GAAQ;SACrE;AACN,SAAO;GAAE,OAAO;GAAI,QAAQ;GAAQ"}

package/dist/extensions/telegram/src/update-offset-store.d.ts

@@ -0,0 +1,9 @@
+export declare function readTelegramUpdateOffset(params: {
+    accountId?: string;
+    botToken?: string;
+}): number | undefined;
+export declare function writeTelegramUpdateOffset(params: {
+    accountId?: string;
+    botToken?: string;
+    lastUpdateId: number;
+}): void;

package/dist/extensions/telegram/src/update-offset-store.js

@@ -0,0 +1,66 @@
+import { resolveStateDir } from "../../../src/config/paths-state.js";
+import { init_paths } from "../../../src/config/paths.js";
+import { join } from "node:path";
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+//#region extensions/telegram/src/update-offset-store.ts
+init_paths();
+const STORE_VERSION = 2;
+function normalizeAccountId(accountId) {
+	const trimmed = accountId?.trim();
+	if (!trimmed) return "default";
+	return trimmed.replace(/[^a-z0-9._-]+/gi, "_");
+}
+function resolveOffsetPath(accountId) {
+	const dir = join(resolveStateDir(), "telegram");
+	mkdirSync(dir, { recursive: true });
+	return join(dir, `update-offset-${normalizeAccountId(accountId)}.json`);
+}
+function extractBotIdFromToken(token) {
+	const trimmed = token?.trim();
+	if (!trimmed) return null;
+	const [rawBotId] = trimmed.split(":", 1);
+	if (!rawBotId || !/^\d+$/.test(rawBotId)) return null;
+	return rawBotId;
+}
+function safeParseState(raw) {
+	try {
+		const parsed = JSON.parse(raw);
+		if (parsed?.version !== STORE_VERSION && parsed?.version !== 1) return null;
+		if (parsed.lastUpdateId != null && (!Number.isSafeInteger(parsed.lastUpdateId) || parsed.lastUpdateId < 0)) return null;
+		return {
+			version: STORE_VERSION,
+			lastUpdateId: parsed.lastUpdateId ?? null,
+			botId: parsed.version === STORE_VERSION ? parsed.botId ?? null : null
+		};
+	} catch {
+		return null;
+	}
+}
+function readTelegramUpdateOffset(params) {
+	const path = resolveOffsetPath(params.accountId);
+	try {
+		const state = safeParseState(readFileSync(path, "utf8"));
+		if (!state || state.lastUpdateId == null) return void 0;
+		const botId = extractBotIdFromToken(params.botToken);
+		if (state.botId && botId && state.botId !== botId) return void 0;
+		return state.lastUpdateId;
+	} catch {
+		return;
+	}
+}
+function writeTelegramUpdateOffset(params) {
+	if (!Number.isSafeInteger(params.lastUpdateId) || params.lastUpdateId < 0) return;
+	const path = resolveOffsetPath(params.accountId);
+	const tmp = `${path}.tmp`;
+	const state = {
+		version: STORE_VERSION,
+		lastUpdateId: params.lastUpdateId,
+		botId: extractBotIdFromToken(params.botToken)
+	};
+	writeFileSync(tmp, JSON.stringify(state, null, 2), "utf8");
+	renameSync(tmp, path);
+}
+//#endregion
+export { readTelegramUpdateOffset, writeTelegramUpdateOffset };
+
+//# sourceMappingURL=update-offset-store.js.map

package/dist/extensions/telegram/src/update-offset-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-offset-store.js","names":[],"sources":["../../../../extensions/telegram/src/update-offset-store.ts"],"sourcesContent":["import { mkdirSync, readFileSync, writeFileSync, renameSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { resolveStateDir } from '@xopcai/xopc/config/paths.js';\n\nconst STORE_VERSION = 2;\n\ntype TelegramUpdateOffsetState = {\n  version: number;\n  lastUpdateId: number | null;\n  botId: string | null;\n};\n\nfunction normalizeAccountId(accountId?: string): string {\n  const trimmed = accountId?.trim();\n  if (!trimmed) return 'default';\n  return trimmed.replace(/[^a-z0-9._-]+/gi, '_');\n}\n\nfunction resolveOffsetPath(accountId?: string): string {\n  const stateDir = resolveStateDir();\n  const dir = join(stateDir, 'telegram');\n  mkdirSync(dir, { recursive: true });\n  return join(dir, `update-offset-${normalizeAccountId(accountId)}.json`);\n}\n\nfunction extractBotIdFromToken(token?: string): string | null {\n  const trimmed = token?.trim();\n  if (!trimmed) return null;\n  const [rawBotId] = trimmed.split(':', 1);\n  if (!rawBotId || !/^\\d+$/.test(rawBotId)) return null;\n  return rawBotId;\n}\n\nfunction safeParseState(raw: string): TelegramUpdateOffsetState | null {\n  try {\n    const parsed = JSON.parse(raw) as {\n      version?: number;\n      lastUpdateId?: number | null;\n      botId?: string | null;\n    };\n    if (parsed?.version !== STORE_VERSION && parsed?.version !== 1) return null;\n    if (parsed.lastUpdateId != null && (!Number.isSafeInteger(parsed.lastUpdateId) || parsed.lastUpdateId < 0)) {\n      return null;\n    }\n    return {\n      version: STORE_VERSION,\n      lastUpdateId: parsed.lastUpdateId ?? null,\n      botId: parsed.version === STORE_VERSION ? (parsed.botId ?? null) : null,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport function readTelegramUpdateOffset(params: {\n  accountId?: string;\n  botToken?: string;\n}): number | undefined {\n  const path = resolveOffsetPath(params.accountId);\n  try {\n    const raw = readFileSync(path, 'utf8');\n    const state = safeParseState(raw);\n    if (!state || state.lastUpdateId == null) return undefined;\n    const botId = extractBotIdFromToken(params.botToken);\n    if (state.botId && botId && state.botId !== botId) return undefined;\n    return state.lastUpdateId;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function writeTelegramUpdateOffset(params: {\n  accountId?: string;\n  botToken?: string;\n  lastUpdateId: number;\n}): void {\n  if (!Number.isSafeInteger(params.lastUpdateId) || params.lastUpdateId < 0) return;\n  const path = resolveOffsetPath(params.accountId);\n  const tmp = `${path}.tmp`;\n  const state: TelegramUpdateOffsetState = {\n    version: STORE_VERSION,\n    lastUpdateId: params.lastUpdateId,\n    botId: extractBotIdFromToken(params.botToken),\n  };\n  writeFileSync(tmp, JSON.stringify(state, null, 2), 'utf8');\n  renameSync(tmp, path);\n}\n"],"mappings":";;;;;YAE+D;AAE/D,MAAM,gBAAgB;AAQtB,SAAS,mBAAmB,WAA4B;CACtD,MAAM,UAAU,WAAW,MAAM;AACjC,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,QAAQ,QAAQ,mBAAmB,IAAI;;AAGhD,SAAS,kBAAkB,WAA4B;CAErD,MAAM,MAAM,KADK,iBACQ,EAAE,WAAW;AACtC,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;AACnC,QAAO,KAAK,KAAK,iBAAiB,mBAAmB,UAAU,CAAC,OAAO;;AAGzE,SAAS,sBAAsB,OAA+B;CAC5D,MAAM,UAAU,OAAO,MAAM;AAC7B,KAAI,CAAC,QAAS,QAAO;CACrB,MAAM,CAAC,YAAY,QAAQ,MAAM,KAAK,EAAE;AACxC,KAAI,CAAC,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAE,QAAO;AACjD,QAAO;;AAGT,SAAS,eAAe,KAA+C;AACrE,KAAI;EACF,MAAM,SAAS,KAAK,MAAM,IAAI;AAK9B,MAAI,QAAQ,YAAY,iBAAiB,QAAQ,YAAY,EAAG,QAAO;AACvE,MAAI,OAAO,gBAAgB,SAAS,CAAC,OAAO,cAAc,OAAO,aAAa,IAAI,OAAO,eAAe,GACtG,QAAO;AAET,SAAO;GACL,SAAS;GACT,cAAc,OAAO,gBAAgB;GACrC,OAAO,OAAO,YAAY,gBAAiB,OAAO,SAAS,OAAQ;GACpE;SACK;AACN,SAAO;;;AAIX,SAAgB,yBAAyB,QAGlB;CACrB,MAAM,OAAO,kBAAkB,OAAO,UAAU;AAChD,KAAI;EAEF,MAAM,QAAQ,eADF,aAAa,MAAM,OACC,CAAC;AACjC,MAAI,CAAC,SAAS,MAAM,gBAAgB,KAAM,QAAO,KAAA;EACjD,MAAM,QAAQ,sBAAsB,OAAO,SAAS;AACpD,MAAI,MAAM,SAAS,SAAS,MAAM,UAAU,MAAO,QAAO,KAAA;AAC1D,SAAO,MAAM;SACP;AACN;;;AAIJ,SAAgB,0BAA0B,QAIjC;AACP,KAAI,CAAC,OAAO,cAAc,OAAO,aAAa,IAAI,OAAO,eAAe,EAAG;CAC3E,MAAM,OAAO,kBAAkB,OAAO,UAAU;CAChD,MAAM,MAAM,GAAG,KAAK;CACpB,MAAM,QAAmC;EACvC,SAAS;EACT,cAAc,OAAO;EACrB,OAAO,sBAAsB,OAAO,SAAS;EAC9C;AACD,eAAc,KAAK,KAAK,UAAU,OAAO,MAAM,EAAE,EAAE,OAAO;AAC1D,YAAW,KAAK,KAAK"}

package/dist/extensions/telegram/xopc.extension.json

@@ -2,7 +2,7 @@
   "id": "telegram",
   "name": "Telegram Channel",
   "description": "Bundled Telegram Bot channel (private workspace sources; ships inside @xopcai/xopc dist/)",
-  "version": "0.0.99",
+  "version": "0.0.100",
   "kind": "channel",
   "main": "src/index.ts",
   "channels": ["telegram"],