@segmentstream/agent 0.12.1 → 0.13.0

package/dist/extension/config.mjs

@@ -5,6 +5,9 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { effectiveGroupPolicy, groupPolicy } from "./lib/group-routing/policy.mjs";
+import { localizedText as localizedText$1 } from "./lib/admission.mjs";
+import { TELEGRAM_TEXT_KEYS } from "./lib/telegram/texts.mjs";
+import { isTechnicalText } from "./lib/customer-text-safety.mjs";
 import { readFileSync, realpathSync } from "node:fs";
 import { isAbsolute, relative, resolve } from "node:path";
 import { expandGroupFiles, groupPolicyIssues } from "@segmentstream-cloud/ontology/groups";
@@ -24,6 +27,9 @@ const DEFAULT_ADMISSION_LIMITS = {
 	workspaceTurnsPerDay: 3e3
 };
 const ADMISSION_REPLY_KEYS = [
+	"pairingRequired",
+	"pairingButton",
+	"groupPairingButton",
 	"limited",
 	"perSenderLimited",
 	"workspaceLimited",
@@ -72,7 +78,8 @@ function telegramSettings(value, issues) {
 			"groups",
 			"linkPreviews",
 			"additionalOwnOrigins",
-			"attachmentLifecycle"
+			"attachmentLifecycle",
+			"menuButton"
 		],
 		issues
 	});
@@ -115,6 +122,17 @@ function telegramSettings(value, issues) {
 		message: "must be an array of HTTP(S) origins without paths, credentials, queries or fragments",
 		path: [...path, "additionalOwnOrigins"]
 	});
+	const menuButton = section({
+		value: telegram.menuButton,
+		path: [...path, "menuButton"],
+		allowed: ["text"],
+		issues
+	});
+	const menuText = menuButton === void 0 ? void 0 : localizedText(menuButton.text, [
+		...path,
+		"menuButton",
+		"text"
+	], issues, 64);
 	const lifecycle = section({
 		value: telegram.attachmentLifecycle,
 		path: [...path, "attachmentLifecycle"],
@@ -143,6 +161,7 @@ function telegramSettings(value, issues) {
 		...signalSettings === void 0 ? {} : { groups: signalSettings },
 		linkPreviews,
 		additionalOwnOrigins,
+		...menuText === void 0 ? {} : { menuButton: { text: menuText } },
 		...lifecycle === void 0 ? {} : { attachmentLifecycle: {
 			entity: String(lifecycle.entity),
 			action: String(lifecycle.action),
@@ -265,7 +284,7 @@ function sessionSettings(value, issues) {
 		idleResetHours: typeof idleResetHours === "number" && Number.isFinite(idleResetHours) && idleResetHours > 0 ? idleResetHours : false
 	};
 }
-function localizedText(value, path, issues) {
+function localizedText(value, path, issues, maximum = 4e3, safe = true) {
 	if (!isRecord(value) || Object.keys(value).length === 0) {
 		issues.push({
 			message: "must be a non-empty locale-to-text object",
@@ -282,14 +301,14 @@ function localizedText(value, path, issues) {
 				path: [...path, locale]
 			});
 		}
-		if (typeof text !== "string" || text.trim() === "" || text.length > 4e3) issues.push({
-			message: "must be non-empty text of at most 4000 characters",
+		if (typeof text !== "string" || text.trim() === "" || text.length > maximum || safe && typeof text === "string" && isTechnicalText(text)) issues.push({
+			message: `must be ${safe ? "safe " : ""}non-empty text of at most ${maximum} characters`,
 			path: [...path, locale]
 		});
 	}
 	return value;
 }
-function firstContactSettings(value, issues) {
+function firstContactSettings(value, issues, safe = true) {
 	const path = ["firstContact"];
 	const settings = section({
 		value,
@@ -303,7 +322,7 @@ function firstContactSettings(value, issues) {
 		message: "must be non-empty text of at most 200 characters without surrounding whitespace",
 		path: [...path, "version"]
 	});
-	const notice = localizedText(settings.notice, [...path, "notice"], issues);
+	const notice = localizedText(settings.notice, [...path, "notice"], issues, 4e3, safe);
 	return {
 		version: typeof version === "string" ? version : "",
 		notice
@@ -351,7 +370,7 @@ function admissionLimits(value, issues) {
 		workspaceTurnsPerDay: limit(limits?.workspaceTurnsPerDay, DEFAULT_ADMISSION_LIMITS.workspaceTurnsPerDay, [...path, "workspaceTurnsPerDay"])
 	};
 }
-function admissionReplies(value, issues) {
+function admissionReplies(value, issues, safe = true) {
 	const replies = section({
 		value,
 		path: ["replies"],
@@ -359,10 +378,90 @@ function admissionReplies(value, issues) {
 		issues
 	});
 	const configured = {};
-	for (const key of ADMISSION_REPLY_KEYS) if (replies?.[key] !== void 0) configured[key] = localizedText(replies[key], ["replies", key], issues);
+	for (const key of ADMISSION_REPLY_KEYS) if (replies?.[key] !== void 0) configured[key] = localizedText(replies[key], ["replies", key], issues, safe && key.endsWith("Button") ? 24 : 4e3, safe);
 	return configured;
 }
-function validateConfig(input) {
+function telegramTexts(value, issues) {
+	const root = section({
+		value,
+		path: ["texts"],
+		allowed: Object.keys(TELEGRAM_TEXT_KEYS),
+		issues
+	});
+	const output = {};
+	for (const [group, keys] of Object.entries(TELEGRAM_TEXT_KEYS)) {
+		const sectionValue = section({
+			value: root?.[group],
+			path: ["texts", group],
+			allowed: keys,
+			issues
+		});
+		if (sectionValue === void 0) continue;
+		output[group] = {};
+		for (const key of keys) if (sectionValue[key] !== void 0) {
+			const maximum = group === "confirmation" ? key === "question" ? 300 : 24 : group === "callback" ? 200 : group === "authorization" && key === "button" ? 24 : 4e3;
+			output[group][key] = localizedText(sectionValue[key], [
+				"texts",
+				group,
+				key
+			], issues, maximum);
+		}
+	}
+	const confirmation = output.confirmation;
+	if (confirmation?.confirm !== void 0 && confirmation.cancel !== void 0) {
+		const locales = new Set([
+			"en",
+			...Object.keys(confirmation.confirm),
+			...Object.keys(confirmation.cancel)
+		]);
+		for (const locale of locales) {
+			const confirm = localizedText$1(confirmation.confirm, locale);
+			const cancel = localizedText$1(confirmation.cancel, locale);
+			if (typeof confirm === "string" && typeof cancel === "string" && confirm.trim() === cancel.trim()) issues.push({
+				message: "confirm and cancel must have distinct effective localized labels",
+				path: [
+					"texts",
+					"confirmation",
+					"cancel",
+					locale
+				]
+			});
+		}
+	}
+	const authorization = output.authorization;
+	if (authorization?.url !== void 0) for (const [locale, value] of Object.entries(authorization.url)) try {
+		const url = new URL(value);
+		if (!["https:", "http:"].includes(url.protocol) || url.username || url.password) throw new Error("Invalid authorization URL");
+	} catch {
+		issues.push({
+			message: "must be an HTTP(S) URL without credentials",
+			path: [
+				"texts",
+				"authorization",
+				"url",
+				locale
+			]
+		});
+	}
+	if ((authorization?.url !== void 0 || authorization?.button !== void 0) && authorization?.prompt === void 0) issues.push({
+		message: "is required when an authorization button is configured",
+		path: [
+			"texts",
+			"authorization",
+			"prompt"
+		]
+	});
+	if (authorization?.url === void 0 !== (authorization?.button === void 0)) issues.push({
+		message: "url and button must be supplied together",
+		path: ["texts", "authorization"]
+	});
+	return output;
+}
+function isLegacyAgentArchive(version) {
+	return /^0\.(?:[0-9]|1[0-2])\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version ?? "");
+}
+function validateConfig(input, options = {}) {
+	const legacyArchive = isLegacyAgentArchive(options.archiveSdkVersion);
 	const issues = [];
 	const root = section({
 		value: input ?? {},
@@ -376,7 +475,8 @@ function validateConfig(input) {
 			"confirmations",
 			"firstContact",
 			"limits",
-			"replies"
+			"replies",
+			"texts"
 		],
 		issues
 	});
@@ -410,8 +510,8 @@ function validateConfig(input) {
 		allowed: ["mode"],
 		issues
 	})?.mode ?? "deferred";
-	if (mode !== "deferred" && mode !== "held") issues.push({
-		message: "must be \"deferred\" or \"held\"",
+	if (mode !== "deferred" && !(legacyArchive && mode === "held")) issues.push({
+		message: "must be \"deferred\"; Telegram Eve approval buttons are unsupported",
 		path: ["confirmations", "mode"]
 	});
 	const telegram = telegramSettings(channels?.telegram, issues);
@@ -502,9 +602,28 @@ function validateConfig(input) {
 	});
 	const connection = ontology?.connection ?? true;
 	const sessions = sessionSettings(root?.sessions, issues);
-	const firstContact = firstContactSettings(root?.firstContact, issues);
+	const firstContact = firstContactSettings(root?.firstContact, issues, !legacyArchive);
 	const limits = admissionLimits(root?.limits, issues);
-	const replies = admissionReplies(root?.replies, issues);
+	const replies = admissionReplies(root?.replies, issues, !legacyArchive);
+	const texts = telegramTexts(root?.texts, issues);
+	if (!legacyArchive && replies.groupPairingButton !== void 0 && replies.groupPairingRequired === void 0) issues.push({
+		message: "is required when groupPairingButton is configured",
+		path: ["replies", "groupPairingRequired"]
+	});
+	if (telegram !== null && !legacyArchive) {
+		for (const key of ["pairingRequired", "pairingButton"]) if (replies[key] === void 0) issues.push({
+			message: "is required for Telegram",
+			path: ["replies", key]
+		});
+		for (const key of TELEGRAM_TEXT_KEYS.confirmation) if (texts.confirmation?.[key] === void 0) issues.push({
+			message: "is required for Telegram confirmations",
+			path: [
+				"texts",
+				"confirmation",
+				key
+			]
+		});
+	}
 	if (typeof connection !== "boolean") issues.push({
 		message: "must be true or false",
 		path: ["ontology", "connection"]
@@ -524,17 +643,18 @@ function validateConfig(input) {
 			attachments
 		},
 		ontology: { connection: connection === true },
-		confirmations: { mode: mode === "held" ? "held" : "deferred" },
+		confirmations: { mode: "deferred" },
 		sessions,
 		firstContact,
 		limits,
-		replies
+		replies,
+		texts
 	} };
 }
 const configSchema = { "~standard": {
 	version: 1,
 	vendor: "segmentstream",
-	validate: validateConfig,
+	validate: (input) => validateConfig(input),
 	types: void 0
 } };
 function manifestOf(config) {
@@ -542,4 +662,4 @@ function manifestOf(config) {
 	if (validation.issues !== void 0) throw new SegmentStreamAgentConfigError(validation.issues);
 	return validation.value;
 }
-export { ADMISSION_REPLY_KEYS, DEFAULT_ADMISSION_LIMITS, DEFAULT_ATTACHMENTS_MODEL, DEFAULT_DECISION_MODEL, DEFAULT_IMAGE_DESCRIPTION_MODEL, DEFAULT_STT_MODEL, SESSION_SCOPES, SegmentStreamAgentConfigError, TELEGRAM_POLICIES, configSchema, manifestOf, validateConfig };
+export { ADMISSION_REPLY_KEYS, DEFAULT_ADMISSION_LIMITS, DEFAULT_ATTACHMENTS_MODEL, DEFAULT_DECISION_MODEL, DEFAULT_IMAGE_DESCRIPTION_MODEL, DEFAULT_STT_MODEL, SESSION_SCOPES, SegmentStreamAgentConfigError, TELEGRAM_POLICIES, configSchema, isLegacyAgentArchive, manifestOf, validateConfig };

package/dist/extension/extension.d.ts

@@ -4,7 +4,12 @@ export declare const segmentstream: import("eve/extension").ExtensionHandle<{
     readonly "~standard": {
         readonly version: 1;
         readonly vendor: "segmentstream";
-        readonly validate: typeof import("./config.js").validateConfig;
+        readonly validate: (input: unknown) => {
+            readonly value: import("./config.js").SegmentStreamAgentConfig;
+            readonly issues?: undefined;
+        } | {
+            readonly issues: ReadonlyArray<import("./config.js").ConfigIssue>;
+        };
         readonly types: {
             readonly input: import("./config.js").SegmentStreamAgentConfigInput;
             readonly output: import("./config.js").SegmentStreamAgentConfig;
@@ -25,3 +30,4 @@ export { archivedRoutingMessages } from "./lib/group-routing/routing-context.js"
 export { replayRouterPayload } from "./lib/group-routing/replay.js";
 export { conversationState as groupConversationState, conversationAddressing as groupConversationAddressing, type ConversationAnalysis, type ConversationPath, } from "./lib/group-routing/conversation.js";
 export { routingBurst, debounceBurst } from "./lib/group-routing/burst.js";
+export type { TelegramTexts } from "./lib/telegram/texts.js";

package/dist/extension/hooks/authorization.d.ts

@@ -0,0 +1,3 @@
+/** Channel delivery reports the reference; the public hook owns cancellation of the running turn. */
+declare const _default: import("eve/hooks").HookDefinition<"authorization.required">;
+export default _default;

package/dist/extension/hooks/authorization.mjs

@@ -0,0 +1,16 @@
+import { fileURLToPath as __eveFileURLToPath } from "node:url";
+import { dirname as __eveDirname } from "node:path";
+import { createRequire as __eveCreateRequire } from "node:module";
+const __filename = __eveFileURLToPath(import.meta.url);
+__eveDirname(__filename);
+__eveCreateRequire(import.meta.url);
+import { localizedText } from "../lib/admission.mjs";
+import "../lib/telegram/principal.mjs";
+import segmentstream from "../extension.mjs";
+import { confirmationLocale } from "../lib/telegram/confirmation-text.mjs";
+import { defineHook } from "eve/hooks";
+var authorization_default = defineHook({ events: { "authorization.required": (event, context) => {
+	const principal = context.session.auth.current;
+	if (principal?.authenticator === "segmentstream-telegram" && event.data.candidateId === void 0 && localizedText(segmentstream.config.texts?.authorization?.prompt, confirmationLocale(principal)) === void 0) context.cancel();
+} } });
+export { authorization_default as default };

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-Dl-ZJp5p.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/conversations.mjs

@@ -6,7 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { proxyEnvironment } from "./environment.mjs";
 import { runtimeToken } from "./runtime-token.mjs";
-import { r as workflowValue } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { r as workflowValue } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 function collapseConversationEvents(events) {
 	const latest = new Map();
 	for (const event of events) {

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-Dl-ZJp5p.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";