@omnizap-system/omnizap 2.5.12

package/app/modules/userModule/userConfigRuntime.js

@@ -0,0 +1,68 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { createModuleCommandConfigRuntime } from '../../services/ai/moduleCommandConfigRuntimeService.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const CONFIG_PATH = path.join(__dirname, 'commandConfig.json');
+
+const DEFAULT_TEXTS = {
+  usage_header: '',
+};
+
+const runtime = createModuleCommandConfigRuntime({
+  configPath: CONFIG_PATH,
+  fallbackConfig: {
+    module: 'userModule',
+    commands: [],
+    textos: DEFAULT_TEXTS,
+  },
+});
+
+const renderUsageMethod = (method, commandPrefix) => String(method || '').replaceAll('<prefix>', String(commandPrefix || '/'));
+
+const resolveUsageLines = (entry, variant) => {
+  if (!entry || typeof entry !== 'object') return [];
+
+  const usageMessages = entry?.mensagens_uso && typeof entry.mensagens_uso === 'object' ? entry.mensagens_uso : null;
+
+  if (usageMessages) {
+    const variantKey = typeof variant === 'string' ? variant.trim() : '';
+    const picked = (variantKey && usageMessages[variantKey]) || usageMessages.default || null;
+    if (Array.isArray(picked)) {
+      return picked.filter(Boolean).map((value) => String(value));
+    }
+    if (typeof picked === 'string' && picked.trim()) {
+      return [picked.trim()];
+    }
+  }
+
+  const methods = Array.isArray(entry?.metodos_de_uso) ? entry.metodos_de_uso : [];
+  return methods.filter(Boolean).map((value) => String(value));
+};
+
+export const getUserModuleConfig = () => runtime.getModuleConfig();
+
+export const resolveUserCommandName = (command) => runtime.resolveCommandName(command);
+export const getUserCommandEntry = (command) => runtime.getCommandEntry(command);
+export const listEnabledUserCommands = () => runtime.listEnabledCommands();
+
+export const getUserTextConfig = () => {
+  const config = getUserModuleConfig();
+  const raw = config?.textos && typeof config.textos === 'object' ? config.textos : {};
+  return {
+    ...DEFAULT_TEXTS,
+    ...raw,
+  };
+};
+
+export const getUserUsageText = (command, { commandPrefix = '/', header, variant } = {}) => {
+  const entry = getUserCommandEntry(command);
+  const methods = resolveUsageLines(entry, variant);
+  if (!methods.length) return '';
+
+  const prefixHeader = typeof header === 'string' ? header : getUserTextConfig().usage_header || DEFAULT_TEXTS.usage_header;
+  const lines = methods.map((method) => renderUsageMethod(method, commandPrefix));
+  return prefixHeader ? [prefixHeader, ...lines].join('\n') : lines.join('\n');
+};

package/app/modules/waifuPicsModule/AGENT.md

@@ -0,0 +1,431 @@
+# WaifuPicsModule Agent Guide
+
+Este arquivo e destinado a agentes de IA para gerar respostas no contexto dos comandos deste modulo.
+
+## Fonte de Verdade
+
+- arquivo_base: `app/modules/waifuPicsModule/commandConfig.json`
+- schema_version: `2.0.0`
+- module_enabled: `true`
+- generated_at: `2026-03-11T02:35:17.177Z`
+
+## Escopo do Modulo
+
+- module: `waifuPicsModule`
+- source_files:
+- waifuPicsCommand.js
+- total_commands: `3`
+- total_enabled_commands: `3`
+
+## Defaults Schema v2
+
+- inheritance_mode: deep_merge_with_command_overrides
+- compatibility_mode: legacy_and_v2_fields
+- legacy_field_aliases:
+- descricao: description
+- metodos_de_uso: usage
+- permissao_necessaria: permission
+- local_de_uso: contexts
+- informacoes_coletadas: collected_data
+- pre_condicoes: requirements
+- dependencias_externas: dependencies
+- efeitos_colaterais: side_effects
+- observabilidade: observability
+- privacidade: privacy
+- limite_uso_por_plano: plan_limits
+- argumentos: arguments
+- acesso: access
+- defaults.command:
+- enabled: true
+- category: anime
+- version: 1.0.0
+- stability: stable
+- deprecated: false
+- replaced_by: null
+- risk_level: medium
+- defaults.requirements (legacy view):
+- requer_grupo: nao
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+
+## Protocolo de Resposta para IA
+
+- Passo 1: identificar comando pelo token apos o prefixo.
+- Passo 2: resolver alias para nome canonico usando campo `aliases`.
+- Passo 3: validar `enabled`, `pre_condicoes`, permissao e local de uso.
+- Passo 4: se houver erro de uso, responder com `mensagens_uso` (quando existir) ou `metodos_de_uso`.
+- Passo 5: seguir `respostas_padrao` como fallback de texto.
+- Passo 6: considerar `informacoes_coletadas`, `privacidade` e `observabilidade` ao elaborar resposta.
+
+## Regras de Seguranca para IA
+
+- A IA orienta, mas nao executa acao administrativa automaticamente.
+- Nao inventar comandos, subcomandos ou permissao fora do JSON.
+- Sempre informar onde pode usar (grupo/privado) e quem pode usar.
+- Em duvida de permissao, responder com orientacao conservadora.
+
+## Catalogo de Comandos
+
+### waifu
+
+- id: waifupics.waifu
+- aliases: waifupics, wp
+- enabled: true
+- categoria: anime
+- descricao: Receba uma imagem incrível de anime (SFW)! Escolha uma categoria como 'neko' ou 'waifu'. ✨
+- permissao_necessaria: Livre para todos!
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- Privado
+- Grupos
+- metodos_de_uso:
+- <prefix>waifu <categoria>
+- <prefix>wp neko
+- mensagens_uso (variantes):
+- default:
+- 💡 _Uso:_ <prefix>waifu <categoria>
+  Exemplo: <prefix>waifu neko
+- Dica: Use <prefix>waifuajuda para ver todas as categorias! 🎨
+- subcomandos:
+- (nenhum)
+- argumentos:
+- categoria | tipo: string | obrigatorio | validacao: categoria SFW suportada | default: null | posicao: 0
+- pre_condicoes:
+- requer_grupo: nao
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+- rate_limit:
+- max: null
+- janela_ms: null
+- escopo: sem_rate_limit_explicito
+- acesso:
+- somente_premium: nao
+- planos_permitidos: comum, premium
+- limite_uso_por_plano:
+- comum: max=10, janela_ms=300000, escopo=usuario
+- premium: max=35, janela_ms=300000, escopo=usuario
+- informacoes_coletadas:
+- ID do chat
+- ID do remetente
+- Comando e categoria escolhida
+- dependencias_externas:
+- Waifu.pics API
+- efeitos_colaterais:
+- 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.
+- mensagens_sistema:
+- (nao informado)
+- limites_operacionais:
+- (nao informado)
+- opcoes:
+- toggle_on_off_status.type: toggle
+- toggle_on_off_status.allowed_actions: on, off, status
+- toggle_on_off_status.action_argument: acao
+- add_remove_list.type: list_management
+- add_remove_list.allowed_actions: add, remove, list
+- add_remove_list.action_argument: acao
+- approve_reject.type: moderation_decision
+- approve_reject.allowed_actions: approve, reject
+- approve_reject.action_argument: acao
+- approve_reject.requires_targets: true
+- set_status_reset.type: configuration_window
+- set_status_reset.allowed_actions: set, status, reset
+- set_status_reset.action_argument: valor
+- observabilidade:
+- event_name: command.executed
+- analytics_event: whatsapp_command_wp
+- tags_log: whatsapp, command, waifuPicsModule, wp
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- chat_identifier
+- sender_identifier
+- command_content
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Busca e envia imagens aleatórias de anime (Safe For Work).
+- usage_examples: <prefix>waifu waifu, <prefix>wp neko
+- usage_variants.default: <prefix>waifu <categoria>, <prefix>wp neko
+- behavior:
+- type: argument_driven
+- allowed_actions: (nenhum)
+- limits:
+- usage_description: sem limite especifico
+- rate_limit.max: null
+- rate_limit.janela_ms: null
+- rate_limit.escopo: sem_rate_limit_explicito
+- access.somente_premium: false
+- access.planos_permitidos: comum, premium
+- plan_limits.comum.max: 10
+- plan_limits.comum.janela_ms: 300000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 35
+- plan_limits.premium.janela_ms: 300000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: waifu, waifupics, anime, privado, grupo
+- faq_queries: como usar waifu, o que faz waifu, comando waifu
+- user_phrasings: quero usar waifu, me ajuda com waifu, envia imagem sfw da
+- suggestion_priority: 100
+- handler:
+- file: waifuPicsCommand.js
+- method: handleWaifuPicsCommand
+- command_case: waifu
+
+### waifunsfw
+
+- id: waifupics.waifunsfw
+- aliases: waifupicsnsfw, wpnsfw
+- enabled: true
+- categoria: anime
+- descricao: Mande aquela imagem picante (NSFW). Exige que o grupo autorize! 🔞
+- permissao_necessaria: Membros em grupos com NSFW ativado.
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- Privado
+- Grupos
+- metodos_de_uso:
+- <prefix>waifunsfw <categoria>
+- <prefix>wpnsfw waifu
+- mensagens_uso (variantes):
+- default:
+- 🔞 _Uso:_ <prefix>waifunsfw <categoria>
+  Exemplo: <prefix>wpnsfw blowjob
+- Atenção: O grupo deve estar com NSFW ligado!
+- subcomandos:
+- (nenhum)
+- argumentos:
+- categoria | tipo: string | obrigatorio | validacao: categoria NSFW suportada | default: null | posicao: 0
+- pre_condicoes:
+- requer_grupo: nao
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: sim
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+- rate_limit:
+- max: null
+- janela_ms: null
+- escopo: sem_rate_limit_explicito
+- acesso:
+- somente_premium: sim
+- planos_permitidos: premium
+- limite_uso_por_plano:
+- comum: max=10, janela_ms=300000, escopo=usuario
+- premium: max=35, janela_ms=300000, escopo=usuario
+- informacoes_coletadas:
+- ID do chat
+- ID do remetente
+- Categoria
+- dependencias_externas:
+- Waifu.pics API
+- configuração de NSFW por grupo
+- efeitos_colaterais:
+- 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.
+- mensagens_sistema:
+- (nao informado)
+- limites_operacionais:
+- (nao informado)
+- opcoes:
+- toggle_on_off_status.type: toggle
+- toggle_on_off_status.allowed_actions: on, off, status
+- toggle_on_off_status.action_argument: acao
+- add_remove_list.type: list_management
+- add_remove_list.allowed_actions: add, remove, list
+- add_remove_list.action_argument: acao
+- approve_reject.type: moderation_decision
+- approve_reject.allowed_actions: approve, reject
+- approve_reject.action_argument: acao
+- approve_reject.requires_targets: true
+- set_status_reset.type: configuration_window
+- set_status_reset.allowed_actions: set, status, reset
+- set_status_reset.action_argument: valor
+- observabilidade:
+- event_name: command.executed
+- analytics_event: whatsapp_command_wpnsfw
+- tags_log: whatsapp, command, waifuPicsModule, wpnsfw
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- chat_identifier
+- sender_identifier
+- command_content
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Envia imagens de anime para maiores (Not Safe For Work) se permitido.
+- usage_examples: <prefix>waifunsfw waifu, <prefix>wpnsfw neko
+- usage_variants.default: <prefix>waifunsfw <categoria>, <prefix>wpnsfw waifu
+- behavior:
+- type: argument_driven
+- allowed_actions: (nenhum)
+- limits:
+- usage_description: depende de configuracao global e do grupo
+- rate_limit.max: null
+- rate_limit.janela_ms: null
+- rate_limit.escopo: sem_rate_limit_explicito
+- access.somente_premium: true
+- access.planos_permitidos: premium
+- plan_limits.comum.max: 10
+- plan_limits.comum.janela_ms: 300000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 35
+- plan_limits.premium.janela_ms: 300000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: waifunsfw, waifupicsnsfw, anime, privado, grupo
+- faq_queries: como usar waifunsfw, o que faz waifunsfw, comando waifunsfw
+- user_phrasings: quero usar waifunsfw, me ajuda com waifunsfw, envia imagem nsfw da
+- suggestion_priority: 100
+- handler:
+- file: waifuPicsCommand.js
+- method: handleWaifuPicsCommand
+- command_case: waifunsfw
+
+### waifuajuda
+
+- id: waifupics.waifuajuda
+- aliases: wppicshelp
+- enabled: true
+- categoria: anime
+- descricao: Veja todas as categorias de fotos anime que eu posso te enviar! 📖
+- permissao_necessaria: Livre para todos!
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- Privado
+- Grupos
+- metodos_de_uso:
+- <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!
+- subcomandos:
+- (nenhum)
+- argumentos:
+- (nenhum)
+- pre_condicoes:
+- requer_grupo: nao
+- requer_admin: nao
+- requer_admin_principal: nao
+- requer_google_login: sim
+- requer_nsfw: nao
+- requer_midia: nao
+- requer_mensagem_respondida: nao
+- rate_limit:
+- max: null
+- janela_ms: null
+- escopo: sem_rate_limit_explicito
+- acesso:
+- somente_premium: nao
+- planos_permitidos: comum, premium
+- limite_uso_por_plano:
+- comum: max=10, janela_ms=300000, escopo=usuario
+- premium: max=35, janela_ms=300000, escopo=usuario
+- informacoes_coletadas:
+- ID do chat
+- ID do remetente
+- dependencias_externas:
+- Waifu.pics API
+- 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.
+- mensagens_sistema:
+- (nao informado)
+- limites_operacionais:
+- (nao informado)
+- opcoes:
+- toggle_on_off_status.type: toggle
+- toggle_on_off_status.allowed_actions: on, off, status
+- toggle_on_off_status.action_argument: acao
+- add_remove_list.type: list_management
+- add_remove_list.allowed_actions: add, remove, list
+- add_remove_list.action_argument: acao
+- approve_reject.type: moderation_decision
+- approve_reject.allowed_actions: approve, reject
+- approve_reject.action_argument: acao
+- approve_reject.requires_targets: true
+- set_status_reset.type: configuration_window
+- set_status_reset.allowed_actions: set, status, reset
+- set_status_reset.action_argument: valor
+- observabilidade:
+- event_name: command.executed
+- analytics_event: whatsapp_command_wppicshelp
+- tags_log: whatsapp, command, waifuPicsModule, wppicshelp
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- chat_identifier
+- sender_identifier
+- command_content
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Exibe o menu de ajuda detalhado do módulo Waifu.pics com todas as categorias.
+- usage_examples: <prefix>waifuajuda
+- usage_variants.default: <prefix>waifuajuda
+- behavior:
+- type: simple_action
+- allowed_actions: (nenhum)
+- limits:
+- usage_description: sem limite especifico
+- rate_limit.max: null
+- rate_limit.janela_ms: null
+- rate_limit.escopo: sem_rate_limit_explicito
+- access.somente_premium: false
+- access.planos_permitidos: comum, premium
+- plan_limits.comum.max: 10
+- plan_limits.comum.janela_ms: 300000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 35
+- plan_limits.premium.janela_ms: 300000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: waifuajuda, anime, privado, grupo
+- faq_queries: como usar waifuajuda, o que faz waifuajuda, comando waifuajuda
+- user_phrasings: quero usar waifuajuda, me ajuda com waifuajuda, mostra ajuda e categorias
+- suggestion_priority: 100
+- handler:
+- file: waifuPicsCommand.js
+- method: getWaifuPicsUsageText
+- command_case: waifuajuda