stickers

name	stickers
description	Gerencia a biblioteca oficial de stickers do Ravi. Use quando o usuário quiser: - Adicionar, listar, mostrar, remover ou enviar stickers - Entender quando stickers aparecem no prompt - Configurar opt-in de stickers por agent - Verificar suporte WhatsApp-only para envio de stickers

Sticker Library

Stickers são uma surface separada de resposta no Ravi:

• texto normal
• reação emoji (ravi react send)
• silêncio (@@SILENT@@)
• sticker (ravi stickers send)

Use stickers com parcimônia. Se o sticker for a resposta inteira, envie o sticker e depois responda exatamente @@SILENT@@, sem texto adicional.

Capability Gate

Stickers só existem para canais com capability explícita. O suporte inicial de envio é WhatsApp.

Não diga que Matrix, TUI ou outros canais suportam stickers. Nesses canais o prompt não deve oferecer instruções de stickers e ravi stickers send deve falhar.

Opt-in Por Agent

O prompt só recebe a seção Stickers quando:

1. o canal atual suporta stickers,
2. o agent tem stickers habilitados,
3. existe pelo menos um sticker enabled, permitido para o canal e para o agent.

Habilite no agent:

ravi agents set main defaults '{"stickers":{"enabled":true}}'

Launchers avançados também podem habilitar somente uma sessão com runtimeSessionParams.stickers.enabled=true.

Catálogo

O catálogo tipado vive fora do prompt:

~/.ravi/stickers/catalog.json

Campos:

• id
• label
• description
• avoid
• channels
• agents
• media
• enabled

O prompt recebe apenas Markdown curto com IDs e descrições naturais. Nunca injete base64, binário, paths locais ou JSON no prompt.

Comandos

Adicionar:

ravi stickers add wave "/path/to/wave.webp" \
  --label "Wave" \
  --description "Use for a friendly quick hello." \
  --avoid "Do not use during serious incidents." \
  --channels whatsapp \
  --json

Listar e inspecionar:

ravi stickers list --json
ravi stickers show wave --json

Remover:

ravi stickers remove wave --json

Enviar no chat WhatsApp atual:

ravi stickers send wave --json

Enviar com alvo explícito:

ravi stickers send wave --channel whatsapp --account main --to "[e-mail]" --json

Envio

ravi stickers send resolve o alvo pelo contexto da sessão atual ou por --session.

O evento emitido é:

ravi.stickers.send

O gateway valida capability de canal e usa o caminho omni de mídia com tipo sticker.