hobots 1.7.0 → 1.7.2

package/README.md

@@ -26,7 +26,7 @@ Também funciona em CommonJS: `const Hobots = require('hobots')`.
 
 ## Um SDK, duas capabilities, um `init()`
 
-O SDK expõe **duas capabilities** autenticadas pelo **mesmo Client Secret do projeto**, configuradas em um único `init()`:
+O SDK expõe **duas capabilities** autenticadas pelo **mesmo Client Secret do agente**, configuradas em um único `init()`:
 
 | Capability | Como habilita | Para quê | Ciclo de vida |
 | --- | --- | --- | --- |
@@ -59,13 +59,13 @@ Hobots.start(); // inicia o polling de tasks (segura o processo vivo)
 
 ## O Client Secret
 
-Cada projeto tem **um único Client Secret** — a mesma credencial autentica a telemetria **e** as tasks:
+Cada agente tem **um único Client Secret** — a mesma credencial autentica a telemetria **e** as tasks:
 
 ```
 hb_<64 hex>
 ```
 
-A credencial é **secreta** e viaja sempre no header `Authorization: Bearer` — nunca na URL. Copie o Client Secret no app, em **Configurações → Projetos** — os snippets de integração já vêm prontos. O SDK fala com a API oficial `https://api2.hobots.app` automaticamente; em desenvolvimento, aponte para outro host com a env `HOBOTS_API_URL` (ex.: `HOBOTS_API_URL=http://localhost:3001`).
+A credencial é **secreta** e viaja sempre no header `Authorization: Bearer` — nunca na URL. Copie o Client Secret no app, em **Configurações → Agentes** — os snippets de integração já vêm prontos. O SDK fala com a API oficial `https://api2.hobots.app` automaticamente; em desenvolvimento, aponte para outro host com a env `HOBOTS_API_URL` (ex.: `HOBOTS_API_URL=http://localhost:3001`).
 
 ---
 
@@ -90,7 +90,7 @@ Hobots.init({
 
 | Opção | Tipo | Default | Descrição |
 | --- | --- | --- | --- |
-| `clientSecret` | `string` | **obrigatório** | o Client Secret do projeto (`hb_<64 hex>`), copiado em **Configurações → Projetos** |
+| `clientSecret` | `string` | **obrigatório** | o Client Secret do agente (`hb_<64 hex>`), copiado em **Configurações → Agentes** |
 | `environment` | `string` | `'production'` | ambiente lógico |
 | `release` | `string` | — | versão do programa, ex. `robo-nfe@1.4.2` |
 | `instanceId` | `string` | **obrigatório** | identidade única da instância — heartbeat e poll de tasks convergem nela |

package/dist/index.cjs

@@ -93,11 +93,11 @@ function validateBaseUrl(raw, prefix) {
 function resolveConfig(options, prefix = "[hobots]") {
   const key = options.clientSecret?.trim();
   if (!key) {
-    throw new Error(`${prefix} clientSecret ausente \u2014 copie o Client Secret do projeto em Configura\xE7\xF5es \u2192 Projetos`);
+    throw new Error(`${prefix} clientSecret ausente \u2014 copie o Client Secret do agente em Configura\xE7\xF5es \u2192 Agentes`);
   }
   if (!SECRET_PATTERN.test(key)) {
     throw new Error(
-      `${prefix} clientSecret com formato inv\xE1lido (${key.length} caracteres) \u2014 esperado "hb_" + 64 hex; copie o Client Secret do projeto em Configura\xE7\xF5es \u2192 Projetos`
+      `${prefix} clientSecret com formato inv\xE1lido (${key.length} caracteres) \u2014 esperado "hb_" + 64 hex; copie o Client Secret do agente em Configura\xE7\xF5es \u2192 Agentes`
     );
   }
   const baseUrl = validateBaseUrl(envBaseUrl() ?? DEFAULT_BASE_URL, prefix);
@@ -163,7 +163,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "2.0.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.7.1" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -1068,6 +1068,15 @@ var RunReporter = class {
     this.clearFlushTimer();
     this.buffer = [];
   }
+  /**
+   * Drena o buffer pendente para o PATCH único do exit path (chame ANTES de kill,
+   * que descarta o buffer). Capado em um chunk — o exit path não tem retry nem fila,
+   * então preserva os logs mais recentes, os mais valiosos na morte do processo.
+   */
+  drainLogs() {
+    this.clearFlushTimer();
+    return this.takeLogs().slice(-MAX_LOGS_PER_PATCH);
+  }
   log(level, message) {
     if (this.dead) return;
     const scrubbed = scrubSecrets(message);
@@ -1160,10 +1169,16 @@ var RunReporter = class {
     return this.chain;
   }
   enqueue(update) {
-    if (this.dead) return;
+    if (this.dead) {
+      this.salvageLogs(update.logs);
+      return;
+    }
     this.pendingUpdates++;
     this.chain = this.chain.then(async () => {
-      if (this.dead) return;
+      if (this.dead) {
+        this.salvageLogs(update.logs);
+        return;
+      }
       const payload = update.logs && update.logs.length === 0 ? { ...update, logs: void 0 } : update;
       try {
         await this.api.updateRun(this.runId, payload);
@@ -1172,16 +1187,35 @@ var RunReporter = class {
           this.dead = true;
           this.stopCancelWatch();
           this.abort();
-          this.buffer = [];
-          this.logger.warn(`run ${this.runId} cancelada/removida no servidor \u2014 reporte suprimido`);
+          const pending = this.buffer.splice(0, this.buffer.length);
+          this.salvageLogs(pending);
+          this.logger.warn(
+            `run ${this.runId} cancelada/finalizada no servidor \u2014 status suprimido` + (pending.length > 0 ? `, ${pending.length} log(s) enviados como log tardio` : "")
+          );
           return;
         }
+        if (update.logs && update.logs.length > 0) {
+          this.buffer.unshift(...update.logs);
+          this.scheduleFlush();
+        }
         this.logger.error(`update da run ${this.runId} perdido:`, error);
       }
     }).finally(() => {
       this.pendingUpdates--;
     });
   }
+  /**
+   * Best-effort de log tardio: envia logs para uma run já terminal, fora da fila.
+   * O servidor anexa os logs mesmo respondendo 409; erros são engolidos — este é
+   * o último recurso, não um canal confiável.
+   */
+  salvageLogs(logs) {
+    if (!logs || logs.length === 0) return;
+    for (let i = 0; i < logs.length; i += MAX_LOGS_PER_PATCH) {
+      void this.api.updateRunOnce(this.runId, { status: "running", logs: logs.slice(i, i + MAX_LOGS_PER_PATCH) }).catch(() => {
+      });
+    }
+  }
 };
 
 // src/tasks/run-context-store.ts
@@ -1337,9 +1371,14 @@ var TaskAgent = class {
     const pending = [];
     for (const reporter of this.reporters) {
       if (reporter.isDead) continue;
+      const logs = reporter.drainLogs();
       reporter.kill();
       pending.push(
-        this.api.updateRunOnce(reporter.context.runId, { status: "failed", error: { type: "AgentTerminated", message } }, timeoutMs).catch(() => {
+        this.api.updateRunOnce(
+          reporter.context.runId,
+          { status: "failed", error: { type: "AgentTerminated", message }, logs: logs.length > 0 ? logs : void 0 },
+          timeoutMs
+        ).catch(() => {
         })
       );
     }
@@ -1395,7 +1434,7 @@ var TaskAgent = class {
     if (error instanceof TasksApiError && error.status === 401) {
       this.consecutiveAuthFailures++;
       if (this.consecutiveAuthFailures === 1 || this.consecutiveAuthFailures % 10 === 0) {
-        this.logger.error("chave rejeitada (401) \u2014 verifique o Client Secret do projeto em Configura\xE7\xF5es \u2192 Projetos");
+        this.logger.error("chave rejeitada (401) \u2014 verifique o Client Secret do agente em Configura\xE7\xF5es \u2192 Agentes");
       }
       return Math.max(this.pollIntervalMs, AUTH_FAILURE_INTERVAL_MS);
     }