@segmentstream/agent 0.19.1 → 0.20.0

package/README.md

@@ -648,6 +648,26 @@ Recovery applies only to session reads. Dispatch failures are never retried beca
 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`.
+
+Failed model calls with an explicit budget-exhaustion reason select optional
+`texts.notice.modelBudgetExceeded`; known temporary provider failures (rate limits,
+timeouts and unavailable services) select `texts.notice.modelUnavailable`. Both use
+the usual locale fallback and then the existing failure notice (`failed` for turns,
+`recovery` for session failures) when unconfigured. Supply
+budget copy that explains that an administrator must restore the budget before
+retrying, and temporary-outage copy that asks the member to wait before retrying.
+Unknown model failures retain the ordinary notice; raw provider messages and hints
+never become user-facing text. Session recovery failures use the same classification.
+
+The conversation recorder also writes a `model_service_alert` decision for recognized
+model service failures on every channel it can archive, including private HTTP sessions.
+This durable operator alert contains only the safe category, failure code, retry policy
+and ordinary event coordinates. A workspace-wide archive event key limits it to one
+alert per category per UTC day, including across chats, concurrent workers and replays.
+The first insert also emits `[segmentstream] model service alert` in runtime logs.
+Per-turn diagnostics remain available; alerting failures do not replace the original
+error. Read alerts with `segmentstream agent logs --query model_service_alert --all`.
+This does not submit member feedback or send an operator chat message.
 See [the incident and verification procedure](../../docs/telegram-session-recovery.md).
 
 ### Opt-in attachment lifecycle

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

package/dist/_chunks/{inbound-request-Dx1B6Y5r.mjs → inbound-request-gJ5wpsBF.mjs}

@@ -33,6 +33,8 @@ function currentThreadId() {
 function customerCopy(locale = currentLocale()) {
 	return {
 		failed: telegramText("notice", "failed", locale),
+		modelBudgetExceeded: telegramText("notice", "modelBudgetExceeded", locale),
+		modelUnavailable: telegramText("notice", "modelUnavailable", locale),
 		recovery: telegramText("notice", "recovery", locale),
 		attachment: telegramText("notice", "attachment", locale),
 		authorization: telegramText("notice", "authorization", locale),
@@ -60,8 +62,9 @@ function reportTelegramError(operation, error, metadata = {}, secrets = new Set(
 	});
 	return errorId;
 }
-function failureText(_errorId, kind = "failed", _locale = currentLocale()) {
-	return customerCopy(_locale)[kind] ?? (kind === "cancelled" ? "⏹" : "⚠️");
+function failureText(_errorId, kind = "failed", _locale = currentLocale(), fallback = "failed") {
+	const copy = customerCopy(_locale);
+	return copy[kind] ?? (kind === "modelBudgetExceeded" || kind === "modelUnavailable" ? copy[fallback] : void 0) ?? (kind === "cancelled" ? "⏹" : "⚠️");
 }
 function customerText(text, locale = currentLocale()) {
 	if (!isTechnicalText(text)) return text;

package/dist/_chunks/{principal-BnJuWJtk.mjs → principal-DFcIfKSa.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-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest } from "./inbound-request-gJ5wpsBF.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-BnJuWJtk.mjs";
+import "../../_chunks/principal-DFcIfKSa.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-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-DFcIfKSa.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-CZ245Pl3.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-sfCL9qIC.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-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-DFcIfKSa.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,11 +5,12 @@ 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-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-DFcIfKSa.mjs";
 import { n as contentText, t as CONTENT_CAPS } from "../../_chunks/content-cDtVnr8Y.mjs";
 import { conversationEvent, conversations, sessionFailureEventId, summarizeArguments } from "./conversations.mjs";
 import { parseAddress } from "./telegram/sessions.mjs";
 import { completionKind } from "./telegram/silent.mjs";
+import { recordModelServiceAlert } from "./model-service-alert.mjs";
 import { decide } from "eve/ai";
 import { call } from "eve/events";
 function conversationCoordinates(context) {
@@ -105,16 +106,18 @@ function conversationRecorder(archive = conversations(), closing = async (messag
 				resultText: contentText(event.data.output, CONTENT_CAPS.result),
 				errorText: contentText(event.data.error?.message ?? (event.data.outcome === "failed" ? resultErrorMessage(event.data.output) : null), CONTENT_CAPS.error)
 			}));
-		} else if ((event.type === "turn.settled" || event.type === "model.settled" || event.type === "session.ended") && event.data.outcome === "failed") await archive.append(conversationEvent({
-			...base,
-			eventId: event.type === "session.ended" ? sessionFailureEventId(context.session.id) : eventId,
-			kind: "decision",
-			decision: "silent",
-			reason: event.type === "session.ended" ? "session.failed" : event.type,
-			status: "failed",
-			errorText: contentText(event.data.error?.message, CONTENT_CAPS.error)
-		}));
-		else if (event.type === "content.completed" && event.data.kind === "text" && event.data.phase === "reply" && !event.data.interrupted) {
+		} else if ((event.type === "turn.settled" || event.type === "model.settled" || event.type === "session.ended") && event.data.outcome === "failed") {
+			await archive.append(conversationEvent({
+				...base,
+				eventId: event.type === "session.ended" ? sessionFailureEventId(context.session.id) : eventId,
+				kind: "decision",
+				decision: "silent",
+				reason: event.type === "session.ended" ? "session.failed" : event.type,
+				status: "failed",
+				errorText: contentText(event.data.error?.message, CONTENT_CAPS.error)
+			}));
+			if (event.type === "turn.settled" || event.type === "session.ended") await recordModelServiceAlert(archive, base, event.data.error);
+		} else if (event.type === "content.completed" && event.data.kind === "text" && event.data.phase === "reply" && !event.data.interrupted) {
 			const message = typeof event.data.value === "string" ? event.data.value : "";
 			const kind = completionKind(message);
 			const silent = kind !== "reply";

package/dist/extension/lib/model-service-alert.d.ts

@@ -0,0 +1,7 @@
+import { type ConversationEvent, type Conversations } from "./conversations.js";
+/**
+ * The archive is the durable operator alert. Its workspace-wide event key bounds repeated
+ * alerts to one per category per UTC day, across chats, workers and callback replays.
+ * Per-turn diagnostics remain separate. No prompt, provider payload or business data is copied.
+ */
+export declare function recordModelServiceAlert(archive: Conversations, scope: Pick<ConversationEvent, "provider" | "chatId" | "chatType" | "threadId" | "participantIds" | "sessionId" | "turnId" | "at">, error: unknown): Promise<void>;

package/dist/extension/lib/model-service-alert.mjs

@@ -0,0 +1,40 @@
+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 { redactTelegramDiagnostic } from "./telegram/diagnostic-redaction.mjs";
+import { conversationEvent } from "./conversations.mjs";
+import { modelServiceFailure } from "./model-service-failure.mjs";
+async function recordModelServiceAlert(archive, scope, error) {
+	const category = modelServiceFailure(error);
+	if (category === void 0) return;
+	const eventId = `agent:model-service-alert:${category}:${scope.at.slice(0, 10)}`;
+	const diagnostic = {
+		operation: "model_service_alert",
+		category,
+		code: "MODEL_CALL_FAILED",
+		retry: category === "modelBudgetExceeded" ? "after_budget_restored" : "later"
+	};
+	try {
+		if (await archive.append(conversationEvent({
+			...scope,
+			eventId,
+			kind: "decision",
+			decision: "silent",
+			status: "failed",
+			reason: "model_service_alert",
+			argsSummary: JSON.stringify(diagnostic)
+		})) === true) console.error("[segmentstream] model service alert", {
+			eventId,
+			...diagnostic
+		});
+	} catch (error) {
+		console.error("[segmentstream] model service alert archive unavailable", {
+			eventId,
+			error: redactTelegramDiagnostic(error)
+		});
+	}
+}
+export { recordModelServiceAlert };

package/dist/extension/lib/model-service-failure.d.ts

@@ -0,0 +1,4 @@
+/** Safe categories only: provider messages and retry hints never become customer copy. */
+export type ModelServiceFailure = "modelBudgetExceeded" | "modelUnavailable";
+/** Eve's normalized failure, including bounded cause chains retained in its details. */
+export declare function modelServiceFailure(error: unknown): ModelServiceFailure | undefined;

package/dist/extension/lib/model-service-failure.mjs

@@ -0,0 +1,38 @@
+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);
+function modelServiceFailure(error) {
+	const seen = new Set();
+	const messages = [];
+	let modelCall = false;
+	let unavailable = false;
+	function visit(value, depth) {
+		if (depth > 5 || value === null || typeof value !== "object" || seen.has(value)) return;
+		seen.add(value);
+		const failure = value;
+		modelCall ||= failure.code === "MODEL_CALL_FAILED";
+		unavailable ||= [
+			408,
+			429,
+			500,
+			502,
+			503,
+			504
+		].includes(Number(failure.statusCode ?? failure.status));
+		if (typeof failure.message === "string") messages.push(failure.message.slice(0, 4e3));
+		for (const key of [
+			"cause",
+			"error",
+			"details",
+			"lastError"
+		]) visit(failure[key], depth + 1);
+	}
+	visit(error, 0);
+	if (!modelCall) return;
+	if (messages.some((message) => /\bbudget\b.{0,60}\b(?:exceeded|exhausted)\b/iu.test(message) || /\b(?:exceeded|exhausted)\b.{0,60}\bbudget\b/iu.test(message))) return "modelBudgetExceeded";
+	if (unavailable || messages.some((message) => /\b(?:service|provider|temporarily) unavailable\b/iu.test(message) || /\b(?:overloaded|rate limit(?:ed)?|timed out|timeout)\b/iu.test(message))) return "modelUnavailable";
+}
+export { modelServiceFailure };

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-BnJuWJtk.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, u as runtimeEnvelope } from "../../_chunks/principal-DFcIfKSa.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-file-call.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-BnJuWJtk.mjs";
+import { i as memberIdOf, u as runtimeEnvelope } from "../../_chunks/principal-DFcIfKSa.mjs";
 import { isChatPost } from "./chat-post-confirmation.mjs";
 import { actionApproval, confirmations, inputHash } from "./confirmations.mjs";
 import { 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-BnJuWJtk.mjs";
+import { c as compatibleRuntimeEnvelope, i as memberIdOf, r as identityProviderOf, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-DFcIfKSa.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-BnJuWJtk.mjs";
+import { c as compatibleRuntimeEnvelope, d as telegramRuntimeSource, l as principalRuntimeSource, s as RUNTIME_SOURCE_PROTOCOL, u as runtimeEnvelope } from "../../_chunks/principal-DFcIfKSa.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-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-DFcIfKSa.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
 import { OntologyFileUnavailable, ontologyTools } from "./ontology-tools.mjs";

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

@@ -7,14 +7,14 @@ __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-BnJuWJtk.mjs";
+import { n as conversationLanguage, o as telegramPrincipal } from "../../../_chunks/principal-DFcIfKSa.mjs";
 import { object } from "../confirmation-description.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
 import { withDeliveryDiagnostics } from "./delivery-diagnostics.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-Dx1B6Y5r.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-gJ5wpsBF.mjs";
 import { chooseModel } from "../../model.mjs";
 import { groupRoutingHealth } from "../group-routing/health.mjs";
 import { decisionRouter } from "../group-routing/router.mjs";
@@ -23,7 +23,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-CZ245Pl3.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-sfCL9qIC.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { observedMessages } from "./observed.mjs";
 import { expireDeferredCards, handleDeferredCallback, isDeferredCallback } from "./deferred-confirmations.mjs";

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-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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,12 +5,12 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { appOrigin, channelsEnabled, proxyEnvironment } from "../environment.mjs";
-import "../../../_chunks/principal-BnJuWJtk.mjs";
+import "../../../_chunks/principal-DFcIfKSa.mjs";
 import { redactDiagnostic } from "../diagnostics.mjs";
 import { confirmationLocale } from "./confirmation-text.mjs";
 import { inTelegramSendQueue, telegramSendScope } from "./send-queue.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
-import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { d as failureText, f as formattingRefused, l as customerMessage, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { MAXIMUM_PROXY_BODY_BYTES, connectionProxy } from "../connection-proxy.mjs";
 import { ACT_AS_HEADER } from "../ontology-connection.mjs";
 import { AttachmentError, CONVERSATION_HEADER, SESSION_HEADER } from "../attachments.mjs";

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-BnJuWJtk.mjs";
+import { d as telegramRuntimeSource, i as memberIdOf, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-DFcIfKSa.mjs";
 import { object } from "../confirmation-description.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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

@@ -9,7 +9,7 @@ import { proxyEnvironment } from "../environment.mjs";
 import { telegramSendScope } from "./send-queue.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversations } from "../conversations.mjs";
-import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { m as safeTelegramFetch, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { connectionProxy } from "../connection-proxy.mjs";
 import { deferredConfirmations } from "../deferred-confirmations.mjs";
 import { expireDeferredRecord } from "./deferred-confirmations.mjs";

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

@@ -5,12 +5,12 @@ 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-BnJuWJtk.mjs";
+import { i as memberIdOf, o as telegramPrincipal } from "../../../_chunks/principal-DFcIfKSa.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 { conversationEvent } from "../conversations.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { chatPostOperationId, isChatPost } from "../chat-post-confirmation.mjs";
 import { confirmations } from "../confirmations.mjs";

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

@@ -6,7 +6,7 @@ __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { n as contentText, t as CONTENT_CAPS } from "../../../_chunks/content-cDtVnr8Y.mjs";
 import { conversationEvent, sessionFailureEventId } from "../conversations.mjs";
-import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { currentConfirmationPrompt, observedChatKey } from "../group-routing/observed.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
 import { contentShape, messageContent } from "./content.mjs";

package/dist/extension/lib/telegram/customer-text.d.ts

@@ -6,6 +6,8 @@ export declare function currentLocale(): string;
 export declare function currentThreadId(): string | undefined;
 export declare function customerCopy(locale?: string): {
     failed: string | undefined;
+    modelBudgetExceeded: string | undefined;
+    modelUnavailable: string | undefined;
     recovery: string | undefined;
     attachment: string | undefined;
     authorization: string | undefined;
@@ -16,7 +18,7 @@ export declare function customerCopy(locale?: string): {
 };
 /** Original failures stay in operator diagnostics, joined to the public notice by a short reference. */
 export declare function reportTelegramError(operation: string, error: unknown, metadata?: Record<string, unknown>, secrets?: ReadonlySet<string>): string;
-export declare function failureText(_errorId: string, kind?: "failed" | "cancelled" | "recovery" | "attachment" | "authorization" | "response", _locale?: string): string;
+export declare function failureText(_errorId: string, kind?: "failed" | "modelBudgetExceeded" | "modelUnavailable" | "cancelled" | "recovery" | "attachment" | "authorization" | "response", _locale?: string, fallback?: "failed" | "recovery"): string;
 export declare function customerText(text: string, locale?: string): string;
 /** Check what Telegram will display, including hidden link destinations, after removing markup. */
 export declare function customerMessage(text: string, locale?: string): TelegramText;

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-Dx1B6Y5r.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-gJ5wpsBF.mjs";
 export { TelegramDeliveryError, currentLocale, currentThreadId, customerCopy, customerMessage, customerText, failureText, formattingRefused, isTechnicalText, reportTelegramError, safeTelegramFetch, withDeliveryLocale };

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

@@ -5,12 +5,12 @@ 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-BnJuWJtk.mjs";
+import { o as telegramPrincipal } from "../../../_chunks/principal-DFcIfKSa.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 { conversationEvent } from "../conversations.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { agentMessage, observedChatKey, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { CONFIRMATION_TTL_MS, inputHash } from "../confirmations.mjs";
 import { OntologyToolRejected } from "../ontology-tools.mjs";

package/dist/extension/lib/telegram/durable-typing.mjs

@@ -8,7 +8,7 @@ import { channelsEnabled, proxyEnvironment } from "../environment.mjs";
 import { redactTelegramDiagnostic } from "./diagnostic-redaction.mjs";
 import { runtimeToken } from "../runtime-token.mjs";
 import { conversationEvent, conversations } from "../conversations.mjs";
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { connectionProxy } from "../connection-proxy.mjs";
 import { sessions } from "eve/server";
 const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);

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-BnJuWJtk.mjs";
-import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as conversationLanguage } from "../../../_chunks/principal-DFcIfKSa.mjs";
+import { d as failureText, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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-CZ245Pl3.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-sfCL9qIC.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-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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.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-Dx1B6Y5r.mjs";
+import { i as withReplacedText, n as currentInboundRequest, r as runInboundRequest, t as InboundRequest } from "../../../_chunks/inbound-request-gJ5wpsBF.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-BnJuWJtk.mjs";
-import { p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { d as telegramRuntimeSource, n as conversationLanguage, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-DFcIfKSa.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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";

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-BnJuWJtk.mjs";
+import { d as telegramRuntimeSource, l as principalRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-DFcIfKSa.mjs";
 import { object } from "../confirmation-description.mjs";
-import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-Dx1B6Y5r.mjs";
+import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { needsConfirmation } from "../confirmations.mjs";
 import { OntologyActionNotPermitted, actionToolName, ontologyTools } from "../ontology-tools.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-CZ245Pl3.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-sfCL9qIC.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-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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-BnJuWJtk.mjs";
+import { a as rolesOf, i as memberIdOf, n as conversationLanguage, o as telegramPrincipal, r as identityProviderOf, t as TELEGRAM_AUTHENTICATOR } from "../../../_chunks/principal-DFcIfKSa.mjs";
 export { TELEGRAM_AUTHENTICATOR, conversationLanguage, identityProviderOf, memberIdOf, rolesOf, telegramPrincipal };

package/dist/extension/lib/telegram/session-recovery.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-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { createHash } from "node:crypto";
 function missingDeployment(error) {
 	if (!(error instanceof Error) || error.name !== "RunKeyFetchError" || !("status" in error) || error.status !== 404) return false;

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-BnJuWJtk.mjs";
+import "../../../_chunks/principal-DFcIfKSa.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-Dx1B6Y5r.mjs";
+import { a as TelegramDeliveryError, l as customerMessage, o as currentLocale, p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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-BnJuWJtk.mjs";
+import { d as telegramRuntimeSource, u as runtimeEnvelope } from "../../../_chunks/principal-DFcIfKSa.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/texts.d.ts

@@ -3,7 +3,7 @@ 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 notice: readonly ["failed", "modelBudgetExceeded", "modelUnavailable", "recovery", "attachment", "authorization", "response", "connected", "disconnected", "cancelled"];
     readonly authorization: readonly ["prompt", "url", "button"];
 };
 export type TelegramTexts = {

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

@@ -34,6 +34,8 @@ const TELEGRAM_TEXT_KEYS = {
 	],
 	notice: [
 		"failed",
+		"modelBudgetExceeded",
+		"modelUnavailable",
 		"recovery",
 		"attachment",
 		"authorization",

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

@@ -5,11 +5,12 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import { telegramText } from "./texts.mjs";
-import { i as memberIdOf } from "../../../_chunks/principal-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../../_chunks/principal-DFcIfKSa.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-Dx1B6Y5r.mjs";
+import { c as customerCopy, d as failureText, o as currentLocale, p as reportTelegramError, s as currentThreadId } from "../../../_chunks/inbound-request-gJ5wpsBF.mjs";
 import { recordSessionFailure } from "./conversations.mjs";
 import { isSilentRoutingCancellation } from "../group-routing/cancellation.mjs";
+import { modelServiceFailure } from "../model-service-failure.mjs";
 function telegramFailureEvents(input) {
 	return {
 		async "interaction.opened"(fact, context) {
@@ -81,7 +82,7 @@ function telegramFailureEvents(input) {
 				});
 				return;
 			}
-			await channel.telegram.post(failureText(errorId, "failed", confirmationLocale(context.session.auth.current, currentLocale())));
+			await channel.telegram.post(failureText(errorId, modelServiceFailure(event.error) ?? "failed", confirmationLocale(context.session.auth.current, currentLocale())));
 		},
 		async "session.ended"(fact, context) {
 			if (fact.data.outcome !== "failed") return;
@@ -104,7 +105,7 @@ function telegramFailureEvents(input) {
 				failure: event
 			});
 			try {
-				await channel.telegram.post(failureText(errorId, "recovery", locale));
+				await channel.telegram.post(failureText(errorId, modelServiceFailure(event) ?? "recovery", locale, "recovery"));
 			} finally {
 				await recorded;
 			}

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-Dx1B6Y5r.mjs";
+import { p as reportTelegramError } from "../../../_chunks/inbound-request-gJ5wpsBF.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-BnJuWJtk.mjs";
+import { a as rolesOf } from "../_chunks/principal-DFcIfKSa.mjs";
 import { defineDynamic } from "eve";
 import { runs } from "eve/events";
 function chooseModel(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-BnJuWJtk.mjs";
+import { u as runtimeEnvelope } from "../../_chunks/principal-DFcIfKSa.mjs";
 import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DU7WeCIW.mjs";
 import segmentstream from "../extension.mjs";
 import { actionApproval } from "../lib/confirmations.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-BnJuWJtk.mjs";
+import { i as memberIdOf } from "../../_chunks/principal-DFcIfKSa.mjs";
 import { n as workflowToolResult } from "../../_chunks/workflow-serializable-DU7WeCIW.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.19.1",
+  "version": "0.20.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",
@@ -66,7 +66,7 @@
   },
   "dependencies": {
     "@chat-adapter/telegram": "4.41.0",
-    "@segmentstream-cloud/ontology": "0.61.0",
+    "@segmentstream-cloud/ontology": "0.61.1",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.137",
     "csv-parse": "^7.0.3",