@segmentstream/agent 0.6.10 → 0.6.12

package/dist/extension/lib/telegram/chat-post-card.mjs

@@ -4,16 +4,24 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { telegramMarkdownLinks, telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 import { escapeMarkdownV2 } from "@chat-adapter/telegram";
 import { AsyncLocalStorage } from "node:async_hooks";
 const MAX_PREVIEW_LENGTH = 3584;
 const exactText = new AsyncLocalStorage();
-function withChatPostCard(text, run) {
+function withChatPostCard(text, run, links = []) {
 	if (text.length > 4096) throw new Error("The complete chat confirmation cannot fit in one Telegram message.");
-	return exactText.run(text, run);
+	return exactText.run({
+		text,
+		links
+	}, run);
 }
 function isExactChatPostCard(text) {
-	return exactText.getStore() === text;
+	return exactText.getStore()?.text === text;
+}
+function chatPostCardLinks(text) {
+	const card = exactText.getStore();
+	return card?.text === text ? card.links : void 0;
 }
 function chatPostCopy(locale) {
 	return locale.startsWith("ru") ? {
@@ -43,6 +51,11 @@ function chatPostCard(preview, locale) {
 	if (text.length > MAX_PREVIEW_LENGTH) throw new Error("The full message and receipt cannot fit in one Telegram confirmation. Make a shorter draft.");
 	return {
 		text,
+		previewLinks: [
+			...telegramTextLinks(`${preview.title}\n${preview.replyTo ?? ""}`),
+			...telegramMarkdownLinks(preview.text),
+			...telegramTextLinks(preview.attribution)
+		],
 		confirm: russian ? "Отправить" : "Confirm",
 		cancel: russian ? "Отмена" : "Cancel",
 		executing: russian ? "Подтверждено." : "Confirmed.",
@@ -65,4 +78,4 @@ function chatPostReceipt(output, locale) {
 		...value.history_recorded ? [] : [copy.history]
 	].join("\n");
 }
-export { chatPostCard, chatPostCardStatus, chatPostCopy, chatPostReceipt, isExactChatPostCard, withChatPostCard };
+export { chatPostCard, chatPostCardLinks, chatPostCardStatus, chatPostCopy, chatPostReceipt, isExactChatPostCard, withChatPostCard };

package/dist/extension/lib/telegram/confirmation-text.d.ts

@@ -1,6 +1,7 @@
 import type { SessionAuthContext } from "eve/context";
 import { type ConfirmationDescription } from "../confirmation-description.js";
 export interface ConfirmationText {
+    readonly previewLinks?: readonly string[];
     readonly text: string;
     readonly confirm: string;
     readonly cancel: string;

package/dist/extension/lib/telegram/confirmations.mjs

@@ -9,11 +9,11 @@ import { chatPostOperationId, isChatPost } from "../chat-post-confirmation.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostCopy, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
 import { confirmations } from "../confirmations.mjs";
 import { conversationEvent } from "../conversations.mjs";
-import { currentInboundRequest } from "./inbound-request.mjs";
-import { currentLocale, failureText, reportTelegramError } from "./customer-text.mjs";
+import { d as failureText, m as reportTelegramError, n as currentInboundRequest, o as currentLocale } from "../../../_chunks/inbound-request-DgyI7oR9.mjs";
 import { answerMarker, isPendingQuestion, pendingQuestions, questionKey } from "../questions.mjs";
 import { confirmationCopy, confirmationLocale, fallbackConfirmation } from "./confirmation-text.mjs";
 import { formatAddress, scopedAddress } from "./sessions.mjs";
+import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 import { registerTelegramFreeformPrompt, renderTelegramInputRequest } from "eve/channels/telegram";
 import { createHash } from "node:crypto";
 const PREFIX = "ss-confirm:";
@@ -265,7 +265,7 @@ function telegramConfirmationEvents(render = async (description, locale) => fall
 						}
 					]] }
 				});
-				const sent = await (exactPost ? withChatPostCard(text, send) : send());
+				const sent = await (exactPost ? withChatPostCard(text, send, copy.previewLinks) : send());
 				const state = channel.state;
 				state.confirmationMessages = {
 					...state.confirmationMessages,
@@ -275,7 +275,8 @@ function telegramConfirmationEvents(render = async (description, locale) => fall
 						text,
 						copy,
 						locale: confirmationLocale(ctx.session.auth.current),
-						exactPost
+						exactPost,
+						previewLinks: copy.previewLinks
 					}
 				};
 			}
@@ -308,7 +309,7 @@ function telegramConfirmationEvents(render = async (description, locale) => fall
 					replyMarkup: { inline_keyboard: [] },
 					text
 				});
-				await (message.exactPost ? withChatPostCard(text, edit) : edit());
+				await (message.exactPost ? withChatPostCard(text, edit, [...message.previewLinks ?? [], ...telegramTextLinks(status)]) : edit());
 				await record(callId, reason ?? resolution.outcome, text, resolution.outcome === "approved" ? "completed" : "cancelled", ctx);
 				const question = chatPostEditQuestion(resolution);
 				if (message.exactPost && reason === "edit" && question !== void 0) {
@@ -395,7 +396,7 @@ function telegramConfirmationEvents(render = async (description, locale) => fall
 					messageId: message.messageId,
 					replyMarkup: { inline_keyboard: [] },
 					text
-				}));
+				}), [...message.previewLinks ?? [], ...telegramTextLinks(status)]);
 				await record(data.result.callId, "receipt", text, failed ? "failed" : object(data.result.kind === "tool-result" ? data.result.output : void 0).status === "sent" ? "completed" : "unknown", ctx);
 			} else if (failed) {
 				const errorId = reportTelegramError("confirmed_action_failed", data, { callId: data.result.callId });

package/dist/extension/lib/telegram/content.d.ts

@@ -17,7 +17,7 @@ export declare function telegramRecord(value: unknown): Readonly<Record<string,
 export declare function messageContent(raw: Readonly<Record<string, unknown>>): MessageContent;
 /** Only shape/size diagnostics: do not retain/log raw webhook bodies, URLs or credential values. */
 export declare function contentShape(raw: Readonly<Record<string, unknown>>, content?: MessageContent): {
-    contentSource: "text" | "caption" | "rich_message" | "none";
+    contentSource: "none" | "text" | "caption" | "rich_message";
     textType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
     captionType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
     hasRichMessage: boolean;

package/dist/extension/lib/telegram/conversations.d.ts

@@ -10,7 +10,7 @@ export declare function captureTelegramWebhook(input: {
     readonly identities: AgentIdentities;
     readonly observed: ObservedMessages;
     readonly chats?: AgentChats;
-    readonly next: () => Promise<Response>;
+    readonly next: (request?: Request) => Promise<Response>;
 }): Promise<Response>;
 /** Additive inbound hook: the router keeps ownership of the reply policy. */
 export declare function recordGateDecision(reason: string, decision?: "reply" | "silent"): void;
@@ -27,4 +27,4 @@ export declare function telegramConversationCapture(input: {
     readonly observed: ObservedMessages;
     readonly chats: AgentChats;
     readonly verify: (request: Request) => boolean;
-}): (request: Request, next: () => Promise<Response>) => Promise<Response>;
+}): (request: Request, next: (request?: Request) => Promise<Response>) => Promise<Response>;

package/dist/extension/lib/telegram/conversations.mjs

@@ -6,12 +6,11 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { collapseConversationEvents, conversationEvent } from "../conversations.mjs";
 import { observedChatKey } from "./observed.mjs";
-import { currentInboundRequest } from "./inbound-request.mjs";
+import { n as currentInboundRequest, s as currentThreadId } from "../../../_chunks/inbound-request-DgyI7oR9.mjs";
 import { reportMembership } from "./membership.mjs";
-import { currentThreadId } from "./customer-text.mjs";
 import { contentShape, messageContent } from "./content.mjs";
 import { parseTelegramUpdate } from "eve/channels/telegram";
-import { randomUUID } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 const captures = new WeakMap();
 const record = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
 const id = (value) => typeof value === "number" || typeof value === "string" ? String(value) : null;
@@ -124,21 +123,37 @@ async function captureTelegramWebhook(input) {
 		chatId: message.chat.id,
 		...message.messageThreadId === void 0 ? {} : { messageThreadId: message.messageThreadId }
 	});
-	if (!(message.from === void 0 || message.from.isBot || message.chat.type === "channel") && edited === void 0) {
-		const history = await input.archive.context({
-			provider: "telegram",
-			chatId: message.chat.id,
-			...event.threadId === null ? {} : { threadId: event.threadId },
-			limit: 100
-		});
-		for (const earlier of (input.observed.recent(chat).length === 0 ? collapseConversationEvents(history.events) : []).filter((item) => item.kind === "inbound" && item.eventId !== event.eventId).slice(0, 30).reverse()) input.observed.add(chat, {
-			author: earlier.senderName ?? earlier.senderId ?? "automated post",
-			text: earlier.text ?? "[attachment or service message]",
-			at: earlier.at,
-			...earlier.messageId === null ? {} : { messageId: earlier.messageId },
-			...earlier.senderId === null ? {} : { authorId: earlier.senderId }
-		});
-	} else {
+	const automated = message.from === void 0 || message.from.isBot || message.chat.type === "channel";
+	const history = automated ? void 0 : await input.archive.context({
+		provider: "telegram",
+		chatId: message.chat.id,
+		...event.threadId === null ? {} : { threadId: event.threadId },
+		limit: 100,
+		includeDecisions: true,
+		...lookup?.status === "paired" ? { participantId: lookup.member.id } : {}
+	});
+	const routing = automated ? [] : (await input.archive.context({
+		provider: "telegram",
+		chatId: message.chat.id,
+		messageId: message.messageId,
+		includeDecisions: true,
+		limit: 100,
+		...lookup?.status === "paired" ? { participantId: lookup.member.id } : {}
+	})).events.filter((earlier) => earlier.kind === "decision" && earlier.senderId === event.senderId);
+	const previousClaim = routing.find((earlier) => earlier.reason === "turn_claimed");
+	const admitted = routing.some((earlier) => earlier.reason === "turn_admitted");
+	const released = previousClaim !== void 0 && routing.some((earlier) => earlier.eventId === `${previousClaim.eventId}:released`);
+	const dispatched = routing.some((earlier) => earlier.reason === "turn_dispatch_started");
+	const reserved = previousClaim !== void 0 && !released && Date.now() - Date.parse(previousClaim.at) < 6e5;
+	const alreadyHandled = admitted || dispatched || reserved;
+	if (!automated && edited === void 0 && !alreadyHandled) for (const earlier of (input.observed.recent(chat).length === 0 ? collapseConversationEvents(history?.events ?? []) : []).filter((item) => item.kind === "inbound" && item.eventId !== event.eventId && !history?.events.some((decision) => decision.kind === "decision" && decision.messageId === item.messageId && decision.reason === "turn_admitted")).slice(0, 30).reverse()) input.observed.add(chat, {
+		author: earlier.senderName ?? earlier.senderId ?? "automated post",
+		text: earlier.text ?? "[attachment or service message]",
+		at: earlier.at,
+		...earlier.messageId === null ? {} : { messageId: earlier.messageId },
+		...earlier.senderId === null ? {} : { authorId: earlier.senderId }
+	});
+	else if (automated || edited !== void 0) {
 		if (message.chat.type === "group" || message.chat.type === "supergroup") await input.chats?.seen({
 			chatId: message.chat.id,
 			title: message.chat.title ?? ""
@@ -150,13 +165,64 @@ async function captureTelegramWebhook(input) {
 			messageId: message.messageId
 		});
 		capture.decision = "silent";
-		capture.reason = edited !== void 0 ? "message_edit" : "automated_or_channel_message";
+		capture.reason = automated ? "automated_or_channel_message" : alreadyHandled ? "message_already_handled" : "message_edit";
+		if (alreadyHandled) capture.note = "This message already started a turn; edits and retries do not repeat its task.";
+	}
+	if (alreadyHandled) {
+		capture.decision = "silent";
+		capture.reason = "message_already_handled";
+	}
+	if (inbound !== void 0) {
+		inbound.edited = edited !== void 0;
+		const nextClaim = previousClaim === void 0 ? void 0 : createHash("sha256").update(previousClaim.eventId).digest("hex");
+		const claimId = previousClaim === void 0 ? `telegram:${message.chat.id}:${message.messageId}:turn` : `telegram:${message.chat.id}:${message.messageId}:turn:${nextClaim}`;
+		let claimed = false;
+		let accepted = false;
+		let dispatchStarted = false;
+		const claimEvent = (reason, status, suffix = "") => ({
+			...event,
+			eventId: `${claimId}${suffix}`,
+			kind: "decision",
+			decision: "reply",
+			reason,
+			status,
+			at: new Date().toISOString(),
+			text: null,
+			attachments: []
+		});
+		inbound.claimTurn = async () => {
+			if (alreadyHandled) return false;
+			claimed = await input.archive.append(claimEvent("turn_claimed", "requested")) !== false;
+			return claimed;
+		};
+		inbound.beginDispatch = async () => {
+			dispatchStarted = await input.archive.append({
+				...claimEvent("turn_dispatch_started", "requested"),
+				eventId: `telegram:${message.chat.id}:${message.messageId}:dispatch`
+			}) === true;
+			return dispatchStarted;
+		};
+		inbound.finishClaim = async (delivered) => {
+			if ((accepted || dispatchStarted) && !delivered) return;
+			accepted ||= delivered;
+			if (claimed) {
+				await input.archive.append(claimEvent(delivered ? "turn_admitted" : "turn_released", delivered ? "completed" : "failed", delivered ? ":admitted" : ":released"));
+				claimed = false;
+			}
+		};
 	}
 	let response;
 	try {
-		response = await input.next();
+		const routeEdit = edited !== void 0 && !automated && !alreadyHandled;
+		if (routeEdit) capture.reason = void 0;
+		response = await input.next(routeEdit ? new Request(input.request, { body: JSON.stringify({
+			...update,
+			edited_message: void 0,
+			message: messagePayload
+		}) }) : alreadyHandled ? new Request(input.request, { body: JSON.stringify({ update_id: update.update_id }) }) : void 0);
 	} catch (error) {
 		try {
+			await inbound?.finishClaim?.(false);
 			await input.archive.append({
 				...event,
 				eventId: `${event.eventId}:decision`,
@@ -174,6 +240,7 @@ async function captureTelegramWebhook(input) {
 		}
 		throw error;
 	}
+	await inbound?.finishClaim?.(false);
 	await input.archive.append({
 		...event,
 		eventId: `${event.eventId}:decision`,
@@ -192,6 +259,7 @@ function recordGateDecision(reason, decision = "silent") {
 	if (capture !== void 0) {
 		capture.reason = reason;
 		capture.decision = decision;
+		capture.note = void 0;
 	}
 }
 function recordRouteDecision(route, addressed, policy, audit) {
@@ -295,15 +363,31 @@ function conversationIdentities(identities) {
 	};
 }
 function telegramConversationCapture(input) {
+	const processing = new Map();
 	return async (request, next) => {
 		if (!input.verify(request)) return next();
 		try {
-			return await captureTelegramWebhook({
-				...input,
-				request,
-				identities: input.identities(),
-				next
-			});
+			const update = record(await request.clone().json().catch(() => null));
+			const payload = record(update.edited_message ?? update.message);
+			const chatId = id(record(payload.chat).id);
+			const messageId = id(payload.message_id);
+			const key = chatId === null || messageId === null ? void 0 : `${chatId}:${messageId}`;
+			const previous = key === void 0 ? void 0 : processing.get(key);
+			const task = (async () => {
+				await previous?.catch(() => void 0);
+				return captureTelegramWebhook({
+					...input,
+					request,
+					identities: input.identities(),
+					next
+				});
+			})();
+			if (key !== void 0) processing.set(key, task);
+			try {
+				return await task;
+			} finally {
+				if (key !== void 0 && processing.get(key) === task) processing.delete(key);
+			}
 		} catch (error) {
 			console.error("[segmentstream] conversation capture failed", { error });
 			return new Response("conversation storage unavailable", { status: 503 });

package/dist/extension/lib/telegram/customer-text.d.ts

@@ -1,3 +1,4 @@
+import { type TelegramPreviewContext } from "@segmentstream-cloud/ontology/telegram";
 import { type TelegramText } from "./format.js";
 export declare function withDeliveryLocale<T>(locale: string, run: () => T, threadId?: string): T;
 export declare function currentLocale(): string;
@@ -15,7 +16,7 @@ export declare function customerCopy(locale?: string): {
 export declare function isTechnicalText(text: string): boolean;
 /** Original failures stay in operator diagnostics, joined to the public notice by a short reference. */
 export declare function reportTelegramError(operation: string, error: unknown, metadata?: Record<string, unknown>, secrets?: ReadonlySet<string>): string;
-export declare function failureText(errorId: string, kind?: "failed" | "recovery" | "attachment" | "authorization" | "response", locale?: string): string;
+export declare function failureText(errorId: string, kind?: "failed" | "cancelled" | "recovery" | "attachment" | "authorization" | "response", locale?: string): string;
 export declare function customerText(text: string, locale?: string): string;
 /** Check what Telegram will display, including hidden link destinations, after removing markup. */
 export declare function customerMessage(text: string, locale?: string): TelegramText;
@@ -29,4 +30,4 @@ export declare class TelegramDeliveryError extends Error {
     constructor(reference: string, delivery: "failed" | "unknown", messageIds: readonly number[]);
 }
 /** Covers framework defaults, edits and callback notices as well as ordinary agent replies. */
-export declare function safeTelegramFetch(fetchImpl: typeof fetch, scope?: string): typeof fetch;
+export declare function safeTelegramFetch(fetchImpl: typeof fetch, scope?: string, previews?: TelegramPreviewContext): typeof fetch;

package/dist/extension/lib/telegram/customer-text.mjs

@@ -4,221 +4,5 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { isExactChatPostCard } from "./chat-post-card.mjs";
-import { redactDiagnostic } from "../diagnostics.mjs";
-import { currentInboundRequest } from "./inbound-request.mjs";
-import { plainTelegramText, splitTelegramText, telegramMarkdown } from "./format.mjs";
-import { inTelegramSendQueue } from "./send-queue.mjs";
-import { randomBytes } from "node:crypto";
-import { AsyncLocalStorage } from "node:async_hooks";
-const deliveryLocale = new AsyncLocalStorage();
-function withDeliveryLocale(locale, run, threadId) {
-	return deliveryLocale.run({
-		locale,
-		threadId
-	}, run);
-}
-function currentLocale() {
-	return deliveryLocale.getStore()?.locale ?? currentInboundRequest()?.locale ?? "en";
-}
-function currentThreadId() {
-	return deliveryLocale.getStore()?.threadId ?? currentInboundRequest()?.threadId;
-}
-function customerCopy(locale = currentLocale()) {
-	return locale.toLowerCase().split(/[-_]/)[0] === "ru" ? {
-		failed: "Не удалось выполнить запрос. Попробуйте ещё раз.",
-		recovery: "Не удалось продолжить разговор. Отправьте новое сообщение.",
-		attachment: "Не удалось обработать файл. Попробуйте ещё раз.",
-		authorization: "Не удалось подключиться. Попробуйте ещё раз.",
-		response: "Не удалось показать ответ. Попробуйте ещё раз.",
-		reference: "Код ошибки",
-		connected: "Доступ подключён.",
-		disconnected: "Подключение отменено."
-	} : {
-		failed: "I couldn't complete the request. Please try again.",
-		recovery: "I couldn't continue the conversation. Please send a new message.",
-		attachment: "I couldn't process the file. Please try again.",
-		authorization: "I couldn't connect. Please try again.",
-		response: "I couldn't display the response. Please try again.",
-		reference: "Error reference",
-		connected: "Access connected.",
-		disconnected: "Connection cancelled."
-	};
-}
-const TECHNICAL_PATTERNS = [
-	/[{}]|```/u,
-	/\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/iu,
-	/\b[0-9a-hjkmnp-tv-z]{26}\b/iu,
-	/\b\w+__\w+/u,
-	/\b(?:Serialization|Type|Reference|Syntax|Tool|Provider|API|Workflow|InternalServer)Error\b/u,
-	/\bError:\s|(?:^|\n)\s*at\s+\S+|\b(?:stack trace|traceback|SQLSTATE|node_modules)\b/imu,
-	/\b(?:duplicate key|ECONN\w+|HTTP [45]\d\d)\b/iu,
-	/\[\s*(?:"[^"]*"|\d+|true|false|null)\s*[,\]]/u
-];
-function isTechnicalText(text) {
-	if (/https?:\/\/[^\s/@]+:[^\s/@]+@|[?&](?:token|access_token|api_key|secret|password)=/iu.test(text)) return true;
-	const visible = text.replace(/https?:\/\/[^\s)<>]+/giu, "link");
-	const prose = visible.replace(/(?<![\w@])@[a-z][a-z0-9_]{4,31}(?!\w)/giu, "recipient");
-	return TECHNICAL_PATTERNS.some((pattern) => pattern.test(visible)) || /\b[a-z][a-z0-9]*_[a-z][a-z0-9_]*\b(?!\.[a-z0-9])/iu.test(prose);
-}
-function redactCredentials(value) {
-	if (typeof value === "string") return value.replace(/\bBearer [A-Za-z0-9_.~+/-]+=*/giu, "Bearer [redacted]").replace(/(https?:\/\/)[^/@\s]+:[^/@\s]+@/gu, "$1[redacted]@").replace(/([?&](?:token|access_token|api_key|secret|password)=)[^&#\s]*/giu, "$1[redacted]").replace(/("(?:token|api_key|password|secret)"\s*:\s*)"(?:\\.|[^"\\])*"/giu, "$1\"[redacted]\"");
-	if (Array.isArray(value)) return value.map(redactCredentials);
-	if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, /^(?:token|password|secret|authorization|cookie|api_?key|access_?token|refresh_?token)$/iu.test(key) && typeof item === "string" ? "[redacted]" : redactCredentials(item)]));
-	return value;
-}
-function reportTelegramError(operation, error, metadata = {}, secrets = new Set()) {
-	const errorId = randomBytes(4).toString("hex").toUpperCase();
-	const credentials = new Set([...secrets, ...[process.env.AI_GATEWAY_API_KEY, process.env.VERCEL_OIDC_TOKEN].filter((value) => value !== void 0)]);
-	console.error("[segmentstream] Telegram delivery diagnostic", {
-		...metadata,
-		errorId,
-		operation,
-		error: redactCredentials(redactDiagnostic(error, credentials))
-	});
-	return errorId;
-}
-function failureText(errorId, kind = "failed", locale = currentLocale()) {
-	const copy = customerCopy(locale);
-	return `${copy[kind]} ${copy.reference}: ${errorId}.`;
-}
-function customerText(text, locale = currentLocale()) {
-	if (!isTechnicalText(text)) return text;
-	return failureText(reportTelegramError("technical_text_blocked", { text }), "response", locale);
-}
-function customerMessage(text, locale = currentLocale()) {
-	let message;
-	try {
-		message = telegramMarkdown(text);
-	} catch (error) {
-		reportTelegramError("markdown_render_failed", error);
-		message = {
-			text: plainTelegramText(text),
-			entities: []
-		};
-	}
-	const links = message.entities.flatMap((entity) => entity.url === void 0 ? [] : [entity.url]);
-	const visible = customerText(message.text, locale);
-	if (visible !== message.text) return {
-		text: visible,
-		entities: []
-	};
-	if (links.some(isTechnicalText)) return {
-		text: failureText(reportTelegramError("unsafe_markdown_link", new Error("Credential-bearing link refused.")), "response", locale),
-		entities: []
-	};
-	return message;
-}
-async function formattingRefused(response) {
-	if (response.status !== 400) return false;
-	const body = await response.clone().json().catch(() => null);
-	return body?.ok === false && typeof body.description === "string" && (/can't parse entities|cannot parse entities|entity (?:bounds|offset|length)|entities (?:are|too)/iu.test(body.description) || /unsupported (?:start tag|parse mode)/iu.test(body.description));
-}
-var TelegramDeliveryError = class extends Error {
-	reference;
-	delivery;
-	messageIds;
-	name = "TelegramDeliveryError";
-	constructor(reference, delivery, messageIds) {
-		super(`Telegram delivery ${delivery}; reference ${reference}. Do not automatically resend.`);
-		this.reference = reference;
-		this.delivery = delivery;
-		this.messageIds = messageIds;
-	}
-};
-function safeTelegramFetch(fetchImpl, scope = "telegram") {
-	const methods = new Set([
-		"sendMessage",
-		"editMessageText",
-		"editMessageCaption",
-		"answerCallbackQuery",
-		"sendPhoto",
-		"sendDocument",
-		"sendMediaGroup"
-	]);
-	return async (input, init) => {
-		const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
-		if (!methods.has(url.split("/").at(-1) ?? "") || typeof init?.body !== "string") return fetchImpl(input, init);
-		const body = JSON.parse(init.body);
-		for (const field of ["text", "caption"]) {
-			if (typeof body[field] === "string" && isExactChatPostCard(body[field])) body.parse_mode = "MarkdownV2";
-			if (typeof body[field] === "string" && !isExactChatPostCard(body[field])) {
-				const entityField = field === "text" ? "entities" : "caption_entities";
-				const existing = body[entityField];
-				const message = Array.isArray(existing) ? {
-					text: body[field],
-					entities: existing
-				} : customerMessage(body[field]);
-				const guarded = customerText(message.text);
-				body[field] = message.entities.some((entity) => typeof entity.url === "string" && isTechnicalText(entity.url)) ? failureText(reportTelegramError("unsafe_entity_link", new Error("Credential-bearing link refused.")), "response") : guarded;
-				if (!url.endsWith("/answerCallbackQuery")) body[entityField] = body[field] === message.text ? message.entities : [];
-				delete body.parse_mode;
-			}
-		}
-		if (Array.isArray(body.media)) body.media = body.media.map((item) => ({
-			...item,
-			...typeof item.caption === "string" ? { caption: customerText(item.caption) } : {}
-		}));
-		const markup = body.reply_markup;
-		if (Array.isArray(markup?.inline_keyboard)) markup.inline_keyboard = markup.inline_keyboard.map((row) => row.map((button) => {
-			if (typeof button.text !== "string" || !isTechnicalText(button.text)) return button;
-			reportTelegramError("technical_button_label_blocked", { text: button.text });
-			return {
-				...button,
-				text: currentLocale().startsWith("ru") ? "Продолжить" : "Continue"
-			};
-		}));
-		const send = async () => {
-			const parts = url.endsWith("/sendMessage") && typeof body.text === "string" && !isExactChatPostCard(body.text) ? splitTelegramText({
-				text: body.text,
-				entities: body.entities ?? []
-			}) : [null];
-			let first;
-			const messageIds = [];
-			const attempt = async (outgoing) => {
-				try {
-					return await fetchImpl(input, {
-						...init,
-						body: JSON.stringify(outgoing)
-					});
-				} catch (error) {
-					throw new TelegramDeliveryError(reportTelegramError("telegram_send_unknown", error, { messageIds }), "unknown", messageIds);
-				}
-			};
-			for (const [index, part] of parts.entries()) {
-				const outgoing = part === null ? { ...body } : {
-					...body,
-					text: part.text,
-					entities: part.entities
-				};
-				if (index < parts.length - 1) delete outgoing.reply_markup;
-				let response = await attempt(outgoing);
-				const entityField = typeof outgoing.text === "string" ? "entities" : "caption_entities";
-				if (Array.isArray(outgoing[entityField]) && outgoing[entityField].length > 0 && await formattingRefused(response)) {
-					delete outgoing[entityField];
-					delete outgoing.parse_mode;
-					response = await attempt(outgoing);
-				}
-				const result = await response.clone().json().catch(() => null);
-				if (url.endsWith("/sendMessage")) {
-					const id = result?.result?.message_id;
-					if (!response.ok || result?.ok !== true || typeof id !== "number" || !Number.isSafeInteger(id) || id < 1) {
-						const delivery = result?.ok === false ? "failed" : "unknown";
-						throw new TelegramDeliveryError(reportTelegramError("telegram_send_unacknowledged", {
-							status: response.status,
-							result,
-							messageIds,
-							delivery
-						}), delivery, messageIds);
-					}
-					messageIds.push(id);
-				} else if (!response.ok || result?.ok !== true) return response;
-				first ??= response;
-			}
-			if (first === void 0) throw new Error("Telegram message has no visible text; nothing was sent.");
-			return first;
-		};
-		return typeof body.chat_id === "string" || typeof body.chat_id === "number" ? inTelegramSendQueue(scope, String(body.chat_id), send) : send();
-	};
-}
+import { a as TelegramDeliveryError, c as customerCopy, d as failureText, f as formattingRefused, g as withDeliveryLocale, h as safeTelegramFetch, l as customerMessage, m as reportTelegramError, o as currentLocale, p as isTechnicalText, s as currentThreadId, u as customerText } from "../../../_chunks/inbound-request-DgyI7oR9.mjs";
 export { TelegramDeliveryError, currentLocale, currentThreadId, customerCopy, customerMessage, customerText, failureText, formattingRefused, isTechnicalText, reportTelegramError, safeTelegramFetch, withDeliveryLocale };

package/dist/extension/lib/telegram/files.mjs

@@ -6,7 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { conversationLanguage } from "./principal.mjs";
 import { MAXIMUM_ATTACHMENT_BYTES, attachmentUrl } from "../attachments.mjs";
-import { failureText, reportTelegramError } from "./customer-text.mjs";
+import { d as failureText, m as reportTelegramError } from "../../../_chunks/inbound-request-DgyI7oR9.mjs";
 import { describableImage, describeReceivedImage } from "./images.mjs";
 function telegramConversation(chatId) {
 	return `telegram:${chatId}`;

package/dist/extension/lib/telegram/images.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { reportTelegramError } from "./customer-text.mjs";
+import { m as reportTelegramError } from "../../../_chunks/inbound-request-DgyI7oR9.mjs";
 import { gateway, generateText } from "ai";
 const MAXIMUM_IMAGE_DESCRIPTION_BYTES = 5242880;
 const MAXIMUM_NATIVE_IMAGE_BYTES = 3145728;

package/dist/extension/lib/telegram/inbound-request.d.ts

@@ -25,6 +25,13 @@ export type StagedFile = {
 export declare class InboundRequest {
     /** The agent's description from the compiled manifest, for the routing decision. */
     readonly agentDescription: () => Promise<string>;
+    edited: boolean;
+    deliveryFailed: ((error: unknown) => Promise<void>) | undefined;
+    /** Atomic per-message admission in the platform archive, after authentication and routing. */
+    claimTurn: (() => Promise<boolean>) | undefined;
+    /** Finalize the reservation only after the durable inbox acknowledges delivery. */
+    beginDispatch: (() => Promise<boolean>) | undefined;
+    finishClaim: ((accepted: boolean) => Promise<void>) | undefined;
     locale: string | undefined;
     threadId: string | undefined;
     /** The text the turn should carry instead of the parsed message, once a transcript exists. */