hobots 1.10.0 → 2.0.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunAttachmentContentType } from './protocol.cjs';
-export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.cjs';
+export { Envelope, EnvelopeItem, ExceptionData, InstanceInfo, 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). */
 type AttachInput = Uint8Array | ArrayBuffer | string;
@@ -50,6 +50,8 @@ interface Logger {
 declare class Client {
     #private;
     readonly logger: Logger;
+    /** Eco de lifecycle (Transaction.emit) e afins só imprimem no terminal com debug ligado. */
+    readonly debug: boolean;
     private readonly transport;
     constructor(options: InitOptions, config?: ResolvedConfig);
     get options(): InitOptions;
@@ -110,9 +112,10 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     runId?: string | undefined);
     /**
-     * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
-     * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
-     * assim que os eventos de performance também aparecem nos logs da run no app.
+     * Registra o início/fim de uma step ou transaction: espelha a linha no sink de
+     * lifecycle, se conectado (é assim que os eventos de performance aparecem nos
+     * logs da run no app), e ecoa no terminal apenas com `debug: true` — o SDK não
+     * escreve no stdout do processo do usuário sem permissão.
      */
     emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Breadcrumb, EventUser, Severity, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunAttachmentContentType } from './protocol.js';
-export { AgentInfo, Envelope, EnvelopeItem, ExceptionData, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.js';
+export { Envelope, EnvelopeItem, ExceptionData, InstanceInfo, 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). */
 type AttachInput = Uint8Array | ArrayBuffer | string;
@@ -50,6 +50,8 @@ interface Logger {
 declare class Client {
     #private;
     readonly logger: Logger;
+    /** Eco de lifecycle (Transaction.emit) e afins só imprimem no terminal com debug ligado. */
+    readonly debug: boolean;
     private readonly transport;
     constructor(options: InitOptions, config?: ResolvedConfig);
     get options(): InitOptions;
@@ -110,9 +112,10 @@ declare class Transaction {
     /** Correlaciona a uma execução de task — preenchido automaticamente em ctx.tx */
     runId?: string | undefined);
     /**
-     * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
-     * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
-     * assim que os eventos de performance também aparecem nos logs da run no app.
+     * Registra o início/fim de uma step ou transaction: espelha a linha no sink de
+     * lifecycle, se conectado (é assim que os eventos de performance aparecem nos
+     * logs da run no app), e ecoa no terminal apenas com `debug: true` — o SDK não
+     * escreve no stdout do processo do usuário sem permissão.
      */
     emit(kind: 'transaction' | 'step', phase: 'start' | 'finish', label: string, startTs?: string, endTs?: string, status?: StepStatus | string): void;
     /** Conecta o espelho de lifecycle (RunReporter) e faz replay do backlog em ordem. */

package/dist/index.js

@@ -103,7 +103,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "1.10.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "2.0.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -296,7 +296,8 @@ var Transport = class {
       return;
     }
     if (this.buffer.length >= this.maxQueueSize) {
-      this.buffer.shift();
+      const dropIndex = this.buffer.findIndex((queued) => queued.type !== "heartbeat");
+      this.buffer.splice(dropIndex === -1 ? 0 : dropIndex, 1);
       this.logger.warn("fila cheia, item mais antigo descartado");
     }
     this.buffer.push(item);
@@ -387,6 +388,8 @@ function runtimeContexts() {
 }
 var Client = class {
   logger;
+  /** Eco de lifecycle (Transaction.emit) e afins só imprimem no terminal com debug ligado. */
+  debug;
   // campos privados + getters de protótipo: o clientSecret não aparece em
   // JSON.stringify/serialização enumerável do Client (ex.: um objeto capturado
   // que referencie o client), mas client.options/config seguem funcionando
@@ -395,7 +398,8 @@ var Client = class {
   transport;
   constructor(options, config = resolveConfig(options)) {
     this.#options = options;
-    this.logger = makeLogger(!!options.debug);
+    this.debug = !!options.debug;
+    this.logger = makeLogger(this.debug);
     this.#config = config;
     this.transport = new Transport({
       endpoint: this.#config.ingestEndpoint,
@@ -482,6 +486,8 @@ var Client = class {
 
 // src/heartbeat.ts
 var DEFAULT_INTERVAL_MS = 3e4;
+var MIN_REPORTED_INTERVAL_MS = 1e3;
+var MAX_REPORTED_INTERVAL_MS = 9e5;
 var Heartbeat = class {
   constructor(client2, options = {}, instanceId) {
     this.client = client2;
@@ -498,12 +504,22 @@ var Heartbeat = class {
   start() {
     if (this.timer) return;
     this.beat();
-    this.timer = setInterval(() => this.beat(), this.intervalMs);
+    this.schedule();
+  }
+  /** Jitter de ±10%: uma frota iniciada junto não sincroniza todos os beats no mesmo segundo. */
+  schedule() {
+    this.timer = setTimeout(
+      () => {
+        this.beat();
+        this.schedule();
+      },
+      this.intervalMs * (0.9 + Math.random() * 0.2)
+    );
     unrefTimer(this.timer);
   }
   stop() {
     if (this.timer) {
-      clearInterval(this.timer);
+      clearTimeout(this.timer);
       this.timer = void 0;
     }
   }
@@ -511,7 +527,7 @@ var Heartbeat = class {
     this.client.sendHeartbeat({
       instance_id: this.instanceId,
       name: this.name,
-      interval_ms: this.intervalMs,
+      interval_ms: Math.min(Math.max(this.intervalMs, MIN_REPORTED_INTERVAL_MS), MAX_REPORTED_INTERVAL_MS),
       timestamp: nowISO(),
       metadata: this.metadata
     });
@@ -758,15 +774,18 @@ var Transaction = class {
   // antes do RunReporter conectar) — replay no setLifecycleSink
   lifecycleBacklog = [];
   /**
-   * Ecoa no terminal o início/fim de uma step ou transaction (sempre, independente de
-   * sampling ou do debug) e espelha a linha no sink de lifecycle, se conectado — é
-   * assim que os eventos de performance também aparecem nos logs da run no app.
+   * Registra o início/fim de uma step ou transaction: espelha a linha no sink de
+   * lifecycle, se conectado (é assim que os eventos de performance aparecem nos
+   * logs da run no app), e ecoa no terminal apenas com `debug: true` — o SDK não
+   * escreve no stdout do processo do usuário sem permissão.
    */
   emit(kind, phase, label, startTs, endTs, status) {
     const durationMs = startTs && endTs ? new Date(endTs).getTime() - new Date(startTs).getTime() : void 0;
-    const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
     const suffix = durationMs != null ? ` (${durationMs}ms)` : "";
-    console.log(`${tag} ${label}${suffix}`);
+    if (this.client?.debug) {
+      const tag = colorize(`[hobots:${kind}] ${phase.toUpperCase()}`, phase === "finish" ? colorForStatus(status ?? "ok") : "cyan");
+      console.log(`${tag} ${label}${suffix}`);
+    }
     const level = phase === "finish" ? levelForStatus(status ?? "ok") : "info";
     const message = `[${kind}] ${phase.toUpperCase()} ${label}${suffix}`;
     if (this.lifecycleSink) this.lifecycleSink(level, message);
@@ -1813,13 +1832,17 @@ var TaskAgent = class {
     try {
       const response = await this.api.poll(
         {
-          agent: {
+          instance: {
             // identidade canônica do agente no painel — o mesmo instanceId do
             // heartbeat da Telemetria, então os dois canais convergem em um agente
             instance_id: this.instanceId,
             version: SDK_VERSION,
             host: hostname(),
-            tasks: [...this.registry.keys()]
+            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.
+            // Clampado à faixa aceita pelo schema do poll (1s..15min).
+            poll_interval_ms: Math.min(Math.max(this.pollIntervalMs, 1e3), 9e5)
           },
           max: Math.min(MAX_CONCURRENCY, this.concurrency - this.activeRuns.size),
           tasks: [...this.registry.keys()]