@segmentstream/agent 0.22.4 → 0.22.6

package/README.md

@@ -874,3 +874,18 @@ later changes are delivered. Active means its published generation is usable; it
 does not prove that the warehouse has every recent write. Use the reported source
 freshness watermark when reading aggregates. Initial copies and replay remain
 unavailable until their required verification and publication finish.
+
+### Exact-post preview wording
+
+`texts.chatPost.previewPrivate` and `previewGroup` optionally provide localized
+confirmation headings for Telegram private chats and groups. Templates substitute
+`{recipient}`, `{signature}` and `{provider}` from the resolved, frozen preview;
+substituted values are literal text. The exact message and its attribution remain
+visible below the heading. Without a template the existing destination heading
+is preserved. A heading that makes the complete card too long is rejected before
+posting; it never truncates the preview.
+
+Recovered Telegram sessions retain their recovery continuation while awaiting a
+confirmation or an answer. They do not alias the original inbox, whose predecessor
+may still own its durable hook. Confirmation callbacks retain the recorded owner
+and the usual requester, expiry and idempotency checks.

package/dist/_chunks/{build-metadata-Bx4wUFu7.mjs → build-metadata-C9CHlcKU.mjs}

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-var version = "0.22.4";
+var version = "0.22.6";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

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-Bx4wUFu7.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-C9CHlcKU.mjs";
 export { agentBuild };

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

@@ -24,7 +24,7 @@ import { MAXIMUM_DOWNLOAD_BYTES, connectionProxy } from "../connection-proxy.mjs
 import { dispatchStructuredMessage, structuredMessage } from "./structured.mjs";
 import { scopedAddress, sessionPolicy } from "./sessions.mjs";
 import { handleWorkspaceCallback, isWorkspaceCallback } from "./callbacks.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Bx4wUFu7.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-C9CHlcKU.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { observedMessages } from "./observed.mjs";
 import { expireDeferredCards, handleDeferredCallback, isDeferredCallback } from "./deferred-confirmations.mjs";

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

@@ -29,9 +29,10 @@ function chatPostCard(description, copy) {
 	const preview = description.chatPost;
 	if (preview === void 0) throw new Error("An exact chat preview is required.");
 	const base = renderConfirmation(description, copy);
+	const destination = telegramText("chatPost", preview.externalId.startsWith("-") ? "previewGroup" : "previewPrivate")?.replace(/\{(recipient|signature|provider)\}/gu, (_, key) => key === "recipient" ? preview.title : key === "signature" ? preview.attribution : preview.provider);
 	const text = [
 		base.text,
-		`${preview.title} (${preview.provider})`,
+		destination ?? `${preview.title} (${preview.provider})`,
 		...preview.replyTo === null ? [] : [preview.replyTo]
 	].map(escapeMarkdownV2).join("\n") + `\n\n${preview.finalText}`;
 	const receiptSpace = RECEIPT_DATA_SPACE + Math.max(...["sent", "uncertain"].map((status) => escapeMarkdownV2(telegramText("chatPost", status) ?? "").length)) + escapeMarkdownV2(telegramText("chatPost", "historyNotRecorded") ?? "").length;

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

@@ -21,6 +21,7 @@ import { call } from "eve/events";
 import { createHash } from "node:crypto";
 import { telegramTextLinks } from "@segmentstream-cloud/ontology/telegram";
 const PREFIX = "ss-confirm:";
+const recoveredContinuation = (address) => address !== void 0 && /:recovery:[a-f0-9]{64}$/u.test(address);
 function shortHash(value) {
 	return createHash("sha256").update(value).digest("hex").slice(0, 20);
 }
@@ -339,7 +340,7 @@ function telegramConfirmationEvents(archive, observed, deferredOptions) {
 			};
 			const sent = await withConfirmationPrompt(prompt, () => exactPost ? withChatPostCard(text, send, copy.previewLinks) : withConfirmationText(text, send));
 			remember(channel, ctx, sent.id, text, prompt);
-			channel.continuation?.alias(formatAddress({
+			if (!recoveredContinuation(channel.continuation?.token)) channel.continuation?.alias(formatAddress({
 				chatId: channel.telegram.chatId,
 				messageThreadId: String(channel.telegram.messageThreadId ?? ""),
 				conversationId: ""
@@ -447,12 +448,14 @@ function telegramConfirmationEvents(archive, observed, deferredOptions) {
 						...state.pendingQuestions,
 						[questionKey(saved)]: saved
 					};
-					channel.continuation?.alias(formatAddress({
-						chatId: question.chatId,
-						messageThreadId: question.messageThreadId,
-						conversationId: ""
-					}));
-					channel.continuation?.alias(questionAddress(saved));
+					if (!recoveredContinuation(address)) {
+						channel.continuation?.alias(formatAddress({
+							chatId: question.chatId,
+							messageThreadId: question.messageThreadId,
+							conversationId: ""
+						}));
+						channel.continuation?.alias(questionAddress(saved));
+					}
 					const sent = await channel.telegram.post({
 						text: question.question,
 						reply_markup: {

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { runtimeRequestFailure } from "./runtime-request.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Bx4wUFu7.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-C9CHlcKU.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";
 function healthRoute(input) {

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

@@ -10,7 +10,7 @@ import { n as currentInboundRequest, p as reportTelegramError } from "../../../_
 import { member } from "../actor.mjs";
 import { needsConfirmation } from "../confirmations.mjs";
 import { OntologyActionNotPermitted, actionToolName, ontologyTools } from "../ontology-tools.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Bx4wUFu7.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-C9CHlcKU.mjs";
 var AttachmentLifecycleNotPermitted = class extends Error {
 	code = "attachment_lifecycle_not_permitted";
 };

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

@@ -2,7 +2,7 @@ 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 chatPost: readonly ["sent", "uncertain", "historyNotRecorded", "previewPrivate", "previewGroup"];
     readonly notice: readonly ["failed", "modelBudgetExceeded", "modelUnavailable", "recovery", "attachment", "authorization", "response", "connected", "disconnected", "cancelled"];
     readonly authorization: readonly ["prompt", "url", "button"];
 };

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

@@ -30,7 +30,9 @@ const TELEGRAM_TEXT_KEYS = {
 	chatPost: [
 		"sent",
 		"uncertain",
-		"historyNotRecorded"
+		"historyNotRecorded",
+		"previewPrivate",
+		"previewGroup"
 	],
 	notice: [
 		"failed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.22.4",
+  "version": "0.22.6",
   "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",
@@ -66,7 +66,7 @@
   },
   "dependencies": {
     "@chat-adapter/telegram": "4.41.0",
-    "@segmentstream-cloud/ontology": "0.68.2",
+    "@segmentstream-cloud/ontology": "0.68.3",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.137",
     "csv-parse": "^7.0.3",