@segmentstream/agent 0.12.2 → 0.13.0

package/dist/extension/instructions.md

@@ -11,7 +11,6 @@ talking to you, and you act with exactly their permissions.
   exact MCP names and input schemas. Pass returned ontology hashes as `expected_hash`
   on subsequent describe/discover requests so a redeployment cannot mix definitions.
   These tools are directly available; do not search a connection namespace to find them.
-  With held confirmations the same operations are reached through `segmentstream__ontology`.
   Call `me` when you need to check whom you act for. For an unfamiliar task, call `describe`
   without a ref for a compact entity index, or `discover` to search names and descriptions.
   Inspect relevant `entity:`, `action:`, or `measure:` refs with `describe` for their complete
@@ -42,14 +41,14 @@ talking to you, and you act with exactly their permissions.
   the member explicitly cancels or replaces the earlier task. If work is interrupted or blocked,
   say what remains unfinished; never silently replace it with the latest question.
 - Destructive or irreversible actions, and legacy custom actions without safety labels, require
-  the tool boundary's Confirm / Cancel buttons. Call the action to start that flow; never ask for
+  the tool boundary's workspace-authored confirmation buttons. Call the action to start that flow; never ask for
   approval in prose or treat a text acknowledgement as approval. Wait for the button outcome.
   When the tool schema offers `_confirmation`, supply {question, confirm, cancel, done,
   cancelled, failed, expired?, edit?} in the chat's language. Describe the action and key
   parameters in a plain single-line question (at most 300 characters); labels are at most
   24 characters. No IDs, tool names, snake_case, URLs, credentials, or markup. The platform
-  adds trusted facts and symbols. Omit this argument on older tools without schema support.
-  Leave decision symbols to the platform and use distinct confirm/cancel labels. If trusted
+  adds trusted facts. Omit this argument on older tools without schema support.
+  Use distinct confirm/cancel labels; all visible wording comes from the workspace. If trusted
   target titles are unavailable or the facts are too long, resolve the targets or narrow the call.
   Cancel ends that call; retry it only after a new instruction from the member.
 - Every change goes through an action. Report results after success; never claim a record changed

package/dist/extension/lib/build-metadata.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 { t as agentBuild } from "../../_chunks/build-metadata-CLprTpsn.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-BLeBanNg.mjs";
 export { agentBuild };

package/dist/extension/lib/chat-post-confirmation.d.ts

@@ -8,6 +8,7 @@ export interface ChatPostPreview {
     readonly externalId: string;
     readonly title: string;
     readonly attribution: string;
+    readonly attributionSeparator?: string;
     readonly text: string;
     readonly finalText: string;
     readonly replyTo: string | null;

package/dist/extension/lib/chat-post-confirmation.mjs

@@ -47,8 +47,9 @@ function describeChatPost(input) {
 		caller.attribution
 	].every((value) => typeof value === "string" && value.length > 0) || target.provider !== "telegram" || target.id !== values.chat && target.title !== values.chat) throw new Error("An unambiguous destination and a complete exact chat preview are required.");
 	const footer = escapeMarkdownV2(caller.attribution);
+	const separator = typeof caller.attribution_separator === "string" ? caller.attribution_separator : "\n\n";
 	return {
-		action: "❓",
+		action: "",
 		fields: [],
 		chatPost: {
 			chatId: target.id,
@@ -56,8 +57,9 @@ function describeChatPost(input) {
 			externalId: target.external_id,
 			title: target.title,
 			attribution: caller.attribution,
+			...separator === "\n\n" ? {} : { attributionSeparator: separator },
 			text: values.text,
-			finalText: `${converter.fromMarkdown(values.text)}\n\n──────────\n_${footer}_`,
+			finalText: `${converter.fromMarkdown(values.text)}${escapeMarkdownV2(separator)}_${footer}_`,
 			replyTo: typeof values.reply_to === "string" ? values.reply_to : null
 		}
 	};

package/dist/extension/lib/confirmation-outcome.d.ts

@@ -22,6 +22,6 @@ export declare function confirmationOutcome(record: DeferredConfirmation, status
         request?: string | undefined;
     } | undefined;
     confirmation: string;
-    status: "done" | "cancelled" | "failed" | "expired" | "approved";
+    status: "expired" | "done" | "cancelled" | "failed" | "approved";
     summary: string;
 };

package/dist/extension/lib/confirmations.d.ts

@@ -2,6 +2,7 @@ import { type StateHandle } from "eve/context";
 import type { ApprovalConfiguration } from "eve/tools/approval";
 import type { ConfirmationDescription } from "./confirmation-description.js";
 import { type ConfirmationCopy } from "./telegram/confirmation-text.js";
+import { type TelegramTexts } from "./telegram/texts.js";
 export declare const CONFIRMATION_TTL_MS: number;
 export interface ActionAnnotations {
     readonly readOnlyHint?: boolean;
@@ -33,6 +34,7 @@ export declare const confirmations: StateHandle<Record<string, Confirmation>>;
 export declare function actionApproval(options: {
     readonly labels: (memberId: string, action: string, input: Readonly<Record<string, unknown>>) => Promise<ActionAnnotations>;
     readonly describe?: (memberId: string, action: string, input: Readonly<Record<string, unknown>>) => Promise<ConfirmationDescription>;
+    readonly texts?: () => TelegramTexts;
     readonly state?: StateHandle<Record<string, Confirmation>>;
     readonly now?: () => number;
 }): ApprovalConfiguration;

package/dist/extension/lib/confirmations.mjs

@@ -4,8 +4,9 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
+import { withTelegramTexts } from "./telegram/texts.mjs";
 import { memberIdOf } from "./telegram/principal.mjs";
-import { confirmationCopy, renderConfirmation } from "./telegram/confirmation-text.mjs";
+import { confirmationCopy, confirmationLocale, renderConfirmation } from "./telegram/confirmation-text.mjs";
 import { chatPostCard } from "./telegram/chat-post-card.mjs";
 import { chatPostDigest, isChatPost } from "./chat-post-confirmation.mjs";
 import { createHash } from "node:crypto";
@@ -36,6 +37,7 @@ function actionApproval(options) {
 		async request(ctx) {
 			const memberId = memberIdOf(ctx.session.auth.current);
 			if (memberId === void 0) return denied("A paired member is required.");
+			const present = (run) => options.texts === void 0 ? run() : withTelegramTexts(options.texts(), run, () => confirmationLocale(ctx.session.auth.current));
 			const hash = inputHash(ctx.toolInput ?? {});
 			const saved = state.get()[ctx.callId];
 			if (saved !== void 0) {
@@ -59,10 +61,11 @@ function actionApproval(options) {
 				const preview = description?.chatPost;
 				const source = ctx.session.auth.current?.attributes;
 				if (description === void 0 || preview === void 0 || typeof source?.chatId !== "string" || source.chatId === preview.externalId) return denied("A complete preview for a different chat is required. Reply normally in this chat.");
-				chatPostCard({
+				const previewDescription = {
 					...description,
 					warning: labels.destructiveHint === true || labels.irreversibleHint === true
-				}, copy);
+				};
+				present(() => chatPostCard(previewDescription, copy));
 				if (saved !== void 0 && (saved.description?.chatPost === void 0 || chatPostDigest(saved.description.chatPost) !== chatPostDigest(preview) || saved.source?.chatId !== source.chatId || saved.source.threadId !== String(source.messageThreadId ?? ""))) return denied("The destination or attribution changed. Make a new call and confirmation.");
 			} catch (error) {
 				console.warn("The exact chat confirmation could not be prepared.", error);
@@ -92,7 +95,7 @@ function actionApproval(options) {
 				warning: labels.destructiveHint === true || labels.irreversibleHint === true
 			};
 			try {
-				if (!posting) renderConfirmation(description, copy);
+				if (!posting) present(() => renderConfirmation(description, copy));
 			} catch {
 				return denied("The complete confirmation facts are unsafe or too long. Narrow the action input.");
 			}

package/dist/extension/lib/deferred-confirmations.d.ts

@@ -2,6 +2,7 @@ import type { ToolContext } from "eve/tools";
 import { type Confirmation } from "./confirmations.js";
 import { type Environment } from "./environment.js";
 import { type RuntimeToken } from "./runtime-token.js";
+import type { TelegramTexts } from "./telegram/texts.js";
 export interface DeferredConfirmation {
     readonly id: string;
     readonly key: string;
@@ -18,12 +19,14 @@ export interface DeferredConfirmation {
         readonly chatId: string;
         readonly threadId: string;
         readonly requester: string;
+        readonly locale?: string;
         readonly requesterName?: string;
         readonly messageId?: string;
         readonly address?: string;
     };
 }
 export type DeferredOptions = {
+    readonly texts?: () => TelegramTexts;
     readonly environment?: Environment;
     readonly token?: RuntimeToken;
     readonly fetch?: typeof fetch;

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

@@ -60,6 +60,7 @@ async function executeDeferredTool(memberId, action, input, ctx, options = {}) {
 	let saved = {};
 	const result = await actionApproval({
 		...tools,
+		...options.texts === void 0 ? {} : { texts: options.texts },
 		state: {
 			get: () => saved,
 			update: (update) => {
@@ -101,6 +102,7 @@ async function executeDeferredTool(memberId, action, input, ctx, options = {}) {
 				chatId: attributes.chatId,
 				threadId: String(attributes.messageThreadId ?? ""),
 				requester: principal.subject,
+				locale: String(attributes.conversationLanguage ?? attributes.locale ?? "en"),
 				...humanText(attributes.memberName) === void 0 ? {} : { requesterName: humanText(attributes.memberName) }
 			}
 		}

package/dist/extension/lib/ontology-tools.mjs

@@ -154,7 +154,7 @@ function ontologyTools(options = {}) {
 						caller,
 						destinations
 					}),
-					action: typeof tool.title === "string" ? tool.title : "❓"
+					action: typeof tool.title === "string" ? tool.title : typeof tool.description === "string" ? tool.description.split("\n\n")[0] : ""
 				};
 			}
 			let entities = [];

package/dist/extension/lib/telegram/adapter.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, withTelegramTexts } from "./texts.mjs";
 import { manifestOf } from "../../config.mjs";
 import { appOrigin, channelsEnabled, proxyEnvironment, runtimeIdentityEnvironment, webhookSecret } from "../environment.mjs";
 import { conversationLanguage, telegramPrincipal } from "./principal.mjs";
@@ -13,10 +14,10 @@ import { decisionRouter } from "../group-routing/router.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-CLprTpsn.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-BLeBanNg.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
-import { d as failureText, h as withDeliveryLocale, i as withReplacedText, m as safeTelegramFetch, n as currentInboundRequest, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { d as failureText, h as withDeliveryLocale, i as withReplacedText, m as safeTelegramFetch, n as currentInboundRequest, o as currentLocale, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { scopedAddress, sessionPolicy } from "./sessions.mjs";
 import { observedMessages } from "./observed.mjs";
@@ -120,7 +121,31 @@ function segmentstreamTelegram(options) {
 		identities: pairing,
 		observed,
 		chats,
-		verify: telegramWebhookVerifier(() => webhookSecret(environment))
+		verify: telegramWebhookVerifier(() => webhookSecret(environment)),
+		answerCallback: async (callbackQueryId, locale) => {
+			const text = telegramText("callback", "unsupported", locale);
+			const reply = await proxy().request({
+				api: "bot",
+				method: "POST",
+				path: "/answerCallbackQuery",
+				headers: [["content-type", "application/json"]],
+				body: new TextEncoder().encode(JSON.stringify({
+					callback_query_id: callbackQueryId,
+					...text === void 0 ? {} : { text }
+				}))
+			});
+			const body = new TextDecoder().decode(reply.body);
+			let answer;
+			try {
+				answer = JSON.parse(body);
+			} catch (cause) {
+				throw new Error(`Telegram callback acknowledgement was invalid (HTTP ${reply.status}): ${body}`, { cause });
+			}
+			if (reply.status < 200 || reply.status >= 300 || answer === null || typeof answer !== "object" || !("ok" in answer) || answer.ok !== true) throw new Error("Telegram callback acknowledgement was refused.", { cause: {
+				status: reply.status,
+				body
+			} });
+		}
 	});
 	let store = options.attachments;
 	function attachments() {
@@ -279,6 +304,8 @@ function segmentstreamTelegram(options) {
 			}
 		},
 		onCallbackQuery: async (context, query) => {
+			const inbound = currentInboundRequest();
+			if (inbound !== void 0) inbound.locale = query.from.languageCode;
 			try {
 				if (isDeferredCallback(query.data)) {
 					await handleDeferredCallback({
@@ -306,7 +333,7 @@ function segmentstreamTelegram(options) {
 				reportTelegramError("confirmation_callback_failed", error);
 				await context.telegram.answerCallbackQuery({
 					callbackQueryId: query.id,
-					text: "⚠️"
+					...telegramText("callback", "error") === void 0 ? {} : { text: telegramText("callback", "error") }
 				});
 			}
 		},
@@ -404,7 +431,7 @@ function segmentstreamTelegram(options) {
 				const locale = confirmationLocale(principal ?? null, context.state.customerLocale ?? "en");
 				context.state.customerLocale = locale;
 				await withDeliveryLocale(locale, async () => {
-					await handler(event, context);
+					await withTelegramTexts(options.admission?.().texts ?? {}, () => handler(event, context), currentLocale);
 				}, context.state.messageThreadId === null ? void 0 : String(context.state.messageThreadId), typeof principal?.attributes.replyToMessageId === "string" ? principal.attributes.replyToMessageId : void 0, typeof principal?.attributes.chatId === "string" ? principal.attributes.chatId : void 0);
 			}]))
 		} },
@@ -482,7 +509,7 @@ function gatedRoute(input) {
 			};
 			inbound.waitUntil = waitUntil;
 			inbound.backgroundUntil = (task) => args.waitUntil(task);
-			return runInboundRequest(inbound, () => input.capture(request, async (routedRequest = request) => {
+			return withTelegramTexts(options.admission?.().texts ?? {}, () => runInboundRequest(inbound, () => input.capture(request, async (routedRequest = request) => {
 				const response = await route.handler(routedRequest, {
 					...args,
 					waitUntil,
@@ -501,7 +528,7 @@ function gatedRoute(input) {
 					headers: { "retry-after": "1" }
 				});
 				return response;
-			}));
+			})), currentLocale);
 		}
 	};
 }

package/dist/extension/lib/telegram/attachment-description.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 { describableImage } from "./images.mjs";
 import { MAXIMUM_ROUTING_PDF_CHARACTERS, extractRoutingPdf } from "./pdf-text.mjs";
 import { gateway, generateText } from "ai";

package/dist/extension/lib/telegram/attachments-send.mjs

@@ -10,7 +10,7 @@ import { runtimeToken } from "../runtime-token.mjs";
 import { redactDiagnostic } from "../diagnostics.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { inTelegramSendQueue, telegramSendScope } from "./send-queue.mjs";
-import { c as customerCopy, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { MAXIMUM_PROXY_BODY_BYTES, connectionProxy } from "../connection-proxy.mjs";
 import { ACT_AS_HEADER } from "../ontology-connection.mjs";
 import { AttachmentError, CONVERSATION_HEADER, SESSION_HEADER } from "../attachments.mjs";
@@ -83,14 +83,17 @@ async function sendAttachmentsInOrder(options) {
 	const environment = options.environment ?? process.env;
 	const principal = options.principal;
 	const locale = confirmationLocale(principal);
-	const unavailable = (error, diagnostic) => ({
-		error,
-		detail: customerCopy().attachment,
-		reference: reportTelegramError("attachment_send_refused", {
+	const unavailable = (error, diagnostic) => {
+		const reference = reportTelegramError("attachment_send_refused", {
 			error,
 			diagnostic
-		})
-	});
+		});
+		return {
+			error,
+			detail: failureText(reference, "attachment", locale),
+			reference
+		};
+	};
 	if (!channelsEnabled(environment)) return unavailable("channels_disabled", "Attachments can be sent only in production.");
 	if (options.connection === void 0) return unavailable("unsupported", "The Telegram channel is not configured.");
 	if (principal?.authenticator !== "segmentstream-telegram" || typeof principal.attributes.chatId !== "string" || !/^-?\d{1,20}$/.test(principal.attributes.chatId)) return unavailable("no_telegram_chat", "This turn has no Telegram chat.");
@@ -104,7 +107,7 @@ async function sendAttachmentsInOrder(options) {
 		const reference = reportTelegramError("attachment_owner_refused", error);
 		return {
 			error: "forbidden",
-			detail: customerCopy().attachment,
+			detail: failureText(reference, "attachment", locale),
 			reference
 		};
 	}
@@ -187,7 +190,7 @@ async function sendAttachmentsInOrder(options) {
 				id: reference.id,
 				filename,
 				error: error instanceof AttachmentError ? error.code : "unavailable",
-				detail: customerCopy().attachment,
+				detail: failureText(errorId, "attachment", locale),
 				reference: errorId
 			};
 		}
@@ -271,7 +274,7 @@ async function sendAttachmentsInOrder(options) {
 					id: file.id,
 					filename: file.filename,
 					error: error instanceof AttachmentError ? error.code : "send_failed",
-					detail: customerCopy().attachment,
+					detail: failureText(errorId, "attachment", locale),
 					reference: errorId
 				};
 			});

package/dist/extension/lib/telegram/chat-post-card.d.ts

@@ -7,4 +7,4 @@ export declare function chatPostCardLinks(text: string): readonly string[] | und
 export declare function chatPostCard(description: ConfirmationDescription, copy?: ConfirmationCopy): ConfirmationText;
 /** Status/receipt strings are data outside the already rendered preview. */
 export declare function chatPostCardStatus(text: string, status: string): string;
-export declare function chatPostReceipt(output: unknown, completed?: string): string | undefined;
+export declare function chatPostReceipt(output: unknown): string | undefined;

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 { 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 { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.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 };