@omnizap-system/omnizap 2.6.1 → 2.6.2

package/app/modules/playModule/playConfigRuntime.js

@@ -22,14 +22,14 @@ const DEFAULT_TEXTS = {
   ready_title_video: '🎬 Vídeo pronto!',
   video_fallback_to_audio: '⚠️ Este link retornou somente áudio. Enviando no formato de áudio.',
   anti_bot_with_cookies: 'YouTube solicitou verificação anti-bot. Atualize o arquivo .secrets/cookies.txt e tente novamente.',
-  anti_bot_with_browser_profile: 'YouTube solicitou verificação anti-bot. Verifique o perfil informado em PLAY_YTDLP_COOKIES_FROM_BROWSER e tente novamente.',
-  anti_bot_without_cookies: 'YouTube solicitou verificação anti-bot. Configure PLAY_YTDLP_COOKIES_PATH com um cookies.txt válido e tente novamente.',
+  anti_bot_with_browser_profile: 'YouTube solicitou verificação anti-bot no provedor de mídia. Verifique suas credenciais e tente novamente.',
+  anti_bot_without_cookies: 'YouTube solicitou verificação anti-bot no provedor de mídia. Tente novamente em alguns minutos.',
   usage_fallback_audio: '🎵 Uso: <prefix>play <link do YouTube ou termo de busca>',
   usage_fallback_video: '🎬 Uso: <prefix>playvid <link do YouTube ou termo de busca>',
   invalid_media_type: 'Tipo de mídia inválido.',
   binary_exec_failed: 'Falha ao executar <command>.',
-  ytdlp_error_generic: 'Falha ao processar mídia com yt-dlp.',
-  ytdlp_timeout_generic: 'Timeout ao processar mídia com yt-dlp.',
+  provider_error_generic: 'Falha ao processar mídia no provedor.',
+  provider_timeout_generic: 'Timeout ao processar mídia no provedor.',
   search_invalid_input: 'Você precisa informar um link do YouTube ou termo de busca.',
   search_not_found: 'Nenhum resultado encontrado para a busca.',
   search_timeout: 'Timeout ao buscar metadados do vídeo.',
@@ -69,10 +69,10 @@ const DEFAULT_OPERATIONAL_LIMITS = {
   thumbnail_timeout_ms: 15000,
   max_thumb_bytes: 5 * 1024 * 1024,
   admin_alert_dedupe_window_ms: 120000,
+  ytmp3_poll_interval_ms: 2000,
 };
 
 const DEFAULT_EXECUTION_OPTIONS = {
-  ytdlp_base_args: ['--ignore-config', '--no-playlist', '--no-warnings', '--js-runtimes', 'node', '--extractor-args', 'youtube:player_client=android,web'],
   estrategias_formato: {
     audio: ['bestaudio/best', 'best'],
     video: ['bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]/best', 'bestvideo*+bestaudio/best', 'best'],
@@ -135,7 +135,6 @@ const normalizeExecutionOptions = (raw) => {
   const rawAudioExtract = rawFormat.audio_extract && typeof rawFormat.audio_extract === 'object' ? rawFormat.audio_extract : {};
 
   return {
-    ytdlp_base_args: normalizeStringArray(source.ytdlp_base_args, DEFAULT_EXECUTION_OPTIONS.ytdlp_base_args),
     estrategias_formato: {
       audio: normalizeStringArray(rawFormat.audio, defaultFormat.audio),
       video: normalizeStringArray(rawFormat.video, defaultFormat.video),

package/app/modules/playModule/playModuleCriticalFlows.test.js

@@ -1,11 +1,8 @@
 import { now as __timeNow, nowIso as __timeNowIso, toUnixMs as __timeNowMs } from '#time';
 import assert from 'node:assert/strict';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { test } from 'node:test';
+import { after, test } from 'node:test';
 
-import { __playYtDlpClientTestUtils } from './playCommandYtDlpClient.js';
+import { __playMediaClientTestUtils } from './playCommandMediaClient.js';
 
 const withEnv = async (overrides, fn) => {
   const previous = new Map();
@@ -31,8 +28,18 @@ const withEnv = async (overrides, fn) => {
   }
 };
 
+let closeDatabasePoolForTests = null;
+
+after(async () => {
+  if (typeof closeDatabasePoolForTests !== 'function') {
+    return;
+  }
+  await closeDatabasePoolForTests();
+  closeDatabasePoolForTests = null;
+});
+
 test('resolve candidates deduplica URLs e ignora inválidas', () => {
-  const urls = __playYtDlpClientTestUtils.extractCandidateUrlsFromSearchResult({
+  const urls = __playMediaClientTestUtils.extractCandidateUrlsFromSearchResult({
     resultado: { url: 'https://www.youtube.com/watch?v=abc123' },
     resultados: [{ url: 'https://www.youtube.com/watch?v=abc123' }, { url: 'https://youtu.be/xyz987' }, { url: 'not-an-url' }, { url: 'https://www.youtube.com/watch?v=zzz000' }],
   });
@@ -40,68 +47,44 @@ test('resolve candidates deduplica URLs e ignora inválidas', () => {
   assert.deepEqual(urls, ['https://www.youtube.com/watch?v=abc123', 'https://youtu.be/xyz987', 'https://www.youtube.com/watch?v=zzz000']);
 });
 
-test('estratégia de formato gera tentativas de fallback para áudio e vídeo', () => {
-  const link = 'https://www.youtube.com/watch?v=test123';
-  const outputTemplate = '/tmp/play-test.%(ext)s';
-
-  const audioAttempts = __playYtDlpClientTestUtils.buildDownloadAttemptArgsList({
-    type: 'audio',
-    outputTemplate,
-    link,
-  });
-  assert.ok(audioAttempts.length >= 2);
-  assert.ok(audioAttempts[0].includes('-x'));
-  assert.ok(audioAttempts[0].includes('--audio-format'));
-  assert.equal(audioAttempts[0][audioAttempts[0].length - 1], link);
-
-  const videoAttempts = __playYtDlpClientTestUtils.buildDownloadAttemptArgsList({
-    type: 'video',
-    outputTemplate,
-    link,
-  });
-  assert.ok(videoAttempts.length >= 2);
-  assert.ok(videoAttempts[0].includes('--merge-output-format'));
-  assert.equal(videoAttempts[0][videoAttempts[0].length - 1], link);
-});
+test('ytmp3 principal é elegível para áudio e vídeo com URL do YouTube', () => {
+  assert.equal(
+    __playMediaClientTestUtils.isYtmp3PrimaryEligible({
+      type: 'audio',
+      link: 'https://www.youtube.com/watch?v=test1234567A',
+    }),
+    true,
+  );
 
-test('anti-bot: detecta causa e retorna mensagem apropriada conforme cookies', { concurrency: false }, async () => {
   assert.equal(
-    __playYtDlpClientTestUtils.isYouTubeBotCheckCause({
-      meta: { cause: 'ERROR: [youtube] Sign in to confirm you’re not a bot.' },
+    __playMediaClientTestUtils.isYtmp3PrimaryEligible({
+      type: 'video',
+      link: 'https://www.youtube.com/watch?v=test1234567A',
     }),
     true,
   );
 
-  await withEnv(
-    {
-      PLAY_YTDLP_COOKIES_PATH: '/tmp/cookies-inexistente.txt',
-      PLAY_YTDLP_COOKIES_FROM_BROWSER: '',
-    },
-    async () => {
-      const message = __playYtDlpClientTestUtils.buildYouTubeBotCheckUserMessage();
-      assert.match(message, /PLAY_YTDLP_COOKIES_PATH/);
-    },
+  assert.equal(
+    __playMediaClientTestUtils.isYtmp3PrimaryEligible({
+      type: 'audio',
+      link: 'https://vimeo.com/1234',
+    }),
+    false,
   );
+});
 
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'play-cookies-'));
-  const cookiesPath = path.join(tempDir, 'cookies.txt');
-  fs.writeFileSync(cookiesPath, '.youtube.com\tTRUE\t/\tFALSE\t2147483647\tSID\ttest-cookie\n', 'utf8');
+test('anti-bot: detecta causa e retorna mensagem genérica do provedor', { concurrency: false }, async () => {
+  assert.equal(
+    __playMediaClientTestUtils.isYouTubeBotCheckCause({
+      meta: { cause: 'ERROR: [youtube] Sign in to confirm you’re not a bot.' },
+    }),
+    true,
+  );
 
-  try {
-    await withEnv(
-      {
-        PLAY_YTDLP_COOKIES_PATH: cookiesPath,
-        PLAY_YTDLP_COOKIES_FROM_BROWSER: '',
-      },
-      async () => {
-        const message = __playYtDlpClientTestUtils.buildYouTubeBotCheckUserMessage();
-        assert.match(message, /cookies\.txt/i);
-        assert.ok(!message.includes('PLAY_YTDLP_COOKIES_PATH'));
-      },
-    );
-  } finally {
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  }
+  const message = __playMediaClientTestUtils.buildYouTubeBotCheckUserMessage();
+  assert.match(message, /anti-bot/i);
+  assert.ok(!message.includes('PLAY_'));
+  assert.ok(!message.toLowerCase().includes('cookies_path'));
 });
 
 test('notifyFailure: envia admin só para erro técnico e deduplica alertas', { concurrency: false }, async () => {
@@ -111,6 +94,8 @@ test('notifyFailure: envia admin só para erro técnico e deduplica alertas', {
     },
     async () => {
       const mod = await import(`./playCommandCore.js?test=${__timeNowMs()}-${Math.random().toString(16).slice(2)}`);
+      const { closePool } = await import('../../../database/index.js');
+      closeDatabasePoolForTests = closePool;
       const utils = mod.__playCommandCoreTestUtils;
       utils.resetAdminAlertDedupCacheForTests();
 

package/app/modules/quoteModule/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/quoteModule/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/quoteModule/commandConfig.json

@@ -357,6 +357,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "citar",
         "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": "Converta texto em uma figurinha no estilo quote para compartilhar citações.",
+        "quando_usar": ["Quando quiser transformar um texto ou mensagem citada em uma figurinha com o estilo 'quote' para compartilhar na conversa.", "Para criar citações rápidas sem digitar outros detalhes, basta digitar o comando com o texto desejado."],
+        "exemplos_reais": [
+          {
+            "situacao": "Criar uma quote simples a partir de um texto próprio.",
+            "comando": "<prefix>citar seu texto",
+            "resposta_esperada": "Figura citada criada com sucesso.",
+            "variacao": "Aparece a figurinha com o seu texto formatado como quote."
+          },
+          {
+            "situacao": "Citar uma frase de outro usuário mencionando-o.",
+            "comando": "<prefix>qc @usuário a frase citada",
+            "resposta_esperada": "Figura citada criada com sucesso.",
+            "variacao": "A citação é gerada a partir da mensagem citada."
+          },
+          {
+            "situacao": "Erro de formato ao não informar o texto.",
+            "comando": "<prefix>citar",
+            "resposta_esperada": "Formato de uso inválido. Consulte metodos_de_uso.",
+            "variacao": "O sistema pede para incluir o texto após o comando."
+          }
+        ],
+        "resposta_esperada": ["Figura citada criada com sucesso.", "Formato de uso inválido. Consulte metodos_de_uso.", "Permissão insuficiente para executar este comando."],
+        "erros_comuns_usuario": ["Esquecer de informar o texto após o comando <prefix>citar.", "Usar o comando <prefix>qc sem a estrutura correta (falta @usuario ou texto).", "Texto muito longo ou com caracteres não suportados pela figurinha.", "Não estar logado quando o sistema exigir login Google."],
+        "passos_se_der_erro": ["Verifique se você incluiu o texto após o comando.", "Se usar <prefix>qc, confirme a menção @usuário e o conteúdo a citar.", "Garanta que você está conectado com o Google (login requerido) e tente novamente.", "Se o problema persistir, tente novamente após atualizar a página ou contate o suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/rpgPokemonModule/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/rpgPokemonModule/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/rpgPokemonModule/commandConfig.json

@@ -377,6 +377,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "pokemon",
         "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": "Comando principal do RPG Pokemon, usado para explorar, batalhar, comprar itens e socializar dentro do jogo pelo chat.",
+        "quando_usar": ["Iniciar a aventura: <prefix>pokemon start.", "Explorar o mapa: <prefix>pokemon explorar.", "Batalhar contra inimigos: <prefix>pokemon atacar <id>.", "Obter ajuda ou ver os métodos de uso: <prefix>pokemon help."],
+        "exemplos_reais": [
+          {
+            "situacao": "Novo jogador quer começar a aventura.",
+            "comando": "<prefix>pokemon start",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "Prefixo pode variar (ex.: ! ou /)."
+          },
+          {
+            "situacao": "Explorar o mapa atual.",
+            "comando": "<prefix>pokemon explorar",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "Se houver área bloqueada, o jogo mostrará informações da área atual."
+          },
+          {
+            "situacao": "Iniciar batalha contra o oponente 1.",
+            "comando": "<prefix>pokemon atacar 1",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "O número pode variar conforme os oponentes disponíveis."
+          }
+        ],
+        "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": ["Esquecer de informar o subcomando obrigatório (ação).", "Usar um subcomando que não existe ou está incorreto.", "Não estar logado com Google antes de usar o comando.", "Formato incorreto ao enviar parâmetros (ex.: <prefix>pokemon atacar sem o id).", "Tentar usar comandos antes de iniciar o jogo com <prefix>pokemon start."],
+        "passos_se_der_erro": ["Leia a mensagem de erro e verifique se o uso está correto consultando <prefix>pokemon help.", "Confira se o subcomando digitado é válido e se o <prefix> está correto.", "Tente novamente com o formato correto, por exemplo <prefix>pokemon start.", "Certifique-se de estar logado com Google, já que é exigido.", "Se o problema continuar, reporte o contexto do erro para o suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/statsModule/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/statsModule/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/statsModule/commandConfig.json

@@ -335,6 +335,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "classificacao",
         "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": "Mostra os 5 membros mais ativos do grupo. Não requer Premium.",
+        "quando_usar": ["Quando quiser ver quem participa mais no grupo.", "Antes de uma discussão ou decisão, para identificar os participantes mais ativos.", "Para comparar participação entre diferentes períodos."],
+        "exemplos_reais": [
+          {
+            "situacao": "Quero ver quem são os 5 membros mais ativos no grupo agora.",
+            "comando": "<prefix>classificacao",
+            "resposta_esperada": "Top 5 ativos no grupo: 1) @usuario1, 2) @usuario2, 3) @usuario3, 4) @usuario4, 5) @usuario5.",
+            "variacao": "<prefix>rank."
+          },
+          {
+            "situacao": "Quero o mesmo resultado usando outro atalho.",
+            "comando": "<prefix>rank",
+            "resposta_esperada": "Top 5 ativos no grupo: 1) @usuario1, 2) @usuario2, 3) @usuario3, 4) @usuario4, 5) @usuario5.",
+            "variacao": "<prefix>classificacao."
+          },
+          {
+            "situacao": "Outra forma rápida de ver o top 5.",
+            "comando": "<prefix>top5",
+            "resposta_esperada": "Top 5 ativos no grupo: 1) @usuario1, 2) @usuario2, 3) @usuario3, 4) @usuario4, 5) @usuario5.",
+            "variacao": "<prefix>classificacao."
+          }
+        ],
+        "resposta_esperada": ["A lista com os 5 membros mais ativos no grupo é exibida."],
+        "erros_comuns_usuario": ["Não está em um grupo ao enviar o comando.", "Ainda não fez login com Google no app.", "Formato do comando incorreto; use um dos métodos de uso: <prefix>classificacao, <prefix>rank, <prefix>top5.", "O grupo não possui participantes ativos suficientes."],
+        "passos_se_der_erro": ["Confira se você está dentro de um grupo.", "Verifique se você está logado com Google.", "Envie o comando correto: <prefix>classificacao, <prefix>rank ou <prefix>top5.", "Tente novamente em poucos segundos.", "Se o erro persistir, peça para o admin revisar as permissões."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -531,6 +560,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "classificacaoglobal",
         "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": "Mostra o top 5 global de atividade. Use para ver quem lidera a atividade mundial e comparar com seu desempenho.",
+        "quando_usar": ["Quero saber quem está no topo da atividade global agora.", "Quero comparar meu desempenho com o ranking global.", "Preciso de uma visão rápida do ranking mundial sem dados locais."],
+        "exemplos_reais": [
+          {
+            "situacao": "Quero ver o ranking global rapidamente.",
+            "comando": "<prefix>classificacaoglobal",
+            "resposta_esperada": "Top 5 global de atividade exibidos com nomes e pontos. Ex.: 1) Nome - 980 pts, 2) Nome2 - 950 pts, ...",
+            "variacao": "<prefix>globalrank."
+          },
+          {
+            "situacao": "Quero usar a outra forma de comando para o ranking.",
+            "comando": "<prefix>globalrank",
+            "resposta_esperada": "Top 5 global de atividade exibidos com nomes e pontos.",
+            "variacao": "<prefix>classificacaoglobal."
+          },
+          {
+            "situacao": "Não estou logado com Google e tento ver o ranking.",
+            "comando": "<prefix>classificacaoglobal",
+            "resposta_esperada": "Você precisa estar logado com sua conta Google para ver o ranking global.",
+            "variacao": "Sem login Google."
+          }
+        ],
+        "resposta_esperada": ["Top 5 global de atividade exibidos com nomes e pontos.", "Se não houver dados, será exibida mensagem informando a ausência de resultados para o ranking global."],
+        "erros_comuns_usuario": ["Esquecer o prefixo no início do comando.", "Digitar o comando com espaços extras ou caracteres não reconhecidos.", "Tentar usar sem estar logado com Google (googleLogin requerido).", "Usar uma forma de comando incorreta ou digitá-lo com erro de grafia."],
+        "passos_se_der_erro": ["Confira se está logado com a conta Google ligada.", "Digite novamente um dos comandos válidos: <prefix>classificacaoglobal ou <prefix>globalrank.", "Verifique se não há espaço extra ou caracteres estranhos no comando.", "Se o problema persistir, peça ajuda e informe a mensagem de erro e o comando utilizado."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/stickerModule/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/stickerModule/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/stickerModule/commandConfig.json

@@ -357,6 +357,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "figurinha",
         "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": "Converte imagem ou vídeo enviado em figurinha para o WhatsApp. Requer login Google e mídia. Disponível para planos comum e premium.",
+        "quando_usar": ["Quando você quer transformar uma foto ou vídeo enviada em uma figurinha para compartilhar no chat.", "Quando desejar adicionar texto opcional à figurinha com o texto após o comando.", "Quando usar o atalho <prefix>s para criar rapidamente a figurinha a partir da mídia recebida."],
+        "exemplos_reais": [
+          {
+            "situacao": "Transformar imagem recebida em figurinha (sem texto).",
+            "comando": "<prefix>figurinha",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "com imagem anexada."
+          },
+          {
+            "situacao": "Criar figurinha com texto personalizado.",
+            "comando": "<prefix>figurinha Olá amigos",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "texto_extra fornecido."
+          },
+          {
+            "situacao": "Usar atalho para vídeo e gerar figurinha.",
+            "comando": "<prefix>s",
+            "resposta_esperada": "Comando executado com sucesso.",
+            "variacao": "vídeo anexado."
+          }
+        ],
+        "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 há mídia anexada para transformar em figurinha.", "Formato de uso inválido. Use <prefix>figurinha ou <prefix>s.", "Não é possível converter conteúdo NSFW ou não aprovado.", "Você não está logado no Google ou a autenticação falhou."],
+        "passos_se_der_erro": ["Verifique se você enviou uma imagem ou vídeo junto ao comando.", "Tente novamente com <prefix>figurinha ou <prefix>s.", "Certifique-se de estar conectado com sua conta Google e que o login esteja ativo."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -553,6 +582,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "paraimagem",
         "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": "Converte figurinha (sticker) para imagem ou vídeo, para você salvar/usar fora do WhatsApp. Disponível para planos comum e premium.",
+        "quando_usar": ["Quando você recebeu uma figurinha e quer salvá-la como imagem.", "Quando precisa de um vídeo a partir de uma figurinha (quando suportado).", "Quando quer reutilizar a figurinha em outros lugares ou projetos."],
+        "exemplos_reais": [
+          {
+            "situacao": "Você recebeu uma figurinha e quer salvar como imagem.",
+            "comando": "<prefix>paraimagem",
+            "resposta_esperada": "A imagem da figurinha é gerada e enviada de volta para você.",
+            "variacao": "paraimagem."
+          },
+          {
+            "situacao": "Precisa de um vídeo da figurinha (quando suportado).",
+            "comando": "<prefix>tovideo",
+            "resposta_esperada": "Vídeo da figurinha gerado e enviado.",
+            "variacao": "tovideo."
+          },
+          {
+            "situacao": "Erro ao enviar comando com formato errado.",
+            "comando": "<prefix>paraimagem extra",
+            "resposta_esperada": "Formato de uso inválido. Consulte metodos_de_uso.",
+            "variacao": "erro de formatação."
+          }
+        ],
+        "resposta_esperada": ["Imagem ou vídeo gerado a partir da figurinha enviada (quando disponível).", "Mensagens claras de erro se houver problemas de formato, permissão ou conteúdo."],
+        "erros_comuns_usuario": ["Formato de comando inválido ou sem figurinha na mensagem.", "Não há figurinha na mensagem para converter.", "Falha de login ou permissão inadequada (Google Login necessário).", "Tentativa de usar o comando sem indicar uma figurinha compatível."],
+        "passos_se_der_erro": ["Confirme que você está logado com Google.", "Envie uma figurinha válida e tente novamente com <prefix>paraimagem, <prefix>tovideo ou <prefix>tovid.", "Verifique se o prefixo do bot está correto.", "Se o problema persistir, peça suporte com print da tela e da mensagem recebida."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -771,6 +829,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "figurinhatexto",
         "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": "Gera figurinha com texto em tema escuro. Digite o texto (até 80 caracteres, até 4 linhas) e a figurinha é criada.",
+        "quando_usar": ["Quando quiser transformar uma frase curta em uma figurinha para compartilhar no chat.", "Para destacar mensagens com estilo visual sem sair do chat."],
+        "exemplos_reais": [
+          {
+            "situacao": "Criar uma figurinha com uma frase curta para cumprimentar.",
+            "comando": "<prefix>figurinhatexto Olá, tudo bem?",
+            "resposta_esperada": "Figura gerada com o texto: 'Olá, tudo bem?'.",
+            "variacao": "<prefix>st Olá, tudo bem?"
+          },
+          {
+            "situacao": "Texto com várias linhas (até 4 linhas).",
+            "comando": "<prefix>figurinhatexto Linha 1\\nLinha 2\\nLinha 3\\nLinha 4",
+            "resposta_esperada": "Figura criada com o texto: 'Linha 1\\nLinha 2\\nLinha 3\\nLinha 4'.",
+            "variacao": "<prefix>st Linha 1\\nLinha 2\\nLinha 3\\nLinha 4."
+          },
+          {
+            "situacao": "Uso rápido com alias.",
+            "comando": "<prefix>st Bom dia a todos",
+            "resposta_esperada": "Figura gerada com o texto: 'Bom dia a todos'.",
+            "variacao": "<prefix>figurinhatexto Bom dia a todos."
+          }
+        ],
+        "resposta_esperada": ["Figura criada com sucesso e pronta para enviar no chat.", "Texto da figurinha incorporado ao sticker.", "Comando executado com sucesso."],
+        "erros_comuns_usuario": ["Texto com mais de 80 caracteres.", "Não informar o texto após <prefix>figurinhatexto ou <prefix>st.", "Formato de uso inválido (faltou o texto ou usou caractere não suportado).", "Usar mais de 4 linhas."],
+        "passos_se_der_erro": ["Verifique o texto informado: até 80 caracteres e até 4 linhas.", "Repita o comando correto, por exemplo: <prefix>figurinhatexto Seu texto aqui.", "Certifique-se de estar conectado com a conta Google, se necessário.", "Se o problema persistir, aguarde alguns minutos e tente novamente ou procure suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -989,6 +1076,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "figurinhatextobranco",
         "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": "Crie figurinha com texto em branco em tema claro usando <prefix>figurinhatextobranco ou <prefix>stw.",
+        "quando_usar": ["Quer compartilhar uma mensagem rápida como imagem no chat.", "Precisa de até 80 caracteres, em até 4 linhas.", "Não precisa de opções adicionais ou ajustes de estilo.", "Prefere um atalho curto com <prefix>stw."],
+        "exemplos_reais": [
+          {
+            "situacao": "Frase motivacional.",
+            "comando": "<prefix>figurinhatextobranco Acredite em si mesmo!",
+            "resposta_esperada": "Figurinha criada com o texto 'Acredite em si mesmo!' em tema claro.",
+            "variacao": "<prefix>stw Acredite em si mesmo!"
+          },
+          {
+            "situacao": "Bom dia.",
+            "comando": "<prefix>figurinhatextobranco Bom dia, equipe!",
+            "resposta_esperada": "Figurinha criada com o texto 'Bom dia, equipe!' em tema claro.",
+            "variacao": "<prefix>stw Bom dia, equipe!"
+          },
+          {
+            "situacao": "Quatro linhas.",
+            "comando": "<prefix>figurinhatextobranco Linha 1 Linha 2 Linha 3 Linha 4",
+            "resposta_esperada": "Figurinha criada com o texto em quatro linhas.",
+            "variacao": "<prefix>stw Linha 1 Linha 2 Linha 3 Linha 4."
+          }
+        ],
+        "resposta_esperada": ["Comando executado com sucesso."],
+        "erros_comuns_usuario": ["Texto não informado após o comando.", "Texto excede 80 caracteres ou ultrapassa 4 linhas.", "Formato de uso incorreto ou sem o prefixo correto.", "Tentar usar caracteres não suportados."],
+        "passos_se_der_erro": ["Certifique-se de incluir o texto após o comando, ex.: <prefix>figurinhatextobranco Seu texto.", "Verifique o tamanho: até 80 caracteres e até 4 linhas.", "Use o formato correto: <prefix>figurinhatextobranco ou <prefix>stw.", "Tente novamente. Se o erro persistir, copie o comando usado e peça ajuda."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     },
     {
@@ -1207,6 +1323,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "figurinhatextopisca",
         "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": "Gera figurinha animada de texto piscante com até 80 caracteres (máx. 4 linhas), usando <prefix>figurinhatextopisca ou <prefix>stb.",
+        "quando_usar": ["Destacar mensagens com texto piscante em chats", "Promover ofertas rápidas ou lembretes", "Saudar ou chamar atenção com uma frase curta", "Transformar seu texto pronto em figurinha para envio rápido"],
+        "exemplos_reais": [
+          {
+            "situacao": "Promoção rápida com destaque.",
+            "comando": "<prefix>figurinhatextopisca Promoção de 50% hoje!",
+            "resposta_esperada": "Figura criada com sucesso.",
+            "variacao": "<prefix>stb Promoção de 50% hoje!"
+          },
+          {
+            "situacao": "Saudação breve.",
+            "comando": "<prefix>figurinhatextopisca Olá, bom dia!",
+            "resposta_esperada": "Figura criada com sucesso.",
+            "variacao": "<prefix>stb Olá, bom dia!"
+          },
+          {
+            "situacao": "Lembrete com até 4 linhas.",
+            "comando": "<prefix>figurinhatextopisca Lembrete: entrega hoje Confira novidades",
+            "resposta_esperada": "Figura criada com sucesso.",
+            "variacao": "<prefix>stb Lembrete: entrega hoje Confira novidades."
+          }
+        ],
+        "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": ["Texto excede 80 caracteres", "Mais de 4 linhas", "Não usar nenhum <prefix> no comando", "Texto vazio", "Texto com caracteres especiais não suportados"],
+        "passos_se_der_erro": ["Verifique o tamanho do texto (≤ 80 caracteres) e o número de linhas (≤ 4).", "Tente novamente usando um dos comandos válidos com o mesmo texto.", "Confirme que você está logado via Google, conforme necessário.", "Se o erro continuar, tente novamente mais tarde ou procure suporte."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/stickerPackModule/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/stickerPackModule/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/stickerPackModule/autoPackCollectorService.js

@@ -5,7 +5,11 @@ import { sanitizeText } from './stickerPackUtils.js';
  * Serviço responsável por direcionar figurinhas recém-criadas para packs automáticos.
  */
 const DEFAULT_AUTO_PACK_NAME = process.env.STICKER_PACK_AUTO_PACK_NAME || 'pack';
-const AUTO_PACK_TARGET_VISIBILITY = 'unlisted';
+const VALID_VISIBILITIES = new Set(['public', 'unlisted', 'private']);
+const AUTO_PACK_TARGET_VISIBILITY_RAW = String(process.env.STICKER_PACK_AUTO_COLLECT_VISIBILITY || process.env.STICKER_AUTO_PACK_BY_TAGS_VISIBILITY || 'public')
+  .trim()
+  .toLowerCase();
+const AUTO_PACK_TARGET_VISIBILITY = VALID_VISIBILITIES.has(AUTO_PACK_TARGET_VISIBILITY_RAW) ? AUTO_PACK_TARGET_VISIBILITY_RAW : 'public';
 const AUTO_COLLECT_ENABLED = process.env.STICKER_PACK_AUTO_COLLECT_ENABLED !== 'false';
 const AUTO_PACK_NAME_MAX_LENGTH = 120;
 const AUTO_PACK_DESCRIPTION_MARKER = '[auto-pack:collector]';

package/app/modules/stickerPackModule/commandConfig.json

@@ -378,6 +378,35 @@
         "schema": "legacy_v1_and_v2",
         "legacy_name": "pacote",
         "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": "Gerencie packs de figurinhas: criar, listar, adicionar figurinhas e enviar packs para contatos.",
+        "quando_usar": ["Criar um novo pack de figurinhas.", "Ver a lista de packs existentes.", "Adicionar figurinhas a um pack existente.", "Enviar um pack para alguém."],
+        "exemplos_reais": [
+          {
+            "situacao": "Criar um pack de figurinhas.",
+            "comando": "<prefix>pacote create meupack",
+            "resposta_esperada": "Pack criado com sucesso.",
+            "variacao": "Use nomes simples, sem aspas. Ex.: meupack."
+          },
+          {
+            "situacao": "Listar todos os packs.",
+            "comando": "<prefix>pacote list",
+            "resposta_esperada": "Listagem exibida com todos os packs.",
+            "variacao": "Pode retornar vários nomes; observe a lista completa."
+          },
+          {
+            "situacao": "Adicionar figurinhas a um pack existente.",
+            "comando": "<prefix>pacote add meupack",
+            "resposta_esperada": "Figurinhas adicionadas ao pack 'meupack'.",
+            "variacao": "Se houver figurinhas disponíveis, elas são incluídas."
+          }
+        ],
+        "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": ["Esquecer de usar o prefixo correto no início do comando.", "Digitar o subcomando errado ou sem o parâmetro necessário.", "Tentar adicionar figurinhas sem indicar o pack ou sem estar logado.", "Tentar enviar sem ter criado ou sem selecionar um pack existente.", "Não estar logado com Google quando o comando exigir login."],
+        "passos_se_der_erro": ["Use <prefix>pacote help para confirmar a sintaxe correta.", "Verifique se o subcomando está entre create, list, add ou send e inclua os parâmetros necessários.", "Confirme que você está logado com Google, conforme exigido.", "Tente novamente após ajustar o comando. Se o erro persistir, copie a mensagem de erro e tente novamente mais tarde.", "Se não resolver, aguarde alguns minutos e procure ajuda com os detalhes do comando executado."],
+        "resumo_usuario_origem": "auto_ia_assistida",
+        "resumo_usuario_revisao_pendente": true
       }
     }
   ],

package/app/modules/stickerPackModule/stickerAutoPackByTagsRuntime.js

@@ -166,7 +166,7 @@ const EFFECTIVE_COMPLETION_TRANSFER_ENABLED = COMPLETION_TRANSFER_ENABLED || IS_
 const EFFECTIVE_MIGRATION_CANDIDATE_LIMIT = IS_AGGRESSIVE_PROFILE ? Math.max(MIGRATION_CANDIDATE_LIMIT, 24) : MIGRATION_CANDIDATE_LIMIT;
 const EFFECTIVE_TRANSFER_CANDIDATE_SIMILARITY_FLOOR = IS_AGGRESSIVE_PROFILE ? Math.max(0.15, TRANSFER_CANDIDATE_SIMILARITY_FLOOR * 0.72) : TRANSFER_CANDIDATE_SIMILARITY_FLOOR;
 
-const EXPLICIT_OWNER = String(process.env.STICKER_AUTO_PACK_OWNER_JID || process.env.USER_ADMIN || '').trim();
+const EXPLICIT_OWNER = String(process.env.STICKER_AUTO_PACK_OWNER_JID || process.env.WHATSAPP_ADMIN_JID || process.env.USER_ADMIN || '').trim();
 
 const LABEL_TO_TAG = {
   'anime illustration': 'anime',