@segmentstream/agent 0.12.2 → 0.14.0

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

@@ -4,11 +4,12 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { telegramText } from "./texts.mjs";
 import { renderConfirmation } from "./confirmation-text.mjs";
-import { telegramMarkdownLinks, telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 import { AsyncLocalStorage } from "node:async_hooks";
+import { telegramMarkdownLinks, telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 import { escapeMarkdownV2 } from "@chat-adapter/telegram";
-const MAX_PREVIEW_LENGTH = 3584;
+const RECEIPT_DATA_SPACE = 512;
 const exactText = new AsyncLocalStorage();
 function withChatPostCard(text, run, links = []) {
 	if (text.length > 4096) throw new Error("The complete chat confirmation cannot fit in one Telegram message.");
@@ -30,31 +31,33 @@ function chatPostCard(description, copy) {
 	const base = renderConfirmation(description, copy);
 	const text = [
 		base.text,
-		`→ ${preview.title} (${preview.provider})`,
-		...preview.replyTo === null ? [] : [`↩️ ${preview.replyTo}`]
+		`${preview.title} (${preview.provider})`,
+		...preview.replyTo === null ? [] : [preview.replyTo]
 	].map(escapeMarkdownV2).join("\n") + `\n\n${preview.finalText}`;
-	if (text.length > MAX_PREVIEW_LENGTH) throw new Error("The full message and receipt cannot fit in one Telegram confirmation. Make a shorter draft.");
+	const receiptSpace = RECEIPT_DATA_SPACE + Math.max(...["sent", "uncertain"].map((status) => escapeMarkdownV2(telegramText("chatPost", status) ?? "").length)) + escapeMarkdownV2(telegramText("chatPost", "historyNotRecorded") ?? "").length;
+	if (text.length > 4096 - receiptSpace) throw new Error("The full message and receipt cannot fit in one Telegram confirmation. Make a shorter draft.");
 	return {
 		...base,
 		text,
 		previewLinks: [
 			...telegramTextLinks(`${preview.title}\n${preview.replyTo ?? ""}`),
 			...telegramMarkdownLinks(preview.text),
+			...telegramTextLinks(preview.attributionSeparator ?? "\n\n"),
 			...telegramTextLinks(preview.attribution)
 		]
 	};
 }
 function chatPostCardStatus(text, status) {
-	return `${text}\n\n${escapeMarkdownV2(status)}`;
+	return status === "" ? text : `${text}\n\n${escapeMarkdownV2(status)}`;
 }
-function chatPostReceipt(output, completed = "✅") {
+function chatPostReceipt(output) {
 	const value = typeof output === "object" && output !== null ? output : {};
 	if (value.status !== "sent" && value.status !== "uncertain" || typeof value.history_recorded !== "boolean" || typeof value.duplicate !== "boolean" || value.message_id !== null && typeof value.message_id !== "string" || value.url !== null && typeof value.url !== "string") return;
 	const url = typeof value.url === "string" && value.url.length <= 256 && /^https:\/\/t\.me\/[A-Za-z0-9_/-]+$/u.test(value.url) ? value.url : null;
 	return [
-		value.status === "sent" ? completed : "⚠️ ❓",
+		telegramText("chatPost", value.status === "sent" ? "sent" : "uncertain"),
 		...url === null ? [] : [url],
-		...value.history_recorded ? [] : ["⚠️"]
-	].join("\n");
+		...value.history_recorded ? [] : [telegramText("chatPost", "historyNotRecorded")]
+	].filter((line) => line !== void 0).join("\n");
 }
 export { chatPostCard, chatPostCardLinks, chatPostCardStatus, chatPostReceipt, isExactChatPostCard, withChatPostCard };

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

@@ -1,4 +1,5 @@
 import type { TelegramSettings } from "../../config.js";
 import { type DeferredConfirmation, type DeferredOptions } from "../deferred-confirmations.js";
+import { type TelegramTexts } from "./texts.js";
 /** A bounded sweep; concurrent webhooks/schedules compete for the same atomic expiry claim. */
-export declare function expireScheduledConfirmations(connection: string, notify: (record: DeferredConfirmation, result: Readonly<Record<string, unknown>>) => Promise<unknown>, options?: DeferredOptions, settings?: TelegramSettings): Promise<void>;
+export declare function expireScheduledConfirmations(connection: string, notify: (record: DeferredConfirmation, result: Readonly<Record<string, unknown>>) => Promise<unknown>, options?: DeferredOptions, settings?: TelegramSettings, texts?: TelegramTexts): Promise<void>;

package/dist/extension/lib/telegram/confirmation-expiry.mjs

@@ -4,18 +4,19 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { withTelegramTexts } from "./texts.mjs";
 import { proxyEnvironment } from "../environment.mjs";
+import { telegramSendScope } from "./send-queue.mjs";
+import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
-import { telegramSendScope } from "./send-queue.mjs";
-import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
 import { deferredConfirmations } from "../deferred-confirmations.mjs";
 import { expireDeferredRecord } from "./deferred-confirmations.mjs";
 import { connectionProxy } from "../connection-proxy.mjs";
 import { TELEGRAM_PLACEHOLDER_TOKEN, TELEGRAM_PROXY_ORIGIN, telegramProxyFetch } from "./proxy-fetch.mjs";
 import { telegramPreviewEnvironment } from "@segmentstream-cloud/ontology/telegram";
 import { editTelegramMessageText } from "eve/channels/telegram";
-async function expireScheduledConfirmations(connection, notify, options = {}, settings) {
+async function expireScheduledConfirmations(connection, notify, options = {}, settings, texts = {}) {
 	const environment = options.environment ?? process.env;
 	const token = options.token ?? runtimeToken;
 	const archive = conversations({
@@ -36,13 +37,13 @@ async function expireScheduledConfirmations(connection, notify, options = {}, se
 	});
 	const records = await deferredConfirmations(options).command({ operation: "expired" });
 	for (const record of records) try {
-		await expireDeferredRecord(record, { telegram: { editMessageText: (input) => editTelegramMessageText({
+		await withTelegramTexts(texts, () => expireDeferredRecord(record, { telegram: { editMessageText: (input) => editTelegramMessageText({
 			apiBaseUrl: TELEGRAM_PROXY_ORIGIN,
 			credentials: { botToken: TELEGRAM_PLACEHOLDER_TOKEN },
 			fetch: transport,
 			chatId: record.data.chatId,
 			...input
-		}) } }, options, archive, notify);
+		}) } }, options, archive, notify), () => record.data.locale ?? "en");
 	} catch (error) {
 		reportTelegramError("deferred_expiry_failed", error);
 	}

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

@@ -30,5 +30,5 @@ export interface ConfirmationText {
 export declare function confirmationLocale(principal: SessionAuthContext | null, fallback?: string): string;
 /** Reject the entire presentation object; never partially trust malformed model copy. */
 export declare function confirmationCopy(value?: unknown): ConfirmationCopy | undefined;
-/** Fixed markers retain callback meaning even if the model writes misleading labels. */
+/** Button positions retain callback meaning; workspace copy supplies every label and status. */
 export declare function renderConfirmation(description?: ConfirmationDescription, copy?: ConfirmationCopy): ConfirmationText;

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

@@ -4,6 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { telegramText } from "./texts.mjs";
 import { isTechnicalText } from "../customer-text-safety.mjs";
 import { humanText, object } from "../confirmation-description.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -48,7 +49,7 @@ function confirmationCopy(value) {
 		return typeof text === "string" && text === text.trim() && (key === "question" || !/[✅❌⌛⚠❓✏]/u.test(text)) && humanText(text, key === "question" ? 300 : 24) === text;
 	};
 	if (required.some((key) => !valid(key)) || optional.some((key) => copy[key] !== void 0 && !valid(key)) || copy.confirm === copy.cancel || Object.keys(copy).some((key) => ![...required, ...optional].includes(key))) {
-		console.warn("Invalid confirmation presentation; using metadata and symbols.");
+		console.warn("Invalid confirmation presentation; using workspace presentation.");
 		return;
 	}
 	return { ...copy };
@@ -57,27 +58,32 @@ function renderConfirmation(description, copy) {
 	copy = confirmationCopy(copy);
 	const action = humanText(description?.action);
 	if (description === void 0 || action === void 0 || action === "❓") throw new Error("A confirmation requires a safe declared action title.");
-	const facts = [[description?.warning ? "⚠️" : "", action].filter(Boolean).join(" "), ...(description?.fields ?? []).map(({ label, value }) => {
+	const facts = [action, ...(description?.fields ?? []).map(({ label, value }) => {
 		if (value.length > 3584) throw new Error("The complete confirmation facts cannot fit in one Telegram message.");
 		const safeLabel = humanText(label);
 		const safeValue = humanText(value, 3584);
 		if (safeLabel === void 0 || safeValue === void 0) throw new Error("The complete confirmation facts contain an unsafe field.");
 		return `${safeLabel}: ${safeValue}`;
 	})].filter(Boolean).join("\n");
-	const text = [copy?.question ?? "❓", facts].filter(Boolean).join("\n\n");
+	const configured = (key) => {
+		const value = telegramText("confirmation", key);
+		if (value === void 0) throw new Error(`texts.confirmation.${key} is required for Telegram confirmations.`);
+		return value;
+	};
+	const text = [copy?.question ?? configured("question"), facts].filter(Boolean).join("\n\n");
 	if (text.length > 3584) throw new Error("The complete confirmation facts cannot fit in one Telegram message.");
 	if (isTechnicalText(text)) throw new Error("The complete confirmation cannot pass the delivery safety check.");
 	return {
 		text,
-		confirm: copy === void 0 ? "✅" : `✅ ${copy.confirm}`,
-		cancel: copy === void 0 ? "❌" : `❌ ${copy.cancel}`,
-		executing: "⌛",
-		cancelled: copy === void 0 ? "❌" : `❌ ${copy.cancelled}`,
-		completed: copy === void 0 ? "✅" : `✅ ${copy.done}`,
-		failed: copy === void 0 ? "⚠️" : `⚠️ ${copy.failed}`,
-		expired: copy?.expired === void 0 ? "⌛" : `⌛ ${copy.expired}`,
-		interrupted: copy?.interrupted === void 0 ? "⏸" : `⏸ ${copy.interrupted}`,
-		edit: copy?.edit === void 0 ? "✏️" : `✏️ ${copy.edit}`
+		confirm: copy?.confirm ?? configured("confirm"),
+		cancel: copy?.cancel ?? configured("cancel"),
+		executing: configured("executing"),
+		cancelled: copy?.cancelled ?? configured("cancelled"),
+		completed: copy?.done ?? configured("done"),
+		failed: copy?.failed ?? configured("failed"),
+		expired: copy?.expired ?? configured("expired"),
+		interrupted: copy?.interrupted ?? configured("interrupted"),
+		edit: copy?.edit ?? configured("edit")
 	};
 }
 export { confirmationCopy, confirmationLocale, isConfirmationText, renderConfirmation, withConfirmationText };

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

@@ -4,21 +4,22 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { memberIdOf, telegramPrincipal } from "./principal.mjs";
-import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
-import { conversationEvent } from "../conversations.mjs";
+import { telegramText } from "./texts.mjs";
+import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-VFQWqe5S.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
+import { conversationEvent } from "../conversations.mjs";
+import { formatAddress, scopedAddress } from "./sessions.mjs";
 import { chatPostOperationId, isChatPost } from "../chat-post-confirmation.mjs";
 import { confirmations } from "../confirmations.mjs";
-import { formatAddress, scopedAddress } from "./sessions.mjs";
 import { postDeferredCard } from "./deferred-confirmations.mjs";
 import { answerMarker, isPendingQuestion, pendingQuestions, questionKey } from "../questions.mjs";
-import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 import { createHash } from "node:crypto";
-import { registerTelegramFreeformPrompt, renderTelegramInputRequest } from "eve/channels/telegram";
+import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
+import { registerTelegramFreeformPrompt } from "eve/channels/telegram";
 const PREFIX = "ss-confirm:";
 function shortHash(value) {
 	return createHash("sha256").update(value).digest("hex").slice(0, 20);
@@ -130,7 +131,7 @@ async function handleConfirmationCallback(input) {
 		showAlert: false
 	});
 	if (!query.data?.startsWith(PREFIX) || query.message === void 0 || query.from.isBot) {
-		await notice("⚠️");
+		await notice(telegramText("callback", "unknown"));
 		return;
 	}
 	const [requestHash, memberHash, choice] = query.data.slice(11).split(":");
@@ -139,7 +140,7 @@ async function handleConfirmationCallback(input) {
 		externalId: query.from.id
 	});
 	if (lookup.status !== "paired" || shortHash(lookup.member.id) !== memberHash) {
-		await notice("🔒");
+		await notice(telegramText("callback", "forbidden"));
 		return;
 	}
 	const address = scopedAddress(formatAddress({
@@ -154,7 +155,7 @@ async function handleConfirmationCallback(input) {
 		"n",
 		"e"
 	].includes(choice ?? "") || choice === "e" && !isChatPost(prompt.toolName)) {
-		await notice("⌛");
+		await notice(telegramText("callback", "already"));
 		return;
 	}
 	const expired = !Number.isFinite(prompt.at) || prompt.at + 6e5 <= (input.now ?? Date.now());
@@ -182,7 +183,7 @@ async function handleConfirmationCallback(input) {
 			...expired ? { confirmationReason: "expired" } : edit ? { confirmationReason: "edit" } : {}
 		}
 	}, edit ? "The chat post was cancelled for editing. Ask the member what to change using questions_ask, then make a NEW chat_post_message call and confirmation. Never reuse the cancelled call." : void 0);
-	await notice(expired ? "⌛" : void 0);
+	await notice(expired ? telegramText("callback", "expired") : void 0);
 }
 function messagePrompt(message) {
 	return message.prompt ?? {
@@ -251,21 +252,25 @@ function telegramConfirmationEvents(archive, observed, deferredOptions) {
 		async "input.requested"(data, channel, ctx) {
 			for (const request of data.requests) {
 				if (request.kind !== "tool-approval") {
-					const rendered = renderTelegramInputRequest(request, channel.state);
-					const sent = await channel.telegram.post({
-						text: rendered.text,
-						reply_markup: rendered.replyMarkup
-					});
-					remember(channel, ctx, sent.id, rendered.text);
-					if (rendered.freeformRequestId !== void 0) registerTelegramFreeformPrompt(channel.state, {
+					const text = [request.prompt, ...(request.options ?? []).map((option, index) => `${index + 1}. ${option.label}`)].join("\n");
+					if (text.length > 4096) throw new Error("A typed Telegram question must fit in one message.");
+					const sent = await withConfirmationText(text, () => channel.telegram.post({
+						text,
+						reply_markup: {
+							force_reply: true,
+							selective: true
+						}
+					}));
+					remember(channel, ctx, sent.id, text);
+					registerTelegramFreeformPrompt(channel.state, {
 						messageId: sent.id,
 						requestId: request.requestId
 					});
-					else channel.state.hitlPrompts = {
+					channel.state.hitlPrompts = {
 						...channel.state.hitlPrompts,
 						[request.requestId]: {
 							messageId: sent.id,
-							text: rendered.text,
+							text,
 							options: (request.options ?? []).map(({ id, label }) => ({
 								id,
 								label
@@ -352,7 +357,7 @@ function telegramConfirmationEvents(archive, observed, deferredOptions) {
 						await channel.telegram.editMessageText({
 							messageId: prompt.messageId,
 							replyMarkup: { inline_keyboard: [] },
-							text: `${prompt.text}\n\n${label ?? "✅"}`
+							text: label === void 0 ? prompt.text : `${prompt.text}\n\n${label}`
 						});
 						delete channel.state.hitlPrompts?.[resolution.requestId];
 					}
@@ -438,9 +443,9 @@ function telegramConfirmationEvents(archive, observed, deferredOptions) {
 			const failed = data.status !== "completed" || data.result.kind === "tool-result" && (data.result.isError === true || object(data.result.output).isError === true || object(object(data.result.output).validation).ok === false);
 			if (message.exactPost) {
 				const copy = message.copy ?? renderConfirmation();
-				const receipt = !failed && data.result.kind === "tool-result" ? chatPostReceipt(data.result.output, copy.completed) : void 0;
+				const receipt = !failed && data.result.kind === "tool-result" ? chatPostReceipt(data.result.output) : void 0;
 				const errorId = failed ? reportTelegramError("confirmed_chat_post_failed", data, { callId: data.result.callId }) : void 0;
-				const status = receipt ?? (failed ? `${copy.failed} ${errorId}\n⚠️ ❓` : "⚠️ ❓");
+				const status = receipt ?? (failed ? `${copy.failed} ${errorId}` : telegramText("chatPost", "uncertain") ?? "");
 				const text = chatPostCardStatus(message.text, status);
 				const prompt = {
 					...messagePrompt(message),

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

@@ -8,6 +8,7 @@ import type { AddressingReason, RouteDecider, RouteDecision } from "./router.js"
 export declare const REVISION_CLAIM_TTL_MS: number;
 /** Runs after webhook verification, before eve drops bot/channel/service updates. */
 export declare function captureTelegramWebhook(input: {
+    readonly answerCallback?: (id: string, locale?: string) => Promise<unknown>;
     readonly request: Request;
     readonly archive: Conversations;
     readonly identities: AgentIdentities;
@@ -31,6 +32,7 @@ export declare function captureTelegramFetch(fetchImpl: typeof fetch, archive: C
 export declare function conversationIdentities(identities: AgentIdentities): AgentIdentities;
 /** Verification and failure acknowledgement stay outside eve's swallowed onMessage failures. */
 export declare function telegramConversationCapture(input: {
+    readonly answerCallback?: (id: string, locale?: string) => Promise<unknown>;
     readonly archive: Conversations;
     readonly identities: () => AgentIdentities;
     readonly observed: ObservedMessages;

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

@@ -4,10 +4,10 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { currentConfirmationPrompt, observedChatKey } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
-import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
 import { contentShape, messageContent } from "./content.mjs";
 import { messageMetadata } from "./observed.mjs";
 import { reportMembership } from "./membership.mjs";
@@ -79,6 +79,19 @@ async function captureTelegramWebhook(input) {
 		return input.next();
 	}
 	const update = record(raw);
+	const callback = record(update.callback_query);
+	const data = callback.data;
+	if (typeof data === "string" && (data.startsWith("eve_auth:") || data.startsWith("eve:"))) {
+		if (typeof callback.id === "string" && input.answerCallback !== void 0) {
+			const locale = record(callback.from).language_code;
+			try {
+				await input.answerCallback(callback.id, typeof locale === "string" ? locale : void 0);
+			} catch (error) {
+				reportTelegramError("unsupported_callback_ack_failed", error, { callbackQueryId: callback.id });
+			}
+		}
+		return new Response("ok");
+	}
 	if (input.chats !== void 0 && (update.my_chat_member !== void 0 || update.chat_member !== void 0)) {
 		const task = reportMembership({
 			update,

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

@@ -4,14 +4,15 @@ export { isTechnicalText } from "../customer-text-safety.js";
 export declare function withDeliveryLocale<T>(locale: string, run: () => T, threadId?: string, replyTo?: string, chatId?: string): T;
 export declare function currentLocale(): string;
 export declare function currentThreadId(): string | undefined;
-export declare function customerCopy(): {
-    failed: string;
-    recovery: string;
-    attachment: string;
-    authorization: string;
-    response: string;
-    connected: string;
-    disconnected: string;
+export declare function customerCopy(locale?: string): {
+    failed: string | undefined;
+    recovery: string | undefined;
+    attachment: string | undefined;
+    authorization: string | undefined;
+    response: string | undefined;
+    connected: string | undefined;
+    disconnected: string | undefined;
+    cancelled: string | undefined;
 };
 /** 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;

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

@@ -5,5 +5,5 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { isTechnicalText } from "../customer-text-safety.mjs";
-import { a as TelegramDeliveryError, c as customerCopy, d as failureText, f as formattingRefused, h as withDeliveryLocale, l as customerMessage, m as safeTelegramFetch, o as currentLocale, p as reportTelegramError, s as currentThreadId, u as customerText } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { a as TelegramDeliveryError, c as customerCopy, d as failureText, f as formattingRefused, h as withDeliveryLocale, l as customerMessage, m as safeTelegramFetch, o as currentLocale, p as reportTelegramError, s as currentThreadId, u as customerText } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 export { TelegramDeliveryError, currentLocale, currentThreadId, customerCopy, customerMessage, customerText, failureText, formattingRefused, isTechnicalText, reportTelegramError, safeTelegramFetch, withDeliveryLocale };

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

@@ -4,23 +4,24 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { telegramPrincipal } from "./principal.mjs";
-import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
-import { conversationEvent } from "../conversations.mjs";
+import { telegramText, withTelegramLocale } from "./texts.mjs";
+import { o as telegramPrincipal } from "../../../_chunks/principal-VFQWqe5S.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
+import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
+import { conversationEvent } from "../conversations.mjs";
+import { formatAddress } from "./sessions.mjs";
 import { CONFIRMATION_TTL_MS, inputHash } from "../confirmations.mjs";
 import { OntologyToolRejected } from "../ontology-tools.mjs";
 import { confirmationOutcome } from "../confirmation-outcome.mjs";
 import { deferredConfirmations, deferredKey, runDeferredAction } from "../deferred-confirmations.mjs";
-import { formatAddress } from "./sessions.mjs";
 import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 const PREFIX = "ss-confirm:d:";
 const isDeferredCallback = (data) => data?.startsWith(PREFIX) === true;
 const deferredCallback = (record, choice) => `${PREFIX}${record.key}:${choice}`;
-const copyOf = (record) => record.data.confirmation.description?.chatPost ? chatPostCard(record.data.confirmation.description, record.data.confirmation.copy) : renderConfirmation(record.data.confirmation.description, record.data.confirmation.copy);
+const copyOf = (record) => withTelegramLocale(record.data.locale, () => record.data.confirmation.description?.chatPost ? chatPostCard(record.data.confirmation.description, record.data.confirmation.copy) : renderConfirmation(record.data.confirmation.description, record.data.confirmation.copy));
 function promptOf(record, state) {
 	const name = humanText(record.data.requesterName);
 	return {
@@ -28,7 +29,7 @@ function promptOf(record, state) {
 		requestId: record.id,
 		sessionId: record.data.sessionId,
 		address: record.data.address,
-		action: humanText(record.data.confirmation.description?.action) ?? "❓",
+		action: humanText(record.data.confirmation.description?.action) ?? "",
 		requestedBy: name ?? null,
 		at: new Date(record.expiresAt - CONFIRMATION_TTL_MS).toISOString(),
 		state,
@@ -151,7 +152,7 @@ async function handleDeferredCallback(input) {
 	};
 	const parts = /^ss-confirm:d:([0-9a-f]{20}):([yne])$/.exec(query.data ?? "");
 	if (!parts || !query.message || query.from.isBot) {
-		await notice("⚠️");
+		await notice(telegramText("callback", "unknown"));
 		return;
 	}
 	const store = deferredConfirmations(options);
@@ -164,11 +165,11 @@ async function handleDeferredCallback(input) {
 		externalId: query.from.id
 	});
 	if (!record || lookup.status !== "paired" || lookup.member.id !== record.memberId || record.data.requester !== query.from.id || record.data.chatId !== query.message.chat.id || record.data.threadId !== String(query.message.messageThreadId ?? "") || record.data.messageId !== query.message.messageId) {
-		await notice("🔒");
+		await notice(telegramText("callback", "forbidden"));
 		return;
 	}
 	if (record.inputHash !== inputHash(record.data.input) || parts[2] === "e" && record.data.confirmation.description?.chatPost === void 0) {
-		await notice("⚠️");
+		await notice(telegramText("callback", "unknown"));
 		return;
 	}
 	const copy = copyOf(record);
@@ -181,10 +182,10 @@ async function handleDeferredCallback(input) {
 		decision
 	});
 	if (!claimed || claimed.status === "pending") {
-		await notice("⌛");
+		await notice(telegramText("callback", "already"));
 		return;
 	}
-	await notice(claimed.status === "expired" ? "⌛" : void 0);
+	await notice(claimed.status === "expired" ? telegramText("callback", "expired") : void 0);
 	let status = claimed.status;
 	let cardStatus = status === "expired" ? copy.expired : copy.cancelled;
 	let execution;
@@ -213,7 +214,7 @@ async function handleDeferredCallback(input) {
 		try {
 			const result = await runDeferredAction(claimed, options);
 			status = "done";
-			cardStatus = claimed.data.confirmation.description?.chatPost ? chatPostReceipt(result.structuredContent, copy.completed) ?? "⚠️ ❓" : copy.completed;
+			cardStatus = claimed.data.confirmation.description?.chatPost ? withTelegramLocale(claimed.data.locale, () => chatPostReceipt(result.structuredContent) ?? telegramText("chatPost", "uncertain") ?? "") : copy.completed;
 		} catch (error) {
 			status = "failed";
 			const reference = reportTelegramError("deferred_action_failed", error);

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

@@ -4,8 +4,8 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { conversationLanguage } from "./principal.mjs";
-import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { n as conversationLanguage } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { describableImage, describeReceivedImage } from "./images.mjs";
 import { MAXIMUM_ATTACHMENT_BYTES, attachmentUrl } from "../attachments.mjs";
 function telegramConversation(chatId) {

package/dist/extension/lib/telegram/health.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 { t as agentBuild } from "../../../_chunks/build-metadata-CLprTpsn.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-BB2uSGsI.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";

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 { p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.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.mjs

@@ -4,5 +4,5 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { i as withReplacedText, n as currentInboundRequest, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { i as withReplacedText, n as currentInboundRequest, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 export { InboundRequest, currentInboundRequest, runInboundRequest, withReplacedText };

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

@@ -5,16 +5,17 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { effectiveGroupPolicy, groupPolicy } from "../group-routing/policy.mjs";
-import { conversationLanguage, telegramPrincipal } from "./principal.mjs";
+import { admitMessage, localizedText } from "../admission.mjs";
+import { d as telegramRuntimeSource, n as conversationLanguage, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-VFQWqe5S.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { addressingReason, conversationKey, otherRecipient } from "../group-routing/signals.mjs";
 import { conversationAddressing, conversationState } from "../group-routing/conversation.mjs";
 import { questionInvitation } from "../group-routing/engagement.mjs";
 import { conversationContext, routeMessage } from "../group-routing/router.mjs";
 import { observedContext } from "../group-routing/observed.mjs";
 import { debounceBurst, routingBurst } from "../group-routing/burst.mjs";
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
-import { AttachmentLifecycleNotPermitted, startTypingHeartbeat, typingUntilComplete } from "./lifecycle.mjs";
 import { formatAddress, messageAddress, scopedAddress } from "./sessions.mjs";
+import { AttachmentLifecycleNotPermitted, startTypingHeartbeat, typingUntilComplete } from "./lifecycle.mjs";
 import { contentShape, messageContent } from "./content.mjs";
 import { messageAudience } from "./audience.mjs";
 import { attachmentKind, messageMetadata } from "./observed.mjs";
@@ -27,13 +28,9 @@ import { questionAddress, questionFromHistory } from "./confirmations.mjs";
 import { routingContext } from "./routing-context.mjs";
 import { recordGateDecision, recordInboundContent, recordRouteDecision } from "./conversations.mjs";
 import { chatContext } from "./chats.mjs";
-import { admitMessage, localizedText } from "../admission.mjs";
 import { attachmentsContext, inboundAttachments, stageFiles } from "./files.mjs";
 import { heldApprovals, releaseHeldApproval } from "./held-approvals.mjs";
 import { voiceOf, voiceText } from "./voice.mjs";
-const UNKNOWN_PRIVATE = "🔗";
-const UNKNOWN_IN_GROUP = "🔒";
-const REFUSED = "🔒";
 const MAXIMUM_QUOTE_LENGTH = 500;
 function buttonTo(text, url) {
 	return { inline_keyboard: [[{
@@ -96,12 +93,6 @@ function speakerBlock(input) {
 	lines.push("</speaker>");
 	return lines.join("\n");
 }
-function unknownInGroup(bot) {
-	return bot?.username === void 0 ? { text: UNKNOWN_IN_GROUP } : {
-		text: UNKNOWN_IN_GROUP,
-		reply_markup: buttonTo("✉️", `https://t.me/${bot.username}`)
-	};
-}
 async function answerUnpaired(input) {
 	const { context, message, lookup, dependencies } = input;
 	if (lookup.status === "limited") {
@@ -131,12 +122,19 @@ async function answerUnpaired(input) {
 	}
 	if (lookup.status === "refused") {
 		const text = localizedText(dependencies.admission().replies.refused, message.from.languageCode);
-		await context.telegram.post(text ?? REFUSED);
-		return true;
+		if (text !== void 0) await context.telegram.post(text);
+		return text !== void 0;
 	}
+	const replies = dependencies.admission().replies;
+	const locale = message.from.languageCode;
 	if (message.chat.type !== "private") {
-		await context.telegram.post(localizedText(dependencies.admission().replies.groupPairingRequired, message.from.languageCode) ?? unknownInGroup(input.bot));
-		return true;
+		const text = localizedText(replies.groupPairingRequired, locale);
+		const button = localizedText(replies.groupPairingButton, locale);
+		if (text !== void 0) await context.telegram.post({
+			text,
+			...button === void 0 || input.bot?.username === void 0 ? {} : { reply_markup: buttonTo(button, `https://t.me/${input.bot.username}`) }
+		});
+		return text !== void 0;
 	}
 	const sender = display(message.from);
 	const pairing = await dependencies.identities.createPairing({
@@ -144,9 +142,12 @@ async function answerUnpaired(input) {
 		externalId: message.from.id,
 		...sender === void 0 ? {} : { display: sender }
 	});
+	const text = localizedText(replies.pairingRequired, locale);
+	const label = localizedText(replies.pairingButton, locale);
+	if (text === void 0 || label === void 0) throw new Error("replies.pairingRequired and replies.pairingButton are required for Telegram.");
 	await context.telegram.post({
-		text: UNKNOWN_PRIVATE,
-		reply_markup: buttonTo("🔗", dependencies.connectUrl(pairing.code))
+		text,
+		reply_markup: buttonTo(label, dependencies.connectUrl(pairing.code))
 	});
 	return true;
 }
@@ -756,6 +757,7 @@ async function handleInboundMessage(input) {
 		} : mediaPlan },
 		...dependencies.describeImage === void 0 ? {} : { describeImage: dependencies.describeImage }
 	});
+	if (input.request !== void 0) input.request.files = files;
 	if (input.request?.lifecycle !== void 0) {
 		const lifecycle = input.request.lifecycle;
 		const key = input.request.lifecycleKey;
@@ -786,7 +788,10 @@ async function handleInboundMessage(input) {
 					outcome = { result: (await dependencies.attachments.promote({
 						memberId: member.id,
 						conversation: `telegram:${sent.chat.id}`
-					}, file.attachment.id, stored.retain)).result };
+					}, file.attachment.id, {
+						...stored.retain,
+						runtime: runtimeEnvelope({ source: telegramRuntimeSource(sent, files) })
+					})).result };
 				} catch (error) {
 					outcome = { error: reportTelegramError("attachment_retention_failed", error, { attachmentId: file.attachment.id }) };
 				}