ConversationHandler<TTools>

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})`)
})

@botmesh/core

@botmesh/core/spi

@botmesh/core/testing

ConversationHandler<TTools>

Type Parameters

Parameters

Returns

Example

​Type Parameters

​Parameters

​Returns

​Example

Type Parameters

Parameters

Returns

Example