Message Subject

When your bot receives a comment on a Linear issue, GitHub PR, or Notion page, message.subject resolves the parent resource so your handler knows what the conversation is about.

Usage

bot.onNewMention(async (thread, message) => {
  const subject = await message.subject;

  if (subject) {
    await thread.post(
      `This is about: ${subject.title} (${subject.status})\n${subject.url}`
    );
  }
});

On Linear, GitHub, and Notion, comment webhooks deliver the comment text but not the full parent resource, so message.subject fetches it from the platform API on first access and caches the result on the message instance. Chat platforms have no parent resource, so message.subject returns null there. It also returns null if the API call fails.

See MessageSubject for the full type shape.

Platform support

All other platforms return null.

User info

For user profile details, use bot.getUser:

bot.onNewMention(async (thread, message) => {
  const user = await bot.getUser(message.author);
  if (user) {
    await thread.post(`Hi ${user.fullName} (${user.email})`);
  }
});

For anything beyond message.subject, access the platform's typed API client via bot.getAdapter("github").octokit or bot.getAdapter("linear").linearClient.