@areumtecnologia/autonomouscustomerserviceagent 2.0.5 → 2.1.0

package/README.md

@@ -1,6 +1,6 @@
 # Autonomous Customer Service Agent
 
-> **v2.0.5** — Agente autônomo de atendimento ao cliente baseado em IA, desenvolvido com Google Gemini. Suporta múltiplas sessões concorrentes, ferramentas customizadas, retry com backoff exponencial e modos de tratamento de falhas `sync` e `async`.
+> **v2.0.6** — Agente autônomo de atendimento ao cliente baseado em IA, desenvolvido com Google Gemini. Suporta múltiplas sessões concorrentes, ferramentas customizadas, retry com backoff exponencial e modos de tratamento de falhas `sync` e `async`.
 
 ---
 
@@ -142,15 +142,15 @@ Constrói a configuração do agente. **Obrigatório** — o construtor de `Auto
 | `sessionTTL` | `number` | `1800000` | TTL da sessão em ms (padrão: 30 min) |
 | `turnTimeoutMs` | `number` | `90000` | Timeout por turno do loop em ms |
 | `maxVulnerabilityAttempts` | `number` | `3` | Tentativas antes de encerrar a sessão |
-| `temperature` | `number` | `0.1` | Temperatura do modelo (0–1) |
+| `temperature` | `number` | `1` | Temperatura do modelo (0–1) |
 | `topP` | `number` | `0.95` | Probabilidade de núcleo (top-p sampling) |
-| `thinkingLevel` | `string` | `'MINIMAL'` | Nível de raciocínio interno do modelo |
+| `thinkingLevel` | `string` | `'HIGH'` | Nível de raciocínio interno do modelo |
 | `maxOutputTokens` | `number` | `32768` | Tokens máximos na resposta |
 | `failureHandlingMode` | `'sync' \| 'async'` | `'sync'` | Modo de tratamento de falhas |
 | `retryScheduleMinutes` | `number` | `5` | Intervalo entre tentativas agendadas (min) |
 | `retryScheduleAttempts` | `number` | `24` | Máximo de tentativas agendadas |
 | `retryScheduleWindowMs` | `number` | `86400000` | Janela total de retentativas (24h) |
-| `unavailabilityMessage` | `string` | Mensagem padrão em inglês | Mensagem exibida ao usuário em caso de indisponibilidade |
+| `unavailabilityMessage` | `string` | `'We are experiencing a temporary outage. We will contact you as soon as the problem is resolved.'` | Mensagem exibida ao usuário em caso de indisponibilidade |
 | `retryOptions` | `object` | `{ maxAttempts: 3, baseDelayMs: 900, maxDelayMs: 9000 }` | Opções do retry com backoff exponencial |
 
 ---
@@ -186,16 +186,16 @@ console.log(response.sent_at);     // Timestamp no fuso de Brasília
 
 Retorna um snapshot read-only da sessão.
 
-#### `agent.getSessionByLead(leadFilter)` → `SessionSnapshot | null`
+#### `agent.getSessionByUser(filter)` → `SessionSnapshot | null`
 
-Busca uma sessão por nome, telefone ou origem. Aceita string (nome ou telefone) ou objeto de filtro.
+Busca uma sessão por nome, telefone ou origem do usuário. Aceita string (nome ou telefone) ou objeto de filtro.
 
 ```javascript
 // Por telefone (string)
-const s1 = agent.getSessionByLead('5511999999999');
+const s1 = agent.getSessionByUser('5511999999999');
 
 // Por objeto de filtro composto
-const s2 = agent.getSessionByLead({
+const s2 = agent.getSessionByUser({
   name: 'Maria Souza',
   origin: { type: 'instagram' },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@areumtecnologia/autonomouscustomerserviceagent",
-  "version": "2.0.5",
+  "version": "2.1.0",
   "description": "Agente autônomo de atendimento ao cliente baseado em IA com Google Gemini API. Suporta múltiplas sessões, ferramentas customizadas e retry com backoff exponencial.",
   "license": "ISC",
   "author": "Áreum Tecnologia",
@@ -26,7 +26,7 @@
     "start": "node tests/test.js"
   },
   "dependencies": {
-    "@google/genai": "^2.6.0"
+    "@google/genai": "^2.8.0"
   },
   "devDependencies": {
     "dotenv": "^17.4.2"

package/src/AgentConfig.js

@@ -3,7 +3,7 @@
 // AgentConfig — construtor de configuração para o agente, usado internamente para complementar o prompt de sistema
 // ──────────────────────────────────────────────────────────────────────────────
 class AgentConfig {
-    constructor(agentName, agentCompanyName, agentCompanyDetails, missionObjective, missionInstructions, reasoningLanguage = 'en_us') {
+    constructor(agentName, agentCompanyName, agentCompanyDetails, missionObjective, missionInstructions, reasoningLanguage = 'en-US') {
         this.agentName = agentName;
         this.agentCompanyName = agentCompanyName;
         this.agentCompanyDetails = agentCompanyDetails;

package/src/AutonomousCustomerServiceAgent.js

@@ -74,7 +74,7 @@ class AutonomousCustomerServiceAgent extends EventEmitter {
         unavailabilityMessage = 'We are experiencing a temporary outage. We will contact you as soon as the problem is resolved.',
         maxVulnerabilityAttempts = 3,
         temperature = 1,
-        topP = 0.75,
+        topP = 0.95,
         thinkingLevel = "HIGH",
         maxOutputTokens = 32_768,
     } = {}) {
@@ -155,36 +155,36 @@ class AutonomousCustomerServiceAgent extends EventEmitter {
 
     /**
      * Retorna a primeira sessão encontrada para as informações do user.
-     * @param {object|string} leadFilter  Objeto com { name?, phone?, origin? } ou uma string de telefone/nome
+     * @param {object|string} filter  Objeto com { name?, phone?, origin? } ou uma string de telefone/nome
      * @returns {object|null}
      */
-    getSessionByLead(leadFilter) {
+    getSessionByUser(filter) {
         const session = Array.from(this.#sessions.values()).find((session) => {
-            if (typeof leadFilter === 'string') {
-                const normalizedFilter = String(leadFilter).trim().toLowerCase();
-                const leadName = String(session.user.name || '').trim().toLowerCase();
-                const leadPhone = this.#normalizePhone(String(session.user.phone || ''));
-                return leadName === normalizedFilter || leadPhone === this.#normalizePhone(leadFilter);
+            if (typeof filter === 'string') {
+                const normalizedFilter = String(filter).trim().toLowerCase();
+                const userName = String(session.user.name || '').trim().toLowerCase();
+                const userPhone = this.#normalizePhone(String(session.user.phone || ''));
+                return userName === normalizedFilter || userPhone === this.#normalizePhone(filter);
             }
 
-            if (typeof leadFilter !== 'object' || leadFilter === null) {
+            if (typeof filter !== 'object' || filter === null) {
                 return false;
             }
 
-            if (leadFilter.name) {
-                const normalizedFilter = String(leadFilter.name).trim().toLowerCase();
-                const leadName = String(session.user.name || '').trim().toLowerCase();
-                if (leadName !== normalizedFilter) return false;
+            if (filter.name) {
+                const normalizedFilter = String(filter.name).trim().toLowerCase();
+                const userName = String(session.user.name || '').trim().toLowerCase();
+                if (userName !== normalizedFilter) return false;
             }
 
-            if (leadFilter.phone) {
-                if (this.#normalizePhone(String(session.user.phone || '')) !== this.#normalizePhone(String(leadFilter.phone))) {
+            if (filter.phone) {
+                if (this.#normalizePhone(String(session.user.phone || '')) !== this.#normalizePhone(String(filter.phone))) {
                     return false;
                 }
             }
 
-            if (leadFilter.origin) {
-                const originFilter = leadFilter.origin;
+            if (filter.origin) {
+                const originFilter = filter.origin;
                 const sessionOrigin = session.user.origin || {};
 
                 if (typeof originFilter === 'string') {
@@ -559,11 +559,11 @@ class AutonomousCustomerServiceAgent extends EventEmitter {
     // ── Helpers ───────────────────────────────────────────────────────────────
 
     #emitSemanticEvents(parsed, session) {
-        // Eventos semânticos baseados na resposta do modelo - Atualmente sem uso, mas podem ser enriquecidos com base nas necessidades de negócio (ex: classificação de leads, detecção de intenções, etc)
+        // Eventos semânticos baseados na resposta do modelo - Atualmente sem uso, mas podem ser enriquecidos com base nas necessidades de negócio (ex: classificação de users, detecção de intenções, etc)
     }
 
     /**
-     * Consciência temporal do Lead:
+     * Consciência temporal do User:
      * Insere de forma explícita na mensagem do usuário a data e hora em que foi recebida.
      */
     #buildUserTurn(session, message) {
@@ -781,7 +781,11 @@ class AutonomousCustomerServiceAgent extends EventEmitter {
     - Creator: Áreum Tecnologia (Software and AI Development Team)
 </identity>
 
- ${this.#agent.company.name ? `<work_context>
+<language>
+    - Reasoning: ${this.#agent.reasoningLanguage || 'en-US'}
+</language>
+
+${this.#agent.company.name ? `<work_context>
     - Company: ${this.#agent.company.name}
     - Company Details: ${this.#agent.company.details || 'No additional company details provided.'}
 </work_context>` : ''}