@omnizap-system/omnizap 2.6.1 → 2.6.2

package/app/modules/stickerPackModule/stickerPackCommandHandlers.js

@@ -7,8 +7,7 @@ import { STICKER_PACK_ERROR_CODES, StickerPackError } from './stickerPackErrors.
 import { captureIncomingStickerAsset, resolveStickerAssetForCommand } from './stickerStorageService.js';
 import { buildStickerPackMessage, sendStickerPackWithFallback } from './stickerPackMessageService.js';
 import { sanitizeText } from './stickerPackUtils.js';
-import { executeQuery, TABLES } from '../../../database/index.js';
-import { extractSenderInfoFromMessage, extractUserIdInfo, resolveUserId } from '../../config/index.js';
+import { extractSenderInfoFromMessage, extractUserIdInfo, normalizePnToJid, primeLidCache, resolveCanonicalWhatsAppJid, resolveUserId, resolveUserIdCached } from '../../config/index.js';
 import { toWhatsAppPhoneDigits } from '../../services/auth/whatsappLoginLinkService.js';
 
 /**
@@ -19,6 +18,7 @@ const RATE_MAX_ACTIONS = Math.max(1, Number(process.env.STICKER_PACK_RATE_MAX_AC
 const MAX_PACK_ITEMS = Math.max(1, Number(process.env.STICKER_PACK_MAX_ITEMS) || 30);
 const MAX_PACK_NAME_LENGTH = 120;
 const LID_SERVERS = new Set(['lid', 'hosted.lid']);
+const OWNER_ID_SERVERS = new Set(['s.whatsapp.net', 'c.us', 'hosted', ...LID_SERVERS]);
 
 const rateMap = new Map();
 
@@ -457,7 +457,9 @@ const readSingleArgument = (input) => {
 };
 
 const buildOwnerLookupJids = (value) => {
-  const normalized = normalizeJid(value) || '';
+  const normalizedValue = normalizeJid(value) || '';
+  const normalizedPn = normalizePnToJid(normalizedValue);
+  const normalized = normalizeJid(normalizedPn || normalizedValue) || normalizedPn || normalizedValue;
   if (!normalized || !normalized.includes('@')) return [];
   const lookup = new Set([normalized]);
   const digits = toWhatsAppPhoneDigits(normalized);
@@ -468,12 +470,39 @@ const buildOwnerLookupJids = (value) => {
   return Array.from(lookup).filter(Boolean);
 };
 
-const appendOwnerCandidate = (candidateSet, lookupSet, value) => {
-  const normalized = normalizeJid(value) || '';
+const appendOwnerCandidate = (candidateSet, value) => {
+  const normalizedValue = normalizeJid(value) || '';
+  const normalizedPn = normalizePnToJid(normalizedValue);
+  const normalized = normalizeJid(normalizedPn || normalizedValue) || normalizedPn || normalizedValue;
   if (!normalized || !normalized.includes('@')) return;
+  const server = getJidServer(normalized);
+  if (!server || !OWNER_ID_SERVERS.has(server)) return;
   candidateSet.add(normalized);
   for (const lookupJid of buildOwnerLookupJids(normalized)) {
-    lookupSet.add(lookupJid);
+    candidateSet.add(lookupJid);
+  }
+};
+
+const appendOwnerCandidatesFromSource = (candidateSet, source) => {
+  if (!source) return;
+
+  const info = extractUserIdInfo(source);
+  appendOwnerCandidate(candidateSet, resolveUserIdCached(info));
+  appendOwnerCandidate(candidateSet, info.jid);
+  appendOwnerCandidate(candidateSet, info.lid);
+  appendOwnerCandidate(candidateSet, info.participantAlt);
+  appendOwnerCandidate(candidateSet, info.raw);
+
+  if (typeof source === 'object') {
+    appendOwnerCandidate(candidateSet, source.id);
+    appendOwnerCandidate(candidateSet, source.jid);
+    appendOwnerCandidate(candidateSet, source.lid);
+    appendOwnerCandidate(candidateSet, source.participant);
+    appendOwnerCandidate(candidateSet, source.participantAlt);
+    appendOwnerCandidate(candidateSet, source.remoteJid);
+    appendOwnerCandidate(candidateSet, source.remoteJidAlt);
+  } else {
+    appendOwnerCandidate(candidateSet, source);
   }
 };
 
@@ -505,58 +534,42 @@ const dedupePacksById = (packs = []) => {
 
 const resolveOwnerCandidatesForPackCommand = async ({ senderJid, messageInfo }) => {
   const candidates = new Set();
-  const lookupByJid = new Set();
 
   const senderInfo = extractSenderInfoFromMessage(messageInfo);
-  appendOwnerCandidate(candidates, lookupByJid, senderJid);
-  appendOwnerCandidate(candidates, lookupByJid, senderInfo?.jid);
-  appendOwnerCandidate(candidates, lookupByJid, senderInfo?.participantAlt);
-  appendOwnerCandidate(candidates, lookupByJid, senderInfo?.lid);
-
-  const directResolved = await resolveUserId(extractUserIdInfo(senderJid)).catch(() => null);
-  if (directResolved) {
-    appendOwnerCandidate(candidates, lookupByJid, directResolved);
-  }
-
-  const senderResolved = await resolveUserId({
-    lid: senderInfo?.lid,
+  appendOwnerCandidatesFromSource(candidates, senderJid);
+  appendOwnerCandidatesFromSource(candidates, senderInfo);
+  appendOwnerCandidatesFromSource(candidates, messageInfo?.key);
+  appendOwnerCandidatesFromSource(candidates, {
     jid: senderInfo?.jid || senderJid || null,
+    lid: senderInfo?.lid || null,
     participantAlt: senderInfo?.participantAlt || null,
-  }).catch(() => null);
-  if (senderResolved) {
-    appendOwnerCandidate(candidates, lookupByJid, senderResolved);
-  }
+    remoteJid: senderInfo?.remoteJid || null,
+    remoteJidAlt: senderInfo?.remoteJidAlt || null,
+  });
 
-  const lookupValues = Array.from(lookupByJid).filter(Boolean);
-  for (let offset = 0; offset < lookupValues.length; offset += 200) {
-    const chunk = lookupValues.slice(offset, offset + 200);
-    if (!chunk.length) continue;
-    const placeholders = chunk.map(() => '?').join(', ');
-    const lookupParams = [...chunk, ...chunk];
-    const rows = await executeQuery(
-      `SELECT lid, jid
-         FROM ${TABLES.LID_MAP}
-        WHERE jid IN (${placeholders})
-           OR lid IN (${placeholders})
-        ORDER BY last_seen DESC
-        LIMIT 500`,
-      lookupParams,
-    ).catch(() => []);
-
-    for (const row of Array.isArray(rows) ? rows : []) {
-      appendOwnerCandidate(candidates, lookupByJid, row?.jid || '');
-      appendOwnerCandidate(candidates, lookupByJid, row?.lid || '');
-    }
+  const lidCandidates = Array.from(candidates).filter((candidate) => LID_SERVERS.has(getJidServer(candidate)));
+  if (lidCandidates.length) {
+    await primeLidCache(lidCandidates).catch(() => null);
   }
 
-  const lidCandidates = Array.from(candidates).filter((candidate) => LID_SERVERS.has(getJidServer(candidate)));
-  for (const lidValue of lidCandidates) {
-    const resolved = await resolveUserId(extractUserIdInfo(lidValue)).catch(() => null);
-    if (resolved) {
-      appendOwnerCandidate(candidates, lookupByJid, resolved);
-    }
+  const currentCandidates = Array.from(candidates);
+  const resolvedCandidates = await Promise.all(
+    currentCandidates.map(async (candidate) => {
+      const info = extractUserIdInfo(candidate);
+      const resolvedCached = resolveUserIdCached(info);
+      const resolved = await resolveUserId(info).catch(() => null);
+      return [resolvedCached, resolved];
+    }),
+  );
+
+  for (const [resolvedCached, resolved] of resolvedCandidates) {
+    appendOwnerCandidate(candidates, resolvedCached);
+    appendOwnerCandidate(candidates, resolved);
   }
 
+  const canonicalWhatsApp = resolveCanonicalWhatsAppJid(...Array.from(candidates));
+  appendOwnerCandidate(candidates, canonicalWhatsApp);
+
   return Array.from(candidates);
 };
 
@@ -712,7 +725,7 @@ export async function handlePackCommand({ sock, remoteJid, messageInfo, expirati
         const name = normalizePackName(base);
         const publisher = options.publisher || options.pub || options.autor || senderName || 'OmniZap';
         const description = options.desc || options.description || '';
-        const visibility = options.visibility || options.vis || 'public';
+        const visibility = options.visibility || options.vis || 'private';
 
         const created = await stickerPackService.createPack({
           ownerJid,
@@ -1121,16 +1134,24 @@ export async function maybeCaptureIncomingSticker({ messageInfo, senderJid, isMe
   if (!isUserJid(senderJid)) return null;
 
   const senderInfo = extractSenderInfoFromMessage(messageInfo);
-  let ownerJid = normalizeJid(senderJid) || senderJid;
+  const senderIdentity = extractUserIdInfo({
+    lid: senderInfo?.lid || null,
+    jid: senderInfo?.jid || senderJid || null,
+    participantAlt: senderInfo?.participantAlt || null,
+    remoteJid: senderInfo?.remoteJid || null,
+    remoteJidAlt: senderInfo?.remoteJidAlt || null,
+  });
+
+  const cachedOwner = resolveUserIdCached(senderIdentity);
+  let ownerJid = normalizeJid(cachedOwner || senderIdentity.jid || senderIdentity.lid || senderJid) || senderJid;
   try {
-    const resolvedOwner = await resolveUserId({
-      lid: senderInfo?.lid,
-      jid: senderInfo?.jid || senderJid || null,
-      participantAlt: senderInfo?.participantAlt || null,
-    });
+    if (senderIdentity.lid) {
+      await primeLidCache([senderIdentity.lid]).catch(() => null);
+    }
+    const resolvedOwner = await resolveUserId(senderIdentity);
     ownerJid = normalizeJid(resolvedOwner || ownerJid) || ownerJid;
   } catch {
-    ownerJid = normalizeJid(senderJid) || senderJid;
+    ownerJid = normalizeJid(cachedOwner || senderJid) || senderJid;
   }
 
   try {

package/app/modules/stickerPackModule/stickerPackService.js

@@ -331,7 +331,7 @@ export function createStickerPackService(options = {}) {
     };
   };
 
-  const sanitizeMetadata = ({ name, publisher, description, visibility }) => {
+  const sanitizeMetadata = ({ name, publisher, description, visibility, defaultVisibility = 'private' }) => {
     const normalizedName = sanitizeText(name, MAX_NAME_LENGTH, { allowEmpty: false });
     const normalizedPublisher = sanitizeText(publisher, MAX_PUBLISHER_LENGTH, {
       allowEmpty: false,
@@ -339,7 +339,7 @@ export function createStickerPackService(options = {}) {
     const normalizedDescription = sanitizeText(description, MAX_DESCRIPTION_LENGTH, {
       allowEmpty: true,
     });
-    const normalizedVisibility = toVisibility(visibility, 'public');
+    const normalizedVisibility = toVisibility(visibility, defaultVisibility);
 
     ensureValue(normalizedName, STICKER_PACK_ERROR_CODES.INVALID_INPUT, 'Nome do pack é obrigatório.');
     ensureValue(normalizedPublisher, STICKER_PACK_ERROR_CODES.INVALID_INPUT, 'Publisher do pack é obrigatório.');
@@ -352,13 +352,20 @@ export function createStickerPackService(options = {}) {
     };
   };
 
-  const createPack = async ({ ownerJid, name, publisher, description, visibility = 'public', status = 'published', packStatus = undefined, packThemeKey = undefined, packVolume = undefined, isAutoPack = undefined, lastRebalancedAt = undefined }) => {
+  const createPack = async ({ ownerJid, name, publisher, description, visibility = undefined, status = 'published', packStatus = undefined, packThemeKey = undefined, packVolume = undefined, isAutoPack = undefined, lastRebalancedAt = undefined }) => {
     const owner = resolveOwner(ownerJid);
+    const isAutoPackEnabled = isAutoPack === true || Number(isAutoPack || 0) === 1;
     const normalizedStatus = PACK_STATUS_VALUES.has(String(status || '').toLowerCase()) ? String(status).toLowerCase() : 'published';
 
     return runAction('create_pack', { owner_jid: owner }, async () => {
       return runInTransaction(async (connection) => {
-        const metadata = sanitizeMetadata({ name, publisher, description, visibility });
+        const metadata = sanitizeMetadata({
+          name,
+          publisher,
+          description,
+          visibility,
+          defaultVisibility: isAutoPackEnabled ? 'public' : 'private',
+        });
         if (hasOwnerPackLimit) {
           const existing = await deps.packRepository.listStickerPacksByOwner(owner, {
             limit: maxPacksPerOwner + 1,
@@ -384,7 +391,7 @@ export function createStickerPackService(options = {}) {
             pack_status: packStatus,
             pack_theme_key: packThemeKey,
             pack_volume: packVolume,
-            is_auto_pack: isAutoPack,
+            is_auto_pack: isAutoPackEnabled,
             last_rebalanced_at: lastRebalancedAt,
             version: 1,
           },
@@ -679,7 +686,7 @@ export function createStickerPackService(options = {}) {
             description: source.description,
             pack_key: packKey,
             cover_sticker_id: source.cover_sticker_id,
-            visibility: 'public',
+            visibility: 'private',
             version: 1,
           },
           connection,

package/app/modules/systemMetricsModule/AGENT.md

@@ -7,7 +7,7 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - arquivo_base: `app/modules/systemMetricsModule/commandConfig.json`
 - schema_version: `2.0.0`
 - module_enabled: `true`
-- generated_at: `2026-03-11T02:35:17.177Z`
+- generated_at: `2026-03-17T04:04:14.195Z`
 
 ## Escopo do Modulo
 

package/app/modules/systemMetricsModule/commandConfig.json

@@ -335,6 +335,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "statusbot",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Exibe latência e estado de saúde do servidor com um comando simples. Não requer Premium.",
+        "quando_usar": ["Antes de iniciar tarefas importantes, para confirmar se o servidor está respondendo.", "Após perceber lentidão ou instabilidade, para checar o status rapidamente.", "Durante monitoramento rápido para verificar se tudo está estável ao longo do dia."],
+        "exemplos_reais": [
+          {
+            "situacao": "Checagem rápida antes de iniciar uma tarefa.",
+            "comando": "<prefix>statusbot",
+            "resposta_esperada": "Latência atual: 42 ms | Status: OK.",
+            "variacao": "ou <prefix>ping."
+          },
+          {
+            "situacao": "Lentidão percebida durante pico de tráfego.",
+            "comando": "<prefix>statusbot",
+            "resposta_esperada": "Latência atual: 320 ms | Status: Atenção - possíveis lentidões. Verifique sua rede.",
+            "variacao": "Se o problema persistir, tente novamente em alguns minutos."
+          },
+          {
+            "situacao": "Verificando disponibilidade após manutenção.",
+            "comando": "<prefix>statusbot",
+            "resposta_esperada": "Latência atual: 15 ms | Status: OK.",
+            "variacao": "Se retornar erro, espere e tente novamente."
+          }
+        ],
+        "resposta_esperada": ["Latência atual: <valor> ms | Status: OK.", "Latência atual: <valor> ms | Status: Atenção - verifique rede.", "Latência atual: <valor> ms | Status: ERRO - serviço indisponível."],
+        "erros_comuns_usuario": ["Esquecer de incluir o prefixo <prefix> ao digitar o comando.", "Executar sem estar conectado à internet ou com a rede instável.", "Esperar uma resposta com muitos detalhes além da latência e do status simples.", "Não estar logado com Google quando a autenticação for necessária.", "Tentar usar o comando em horários de manutenção sem observar a latência."],
+        "passos_se_der_erro": ["Verifique a sua conexão com a internet e tente novamente.", "Aguarde alguns segundos e execute novamente o comando: <prefix>statusbot.", "Confira se há mensagens de erro específicas (ex.: permissionError) e corrija as permissões se necessário.", "Se o problema persistir, tente em outro momento ou contate o suporte, descrevendo o que aconteceu."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/tiktokModule/AGENT.md

@@ -7,7 +7,7 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - arquivo_base: `app/modules/tiktokModule/commandConfig.json`
 - schema_version: `2.0.0`
 - module_enabled: `true`
-- generated_at: `2026-03-11T02:35:17.177Z`
+- generated_at: `2026-03-17T04:04:14.195Z`
 
 ## Escopo do Modulo
 

package/app/modules/tiktokModule/commandConfig.json

@@ -357,6 +357,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "baixartiktok",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Baixe vídeos do TikTok sem marca d'água a partir de URLs, direto no chat.",
+        "quando_usar": ["Quero salvar vídeos do TikTok sem a marca d’água para assistir offline.", "Preciso baixar até 5 vídeos de uma vez.", "Uso rápido: baixar rapidamente sem complicações."],
+        "exemplos_reais": [
+          {
+            "situacao": "Baixar um único vídeo.",
+            "comando": "<prefix>baixartiktok https://www.tiktok.com/@usuario/video/12345",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "<prefix>tt https://tiktok.com/@usuario/video/12345."
+          },
+          {
+            "situacao": "Baixar até 5 vídeos de uma vez.",
+            "comando": "<prefix>tt https://www.tiktok.com/@a/video/1 https://www.tiktok.com/@b/video/2",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "<prefix>baixartiktok https://tiktok.com/@a/video/1 https://tiktok.com/@b/video/2."
+          },
+          {
+            "situacao": "Formato de uso inválido.",
+            "comando": "<prefix>baixartiktok",
+            "resposta_esperada": "Formato de uso inválido. Consulte metodos_de_uso.",
+            "variacao": "<prefix>tt <url> <url> extra."
+          }
+        ],
+        "resposta_esperada": ["Comando executado com sucesso.", "Formato de uso inválido. Consulte metodos_de_uso.", "Permissão insuficiente para executar este comando."],
+        "erros_comuns_usuario": ["Não incluir URL(s) ou incluir mais de 5 URLs.", "Usar URLs que não são do TikTok.", "Esquecer de colocar o prefixo correto do comando.", "Tentar usar sem conexão estável."],
+        "passos_se_der_erro": ["Confira se inseriu entre 1 e 5 URLs válidas do TikTok.", "Use o formato correto: <prefix>baixartiktok <url> ou <prefix>tt <url1> <url2> ...", "Verifique a sua conexão com a internet.", "Se o erro persistir, tente novamente mais tarde ou contate o suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/userModule/AGENT.md

@@ -7,7 +7,7 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - arquivo_base: `app/modules/userModule/commandConfig.json`
 - schema_version: `2.0.0`
 - module_enabled: `true`
-- generated_at: `2026-03-11T02:35:17.177Z`
+- generated_at: `2026-03-17T04:04:14.195Z`
 
 ## Escopo do Modulo
 

package/app/modules/userModule/commandConfig.json

@@ -377,6 +377,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "perfil",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Consulta o perfil e estatísticas de um usuário. Exibe dados básicos como nome, bio, foto e métricas rápidas.",
+        "quando_usar": ["Precisa ver informações de alguém no chat.", "Quer confirmar dados de um usuário pelo id, telefone ou menção.", "Antes de agir com base no perfil, verifique as informações obtidas."],
+        "exemplos_reais": [
+          {
+            "situacao": "Ver o próprio perfil.",
+            "comando": "<prefix>perfil perfil",
+            "resposta_esperada": "Perfil exibido com dados básicos do seu usuário.",
+            "variacao": "perfil."
+          },
+          {
+            "situacao": "Consultar perfil por ID.",
+            "comando": "<prefix>perfil perfil 12345",
+            "resposta_esperada": "Perfil do usuário 12345 exibido.",
+            "variacao": "<prefix>perfil perfil 12345."
+          },
+          {
+            "situacao": "Consultar perfil por @contato.",
+            "comando": "<prefix>usuario perfil @joana",
+            "resposta_esperada": "Perfil do contato exibido.",
+            "variacao": "<prefix>usuario perfil @joana."
+          }
+        ],
+        "resposta_esperada": ["Perfil exibido com sucesso com informações básicas e estatísticas.", "Erro: usuário não encontrado ou alvo inválido."],
+        "erros_comuns_usuario": ["Formato de uso inválido. Use <prefix>perfil perfil [alvo].", "Alvo ausente ou inválido (id, telefone ou menção).", "Não autorizado: verifique se está logado com sua conta Google."],
+        "passos_se_der_erro": ["Conferir formato do comando: <prefix>perfil perfil [alvo].", "Verificar o alvo informado (id, telefone ou menção).", "Garantir login com conta Google.", "Se o erro persistir, tente novamente mais tarde ou contate o suporte com o comando utilizado."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/waifuPicsModule/AGENT.md

@@ -7,7 +7,7 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - arquivo_base: `app/modules/waifuPicsModule/commandConfig.json`
 - schema_version: `2.0.0`
 - module_enabled: `true`
-- generated_at: `2026-03-11T02:35:17.177Z`
+- generated_at: `2026-03-17T04:04:14.195Z`
 
 ## Escopo do Modulo
 
@@ -90,9 +90,9 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - <prefix>wp neko
 - mensagens_uso (variantes):
 - default:
-- 💡 _Uso:_ <prefix>waifu <categoria>
-  Exemplo: <prefix>waifu neko
-- Dica: Use <prefix>waifuajuda para ver todas as categorias! 🎨
+- 🖼️ _Como usar:_ <prefix>waifu <categoria>
+- Exemplos rápidos: <prefix>waifu neko | <prefix>wp hug
+- Quer ver todas as categorias disponíveis? Use <prefix>waifuajuda.
 - subcomandos:
 - (nenhum)
 - argumentos:
@@ -125,12 +125,22 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - consulta API externa
 - envia imagem no chat
 - respostas_padrao:
-- success: Prontinho! Aqui está sua imagem. ✨
-- usage_error: Ops! Parece que você esqueceu a categoria. Use <prefix>waifuajuda para ver as opções disponíveis. 🧐
-- permission_error: Eita! Você não tem permissão para usar este comando. Entre em contato com um administrador. 🔐
-- sucesso: Comando executado com sucesso.
-- erro_uso: Formato de uso inválido. Consulte metodos_de_uso.
-- erro_permissao: Permissão insuficiente para executar este comando.
+- success: ✅ Pedido recebido! Aqui vai sua imagem.
+  Dica: você pode pedir outra categoria no próximo comando (ex.: <prefix>waifu neko).
+- usage_error: ❗ Não entendi o formato do comando.
+  Exemplos:
+  • <prefix>waifu neko
+  • <prefix>waifunsfw waifu
+  Para ver todas as categorias: <prefix>waifuajuda
+- permission_error: 🔒 Este comando não está liberado para você neste contexto.
+  Se for NSFW em grupo, peça para um admin usar <prefix>nsfw on.
+- sucesso: ✅ Imagem enviada com sucesso!
+  Exemplo de próximo pedido: <prefix>waifu hug
+- erro_uso: ❗ Categoria inválida ou ausente.
+  Exemplos: <prefix>waifu neko | <prefix>wp waifu
+  Veja a lista completa em <prefix>waifuajuda.
+- erro_permissao: 🔒 Não consegui liberar este pedido para seu perfil.
+  Se achar que é engano, verifique seu plano e tente novamente.
 - mensagens_sistema:
 - (nao informado)
 - limites_operacionais:
@@ -211,9 +221,9 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - <prefix>wpnsfw waifu
 - mensagens_uso (variantes):
 - default:
-- 🔞 _Uso:_ <prefix>waifunsfw <categoria>
-  Exemplo: <prefix>wpnsfw blowjob
-- Atenção: O grupo deve estar com NSFW ligado!
+- 🔞 _Como usar:_ <prefix>waifunsfw <categoria>
+- Exemplos rápidos: <prefix>waifunsfw waifu | <prefix>wpnsfw neko
+- Pré-requisitos: plano Premium; em grupo, NSFW ativo com <prefix>nsfw on.
 - subcomandos:
 - (nenhum)
 - argumentos:
@@ -247,12 +257,22 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - consulta API externa
 - envia imagem NSFW no chat
 - respostas_padrao:
-- success: Prontinho! Aqui está sua imagem. ✨
-- usage_error: Ops! Parece que você esqueceu a categoria. Use <prefix>waifuajuda para ver as opções disponíveis. 🧐
-- permission_error: Eita! Você não tem permissão para usar este comando. Entre em contato com um administrador. 🔐
-- sucesso: Comando executado com sucesso.
-- erro_uso: Formato de uso inválido. Consulte metodos_de_uso.
-- erro_permissao: Permissão insuficiente para executar este comando.
+- success: ✅ Pedido recebido! Aqui vai sua imagem.
+  Dica: você pode pedir outra categoria no próximo comando (ex.: <prefix>waifu neko).
+- usage_error: ❗ Não entendi o formato do comando.
+  Exemplos:
+  • <prefix>waifu neko
+  • <prefix>waifunsfw waifu
+  Para ver todas as categorias: <prefix>waifuajuda
+- permission_error: 🔒 Este comando não está liberado para você neste contexto.
+  Se for NSFW em grupo, peça para um admin usar <prefix>nsfw on.
+- sucesso: 🔞 Imagem NSFW enviada.
+  Exemplo de próximo pedido: <prefix>waifunsfw neko
+- erro_uso: ❗ Categoria NSFW inválida ou ausente.
+  Exemplos: <prefix>waifunsfw waifu | <prefix>wpnsfw neko
+  Veja opções em <prefix>waifuajuda.
+- erro_permissao: 🔒 Este comando NSFW exige acesso Premium.
+  Em grupos, também é preciso NSFW ativo com <prefix>nsfw on.
 - mensagens_sistema:
 - (nao informado)
 - limites_operacionais:
@@ -332,8 +352,9 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - <prefix>waifuajuda
 - mensagens_uso (variantes):
 - default:
-- 📖 _Guia Rápido:_ Digite <prefix>waifuajuda para ver as categorias SFW e NSFW disponíveis.
-- Use <prefix>waifu <categoria> para receber uma imagem!
+- 📖 _Como usar:_ <prefix>waifuajuda
+- Depois do guia, teste: <prefix>waifu neko
+- Para NSFW: <prefix>waifunsfw waifu (Premium; em grupo exige <prefix>nsfw on).
 - subcomandos:
 - (nenhum)
 - argumentos:
@@ -364,12 +385,21 @@ Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos co
 - efeitos_colaterais:
 - envia mensagem de ajuda
 - respostas_padrao:
-- success: Prontinho! Aqui está sua imagem. ✨
-- usage_error: Ops! Parece que você esqueceu a categoria. Use <prefix>waifuajuda para ver as opções disponíveis. 🧐
-- permission_error: Eita! Você não tem permissão para usar este comando. Entre em contato com um administrador. 🔐
-- sucesso: Comando executado com sucesso.
-- erro_uso: Formato de uso inválido. Consulte metodos_de_uso.
-- erro_permissao: Permissão insuficiente para executar este comando.
+- success: ✅ Pedido recebido! Aqui vai sua imagem.
+  Dica: você pode pedir outra categoria no próximo comando (ex.: <prefix>waifu neko).
+- usage_error: ❗ Não entendi o formato do comando.
+  Exemplos:
+  • <prefix>waifu neko
+  • <prefix>waifunsfw waifu
+  Para ver todas as categorias: <prefix>waifuajuda
+- permission_error: 🔒 Este comando não está liberado para você neste contexto.
+  Se for NSFW em grupo, peça para um admin usar <prefix>nsfw on.
+- sucesso: 📚 Guia enviado com sucesso.
+  Agora experimente: <prefix>waifu neko
+- erro_uso: ℹ️ Este comando não precisa de argumentos.
+  Use apenas: <prefix>waifuajuda
+- erro_permissao: 🔒 Não consegui mostrar o guia neste contexto.
+  Tente novamente no privado ou em um grupo permitido.
 - mensagens_sistema:
 - (nao informado)
 - limites_operacionais:

package/app/modules/waifuPicsModule/commandConfig.json

@@ -357,6 +357,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "waifu",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Guia rápido para usar o comando waifu e receber uma imagem de anime (SFW) da categoria escolhida.",
+        "quando_usar": ["Quando você quer uma imagem de anime específica (ex.: neko, waifu) sem enviar outras perguntas."],
+        "exemplos_reais": [
+          {
+            "situacao": "Quero uma imagem de neko.",
+            "comando": "<prefix>waifu neko",
+            "resposta_esperada": "✅ Imagem enviada com sucesso! Exemplo de próximo pedido: <prefix>waifu hug.",
+            "variacao": "Usando alias: <prefix>wp neko."
+          },
+          {
+            "situacao": "Não informei a categoria.",
+            "comando": "<prefix>waifu",
+            "resposta_esperada": "❗ Categoria inválida ou ausente. Exemplos: <prefix>waifu neko | <prefix>wp waifu Veja a lista completa em <prefix>waifuajuda.",
+            "variacao": "Tente: <prefix>waifu neko."
+          },
+          {
+            "situacao": "Categoria não suportada.",
+            "comando": "<prefix>waifu dragon",
+            "resposta_esperada": "❗ Categoria inválida ou ausente. Exemplos: <prefix>waifu neko | <prefix>wp waifu Veja a lista completa em <prefix>waifuajuda.",
+            "variacao": "Tente uma categoria comum como neko ou waifu."
+          }
+        ],
+        "resposta_esperada": ["O bot envia uma imagem de anime da categoria solicitada (SFW)."],
+        "erros_comuns_usuario": ["Esquecer de indicar a categoria", "Usar uma categoria não suportada", "Usar o comando sem o prefixo quando necessário", "Erro de conexão temporário"],
+        "passos_se_der_erro": ["1. Verifique se digitou a categoria corretamente. 2. Use o formato com prefixo: <prefix>waifu <categoria> ou <prefix>wp <categoria>. 3. Se receber erro de categoria, peça a lista de categorias com <prefix>waifuajuda e es"],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -575,6 +604,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "waifunsfw",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Envie imagens NSFW de waifus em grupos autorizados. Requer Premium e NSFW ativo. Use <prefix>waifunsfw <categoria> ou <prefix>wpnsfw <waifu>.",
+        "quando_usar": ["Quando o grupo tiver NSFW ativo e você for assinante Premium.", "Para solicitar uma imagem NSFW de uma categoria válida (ex.: neko, waifu, etc.).", "Para confirmar qual variedade de conteúdo NSFW está disponível no momento."],
+        "exemplos_reais": [
+          {
+            "situacao": "Grupo com NSFW ativo e usuário Premium solicita neko.",
+            "comando": "<prefix>waifunsfw neko",
+            "resposta_esperada": "🔞 Imagem NSFW enviada. Exemplo de próximo pedido: <prefix>waifunsfw neko.",
+            "variacao": "neko."
+          },
+          {
+            "situacao": "Grupo sem Premium ou NSFW ativo.",
+            "comando": "<prefix>waifunsfw neko",
+            "resposta_esperada": "🔒 Este comando NSFW exige acesso Premium. Em grupos, também é preciso NSFW ativo com <prefix>nsfw on.",
+            "variacao": "premium_required."
+          },
+          {
+            "situacao": "Categoria NSFW inválida.",
+            "comando": "<prefix>waifunsfw manga",
+            "resposta_esperada": "❗ Categoria NSFW inválida ou ausente. Exemplos: <prefix>waifunsfw waifu | <prefix>wpnsfw neko Veja opções em <prefix>waifuajuda.",
+            "variacao": "categoria_invalida."
+          }
+        ],
+        "resposta_esperada": ["🔞 Imagem NSFW enviada. Exemplo de próximo pedido: <prefix>waifunsfw neko", "❗ Categoria NSFW inválida ou ausente. Exemplos: <prefix>waifunsfw waifu | <prefix>wpnsfw neko Veja opções em <prefix>waifuajuda.", "🔒 Este comando NSFW exige acesso Premium. Em grupos, também é preciso NSFW ativo com <prefix>nsfw on."],
+        "erros_comuns_usuario": ["Não informar a categoria NSFW", "Categoria informada não é suportada", "NSFW não está ativo no grupo", "Usuário não possui assinatura Premium"],
+        "passos_se_der_erro": ["Verifique se o NSFW está ativo no grupo com <prefix>nsfw on e peça ao admin para ativar, se necessário.", "Confirme que você possui uma assinatura Premium válida para usar o comando.", "Certifique-se de digitar uma categoria NSFW suportada, por exemplo neko, waifu, etc.", "Tente novamente com uma categoria diferente ou em outro momento; se o problema persistir, peça ajuda ao administrador do grupo."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -771,6 +829,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "waifuajuda",
         "legacy_fields_present": ["descricao", "metodos_de_uso", "permissao_necessaria", "local_de_uso", "informacoes_coletadas", "argumentos", "pre_condicoes", "dependencias_externas", "efeitos_colaterais", "observabilidade", "privacidade", "acesso", "limite_uso_por_plano"]
+      },
+      "user_experience": {
+        "resumo_usuario": "Guia rápido das categorias de fotos anime que posso enviar. Mostra todas as opções disponíveis e como usar o comando. Não é necessário Premium; funciona para planos comum e premium.",
+        "quando_usar": ["Quando você quer conhecer todas as categorias de fotos disponíveis sem digitar argumentos", "Quando precisa confirmar que o comando não aceita parâmetros", "Quando desejar usar o alias wppicshelp para abrir o guia rapidamente"],
+        "exemplos_reais": [
+          {
+            "situacao": "Usuário quer abrir o guia rapidamente com o prefix.",
+            "comando": "<prefix>waifuajuda",
+            "resposta_esperada": "Guia de categorias exibido. Exemplo: <prefix>waifu neko.",
+            "variacao": "uso direto com <prefix>."
+          },
+          {
+            "situacao": "Usuário prefere usar o alias.",
+            "comando": "wppicshelp",
+            "resposta_esperada": "Guia de categorias exibido. Observação: você pode usar <prefix>waifu neko para abrir uma categoria específica.",
+            "variacao": "alias."
+          },
+          {
+            "situacao": "Usuário está em contexto privado ou grupo permitido.",
+            "comando": "<prefix>waifuajuda",
+            "resposta_esperada": "Guia pronto. Veja as categorias disponíveis e escolha uma: neko, shinobu, etc.",
+            "variacao": "contexto privado ou grupo permitido."
+          }
+        ],
+        "resposta_esperada": ["Guia de categorias exibido com sucesso. Use <prefix>waifu neko para ver fotos de uma categoria específica."],
+        "erros_comuns_usuario": ["Tentar usar o comando com argumentos, quando ele não exige nenhum.", "Esquecer de incluir o prefixo, por exemplo usar 'waifuajuda' sem o prefixo.", "Tentar usar em contexto onde o guia não pode ser exibido (contextos não suportados)."],
+        "passos_se_der_erro": ["Verifique se o comando está sendo usado em um contexto permitido (privado ou grupo permitido).", "Tente novamente com o prefix correto: <prefix>waifuajuda.", "Se o guia não aparecer, tente novamente mais tarde ou entre em contato com o suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],