XMTP reactions

Send and receive emoji reactions, including thinking indicator patterns.

When to apply

Reference these guidelines when:

• Reacting to user messages with emoji
• Showing processing/thinking state
• Receiving and handling reactions
• Implementing acknowledgment patterns

Rule categories by priority

| Priority | Category | Impact | Prefix | |----------|----------|--------|--------| | 1 | Send | HIGH | send- | | 2 | Receive | HIGH | receive- | | 3 | Patterns | MEDIUM | patterns- |

Quick reference

Send (HIGH)

• send-reaction - Send emoji reactions to messages

Receive (HIGH)

• receive-reaction - Handle incoming reactions

Patterns (MEDIUM)

• patterns-thinking - Thinking indicator pattern

Quick start

// Send a reaction
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "👍",
  schema: "unicode",
});

// Thinking indicator pattern
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "⏳",
  schema: "unicode",
});

// Process...

await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "removed",
  content: "⏳",
  schema: "unicode",
});

How to use

Read individual rule files for detailed explanations:

rules/send-reaction.md
rules/receive-reaction.md
rules/patterns-thinking.md