eve 0.83.2 → 0.84.0

package/dist/src/public/channels/telegram/index.d.ts

@@ -1,4 +1,3 @@
-export type { ModelMessage } from "ai";
 /**
  * Per-session instrumentation metadata for the Telegram channel, exposed to
  * observability tooling. The channel derives `chatId`, `chatType`, and
@@ -10,10 +9,9 @@ export interface TelegramInstrumentationMetadata extends Record<string, unknown>
     readonly chatType: import("#public/channels/telegram/inbound.js").TelegramChatType | null;
     readonly triggeringUserId: string | null;
 }
-export { telegramChannel, type TelegramChannel, type TelegramChannelConfig, type TelegramChannelCredentials, type TelegramChannelEvents, type TelegramChannelState, type TelegramContext, type TelegramEventContext, type TelegramHandle, type TelegramInboundResult, type TelegramInboundResultOrPromise, type TelegramReceiveTarget, } from "#public/channels/telegram/telegramChannel.js";
-export { callTelegramApi, answerTelegramCallbackQuery, downloadTelegramFile, editTelegramMessageReplyMarkup, editTelegramMessageText, getTelegramFile, resolveTelegramBotToken, sendTelegramChatAction, sendTelegramMessage, splitTelegramMessageText, telegramContinuationToken, TELEGRAM_MESSAGE_TEXT_MAX_LENGTH, type TelegramApiOptions, type TelegramApiResponse, type TelegramBotToken, type TelegramCredentials, type TelegramEphemeralMessageParameters, type TelegramFetch, type TelegramMessageBody, type TelegramMessageResult, } from "#public/channels/telegram/api.js";
-export { formatTelegramContextBlock, parseTelegramUpdate, type TelegramAttachment, type TelegramCallbackQuery, type TelegramChat, type TelegramChatType, type TelegramInboundContext, type TelegramMessage, type TelegramMessageReference, type TelegramUpdate, type TelegramUser, } from "#public/channels/telegram/inbound.js";
-export { TELEGRAM_CALLBACK_RESPONSE_PREFIX, TELEGRAM_HITL_CALLBACK_PREFIX, TELEGRAM_REPLY_RESPONSE_PREFIX, isTelegramSyntheticResponse, registerTelegramFreeformPrompt, renderTelegramInputRequest, resolveTelegramInputResponses, telegramCallbackInputResponse, telegramReplyInputResponse, type TelegramHitlState, type TelegramInputRequestMessage, } from "#public/channels/telegram/hitl.js";
-export { TELEGRAM_FILE_URL_PROTOCOL, buildTelegramTurnMessage, collectTelegramFileParts, createTelegramFetchFile, createTelegramFileUrl, } from "#public/channels/telegram/attachments.js";
+export { telegramChannel, type TelegramChannel, type TelegramChannelConfig, type TelegramChannelContext, type TelegramChannelCredentials, type TelegramChannelEvents, type TelegramChannelState, type TelegramContext, type TelegramEventContext, type TelegramHandle, type TelegramInboundResult, type TelegramReceiveTarget, } from "#public/channels/telegram/telegramChannel.js";
+export { telegramContinuationToken, type TelegramApiOptions, type TelegramApiResponse, type TelegramBotToken, type TelegramEphemeralMessageParameters, type TelegramFetch, type TelegramMessageBody, type TelegramMessageResult, } from "#public/channels/telegram/api.js";
+export { type TelegramAttachment, type TelegramCallbackQuery, type TelegramChat, type TelegramChatType, type TelegramInboundContext, type TelegramMessage, type TelegramMessageReference, type TelegramUpdate, type TelegramUser, } from "#public/channels/telegram/inbound.js";
+export { type TelegramHitlState, type TelegramInteractionMessage, } from "#public/channels/telegram/hitl.js";
 export { defaultTelegramAuth } from "#public/channels/telegram/defaults.js";
-export { resolveTelegramWebhookSecretToken, verifyTelegramRequest, type TelegramVerifyOptions, type TelegramWebhookSecretToken, type TelegramWebhookVerifier, } from "#public/channels/telegram/verify.js";
+export { type TelegramWebhookSecretToken, type TelegramWebhookVerifier, } from "#public/channels/telegram/verify.js";

package/dist/src/public/channels/telegram/index.js

@@ -1 +1 @@
-import{formatTelegramContextBlock,parseTelegramUpdate}from"#public/channels/telegram/inbound.js";import{TELEGRAM_MESSAGE_TEXT_MAX_LENGTH,answerTelegramCallbackQuery,callTelegramApi,downloadTelegramFile,editTelegramMessageReplyMarkup,editTelegramMessageText,getTelegramFile,resolveTelegramBotToken,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramContinuationToken}from"#public/channels/telegram/api.js";import{TELEGRAM_CALLBACK_RESPONSE_PREFIX,TELEGRAM_HITL_CALLBACK_PREFIX,TELEGRAM_REPLY_RESPONSE_PREFIX,isTelegramSyntheticResponse,registerTelegramFreeformPrompt,renderTelegramInputRequest,resolveTelegramInputResponses,telegramCallbackInputResponse,telegramReplyInputResponse}from"#public/channels/telegram/hitl.js";import{telegramChannel}from"#public/channels/telegram/telegramChannel.js";import{TELEGRAM_FILE_URL_PROTOCOL,buildTelegramTurnMessage,collectTelegramFileParts,createTelegramFetchFile,createTelegramFileUrl}from"#public/channels/telegram/attachments.js";import{defaultTelegramAuth}from"#public/channels/telegram/defaults.js";import{resolveTelegramWebhookSecretToken,verifyTelegramRequest}from"#public/channels/telegram/verify.js";export{TELEGRAM_CALLBACK_RESPONSE_PREFIX,TELEGRAM_FILE_URL_PROTOCOL,TELEGRAM_HITL_CALLBACK_PREFIX,TELEGRAM_MESSAGE_TEXT_MAX_LENGTH,TELEGRAM_REPLY_RESPONSE_PREFIX,answerTelegramCallbackQuery,buildTelegramTurnMessage,callTelegramApi,collectTelegramFileParts,createTelegramFetchFile,createTelegramFileUrl,defaultTelegramAuth,downloadTelegramFile,editTelegramMessageReplyMarkup,editTelegramMessageText,formatTelegramContextBlock,getTelegramFile,isTelegramSyntheticResponse,parseTelegramUpdate,registerTelegramFreeformPrompt,renderTelegramInputRequest,resolveTelegramBotToken,resolveTelegramInputResponses,resolveTelegramWebhookSecretToken,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramCallbackInputResponse,telegramChannel,telegramContinuationToken,telegramReplyInputResponse,verifyTelegramRequest};
+import{telegramContinuationToken}from"#public/channels/telegram/api.js";import{telegramChannel}from"#public/channels/telegram/telegramChannel.js";import{defaultTelegramAuth}from"#public/channels/telegram/defaults.js";export{defaultTelegramAuth,telegramChannel,telegramContinuationToken};

package/dist/src/public/channels/telegram/telegramChannel.d.ts

@@ -1,27 +1,23 @@
+import type { TelegramChannelCredentials } from "#public/channels/telegram/credentials.js";
+export type { TelegramChannelCredentials } from "#public/channels/telegram/credentials.js";
+import type { ChannelEventContext, ChannelEventOf } from "#public/definitions/channel.js";
+import type { SessionEvent } from "#protocol/session-event.js";
 import type { TelegramInstrumentationMetadata } from "#public/channels/telegram/index.js";
 import type { SessionHistoryMessage } from "#shared/session-history.js";
 import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
-import type { SessionContext } from "#public/definitions/callback-context.js";
 import type { ChannelContinuationOps } from "#public/definitions/channel.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import { type TelegramApiOptions, type TelegramApiResponse, type TelegramCredentials, type TelegramMessageBody, type TelegramMessageResult } from "#public/channels/telegram/api.js";
+import { type TelegramApiOptions, type TelegramApiResponse, type TelegramMessageBody, type TelegramMessageResult } from "#public/channels/telegram/api.js";
 import { type TelegramHitlState } from "#public/channels/telegram/hitl.js";
 import { type TelegramCallbackQuery, type TelegramChatType, type TelegramMessage } from "#public/channels/telegram/inbound.js";
 import { type UploadPolicyInput } from "#public/channels/upload-policy.js";
-import { type TelegramWebhookSecretToken, type TelegramWebhookVerifier } from "#public/channels/telegram/verify.js";
 import { type Channel } from "#public/definitions/channel.js";
 import { type JsonObject } from "#shared/json.js";
-type EventData<T extends UnstampedMessageStreamEvent["type"]> = Extract<UnstampedMessageStreamEvent, {
-    type: T;
-}> extends {
-    data: infer D;
-} ? D : undefined;
 /** Minimal Telegram context (only `telegram`, no `state` or session ops), passed to `onMessage` and `onCallbackQuery` hooks before a session exists. Event handlers receive the richer {@link TelegramEventContext}. */
 export interface TelegramContext {
     readonly telegram: TelegramHandle;
 }
 /** Channel-owned Telegram context returned by `context()`. */
-interface TelegramChannelContext extends TelegramContext {
+export interface TelegramChannelContext extends TelegramContext {
     state: TelegramChannelState;
 }
 /** Event-handler Telegram context, including continuation routing. */
@@ -50,11 +46,6 @@ export interface TelegramChannelState extends TelegramHitlState {
     pendingAuthMessageIds?: Record<string, string>;
 }
 /** Telegram channel credentials. `webhookVerifier` is a custom inbound webhook verifier for forwarded webhooks. */
-export interface TelegramChannelCredentials extends TelegramCredentials {
-    /** Webhook secret token configured via setWebhook. Falls back to `TELEGRAM_WEBHOOK_SECRET_TOKEN` when neither this nor `webhookVerifier` is set. */
-    readonly webhookSecretToken?: TelegramWebhookSecretToken;
-    readonly webhookVerifier?: TelegramWebhookVerifier;
-}
 /** Target for `receive(telegram, { target })` proactive sessions. `chatId` is required. `conversationId` resumes an existing thread; `initialMessage` posts a seed message and starts a new thread from it. The two are mutually exclusive: supplying both throws. */
 export interface TelegramReceiveTarget {
     readonly chatId: number | string;
@@ -72,27 +63,24 @@ export type TelegramInboundResult = {
     readonly title?: string;
 } | null;
 /** Sync or async {@link TelegramInboundResult}. */
-export type TelegramInboundResultOrPromise = TelegramInboundResult | Promise<TelegramInboundResult>;
-type TelegramEventHandler<T extends UnstampedMessageStreamEvent["type"]> = (data: EventData<T>, channel: TelegramEventContext, ctx: SessionContext) => void | Promise<void>;
-type TelegramSessionFailedHandler = (data: EventData<"session.failed">, channel: TelegramEventContext) => void | Promise<void>;
-/** Per-event handlers for `telegramChannel({ events })`. Each entry overrides the built-in default (handlers merge over {@link defaultEvents}). `session.failed` receives `(data, channel)` and exposes the ID as `data.sessionId`; all others also receive the {@link SessionContext}. */
+type TelegramEventHandler<T extends SessionEvent["type"]> = (event: ChannelEventOf<T>, ctx: ChannelEventContext<TelegramEventContext>) => void | Promise<void>;
+/**
+ * Per-event handlers for `telegramChannel({ events })`. Each entry overrides the built-in default
+ * (handlers merge over {@link defaultEvents}). Every handler receives the event and a `ctx` whose
+ * `channel` is the Telegram context.
+ */
 export interface TelegramChannelEvents {
     readonly "turn.started"?: TelegramEventHandler<"turn.started">;
-    readonly "actions.requested"?: TelegramEventHandler<"actions.requested">;
-    readonly "action.partial"?: TelegramEventHandler<"action.partial">;
-    readonly "action.result"?: TelegramEventHandler<"action.result">;
-    readonly "message.completed"?: TelegramEventHandler<"message.completed">;
-    readonly "message.appended"?: TelegramEventHandler<"message.appended">;
-    readonly "input.requested"?: TelegramEventHandler<"input.requested">;
-    readonly "input.resolved"?: TelegramEventHandler<"input.resolved">;
-    readonly "turn.failed"?: TelegramEventHandler<"turn.failed">;
-    readonly "turn.completed"?: TelegramEventHandler<"turn.completed">;
-    readonly "turn.cancelled"?: TelegramEventHandler<"turn.cancelled">;
-    readonly "session.failed"?: TelegramSessionFailedHandler;
-    readonly "session.completed"?: TelegramEventHandler<"session.completed">;
-    readonly "session.waiting"?: TelegramEventHandler<"session.waiting">;
-    readonly "authorization.required"?: TelegramEventHandler<"authorization.required">;
-    readonly "authorization.completed"?: TelegramEventHandler<"authorization.completed">;
+    readonly "call.requested"?: TelegramEventHandler<"call.requested">;
+    readonly "call.progress"?: TelegramEventHandler<"call.progress">;
+    readonly "call.settled"?: TelegramEventHandler<"call.settled">;
+    readonly "content.completed"?: TelegramEventHandler<"content.completed">;
+    readonly "content.delta"?: TelegramEventHandler<"content.delta">;
+    readonly "interaction.opened"?: TelegramEventHandler<"interaction.opened">;
+    readonly "interaction.settled"?: TelegramEventHandler<"interaction.settled">;
+    readonly "turn.settled"?: TelegramEventHandler<"turn.settled">;
+    readonly "session.ended"?: TelegramEventHandler<"session.ended">;
+    readonly "delivery.settled"?: TelegramEventHandler<"delivery.settled">;
 }
 /** Configuration for {@link telegramChannel}. */
 export interface TelegramChannelConfig {
@@ -107,7 +95,7 @@ export interface TelegramChannelConfig {
     /** Handler for non-HITL callback queries. */
     readonly onCallbackQuery?: (ctx: TelegramContext, query: TelegramCallbackQuery) => void | Promise<void>;
     /** Inbound message hook. Defaults to Telegram user auth and dispatch gating. */
-    readonly onMessage?: (ctx: TelegramContext, message: TelegramMessage) => TelegramInboundResultOrPromise;
+    readonly onMessage?: (ctx: TelegramContext, message: TelegramMessage) => TelegramInboundResult | Promise<TelegramInboundResult>;
     /** Override the default webhook route path (`/eve/v1/telegram`). */
     readonly route?: string;
     /** Policy for accepted messages that arrive while a turn is active. */
@@ -150,4 +138,3 @@ export interface TelegramChannel extends Channel<TelegramChannelState, TelegramR
 }
 /** Telegram channel factory for webhook updates and proactive messages. */
 export declare function telegramChannel(config?: TelegramChannelConfig): TelegramChannel;
-export {};

package/dist/src/public/channels/telegram/telegramChannel.js

@@ -1 +1 @@
-import{createLogger,logError}from"#internal/logging.js";import{isCompiledChannel}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{parseJsonObject}from"#shared/json.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{INACTIVE_REQUEST_NOTICE,respondOrRetireInactivePrompt}from"#channel/inactive-prompt.js";import{formatTelegramContextBlock,parseTelegramUpdate}from"#public/channels/telegram/inbound.js";import{answerTelegramCallbackQuery,callTelegramApi,editTelegramMessageReplyMarkup,editTelegramMessageText,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramContinuationToken}from"#public/channels/telegram/api.js";import{TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX}from"#public/channels/telegram/authorization.js";import{TELEGRAM_HITL_CALLBACK_PREFIX,isTelegramSyntheticResponse,resolveTelegramInputResponses,telegramCallbackInputResponse,telegramReplyInputResponses,telegramResolvedPromptText}from"#public/channels/telegram/hitl.js";import{buildTelegramTurnMessage,collectTelegramFileParts,createTelegramFetchFile}from"#public/channels/telegram/attachments.js";import{defaultEvents,defaultOnMessage,defaultTelegramAuth,isTelegramBotMentioned}from"#public/channels/telegram/defaults.js";import{verifyTelegramRequest}from"#public/channels/telegram/verify.js";import{dispatchTelegramAuthorizationCallback}from"#public/channels/telegram/authorization-callback.js";import{initialTelegramState,stateFromTelegramCallbackQuery,stateFromTelegramMessage,telegramContinuationTokenFromState}from"#public/channels/telegram/state.js";import{telegramInstrumentation}from"#public/channels/telegram/audience.js";const log=createLogger(`telegram.channel`);function telegramChannel(e={}){let t=mergeUploadPolicy(e.uploadPolicy),n=e.onMessage??defaultOnMessage,r={...defaultEvents,...e.events},i=defineChannel({kindHint:`telegram`,turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:initialTelegramState(e.botUsername),...telegramInstrumentation,fetchFile:createTelegramFetchFile({api:e.api,credentials:e.credentials,policy:t}),context(t,n){return rebuildTelegramContext(t,n,e)},routes:[POST(e.route??`/eve/v1/telegram`,async(r,{from:i,resolveSession:a,waitUntil:o})=>{let s=await verifyInbound(r,e.credentials);if(s===null)return new Response(`unauthorized`,{status:401});let c;try{c=parseJsonObject(JSON.parse(s))}catch(e){return log.warn(`inbound Telegram body is not valid JSON`,{error:e}),new Response(`ok`)}let l=parseTelegramUpdate(c);return l===null?new Response(`ok`):l.kind===`message`?(o(dispatchMessage({config:e,message:l.message,onMessage:n,uploadPolicy:t,from:i})),new Response(`ok`)):(o(dispatchCallbackQuery({config:e,query:l.callbackQuery,from:i,resolveSession:a})),new Response(`ok`))})],async receive(t,{from:n}){let r=t.target,i=readChatId(r.chatId);if(i===void 0)throw Error(`telegramChannel().receive requires target.chatId.`);let a=typeof r.messageThreadId==`number`?r.messageThreadId:void 0,o=readChatId(r.conversationId),s=r.initialMessage;if(s!==void 0&&o!==void 0)throw Error("telegramChannel().receive: `conversationId` and `initialMessage` are mutually exclusive.");let c={...initialTelegramState(e.botUsername),chatId:i,conversationId:o??null,messageThreadId:a??null};return s!==void 0&&await buildTelegramHandle({config:e,state:c}).sendMessage(s),n(telegramContinuationTokenFromState(c)).send(t.message,{auth:t.auth,state:c})},events:r});return attachTelegramDeliver(i),i}function rebuildTelegramContext(e,t,n){return{state:e,telegram:buildTelegramHandle({config:n,session:t,state:e})}}function buildTelegramHandle(e){let t=e.config.api,n=e.state,r=e.config.credentials;function anchor(t){let r=n.chatType??t.chatType??null;n.chatType===null&&t.chatType!==void 0&&(n.chatType=t.chatType),t.id&&shouldAnchorTelegramConversation(r)&&(n.conversationId=t.id,n.chatId&&e.session?.continuation?.alias(telegramContinuationToken({chatId:n.chatId,conversationId:t.id,messageThreadId:n.messageThreadId??void 0})))}async function sendOne(e){let t=await sendMessage(e);return anchor(t),t}async function sendMessage(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for outbound message.`);return sendTelegramMessage({apiBaseUrl:t?.apiBaseUrl,body:{...e,message_thread_id:e.message_thread_id??n.messageThreadId??void 0},credentials:r,fetch:t?.fetch,fileBaseUrl:t?.fileBaseUrl,chatId:i})}return{botUsername:n.botUsername??e.config.botUsername,chatId:n.chatId??``,chatType:n.chatType??void 0,conversationId:n.conversationId??void 0,messageThreadId:n.messageThreadId??void 0,answerCallbackQuery(e){return answerTelegramCallbackQuery({apiBaseUrl:t?.apiBaseUrl,callbackQueryId:e.callbackQueryId,credentials:r,fetch:t?.fetch,showAlert:e.showAlert,text:e.text})},editMessageReplyMarkup(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for reply-markup edit.`);return editTelegramMessageReplyMarkup({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup})},editMessageText(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for text edit.`);return editTelegramMessageText({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup,text:e.text})},post(e){return postTelegramMessage(e,sendOne)},postEphemeral(e,t,n){return postTelegramMessage({...typeof t==`string`?{text:t}:t,ephemeral_message_parameters:{...n?.callbackQueryId===void 0?{}:{callback_query_id:n.callbackQueryId},receiver_user_id:e}},sendMessage)},request(e,n){return callTelegramApi({apiBaseUrl:t?.apiBaseUrl,body:n,botToken:r?.botToken,fetch:t?.fetch,method:e})},sendMessage(e){return postTelegramMessage(e,sendOne)},async startTyping(e=`typing`){let i=n.chatId??``;if(i)try{await sendTelegramChatAction({action:e,apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageThreadId:n.messageThreadId??void 0})}catch(e){logError(log,`Telegram typing indicator failed — swallowed`,e,{chatId:i})}}}}function shouldAnchorTelegramConversation(e){return e===`group`||e===`supergroup`}async function postTelegramMessage(e,t){let n=typeof e==`string`?{text:e}:e,r=splitTelegramMessageText(n.text),i;for(let[e,a]of r.entries()){let r=await t(e===0?{...n,text:a}:{...n.ephemeral_message_parameters===void 0?{}:{ephemeral_message_parameters:n.ephemeral_message_parameters},text:a});i===void 0&&(i=r)}return i??{id:``,raw:null}}async function verifyInbound(e,t){try{return await verifyTelegramRequest(e,{secretToken:t?.webhookVerifier?void 0:t?.webhookSecretToken,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`telegram inbound verification failed`,{error:e}),null}}async function dispatchMessage(e){if(e.message.from?.isBot===!0)return;let t=stateFromTelegramMessage(e.message,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})},r;try{r=await e.onMessage(n,e.message)}catch(e){log.error(`message handler failed`,{error:e});return}if(r==null)return;let i=collectTelegramFileParts(e.message.attachments,e.uploadPolicy),a=buildTelegramTurnMessage(e.message,i),o=formatTelegramContextBlock({botUsername:e.config.botUsername,chatId:e.message.chat.id,chatTitle:e.message.chat.title,chatType:e.message.chat.type,isMentioned:isTelegramBotMentioned(e.message,e.config.botUsername),messageId:e.message.messageId,messageThreadId:e.message.messageThreadId,userId:e.message.from?.id,username:e.message.from?.username}),s=r.context??[];try{await e.from(telegramContinuationTokenFromState(t)).send(a,{auth:r.auth,context:[o,...s],history:r.history,state:t,title:r.title})}catch(e){log.error(`message delivery failed`,{error:e})}}async function dispatchCallbackQuery(e){let t=stateFromTelegramCallbackQuery(e.query,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})};if(e.query.data?.startsWith(TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX)===!0){await dispatchTelegramAuthorizationCallback({continuationToken:telegramContinuationTokenFromState(t),query:e.query,resolveSession:e.resolveSession,state:t,telegram:n});return}if(e.query.data?.startsWith(TELEGRAM_HITL_CALLBACK_PREFIX)===!0){let r=e.query.message,i=e.query.data,a=r&&t.chatId?await respondOrRetireInactivePrompt(()=>e.from(telegramContinuationTokenFromState(t)).respond([telegramCallbackInputResponse(i)],{auth:defaultTelegramAuth({...r,from:e.query.from})}),{retirePrompt:e=>retireInactivePrompt(n,r,e)},log):void 0;try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:a?.outcome===`inactive`?INACTIVE_REQUEST_NOTICE:`Answer received.`})}catch(e){log.warn(`Telegram callback-query acknowledgement failed`,{error:e})}a?.outcome===`inactive`&&await a.retirement;return}if(e.config.onCallbackQuery!==void 0){try{await e.config.onCallbackQuery(n,e.query)}catch(e){log.error(`custom callback-query handler failed`,{error:e})}return}try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:`Unsupported action.`})}catch(e){log.warn(`Telegram unsupported callback-query acknowledgement failed`,{error:e})}}async function retireInactivePrompt(e,t,n){let r={inline_keyboard:[]};if(t.text===void 0){await e.telegram.editMessageReplyMarkup({messageId:t.messageId,replyMarkup:r});return}await e.telegram.editMessageText({messageId:t.messageId,replyMarkup:r,text:telegramResolvedPromptText(t.text,n)})}function attachTelegramDeliver(e){if(!isCompiledChannel(e))return;let t=e.adapter;t.deliver=(e,t)=>{let n=e.state,r=[...e.inputResponses??[],...telegramReplyInputResponses(n?.replyToBotMessageId,e.message)];if(r.some(isTelegramSyntheticResponse)){let n=resolveTelegramInputResponses(t.state,r);return n.length>0?{inputResponses:n,context:e.context}:e.message===void 0?void 0:{message:e.message,context:e.context}}return defaultDeliverResult(e)}}function readChatId(e){if(typeof e==`string`&&e.length>0)return e;if(typeof e==`number`&&Number.isFinite(e))return String(e)}export{telegramChannel};
+import{createLogger,logError}from"#internal/logging.js";import{isCompiledChannel}from"#channel/compiled-channel.js";import{defaultDeliverResult}from"#channel/adapter.js";import{parseJsonObject}from"#shared/json.js";import{POST,defineChannel}from"#public/definitions/channel.js";import{mergeUploadPolicy}from"#public/channels/upload-policy.js";import{INACTIVE_REQUEST_NOTICE,respondOrRetireInactivePrompt}from"#channel/inactive-prompt.js";import{formatTelegramContextBlock,parseTelegramUpdate}from"#public/channels/telegram/inbound.js";import{answerTelegramCallbackQuery,callTelegramApi,editTelegramMessageReplyMarkup,editTelegramMessageText,sendTelegramChatAction,sendTelegramMessage,splitTelegramMessageText,telegramContinuationToken}from"#public/channels/telegram/api.js";import{TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX}from"#public/channels/telegram/authorization.js";import{TELEGRAM_HITL_CALLBACK_PREFIX,isTelegramSyntheticResponse,resolveTelegramAnswers,telegramCallbackAnswer,telegramReplyAnswers,telegramResolvedPromptText}from"#public/channels/telegram/hitl.js";import{defaultEvents,defaultOnMessage,defaultTelegramAuth,isTelegramBotMentioned}from"#public/channels/telegram/defaults.js";import{dispatchTelegramAuthorizationCallback}from"#public/channels/telegram/authorization-callback.js";import{buildTelegramTurnMessage,collectTelegramFileParts,createTelegramFetchFile}from"#public/channels/telegram/attachments.js";import{initialTelegramState,stateFromTelegramCallbackQuery,stateFromTelegramMessage,telegramContinuationTokenFromState}from"#public/channels/telegram/state.js";import{verifyTelegramRequest}from"#public/channels/telegram/verify.js";import{telegramInstrumentation}from"#public/channels/telegram/audience.js";const log=createLogger(`telegram.channel`);function telegramChannel(e={}){let t=mergeUploadPolicy(e.uploadPolicy),n=e.onMessage??defaultOnMessage,r={...defaultEvents,...e.events},i=defineChannel({turnPolicy:e.turnPolicy,uploadPolicy:e.uploadPolicy,state:initialTelegramState(e.botUsername),...telegramInstrumentation,fetchFile:createTelegramFetchFile({api:e.api,credentials:e.credentials,policy:t}),context(t,n){return rebuildTelegramContext(t,n,e)},routes:[POST(e.route??`/eve/v1/telegram`,async(r,{from:i,resolveSession:a,waitUntil:o})=>{let s=await verifyInbound(r,e.credentials);if(s===null)return new Response(`unauthorized`,{status:401});let c;try{c=parseJsonObject(JSON.parse(s))}catch(e){return log.warn(`inbound Telegram body is not valid JSON`,{error:e}),new Response(`ok`)}let l=parseTelegramUpdate(c);return l===null?new Response(`ok`):l.kind===`message`?(o(dispatchMessage({config:e,message:l.message,onMessage:n,uploadPolicy:t,from:i})),new Response(`ok`)):(o(dispatchCallbackQuery({config:e,query:l.callbackQuery,from:i,resolveSession:a})),new Response(`ok`))})],async receive(t,{from:n}){let r=t.target,i=readChatId(r.chatId);if(i===void 0)throw Error(`telegramChannel().receive requires target.chatId.`);let a=typeof r.messageThreadId==`number`?r.messageThreadId:void 0,o=readChatId(r.conversationId),s=r.initialMessage;if(s!==void 0&&o!==void 0)throw Error("telegramChannel().receive: `conversationId` and `initialMessage` are mutually exclusive.");let c={...initialTelegramState(e.botUsername),chatId:i,conversationId:o??null,messageThreadId:a??null};return s!==void 0&&await buildTelegramHandle({config:e,state:c}).sendMessage(s),n(telegramContinuationTokenFromState(c)).send(t.message,{auth:t.auth,state:c})},events:r});return attachTelegramDeliver(i),i}function rebuildTelegramContext(e,t,n){return{state:e,telegram:buildTelegramHandle({config:n,session:t,state:e})}}function buildTelegramHandle(e){let t=e.config.api,n=e.state,r=e.config.credentials;function anchor(t){let r=n.chatType??t.chatType??null;n.chatType===null&&t.chatType!==void 0&&(n.chatType=t.chatType),t.id&&shouldAnchorTelegramConversation(r)&&(n.conversationId=t.id,n.chatId&&e.session?.continuation?.alias(telegramContinuationToken({chatId:n.chatId,conversationId:t.id,messageThreadId:n.messageThreadId??void 0})))}async function sendOne(e){let t=await sendMessage(e);return anchor(t),t}async function sendMessage(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for outbound message.`);return sendTelegramMessage({apiBaseUrl:t?.apiBaseUrl,body:{...e,message_thread_id:e.message_thread_id??n.messageThreadId??void 0},credentials:r,fetch:t?.fetch,fileBaseUrl:t?.fileBaseUrl,chatId:i})}return{botUsername:n.botUsername??e.config.botUsername,chatId:n.chatId??``,chatType:n.chatType??void 0,conversationId:n.conversationId??void 0,messageThreadId:n.messageThreadId??void 0,answerCallbackQuery(e){return answerTelegramCallbackQuery({apiBaseUrl:t?.apiBaseUrl,callbackQueryId:e.callbackQueryId,credentials:r,fetch:t?.fetch,showAlert:e.showAlert,text:e.text})},editMessageReplyMarkup(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for reply-markup edit.`);return editTelegramMessageReplyMarkup({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup})},editMessageText(e){let i=n.chatId??``;if(!i)throw Error(`telegramChannel: missing chat id for text edit.`);return editTelegramMessageText({apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageId:e.messageId,replyMarkup:e.replyMarkup,text:e.text})},post(e){return postTelegramMessage(e,sendOne)},postEphemeral(e,t,n){return postTelegramMessage({...typeof t==`string`?{text:t}:t,ephemeral_message_parameters:{...n?.callbackQueryId===void 0?{}:{callback_query_id:n.callbackQueryId},receiver_user_id:e}},sendMessage)},request(e,n){return callTelegramApi({apiBaseUrl:t?.apiBaseUrl,body:n,botToken:r?.botToken,fetch:t?.fetch,method:e})},sendMessage(e){return postTelegramMessage(e,sendOne)},async startTyping(e=`typing`){let i=n.chatId??``;if(i)try{await sendTelegramChatAction({action:e,apiBaseUrl:t?.apiBaseUrl,chatId:i,credentials:r,fetch:t?.fetch,messageThreadId:n.messageThreadId??void 0})}catch(e){logError(log,`Telegram typing indicator failed — swallowed`,e,{chatId:i})}}}}function shouldAnchorTelegramConversation(e){return e===`group`||e===`supergroup`}async function postTelegramMessage(e,t){let n=typeof e==`string`?{text:e}:e,r=splitTelegramMessageText(n.text),i;for(let[e,a]of r.entries()){let r=await t(e===0?{...n,text:a}:{...n.ephemeral_message_parameters===void 0?{}:{ephemeral_message_parameters:n.ephemeral_message_parameters},text:a});i===void 0&&(i=r)}return i??{id:``,raw:null}}async function verifyInbound(e,t){try{return await verifyTelegramRequest(e,{secretToken:t?.webhookVerifier?void 0:t?.webhookSecretToken,webhookVerifier:t?.webhookVerifier})}catch(e){return log.warn(`telegram inbound verification failed`,{error:e}),null}}async function dispatchMessage(e){if(e.message.from?.isBot===!0)return;let t=stateFromTelegramMessage(e.message,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})},r;try{r=await e.onMessage(n,e.message)}catch(e){log.error(`message handler failed`,{error:e});return}if(r==null)return;let i=collectTelegramFileParts(e.message.attachments,e.uploadPolicy),a=buildTelegramTurnMessage(e.message,i),o=formatTelegramContextBlock({botUsername:e.config.botUsername,chatId:e.message.chat.id,chatTitle:e.message.chat.title,chatType:e.message.chat.type,isMentioned:isTelegramBotMentioned(e.message,e.config.botUsername),messageId:e.message.messageId,messageThreadId:e.message.messageThreadId,userId:e.message.from?.id,username:e.message.from?.username}),s=r.context??[];try{await e.from(telegramContinuationTokenFromState(t)).send(a,{auth:r.auth,context:[o,...s],history:r.history,state:t,title:r.title})}catch(e){log.error(`message delivery failed`,{error:e})}}async function dispatchCallbackQuery(e){let t=stateFromTelegramCallbackQuery(e.query,e.config.botUsername),n={telegram:buildTelegramHandle({config:e.config,state:t})};if(e.query.data?.startsWith(TELEGRAM_AUTHORIZATION_CALLBACK_PREFIX)===!0){await dispatchTelegramAuthorizationCallback({continuationToken:telegramContinuationTokenFromState(t),query:e.query,resolveSession:e.resolveSession,state:t,telegram:n});return}if(e.query.data?.startsWith(TELEGRAM_HITL_CALLBACK_PREFIX)===!0){let r=e.query.message,i=e.query.data,a=r&&t.chatId?await respondOrRetireInactivePrompt(()=>e.from(telegramContinuationTokenFromState(t)).respond([telegramCallbackAnswer(i)],{auth:defaultTelegramAuth({...r,from:e.query.from})}),{retirePrompt:e=>retireInactivePrompt(n,r,e)},log):void 0;try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:a?.outcome===`inactive`?INACTIVE_REQUEST_NOTICE:`Answer received.`})}catch(e){log.warn(`Telegram callback-query acknowledgement failed`,{error:e})}a?.outcome===`inactive`&&await a.retirement;return}if(e.config.onCallbackQuery!==void 0){try{await e.config.onCallbackQuery(n,e.query)}catch(e){log.error(`custom callback-query handler failed`,{error:e})}return}try{await n.telegram.answerCallbackQuery({callbackQueryId:e.query.id,text:`Unsupported action.`})}catch(e){log.warn(`Telegram unsupported callback-query acknowledgement failed`,{error:e})}}async function retireInactivePrompt(e,t,n){let r={inline_keyboard:[]};if(t.text===void 0){await e.telegram.editMessageReplyMarkup({messageId:t.messageId,replyMarkup:r});return}await e.telegram.editMessageText({messageId:t.messageId,replyMarkup:r,text:telegramResolvedPromptText(t.text,n)})}function attachTelegramDeliver(e){if(!isCompiledChannel(e))return;let t=e.adapter;t.deliver=(e,t)=>{let n=e.state,r=[...e.answers??[],...telegramReplyAnswers(n?.replyToBotMessageId,e.message)];if(r.some(isTelegramSyntheticResponse)){let n=resolveTelegramAnswers(t.state,r);return n.length>0?{answers:n,context:e.context}:e.message===void 0?void 0:{message:e.message,context:e.context}}return defaultDeliverResult(e)}}function readChatId(e){if(typeof e==`string`&&e.length>0)return e;if(typeof e==`number`&&Number.isFinite(e))return String(e)}export{telegramChannel};

package/dist/src/public/channels/text.d.ts

@@ -0,0 +1,4 @@
+/** Caps `value` at `maxLength` characters, ending a cut value with `...`. */
+export declare function truncate(value: string, maxLength: number): string;
+/** `values` in consecutive groups of `size`. */
+export declare function chunk<T>(values: readonly T[], size: number): T[][];

package/dist/src/public/channels/text.js

@@ -0,0 +1 @@
+function truncate(e,t){return t<=0?``:e.length<=t?e:`${e.slice(0,Math.max(0,t-3)).trimEnd()}...`}function chunk(e,t){let n=[];for(let r=0;r<e.length;r+=t)n.push(e.slice(r,r+t));return n}export{chunk,truncate};

package/dist/src/public/channels/twilio/api.d.ts

@@ -1,22 +1,22 @@
+import type { TwilioChannelCredentials } from "#public/channels/twilio/credentials.js";
+export type { TwilioChannelCredentials } from "#public/channels/twilio/credentials.js";
 import { type TwilioApiResponse, type TwilioCredential, type TwilioFetch } from "#compiled/@chat-adapter/twilio/api.js";
 import type { FetchFileResult } from "#channel/adapter.js";
-import { type TwilioAuthToken } from "#public/channels/twilio/verify.js";
 /**
  * Builds the Twilio channel-local continuation token (`<from>:<to>`).
  * Eve namespaces this with the channel name before handing it to the runtime.
  */
-export declare function twilioContinuationToken(from: string, to: string | undefined): string;
+export declare function twilioContinuationToken({ from, to, }: {
+    readonly from: string;
+    readonly to?: string | undefined;
+}): string;
 /** Twilio Account SID, materialized directly or from an async secret provider. */
 export type TwilioAccountSid = TwilioCredential;
 export type { TwilioApiResponse, TwilioFetch };
 /** Credentials used for Twilio REST API calls and webhook verification. */
-export interface TwilioCredentials {
-    readonly accountSid?: TwilioAccountSid;
-    readonly authToken?: TwilioAuthToken;
-}
 /** Shared Twilio REST API options. */
 export interface TwilioApiOptions {
-    readonly credentials?: TwilioCredentials;
+    readonly credentials?: TwilioChannelCredentials;
     readonly apiBaseUrl?: string;
     readonly fetch?: TwilioFetch;
 }
@@ -42,7 +42,7 @@ export declare function resolveTwilioAccountSid(accountSid?: TwilioAccountSid):
  * behavior: non-2xx Twilio responses become `{ ok: false, status, body }`.
  */
 export declare function callTwilioApi(input: {
-    readonly credentials?: TwilioCredentials;
+    readonly credentials?: TwilioChannelCredentials;
     readonly apiBaseUrl?: string;
     readonly fetch?: TwilioFetch;
     readonly path: string;

package/dist/src/public/channels/twilio/api.js

@@ -1 +1 @@
-import{DEFAULT_UPLOAD_POLICY}from"#public/channels/upload-policy.js";import{EveAttachmentError}from"#internal/attachments/errors.js";import{limitedFetch}from"#internal/attachments/limited-read.js";import{TwilioApiError,callTwilioApi as callTwilioApi$1,encodeTwilioForm,fetchTwilioMedia,resolveTwilioCredential}from"#compiled/@chat-adapter/twilio/api.js";import{resolveTwilioAuthToken}from"#public/channels/twilio/verify.js";function twilioContinuationToken(e,t){return`${e}:${t??``}`}async function resolveTwilioAccountSid(e){try{return await resolveTwilioCredential(e,`TWILIO_ACCOUNT_SID`)}catch(e){throw e instanceof TwilioApiError&&e.status===0?Error(`TWILIO_ACCOUNT_SID is required.`):e}}async function callTwilioApi(e){let t=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm(e.body),credentials:t,fetch:e.fetch,path:e.path}))}async function sendTwilioMessage(e){if(!e.from&&!e.messagingServiceSid)throw Error(`twilioChannel: sending a message requires from or messagingServiceSid.`);let t=await resolveTwilioAccountSid(e.credentials?.accountSid),n=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm({Body:e.body,From:e.from,MessagingServiceSid:e.messagingServiceSid,StatusCallback:e.statusCallbackUrl,To:e.to}),credentials:n,fetch:e.fetch,path:`/2010-04-01/Accounts/${encodeURIComponent(t)}/Messages.json`}))}async function updateTwilioCall(e){let t=await resolveTwilioAccountSid(e.credentials?.accountSid),n=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm({Twiml:e.twiml}),credentials:n,fetch:e.fetch,path:`/2010-04-01/Accounts/${encodeURIComponent(t)}/Calls/${encodeURIComponent(e.callSid)}.json`}))}function createTwilioFetchFile(e){let t=new URL(e.apiBaseUrl??`https://api.twilio.com`).origin;return async n=>{if(URL.parse(n)?.origin!==t)return null;try{let t=await fetchTwilioMedia({apiBaseUrl:e.apiBaseUrl,credentials:await resolveCredentials(e.credentials),fetch:limitedFetch(e.fetch??fetch,DEFAULT_UPLOAD_POLICY.maxBytes,`twilio`),url:n});return{bytes:Buffer.from(t)}}catch(e){throw e instanceof EveAttachmentError?e:new EveAttachmentError({adapterKind:`twilio`,cause:e,kind:`resolver-threw`,message:e instanceof TwilioApiError&&e.status!==0?`Twilio media fetch returned HTTP ${e.status}.`:`Twilio media fetch failed.`})}}}async function resolveCredentials(e){return{accountSid:await resolveTwilioAccountSid(e?.accountSid),authToken:await resolveTwilioAuthToken(e?.authToken)}}async function preserveTwilioApiResponse(e){try{return await e}catch(e){if(e instanceof TwilioApiError&&e.status!==0)return{body:e.body,ok:!1,status:e.status};throw e}}export{callTwilioApi,createTwilioFetchFile,resolveTwilioAccountSid,sendTwilioMessage,twilioContinuationToken,updateTwilioCall};
+import{DEFAULT_UPLOAD_POLICY}from"#public/channels/upload-policy.js";import{EveAttachmentError}from"#internal/attachments/errors.js";import{limitedFetch}from"#internal/attachments/limited-read.js";import{TwilioApiError,callTwilioApi as callTwilioApi$1,encodeTwilioForm,fetchTwilioMedia,resolveTwilioCredential}from"#compiled/@chat-adapter/twilio/api.js";import{resolveTwilioAuthToken}from"#public/channels/twilio/verify.js";function twilioContinuationToken({from:e,to:t}){return`${e}:${t??``}`}async function resolveTwilioAccountSid(e){try{return await resolveTwilioCredential(e,`TWILIO_ACCOUNT_SID`)}catch(e){throw e instanceof TwilioApiError&&e.status===0?Error(`TWILIO_ACCOUNT_SID is required.`):e}}async function callTwilioApi(e){let t=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm(e.body),credentials:t,fetch:e.fetch,path:e.path}))}async function sendTwilioMessage(e){if(!e.from&&!e.messagingServiceSid)throw Error(`twilioChannel: sending a message requires from or messagingServiceSid.`);let t=await resolveTwilioAccountSid(e.credentials?.accountSid),n=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm({Body:e.body,From:e.from,MessagingServiceSid:e.messagingServiceSid,StatusCallback:e.statusCallbackUrl,To:e.to}),credentials:n,fetch:e.fetch,path:`/2010-04-01/Accounts/${encodeURIComponent(t)}/Messages.json`}))}async function updateTwilioCall(e){let t=await resolveTwilioAccountSid(e.credentials?.accountSid),n=await resolveCredentials(e.credentials);return preserveTwilioApiResponse(callTwilioApi$1({apiBaseUrl:e.apiBaseUrl,body:encodeTwilioForm({Twiml:e.twiml}),credentials:n,fetch:e.fetch,path:`/2010-04-01/Accounts/${encodeURIComponent(t)}/Calls/${encodeURIComponent(e.callSid)}.json`}))}function createTwilioFetchFile(e){let t=new URL(e.apiBaseUrl??`https://api.twilio.com`).origin;return async n=>{if(URL.parse(n)?.origin!==t)return null;try{let t=await fetchTwilioMedia({apiBaseUrl:e.apiBaseUrl,credentials:await resolveCredentials(e.credentials),fetch:limitedFetch(e.fetch??fetch,DEFAULT_UPLOAD_POLICY.maxBytes,`twilio`),url:n});return{bytes:Buffer.from(t)}}catch(e){throw e instanceof EveAttachmentError?e:new EveAttachmentError({adapterKind:`twilio`,cause:e,kind:`resolver-threw`,message:e instanceof TwilioApiError&&e.status!==0?`Twilio media fetch returned HTTP ${e.status}.`:`Twilio media fetch failed.`})}}}async function resolveCredentials(e){return{accountSid:await resolveTwilioAccountSid(e?.accountSid),authToken:await resolveTwilioAuthToken(e?.authToken)}}async function preserveTwilioApiResponse(e){try{return await e}catch(e){if(e instanceof TwilioApiError&&e.status!==0)return{body:e.body,ok:!1,status:e.status};throw e}}export{callTwilioApi,createTwilioFetchFile,resolveTwilioAccountSid,sendTwilioMessage,twilioContinuationToken,updateTwilioCall};

package/dist/src/public/channels/twilio/credentials.d.ts

@@ -0,0 +1,7 @@
+import type { TwilioAccountSid } from "#public/channels/twilio/api.js";
+import type { TwilioAuthToken } from "#public/channels/twilio/verify.js";
+/** Credentials for the Twilio channel and its API. */
+export interface TwilioChannelCredentials {
+    readonly accountSid?: TwilioAccountSid;
+    readonly authToken?: TwilioAuthToken;
+}

package/dist/src/public/channels/twilio/credentials.js

@@ -0,0 +1 @@
+export{};

package/dist/src/public/channels/twilio/defaults.d.ts

@@ -6,5 +6,4 @@ export declare function defaultOnText(_ctx: TwilioContext, message: TwilioTextMe
 export declare function defaultOnVoice(_ctx: TwilioContext, _call: TwilioVoiceCall): TwilioVoiceResult;
 /** Default inbound voice hook: dispatch with Twilio phone-number auth. */
 export declare function defaultOnVoiceTranscription(_ctx: TwilioContext, transcription: TwilioVoiceTranscription): TwilioInboundResult;
-/** Built-in Twilio event handlers for text delivery, sign-ins, and terminal errors. */
 export declare const defaultEvents: TwilioChannelEvents;

package/dist/src/public/channels/twilio/defaults.js

@@ -1,5 +1 @@
-import{extractErrorId,formatErrorHint}from"#internal/logging.js";import{displayProperName}from"#shared/display-name.js";import{renderTextInputRequest}from"#channel/resolve-text.js";import{promptQueueEvents}from"#channel/prompt-queue.js";function defaultTwilioAuth(e){let t={channel:e.channel,from:e.from};return e.to!==void 0&&(t.to=e.to),{attributes:t,authenticator:`twilio-webhook`,issuer:`twilio`,principalId:`twilio:${e.from}`,principalType:`user`}}function defaultOnText(e,t){return{auth:defaultTwilioAuth({channel:`text`,from:t.from,to:t.to})}}function defaultOnVoice(e,t){return{}}function defaultOnVoiceTranscription(e,t){return{auth:defaultTwilioAuth({channel:`voice`,from:t.from,to:t.to})}}const defaultEvents={async"message.completed"(e,t,n){e.finishReason!==`tool-calls`&&e.message&&await t.twilio.sendMessage(e.message)},...promptQueueEvents(showPrompt),async"authorization.required"(e,t,n){if(e.candidateId!==void 0)return;let r=e.authorization;await t.twilio.sendMessage([`Sign in to ${r?.displayName??displayProperName(e.name)} to continue.`,r?.instructions,r?.userCode?`Code: ${r.userCode}`:void 0,r?.url].filter(e=>e!==void 0&&e.length>0).join(`
-
-`))},async"authorization.completed"(e,t,n){e.candidateId===void 0&&await t.twilio.sendMessage(renderAuthorizationOutcome({displayName:e.authorization?.displayName??displayProperName(e.name),outcome:e.outcome,reason:e.reason}))},async"turn.failed"(e,t,n){if(e.terminal)return;let r=formatErrorHint(e),i=extractErrorId(e.details);await t.twilio.sendMessage([`I hit an error while handling your request${r}.`,``,`Please try again, rephrase, or reach out if it keeps failing.`,...i?[``,`Error id: ${i}`]:[]].join(`
-`))},async"session.failed"(e,t){let n=formatErrorHint(e),r=extractErrorId(e.details);await t.twilio.sendMessage([`This session could not recover from an error${n}.`,``,`Start a new message to continue.`,...r?[``,`Error id: ${r}`]:[]].join(`
-`))}};async function showPrompt(e,t){let n=renderTextInputRequest(t);if((t.options??[]).length===0){await e.twilio.sendMessage(n);return}let r=t.allowFreeform===!0?`Reply with a number, or with your own answer.`:`Reply with a number to choose.`;await e.twilio.sendMessage(`${n}\n\n${r}`)}function renderAuthorizationOutcome(e){if(e.outcome===`authorized`)return`${e.displayName} connected.`;if(e.outcome===`declined`)return`${e.displayName} sign-in cancelled.`;let t=e.outcome===`timed-out`?`timed out`:e.outcome,n=e.reason===void 0?``:` (${e.reason})`;return`${e.displayName} sign-in ${t}${n}.`}export{defaultEvents,defaultOnText,defaultOnVoice,defaultOnVoiceTranscription};
+import{postedIn,signInChallengeText}from"#channel/sign-in.js";import{renderTextInteraction}from"#channel/resolve-text.js";import{surfaceEvents}from"#channel/surface.js";function defaultTwilioAuth(e){let t={channel:e.channel,from:e.from};return e.to!==void 0&&(t.to=e.to),{attributes:t,authenticator:`twilio-webhook`,issuer:`twilio`,principalId:`twilio:${e.from}`,principalType:`user`}}function defaultOnText(e,t){return{auth:defaultTwilioAuth({channel:`text`,from:t.from,to:t.to})}}function defaultOnVoice(e,t){return{}}function defaultOnVoiceTranscription(e,t){return{auth:defaultTwilioAuth({channel:`voice`,from:t.from,to:t.to})}}function twilioSignIns(e){let send=async t=>{await e.twilio.sendMessage(t)};return{private:!0,postChallenge:e=>send(signInChallengeText(e)),post:send,posted:postedIn(e.state,`pendingSignIns`)}}const defaultEvents=surfaceEvents({post:(e,t)=>e.twilio.sendMessage(t),restart:`message`,requests:{showOne:showPrompt},signIns:twilioSignIns});async function showPrompt(e,t){let n=renderTextInteraction(t.request);if((t.request.options??[]).length===0){await e.twilio.sendMessage(n);return}let r=t.request.allowFreeform===!0?`Reply with a number, or with your own answer.`:`Reply with a number to choose.`;await e.twilio.sendMessage(`${n}\n\n${r}`)}export{defaultEvents,defaultOnText,defaultOnVoice,defaultOnVoiceTranscription};

package/dist/src/public/channels/twilio/inbound.d.ts

@@ -1,4 +1,4 @@
-import type { UserContent } from "ai";
+import type { MessageContent } from "#shared/message-content.js";
 import { type TwilioMediaPayload } from "#compiled/@chat-adapter/twilio/webhook.js";
 /** Channel-owned representation of one inbound Twilio text or media message. */
 export interface TwilioTextMessage {
@@ -44,7 +44,7 @@ export declare function parseTwilioTextMessage(params: URLSearchParams): TwilioT
  * per MMS media URL, which the channel's `fetchFile` downloads with the
  * account's credentials.
  */
-export declare function twilioMessageContent(message: TwilioTextMessage): string | UserContent;
+export declare function twilioMessageContent(message: TwilioTextMessage): MessageContent;
 /** Parses Twilio's incoming-call webhook fields into Eve's voice payload. */
 export declare function parseTwilioVoiceCall(params: URLSearchParams): TwilioVoiceCall | null;
 /**

package/dist/src/public/channels/twilio/index.d.ts

@@ -1,5 +1,5 @@
-export { twilioChannel, type TwilioAllowFrom, type TwilioChannel, type TwilioChannelConfig, type TwilioChannelCredentials, type TwilioChannelEvents, type TwilioChannelState, type TwilioContext, type TwilioEventContext, type TwilioHandle, type TwilioInboundResult, type TwilioInboundResultOrPromise, type TwilioInstrumentationMetadata, type TwilioMessagingConfig, type TwilioReceiveTarget, type TwilioSendMessageOptions, type TwilioVoiceConfig, type TwilioVoiceResult, type TwilioVoiceResultOrPromise, } from "#public/channels/twilio/twilioChannel.js";
-export { callTwilioApi, resolveTwilioAccountSid, sendTwilioMessage, twilioContinuationToken, updateTwilioCall, type TwilioAccountSid, type TwilioApiOptions, type TwilioApiResponse, type TwilioCredentials, type TwilioFetch, type TwilioSendMessageInput, type TwilioUpdateCallInput, } from "#public/channels/twilio/api.js";
+export { twilioChannel, type TwilioAllowFrom, type TwilioChannel, type TwilioChannelConfig, type TwilioChannelContext, type TwilioChannelCredentials, type TwilioChannelEvents, type TwilioChannelState, type TwilioContext, type TwilioEventContext, type TwilioHandle, type TwilioInboundResult, type TwilioInstrumentationMetadata, type TwilioMessagingConfig, type TwilioReceiveTarget, type TwilioSendMessageOptions, type TwilioVoiceConfig, type TwilioVoiceResult, } from "#public/channels/twilio/twilioChannel.js";
+export { twilioContinuationToken, type TwilioAccountSid, type TwilioApiOptions, type TwilioApiResponse, type TwilioFetch, type TwilioSendMessageInput, type TwilioUpdateCallInput, } from "#public/channels/twilio/api.js";
 export type { TwilioInboundContext, TwilioTextMessage, TwilioVoiceCall, TwilioVoiceTranscription, } from "#public/channels/twilio/inbound.js";
-export { emptyTwilioResponse, escapeXml, gatherSpeechTwilioResponse, sayTwilioResponse, twimlResponse, type TwilioGatherTwimlOptions, } from "#public/channels/twilio/twiml.js";
-export { buildTwilioSignatureBase, resolveTwilioAuthToken, signTwilioRequest, verifyTwilioRequest, type TwilioAuthToken, type TwilioVerifiedRequest, type TwilioVerifyOptions, type TwilioWebhookUrl, } from "#public/channels/twilio/verify.js";
+export { type TwilioGatherTwimlOptions } from "#public/channels/twilio/twiml.js";
+export { type TwilioAuthToken, type TwilioVerifiedRequest, type TwilioWebhookUrl, } from "#public/channels/twilio/verify.js";

package/dist/src/public/channels/twilio/index.js

@@ -1 +1 @@
-import{buildTwilioSignatureBase,resolveTwilioAuthToken,signTwilioRequest,verifyTwilioRequest}from"#public/channels/twilio/verify.js";import{twilioChannel}from"#public/channels/twilio/twilioChannel.js";import{callTwilioApi,resolveTwilioAccountSid,sendTwilioMessage,twilioContinuationToken,updateTwilioCall}from"#public/channels/twilio/api.js";import{emptyTwilioResponse,escapeXml,gatherSpeechTwilioResponse,sayTwilioResponse,twimlResponse}from"#public/channels/twilio/twiml.js";export{buildTwilioSignatureBase,callTwilioApi,emptyTwilioResponse,escapeXml,gatherSpeechTwilioResponse,resolveTwilioAccountSid,resolveTwilioAuthToken,sayTwilioResponse,sendTwilioMessage,signTwilioRequest,twilioChannel,twilioContinuationToken,twimlResponse,updateTwilioCall,verifyTwilioRequest};
+import{twilioChannel}from"#public/channels/twilio/twilioChannel.js";import{twilioContinuationToken}from"#public/channels/twilio/api.js";export{twilioChannel,twilioContinuationToken};

package/dist/src/public/channels/twilio/twilioChannel.d.ts

@@ -1,23 +1,20 @@
+import type { TwilioChannelCredentials } from "#public/channels/twilio/credentials.js";
+export type { TwilioChannelCredentials } from "#public/channels/twilio/credentials.js";
+import type { ChannelEventContext, ChannelEventOf } from "#public/definitions/channel.js";
+import type { SessionEvent } from "#protocol/session-event.js";
 import type { PromptQueueState } from "#channel/prompt-queue.js";
 import type { SessionAuthContext, TurnPolicy } from "#channel/types.js";
-import type { SessionContext } from "#public/definitions/callback-context.js";
 import type { ChannelContinuationOps } from "#public/definitions/channel.js";
-import type { UnstampedMessageStreamEvent } from "#protocol/message.js";
-import { type TwilioApiOptions, type TwilioApiResponse, type TwilioCredentials } from "#public/channels/twilio/api.js";
+import { type TwilioApiOptions, type TwilioApiResponse } from "#public/channels/twilio/api.js";
 import { type TwilioTextMessage, type TwilioVoiceCall, type TwilioVoiceTranscription } from "#public/channels/twilio/inbound.js";
-import { type TwilioAuthToken, type TwilioWebhookUrl } from "#public/channels/twilio/verify.js";
+import { type TwilioWebhookUrl } from "#public/channels/twilio/verify.js";
 import { type Channel } from "#public/definitions/channel.js";
-type EventData<T extends UnstampedMessageStreamEvent["type"]> = Extract<UnstampedMessageStreamEvent, {
-    type: T;
-}> extends {
-    data: infer D;
-} ? D : undefined;
 /** Pre-dispatch Twilio context passed to the inbound text, voice, and voice-transcription hooks. */
 export interface TwilioContext {
     readonly twilio: TwilioHandle;
 }
 /** Channel-owned Twilio context returned by `context()`. */
-interface TwilioChannelContext extends TwilioContext {
+export interface TwilioChannelContext extends TwilioContext {
     state: TwilioChannelState;
 }
 /** Event-handler Twilio context, including continuation routing. */
@@ -33,6 +30,8 @@ export interface TwilioChannelState extends PromptQueueState {
     lastMessageSid?: string | null;
     /** Most recent inbound Call SID when this session was started by voice. */
     lastCallSid?: string | null;
+    /** The sign-ins the default flow sent a prompt for, by connection name. */
+    pendingSignIns?: Record<string, string>;
 }
 /** Per-session instrumentation snapshot for Twilio runtime telemetry. Reports the active phone-number pair and the most recent message and call SIDs. */
 export interface TwilioInstrumentationMetadata extends Record<string, unknown> {
@@ -42,9 +41,6 @@ export interface TwilioInstrumentationMetadata extends Record<string, unknown> {
     readonly to: string | null;
 }
 /** Twilio channel credentials. `authToken` also verifies inbound webhook signatures. */
-export interface TwilioChannelCredentials extends TwilioCredentials {
-    readonly authToken?: TwilioAuthToken;
-}
 /** Target accepted by `receive(twilio, { target })` for proactive phone-number sessions. */
 export interface TwilioReceiveTarget {
     readonly phoneNumber: string;
@@ -58,7 +54,6 @@ export type TwilioInboundResult = {
     title?: string;
 } | null;
 /** Sync or async {@link TwilioInboundResult}. */
-export type TwilioInboundResultOrPromise = TwilioInboundResult | Promise<TwilioInboundResult>;
 /** Phone-number allow list for inbound Twilio webhook triggers. `"*"` allows every sender. */
 export type TwilioAllowFrom = string | readonly string[] | (() => string | readonly string[] | Promise<string | readonly string[]>);
 /**
@@ -84,28 +79,21 @@ export interface TwilioVoiceResult {
     readonly profanityFilter?: boolean;
 }
 /** Sync or async {@link TwilioVoiceResult}. */
-export type TwilioVoiceResultOrPromise = TwilioVoiceResult | null | undefined | Promise<TwilioVoiceResult | null | undefined>;
-type TwilioEventHandler<T extends UnstampedMessageStreamEvent["type"]> = (data: EventData<T>, channel: TwilioEventContext, ctx: SessionContext) => void | Promise<void>;
-type TwilioSessionFailedHandler = (data: EventData<"session.failed">, channel: TwilioEventContext) => void | Promise<void>;
+type TwilioEventHandler<T extends SessionEvent["type"]> = (event: ChannelEventOf<T>, ctx: ChannelEventContext<TwilioEventContext>) => void | Promise<void>;
 /** Event handlers supported by `twilioChannel({ events })`. */
 export interface TwilioChannelEvents {
     readonly "turn.started"?: TwilioEventHandler<"turn.started">;
-    readonly "actions.requested"?: TwilioEventHandler<"actions.requested">;
-    readonly "action.partial"?: TwilioEventHandler<"action.partial">;
-    readonly "action.result"?: TwilioEventHandler<"action.result">;
-    readonly "message.completed"?: TwilioEventHandler<"message.completed">;
-    readonly "message.appended"?: TwilioEventHandler<"message.appended">;
-    readonly "input.requested"?: TwilioEventHandler<"input.requested">;
-    readonly "input.resolved"?: TwilioEventHandler<"input.resolved">;
-    readonly "approval.settled"?: TwilioEventHandler<"approval.settled">;
-    readonly "turn.failed"?: TwilioEventHandler<"turn.failed">;
-    readonly "turn.completed"?: TwilioEventHandler<"turn.completed">;
-    readonly "turn.cancelled"?: TwilioEventHandler<"turn.cancelled">;
-    readonly "session.failed"?: TwilioSessionFailedHandler;
-    readonly "session.completed"?: TwilioEventHandler<"session.completed">;
-    readonly "session.waiting"?: TwilioEventHandler<"session.waiting">;
-    readonly "authorization.required"?: TwilioEventHandler<"authorization.required">;
-    readonly "authorization.completed"?: TwilioEventHandler<"authorization.completed">;
+    readonly "call.requested"?: TwilioEventHandler<"call.requested">;
+    readonly "call.progress"?: TwilioEventHandler<"call.progress">;
+    readonly "call.settled"?: TwilioEventHandler<"call.settled">;
+    readonly "content.completed"?: TwilioEventHandler<"content.completed">;
+    readonly "content.delta"?: TwilioEventHandler<"content.delta">;
+    readonly "interaction.opened"?: TwilioEventHandler<"interaction.opened">;
+    readonly "interaction.settled"?: TwilioEventHandler<"interaction.settled">;
+    readonly "response.admitted"?: TwilioEventHandler<"response.admitted">;
+    readonly "turn.settled"?: TwilioEventHandler<"turn.settled">;
+    readonly "session.ended"?: TwilioEventHandler<"session.ended">;
+    readonly "delivery.settled"?: TwilioEventHandler<"delivery.settled">;
 }
 /** SMS/Messaging defaults for Twilio outbound replies. */
 export interface TwilioMessagingConfig {
@@ -163,11 +151,11 @@ export interface TwilioChannelConfig {
     readonly voice?: TwilioVoiceConfig;
     readonly api?: Omit<TwilioApiOptions, "credentials">;
     /** Inbound text hook. Defaults to phone-number auth and dispatch. */
-    onText?(ctx: TwilioContext, message: TwilioTextMessage): TwilioInboundResultOrPromise;
+    onText?(ctx: TwilioContext, message: TwilioTextMessage): TwilioInboundResult | Promise<TwilioInboundResult>;
     /** Inbound voice hook. Return `null` to reject the call before gathering speech. */
-    onVoice?(ctx: TwilioContext, call: TwilioVoiceCall): TwilioVoiceResultOrPromise;
+    onVoice?(ctx: TwilioContext, call: TwilioVoiceCall): TwilioVoiceResult | null | undefined | Promise<TwilioVoiceResult | null | undefined>;
     /** Inbound voice transcription hook. Defaults to phone-number auth and dispatch. */
-    onVoiceTranscription?(ctx: TwilioContext, transcription: TwilioVoiceTranscription): TwilioInboundResultOrPromise;
+    onVoiceTranscription?(ctx: TwilioContext, transcription: TwilioVoiceTranscription): TwilioInboundResult | Promise<TwilioInboundResult>;
     readonly events?: TwilioChannelEvents;
 }
 /** Low-level Twilio handle exposed to hooks and event handlers. */
@@ -201,4 +189,3 @@ export interface TwilioChannel extends Channel<TwilioChannelState, TwilioReceive
 }
 /** Twilio channel factory for SMS and speech-transcribed inbound calls. */
 export declare function twilioChannel(config: TwilioChannelConfig): TwilioChannel;
-export {};

package/dist/src/public/channels/twilio/twilioChannel.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{readNonEmptyString}from"#shared/guards.js";import{GET,POST,defineChannel}from"#public/definitions/channel.js";import"#public/channels/twilio/verify.js";import{callTwilioApi,createTwilioFetchFile,sendTwilioMessage,twilioContinuationToken,updateTwilioCall}from"#public/channels/twilio/api.js";import{emptyTwilioResponse,gatherSpeechTwilioResponse,sayTwilioResponse}from"#public/channels/twilio/twiml.js";import{defaultEvents,defaultOnText,defaultOnVoice,defaultOnVoiceTranscription}from"#public/channels/twilio/defaults.js";import{formatTwilioContextBlock,parseTwilioTextMessage,parseTwilioVoiceCall,parseTwilioVoiceTranscription,twilioMessageContent}from"#public/channels/twilio/inbound.js";import{buildTwilioActionUrl,buildTwilioRoutes,verifyTwilioInbound}from"#public/channels/twilio/routing.js";const log=createLogger(`twilio.channel`);function twilioChannel(e){assertAllowFromConfigured(e);let t=buildTwilioRoutes(e.route??`/eve/v1/twilio`),n=e.onText??defaultOnText,r=e.onVoice??defaultOnVoice,i=e.onVoiceTranscription??defaultOnVoiceTranscription,a={...defaultEvents,...e.events},o=handleTwilioMessages({config:e,onText:n}),s=handleTwilioVoice({config:e,onVoice:r,routes:t}),c=handleTwilioTranscription({config:e,onVoiceTranscription:i,routes:t});return defineChannel({kindHint:`twilio`,turnPolicy:e.turnPolicy,state:{from:null,to:null,lastCallSid:null,lastMessageSid:null},metadata(e){return{from:e.from,lastCallSid:e.lastCallSid??null,lastMessageSid:e.lastMessageSid??null,to:e.to}},audience:()=>`private`,fetchFile:createTwilioFetchFile({...e.api,credentials:e.credentials}),context(t,n){return rebuildTwilioContext(t,n,e)},routes:[GET(t.messages,o),POST(t.messages,o),GET(t.voice,s),POST(t.voice,s),GET(t.transcription,c),POST(t.transcription,c)],async receive(t,{from:n}){let r=readNonEmptyString(t.target.phoneNumber);if(!r)throw Error(`twilioChannel().receive requires target.phoneNumber.`);let i=readNonEmptyString(t.target.from)??e.messaging?.from??null;return n(twilioContinuationToken(r,i??void 0)).send(t.message,{auth:t.auth,state:{from:r,lastCallSid:null,lastMessageSid:null,to:i}})},events:a})}function handleTwilioMessages(e){return async(t,{from:n,waitUntil:r})=>{let i=await verifyTwilioInbound(t,e.config);if(i===null)return new Response(`unauthorized`,{status:401});let a=parseTwilioTextMessage(i.params);return a?await isAllowed(a.from,e.config.allowFrom)?(r(dispatchText({config:e.config,message:a,onText:e.onText,from:n})),emptyTwilioResponse()):new Response(`forbidden`,{status:403}):emptyTwilioResponse()}}function handleTwilioVoice(e){return async t=>{let n=await verifyTwilioInbound(t,e.config);if(n===null)return new Response(`unauthorized`,{status:401});let r=parseTwilioVoiceCall(n.params);if(!r)return sayTwilioResponse(`Missing caller information.`);if(!await isAllowed(r.from,e.config.allowFrom))return new Response(`forbidden`,{status:403});let i=await acceptVoiceCall({call:r,config:e.config,onVoice:e.onVoice});if(i===null)return new Response(`forbidden`,{status:403});let a=i??{};return gatherSpeechTwilioResponse({actionUrl:await buildTwilioActionUrl(t,e.config,e.routes.transcription),hints:a.hints??e.config.voice?.hints,language:a.language??e.config.voice?.language,profanityFilter:a.profanityFilter??e.config.voice?.profanityFilter,prompt:a.prompt??e.config.voice?.prompt??`Please say your message after the tone.`,speechModel:a.speechModel??e.config.voice?.speechModel,speechTimeout:a.speechTimeout??e.config.voice?.speechTimeout??`auto`,timeoutSeconds:a.timeoutSeconds??e.config.voice?.timeoutSeconds,voice:a.voice??e.config.voice?.voice})}}function handleTwilioTranscription(e){return async(t,{from:n,waitUntil:r})=>{let i=await verifyTwilioInbound(t,e.config);if(i===null)return new Response(`unauthorized`,{status:401});let a=parseTwilioVoiceTranscription(i.params);return a?await isAllowed(a.from,e.config.allowFrom)?(r(dispatchVoiceTranscription({config:e.config,onVoiceTranscription:e.onVoiceTranscription,from:n,transcription:a})),sayTwilioResponse(e.config.voice?.acknowledgement??`Thanks. I'll follow up by text.`)):new Response(`forbidden`,{status:403}):gatherSpeechTwilioResponse({actionUrl:await buildTwilioActionUrl(t,e.config,e.routes.transcription),language:e.config.voice?.language,prompt:e.config.voice?.prompt??`Please say your message after the tone.`,speechTimeout:e.config.voice?.speechTimeout??`auto`,timeoutSeconds:e.config.voice?.timeoutSeconds})}}function rebuildTwilioContext(e,t,n){return{state:e,twilio:buildTwilioHandle({callSid:e.lastCallSid??void 0,config:n,from:e.from??``,to:e.to??void 0})}}function buildTwilioHandle(e){let t=e.config.api,n=e.config.credentials,r=e.config.messaging?.from??e.to,i=e.config.messaging?.messagingServiceSid,a=e.config.messaging?.statusCallbackUrl;return{callSid:e.callSid,from:e.from,to:e.to,request(e,r){return callTwilioApi({apiBaseUrl:t?.apiBaseUrl,body:r,credentials:n,fetch:t?.fetch,path:e})},sendMessage(o,s){return sendTwilioMessage({apiBaseUrl:t?.apiBaseUrl,body:o,credentials:n,fetch:t?.fetch,from:s?.from??r,messagingServiceSid:s?.messagingServiceSid??i,statusCallbackUrl:s?.statusCallbackUrl??a,to:s?.to??e.from})},updateCall(e,r){return updateTwilioCall({apiBaseUrl:t?.apiBaseUrl,callSid:e,credentials:n,fetch:t?.fetch,twiml:r})}}}function assertAllowFromConfigured(e){if(e?.allowFrom===void 0)throw Error(`twilioChannel requires allowFrom. Use allowFrom: "*" to allow all numbers.`)}async function dispatchText(e){let{message:t}=e,n={twilio:buildTwilioHandle({callSid:void 0,config:e.config,from:t.from,to:t.to})},r;try{r=await e.onText(n,t)}catch(e){log.error(`text handler failed`,{error:e});return}if(r==null)return;let i=formatTwilioContextBlock({channel:`text`,from:t.from,messageSid:t.messageSid,to:t.to});try{await e.from(twilioContinuationToken(t.from,t.to)).send(twilioMessageContent(t),{auth:r.auth,context:[i],state:{from:t.from,lastCallSid:null,lastMessageSid:t.messageSid??null,to:t.to??null},title:r.title})}catch(e){log.error(`text delivery failed`,{error:e})}}async function acceptVoiceCall(e){let{call:t}=e,n={twilio:buildTwilioHandle({callSid:t.callSid,config:e.config,from:t.from,to:t.to})};try{return await e.onVoice(n,t)}catch(e){return log.error(`voice handler failed`,{error:e}),null}}async function dispatchVoiceTranscription(e){let{transcription:t}=e,n={twilio:buildTwilioHandle({callSid:t.callSid,config:e.config,from:t.from,to:t.to})},r;try{r=await e.onVoiceTranscription(n,t)}catch(e){log.error(`voice transcription handler failed`,{error:e});return}if(r==null)return;let i=formatTwilioContextBlock({callSid:t.callSid,channel:`voice`,from:t.from,to:t.to});try{await e.from(twilioContinuationToken(t.from,t.to)).send(t.text,{auth:r.auth,context:[i],state:{from:t.from,lastCallSid:t.callSid??null,lastMessageSid:null,to:t.to??null},title:r.title})}catch(e){log.error(`voice transcription delivery failed`,{error:e})}}async function isAllowed(e,t){let n=typeof t==`function`?await t():t;return n===`*`?!0:typeof n==`string`?n===e:n.includes(e)}export{twilioChannel};
+import{createLogger}from"#internal/logging.js";import{readNonEmptyString}from"#shared/guards.js";import{GET,POST,defineChannel}from"#public/definitions/channel.js";import"#public/channels/twilio/verify.js";import{callTwilioApi,createTwilioFetchFile,sendTwilioMessage,twilioContinuationToken,updateTwilioCall}from"#public/channels/twilio/api.js";import{defaultEvents,defaultOnText,defaultOnVoice,defaultOnVoiceTranscription}from"#public/channels/twilio/defaults.js";import{formatTwilioContextBlock,parseTwilioTextMessage,parseTwilioVoiceCall,parseTwilioVoiceTranscription,twilioMessageContent}from"#public/channels/twilio/inbound.js";import{emptyTwilioResponse,gatherSpeechTwilioResponse,sayTwilioResponse}from"#public/channels/twilio/twiml.js";import{buildTwilioActionUrl,buildTwilioRoutes,verifyTwilioInbound}from"#public/channels/twilio/routing.js";const log=createLogger(`twilio.channel`);function twilioChannel(e){assertAllowFromConfigured(e);let t=buildTwilioRoutes(e.route??`/eve/v1/twilio`),n=e.onText??defaultOnText,r=e.onVoice??defaultOnVoice,i=e.onVoiceTranscription??defaultOnVoiceTranscription,a={...defaultEvents,...e.events},o=handleTwilioMessages({config:e,onText:n}),s=handleTwilioVoice({config:e,onVoice:r,routes:t}),c=handleTwilioTranscription({config:e,onVoiceTranscription:i,routes:t});return defineChannel({turnPolicy:e.turnPolicy,state:{from:null,to:null,lastCallSid:null,lastMessageSid:null},metadata(e){return{from:e.from,lastCallSid:e.lastCallSid??null,lastMessageSid:e.lastMessageSid??null,to:e.to}},audience:()=>`private`,fetchFile:createTwilioFetchFile({...e.api,credentials:e.credentials}),context(t,n){return rebuildTwilioContext(t,n,e)},routes:[GET(t.messages,o),POST(t.messages,o),GET(t.voice,s),POST(t.voice,s),GET(t.transcription,c),POST(t.transcription,c)],async receive(t,{from:n}){let r=readNonEmptyString(t.target.phoneNumber);if(!r)throw Error(`twilioChannel().receive requires target.phoneNumber.`);let i=readNonEmptyString(t.target.from)??e.messaging?.from??null;return n(twilioContinuationToken({from:r,to:i??void 0})).send(t.message,{auth:t.auth,state:{from:r,lastCallSid:null,lastMessageSid:null,to:i}})},events:a})}function handleTwilioMessages(e){return async(t,{from:n,waitUntil:r})=>{let i=await verifyTwilioInbound(t,e.config);if(i===null)return new Response(`unauthorized`,{status:401});let a=parseTwilioTextMessage(i.params);return a?await isAllowed(a.from,e.config.allowFrom)?(r(dispatchText({config:e.config,message:a,onText:e.onText,from:n})),emptyTwilioResponse()):new Response(`forbidden`,{status:403}):emptyTwilioResponse()}}function handleTwilioVoice(e){return async t=>{let n=await verifyTwilioInbound(t,e.config);if(n===null)return new Response(`unauthorized`,{status:401});let r=parseTwilioVoiceCall(n.params);if(!r)return sayTwilioResponse(`Missing caller information.`);if(!await isAllowed(r.from,e.config.allowFrom))return new Response(`forbidden`,{status:403});let i=await acceptVoiceCall({call:r,config:e.config,onVoice:e.onVoice});if(i===null)return new Response(`forbidden`,{status:403});let a=i??{};return gatherSpeechTwilioResponse({actionUrl:await buildTwilioActionUrl(t,e.config,e.routes.transcription),hints:a.hints??e.config.voice?.hints,language:a.language??e.config.voice?.language,profanityFilter:a.profanityFilter??e.config.voice?.profanityFilter,prompt:a.prompt??e.config.voice?.prompt??`Please say your message after the tone.`,speechModel:a.speechModel??e.config.voice?.speechModel,speechTimeout:a.speechTimeout??e.config.voice?.speechTimeout??`auto`,timeoutSeconds:a.timeoutSeconds??e.config.voice?.timeoutSeconds,voice:a.voice??e.config.voice?.voice})}}function handleTwilioTranscription(e){return async(t,{from:n,waitUntil:r})=>{let i=await verifyTwilioInbound(t,e.config);if(i===null)return new Response(`unauthorized`,{status:401});let a=parseTwilioVoiceTranscription(i.params);return a?await isAllowed(a.from,e.config.allowFrom)?(r(dispatchVoiceTranscription({config:e.config,onVoiceTranscription:e.onVoiceTranscription,from:n,transcription:a})),sayTwilioResponse(e.config.voice?.acknowledgement??`Thanks. I'll follow up by text.`)):new Response(`forbidden`,{status:403}):gatherSpeechTwilioResponse({actionUrl:await buildTwilioActionUrl(t,e.config,e.routes.transcription),language:e.config.voice?.language,prompt:e.config.voice?.prompt??`Please say your message after the tone.`,speechTimeout:e.config.voice?.speechTimeout??`auto`,timeoutSeconds:e.config.voice?.timeoutSeconds})}}function rebuildTwilioContext(e,t,n){return{state:e,twilio:buildTwilioHandle({callSid:e.lastCallSid??void 0,config:n,from:e.from??``,to:e.to??void 0})}}function buildTwilioHandle(e){let t=e.config.api,n=e.config.credentials,r=e.config.messaging?.from??e.to,i=e.config.messaging?.messagingServiceSid,a=e.config.messaging?.statusCallbackUrl;return{callSid:e.callSid,from:e.from,to:e.to,request(e,r){return callTwilioApi({apiBaseUrl:t?.apiBaseUrl,body:r,credentials:n,fetch:t?.fetch,path:e})},sendMessage(o,s){return sendTwilioMessage({apiBaseUrl:t?.apiBaseUrl,body:o,credentials:n,fetch:t?.fetch,from:s?.from??r,messagingServiceSid:s?.messagingServiceSid??i,statusCallbackUrl:s?.statusCallbackUrl??a,to:s?.to??e.from})},updateCall(e,r){return updateTwilioCall({apiBaseUrl:t?.apiBaseUrl,callSid:e,credentials:n,fetch:t?.fetch,twiml:r})}}}function assertAllowFromConfigured(e){if(e?.allowFrom===void 0)throw Error(`twilioChannel requires allowFrom. Use allowFrom: "*" to allow all numbers.`)}async function dispatchText(e){let{message:t}=e,n={twilio:buildTwilioHandle({callSid:void 0,config:e.config,from:t.from,to:t.to})},r;try{r=await e.onText(n,t)}catch(e){log.error(`text handler failed`,{error:e});return}if(r==null)return;let i=formatTwilioContextBlock({channel:`text`,from:t.from,messageSid:t.messageSid,to:t.to});try{await e.from(twilioContinuationToken({from:t.from,to:t.to})).send(twilioMessageContent(t),{auth:r.auth,context:[i],state:{from:t.from,lastCallSid:null,lastMessageSid:t.messageSid??null,to:t.to??null},title:r.title})}catch(e){log.error(`text delivery failed`,{error:e})}}async function acceptVoiceCall(e){let{call:t}=e,n={twilio:buildTwilioHandle({callSid:t.callSid,config:e.config,from:t.from,to:t.to})};try{return await e.onVoice(n,t)}catch(e){return log.error(`voice handler failed`,{error:e}),null}}async function dispatchVoiceTranscription(e){let{transcription:t}=e,n={twilio:buildTwilioHandle({callSid:t.callSid,config:e.config,from:t.from,to:t.to})},r;try{r=await e.onVoiceTranscription(n,t)}catch(e){log.error(`voice transcription handler failed`,{error:e});return}if(r==null)return;let i=formatTwilioContextBlock({callSid:t.callSid,channel:`voice`,from:t.from,to:t.to});try{await e.from(twilioContinuationToken({from:t.from,to:t.to})).send(t.text,{auth:r.auth,context:[i],state:{from:t.from,lastCallSid:t.callSid??null,lastMessageSid:null,to:t.to??null},title:r.title})}catch(e){log.error(`voice transcription delivery failed`,{error:e})}}async function isAllowed(e,t){let n=typeof t==`function`?await t():t;return n===`*`?!0:typeof n==`string`?n===e:n.includes(e)}export{twilioChannel};

package/dist/src/public/channels/twilio/verify.d.ts

@@ -1,8 +1,10 @@
-import { type TwilioCredential } from "#compiled/@chat-adapter/twilio/api.js";
-import { type TwilioVerifiedRequest, type TwilioWebhookUrl } from "#compiled/@chat-adapter/twilio/webhook.js";
 /** Twilio auth token, materialized directly or from an async secret provider. */
-export type TwilioAuthToken = TwilioCredential;
-export type { TwilioVerifiedRequest, TwilioWebhookUrl };
+export type TwilioAuthToken = string | (() => string | Promise<string>);
+export type TwilioWebhookUrl = string | ((request: Request) => string | Promise<string>);
+export interface TwilioVerifiedRequest {
+    readonly body: string;
+    readonly params: URLSearchParams;
+}
 /** Options for verifying Twilio inbound webhooks. */
 export interface TwilioVerifyOptions {
     /** Auth token used to verify the signature. Defaults to `TWILIO_AUTH_TOKEN`. */

package/dist/src/public/channels/undelivered-reply.d.ts

@@ -0,0 +1,30 @@
+import type { ChannelDelivery } from "#shared/channel-delivery.js";
+import { type Logger } from "#internal/logging.js";
+/** Channel state that remembers a final reply the user never saw. */
+export interface UndeliveredReplyState {
+    /**
+     * Error id of a final reply that never reached the user. The next delivered
+     * message tells the model the reply was not seen, then clears it.
+     */
+    undeliveredReplyErrorId?: string | null;
+}
+/** Where a channel's final reply failed, and how to post a notice there. */
+export interface UndeliveredReplySurface {
+    readonly log: Logger;
+    /** The surface as the user and the model know it, e.g. `"Slack"`. */
+    readonly name: string;
+    readonly post: (notice: string) => Promise<unknown>;
+    readonly state: UndeliveredReplyState;
+}
+/**
+ * Records a final reply that failed to reach the user: logs `error` at error
+ * level, remembers its error id for {@link withUndeliveredReplyNote}, and
+ * posts a notice that names the id without repeating the reply. A failed
+ * notice is logged, not thrown.
+ */
+export declare function reportUndeliveredReply(surface: UndeliveredReplySurface, turnId: string, error: unknown): Promise<void>;
+/**
+ * Tells the model, ahead of the next message, that its previous reply never
+ * reached `surfaceName`, so it does not assume the user read that reply.
+ */
+export declare function withUndeliveredReplyNote<T extends ChannelDelivery<unknown>>(state: UndeliveredReplyState, payload: T, surfaceName: string): T;

package/dist/src/public/channels/undelivered-reply.js

@@ -0,0 +1 @@
+import{logError}from"#internal/logging.js";async function reportUndeliveredReply(e,t,n){let r=logError(e.log,`final reply was not delivered to ${e.name}`,n,{turnId:t});e.state.undeliveredReplyErrorId=r;try{await e.post(`I finished, but couldn't deliver my answer in ${e.name} (error id \`${r}\`). Please ask me to resend it.`)}catch(n){logError(e.log,`undelivered reply notice failed`,n,{errorId:r,turnId:t})}}function withUndeliveredReplyNote(e,t,n){let r=e.undeliveredReplyErrorId;if(!r||t.message===void 0)return t;e.undeliveredReplyErrorId=null;let i=[`Your previous reply was not delivered to ${n} (error id ${r}).`,`The user has not seen it. Do not assume they read it; send the answer again if they ask for it.`].join(` `);return{...t,context:[i,...t.context??[]]}}export{reportUndeliveredReply,withUndeliveredReplyNote};

package/dist/src/public/channels/upload-policy.d.ts

@@ -1,7 +1,7 @@
 /**
  * Upload-policy authoring helpers for channel routes.
  */
-import type { FilePart, UserContent } from "ai";
+import type { MessageContent, MessageFilePart } from "#shared/message-content.js";
 /**
  * Framework policy for inbound attachments. Either the literal
  * `"disabled"` (reject every attachment) or a structural config.
@@ -27,7 +27,7 @@ export type UploadPolicyInput = "disabled" | Partial<UploadPolicyConfig>;
  */
 export declare const DEFAULT_UPLOAD_POLICY: UploadPolicyConfig;
 /**
- * Describes the reason one inbound `FilePart` failed the policy check.
+ * Describes the reason one inbound `MessageFilePart` failed the policy check.
  *
  * Channels use this to produce human-readable error responses
  * (`413 Payload Too Large`, `415 Unsupported Media Type`) or to log and
@@ -62,7 +62,7 @@ export declare function isUploadsDisabled(policy: UploadPolicy): boolean;
  */
 export declare function isMediaTypeAllowed(mediaType: string, policy: UploadPolicy): boolean;
 /**
- * Evaluates a single `FilePart` against a {@link UploadPolicy}. Returns
+ * Evaluates a single `MessageFilePart` against a {@link UploadPolicy}. Returns
  * a {@link UploadPolicyViolation} on rejection, or `null` when the
  * part is either accepted or has a non-local payload (remote URL) whose
  * size cannot be determined without fetching.
@@ -72,17 +72,17 @@ export declare function isMediaTypeAllowed(mediaType: string, policy: UploadPoli
  * CSV surfaces a 415 instead of a 413 — and mirrors how most HTTP
  * proxies enforce policy.
  */
-export declare function evaluateFilePart(part: FilePart, policy: UploadPolicy): UploadPolicyViolation | null;
+export declare function evaluateFilePart(part: MessageFilePart, policy: UploadPolicy): UploadPolicyViolation | null;
 /**
- * Walks a `UserContent` array and returns every policy violation, in
- * iteration order. Non-file parts (text, image) are skipped.
+ * Walks a message's parts and returns every policy violation, in
+ * iteration order. Text parts are skipped.
  *
  * Returns an empty array when the message is a plain string or when
  * every file part passes. Channels use this to decide between
  * rejecting an inbound request (HTTP) and dropping individual attachments
  * (Slack).
  */
-export declare function collectUploadPolicyViolations(content: string | UserContent, policy: UploadPolicy): readonly UploadPolicyViolation[];
+export declare function collectUploadPolicyViolations(content: MessageContent, policy: UploadPolicy): readonly UploadPolicyViolation[];
 /**
  * Renders a {@link UploadPolicyViolation} as a short human-readable
  * string. Used by channel error responses and warning logs.