@tangle-network/agent-integrations 0.65.1 → 0.67.0

package/dist/conversation-events/index.js

@@ -392,13 +392,13 @@ function isRecord(value) {
 }
 //#endregion
 //#region src/conversation-events/linq-whatsapp.ts
-function object$1(value) {
+function object$2(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function id(value) {
 	return typeof value === "string" && value.length > 0 && value.length <= 256 && !/[\u0000-\u001f\u007f]/.test(value);
 }
-const invalid$3 = (message) => ({
+const invalid$4 = (message) => ({
 	ok: false,
 	code: "invalid_payload",
 	message
@@ -436,25 +436,25 @@ function mediaPart(part) {
 * Keep that customer opaque; never mislabel message.from (our number) as the sender. */
 function normalizeLinqWhatsappConversation(input) {
 	const value = input.payload;
-	if (!object$1(value) || input.type !== `linq-whatsapp.${value.type}`) return invalid$3("Event type does not match the provider envelope");
+	if (!object$2(value) || input.type !== `linq-whatsapp.${value.type}`) return invalid$4("Event type does not match the provider envelope");
 	if (value.type !== "message.received") return {
 		ok: false,
 		code: "unsupported_event",
 		message: "Not an incoming message"
 	};
-	if (!object$1(value.data) || !object$1(value.data.message)) return invalid$3("Read the chat journal to hydrate this historical event");
+	if (!object$2(value.data) || !object$2(value.data.message)) return invalid$4("Read the chat journal to hydrate this historical event");
 	const message = value.data.message;
-	if (!id(value.id) || !id(message.id) || !id(message.chat_id) || !id(message.from) || message.direction !== "inbound") return invalid$3("Incoming message requires a stable identity, conversation and owned destination");
-	if (value.data.chat_id !== void 0 && value.data.chat_id !== message.chat_id) return invalid$3("Chat identity mismatch");
-	if (!Array.isArray(message.parts) || !message.parts.length || message.parts.length > 50) return invalid$3("Invalid message parts");
+	if (!id(value.id) || !id(message.id) || !id(message.chat_id) || !id(message.from) || message.direction !== "inbound") return invalid$4("Incoming message requires a stable identity, conversation and owned destination");
+	if (value.data.chat_id !== void 0 && value.data.chat_id !== message.chat_id) return invalid$4("Chat identity mismatch");
+	if (!Array.isArray(message.parts) || !message.parts.length || message.parts.length > 50) return invalid$4("Invalid message parts");
 	const text = [];
 	const attachments = [];
 	let historyOnly = false;
 	for (const part of message.parts) {
-		if (!object$1(part)) return invalid$3("Invalid message part");
+		if (!object$2(part)) return invalid$4("Invalid message part");
 		if (part.type === "media") {
 			const media = mediaPart(part);
-			if (!media) return invalid$3("Invalid media attachment");
+			if (!media) return invalid$4("Invalid media attachment");
 			attachments.push(media.attachment);
 			if (media.caption) text.push(media.caption);
 			if (!media.attachment.url) historyOnly = true;
@@ -466,7 +466,7 @@ function normalizeLinqWhatsappConversation(input) {
 		};
 	}
 	const occurredAt = typeof message.created_at === "string" ? Date.parse(message.created_at) : NaN;
-	if (!Number.isSafeInteger(occurredAt) || occurredAt < 0) return invalid$3("Invalid message timestamp");
+	if (!Number.isSafeInteger(occurredAt) || occurredAt < 0) return invalid$4("Invalid message timestamp");
 	return {
 		ok: true,
 		event: {
@@ -514,7 +514,7 @@ function timestamp(value) {
 function phone$1(value) {
 	return typeof value === "string" && /^\+[1-9]\d{6,14}$/.test(value);
 }
-const invalid$2 = (message) => ({
+const invalid$3 = (message) => ({
 	ok: false,
 	code: "invalid_payload",
 	message
@@ -545,13 +545,13 @@ function attachment(value) {
 }
 function finish(input, data) {
 	const id = string(data.id), conversation = string(data.conversation), sender = string(data.sender), destination = string(data.destination);
-	if (!id || !conversation || !sender || !destination) return invalid$2("Message identity, conversation, sender and destination are required");
-	if (data.text !== null && data.text !== void 0 && (typeof data.text !== "string" || data.text.length > 1e6)) return invalid$2("Invalid message text");
-	if (data.media !== void 0 && data.media !== null && (!Array.isArray(data.media) || data.media.length > 50)) return invalid$2("Invalid attachment list");
+	if (!id || !conversation || !sender || !destination) return invalid$3("Message identity, conversation, sender and destination are required");
+	if (data.text !== null && data.text !== void 0 && (typeof data.text !== "string" || data.text.length > 1e6)) return invalid$3("Invalid message text");
+	if (data.media !== void 0 && data.media !== null && (!Array.isArray(data.media) || data.media.length > 50)) return invalid$3("Invalid attachment list");
 	const attachments = (data.media ?? []).map(attachment);
-	if (attachments.some((a) => !a)) return invalid$2("Attachments require HTTPS references; bytes must be resolved through the authorized file boundary");
+	if (attachments.some((a) => !a)) return invalid$3("Attachments require HTTPS references; bytes must be resolved through the authorized file boundary");
 	const time = timestamp(data.time);
-	if (time === null) return invalid$2("A valid provider timestamp is required");
+	if (time === null) return invalid$3("A valid provider timestamp is required");
 	return {
 		ok: true,
 		event: {
@@ -588,17 +588,17 @@ function finish(input, data) {
 /** Called after the host verifies signatures and resolves the owning connection. */
 function normalizeMobileConversation(input) {
 	const p = input.payload;
-	if (!record$2(p)) return invalid$2("Provider payload requires an object");
+	if (!record$2(p)) return invalid$3("Provider payload requires an object");
 	if (input.provider === "sendblue") {
 		if (input.type !== "sendblue.message.received") return unsupported$1();
-		if (p.is_outbound !== false || String(p.status).toUpperCase() !== "RECEIVED" || !phone$1(p.from_number) || !phone$1(p.sendblue_number) || p.to_number !== void 0 && p.to_number !== p.sendblue_number || p.number !== void 0 && p.number !== p.from_number) return invalid$2("Sendblue requires an inbound received message with exact line and contact routing");
+		if (p.is_outbound !== false || String(p.status).toUpperCase() !== "RECEIVED" || !phone$1(p.from_number) || !phone$1(p.sendblue_number) || p.to_number !== void 0 && p.to_number !== p.sendblue_number || p.number !== void 0 && p.number !== p.from_number) return invalid$3("Sendblue requires an inbound received message with exact line and contact routing");
 		const service = typeof p.service === "string" ? p.service.toLowerCase() : null;
 		const transport = service === "imessage" ? "imessage" : service === "sms" ? "sms" : service === "rcs" ? "rcs" : null;
 		const messageType = typeof p.message_type === "string" ? p.message_type.toLowerCase() : null;
 		if (!transport || messageType !== "message" && messageType !== "group") return unsupported$1();
 		const group = messageType === "group" || Boolean(p.group_id);
-		if (group && !string(p.group_id, 256)) return invalid$2("Group messages require a group id");
-		if (p.media_url !== void 0 && p.media_url !== null && typeof p.media_url !== "string") return invalid$2("Invalid Sendblue media URL");
+		if (group && !string(p.group_id, 256)) return invalid$3("Group messages require a group id");
+		if (p.media_url !== void 0 && p.media_url !== null && typeof p.media_url !== "string") return invalid$3("Invalid Sendblue media URL");
 		return finish(input, {
 			id: p.message_handle,
 			conversation: group ? p.group_id : JSON.stringify([
@@ -620,21 +620,21 @@ function normalizeMobileConversation(input) {
 	}
 	if (input.provider === "twilio-sms") {
 		if (input.type !== "twilio-sms.message.received") return unsupported$1();
-		if (!/^AC[a-f\d]{32}$/i.test(String(p.AccountSid ?? "")) || !phone$1(p.From) || !phone$1(p.To) || !/^(SM|MM)[a-f\d]{32}$/i.test(String(p.MessageSid ?? ""))) return invalid$2("Twilio message requires its signed account, SID, and phone routing");
+		if (!/^AC[a-f\d]{32}$/i.test(String(p.AccountSid ?? "")) || !phone$1(p.From) || !phone$1(p.To) || !/^(SM|MM)[a-f\d]{32}$/i.test(String(p.MessageSid ?? ""))) return invalid$3("Twilio message requires its signed account, SID, and phone routing");
 		const count = Number(p.NumMedia ?? 0);
-		if (!Number.isSafeInteger(count) || count < 0 || count > 10) return invalid$2("Invalid Twilio media count");
+		if (!Number.isSafeInteger(count) || count < 0 || count > 10) return invalid$3("Invalid Twilio media count");
 		const media = [];
 		for (let index = 0; index < count; index++) {
 			const rawUrl = string(p[`MediaUrl${index}`], 8192);
-			if (!rawUrl) return invalid$2("Missing Twilio media URL");
+			if (!rawUrl) return invalid$3("Missing Twilio media URL");
 			let url;
 			try {
 				url = new URL(rawUrl);
 			} catch {
-				return invalid$2("Invalid Twilio media URL");
+				return invalid$3("Invalid Twilio media URL");
 			}
 			const parts = /^\/2010-04-01\/Accounts\/(AC[a-f\d]{32})\/Messages\/((?:SM|MM)[a-f\d]{32})\/Media\/(ME[a-f\d]{32})$/i.exec(url.pathname);
-			if (url.origin !== "https://api.twilio.com" || url.username || url.password || url.search || !parts || parts[1].toLowerCase() !== String(p.AccountSid).toLowerCase() || parts[2].toLowerCase() !== String(p.MessageSid).toLowerCase()) return invalid$2("Twilio media URL must belong to the signed message and account");
+			if (url.origin !== "https://api.twilio.com" || url.username || url.password || url.search || !parts || parts[1].toLowerCase() !== String(p.AccountSid).toLowerCase() || parts[2].toLowerCase() !== String(p.MessageSid).toLowerCase()) return invalid$3("Twilio media URL must belong to the signed message and account");
 			media.push({
 				id: parts[3],
 				url: rawUrl,
@@ -657,13 +657,13 @@ function normalizeMobileConversation(input) {
 			transport: "sms"
 		});
 	}
-	if (!record$2(p.data)) return invalid$2("Provider payload requires a data object");
+	if (!record$2(p.data)) return invalid$3("Provider payload requires a data object");
 	const data = p.data;
 	if (input.provider === "inkbox") {
-		if (input.type !== `inkbox.${p.event_type}`) return invalid$2("Event type does not match the provider envelope");
+		if (input.type !== `inkbox.${p.event_type}`) return invalid$3("Event type does not match the provider envelope");
 		if (p.event_type === "imessage.received") {
 			const m = data.message;
-			if (!record$2(m) || m.direction !== "inbound") return invalid$2("Expected an inbound iMessage");
+			if (!record$2(m) || m.direction !== "inbound") return invalid$3("Expected an inbound iMessage");
 			return finish(input, {
 				id: m.id,
 				conversation: m.conversation_id,
@@ -678,7 +678,7 @@ function normalizeMobileConversation(input) {
 		}
 		if (p.event_type === "text.received") {
 			const m = data.text_message;
-			if (!record$2(m) || m.direction !== "inbound") return invalid$2("Expected an inbound phone text");
+			if (!record$2(m) || m.direction !== "inbound") return invalid$3("Expected an inbound phone text");
 			return finish(input, {
 				id: m.id,
 				conversation: m.conversation_id,
@@ -694,7 +694,7 @@ function normalizeMobileConversation(input) {
 		}
 		if (p.event_type === "message.received") {
 			const m = data.message;
-			if (!record$2(m) || m.direction !== "inbound") return invalid$2("Expected inbound mail");
+			if (!record$2(m) || m.direction !== "inbound") return invalid$3("Expected inbound mail");
 			return finish(input, {
 				id: m.id,
 				conversation: m.thread_id ?? m.id,
@@ -713,17 +713,17 @@ function normalizeMobileConversation(input) {
 		return unsupported$1();
 	}
 	if (input.provider === "linq") {
-		if (input.type !== `linq.${p.event_type}`) return invalid$2("Event type does not match the provider envelope");
+		if (input.type !== `linq.${p.event_type}`) return invalid$3("Event type does not match the provider envelope");
 		if (p.event_type !== "message.received") return unsupported$1();
-		if (p.webhook_version !== "2026-02-03" || data.direction !== "inbound" || !record$2(data.chat) || !record$2(data.sender_handle) || !record$2(data.chat.owner_handle) || data.chat.owner_handle.is_me !== true || data.sender_handle.is_me === true) return invalid$2("Linq requires v2026-02-03 incoming payloads with explicit sender and owner handles");
+		if (p.webhook_version !== "2026-02-03" || data.direction !== "inbound" || !record$2(data.chat) || !record$2(data.sender_handle) || !record$2(data.chat.owner_handle) || data.chat.owner_handle.is_me !== true || data.sender_handle.is_me === true) return invalid$3("Linq requires v2026-02-03 incoming payloads with explicit sender and owner handles");
 		const transport = data.service === "iMessage" ? "imessage" : data.service === "SMS" ? "sms" : data.service === "RCS" ? "rcs" : null;
-		if (!transport) return invalid$2("Linq incoming message requires its actual service");
-		if (!Array.isArray(data.parts) || data.parts.length > 50) return invalid$2("Invalid Linq parts");
+		if (!transport) return invalid$3("Linq incoming message requires its actual service");
+		if (!Array.isArray(data.parts) || data.parts.length > 50) return invalid$3("Invalid Linq parts");
 		const texts = [], media = [];
 		for (const part of data.parts) {
-			if (!record$2(part)) return invalid$2("Invalid Linq part");
+			if (!record$2(part)) return invalid$3("Invalid Linq part");
 			if (part.type === "text" || part.type === "link") {
-				if (typeof part.value !== "string") return invalid$2("Invalid Linq text");
+				if (typeof part.value !== "string") return invalid$3("Invalid Linq text");
 				texts.push(part.value);
 			} else if (part.type === "media") media.push(part);
 			else return unsupported$1();
@@ -744,13 +744,13 @@ function normalizeMobileConversation(input) {
 		});
 	}
 	if (input.provider === "contiguity") {
-		if (input.type !== `contiguity.${p.type}`) return invalid$2("Event type does not match the provider envelope");
+		if (input.type !== `contiguity.${p.type}`) return invalid$3("Event type does not match the provider envelope");
 		if (![
 			"imessage.incoming",
 			"text.incoming.sms",
 			"text.incoming.mms"
 		].includes(String(p.type))) return unsupported$1();
-		if (!string(data.to, 320) || !string(data.from, 320)) return invalid$2("Missing Contiguity phone routing");
+		if (!string(data.to, 320) || !string(data.from, 320)) return invalid$3("Missing Contiguity phone routing");
 		return finish(input, {
 			id: p.id,
 			conversation: JSON.stringify([
@@ -782,7 +782,7 @@ function address(value) {
 	if (typeof value !== "string" || value.length > 320) return null;
 	return /^(?:[^<>]*<)?([^<>\s]+@[^<>\s]+)(?:>)?$/.exec(value.trim())?.[1]?.toLowerCase() ?? null;
 }
-const invalid$1 = (message) => ({
+const invalid$2 = (message) => ({
 	ok: false,
 	code: "invalid_payload",
 	message
@@ -790,13 +790,13 @@ const invalid$1 = (message) => ({
 /** The host adds the provider-read email after verifying the notification. */
 function normalizeResendConversation(input) {
 	const payload = input.payload;
-	if (input.type !== "resend.email.received" || !record$1(payload) || payload.type !== "email.received" || !record$1(payload.data) || !record$1(payload.received)) return invalid$1("Resend requires a hydrated received-email notification");
+	if (input.type !== "resend.email.received" || !record$1(payload) || payload.type !== "email.received" || !record$1(payload.data) || !record$1(payload.received)) return invalid$2("Resend requires a hydrated received-email notification");
 	const data = payload.data, received = payload.received;
-	if (typeof data.email_id !== "string" || received.id !== data.email_id || !Array.isArray(received.to) || received.to.length < 1 || received.to.length > 50 || received.cc !== void 0 && (!Array.isArray(received.cc) || received.cc.length > 50) || !address(received.from) || received.text != null && typeof received.text !== "string" || typeof received.created_at !== "string" || !Number.isFinite(Date.parse(received.created_at))) return invalid$1("Resend email identity, sender, recipient, body or time is invalid");
+	if (typeof data.email_id !== "string" || received.id !== data.email_id || !Array.isArray(received.to) || received.to.length < 1 || received.to.length > 50 || received.cc !== void 0 && (!Array.isArray(received.cc) || received.cc.length > 50) || !address(received.from) || received.text != null && typeof received.text !== "string" || typeof received.created_at !== "string" || !Number.isFinite(Date.parse(received.created_at))) return invalid$2("Resend email identity, sender, recipient, body or time is invalid");
 	const recipients = [...received.to, ...received.cc ?? []].map(address);
-	if (recipients.some((item) => !item)) return invalid$1("Resend recipient address is invalid");
+	if (recipients.some((item) => !item)) return invalid$2("Resend recipient address is invalid");
 	const attachments = Array.isArray(received.attachments) ? received.attachments : [];
-	if (attachments.length > 50 || attachments.some((item) => !record$1(item) || typeof item.id !== "string")) return invalid$1("Resend attachments require provider ids");
+	if (attachments.length > 50 || attachments.some((item) => !record$1(item) || typeof item.id !== "string")) return invalid$2("Resend attachments require provider ids");
 	const sender = address(received.from);
 	return {
 		ok: true,
@@ -841,6 +841,106 @@ function normalizeResendConversation(input) {
 	};
 }
 //#endregion
+//#region src/conversation-events/telegram.ts
+function object$1(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function integer(value, positive = true) {
+	return typeof value === "number" && Number.isSafeInteger(value) && (positive ? value > 0 : value !== 0);
+}
+const invalid$1 = (message) => ({
+	ok: false,
+	code: "invalid_payload",
+	message
+});
+/** Parse only new human messages. The verified webhook proves origin; the host
+* must still check live bot membership and the sender's authority before acting.
+* Addresses include chat, forum topic and sender to prevent session reuse across
+* groups, topics or people. Anonymous/channel senders cannot acquire user rights. */
+function normalizeTelegramConversation(input) {
+	if (input.type !== "telegram.message") return {
+		ok: false,
+		code: "unsupported_event",
+		message: "Not a new Telegram message"
+	};
+	const envelope = input.payload;
+	if (!object$1(envelope) || !Number.isSafeInteger(envelope.update_id) || envelope.update_id < 0 || !object$1(envelope.message)) return invalid$1("Telegram requires an update id and message");
+	const message = envelope.message;
+	const chat = message.chat;
+	const from = message.from;
+	if (!object$1(chat) || !object$1(from) || !integer(chat.id, false) || !integer(from.id) || from.is_bot !== false || message.sender_chat !== void 0 || !integer(message.message_id) || !integer(message.date) || !Number.isSafeInteger(message.date * 1e3) || ![
+		"private",
+		"group",
+		"supergroup"
+	].includes(String(chat.type)) || (chat.type === "private" ? chat.id !== from.id : chat.id >= 0)) return invalid$1("Telegram requires a human sender and supported chat identity");
+	const topic = message.message_thread_id;
+	if (topic !== void 0 && (!integer(topic) || chat.type !== "supergroup")) return invalid$1("Invalid Telegram topic");
+	const text = message.text ?? message.caption ?? "";
+	if (typeof text !== "string" || text.length > 4096 || text.includes("\0")) return invalid$1("Invalid Telegram message text");
+	const media = [];
+	if (message.photo !== void 0) {
+		if (!Array.isArray(message.photo) || message.photo.length === 0 || message.photo.length > 20) return invalid$1("Invalid Telegram photo");
+		media.push(message.photo[message.photo.length - 1]);
+	}
+	for (const kind of [
+		"document",
+		"audio",
+		"voice",
+		"video",
+		"video_note",
+		"animation",
+		"sticker"
+	]) if (message[kind] !== void 0) media.push(message[kind]);
+	const attachments = [];
+	for (const file of media) {
+		if (!object$1(file) || typeof file.file_id !== "string" || !/^[A-Za-z0-9_-]{1,512}$/.test(file.file_id) || file.file_size !== void 0 && (!Number.isSafeInteger(file.file_size) || file.file_size < 0)) return invalid$1("Invalid Telegram attachment");
+		attachments.push({
+			id: file.file_id,
+			name: typeof file.file_name === "string" ? file.file_name.slice(0, 255) : null,
+			contentType: typeof file.mime_type === "string" ? file.mime_type.slice(0, 200) : null,
+			size: typeof file.file_size === "number" ? file.file_size : null,
+			contentBase64: null,
+			url: null
+		});
+	}
+	if (!text.trim() && attachments.length === 0) return {
+		ok: false,
+		code: "unsupported_event",
+		message: "No message content"
+	};
+	return {
+		ok: true,
+		event: {
+			version: 1,
+			provider: "telegram",
+			eventType: input.type,
+			operation: "created",
+			eventId: `${chat.id}:${message.message_id}`,
+			conversationId: String(chat.id),
+			parentEventIds: object$1(message.reply_to_message) && integer(message.reply_to_message.message_id) ? [`${chat.id}:${message.reply_to_message.message_id}`] : [],
+			sender: {
+				id: String(from.id),
+				address: `telegram:${chat.id}:${topic ?? 0}:${from.id}`,
+				displayName: typeof from.first_name === "string" ? from.first_name.slice(0, 100) : null
+			},
+			destinations: [{
+				kind: "chat",
+				id: String(chat.id),
+				address: `telegram:${chat.id}`,
+				displayName: null
+			}],
+			subject: null,
+			text,
+			html: null,
+			attachments,
+			occurredAt: message.date * 1e3,
+			transport: "telegram",
+			isGroup: chat.type !== "private",
+			historyOnly: false
+		}
+	};
+}
+//#endregion
 //#region src/conversation-events/reply.ts
 function object(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -885,7 +985,27 @@ function buildMessagingReply(input, text, operationId) {
 	const event = normalized.event;
 	if (typeof text !== "string" || !text.trim() || text.length > 1e4 || text.includes("\0")) return fail("Reply text is empty or exceeds its limit");
 	if (!validOperationId(operationId)) return fail("A stable operation id is required");
-	if (event.historyOnly || event.isGroup) return fail("This event requires review or complete input before a reply");
+	if (event.historyOnly || event.isGroup && event.provider !== "telegram") return fail("This event requires review or complete input before a reply");
+	if (event.provider === "telegram") {
+		if (text.length > 4096) return fail("Telegram text is limited to 4096 characters");
+		const message = object(object(input.payload).message);
+		return {
+			ok: true,
+			reply: {
+				idempotencyKey: operationId,
+				action: "telegram.sendMessage",
+				input: {
+					chat_id: event.conversationId,
+					text,
+					reply_parameters: {
+						message_id: message.message_id,
+						allow_sending_without_reply: true
+					},
+					...message.message_thread_id === void 0 ? {} : { message_thread_id: message.message_thread_id }
+				}
+			}
+		};
+	}
 	const data = object(object(input.payload).data);
 	if (event.provider === "inkbox") {
 		if (event.eventType === "inkbox.imessage.received") return {
@@ -1068,6 +1188,15 @@ function buildMessagingMediaReply(input, media, operationId) {
 //#endregion
 //#region src/conversation-events/channels.ts
 const channels = [
+	{
+		providerId: "telegram",
+		eventType: "telegram.message",
+		label: "Telegram",
+		transport: "telegram",
+		sourceKind: "connection",
+		replies: true,
+		replyAction: "telegram.sendMessage"
+	},
 	{
 		providerId: "email",
 		eventType: "email.received",
@@ -1465,13 +1594,19 @@ function normalizeConversationEvent(value) {
 		"linq-whatsapp",
 		"resend",
 		"sendblue",
-		"twilio-sms"
+		"twilio-sms",
+		"telegram"
 	].includes(String(value.provider))) {
 		if (!("type" in value) || typeof value.type !== "string" || !("payload" in value)) return {
 			ok: false,
 			code: "invalid_payload",
 			message: "Provider event requires type and payload"
 		};
+		if (value.provider === "telegram") return normalizeTelegramConversation({
+			provider: value.provider,
+			type: value.type,
+			payload: value.payload
+		});
 		if (value.provider === "linq-whatsapp") return normalizeLinqWhatsappConversation({
 			provider: value.provider,
 			type: value.type,