@omnizap-system/omnizap 2.5.12

package/app/modules/tiktokModule/tiktokConfigRuntime.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: 'tiktokModule',
+    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 getTikTokModuleConfig = () => runtime.getModuleConfig();
+
+export const resolveTikTokCommandName = (command) => runtime.resolveCommandName(command);
+export const getTikTokCommandEntry = (command) => runtime.getCommandEntry(command);
+export const listEnabledTikTokCommands = () => runtime.listEnabledCommands();
+
+export const getTikTokTextConfig = () => {
+  const config = getTikTokModuleConfig();
+  const raw = config?.textos && typeof config.textos === 'object' ? config.textos : {};
+  return {
+    ...DEFAULT_TEXTS,
+    ...raw,
+  };
+};
+
+export const getTikTokUsageText = (command, { commandPrefix = '/', header, variant } = {}) => {
+  const entry = getTikTokCommandEntry(command);
+  const methods = resolveUsageLines(entry, variant);
+  if (!methods.length) return '';
+
+  const prefixHeader = typeof header === 'string' ? header : getTikTokTextConfig().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/userModule/AGENT.md

@@ -0,0 +1,200 @@
+# UserModule 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/userModule/commandConfig.json`
+- schema_version: `2.0.0`
+- module_enabled: `true`
+- generated_at: `2026-03-11T02:35:17.177Z`
+
+## Escopo do Modulo
+
+- module: `userModule`
+- source_files:
+- userCommand.js
+- total_commands: `1`
+- total_enabled_commands: `1`
+
+## 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: usuario
+- 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
+
+### perfil
+
+- id: user.perfil
+- aliases: usuario, user
+- enabled: true
+- categoria: usuario
+- descricao: Consulta perfil e estatisticas de um usuario.
+- permissao_necessaria: usuario comum
+- version: 1.0.0
+- stability: stable
+- deprecated: nao
+- risk_level: low
+- local_de_uso:
+- privado
+- grupo
+- metodos_de_uso:
+- <prefix>perfil perfil
+- <prefix>perfil perfil <id|telefone>
+- <prefix>usuario perfil @contato
+- mensagens_uso (variantes):
+- default:
+- Formato de uso:
+- <prefix>perfil perfil <id|telefone>
+- Dica:
+- • Você pode mencionar alguém.
+- • Ou responder a mensagem do usuário desejado.
+- subcomandos:
+- perfil
+- profile
+- argumentos:
+- subcomando | tipo: string | obrigatorio | validacao: perfil|profile | default: null | posicao: 0
+- alvo | tipo: string | opcional | validacao: id, telefone, menção ou reply | default: null | posicao: 1
+- 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=30, janela_ms=60000, escopo=usuario
+- premium: max=120, janela_ms=60000, escopo=usuario
+- informacoes_coletadas:
+- identificador do chat (remoteJid)
+- identificador do remetente (senderJid)
+- texto do comando e argumentos
+- contexto da mensagem (citacao e mencoes, quando existir)
+- alvo do perfil (mencao, resposta, id ou telefone)
+- mapeamento de identidade jid/lid para usuario canonico
+- dados de perfil/atividade/premium/bloqueio no banco e stores
+- dependencias_externas:
+- banco de dados de mensagens/perfil
+- stores internas de premium/blocklist
+- efeitos_colaterais:
+- consulta perfil/estatísticas no banco
+- envia painel de usuário
+- respostas_padrao:
+- success: Comando executado com sucesso.
+- usage_error: Formato de uso inválido. Consulte metodos_de_uso.
+- permission_error: Permissão insuficiente para executar este comando.
+- 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_user
+- tags_log: whatsapp, command, userModule, user
+- nivel_log: info
+- privacidade:
+- dados_sensiveis:
+- sender_identifier
+- retencao: standard_app_logs
+- base_legal: service_execution_and_legitimate_interest
+- docs:
+- summary: Consulta perfil e estatisticas de um usuario.
+- usage_examples: <prefix>perfil perfil, <prefix>perfil perfil <id|telefone>, <prefix>usuario perfil @contato
+- usage_variants.default: Formato de uso:, <prefix>perfil perfil <id|telefone>, , Dica:, • Você pode mencionar alguém., • Ou responder a mensagem do usuário desejado.
+- behavior:
+- type: subcommand
+- allowed_actions: perfil, profile
+- limits:
+- usage_description: consulta por um alvo por comando
+- 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: 30
+- plan_limits.comum.janela_ms: 60000
+- plan_limits.comum.escopo: usuario
+- plan_limits.premium.max: 120
+- plan_limits.premium.janela_ms: 60000
+- plan_limits.premium.escopo: usuario
+- discovery:
+- keywords: perfil, usuario, privado, grupo
+- faq_queries: como usar perfil, o que faz perfil, comando perfil
+- user_phrasings: quero usar perfil, me ajuda com perfil, consulta perfil e estatisticas
+- suggestion_priority: 100
+- handler:
+- file: userCommand.js
+- method: handleUserCommand
+- command_case: perfil

package/app/modules/userModule/commandConfig.json

@@ -0,0 +1,386 @@
+{
+  "schema_version": "2.0.0",
+  "module": "userModule",
+  "enabled": true,
+  "source_files": ["userCommand.js"],
+  "defaults": {
+    "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"
+    },
+    "command": {
+      "enabled": true,
+      "category": "usuario",
+      "version": "1.0.0",
+      "stability": "stable",
+      "deprecated": false,
+      "replaced_by": null,
+      "risk_level": "medium"
+    },
+    "requirements": {
+      "require_group": false,
+      "require_group_admin": false,
+      "require_bot_owner": false,
+      "require_google_login": true,
+      "require_nsfw_enabled": false,
+      "require_media": false,
+      "require_reply_message": false,
+      "legacy": {
+        "requer_grupo": false,
+        "requer_admin": false,
+        "requer_admin_principal": false,
+        "requer_google_login": true,
+        "requer_nsfw": false,
+        "requer_midia": false,
+        "requer_mensagem_respondida": false
+      }
+    },
+    "pre_condicoes": {
+      "requer_grupo": false,
+      "requer_admin": false,
+      "requer_admin_principal": false,
+      "requer_google_login": true,
+      "requer_nsfw": false,
+      "requer_midia": false,
+      "requer_mensagem_respondida": false
+    },
+    "rate_limit": {
+      "max": null,
+      "janela_ms": null,
+      "escopo": "sem_rate_limit_explicito"
+    },
+    "dependencies": ["banco de dados de mensagens/perfil", "stores internas de premium/blocklist"],
+    "dependencias_externas": ["banco de dados de mensagens/perfil", "stores internas de premium/blocklist"],
+    "responses": {
+      "success": "Comando executado com sucesso.",
+      "usage_error": "Formato de uso inválido. Consulte metodos_de_uso.",
+      "permission_error": "Permissão insuficiente para executar este comando."
+    },
+    "respostas_padrao": {
+      "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."
+    },
+    "observability": {
+      "event_name": "command.executed",
+      "log_level": "info",
+      "tags": ["whatsapp", "command", "userModule"]
+    },
+    "privacy": {
+      "data_categories": ["chat_identifier", "sender_identifier", "command_content"],
+      "retention_policy": "standard_app_logs",
+      "legal_basis": "service_execution_and_legitimate_interest"
+    },
+    "access": {
+      "premium_only": false,
+      "allowed_plans": ["comum", "premium"]
+    },
+    "acesso": {
+      "somente_premium": false,
+      "planos_permitidos": ["comum", "premium"]
+    },
+    "plan_limits": {
+      "comum": {
+        "max": 30,
+        "janela_ms": 60000,
+        "escopo": "usuario"
+      },
+      "premium": {
+        "max": 120,
+        "janela_ms": 60000,
+        "escopo": "usuario"
+      }
+    },
+    "limite_uso_por_plano": {
+      "comum": {
+        "max": 30,
+        "janela_ms": 60000,
+        "escopo": "usuario"
+      },
+      "premium": {
+        "max": 120,
+        "janela_ms": 60000,
+        "escopo": "usuario"
+      }
+    },
+    "behavior_templates": {
+      "toggle_on_off_status": {
+        "type": "toggle",
+        "allowed_actions": ["on", "off", "status"],
+        "action_argument": "acao"
+      },
+      "add_remove_list": {
+        "type": "list_management",
+        "allowed_actions": ["add", "remove", "list"],
+        "action_argument": "acao"
+      },
+      "approve_reject": {
+        "type": "moderation_decision",
+        "allowed_actions": ["approve", "reject"],
+        "action_argument": "acao",
+        "requires_targets": true
+      },
+      "set_status_reset": {
+        "type": "configuration_window",
+        "allowed_actions": ["set", "status", "reset"],
+        "action_argument": "valor"
+      }
+    }
+  },
+  "commands": [
+    {
+      "name": "perfil",
+      "aliases": ["usuario", "user"],
+      "descricao": "Consulta perfil e estatisticas de um usuario.",
+      "metodos_de_uso": ["<prefix>perfil perfil", "<prefix>perfil perfil <id|telefone>", "<prefix>usuario perfil @contato"],
+      "permissao_necessaria": "usuario comum",
+      "limite_de_uso": "consulta por um alvo por comando",
+      "local_de_uso": ["privado", "grupo"],
+      "informacoes_coletadas": ["identificador do chat (remoteJid)", "identificador do remetente (senderJid)", "texto do comando e argumentos", "contexto da mensagem (citacao e mencoes, quando existir)", "alvo do perfil (mencao, resposta, id ou telefone)", "mapeamento de identidade jid/lid para usuario canonico", "dados de perfil/atividade/premium/bloqueio no banco e stores"],
+      "enabled": true,
+      "categoria": "usuario",
+      "subcomandos": ["perfil", "profile"],
+      "argumentos": [
+        {
+          "nome": "subcomando",
+          "tipo": "string",
+          "obrigatorio": true,
+          "validacao": "perfil|profile",
+          "default": null
+        },
+        {
+          "nome": "alvo",
+          "tipo": "string",
+          "obrigatorio": false,
+          "validacao": "id, telefone, menção ou reply",
+          "default": null
+        }
+      ],
+      "pre_condicoes": {
+        "requer_grupo": false,
+        "requer_admin": false,
+        "requer_admin_principal": false,
+        "requer_google_login": true,
+        "requer_nsfw": false,
+        "requer_midia": false,
+        "requer_mensagem_respondida": false
+      },
+      "rate_limit": {
+        "max": null,
+        "janela_ms": null,
+        "escopo": "sem_rate_limit_explicito"
+      },
+      "dependencias_externas": ["banco de dados de mensagens/perfil", "stores internas de premium/blocklist"],
+      "efeitos_colaterais": ["consulta perfil/estatísticas no banco", "envia painel de usuário"],
+      "respostas_padrao": {
+        "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."
+      },
+      "observabilidade": {
+        "evento_analytics": "whatsapp_command_user",
+        "tags_log": ["whatsapp", "command", "userModule", "user"],
+        "nivel_log": "info"
+      },
+      "privacidade": {
+        "dados_sensiveis": ["identificador do remetente", "telefone/ID alvo informado ou mencionado", "métricas de atividade e perfil consultadas"],
+        "retencao": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+        "base_legal": "execução do serviço solicitado e legítimo interesse operacional"
+      },
+      "capability_keywords": ["perfil", "usuario", "privado", "grupo"],
+      "faq_patterns": ["como usar perfil", "o que faz perfil", "comando perfil"],
+      "user_phrasings": ["quero usar perfil", "me ajuda com perfil", "consulta perfil e estatisticas"],
+      "suggestion_priority": 100,
+      "acesso": {
+        "somente_premium": false,
+        "planos_permitidos": ["comum", "premium"]
+      },
+      "limite_uso_por_plano": {
+        "comum": {
+          "max": 30,
+          "janela_ms": 60000,
+          "escopo": "usuario"
+        },
+        "premium": {
+          "max": 120,
+          "janela_ms": 60000,
+          "escopo": "usuario"
+        }
+      },
+      "mensagens_uso": {
+        "default": ["Formato de uso:", "<prefix>perfil perfil <id|telefone>", "", "Dica:", "• Você pode mencionar alguém.", "• Ou responder a mensagem do usuário desejado."]
+      },
+      "id": "user.perfil",
+      "description": "Consulta perfil e estatisticas de um usuario.",
+      "usage": ["<prefix>perfil perfil", "<prefix>perfil perfil <id|telefone>", "<prefix>usuario perfil @contato"],
+      "docs": {
+        "summary": "Consulta perfil e estatisticas de um usuario.",
+        "usage_examples": ["<prefix>perfil perfil", "<prefix>perfil perfil <id|telefone>", "<prefix>usuario perfil @contato"],
+        "usage_variants": {
+          "default": ["Formato de uso:", "<prefix>perfil perfil <id|telefone>", "", "Dica:", "• Você pode mencionar alguém.", "• Ou responder a mensagem do usuário desejado."]
+        }
+      },
+      "permission": "usuario comum",
+      "contexts": ["privado", "grupo"],
+      "collected_data": ["identificador do chat (remoteJid)", "identificador do remetente (senderJid)", "texto do comando e argumentos", "contexto da mensagem (citacao e mencoes, quando existir)", "alvo do perfil (mencao, resposta, id ou telefone)", "mapeamento de identidade jid/lid para usuario canonico", "dados de perfil/atividade/premium/bloqueio no banco e stores"],
+      "requirements": {
+        "require_group": false,
+        "require_group_admin": false,
+        "require_bot_owner": false,
+        "require_google_login": true,
+        "require_nsfw_enabled": false,
+        "require_media": false,
+        "require_reply_message": false,
+        "legacy": {
+          "requer_grupo": false,
+          "requer_admin": false,
+          "requer_admin_principal": false,
+          "requer_google_login": true,
+          "requer_nsfw": false,
+          "requer_midia": false,
+          "requer_mensagem_respondida": false
+        }
+      },
+      "arguments": [
+        {
+          "name": "subcomando",
+          "type": "string",
+          "required": true,
+          "default": null,
+          "enum": ["perfil", "profile"],
+          "description": "perfil|profile",
+          "position": 0,
+          "accepts_mentions": false,
+          "accepts_reply_target": true,
+          "greedy": false,
+          "validation": "perfil|profile"
+        },
+        {
+          "name": "alvo",
+          "type": "string",
+          "required": false,
+          "default": null,
+          "enum": null,
+          "description": "id, telefone, menção ou reply",
+          "position": 1,
+          "accepts_mentions": true,
+          "accepts_reply_target": true,
+          "greedy": false,
+          "validation": "id, telefone, menção ou reply"
+        }
+      ],
+      "behavior": {
+        "type": "subcommand",
+        "allowed_actions": ["perfil", "profile"]
+      },
+      "limits": {
+        "usage_description": "consulta por um alvo por comando",
+        "rate_limit": {
+          "max": null,
+          "janela_ms": null,
+          "escopo": "sem_rate_limit_explicito"
+        },
+        "access": {
+          "somente_premium": false,
+          "planos_permitidos": ["comum", "premium"]
+        },
+        "plan_limits": {
+          "comum": {
+            "max": 30,
+            "janela_ms": 60000,
+            "escopo": "usuario"
+          },
+          "premium": {
+            "max": 120,
+            "janela_ms": 60000,
+            "escopo": "usuario"
+          }
+        }
+      },
+      "dependencies": ["banco de dados de mensagens/perfil", "stores internas de premium/blocklist"],
+      "side_effects": ["consulta perfil/estatísticas no banco", "envia painel de usuário"],
+      "observability": {
+        "event_name": "command.executed",
+        "event_key": "user.perfil",
+        "analytics_event": "whatsapp_command_user",
+        "log_level": "info",
+        "tags": ["whatsapp", "command", "userModule", "user"],
+        "legacy": {
+          "evento_analytics": "whatsapp_command_user",
+          "tags_log": ["whatsapp", "command", "userModule", "user"],
+          "nivel_log": "info"
+        }
+      },
+      "privacy": {
+        "data_categories": ["sender_identifier"],
+        "sensitive_fields": ["senderJid"],
+        "retention_policy": "standard_app_logs",
+        "retention_notes": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+        "legal_basis": "service_execution_and_legitimate_interest",
+        "legal_basis_notes": "execução do serviço solicitado e legítimo interesse operacional",
+        "legacy": {
+          "dados_sensiveis": ["identificador do remetente", "telefone/ID alvo informado ou mencionado", "métricas de atividade e perfil consultadas"],
+          "retencao": "conforme políticas de logs, banco de dados e arquivos temporários da aplicação",
+          "base_legal": "execução do serviço solicitado e legítimo interesse operacional"
+        }
+      },
+      "discovery": {
+        "keywords": ["perfil", "usuario", "privado", "grupo"],
+        "faq_queries": ["como usar perfil", "o que faz perfil", "comando perfil"],
+        "user_phrasings": ["quero usar perfil", "me ajuda com perfil", "consulta perfil e estatisticas"],
+        "suggestion_priority": 100
+      },
+      "access": {
+        "premium_only": false,
+        "allowed_plans": ["comum", "premium"],
+        "legacy": {
+          "somente_premium": false,
+          "planos_permitidos": ["comum", "premium"]
+        }
+      },
+      "plan_limits": {
+        "comum": {
+          "max": 30,
+          "janela_ms": 60000,
+          "escopo": "usuario"
+        },
+        "premium": {
+          "max": 120,
+          "janela_ms": 60000,
+          "escopo": "usuario"
+        }
+      },
+      "version": "1.0.0",
+      "stability": "stable",
+      "deprecated": false,
+      "replaced_by": null,
+      "risk_level": "low",
+      "handler": {
+        "file": "userCommand.js",
+        "method": "handleUserCommand",
+        "command_case": "perfil"
+      },
+      "compatibility": {
+        "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"]
+      }
+    }
+  ],
+  "textos": {
+    "usage_header": ""
+  }
+}

package/app/modules/userModule/userAiHelpService.js

@@ -0,0 +1,14 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createModuleAiHelpWrapper } from '../../services/ai/moduleAiHelpWrapperFactory.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export const userAiHelpWrapper = createModuleAiHelpWrapper({
+  moduleKey: 'user',
+  moduleLabel: 'comandos de usuario',
+  envPrefix: 'USER_AI_HELP',
+  moduleDirPath: __dirname,
+  moduleNameFallback: 'userModule',
+});