ConversationHandler<TTools>

Type alias exported by @botmesh/core.

type ConversationHandler<TTools> = (c, ctx) => Promise<unknown>;

Defined in: conversations/handler.ts:32

Handler of bot.conversation(): an async function that drives one conversation.

ctx is the full MessageContext of the message that started it — reply helpers (photo, poll, react, quote…), senderInfo, chat, and ctx.tools typed with every DefaultTools augmentation (e.g. ctx.tools.nlu once @botmesh/nlu is imported). The low-level ConversationRuntime keeps working with the minimal RuntimeMessage; handlers written against that older, narrower type remain assignable to this one. The resolved value is ignored, so async (c, ctx) => ctx.reply('…') is fine; the conversation ends when the returned promise settles.

Type Parameters

Type Parameter	Default type	Description
TTools extends object	DefaultTools	Shape of ctx.tools; defaults to the (augmentable) DefaultTools.

Parameters

Parameter	Type
c	ConversationControls
ctx	MessageContext<TTools>

Returns

Promise<unknown>

Example

bot.conversation('foto', async (c, ctx) => {
  const img = await c.waitMedia(['image'], { timeout: '2m' })
  await ctx.react('📸')
  await ctx.reply(`Recibida (${img.type})`)
})