@segmentstream/agent 0.26.1 → 0.28.0

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

@@ -1,5 +1,5 @@
 import { type StructuredInbound, type StructuredMessage, type StructuredResult } from "./structured.js";
-import type { RecentMessage } from "../group-routing/observed.js";
+import type { RecentMessage } from "../group-routing/messages.js";
 import { type GroupPolicy } from "../group-routing/policy.js";
 import type { TelegramSettings } from "../../config.js";
 import { attachmentLifecycle } from "./lifecycle.js";
@@ -12,9 +12,8 @@ import { type AgentChats } from "./chats.js";
 import type { InboundRequest } from "./inbound-request.js";
 import type { ImageDescriber } from "./images.js";
 import type { MediaPlan } from "./media-policy.js";
-import { type ObservedMessages } from "./observed.js";
 import { type RouteDecider } from "./router.js";
-import { type HistoryReader, type SessionPolicy } from "./sessions.js";
+import { type HistoryReader } from "./sessions.js";
 import { type Transcriber } from "./voice.js";
 import { type AttachmentDescriber } from "./attachment-description.js";
 import type { PdfTextExtractor } from "./pdf-text.js";
@@ -30,16 +29,18 @@ import type { PdfTextExtractor } from "./pdf-text.js";
  * 2. Voice becomes text, so the router and the agent read what was said.
  * 3. The router answers or observes. Group files follow the same addressing rules as text;
  *    captionless uploads use smart routing and recent agent requests. Files are stored after the
- *    registry knows the sender. Observing starts no session or typing indication;
- *    the ring carries the stored files' references (or storage failures) into the next reply.
- * 4. The session policy runs on the session an answered message continues: an idle one is cleared, the
- *    first message after the day's compaction time compacts it.
+ *    registry knows the sender. Observing starts no session or typing indication; the
+ *    conversation archive keeps the message and its stored files' references for routing, the
+ *    next turn's chat context and the native images that turn carries.
+ * 4. An answered message continues the session its address names under the configured scope; eve
+ *    compacts and expires sessions itself.
  * 5. An answered message reads the stored attachments in place of the Telegram files.
- * 6. An answered message dispatches as the paired member, with the ring, the registry's `<chat>`
- *    block, a `<speaker>` block naming the member, their roles and the message they replied to and
- *    an `<attachments>` block naming its stored files ahead of it as context. An answered group
- *    message waits for its chat's report first, so that a chat new to the process already carries
- *    its `<chat>` block.
+ * 6. An answered message dispatches as the paired member, with only its own facts as context: a
+ *    `<speaker>` block naming the member, their roles and the message they replied to, its
+ *    `<message_audience>` and an `<attachments>` block naming its stored files. The chat around
+ *    it, observed messages and the registry's `<chat>` guidance, reaches the session once through
+ *    its chat context (`lib/chat-context.ts`). An answered group message waits for its chat's
+ *    report first, so that a chat new to the process already carries its guidance.
  */
 export interface InboundDependencies {
     readonly structured?: {
@@ -49,12 +50,12 @@ export interface InboundDependencies {
     readonly policy: TelegramPolicy;
     readonly decisionModel?: string;
     readonly groups?: GroupPolicy;
+    /** The chat's or forum topic's recent messages from the conversation archive, oldest first. */
     readonly recentConversation?: (chatId: string, threadId?: string) => Promise<ReadonlyArray<RecentMessage>>;
     readonly signalSettings?: TelegramSettings["groups"];
     readonly lifecycle?: (principal: import("eve/context").SessionAuthContext, memberId: string, message: TelegramMessage) => ReturnType<typeof attachmentLifecycle>;
     readonly admission: () => AdmissionSettings;
     readonly sessions: () => SessionSettings;
-    readonly sessionPolicy: SessionPolicy;
     readonly sttModel: string | false;
     readonly attachmentsModel: string | false;
     readonly describeAttachment: AttachmentDescriber;
@@ -73,7 +74,6 @@ export interface InboundDependencies {
     }) => Promise<Uint8Array>;
     /** The attachment store; without it, files reach the turn as eve's Telegram file parts. */
     readonly attachments?: AgentAttachments;
-    readonly observed: ObservedMessages;
     /** Recent session events for smart routing. */
     readonly readHistory: HistoryReader;
     readonly chats: AgentChats;

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

@@ -9,29 +9,28 @@ import { admitMessage, localizedText } from "../admission.mjs";
 import { d as telegramRuntimeSource, n as conversationLanguage, o as telegramPrincipal, u as runtimeEnvelope } from "../../../_chunks/principal-D99Lleae.mjs";
 import { p as reportTelegramError } from "../../../_chunks/inbound-request-D1r0FkDI.mjs";
 import { addressingReason, conversationKey, otherRecipient } from "../group-routing/signals.mjs";
-import { conversationAddressing, conversationState } from "../group-routing/conversation.mjs";
+import { conversationAddressing } from "../group-routing/addressing.mjs";
 import { questionInvitation } from "../group-routing/engagement.mjs";
-import { conversationContext, routeMessage } from "../group-routing/router.mjs";
-import { observedContext } from "../group-routing/observed.mjs";
+import { routeMessage } from "../group-routing/router.mjs";
 import { debounceBurst, routingBurst } from "../group-routing/burst.mjs";
 import { WorkspaceActionAlreadyDispatched } from "./workspace-action.mjs";
 import { structuredMessage } from "./structured.mjs";
-import { evidenceSince, formatAddress, messageAddress, scopedAddress } from "./sessions.mjs";
+import { formatAddress, messageAddress, scopedAddress } from "./sessions.mjs";
 import { AttachmentLifecycleNotPermitted } from "./lifecycle.mjs";
 import { MAXIMUM_NATIVE_IMAGE_BYTES } from "./images.mjs";
 import { MAXIMUM_ROUTING_ATTACHMENT_BYTES, describeRoutingAttachment, routingAttachmentDeadline } from "./attachment-description.mjs";
 import { attachmentUrl } from "../attachments.mjs";
 import { contentShape, messageContent } from "./content.mjs";
 import { messageAudience } from "./audience.mjs";
-import { attachmentKind, messageMetadata } from "./observed.mjs";
-import { telegramSignals } from "./signals.mjs";
+import { attachmentKind, messageMetadata } from "./message-metadata.mjs";
+import { recordGateDecision, recordInboundContent, recordRouteDecision } from "./conversations.mjs";
 import { answerMarker } from "../questions.mjs";
 import { questionAddress, questionFromHistory } from "./confirmations.mjs";
-import { routingContext } from "./routing-context.mjs";
-import { recordGateDecision, recordInboundContent, recordRouteDecision } from "./conversations.mjs";
 import { chatContext } from "./chats.mjs";
+import { telegramSignals } from "./signals.mjs";
 import { attachmentsContext, inboundAttachments, stageFiles } from "./files.mjs";
 import { heldApprovals, releaseHeldApproval } from "./held-approvals.mjs";
+import { routingContext } from "./routing-context.mjs";
 import { voiceOf, voiceText } from "./voice.mjs";
 const MAXIMUM_QUOTE_LENGTH = 500;
 function buttonTo(text, url) {
@@ -68,6 +67,10 @@ function observedMessage(message, text, member, media, bot) {
 		...media ? { media } : {}
 	};
 }
+function observedImages(recent, current) {
+	const answered = recent.findLastIndex((message) => message.admitted === true);
+	return recent.slice(answered + 1).filter((message) => !("role" in message) && message.messageId !== current).flatMap((message) => message.images ?? []);
+}
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -268,7 +271,19 @@ async function handleInboundMessage(input) {
 	const turn = structured === void 0 && input.request?.structuredContext === void 0 && addressed !== void 0 && hasContent && (addressed !== "reply-to-bot" || elsewhere === void 0);
 	const lookup = await resolve(turn);
 	const group = isGroupChat(sent);
-	const chat = conversationKey(signals);
+	const freshConversation = async () => await dependencies.recentConversation?.(sent.chat.id, sent.messageThreadId === void 0 ? void 0 : String(sent.messageThreadId)) ?? [];
+	let archived;
+	const recentConversation = () => archived ??= freshConversation();
+	const languageOf = async (current) => {
+		const own = conversationLanguage([current]);
+		if (own !== void 0) return own;
+		try {
+			return conversationLanguage((await recentConversation()).map((message) => message.text).reverse());
+		} catch (error) {
+			reportTelegramError("conversation_language_unavailable", error, { chatId: sent.chat.id });
+			return;
+		}
+	};
 	const report = group ? dependencies.chats.seen({
 		chatId: sent.chat.id,
 		title: sent.chat.title ?? "",
@@ -349,9 +364,9 @@ async function handleInboundMessage(input) {
 	async function observeRaw() {
 		await recordInboundContent({
 			text,
-			decoded
+			decoded,
+			author: authorOf(sent.from, void 0)
 		});
-		if (group) dependencies.observed.add(chat, observedMessage(sent, text || "[attachment]", void 0, void 0, bot));
 	}
 	if (lookup.status !== "existing" && lookup.status !== "created") {
 		const configuredGroupPairing = lookup.status === "pairing_required" && localizedText(dependencies.admission().replies.groupPairingRequired, sent.from.languageCode) !== void 0;
@@ -360,6 +375,10 @@ async function handleInboundMessage(input) {
 		return null;
 	}
 	let member = lookup.member;
+	const recordContent = (content) => recordInboundContent({
+		...content,
+		author: authorOf(sent.from, member)
+	});
 	if (input.request?.structuredContext !== void 0 && input.request.structuredContext.memberId !== member.id) {
 		recordGateDecision("structured_context_actor_changed");
 		return null;
@@ -393,7 +412,7 @@ async function handleInboundMessage(input) {
 		const principal = telegramPrincipal({
 			message: sent,
 			member,
-			conversationLanguage: conversationLanguage([sent.text || sent.caption, ...dependencies.observed.recent(chat).map((message) => message.text).reverse()])
+			conversationLanguage: await languageOf(sent.text || sent.caption)
 		});
 		input.request.lifecycle = dependencies.lifecycle(principal, member.id, sent);
 		await context.telegram.startTyping();
@@ -481,8 +500,7 @@ async function handleInboundMessage(input) {
 		bot?.firstName,
 		bot?.displayName
 	].filter((n) => !!n)];
-	const freshConversation = async () => dependencies.recentConversation ? dependencies.recentConversation(sent.chat.id, sent.messageThreadId === void 0 ? void 0 : String(sent.messageThreadId)) : dependencies.observed.recent(chat);
-	let conversationRecent = conversationPolicy ? await freshConversation() : dependencies.observed.recent(chat);
+	let conversationRecent = conversationPolicy ? await recentConversation() : [];
 	if (conversationPolicy && input.request && input.request.lifecycleKey === void 0 && input.request.structuredContext === void 0) {
 		address = topicAddress;
 		input.request.address = topicAddress;
@@ -497,26 +515,16 @@ async function handleInboundMessage(input) {
 	});
 	const questionAge = Date.parse(sentAt(sent)) - Date.parse(asked?.meta.at ?? "");
 	if (answering && addressed === void 0 && !questionInvitation(asked?.meta.at, sentAt(sent), groups.smart.engagement.openQuestionMinutes)) answering = false;
-	if (conversationPolicy && answering) {
-		if (!conversationState({
-			signals: policySignals,
-			recent: conversationRecent,
-			policy: groups,
-			agentNames: agentAliases,
-			pendingQuestionAt: asked?.meta.at
-		}).pending_question_live) answering = false;
-	}
 	const recipientAnswer = !conversationPolicy && answering && (groups.smart.engagement.policy === "engaged" || questionAge >= 0 && questionAge <= groups.smart.engagement.followUpMinutes * 6e4) && audience.replyTo?.kind === "bot" && isRecipientAnswer(audience);
 	if (!conversationPolicy && answering && pending !== void 0 && input.request !== void 0) {
 		address = pending.address || (questionSession === void 0 ? topicAddress : memberQuestionAddress);
 		input.request.address = address;
 	}
 	if (input.request?.lifecycleKey === void 0 && input.request?.structuredContext === void 0 && group && (addressed === void 0 && !answering && groups.mode === "mention" || !conversationPolicy && elsewhere !== void 0 && (addressed === void 0 || addressed === "reply-to-bot" && !recipientAnswer))) {
-		await recordInboundContent({
-			text,
+		await recordContent({
+			text: text || (structured === void 0 ? text : `[${structured.kind}]`),
 			decoded
 		});
-		dependencies.observed.add(chat, observedMessage(sent, text || (structured === void 0 ? "[attachment]" : `[${structured.kind}]`), member, void 0, bot));
 		recordRouteDecision("observe", addressed, groups.mode, {
 			reason: elsewhere === void 0 ? "mention_policy" : "other_recipient",
 			note: elsewhere ?? "Mention policy observes unaddressed messages."
@@ -531,7 +539,12 @@ async function handleInboundMessage(input) {
 		await observeRaw();
 		return null;
 	}
-	const mediaPlan = voice !== void 0 || sent.attachments.length > 0 || dependencies.observed.list(chat).some((message) => (message.images?.length ?? 0) > 0) ? await dependencies.mediaPlan?.(member, owner?.id) : void 0;
+	if (group && !conversationPolicy) conversationRecent = (await recentConversation()).filter((message) => message.messageId !== sent.messageId).map(({ signedAuthor, ...message }) => signedAuthor === void 0 ? message : {
+		...message,
+		author: signedAuthor
+	});
+	const carried = observedImages(conversationRecent, sent.messageId);
+	const mediaPlan = voice !== void 0 || sent.attachments.length > 0 || carried.length > 0 ? await dependencies.mediaPlan?.(member, owner?.id) : void 0;
 	if (voice !== void 0 && !group) await transcribeVoice(false);
 	if (voice !== void 0 && mediaPlan?.audio) notes.push("[The chat model supports audio, but this host cannot deliver native audio. The configured speech-to-text fallback was used if enabled.]");
 	if (structured !== void 0) {
@@ -575,7 +588,7 @@ async function handleInboundMessage(input) {
 			address,
 			operations,
 			read: dependencies.history ?? dependencies.readHistory,
-			remembered: conversationPolicy ? conversationRecent : dependencies.observed.recent(chat),
+			remembered: conversationRecent,
 			at: sentAt(sent),
 			questionHistory,
 			questionSessionId: owner?.id
@@ -625,7 +638,7 @@ async function handleInboundMessage(input) {
 		};
 		const evidence = conversationAddressing(routingSignals, conversationRecent, groups, agentAliases);
 		if (!evidence.agent_named && !evidence.reply_to_agent && evidence.human_targets.length === 0) {
-			await recordInboundContent({
+			await recordContent({
 				text,
 				decoded
 			});
@@ -718,7 +731,7 @@ async function handleInboundMessage(input) {
 					...notes
 				].join("\n");
 			} else if (voice !== void 0) media = [...attachmentMetadata, ...notes].join("\n");
-			await recordInboundContent({
+			await recordContent({
 				text,
 				decoded,
 				...processedMedia === void 0 ? {} : { media: processedMedia }
@@ -743,11 +756,10 @@ async function handleInboundMessage(input) {
 	let structuredDispatched = false;
 	if (structured !== void 0 && dependencies.structured !== void 0) {
 		if (route === "observe" || admissionRefused) {
-			await recordInboundContent({
+			await recordContent({
 				text,
 				decoded
 			});
-			if (group) dependencies.observed.add(chat, observedMessage(sent, text, member, media, bot));
 			return null;
 		}
 		if (!await admitTurn(true)) return null;
@@ -813,14 +825,12 @@ async function handleInboundMessage(input) {
 		note: "The configured workspace action admitted this attachment task."
 	});
 	if (admissionRefused) {
-		await recordInboundContent({
+		await recordContent({
 			text,
 			decoded
 		});
-		dependencies.observed.add(chat, observedMessage(sent, text || "[attachment]", member, void 0, bot));
 		return null;
 	}
-	if (group && route === "observe") dependencies.observed.add(chat, observedMessage(sent, text, member, media, bot));
 	if (sent.attachments.length > 0) await report;
 	let files = input.request?.edited && !input.request.attachmentsChanged && (input.request.previousContent?.decoded.length ?? 0) > 0 || sent.attachments.length === 0 || dependencies.attachments === void 0 || input.request === void 0 ? new Map() : await stageFiles({
 		message: sent,
@@ -937,24 +947,24 @@ async function handleInboundMessage(input) {
 	if (input.request !== void 0 && (voice !== void 0 || processedMedia !== void 0)) input.request.text = text;
 	const retainedMedia = processedMedia ?? ([...files.values()].flatMap((file) => file.status === "stored" && file.description !== void 0 ? [file.description] : []).join("\n") || void 0);
 	if (decoded.length === 0) decoded.push(...[...files.values()].flatMap((file) => file.status === "stored" && file.decoded !== void 0 ? [file.decoded] : []));
-	await recordInboundContent({
+	await recordContent({
 		text,
 		decoded,
-		...retainedMedia === void 0 ? {} : { media: retainedMedia }
+		...retainedMedia === void 0 ? {} : { media: retainedMedia },
+		files: [...files.values()].flatMap((file) => file.status === "stored" ? [{
+			id: file.attachment.id,
+			filename: file.attachment.filename,
+			contentType: file.attachment.contentType,
+			size: file.attachment.size,
+			expiresAt: file.attachment.expiresAt,
+			...file.imageInput === "native" ? { image: true } : {}
+		}] : [])
 	});
-	if (route === "observe") {
-		const images = [...files.values()].flatMap((file) => file.status === "stored" && file.imageInput === "native" ? [file.attachment] : []);
-		dependencies.observed.add(chat, {
-			...observedMessage(sent, text === "" ? "[attachment]" : text, member, media, bot),
-			images
-		});
-		return null;
-	}
+	if (route === "observe") return null;
 	if (!structuredDispatched && input.request?.claimTurn !== void 0 && !await input.request.claimTurn()) {
 		recordGateDecision("message_already_handled");
 		return null;
 	}
-	let receivingHistory;
 	if (operations !== void 0 && dependencies.history !== void 0) {
 		let recoverySessionId;
 		try {
@@ -962,7 +972,6 @@ async function handleInboundMessage(input) {
 			if (session !== void 0) {
 				recoverySessionId = session.id;
 				const previous = session.id === owner?.id ? questionHistory : await dependencies.history(session.id);
-				receivingHistory = previous;
 				const recovery = heldApprovals(previous).length === 0 ? void 0 : await releaseHeldApproval({
 					events: await dependencies.history(session.id),
 					now: Date.now(),
@@ -996,24 +1005,6 @@ async function handleInboundMessage(input) {
 		notes.push(`<pending_question>\nTask: ${pending.task}\nQuestion: ${pending.question}\nUse this member's answer to continue the pending task with their current permissions.
 </pending_question>`);
 	}
-	if (operations !== void 0) {
-		const newest = dependencies.observed.list(chat).at(-1);
-		if (await dependencies.sessionPolicy.apply({
-			address,
-			operations,
-			...newest === void 0 ? {} : { activeAt: Date.parse(newest.at) || 0 }
-		}) === "cleared") {
-			dependencies.observed.clear(chat);
-			question = void 0;
-			if (answering && input.request !== void 0) {
-				answering = false;
-				input.request.text = text;
-				const questionNote = notes.findIndex((note) => note.startsWith("<pending_question>"));
-				if (questionNote !== -1) notes.splice(questionNote, 1);
-			}
-		}
-		dependencies.sessionPolicy.delivered(address);
-	}
 	await context.telegram.startTyping();
 	await report;
 	if (input.request !== void 0 && files.size > 0) input.request.files = files;
@@ -1021,7 +1012,7 @@ async function handleInboundMessage(input) {
 		const currentImages = [...files.values()].flatMap((file) => file.status === "stored" && file.imageInput === "native" ? [file.attachment] : []);
 		let remaining = Math.max(0, MAXIMUM_NATIVE_IMAGE_BYTES - currentImages.reduce((sum, file) => sum + file.size, 0));
 		let count = currentImages.length;
-		input.request.extraFiles = dependencies.observed.list(chat).flatMap((message) => (message.images ?? []).flatMap((image) => {
+		input.request.extraFiles = carried.flatMap((image) => {
 			if (Date.parse(image.expiresAt) <= Date.now() || image.size > remaining || count >= 5) {
 				notes.push(`[Earlier image ${JSON.stringify(image.filename)} omitted: expired or native context limit.]`);
 				return [];
@@ -1038,16 +1029,15 @@ async function handleInboundMessage(input) {
 				mediaType: image.contentType,
 				filename: image.filename
 			}];
-		}));
+		});
 	}
-	const language = conversationLanguage([text, ...dependencies.observed.recent(chat).map((message) => message.text).reverse()]);
-	const sharedContext = group ? conversationContext(await conversation(), { since: receivingHistory === void 0 ? void 0 : evidenceSince(receivingHistory) }) : void 0;
+	const language = await languageOf(text);
+	const confirmationReply = (group ? await conversation() : void 0)?.recent.some((entry) => "role" in entry && entry.confirmation !== void 0 && entry.messageId === audience.replyTo?.messageId) === true;
 	const beginTurnDispatch = structuredDispatched ? input.request?.beginStructuredContinuation : input.request?.beginDispatch;
 	if (beginTurnDispatch !== void 0 && !await beginTurnDispatch()) {
 		recordGateDecision("message_already_handled");
 		return null;
 	}
-	dependencies.observed.remember(chat, observedMessage(sent, text, member, retainedMedia, bot));
 	let principal = telegramPrincipal({
 		message: {
 			...sent,
@@ -1056,6 +1046,14 @@ async function handleInboundMessage(input) {
 		member,
 		conversationLanguage: language
 	});
+	const [guidance] = group ? chatContext(dependencies.chats.chat(sent.chat.id)) : [];
+	if (guidance !== void 0) principal = {
+		...principal,
+		attributes: {
+			...principal.attributes,
+			chatGuidance: guidance
+		}
+	};
 	if (conversationPolicy && input.request?.lifecycleKey === void 0 && input.request?.structuredContext === void 0) principal = {
 		...principal,
 		attributes: {
@@ -1109,27 +1107,24 @@ async function handleInboundMessage(input) {
 		},
 		context: [
 			...input.request?.lifecycleContext === void 0 ? [] : [input.request.lifecycleContext],
-			...observedContext(dependencies.observed.take(chat).slice(-groups.smart.context.messages), sharedContext),
-			...group ? chatContext(dependencies.chats.chat(sent.chat.id)) : [],
 			speakerBlock({
 				message: sent,
 				member,
 				bot,
-				omitQuote: group && question?.recent.some((entry) => "role" in entry && entry.confirmation !== void 0 && entry.messageId === audience.replyTo?.messageId)
+				omitQuote: confirmationReply
 			}),
 			"<message_audience>\n" + JSON.stringify({
 				bot_addressed: addressed !== void 0 || answering,
 				bot_tagged: audience.botTagged,
-				reply_target: sharedContext === void 0 ? audience.replyTo : JSON.parse(sharedContext.reply_target),
-				tagged_users: audience.mentions
-			}) + "\nUse these user-ID and rich-mention signals for addressing.\n</message_audience>",
-			"Reply in the member's conversation language. After an action, use at most one short human sentence saying what changed and where, with a link to the record in the app. Confirmations already show their status. Never quote tool output, tool names, record ids, JSON, stack traces or internal errors; explain failures briefly with an error reference when available.",
+				reply_target: confirmationReply && audience.replyTo !== null ? Object.fromEntries(Object.entries(audience.replyTo).filter(([key]) => key !== "text")) : audience.replyTo,
+				tagged_users: audience.mentions,
+				...conversationPolicy ? { engagement_policy: "conversation" } : {}
+			}) + "\n</message_audience>",
 			...attachmentsContext({
 				files,
 				group
 			}),
 			...processedMedia === void 0 ? [] : [processedMedia],
-			...conversationPolicy ? ["If this member declines your involvement or closes the conversation, output exactly [SILENT]. Do not acknowledge the rejection or perform actions."] : [],
 			...notes
 		]
 	};

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

@@ -10,7 +10,7 @@ import { n as currentInboundRequest } from "../../../_chunks/inbound-request-D1r
 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-D_Gqlb5f.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-CMmCRD8l.mjs";
 var AttachmentLifecycleNotPermitted = class extends Error {
 	code = "attachment_lifecycle_not_permitted";
 };

package/dist/extension/lib/telegram/{observed.d.ts → message-metadata.d.ts}

@@ -1,14 +1,10 @@
-import { type ObservedMessages } from "../group-routing/observed.js";
 import type { TelegramMessage } from "eve/channels/telegram";
 import type { BotIdentity } from "./router.js";
-import type { ObservedMessage } from "../group-routing/observed.js";
-export * from "../group-routing/observed.js";
+import type { ObservedMessage } from "../group-routing/messages.js";
 /** Eve represents non-image media as documents; retain the actual Telegram kind in context. */
 export declare function attachmentKind(message: TelegramMessage, file: {
     readonly fileId: string;
     readonly kind: string;
 }): string;
-/** Bounded provider structure, shared by the warm ring and archive reconstruction. No file grants. */
+/** Bounded provider structure, archived with each message for routing. No file grants. */
 export declare function messageMetadata(message: TelegramMessage, bot?: BotIdentity): Pick<ObservedMessage, "invitation" | "kind" | "username" | "replyTo" | "taggedUsers" | "attachmentKinds" | "hasCaption" | "revision">;
-/** Compatibility boundary for callers that used Telegram's former unqualified ring keys. */
-export declare function observedMessages(capacity?: number): ObservedMessages;

package/dist/extension/lib/telegram/{observed.mjs → message-metadata.mjs}

@@ -4,7 +4,6 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { OBSERVED_MESSAGES, agentMessage, currentConfirmationPrompt, observedChatKey, observedContext, observedMessages as observedMessages$1, withConfirmationPrompt } from "../group-routing/observed.mjs";
 import { messageAudience } from "./audience.mjs";
 const PROVIDER_MEDIA_KINDS = [
 	"voice",
@@ -49,16 +48,4 @@ function messageMetadata(message, bot) {
 		}
 	};
 }
-function observedMessages(capacity) {
-	const ring = observedMessages$1(capacity);
-	const key = (value) => /^[a-z][a-z0-9_-]*:/u.test(value) ? value : `telegram:${value.replace(/:/u, "/")}`;
-	return {
-		add: (chat, message) => ring.add(key(chat), message),
-		remember: (chat, message) => ring.remember(key(chat), message),
-		list: (chat) => ring.list(key(chat)),
-		recent: (chat) => ring.recent(key(chat)),
-		take: (chat) => ring.take(key(chat)),
-		clear: (chat) => ring.clear(key(chat))
-	};
-}
-export { OBSERVED_MESSAGES, agentMessage, attachmentKind, currentConfirmationPrompt, messageMetadata, observedChatKey, observedContext, observedMessages, withConfirmationPrompt };
+export { attachmentKind, messageMetadata };

package/dist/extension/lib/telegram/routing-context.d.ts

@@ -1,10 +1,11 @@
-import { type RecentMessage, type PendingConfirmation } from "./observed.js";
+import { type RecentMessage, type PendingConfirmation } from "../group-routing/messages.js";
 import type { HistoryReader, RecordedEvent, SessionOperations } from "./sessions.js";
 import { type PendingQuestion } from "../questions.js";
 export { archivedRoutingMessages } from "../group-routing/routing-context.js";
 /**
- * Recover the agent's questions from the existing session without starting a turn. The local
- * ring supplements this with recipient identities and chatter not written to Eve's stream.
+ * Recover the agent's questions from the existing session without starting a turn. The archived
+ * messages (`remembered`) supplement this with recipient identities and chatter not written to
+ * Eve's stream.
  */
 export declare function routingContext(input: {
     readonly address: string;

package/dist/extension/lib/telegram/routing-context.mjs

@@ -5,11 +5,11 @@ const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
 import "../group-routing/router.mjs";
-import { agentMessage } from "../group-routing/observed.mjs";
+import { agentMessage } from "../group-routing/messages.mjs";
 import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
-import { isSilentReply } from "./silent.mjs";
 import { questionKey } from "../questions.mjs";
 import { questionsFromHistory, routingConfirmationState, routingConfirmations } from "./confirmations.mjs";
+import { isSilentReply } from "./silent.mjs";
 const DELIVERY_CLOCK_TOLERANCE_MS = 6e4;
 async function routingContext(input) {
 	const histories = new Map();

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

@@ -3,11 +3,9 @@ import type { ChannelSource } from "eve/channels";
 import type { TelegramChannelState } from "eve/channels/telegram";
 import type { SessionSettings } from "../../config.js";
 /**
- * Session policy for the Telegram channel (`agent-design.md`, section 4, and docs/agent.md,
- * "Sessions"): what a group session spans, the daily compaction and the idle reset. The policy
- * runs in the webhook route, before eve delivers a message, with the operations the route offers
- * on a continuation address (`resolveSession`, `compact`, `clear`); the history it needs is read
- * from the session's own durable stream, so nothing is stored beside eve.
+ * Telegram session addressing (`agent-design.md`, section 4, and docs/agent.md, "Sessions"): what
+ * a group session spans. Compaction and idle expiry are eve's own: automatic compaction near the
+ * context window and `limits.sessionTimeoutMs` in the workspace's `agent.ts`.
  */
 /** eve's Telegram continuation address: `chat:thread:conversation`, the last two possibly empty. */
 export interface TelegramAddress {
@@ -28,18 +26,7 @@ export declare function messageAddress(message: TelegramMessage): string;
  * eve's own address. A private chat has no anchor either way.
  */
 export declare function scopedAddress(address: string, scope: SessionSettings["scope"]): string;
-/** The most recent `HH:MM` in `timezone` at or before `now`. */
-export declare function compactBoundary(now: Date, compactAt: string, timezone: string): Date;
-/** What the policy knows about one session: from its stream, then kept per process. */
-export interface SessionHistory {
-    /** When the session last did anything. */
-    readonly lastAt: number;
-    /** When its history last started afresh: creation, compaction or clear. */
-    readonly resetAt: number;
-    /** Turns completed since `resetAt`; a compaction is worth nothing before the first. */
-    readonly turnsSinceReset: number;
-}
-/** One recorded event used by session policy, routing context and interaction projections. */
+/** One recorded event used by routing context and interaction projections. */
 export interface RecordedEvent {
     readonly type: string;
     readonly scope?: {
@@ -53,18 +40,8 @@ export interface RecordedEvent {
 }
 /** Session events, oldest first; readers choose a tail or full stream for their consumers. */
 export type HistoryReader = (sessionId: string) => Promise<ReadonlyArray<RecordedEvent>>;
-/** How many events of the tail the reader fetches: enough for a day of a busy group. */
+/** How many events of the tail the adapter's tail reader fetches. */
 export declare const HISTORY_TAIL = 400;
-/** Folds a tail into a history; with no reset marker in it, `resetAt` is its earliest event. */
-export declare function historyOf(events: ReadonlyArray<RecordedEvent>): SessionHistory;
-/**
- * The earliest message time a group turn's conversation evidence still needs: each member
- * message the session took in carried the chat's evidence up to then, and its history keeps it
- * until a compaction or clear. Undefined when the session has none since its last reset, so the
- * turn carries the whole window. Schedule sends and button answers carry no evidence and are
- * skipped; a workspace callback turn is indistinguishable and may hide earlier unseen chatter.
- */
-export declare function evidenceSince(events: ReadonlyArray<RecordedEvent>): number | undefined;
 /** The route's operations on a continuation address, as eve gives them to the handler. */
 export interface SessionOperations {
     readonly resolveSession: (address: string) => Promise<{
@@ -75,29 +52,5 @@ export interface SessionOperations {
     } | undefined>;
     readonly from: (address: string) => {
         readonly send?: ChannelSource<TelegramChannelState>["send"];
-        compact: ChannelSource<TelegramChannelState>["compact"];
-        clear: ChannelSource<TelegramChannelState>["clear"];
     };
 }
-export type SessionAction = "none" | "cleared" | "compacted";
-export interface SessionPolicy {
-    /**
-     * Applies the policy to the session `address` continues, before a message is delivered to it:
-     * clears a history idle for longer than `idleResetHours`, else compacts it once after each
-     * day's `compactAt`. A session that does not exist yet needs neither.
-     */
-    apply(input: {
-        readonly address: string;
-        readonly operations: SessionOperations;
-        /** The newest activity the stream does not show, such as an observed group message. */
-        readonly activeAt?: number;
-        readonly now?: Date;
-    }): Promise<SessionAction>;
-    /** Records that a message was just delivered to the session. */
-    delivered(address: string, now?: Date): void;
-}
-export declare function sessionPolicy(input: {
-    readonly settings: () => SessionSettings;
-    readonly read: HistoryReader;
-    readonly log?: (message: string, error: unknown) => void;
-}): SessionPolicy;