@segmentstream/agent 0.12.1 → 0.13.0

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

@@ -5,6 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { effectiveGroupPolicy, groupPolicy } from "../group-routing/policy.mjs";
+import { admitMessage, localizedText } from "../admission.mjs";
 import { conversationLanguage, telegramPrincipal } from "./principal.mjs";
 import { addressingReason, conversationKey, otherRecipient } from "../group-routing/signals.mjs";
 import { conversationAddressing, conversationState } from "../group-routing/conversation.mjs";
@@ -12,7 +13,7 @@ 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 { p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 import { AttachmentLifecycleNotPermitted, startTypingHeartbeat, typingUntilComplete } from "./lifecycle.mjs";
 import { formatAddress, messageAddress, scopedAddress } from "./sessions.mjs";
 import { contentShape, messageContent } from "./content.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;
 }

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

@@ -4,9 +4,9 @@ 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";
 import { object } from "../confirmation-description.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 { needsConfirmation } from "../confirmations.mjs";
 import { OntologyActionNotPermitted, actionToolName, ontologyTools } from "../ontology-tools.mjs";
 var AttachmentLifecycleNotPermitted = class extends Error {

package/dist/extension/lib/telegram/media-policy.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { DEFAULT_IMAGE_DESCRIPTION_MODEL } from "../../config.mjs";
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 function planMedia(capabilities, descriptionModel = null) {
 	if (typeof descriptionModel === "string") return {
 		images: "describe",

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

@@ -9,7 +9,7 @@ import { agentMessage, observedChatKey } from "../group-routing/observed.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { splitTelegramText } from "./format.mjs";
 import { inTelegramSendQueue } from "./send-queue.mjs";
-import { a as TelegramDeliveryError, l as customerMessage, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { a as TelegramDeliveryError, l as customerMessage, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 const SILENT_MARKERS = new Set(["[silent]", "no_reply"]);
 function isSilentReply(text) {
 	return SILENT_MARKERS.has(text.trim().toLowerCase());

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

@@ -0,0 +1,16 @@
+import type { LocalizedText } from "../../config.js";
+export declare const TELEGRAM_TEXT_KEYS: {
+    readonly callback: readonly ["error", "unknown", "forbidden", "expired", "already", "unsupported"];
+    readonly confirmation: readonly ["question", "confirm", "cancel", "edit", "executing", "done", "cancelled", "failed", "expired", "interrupted"];
+    readonly chatPost: readonly ["sent", "uncertain", "historyNotRecorded"];
+    readonly notice: readonly ["failed", "recovery", "attachment", "authorization", "response", "connected", "disconnected", "cancelled"];
+    readonly authorization: readonly ["prompt", "url", "button"];
+};
+export type TelegramTexts = {
+    readonly [Group in keyof typeof TELEGRAM_TEXT_KEYS]?: Partial<Record<(typeof TELEGRAM_TEXT_KEYS)[Group][number], LocalizedText>>;
+};
+/** Bind workspace copy to one webhook or durable event, never to another workspace's request. */
+export declare function withTelegramTexts<T>(texts: TelegramTexts, run: () => T, locale?: () => string): T;
+export declare function telegramText<Group extends keyof TelegramTexts>(group: Group, key: (typeof TELEGRAM_TEXT_KEYS)[Group][number], locale?: string): string | undefined;
+/** A persisted card keeps its original locale even while another member's webhook reconciles it. */
+export declare function withTelegramLocale<T>(locale: string | undefined, run: () => T): T;

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

@@ -0,0 +1,70 @@
+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 "../admission.mjs";
+import { AsyncLocalStorage } from "node:async_hooks";
+const TELEGRAM_TEXT_KEYS = {
+	callback: [
+		"error",
+		"unknown",
+		"forbidden",
+		"expired",
+		"already",
+		"unsupported"
+	],
+	confirmation: [
+		"question",
+		"confirm",
+		"cancel",
+		"edit",
+		"executing",
+		"done",
+		"cancelled",
+		"failed",
+		"expired",
+		"interrupted"
+	],
+	chatPost: [
+		"sent",
+		"uncertain",
+		"historyNotRecorded"
+	],
+	notice: [
+		"failed",
+		"recovery",
+		"attachment",
+		"authorization",
+		"response",
+		"connected",
+		"disconnected",
+		"cancelled"
+	],
+	authorization: [
+		"prompt",
+		"url",
+		"button"
+	]
+};
+const storage = new AsyncLocalStorage();
+function withTelegramTexts(texts, run, locale = () => "en") {
+	return storage.run({
+		texts,
+		locale
+	}, run);
+}
+function telegramText(group, key, locale) {
+	const configured = storage.getStore();
+	const section = configured?.texts[group];
+	return localizedText(section?.[key], locale ?? configured?.locale());
+}
+function withTelegramLocale(locale, run) {
+	const configured = storage.getStore();
+	return configured === void 0 || locale === void 0 ? run() : storage.run({
+		...configured,
+		locale: () => locale
+	}, run);
+}
+export { TELEGRAM_TEXT_KEYS, telegramText, withTelegramLocale, withTelegramTexts };

package/dist/extension/lib/telegram/turn-errors.d.ts

@@ -1,2 +1,2 @@
 import type { TelegramChannelEvents } from "eve/channels/telegram";
-export declare const telegramFailureEvents: Pick<TelegramChannelEvents, "turn.failed" | "turn.cancelled" | "session.failed" | "authorization.completed">;
+export declare const telegramFailureEvents: Pick<TelegramChannelEvents, "turn.failed" | "turn.cancelled" | "session.failed" | "authorization.completed" | "authorization.required">;

package/dist/extension/lib/telegram/turn-errors.mjs

@@ -4,11 +4,41 @@ 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 { memberIdOf } from "./principal.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
-import { c as customerCopy, d as failureText, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-BrWspFw5.mjs";
+import { c as customerCopy, d as failureText, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-BXhiIph-.mjs";
 const telegramFailureEvents = {
+	async "authorization.required"(event, channel, context) {
+		if (event.candidateId !== void 0) return;
+		const locale = confirmationLocale(context.session.auth.current, currentLocale());
+		const prompt = telegramText("authorization", "prompt", locale);
+		const url = telegramText("authorization", "url", locale);
+		const button = telegramText("authorization", "button", locale);
+		if (prompt !== void 0) {
+			const sent = await channel.telegram.post({
+				text: prompt,
+				...url === void 0 || button === void 0 ? {} : { reply_markup: { inline_keyboard: [[{
+					text: button,
+					url
+				}]] } }
+			});
+			if (sent.id) channel.state.pendingAuthMessageIds = {
+				...channel.state.pendingAuthMessageIds,
+				[event.name]: sent.id
+			};
+			return;
+		}
+		const state = channel.state;
+		state.authorizationCancellationTurnId = event.turnId;
+		const errorId = reportTelegramError("authorization_prompt_unconfigured", new Error("texts.authorization.prompt is not configured."), { sessionId: context.session.id });
+		await channel.telegram.post(failureText(errorId, "authorization", locale));
+	},
 	async "turn.cancelled"(event, channel, context) {
+		const state = channel.state;
+		const authorizationTurn = state.authorizationCancellationTurnId;
+		delete state.authorizationCancellationTurnId;
+		if (typeof event.turnId === "string" && authorizationTurn === event.turnId) return;
 		const errorId = reportTelegramError("turn_cancelled", event, {
 			chatId: channel.state.chatId,
 			sessionId: context.session.id,
@@ -37,17 +67,21 @@ const telegramFailureEvents = {
 		const messageId = channel.state.pendingAuthMessageIds?.[event.name];
 		if (event.candidateId !== void 0 || messageId === void 0) return;
 		const locale = confirmationLocale(context.session.auth.current);
-		const copy = customerCopy();
+		const copy = customerCopy(locale);
 		let text = event.outcome === "authorized" ? copy.connected : copy.disconnected;
 		if (event.reason !== void 0) {
 			const errorId = reportTelegramError("authorization_not_completed", event, { chatId: channel.state.chatId });
 			text = failureText(errorId, "authorization", locale);
 		}
-		await channel.telegram.editMessageText({
+		if (text !== void 0) await channel.telegram.editMessageText({
 			messageId,
 			text,
 			replyMarkup: { inline_keyboard: [] }
 		});
+		else await channel.telegram.editMessageReplyMarkup({
+			messageId,
+			replyMarkup: { inline_keyboard: [] }
+		});
 		delete channel.state.pendingAuthMessageIds?.[event.name];
 	}
 };

package/dist/extension/lib/telegram/voice.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 "../connection-proxy.mjs";
 import { gateway, transcribe } from "ai";
 const LABELS = {

package/dist/extension/lib/workflow-serializable.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 { n as workflowToolResult, r as workflowValue, t as toWorkflowSerializable } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult, r as workflowValue, t as toWorkflowSerializable } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 export { toWorkflowSerializable, workflowToolResult, workflowValue };

package/dist/extension/schedules/confirmations.mjs

@@ -27,7 +27,7 @@ var confirmations_default = defineSchedule({
 				auth: null,
 				turnPolicy: "queue"
 			});
-		}, {}, settings);
+		}, {}, settings, segmentstream.config.texts);
 	}
 });
 export { confirmations_default as default };

package/dist/extension/tools/attachments_discard.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 { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import { ID_INPUT, attachmentForModel, attachmentOwner, stringArgument, toolAttachments } from "../lib/attachment-tools.mjs";
 import { defineTool } from "eve/tools";
 var attachments_discard_default = defineTool({

package/dist/extension/tools/attachments_list.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 { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import { attachmentForModel, attachmentOwner, toolAttachments } from "../lib/attachment-tools.mjs";
 import { defineTool } from "eve/tools";
 var attachments_list_default = defineTool({

package/dist/extension/tools/attachments_promote.mjs

@@ -4,13 +4,15 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
+import segmentstream from "../extension.mjs";
 import { actionApproval } from "../lib/confirmations.mjs";
 import { ontologyTools, promotionTarget } from "../lib/ontology-tools.mjs";
 import { attachmentForModel, attachmentOwner, optionalObject, optionalString, stringArgument, toolAttachments } from "../lib/attachment-tools.mjs";
 import { defineTool } from "eve/tools";
 var attachments_promote_default = defineTool({
 	approval: actionApproval({
+		texts: () => segmentstream.config.texts ?? {},
 		labels: (memberId, _tool, input) => {
 			const target = promotionTarget(input);
 			return ontologyTools().labels(memberId, target.action, target.input);

package/dist/extension/tools/attachments_read.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 { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import { ID_INPUT, attachmentOwner, headerArgument, optionalString, pageInteger, readOutput, stringArgument, toolAttachments } from "../lib/attachment-tools.mjs";
 import { readStoredFile } from "../lib/stored-files.mjs";
 import { defineTool } from "eve/tools";

package/dist/extension/tools/attachments_send.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 { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import segmentstream from "../extension.mjs";
 import { sendAttachments, sendAttachmentsInput } from "../lib/telegram/attachments-send.mjs";
 import { defineTool } from "eve/tools";

package/dist/extension/tools/attachments_table.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 { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import { readSheets, typedTable } from "../lib/attachment-tables.mjs";
 import { queryTable } from "../lib/attachment-query.mjs";
 import { ID_INPUT, attachmentForModel, attachmentOwner, boundedResultPage, headerArgument, optionalString, pageInteger, stringArgument, toolAttachments } from "../lib/attachment-tools.mjs";

package/dist/extension/tools/ontology.mjs

@@ -123,7 +123,7 @@ var ontology_default = defineDynamic({ events: { "turn.started": async (_event,
 				required: ["name"],
 				additionalProperties: false
 			},
-			execute: (input, ctx) => executeDeferredTool(memberId, input.name, input.arguments ?? {}, ctx)
+			execute: (input, ctx) => executeDeferredTool(memberId, input.name, input.arguments ?? {}, ctx, { texts: () => segmentstream.config.texts ?? {} })
 		})
 	};
 } } });

package/dist/extension/tools/questions_ask.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { memberIdOf } from "../lib/telegram/principal.mjs";
-import { n as workflowToolResult } from "../../_chunks/workflow-serializable-BxrXgxjc.mjs";
+import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import { pendingQuestions, questionKey } from "../lib/questions.mjs";
 import { stringArgument } from "../lib/attachment-tools.mjs";
 import { defineTool } from "eve/tools";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "Mount a SegmentStream workspace's agent on eve: the ontology as tools, acting as the member who writes, and Telegram through the workspace's connection.",
   "license": "Apache-2.0",
   "author": "SegmentStream",
@@ -62,7 +62,7 @@
   },
   "dependencies": {
     "@chat-adapter/telegram": "4.41.0",
-    "@segmentstream-cloud/ontology": "0.48.1",
+    "@segmentstream-cloud/ontology": "0.49.0",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.128",
     "csv-parse": "^7.0.3",

package/dist/extension/connections/ontology.d.ts

@@ -1,7 +0,0 @@
-/**
- * `segmentstream__ontology`: the ontology's MCP tools, acting as the member of each turn. It is
- * resolved per turn because a group chat's session serves several members; a turn without a
- * paired member, or a mount with `ontology.connection: false`, gets no connection.
- */
-declare const _default: import("eve").DynamicSentinel<import("eve/connections").DynamicConnectionResult>;
-export default _default;

package/dist/extension/connections/ontology.mjs

@@ -1,11 +0,0 @@
-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 segmentstream from "../extension.mjs";
-import { ontologyConnectionForTurn } from "../lib/ontology-connection.mjs";
-import { defineDynamic } from "eve/connections";
-var ontology_default = defineDynamic({ events: { "turn.started": (_event, context) => segmentstream.config.ontology.connection && segmentstream.config.confirmations.mode === "held" ? ontologyConnectionForTurn({ principal: context.session.auth.current }) : null } });
-export { ontology_default as default };