Problem

The active message interface (sendMsg, sendMaster, sendAdmin) did not support arrays containing mixed strings and message segments. This prevented users from sending messages like:

const message = [
  'Hello ',
  segment.at('123456'),
  ', check out this image: ',
  segment.image('image.jpg'),
  ' Amazing!'
]
await karin.sendMsg(selfId, contact, message) // Type error!

Root Cause

Two files had incorrect local Message type definitions that only allowed Array<Elements>:

type Message = string | Elements | Array<Elements> // ❌ Incorrect

While the correct SendMessage type was already properly defined in the type system as:

export type SendMessage = string | Elements | Array<string | Elements> // ✅ Correct

The local definitions were shadowing the correct type and preventing mixed arrays.

Changes

This PR fixes the issue by removing the incorrect local Message type definitions and using the proper SendMessage type:

Files changed:

• packages/core/src/service/bot.ts - Updated sendMsg function to use SendMessage type
• packages/core/src/core/karin/sendMsg.ts - Updated sendMaster and sendAdmin functions to use SendMessage type

Impact

After this fix, all active message functions now correctly support mixed arrays:

// All of these patterns now work correctly:
await karin.sendMsg(selfId, contact, 'Simple string')
await karin.sendMsg(selfId, contact, segment.image('img.jpg'))
await karin.sendMsg(selfId, contact, [segment.at('123'), segment.text('Hi')])
await karin.sendMsg(selfId, contact, ['String', segment.image('img.jpg')]) // ✅ Now works!

// Also applies to:
await karin.sendMaster(selfId, masterId, ['Text', segment.at('123')])
await karin.sendAdmin(selfId, adminId, ['Text', segment.image('img.jpg')])

Testing

• ✅ TypeScript compilation verified
• ✅ No breaking changes to existing code
• ✅ All existing message patterns continue to work
• ✅ New mixed array pattern now supported

Fixes #[issue_number]

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.