agents 0.21.0 → 0.23.0

package/dist/channels/telegram.js

@@ -0,0 +1,427 @@
+import { t as isChannelMessageSurface } from "../surface-bZZJqBka.js";
+import { a as isRecord, i as encodeUtf8, n as defaultText, o as renderInput, r as emptyIngressResponse, s as uncertain } from "../internal-CYlgHl1l.js";
+import { i as createPacer, r as consumeChunks, t as matchesPath } from "../ingress-BfetZbMO.js";
+//#region src/channels/adapters/telegram.ts
+const TELEGRAM_MESSAGE_LIMIT = 4096;
+const DEFAULT_STREAM_INTERVAL_MS = 500;
+const DEFAULT_TELEGRAM_WEBHOOK_PATH = "/webhooks/telegram";
+const APPROVAL_INSTRUCTIONS = "Reply YES to approve or NO to reject.";
+const INTERACTION_FOOTER = /\n\nReply YES to approve or NO to reject\.\n\n\[channel-interaction:v1:([A-Za-z0-9_-]+)\]$/;
+function channelIdentity(chatId) {
+	return `telegram:chat:${chatId}`;
+}
+function userIdentity(userId) {
+	return `telegram:user:${userId}`;
+}
+function messageIdentity(chatId, messageId) {
+	return `${channelIdentity(chatId)}:message:${messageId}`;
+}
+function updateIdentity(chatId, updateId) {
+	return `${channelIdentity(chatId)}:update:${updateId}`;
+}
+function encodeInteractionId(interactionId) {
+	const bytes = encodeUtf8(interactionId);
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function decodeInteractionId(value) {
+	try {
+		const base64 = value.replace(/-/g, "+").replace(/_/g, "/");
+		const padding = "=".repeat((4 - base64.length % 4) % 4);
+		const binary = atob(base64 + padding);
+		const bytes = Uint8Array.from(binary, (character) => character.charCodeAt(0));
+		return new TextDecoder("utf-8", { fatal: true }).decode(bytes) || void 0;
+	} catch {
+		return;
+	}
+}
+function approvalText(interactionId, request) {
+	return [
+		...request.title ? [request.title] : [],
+		request.summary,
+		`Input:\n${renderInput(request.input)}`,
+		APPROVAL_INSTRUCTIONS,
+		`[channel-interaction:v1:${encodeInteractionId(interactionId)}]`
+	].join("\n\n");
+}
+function asApiResponse(value) {
+	return value !== null && typeof value === "object" ? value : void 0;
+}
+function classifyResponse(response, payload) {
+	if (payload.ok === true) {
+		const result = asApiResponse(payload.result);
+		if (typeof result?.message_id === "number") return {
+			status: "delivered",
+			reference: String(result.message_id)
+		};
+		return uncertain("TELEGRAM_DELIVERY_ERROR", "Telegram returned an invalid delivery response");
+	}
+	if (payload.ok === false) {
+		const errorCode = typeof payload.error_code === "number" ? payload.error_code : response.status;
+		const message = typeof payload.description === "string" ? payload.description : "Telegram rejected the message";
+		const error = {
+			code: `TELEGRAM_API_ERROR_${errorCode}`,
+			message
+		};
+		if (errorCode >= 500) return {
+			status: "uncertain",
+			error
+		};
+		return {
+			status: "failed",
+			retryable: errorCode === 429,
+			error
+		};
+	}
+	return uncertain("TELEGRAM_DELIVERY_ERROR", "Telegram returned an invalid delivery response");
+}
+function asTelegramMessage(value) {
+	return value !== null && typeof value === "object" ? value : void 0;
+}
+function telegramActor(message) {
+	const sender = message.from;
+	if (sender) {
+		const fullName = [sender.first_name, sender.last_name].filter(Boolean).join(" ");
+		return {
+			id: userIdentity(sender.id),
+			identity: { subject: `user:${sender.id}` },
+			...sender.username && { username: sender.username },
+			...fullName && { fullName },
+			isBot: sender.is_bot
+		};
+	}
+	const senderChat = message.sender_chat;
+	if (!senderChat) return void 0;
+	const fullName = senderChat.title ?? [senderChat.first_name, senderChat.last_name].filter(Boolean).join(" ");
+	return {
+		id: channelIdentity(senderChat.id),
+		identity: { subject: `chat:${senderChat.id}` },
+		...senderChat.username && { username: senderChat.username },
+		...fullName && { fullName },
+		isBot: "unknown"
+	};
+}
+function chatLabel(chat) {
+	return `Telegram · ${(chat.title ?? (chat.username ? `@${chat.username}` : void 0) ?? [chat.first_name, chat.last_name].filter(Boolean).join(" ") ?? String(chat.id)) || chat.id}`;
+}
+function eventContext(message, eventId, botUserId) {
+	const actor = telegramActor(message);
+	const channelId = channelIdentity(message.chat.id);
+	return {
+		eventId,
+		thread: {
+			id: typeof message.message_thread_id === "number" ? `${channelId}:topic:${message.message_thread_id}` : channelId,
+			isDirectMessage: message.chat.type === "private" ? true : message.chat.type === "group" || message.chat.type === "supergroup" || message.chat.type === "channel" ? false : "unknown"
+		},
+		replySurface: {
+			version: 1,
+			address: {
+				chatId: String(message.chat.id),
+				...botUserId && { botUserId },
+				...typeof message.message_thread_id === "number" && { messageThreadId: message.message_thread_id },
+				replyToMessageId: message.message_id
+			},
+			label: chatLabel(message.chat)
+		},
+		...actor && { actor }
+	};
+}
+function telegramTimestamp(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+	const date = /* @__PURE__ */ new Date(value * 1e3);
+	return Number.isFinite(date.getTime()) ? date.toISOString() : void 0;
+}
+function normalizedMessage(message, eventId, edited, botUserId) {
+	const reply = asTelegramMessage(message.reply_to_message);
+	const sentAt = telegramTimestamp(message.date);
+	const editedAt = telegramTimestamp(message.edit_date);
+	return {
+		type: "message",
+		...eventContext(message, eventId, botUserId),
+		message: {
+			id: messageIdentity(message.chat.id, message.message_id),
+			text: message.text,
+			...typeof reply?.message_id === "number" && { reply: {
+				id: messageIdentity(message.chat.id, reply.message_id),
+				...typeof reply.text === "string" && { text: reply.text }
+			} },
+			...(sentAt || edited || editedAt) && { metadata: {
+				...sentAt && { sentAt },
+				...edited && { edited: true },
+				...editedAt && { editedAt }
+			} }
+		}
+	};
+}
+function approvalResponse(message, eventId, botUserId) {
+	if (botUserId === void 0) return void 0;
+	if (message.text !== "YES" && message.text !== "NO") return void 0;
+	const reply = asTelegramMessage(message.reply_to_message);
+	if (typeof reply?.message_id !== "number") return void 0;
+	const author = reply.from;
+	if (author?.is_bot !== true || author.id !== botUserId) return void 0;
+	const encodedInteractionId = typeof reply.text === "string" ? reply.text.match(INTERACTION_FOOTER)?.[1] : void 0;
+	const interactionId = encodedInteractionId ? decodeInteractionId(encodedInteractionId) : void 0;
+	if (!interactionId) return void 0;
+	return {
+		type: "approval-response",
+		...eventContext(message, eventId, botUserId),
+		interactionId,
+		decision: message.text === "YES" ? "approve" : "reject",
+		reference: messageIdentity(message.chat.id, message.message_id)
+	};
+}
+function inboundEvent(update, botUserId) {
+	const edited = update.edited_message !== void 0;
+	const message = asTelegramMessage(edited ? update.edited_message : update.message);
+	if (typeof update.update_id !== "number" || typeof message?.message_id !== "number" || typeof message.text !== "string" || typeof message.chat?.id !== "number") return;
+	const eventId = updateIdentity(message.chat.id, update.update_id);
+	return approvalResponse(message, eventId, botUserId) ?? normalizedMessage(message, eventId, edited, botUserId);
+}
+/** Recover this bot's numeric user id from its BotFather token prefix. */
+function telegramBotUserId(botToken) {
+	const prefix = botToken.match(/^(\d+):/)?.[1];
+	if (!prefix) return void 0;
+	const botUserId = Number(prefix);
+	return Number.isSafeInteger(botUserId) && botUserId > 0 ? botUserId : void 0;
+}
+/** Create dependency-free Telegram webhook ingress for a destination chat. */
+function telegramWebhook(options) {
+	if (!options.secretToken.trim()) throw new Error("secretToken is required to create Telegram webhook ingress");
+	if (options.botUserId !== void 0 && (!Number.isSafeInteger(options.botUserId) || options.botUserId <= 0)) throw new Error("botUserId must be a positive Telegram user id");
+	const botUserId = options.botUserId;
+	const path = options.path ?? DEFAULT_TELEGRAM_WEBHOOK_PATH;
+	return { async receive(request) {
+		if (!matchesPath(request, path)) return null;
+		if (request.method !== "POST") return emptyIngressResponse(405);
+		if (request.headers.get("x-telegram-bot-api-secret-token") !== options.secretToken) return emptyIngressResponse(401);
+		let update;
+		try {
+			update = await request.json();
+		} catch {
+			return emptyIngressResponse(400);
+		}
+		if (update === null || typeof update !== "object") return emptyIngressResponse(400);
+		const raw = update;
+		const event = inboundEvent(raw, botUserId);
+		return {
+			events: event ? [{
+				event,
+				raw
+			}] : [],
+			response: new Response(null, { status: 200 })
+		};
+	} };
+}
+function telegramSurface(surface) {
+	if (!isChannelMessageSurface(surface) || surface.version !== 1 || !isRecord(surface.address) || typeof surface.address.chatId !== "string" || surface.address.chatId.length === 0 || surface.address.botUserId !== void 0 && (!Number.isSafeInteger(surface.address.botUserId) || Number(surface.address.botUserId) <= 0)) return;
+	if (surface.address.messageThreadId !== void 0 && !Number.isSafeInteger(surface.address.messageThreadId) || surface.address.replyToMessageId !== void 0 && !Number.isSafeInteger(surface.address.replyToMessageId)) return;
+	return surface;
+}
+/**
+* Whether a chat can show an animated draft.
+*
+* `sendMessageDraft` is private chats only, and Telegram gives private chats
+* positive ids. Anywhere else the answer is simply sent once at the end.
+*/
+function supportsDraft(chatId) {
+	const numeric = Number(chatId);
+	return Number.isSafeInteger(numeric) && numeric > 0;
+}
+/** A non-zero draft identifier; reusing one animates between snapshots. */
+function newDraftId() {
+	const [random] = crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(1));
+	return (random ?? 1) % 2147483647 + 1;
+}
+function splitText(text, limit) {
+	const pieces = [];
+	let piece = "";
+	let length = 0;
+	for (const character of text) {
+		if (length === limit) {
+			pieces.push(piece);
+			piece = "";
+			length = 0;
+		}
+		piece += character;
+		length += 1;
+	}
+	if (piece.length > 0) pieces.push(piece);
+	return pieces;
+}
+function textLength(text) {
+	return [...text].length;
+}
+/** Create a configured Telegram Bot API Channel. */
+function telegram(options) {
+	if (!options.botToken.trim()) throw new Error("botToken is required to create a Telegram channel");
+	const fetch = options.fetch ?? globalThis.fetch;
+	const apiBaseUrl = (options.apiBaseUrl ?? "https://api.telegram.org").replace(/\/$/, "");
+	const maxLength = options.maxLength ?? TELEGRAM_MESSAGE_LIMIT;
+	if (!Number.isInteger(maxLength) || maxLength < 1 || maxLength > TELEGRAM_MESSAGE_LIMIT) throw new Error(`maxLength must be an integer between 1 and ${TELEGRAM_MESSAGE_LIMIT}`);
+	const toText = options.toText ?? defaultText;
+	const streamIntervalMs = options.streamIntervalMs ?? DEFAULT_STREAM_INTERVAL_MS;
+	if (!Number.isInteger(streamIntervalMs) || streamIntervalMs < 0) throw new Error("streamIntervalMs must be a non-negative integer");
+	const botUserId = telegramBotUserId(options.botToken);
+	const ingress = options.webhook ? telegramWebhook({
+		...options.webhook,
+		botUserId
+	}) : void 0;
+	async function send(destinationValue, text, parseMode) {
+		const destination = telegramSurface(destinationValue);
+		if (!destination || botUserId !== void 0 && destination.address.botUserId !== void 0 && destination.address.botUserId !== botUserId) return {
+			status: "failed",
+			retryable: false,
+			error: {
+				code: "TELEGRAM_SURFACE_INVALID",
+				message: `Telegram cannot parse the address for Channel "${destinationValue.channelKey}"`
+			}
+		};
+		if (textLength(text) > maxLength) return {
+			status: "failed",
+			retryable: false,
+			error: {
+				code: "TELEGRAM_MESSAGE_TOO_LONG",
+				message: `Telegram message exceeds the configured ${maxLength}-character limit`
+			}
+		};
+		let response;
+		try {
+			response = await fetch(`${apiBaseUrl}/bot${options.botToken}/sendMessage`, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					chat_id: destination.address.chatId,
+					text,
+					...destination.address.messageThreadId !== void 0 && { message_thread_id: destination.address.messageThreadId },
+					...destination.address.replyToMessageId !== void 0 && { reply_parameters: { message_id: destination.address.replyToMessageId } },
+					...parseMode && { parse_mode: parseMode }
+				})
+			});
+		} catch {
+			return uncertain("TELEGRAM_DELIVERY_ERROR", "Telegram delivery failed with an unknown outcome");
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch {
+			return uncertain("TELEGRAM_DELIVERY_ERROR", "Telegram returned an invalid delivery response");
+		}
+		const apiResponse = asApiResponse(payload);
+		return apiResponse ? classifyResponse(response, apiResponse) : uncertain("TELEGRAM_DELIVERY_ERROR", "Telegram returned an invalid delivery response");
+	}
+	/**
+	* Show one ephemeral preview. Failures are swallowed on purpose: a draft is
+	* a 30-second animation, and losing one must never cost the real message.
+	*
+	* The configured parse mode is deliberately not applied. A partial answer
+	* routinely holds unbalanced markup, which Telegram rejects outright.
+	*/
+	async function sendDraft(destination, draftId, text) {
+		try {
+			return asApiResponse(await (await fetch(`${apiBaseUrl}/bot${options.botToken}/sendMessageDraft`, {
+				method: "POST",
+				headers: { "content-type": "application/json" },
+				body: JSON.stringify({
+					chat_id: Number(destination.address.chatId),
+					draft_id: draftId,
+					text,
+					...destination.address.messageThreadId !== void 0 && { message_thread_id: destination.address.messageThreadId }
+				})
+			})).json())?.ok === true;
+		} catch {
+			return false;
+		}
+	}
+	/** Persist the answer, splitting it when it outgrows one Telegram message. */
+	async function sendComplete(destination, text) {
+		const [head, ...tail] = splitText(text, maxLength);
+		const parseMode = tail.length === 0 ? options.parseMode : void 0;
+		const first = await send(destination, head, parseMode);
+		if (first.status !== "delivered") return first;
+		for (const piece of tail) if ((await send(destination, piece, parseMode)).status !== "delivered") return uncertain("TELEGRAM_STREAM_PARTIAL", "Telegram accepted only part of a split answer", first.reference);
+		return first;
+	}
+	async function streamMessage(destinationValue, chunks, streamOptions) {
+		const destination = telegramSurface(destinationValue);
+		if (!destination || botUserId !== void 0 && destination.address.botUserId !== void 0 && destination.address.botUserId !== botUserId) {
+			await chunks.cancel().catch(() => {});
+			return {
+				status: "failed",
+				retryable: false,
+				error: {
+					code: "TELEGRAM_SURFACE_INVALID",
+					message: `Telegram cannot parse the address for Channel "${destinationValue.channelKey}"`
+				}
+			};
+		}
+		const draftId = supportsDraft(destination.address.chatId) ? newDraftId() : void 0;
+		const prefix = streamOptions.title ? `${streamOptions.title}\n\n` : "";
+		const shouldPreview = createPacer(streamIntervalMs);
+		let answer = "";
+		let draftsStopped = draftId === void 0;
+		return consumeChunks(chunks, {
+			async onChunk(chunk) {
+				if (chunk.type !== "text" || chunk.text.length === 0) return;
+				answer += chunk.text;
+				if (draftsStopped || !shouldPreview()) return;
+				if (!await sendDraft(destination, draftId, splitText(`${prefix}${answer}`, maxLength)[0] ?? "")) draftsStopped = true;
+			},
+			async onFinish(outcome) {
+				if (answer.length === 0) return {
+					status: "failed",
+					retryable: false,
+					error: outcome.interrupted ? {
+						code: "TELEGRAM_STREAM_INTERRUPTED",
+						message: "The answer ended before producing any text to send"
+					} : {
+						code: "TELEGRAM_STREAM_EMPTY",
+						message: "The stream carried no text to send"
+					}
+				};
+				const result = await sendComplete(destination, `${prefix}${answer}`);
+				if (!outcome.interrupted || result.status !== "delivered") return result;
+				return uncertain("TELEGRAM_STREAM_INTERRUPTED", "An incomplete answer was sent because the stream ended early", result.reference);
+			}
+		});
+	}
+	return {
+		...options.route && { route: options.route },
+		...ingress && { ingress },
+		contactSurface(identity) {
+			if ((identity.scope ?? "default") !== "default") return null;
+			const match = identity.subject.match(/^(user|chat):(-?\d+)$/);
+			if (!match) return null;
+			return {
+				version: 1,
+				address: {
+					chatId: match[2],
+					...botUserId && { botUserId }
+				},
+				label: `Telegram · ${match[1]} ${match[2]}`
+			};
+		},
+		deliver(destination, message) {
+			return send(destination, toText(message), options.parseMode);
+		},
+		stream(destination, chunks, streamOptions) {
+			return streamMessage(destination, chunks, streamOptions);
+		},
+		requestApproval(destination, { interactionId, request }) {
+			if (interactionId.length === 0) return Promise.resolve({
+				status: "failed",
+				retryable: false,
+				error: {
+					code: "TELEGRAM_INTERACTION_ID_REQUIRED",
+					message: "Telegram approval requests require a non-empty interaction id"
+				}
+			});
+			return send(destination, approvalText(interactionId, request));
+		}
+	};
+}
+//#endregion
+export { telegram, telegramWebhook };
+
+//# sourceMappingURL=telegram.js.map

package/dist/channels/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","names":[],"sources":["../../src/channels/adapters/telegram.ts"],"sourcesContent":["import type {\n  Channel,\n  ChannelApprovalRequest,\n  ChannelChunk,\n  ChannelMessage,\n  ChannelRoute,\n  ChannelStreamOptions,\n  DeliveryResult\n} from \"../channel\";\nimport { consumeChunks, createPacer } from \"../stream\";\nimport type { ChannelIdentity } from \"../identity\";\nimport {\n  isChannelMessageSurface,\n  type ChannelMessageSurface\n} from \"../surface\";\nimport {\n  matchesPath,\n  type ChannelApprovalResponseInput,\n  type ChannelEventContextInput,\n  type ChannelInboundMessageInput,\n  type ChannelIngress,\n  type ChannelIngressEventInput\n} from \"../ingress\";\nimport {\n  defaultText,\n  emptyIngressResponse,\n  encodeUtf8,\n  isRecord,\n  renderInput,\n  uncertain\n} from \"../internal\";\n\nexport type TelegramUser = {\n  id: number;\n  is_bot: boolean;\n  first_name: string;\n  last_name?: string;\n  username?: string;\n  [key: string]: unknown;\n};\n\nexport type TelegramChat = {\n  id: number;\n  type: \"private\" | \"group\" | \"supergroup\" | \"channel\";\n  title?: string;\n  username?: string;\n  first_name?: string;\n  last_name?: string;\n  [key: string]: unknown;\n};\n\nexport type TelegramMessage = {\n  message_id: number;\n  date: number;\n  chat: TelegramChat;\n  message_thread_id?: number;\n  from?: TelegramUser;\n  sender_chat?: TelegramChat;\n  text?: string;\n  edit_date?: number;\n  reply_to_message?: TelegramMessage;\n  [key: string]: unknown;\n};\n\n/** Authenticated JSON body delivered by a Telegram webhook. */\nexport type TelegramUpdate = {\n  update_id: number;\n  message?: TelegramMessage;\n  edited_message?: TelegramMessage;\n  [key: string]: unknown;\n};\n\nexport type TelegramMessageSurface = ChannelMessageSurface<\n  string,\n  {\n    chatId: string;\n    botUserId?: number;\n    messageThreadId?: number;\n    replyToMessageId?: number;\n  }\n>;\n\n/** Configuration for a Telegram Channel. */\nexport type TelegramChannelOptions = {\n  /** Bot token issued by BotFather. */\n  botToken: string;\n  /** Telegram Bot API origin. @default \"https://api.telegram.org\" */\n  apiBaseUrl?: string;\n  /** Maximum text length accepted by this route. @default 4096 */\n  maxLength?: number;\n  /** Project the canonical message into Telegram text. */\n  toText?: (message: ChannelMessage) => string;\n  /** Parse mode for caller-formatted delivery text. */\n  parseMode?: \"HTML\" | \"MarkdownV2\";\n  /**\n   * Smallest gap between `sendMessageDraft` previews. Snapshots produced\n   * inside one interval are replaced rather than sent. @default 500\n   */\n  streamIntervalMs?: number;\n  /** Select an application route from the event, raw update, and Host context. */\n  route?: ChannelRoute<TelegramUpdate>;\n  /** Add secret-verified Telegram webhook ingress to the returned Channel. */\n  webhook?: {\n    secretToken: string;\n    /** Exact webhook pathname accepted by this ingress. @default \"/webhooks/telegram\" */\n    path?: string;\n  };\n  /** Override fetch for testing or custom network routing. */\n  fetch?: typeof globalThis.fetch;\n};\n\ntype TelegramApiResponse = {\n  ok?: unknown;\n  result?: unknown;\n  error_code?: unknown;\n  description?: unknown;\n};\n\nconst TELEGRAM_MESSAGE_LIMIT = 4096;\nconst DEFAULT_STREAM_INTERVAL_MS = 500;\nconst DEFAULT_TELEGRAM_WEBHOOK_PATH = \"/webhooks/telegram\";\nconst APPROVAL_INSTRUCTIONS = \"Reply YES to approve or NO to reject.\";\nconst INTERACTION_FOOTER =\n  /\\n\\nReply YES to approve or NO to reject\\.\\n\\n\\[channel-interaction:v1:([A-Za-z0-9_-]+)\\]$/;\n\nfunction channelIdentity(chatId: number): string {\n  return `telegram:chat:${chatId}`;\n}\n\nfunction userIdentity(userId: number): string {\n  return `telegram:user:${userId}`;\n}\n\nfunction messageIdentity(chatId: number, messageId: number): string {\n  return `${channelIdentity(chatId)}:message:${messageId}`;\n}\n\nfunction updateIdentity(chatId: number, updateId: number): string {\n  return `${channelIdentity(chatId)}:update:${updateId}`;\n}\n\nfunction encodeInteractionId(interactionId: string): string {\n  const bytes = encodeUtf8(interactionId);\n  let binary = \"\";\n  for (const byte of bytes) binary += String.fromCharCode(byte);\n  return btoa(binary)\n    .replace(/\\+/g, \"-\")\n    .replace(/\\//g, \"_\")\n    .replace(/=+$/, \"\");\n}\n\nfunction decodeInteractionId(value: string): string | undefined {\n  try {\n    const base64 = value.replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const padding = \"=\".repeat((4 - (base64.length % 4)) % 4);\n    const binary = atob(base64 + padding);\n    const bytes = Uint8Array.from(binary, (character) =>\n      character.charCodeAt(0)\n    );\n    const interactionId = new TextDecoder(\"utf-8\", { fatal: true }).decode(\n      bytes\n    );\n    return interactionId || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction approvalText(\n  interactionId: string,\n  request: ChannelApprovalRequest\n): string {\n  return [\n    ...(request.title ? [request.title] : []),\n    request.summary,\n    `Input:\\n${renderInput(request.input)}`,\n    APPROVAL_INSTRUCTIONS,\n    `[channel-interaction:v1:${encodeInteractionId(interactionId)}]`\n  ].join(\"\\n\\n\");\n}\n\nfunction asApiResponse(value: unknown): TelegramApiResponse | undefined {\n  return value !== null && typeof value === \"object\"\n    ? (value as TelegramApiResponse)\n    : undefined;\n}\n\nfunction classifyResponse(\n  response: Response,\n  payload: TelegramApiResponse\n): DeliveryResult {\n  if (payload.ok === true) {\n    const result = asApiResponse(payload.result) as\n      | { message_id?: unknown }\n      | undefined;\n    if (typeof result?.message_id === \"number\") {\n      return { status: \"delivered\", reference: String(result.message_id) };\n    }\n    return uncertain(\n      \"TELEGRAM_DELIVERY_ERROR\",\n      \"Telegram returned an invalid delivery response\"\n    );\n  }\n\n  if (payload.ok === false) {\n    const errorCode =\n      typeof payload.error_code === \"number\"\n        ? payload.error_code\n        : response.status;\n    const message =\n      typeof payload.description === \"string\"\n        ? payload.description\n        : \"Telegram rejected the message\";\n    const error = { code: `TELEGRAM_API_ERROR_${errorCode}`, message };\n    if (errorCode >= 500) return { status: \"uncertain\", error };\n    return {\n      status: \"failed\",\n      retryable: errorCode === 429,\n      error\n    };\n  }\n\n  return uncertain(\n    \"TELEGRAM_DELIVERY_ERROR\",\n    \"Telegram returned an invalid delivery response\"\n  );\n}\n\nexport type TelegramWebhookOptions = {\n  /** Telegram webhook secret configured through setWebhook. */\n  secretToken: string;\n  /** Exact webhook pathname accepted by this ingress. @default \"/webhooks/telegram\" */\n  path?: string;\n  /**\n   * Numeric user id of this bot, used to prove that an approval reply answers\n   * a message this bot sent. Without it, marker replies stay ordinary\n   * messages because their provenance cannot be established.\n   */\n  botUserId?: number;\n};\n\nfunction asTelegramMessage(value: unknown): TelegramMessage | undefined {\n  return value !== null && typeof value === \"object\"\n    ? (value as TelegramMessage)\n    : undefined;\n}\n\nfunction telegramActor(message: TelegramMessage) {\n  const sender = message.from;\n  if (sender) {\n    const fullName = [sender.first_name, sender.last_name]\n      .filter(Boolean)\n      .join(\" \");\n    return {\n      id: userIdentity(sender.id),\n      identity: {\n        subject: `user:${sender.id}`\n      },\n      ...(sender.username && { username: sender.username }),\n      ...(fullName && { fullName }),\n      isBot: sender.is_bot\n    };\n  }\n\n  const senderChat = message.sender_chat;\n  if (!senderChat) return undefined;\n  const fullName =\n    senderChat.title ??\n    [senderChat.first_name, senderChat.last_name].filter(Boolean).join(\" \");\n  return {\n    id: channelIdentity(senderChat.id),\n    identity: {\n      subject: `chat:${senderChat.id}`\n    },\n    ...(senderChat.username && { username: senderChat.username }),\n    ...(fullName && { fullName }),\n    isBot: \"unknown\" as const\n  };\n}\n\nfunction chatLabel(chat: TelegramChat): string {\n  const name =\n    chat.title ??\n    (chat.username ? `@${chat.username}` : undefined) ??\n    [chat.first_name, chat.last_name].filter(Boolean).join(\" \") ??\n    String(chat.id);\n  return `Telegram · ${name || chat.id}`;\n}\n\nfunction eventContext(\n  message: TelegramMessage,\n  eventId: string,\n  botUserId: number | undefined\n): ChannelEventContextInput {\n  const actor = telegramActor(message);\n  const channelId = channelIdentity(message.chat.id);\n  const threadId =\n    typeof message.message_thread_id === \"number\"\n      ? `${channelId}:topic:${message.message_thread_id}`\n      : channelId;\n  const isDirectMessage =\n    message.chat.type === \"private\"\n      ? true\n      : message.chat.type === \"group\" ||\n          message.chat.type === \"supergroup\" ||\n          message.chat.type === \"channel\"\n        ? false\n        : (\"unknown\" as const);\n  return {\n    eventId,\n    thread: { id: threadId, isDirectMessage },\n    replySurface: {\n      version: 1,\n      address: {\n        chatId: String(message.chat.id),\n        ...(botUserId && { botUserId }),\n        ...(typeof message.message_thread_id === \"number\" && {\n          messageThreadId: message.message_thread_id\n        }),\n        replyToMessageId: message.message_id\n      },\n      label: chatLabel(message.chat)\n    },\n    ...(actor && { actor })\n  };\n}\n\nfunction telegramTimestamp(value: unknown): string | undefined {\n  if (typeof value !== \"number\" || !Number.isFinite(value)) return undefined;\n  const date = new Date(value * 1000);\n  return Number.isFinite(date.getTime()) ? date.toISOString() : undefined;\n}\n\nfunction normalizedMessage(\n  message: TelegramMessage,\n  eventId: string,\n  edited: boolean,\n  botUserId: number | undefined\n): ChannelInboundMessageInput {\n  const reply = asTelegramMessage(message.reply_to_message);\n  const sentAt = telegramTimestamp(message.date);\n  const editedAt = telegramTimestamp(message.edit_date);\n\n  return {\n    type: \"message\",\n    ...eventContext(message, eventId, botUserId),\n    message: {\n      id: messageIdentity(message.chat.id, message.message_id),\n      text: message.text as string,\n      ...(typeof reply?.message_id === \"number\" && {\n        reply: {\n          id: messageIdentity(message.chat.id, reply.message_id),\n          ...(typeof reply.text === \"string\" && { text: reply.text })\n        }\n      }),\n      ...((sentAt || edited || editedAt) && {\n        metadata: {\n          ...(sentAt && { sentAt }),\n          ...(edited && { edited: true }),\n          ...(editedAt && { editedAt })\n        }\n      })\n    }\n  };\n}\n\nfunction approvalResponse(\n  message: TelegramMessage,\n  eventId: string,\n  botUserId: number | undefined\n): ChannelApprovalResponseInput | undefined {\n  if (botUserId === undefined) return undefined;\n  if (message.text !== \"YES\" && message.text !== \"NO\") return undefined;\n\n  const reply = asTelegramMessage(message.reply_to_message);\n  if (typeof reply?.message_id !== \"number\") return undefined;\n\n  // An interaction marker only authorizes a decision when this bot authored\n  // the replied-to message; otherwise any chat member could forge one.\n  const author = reply.from;\n  if (author?.is_bot !== true || author.id !== botUserId) return undefined;\n\n  const encodedInteractionId =\n    typeof reply.text === \"string\"\n      ? reply.text.match(INTERACTION_FOOTER)?.[1]\n      : undefined;\n  const interactionId = encodedInteractionId\n    ? decodeInteractionId(encodedInteractionId)\n    : undefined;\n  if (!interactionId) return undefined;\n\n  return {\n    type: \"approval-response\",\n    ...eventContext(message, eventId, botUserId),\n    interactionId,\n    decision: message.text === \"YES\" ? \"approve\" : \"reject\",\n    reference: messageIdentity(message.chat.id, message.message_id)\n  };\n}\n\nfunction inboundEvent(\n  update: TelegramUpdate,\n  botUserId: number | undefined\n): ChannelIngressEventInput | undefined {\n  const edited = update.edited_message !== undefined;\n  const message = asTelegramMessage(\n    edited ? update.edited_message : update.message\n  );\n  if (\n    typeof update.update_id !== \"number\" ||\n    typeof message?.message_id !== \"number\" ||\n    typeof message.text !== \"string\" ||\n    typeof message.chat?.id !== \"number\"\n  ) {\n    return undefined;\n  }\n\n  const eventId = updateIdentity(message.chat.id, update.update_id);\n  return (\n    approvalResponse(message, eventId, botUserId) ??\n    normalizedMessage(message, eventId, edited, botUserId)\n  );\n}\n\n/** Recover this bot's numeric user id from its BotFather token prefix. */\nfunction telegramBotUserId(botToken: string): number | undefined {\n  const prefix = botToken.match(/^(\\d+):/)?.[1];\n  if (!prefix) return undefined;\n  const botUserId = Number(prefix);\n  return Number.isSafeInteger(botUserId) && botUserId > 0\n    ? botUserId\n    : undefined;\n}\n\n/** Create dependency-free Telegram webhook ingress for a destination chat. */\nexport function telegramWebhook(\n  options: TelegramWebhookOptions\n): ChannelIngress<TelegramUpdate> {\n  if (!options.secretToken.trim()) {\n    throw new Error(\n      \"secretToken is required to create Telegram webhook ingress\"\n    );\n  }\n  if (\n    options.botUserId !== undefined &&\n    (!Number.isSafeInteger(options.botUserId) || options.botUserId <= 0)\n  ) {\n    throw new Error(\"botUserId must be a positive Telegram user id\");\n  }\n\n  const botUserId = options.botUserId;\n  const path = options.path ?? DEFAULT_TELEGRAM_WEBHOOK_PATH;\n  return {\n    async receive(request) {\n      if (!matchesPath(request, path)) return null;\n      if (request.method !== \"POST\") return emptyIngressResponse(405);\n      if (\n        request.headers.get(\"x-telegram-bot-api-secret-token\") !==\n        options.secretToken\n      ) {\n        return emptyIngressResponse(401);\n      }\n\n      let update: unknown;\n      try {\n        update = await request.json();\n      } catch {\n        return emptyIngressResponse(400);\n      }\n      if (update === null || typeof update !== \"object\") {\n        return emptyIngressResponse(400);\n      }\n\n      const raw = update as TelegramUpdate;\n      const event = inboundEvent(raw, botUserId);\n      return {\n        events: event ? [{ event, raw }] : [],\n        response: new Response(null, { status: 200 })\n      };\n    }\n  };\n}\n\nfunction telegramSurface(\n  surface: ChannelMessageSurface\n): TelegramMessageSurface | undefined {\n  if (\n    !isChannelMessageSurface(surface) ||\n    surface.version !== 1 ||\n    !isRecord(surface.address) ||\n    typeof surface.address.chatId !== \"string\" ||\n    surface.address.chatId.length === 0 ||\n    (surface.address.botUserId !== undefined &&\n      (!Number.isSafeInteger(surface.address.botUserId) ||\n        Number(surface.address.botUserId) <= 0))\n  ) {\n    return undefined;\n  }\n  if (\n    (surface.address.messageThreadId !== undefined &&\n      !Number.isSafeInteger(surface.address.messageThreadId)) ||\n    (surface.address.replyToMessageId !== undefined &&\n      !Number.isSafeInteger(surface.address.replyToMessageId))\n  ) {\n    return undefined;\n  }\n  return surface as TelegramMessageSurface;\n}\n\n/**\n * Whether a chat can show an animated draft.\n *\n * `sendMessageDraft` is private chats only, and Telegram gives private chats\n * positive ids. Anywhere else the answer is simply sent once at the end.\n */\nfunction supportsDraft(chatId: string): boolean {\n  const numeric = Number(chatId);\n  return Number.isSafeInteger(numeric) && numeric > 0;\n}\n\n/** A non-zero draft identifier; reusing one animates between snapshots. */\nfunction newDraftId(): number {\n  const [random] = crypto.getRandomValues(new Uint32Array(1));\n  return ((random ?? 1) % 2_147_483_647) + 1;\n}\n\nfunction splitText(text: string, limit: number): string[] {\n  const pieces: string[] = [];\n  let piece = \"\";\n  let length = 0;\n  for (const character of text) {\n    if (length === limit) {\n      pieces.push(piece);\n      piece = \"\";\n      length = 0;\n    }\n    piece += character;\n    length += 1;\n  }\n  if (piece.length > 0) pieces.push(piece);\n  return pieces;\n}\n\nfunction textLength(text: string): number {\n  return [...text].length;\n}\n\n/** Create a configured Telegram Bot API Channel. */\nexport function telegram(\n  options: TelegramChannelOptions\n): Channel<TelegramUpdate> {\n  if (!options.botToken.trim()) {\n    throw new Error(\"botToken is required to create a Telegram channel\");\n  }\n  const fetch = options.fetch ?? globalThis.fetch;\n  const apiBaseUrl = (options.apiBaseUrl ?? \"https://api.telegram.org\").replace(\n    /\\/$/,\n    \"\"\n  );\n  const maxLength = options.maxLength ?? TELEGRAM_MESSAGE_LIMIT;\n  if (\n    !Number.isInteger(maxLength) ||\n    maxLength < 1 ||\n    maxLength > TELEGRAM_MESSAGE_LIMIT\n  ) {\n    throw new Error(\n      `maxLength must be an integer between 1 and ${TELEGRAM_MESSAGE_LIMIT}`\n    );\n  }\n  const toText = options.toText ?? defaultText;\n  const streamIntervalMs =\n    options.streamIntervalMs ?? DEFAULT_STREAM_INTERVAL_MS;\n  if (!Number.isInteger(streamIntervalMs) || streamIntervalMs < 0) {\n    throw new Error(\"streamIntervalMs must be a non-negative integer\");\n  }\n  const botUserId = telegramBotUserId(options.botToken);\n  const ingress = options.webhook\n    ? telegramWebhook({ ...options.webhook, botUserId })\n    : undefined;\n\n  async function send(\n    destinationValue: ChannelMessageSurface,\n    text: string,\n    parseMode?: TelegramChannelOptions[\"parseMode\"]\n  ): Promise<DeliveryResult> {\n    const destination = telegramSurface(destinationValue);\n    if (\n      !destination ||\n      (botUserId !== undefined &&\n        destination.address.botUserId !== undefined &&\n        destination.address.botUserId !== botUserId)\n    ) {\n      return {\n        status: \"failed\",\n        retryable: false,\n        error: {\n          code: \"TELEGRAM_SURFACE_INVALID\",\n          message: `Telegram cannot parse the address for Channel \"${destinationValue.channelKey}\"`\n        }\n      };\n    }\n    if (textLength(text) > maxLength) {\n      return {\n        status: \"failed\",\n        retryable: false,\n        error: {\n          code: \"TELEGRAM_MESSAGE_TOO_LONG\",\n          message: `Telegram message exceeds the configured ${maxLength}-character limit`\n        }\n      };\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(\n        `${apiBaseUrl}/bot${options.botToken}/sendMessage`,\n        {\n          method: \"POST\",\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            chat_id: destination.address.chatId,\n            text,\n            ...(destination.address.messageThreadId !== undefined && {\n              message_thread_id: destination.address.messageThreadId\n            }),\n            ...(destination.address.replyToMessageId !== undefined && {\n              reply_parameters: {\n                message_id: destination.address.replyToMessageId\n              }\n            }),\n            ...(parseMode && { parse_mode: parseMode })\n          })\n        }\n      );\n    } catch {\n      return uncertain(\n        \"TELEGRAM_DELIVERY_ERROR\",\n        \"Telegram delivery failed with an unknown outcome\"\n      );\n    }\n\n    let payload: unknown;\n    try {\n      payload = await response.json();\n    } catch {\n      return uncertain(\n        \"TELEGRAM_DELIVERY_ERROR\",\n        \"Telegram returned an invalid delivery response\"\n      );\n    }\n\n    const apiResponse = asApiResponse(payload);\n    return apiResponse\n      ? classifyResponse(response, apiResponse)\n      : uncertain(\n          \"TELEGRAM_DELIVERY_ERROR\",\n          \"Telegram returned an invalid delivery response\"\n        );\n  }\n\n  /**\n   * Show one ephemeral preview. Failures are swallowed on purpose: a draft is\n   * a 30-second animation, and losing one must never cost the real message.\n   *\n   * The configured parse mode is deliberately not applied. A partial answer\n   * routinely holds unbalanced markup, which Telegram rejects outright.\n   */\n  async function sendDraft(\n    destination: TelegramMessageSurface,\n    draftId: number,\n    text: string\n  ): Promise<boolean> {\n    try {\n      const response = await fetch(\n        `${apiBaseUrl}/bot${options.botToken}/sendMessageDraft`,\n        {\n          method: \"POST\",\n          headers: { \"content-type\": \"application/json\" },\n          body: JSON.stringify({\n            chat_id: Number(destination.address.chatId),\n            draft_id: draftId,\n            text,\n            ...(destination.address.messageThreadId !== undefined && {\n              message_thread_id: destination.address.messageThreadId\n            })\n          })\n        }\n      );\n      return asApiResponse(await response.json())?.ok === true;\n    } catch {\n      return false;\n    }\n  }\n\n  /** Persist the answer, splitting it when it outgrows one Telegram message. */\n  async function sendComplete(\n    destination: ChannelMessageSurface,\n    text: string\n  ): Promise<DeliveryResult> {\n    const [head, ...tail] = splitText(text, maxLength);\n    // Raw HTML and Markdown cannot be partitioned safely without parsing it.\n    // Preserve all content literally rather than send malformed fragments.\n    const parseMode = tail.length === 0 ? options.parseMode : undefined;\n    const first = await send(destination, head!, parseMode);\n    if (first.status !== \"delivered\") return first;\n\n    for (const piece of tail) {\n      const result = await send(destination, piece, parseMode);\n      // A later piece failing still leaves earlier ones in the chat.\n      if (result.status !== \"delivered\") {\n        return uncertain(\n          \"TELEGRAM_STREAM_PARTIAL\",\n          \"Telegram accepted only part of a split answer\",\n          first.reference\n        );\n      }\n    }\n    return first;\n  }\n\n  async function streamMessage(\n    destinationValue: ChannelMessageSurface,\n    chunks: ReadableStream<ChannelChunk>,\n    streamOptions: ChannelStreamOptions\n  ): Promise<DeliveryResult> {\n    const destination = telegramSurface(destinationValue);\n    if (\n      !destination ||\n      (botUserId !== undefined &&\n        destination.address.botUserId !== undefined &&\n        destination.address.botUserId !== botUserId)\n    ) {\n      await chunks.cancel().catch(() => {});\n      return {\n        status: \"failed\",\n        retryable: false,\n        error: {\n          code: \"TELEGRAM_SURFACE_INVALID\",\n          message: `Telegram cannot parse the address for Channel \"${destinationValue.channelKey}\"`\n        }\n      };\n    }\n\n    const draftId = supportsDraft(destination.address.chatId)\n      ? newDraftId()\n      : undefined;\n    const prefix = streamOptions.title ? `${streamOptions.title}\\n\\n` : \"\";\n    const shouldPreview = createPacer(streamIntervalMs);\n    let answer = \"\";\n    let draftsStopped = draftId === undefined;\n\n    return consumeChunks(chunks, {\n      async onChunk(chunk) {\n        if (chunk.type !== \"text\" || chunk.text.length === 0) return;\n        answer += chunk.text;\n        if (draftsStopped || !shouldPreview()) return;\n        const preview = splitText(`${prefix}${answer}`, maxLength)[0] ?? \"\";\n        const shown = await sendDraft(destination, draftId!, preview);\n        if (!shown) draftsStopped = true;\n      },\n      async onFinish(outcome) {\n        // The draft is not the message. Without this send the reader's screen\n        // goes blank in thirty seconds and nothing is kept.\n        if (answer.length === 0) {\n          return {\n            status: \"failed\",\n            retryable: false,\n            error: outcome.interrupted\n              ? {\n                  code: \"TELEGRAM_STREAM_INTERRUPTED\",\n                  message: \"The answer ended before producing any text to send\"\n                }\n              : {\n                  code: \"TELEGRAM_STREAM_EMPTY\",\n                  message: \"The stream carried no text to send\"\n                }\n          };\n        }\n\n        const result = await sendComplete(destination, `${prefix}${answer}`);\n        if (!outcome.interrupted || result.status !== \"delivered\") {\n          return result;\n        }\n        return uncertain(\n          \"TELEGRAM_STREAM_INTERRUPTED\",\n          \"An incomplete answer was sent because the stream ended early\",\n          result.reference\n        );\n      }\n    });\n  }\n\n  return {\n    ...(options.route && { route: options.route }),\n    ...(ingress && { ingress }),\n    contactSurface(identity: ChannelIdentity) {\n      if ((identity.scope ?? \"default\") !== \"default\") return null;\n      const match = identity.subject.match(/^(user|chat):(-?\\d+)$/);\n      if (!match) return null;\n      return {\n        version: 1,\n        address: {\n          chatId: match[2],\n          ...(botUserId && { botUserId })\n        },\n        label: `Telegram · ${match[1]} ${match[2]}`\n      };\n    },\n    deliver(destination, message) {\n      return send(destination, toText(message), options.parseMode);\n    },\n    stream(destination, chunks, streamOptions) {\n      return streamMessage(destination, chunks, streamOptions);\n    },\n    requestApproval(destination, { interactionId, request }) {\n      if (interactionId.length === 0) {\n        return Promise.resolve({\n          status: \"failed\",\n          retryable: false,\n          error: {\n            code: \"TELEGRAM_INTERACTION_ID_REQUIRED\",\n            message:\n              \"Telegram approval requests require a non-empty interaction id\"\n          }\n        });\n      }\n      return send(destination, approvalText(interactionId, request));\n    }\n  };\n}\n"],"mappings":"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"}

package/dist/channels/voice.d.ts

@@ -0,0 +1,45 @@
+import {
+  F as ChannelMessageSurface,
+  n as Channel,
+  u as ChannelMessage
+} from "../channel-Bnm4S7T2.js";
+import { c as VoiceAudioFormat, n as TTSProvider } from "../types-_Faxb570.js";
+
+//#region src/channels/adapters/voice.d.ts
+type BrowserVoiceSurface = ChannelMessageSurface<
+  string,
+  {
+    connection: "current";
+  }
+>;
+/** The subset of an Agent WebSocket connection needed for audio delivery. */
+type BrowserVoiceConnection = {
+  id: string;
+  send(message: string | ArrayBuffer | ArrayBufferView): void;
+};
+/** Configuration for an output-only browser voice channel. */
+type BrowserVoiceChannelOptions = {
+  /** Text-to-speech provider used to synthesize each outbound message. */ tts: TTSProvider /** Return the browser voice surface to use, or undefined when unavailable. */;
+  getConnection: () =>
+    | BrowserVoiceConnection
+    | undefined /** Encoded audio format returned by the TTS provider. @default "mp3" */;
+  audioFormat?: VoiceAudioFormat /** Sample rate for raw PCM audio. Ignored by encoded formats. @default 16000 */;
+  sampleRate?: number /** Project the canonical Markdown message into text suitable for speech. */;
+  toSpeechText?: (message: ChannelMessage) => string;
+};
+/**
+ * Create an output-only channel that synthesizes one message and sends its
+ * encoded audio to one browser using the Cloudflare Voice wire protocol.
+ *
+ * The browser should connect with `VoiceClient` or `useVoiceAgent()`. No
+ * `withVoice()` mixin, microphone, or speech-to-text provider is required.
+ */
+declare function browserVoice(options: BrowserVoiceChannelOptions): Channel;
+//#endregion
+export {
+  BrowserVoiceChannelOptions,
+  BrowserVoiceConnection,
+  BrowserVoiceSurface,
+  browserVoice
+};
+//# sourceMappingURL=voice.d.ts.map