hobots 2.3.0 → 2.4.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, EventType, MachineSnapshot, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType } from './protocol.cjs';
+import { Breadcrumb, EventUser, EventType, MachineSnapshot, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType, EnvironmentInput } from './protocol.cjs';
 export { BreadcrumbLevel, Envelope, EnvelopeItem, ExceptionData, InstanceInfo, MachineProcess, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.cjs';
 
 /** Aceita tudo que o handler pode ter em mãos: bytes ou um caminho de arquivo (só Node). */
@@ -95,6 +95,12 @@ declare class Client {
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
     sendHeartbeat(payload: HeartbeatPayload): void;
+    /**
+     * Ambiente do item: o dele, senão o do init(), senão produção. Centralizado
+     * porque evento, transaction e heartbeat precisam responder igual — o servidor
+     * normaliza apelidos legados, então aqui basta repassar.
+     */
+    private resolveEnvironment;
     flush(timeoutMs?: number): Promise<boolean>;
     close(timeoutMs?: number): Promise<boolean>;
 }
@@ -162,7 +168,7 @@ declare class Transaction {
 
 /** Opções de tasks dentro de `init({ tasks: ... })`. Credencial (clientSecret), identidade (instanceId) e debug vêm do init. */
 interface TasksOptions {
-    /** Intervalo entre polls sem trabalho. Default: 5_000 (mínimo 1_000) */
+    /** Intervalo entre polls sem trabalho. Default: 2_000 (mínimo 1_000) */
     pollIntervalMs?: number;
     /** Runs simultâneas (1..5). Default: 1 (sequencial) */
     concurrency?: number;
@@ -285,8 +291,16 @@ interface HeartbeatOptions {
 interface InitOptions {
     /** O Client Secret do agente (hb_…) — a mesma credencial para telemetria e tasks. Copie em Configurações → Agentes. */
     clientSecret: string;
-    /** Default: 'production' */
-    environment?: string;
+    /**
+       * Ambiente lógico onde este robô roda: 'development', 'testing', 'staging'
+       * (homologação) ou 'production'. Vai em todo evento e transaction E na
+       * identidade da instância — é por ele que as regras de alerta decidem se
+       * notificam. Default: 'production'.
+       *
+       * Um valor livre herdado continua valendo — o servidor normaliza apelidos
+       * como 'prod' e 'qa'.
+       */
+    environment?: EnvironmentInput;
     /** Versão do programa, ex.: 'robo-nfe@1.4.2' */
     release?: string;
     /** Identificador único e estável desta instância — a identidade do agente no painel (heartbeat e poll de tasks convergem nele) */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Breadcrumb, EventUser, EventType, MachineSnapshot, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType } from './protocol.js';
+import { Breadcrumb, EventUser, EventType, MachineSnapshot, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType, EnvironmentInput } from './protocol.js';
 export { BreadcrumbLevel, Envelope, EnvelopeItem, ExceptionData, InstanceInfo, MachineProcess, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.js';
 
 /** Aceita tudo que o handler pode ter em mãos: bytes ou um caminho de arquivo (só Node). */
@@ -95,6 +95,12 @@ declare class Client {
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
     sendHeartbeat(payload: HeartbeatPayload): void;
+    /**
+     * Ambiente do item: o dele, senão o do init(), senão produção. Centralizado
+     * porque evento, transaction e heartbeat precisam responder igual — o servidor
+     * normaliza apelidos legados, então aqui basta repassar.
+     */
+    private resolveEnvironment;
     flush(timeoutMs?: number): Promise<boolean>;
     close(timeoutMs?: number): Promise<boolean>;
 }
@@ -162,7 +168,7 @@ declare class Transaction {
 
 /** Opções de tasks dentro de `init({ tasks: ... })`. Credencial (clientSecret), identidade (instanceId) e debug vêm do init. */
 interface TasksOptions {
-    /** Intervalo entre polls sem trabalho. Default: 5_000 (mínimo 1_000) */
+    /** Intervalo entre polls sem trabalho. Default: 2_000 (mínimo 1_000) */
     pollIntervalMs?: number;
     /** Runs simultâneas (1..5). Default: 1 (sequencial) */
     concurrency?: number;
@@ -285,8 +291,16 @@ interface HeartbeatOptions {
 interface InitOptions {
     /** O Client Secret do agente (hb_…) — a mesma credencial para telemetria e tasks. Copie em Configurações → Agentes. */
     clientSecret: string;
-    /** Default: 'production' */
-    environment?: string;
+    /**
+       * Ambiente lógico onde este robô roda: 'development', 'testing', 'staging'
+       * (homologação) ou 'production'. Vai em todo evento e transaction E na
+       * identidade da instância — é por ele que as regras de alerta decidem se
+       * notificam. Default: 'production'.
+       *
+       * Um valor livre herdado continua valendo — o servidor normaliza apelidos
+       * como 'prod' e 'qa'.
+       */
+    environment?: EnvironmentInput;
     /** Versão do programa, ex.: 'robo-nfe@1.4.2' */
     release?: string;
     /** Identificador único e estável desta instância — a identidade do agente no painel (heartbeat e poll de tasks convergem nele) */

package/dist/index.js

@@ -103,7 +103,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "2.3.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "2.4.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -457,7 +457,7 @@ var Client = class {
       ...event,
       type: hint?.type ?? event.type ?? scope2.type ?? "error",
       release: event.release ?? this.options.release,
-      environment: event.environment ?? this.options.environment ?? "production",
+      environment: this.resolveEnvironment(event.environment),
       tags: Object.keys(tags).length > 0 ? tags : void 0,
       extra: Object.keys(extra).length > 0 ? extra : void 0,
       user: event.user ?? scope2.user,
@@ -472,7 +472,7 @@ var Client = class {
       payload: {
         ...payload,
         release: payload.release ?? this.options.release,
-        environment: payload.environment ?? this.options.environment ?? "production",
+        environment: this.resolveEnvironment(payload.environment),
         tags: { ...this.options.tags, ...payload.tags }
       }
     });
@@ -480,9 +480,22 @@ var Client = class {
   sendHeartbeat(payload) {
     this.transport.enqueue({
       type: "heartbeat",
-      payload: { ...payload, release: payload.release ?? this.options.release }
+      payload: {
+        ...payload,
+        release: payload.release ?? this.options.release,
+        // o ambiente viaja no beat: é assim que a instância se classifica no app
+        environment: this.resolveEnvironment(payload.environment)
+      }
     });
   }
+  /**
+   * Ambiente do item: o dele, senão o do init(), senão produção. Centralizado
+   * porque evento, transaction e heartbeat precisam responder igual — o servidor
+   * normaliza apelidos legados, então aqui basta repassar.
+   */
+  resolveEnvironment(value) {
+    return value ?? this.options.environment ?? "production";
+  }
   flush(timeoutMs) {
     return this.transport.flush(timeoutMs);
   }
@@ -1931,7 +1944,7 @@ function installShutdownHandlers(agent2) {
 }
 
 // src/tasks/agent.ts
-var DEFAULT_POLL_INTERVAL_MS = 5e3;
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
 var MIN_POLL_INTERVAL_MS = 1e3;
 var MAX_CONCURRENCY = 5;
 var POLL_RETRY_DELAYS_MS = [1e3, 4e3, 16e3];
@@ -2062,6 +2075,9 @@ var TaskAgent = class {
             instance_id: this.instanceId,
             version: SDK_VERSION,
             host: hostname(),
+            // ambiente da instância: em agentes poll-only (sem heartbeat) este é o
+            // único canal por onde o servidor descobre onde o robô está rodando
+            environment: this.options.environment,
             tasks: [...this.registry.keys()],
             // o servidor calcula a tolerância de offline (3×) a partir disto em
             // agentes poll-only — sem o campo, um poll lento flaparia offline/online.
@@ -2251,7 +2267,7 @@ function init(options) {
   if (options.tasks) {
     const tasksOptions = options.tasks === true ? {} : options.tasks;
     agent = new TaskAgent(
-      { ...tasksOptions, config, instanceId: options.instanceId, debug: options.debug, client, machineSampler },
+      { ...tasksOptions, config, instanceId: options.instanceId, environment: options.environment, debug: options.debug, client, machineSampler },
       registry
     );
   }