@segmentstream/agent 0.17.3 → 0.17.6

package/README.md

@@ -615,7 +615,7 @@ Eve resolution, so member/topic routing survives a cold start. No second provide
 
 ## Release and migration
 
-The coordinated release uses Agent SDK 0.17.3, Eve 0.76.3, Ontology SDK 0.54.0 and App SDK 0.25.0.
+The coordinated release uses Agent SDK 0.17.6, Eve 0.76.3, Ontology SDK 0.54.2 and App SDK 0.25.0.
 The compatible Cloud archive/API must be deployed first; migrations run only through its CI/CD gate.
 Publish the ontology SDK before the agent SDK. Upgrade the workspace ontology before its agent,
 with the declared Telegram provider mapping and explicit `agent_chat:post_message` grant.
@@ -628,6 +628,23 @@ disables posting while preserving archive claims and deduplication tombstones;
 it never restores relay or retries uncertain deliveries.
 See [migration and verification](../../docs/agent-chat-delivery-migration.md).
 
+### Deleted session deployments
+
+If Eve's session lookup raises `RunKeyFetchError` with HTTP 404 and Vercel's
+`not_found` / `Deployment not found.` response, the Telegram adapter records the
+original diagnostic and uses a fresh continuation scoped to the serving deployment.
+The smart gate still decides whether to reply; observing a message creates no session
+and sends no failure notice. Independent requests and cold starts select the same
+replacement. Healthy sessions continue across deployments as before. Once an address
+needs recovery, later deployments start it fresh; archived conversation context remains
+available, but the inaccessible session's model history and pending inputs cannot migrate.
+
+Recovery applies only to session reads. Dispatch failures are never retried because
+the inbox may already have accepted them. Other provider errors propagate to operator
+diagnostics. A group receives a failure notice only after routing selected a reply or
+a workspace hook acknowledged the task. Notice wording comes from workspace `texts.notice`.
+See [the incident and verification procedure](../../docs/telegram-session-recovery.md).
+
 ### Opt-in attachment lifecycle
 
 `channels.telegram.attachmentLifecycle: { entity, action }` selects a permitted,

package/dist/_chunks/{build-metadata-Cq47dn8C.mjs → build-metadata-BkfakQLL.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.17.3";
+var version = "0.17.6";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

package/dist/_chunks/{inbound-request-RIRNBxUC.mjs → inbound-request-DxRm5LC8.mjs}

@@ -253,6 +253,7 @@ var InboundRequest = class {
 	previousContent;
 	claimRevision;
 	deliveryFailed;
+	engaged = false;
 	claimTurn;
 	beginDispatch;
 	finishClaim;

package/dist/_chunks/{principal-MEMlG3EG.mjs → principal-B6u41vIf.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 currentInboundRequest } from "./inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest } from "./inbound-request-DxRm5LC8.mjs";
 import { randomUUID } from "node:crypto";
 function telegramRuntimeSource(message, files, callbackQueryId) {
 	const attachments = [];

package/dist/extension/hooks/authorization.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { localizedText } from "../lib/admission.mjs";
-import "../../_chunks/principal-MEMlG3EG.mjs";
+import "../../_chunks/principal-B6u41vIf.mjs";
 import { confirmationLocale } from "../lib/telegram/confirmation-text.mjs";
 import segmentstream from "../extension.mjs";
 import { defineHook } from "eve/hooks";

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import { runtimeToken } from "./runtime-token.mjs";
 import { agentAttachments } from "./attachments.mjs";
 import { telegramConversation } from "./telegram/files.mjs";

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

package/dist/extension/lib/confirmations.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { withTelegramTexts } from "./telegram/texts.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.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";

package/dist/extension/lib/conversation-runtime.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { ENDS_CONVERSATION_INSTRUCTIONS } from "./group-routing/conversation-prompt.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import { n as contentText, t as CONTENT_CAPS } from "../../_chunks/content-CvFsrmSD.mjs";
 import { conversationEvent, conversations, sessionFailureEventId, summarizeArguments } from "./conversations.mjs";
 import { parseAddress } from "./telegram/sessions.mjs";

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf, l as principalRuntimeSource, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf, l as principalRuntimeSource, u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { humanText, object } from "./confirmation-description.mjs";
 import { runtimeToken } from "./runtime-token.mjs";

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 import { runtimeToken, tokenExpiry } from "./runtime-token.mjs";
 import { CHAT_POST_ENVELOPE, chatPostDigest, chatPostOperationId, isChatPost } from "./chat-post-confirmation.mjs";
 import { actionApproval, confirmations } from "./confirmations.mjs";

package/dist/extension/lib/ontology-gateway.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 { i as memberIdOf, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf, u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 import { object } from "./confirmation-description.mjs";
 import { readOntologyMetadata } from "./ontology-metadata-read.mjs";
 async function ontologyMetadata(memberId, operation, input, context, options = {}) {

package/dist/extension/lib/ontology-metadata-read.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
 import { OntologyToolRejected, ontologyTools } from "./ontology-tools.mjs";

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin } from "./environment.mjs";
-import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { describeConfirmation, object } from "./confirmation-description.mjs";
 import { runtimeToken } from "./runtime-token.mjs";

package/dist/extension/lib/runtime-envelope.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 { c as compatibleRuntimeEnvelope, d as telegramRuntimeSource, l as principalRuntimeSource, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { c as compatibleRuntimeEnvelope, d as telegramRuntimeSource, l as principalRuntimeSource, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 export { RUNTIME_SOURCE_PROTOCOL, compatibleRuntimeEnvelope, principalRuntimeSource, runtimeEnvelope, telegramRuntimeSource };

package/dist/extension/lib/stored-files.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 { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
 import { ontologyTools } from "./ontology-tools.mjs";

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

@@ -7,10 +7,10 @@ __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 { n as conversationLanguage, o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { n as conversationLanguage, o as telegramPrincipal } from "../../../_chunks/principal-B6u41vIf.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, o as currentLocale, p as reportTelegramError, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-RIRNBxUC.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-DxRm5LC8.mjs";
 import { chooseModel } from "../../model.mjs";
 import { groupRoutingHealth } from "../group-routing/health.mjs";
 import { decisionRouter } from "../group-routing/router.mjs";
@@ -20,7 +20,7 @@ import { archivedRoutingMessages } from "../group-routing/routing-context.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-Cq47dn8C.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { observedMessages } from "./observed.mjs";
 import { expireDeferredCards, handleDeferredCallback, isDeferredCallback } from "./deferred-confirmations.mjs";
@@ -38,6 +38,7 @@ import { gatewayMediaCapabilities, planMedia } from "./media-policy.mjs";
 import { agentChats } from "./chats.mjs";
 import { downloadTelegramFile, gatewayTranscriber } from "./voice.mjs";
 import { handleInboundMessage } from "./inbound.mjs";
+import { recoverableSessions } from "./session-recovery.mjs";
 import { TELEGRAM_PLACEHOLDER_TOKEN, TELEGRAM_PROXY_ORIGIN, telegramProxyFetch } from "./proxy-fetch.mjs";
 import { healthRoute } from "./health.mjs";
 import { telegramFailureEvents } from "./turn-errors.mjs";
@@ -318,7 +319,11 @@ function segmentstreamTelegram(options) {
 				}
 				const errorId = reportTelegramError("inbound_message_failed", error, { chatId: message.chat.id });
 				if (inbound?.retryReference !== void 0 || inbound?.lifecycleKey !== void 0 || inbound?.structuredContext !== void 0) inbound.retryReference = errorId;
-				else await context.telegram.post(failureText(errorId));
+				else if (message.chat.type === "private" || inbound?.engaged === true) try {
+					await context.telegram.post(failureText(errorId));
+				} catch (noticeError) {
+					reportTelegramError("inbound_failure_notice_failed", noticeError, { errorId });
+				}
 				return null;
 			} finally {
 				inbound?.stopTyping?.();
@@ -446,6 +451,7 @@ function segmentstreamTelegram(options) {
 	return {
 		...channel,
 		async receive(input, operations) {
+			operations = recoverableSessions(operations, environment.VERCEL_DEPLOYMENT_ID, readHistory);
 			const target = input.target;
 			if (target.confirmationSessionId !== void 0) {
 				const address = target.confirmationAddress;
@@ -480,7 +486,8 @@ function segmentstreamTelegram(options) {
 			route,
 			options,
 			environment,
-			capture
+			capture,
+			readHistory
 		})), healthRoute({
 			chats,
 			...options.groups === void 0 ? {} : { routing: groupRoutingHealth },
@@ -506,6 +513,10 @@ function gatedRoute(input) {
 		handler: async (request, args) => {
 			if (!channelsEnabled(environment)) return new Response("ok");
 			if (options.settings() === null) return new Response("not found", { status: 404 });
+			args = {
+				...args,
+				...recoverableSessions(args, environment.VERCEL_DEPLOYMENT_ID, input.readHistory)
+			};
 			let description;
 			const describe = () => description ??= args.describe();
 			const inbound = new InboundRequest(async () => (await describe()).description ?? "", async () => (await describe()).name);

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

@@ -5,11 +5,11 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin, channelsEnabled, proxyEnvironment } from "../environment.mjs";
-import "../../../_chunks/principal-MEMlG3EG.mjs";
+import "../../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "../diagnostics.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { inTelegramSendQueue, telegramSendScope } from "./send-queue.mjs";
-import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { MAXIMUM_PROXY_BODY_BYTES, connectionProxy } from "../connection-proxy.mjs";
 import { ACT_AS_HEADER } from "../ontology-connection.mjs";

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

@@ -6,9 +6,9 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { admitMessage } from "../admission.mjs";
 import { telegramText } from "./texts.mjs";
-import { d as telegramRuntimeSource, i as memberIdOf, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { d as telegramRuntimeSource, i as memberIdOf, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { object } from "../confirmation-description.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { workspaceAction } from "./workspace-action.mjs";
 import { formatAddress, parseAddress, scopedAddress } from "./sessions.mjs";
 const isWorkspaceCallback = (data) => data?.startsWith("ws:") === true;

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

@@ -7,7 +7,7 @@ __eveCreateRequire(import.meta.url);
 import { withTelegramTexts } from "./texts.mjs";
 import { proxyEnvironment } from "../environment.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
-import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
 import { deferredConfirmations } from "../deferred-confirmations.mjs";

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

@@ -5,11 +5,11 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText } from "./texts.mjs";
-import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
 import { chatPostOperationId, isChatPost } from "../chat-post-confirmation.mjs";

package/dist/extension/lib/telegram/conversations.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 currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { n as contentText, t as CONTENT_CAPS } from "../../../_chunks/content-CvFsrmSD.mjs";
 import { currentConfirmationPrompt, observedChatKey } from "../group-routing/observed.mjs";
 import { conversationEvent, sessionFailureEventId } from "../conversations.mjs";

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

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

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

@@ -5,11 +5,11 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText, withTelegramLocale } from "./texts.mjs";
-import { o as telegramPrincipal } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { o as telegramPrincipal } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { humanText } from "../confirmation-description.mjs";
 import { renderConfirmation, withConfirmationText } from "./confirmation-text.mjs";
 import { chatPostCard, chatPostCardStatus, chatPostReceipt, withChatPostCard } from "./chat-post-card.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { conversationEvent } from "../conversations.mjs";
 import { CONFIRMATION_TTL_MS, inputHash } from "../confirmations.mjs";

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

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

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

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../../_chunks/build-metadata-Cq47dn8C.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";

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

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { gateway, generateText } from "ai";
 const MAXIMUM_IMAGE_DESCRIPTION_BYTES = 5242880;
 const MAXIMUM_NATIVE_IMAGE_BYTES = 3145728;

package/dist/extension/lib/telegram/inbound-request.d.ts

@@ -55,6 +55,8 @@ export declare class InboundRequest {
     /** Claims one edit revision before routing, including revisions the classifier observes. */
     claimRevision: (() => Promise<boolean>) | undefined;
     deliveryFailed: ((error: unknown) => Promise<void>) | undefined;
+    /** Routing chose a reply, or the workspace already acknowledged this task. */
+    engaged: boolean;
     /** Atomic per-message admission in the platform archive, after authentication and routing. */
     claimTurn: (() => Promise<boolean>) | undefined;
     /** Finalize the reservation only after the durable inbox acknowledges delivery. */

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

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

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

@@ -6,8 +6,8 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { effectiveGroupPolicy, groupPolicy } from "../group-routing/policy.mjs";
 import { admitMessage, localizedText } from "../admission.mjs";
-import { d as telegramRuntimeSource, n as conversationLanguage, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-MEMlG3EG.mjs";
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { d as telegramRuntimeSource, n as conversationLanguage, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-B6u41vIf.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { addressingReason, conversationKey, otherRecipient } from "../group-routing/signals.mjs";
 import { conversationAddressing, conversationState } from "../group-routing/conversation.mjs";
 import { questionInvitation } from "../group-routing/engagement.mjs";
@@ -407,24 +407,27 @@ async function handleInboundMessage(input) {
 			input.request.lifecycleKey = admitted.key;
 			input.request.replyTo = admitted.replyTo ?? sent.messageId;
 			if (admitted.key === void 0) input.request.lifecycle = void 0;
-			if (admitted.acknowledgement) try {
-				await context.telegram.post({
-					text: admitted.acknowledgement,
-					reply_parameters: { message_id: Number(input.request.replyTo) }
-				});
-				console.info("[segmentstream] telegram.phase", {
-					phase: "acknowledged",
-					at: new Date().toISOString(),
-					traceId: input.request.traceId,
-					intakeId: admitted.key,
-					chatId: sent.chat.id,
-					messageId: sent.messageId
-				});
-			} catch (error) {
-				reportTelegramError("intake_acknowledgement_failed", error, {
-					chatId: sent.chat.id,
-					messageId: sent.messageId
-				});
+			if (admitted.acknowledgement) {
+				input.request.engaged = true;
+				try {
+					await context.telegram.post({
+						text: admitted.acknowledgement,
+						reply_parameters: { message_id: Number(input.request.replyTo) }
+					});
+					console.info("[segmentstream] telegram.phase", {
+						phase: "acknowledged",
+						at: new Date().toISOString(),
+						traceId: input.request.traceId,
+						intakeId: admitted.key,
+						chatId: sent.chat.id,
+						messageId: sent.messageId
+					});
+				} catch (error) {
+					reportTelegramError("intake_acknowledgement_failed", error, {
+						chatId: sent.chat.id,
+						messageId: sent.messageId
+					});
+				}
 			}
 		} catch (error) {
 			input.request.lifecycle = void 0;
@@ -749,6 +752,7 @@ async function handleInboundMessage(input) {
 			return conversation();
 		}
 	});
+	if (route === "reply" && input.request !== void 0) input.request.engaged = true;
 	let structuredDispatched = false;
 	if (structured !== void 0 && dependencies.structured !== void 0) {
 		if (route === "observe" || admissionRefused) {

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

@@ -4,12 +4,12 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { d as telegramRuntimeSource, l as principalRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { d as telegramRuntimeSource, l as principalRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { object } from "../confirmation-description.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { needsConfirmation } from "../confirmations.mjs";
 import { OntologyActionNotPermitted, actionToolName, ontologyTools } from "../ontology-tools.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-Cq47dn8C.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
 var AttachmentLifecycleNotPermitted = class extends Error {
 	code = "attachment_lifecycle_not_permitted";
 };

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-RIRNBxUC.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 function planMedia(capabilities, descriptionModel = null) {
 	if (typeof descriptionModel === "string") return {
 		images: "describe",

package/dist/extension/lib/telegram/principal.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 { a as rolesOf, i as memberIdOf, n as conversationLanguage, o as telegramPrincipal, r as identityProviderOf, t as TELEGRAM_AUTHENTICATOR } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { a as rolesOf, i as memberIdOf, n as conversationLanguage, o as telegramPrincipal, r as identityProviderOf, t as TELEGRAM_AUTHENTICATOR } from "../../../_chunks/principal-B6u41vIf.mjs";
 export { TELEGRAM_AUTHENTICATOR, conversationLanguage, identityProviderOf, memberIdOf, rolesOf, telegramPrincipal };

package/dist/extension/lib/telegram/session-recovery.d.ts

@@ -0,0 +1,10 @@
+import type { ChannelReceiveContext } from "eve/channels";
+import type { HistoryReader } from "./sessions.js";
+/**
+ * Eve 0.76.3 cannot resolve/reset an inbox whose metadata key belonged to a deleted deployment.
+ * Recover on a read, before dispatch: independent requests on this deployment use the same fresh
+ * continuation. Healthy addresses keep their owner across deploys. An already broken address
+ * gets a fresh owner on each deployment; the archive remains the source of routing context.
+ * No send is retried: a dispatch error can mean the durable inbox already accepted the message.
+ */
+export declare function recoverableSessions<State>(operations: ChannelReceiveContext<State>, deploymentId: string | undefined, readHistory?: HistoryReader): ChannelReceiveContext<State>;

package/dist/extension/lib/telegram/session-recovery.mjs

@@ -0,0 +1,66 @@
+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 { p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
+import { createHash } from "node:crypto";
+function missingDeployment(error) {
+	if (!(error instanceof Error) || error.name !== "RunKeyFetchError" || !("status" in error) || error.status !== 404) return false;
+	const body = /^Failed to fetch run key for wrun_[\w-]+ \(deployment dpl_[\w-]+\): HTTP 404 [^\n]+? — (.+)$/u.exec(error.message)?.[1];
+	try {
+		const response = JSON.parse(body ?? "");
+		return response?.error?.code === "not_found" && response.error.message === "Deployment not found.";
+	} catch {
+		return false;
+	}
+}
+function recoverableSessions(operations, deploymentId, readHistory) {
+	const replacements = new Map();
+	const readable = new Map();
+	const target = (address) => replacements.get(address) ?? address;
+	async function lookup(address) {
+		const session = await operations.resolveSession(address);
+		if (session !== void 0 && readHistory !== void 0) {
+			let history = readable.get(session.id);
+			if (history === void 0) {
+				history = readHistory(session.id);
+				readable.set(session.id, history);
+			}
+			await history;
+		}
+		return session;
+	}
+	async function resolveSession(address) {
+		try {
+			return await lookup(target(address));
+		} catch (error) {
+			if (!deploymentId || replacements.has(address) || !missingDeployment(error)) throw error;
+			const replacement = `${address}:recovery:${createHash("sha256").update(JSON.stringify([address, deploymentId])).digest("hex")}`;
+			reportTelegramError("session_resume_recovered", error, {
+				address,
+				replacement,
+				deploymentId
+			});
+			replacements.set(address, replacement);
+			return lookup(replacement);
+		}
+	}
+	async function source(address) {
+		await resolveSession(address);
+		return operations.from(target(address));
+	}
+	return {
+		resolveSession,
+		from: (address) => ({
+			send: async (message, options) => (await source(address)).send(message, options),
+			respond: async (responses, options) => (await source(address)).respond(responses, options),
+			cancel: async (options) => (await source(address)).cancel(options),
+			compact: async () => (await source(address)).compact(),
+			clear: async () => (await source(address)).clear(),
+			reset: async (options) => (await source(address)).reset(options)
+		})
+	};
+}
+export { recoverableSessions };

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

@@ -4,11 +4,11 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import "../../../_chunks/principal-MEMlG3EG.mjs";
+import "../../../_chunks/principal-B6u41vIf.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-RIRNBxUC.mjs";
+import { a as TelegramDeliveryError, l as customerMessage, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { agentMessage, observedChatKey } from "../group-routing/observed.mjs";
 const SILENT_MARKERS = new Set(["[silent]", "no_reply"]);
 function isSilentReply(text) {

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

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { STRUCTURED_KINDS } from "./structured-settings.mjs";
-import { d as telegramRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { d as telegramRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { workspaceAction } from "./workspace-action.mjs";
 const record = (value) => {
 	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid structured Telegram object.");

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

@@ -5,9 +5,9 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText } from "./texts.mjs";
-import { i as memberIdOf } from "../../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../../_chunks/principal-B6u41vIf.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
-import { c as customerCopy, d as failureText, o as currentLocale, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-RIRNBxUC.mjs";
+import { c as customerCopy, d as failureText, o as currentLocale, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { recordSessionFailure } from "./conversations.mjs";
 function telegramFailureEvents(input) {
 	return {

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-RIRNBxUC.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import "../connection-proxy.mjs";
 import { gateway, transcribe } from "ai";
 const LABELS = {

package/dist/extension/model.mjs

@@ -5,7 +5,7 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { isPreview } from "./lib/environment.mjs";
-import { a as rolesOf } from "../_chunks/principal-MEMlG3EG.mjs";
+import { a as rolesOf } from "../_chunks/principal-B6u41vIf.mjs";
 import { defineDynamic } from "eve";
 function chooseModel(input) {
 	const { choice } = input;

package/dist/extension/tools/attachments_promote.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 { u as runtimeEnvelope } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { u as runtimeEnvelope } from "../../_chunks/principal-B6u41vIf.mjs";
 import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DVQBWK8p.mjs";
 import segmentstream from "../extension.mjs";
 import { actionApproval } from "../lib/confirmations.mjs";

package/dist/extension/tools/ontology.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 { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import segmentstream from "../extension.mjs";
 import { executeDeferredTool } from "../lib/deferred-confirmations.mjs";
 import { MAXIMUM_ARGUMENTS_FILE_BYTES, ontologyCallArguments } from "../lib/ontology-arguments.mjs";

package/dist/extension/tools/questions_ask.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 { i as memberIdOf } from "../../_chunks/principal-MEMlG3EG.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.17.3",
+  "version": "0.17.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.54.0",
+    "@segmentstream-cloud/ontology": "0.54.2",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.128",
     "csv-parse": "^7.0.3",