hobots 2.0.0 → 2.2.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 { Envelope, EnvelopeItem, ExceptionData, InstanceInfo, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.cjs';
+import { Breadcrumb, EventUser, EventType, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType } from './protocol.cjs';
+export { BreadcrumbLevel, 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;
@@ -25,7 +25,7 @@ declare class Scope {
     user?: EventUser;
     contexts: Record<string, Record<string, unknown>>;
     extra: Record<string, unknown>;
-    level?: Severity;
+    type?: EventType;
     fingerprint?: string[];
     breadcrumbs: Breadcrumb[];
     setTag(key: string, value: string): this;
@@ -34,7 +34,7 @@ declare class Scope {
     setContext(name: string, context: Record<string, unknown> | null): this;
     setExtra(key: string, value: unknown): this;
     setExtras(extras: Record<string, unknown>): this;
-    setLevel(level: Severity): this;
+    setType(type: EventType): this;
     setFingerprint(fingerprint: string[]): this;
     addBreadcrumb(crumb: BreadcrumbInput, maxBreadcrumbs: number): this;
     clearBreadcrumbs(): this;
@@ -59,7 +59,7 @@ declare class Client {
     /** Serialização explícita nunca inclui o secret. */
     toJSON(): Record<string, unknown>;
     captureException(error: unknown, hint: CaptureHint | undefined, scope: Scope): string;
-    captureMessage(message: string, level: Severity, hint: CaptureHint | undefined, scope: Scope): string;
+    captureMessage(message: string, type: EventType, hint: CaptureHint | undefined, scope: Scope): string;
     captureEvent(event: EventPayload, hint: CaptureHint | undefined, scope: Scope): string;
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
@@ -198,6 +198,24 @@ interface RunItems {
     /** Ocorrência de negócio (ex.: "nota nº 10 não encontrada") — não é falha do bot. */
     occurrence(message: string, payload?: Record<string, unknown>, options?: RunItemOptions): void;
 }
+/**
+ * Progresso da execução (itens processados / total) — opcional e independente de
+ * `ctx.items`. Declare o total antes do loop e avance a cada item: a plataforma e o
+ * Studio mostram barra, percentual e tempo restante estimado. Sem `total()` nada é
+ * enviado. Chamadas são síncronas e baratas (≤ 1 PATCH/s, pegando carona nos logs).
+ */
+interface RunProgressReporter {
+    /** Declara (ou ajusta) o total de itens previsto — inteiro >= 1. Idempotente. */
+    total(total: number): void;
+    /** Incrementa os processados (padrão 1). Clampa em `total`. */
+    advance(count?: number): void;
+    /** Define o valor absoluto de processados e, opcionalmente, o total. */
+    set(current: number, total?: number): void;
+    /** Processados até agora (0 antes de qualquer chamada). */
+    readonly current: number;
+    /** `{ current, total }` quando há total declarado; null caso contrário. */
+    readonly snapshot: RunProgress | null;
+}
 interface RunContext {
     runId: string;
     task: string;
@@ -205,6 +223,8 @@ interface RunContext {
     log: RunLogger;
     /** Itens processados/gerados pela execução — a entrega do bot, com status e atributos */
     items: RunItems;
+    /** Progresso declarado (barra + ETA no app) — opcional, independente de `ctx.items` */
+    progress: RunProgressReporter;
     /**
      * Transaction de performance desta execução — já correlacionada à run e finalizada
      * automaticamente ao fim do handler. Use `ctx.tx.startChild(op, description)` pra medir
@@ -277,7 +297,7 @@ interface CaptureAttachment {
     contentType?: RunAttachmentContentType;
 }
 interface CaptureHint {
-    level?: Severity;
+    type?: EventType;
     tags?: Record<string, string>;
     extra?: Record<string, unknown>;
     fingerprint?: string[];
@@ -305,7 +325,7 @@ declare function getClient(): Client | undefined;
  * como miniatura na linha de log da run correspondente ao erro.
  */
 declare function captureException(error: unknown, hint?: CaptureHint): string | undefined;
-declare function captureMessage(message: string, level?: Severity, hint?: CaptureHint): string | undefined;
+declare function captureMessage(message: string, type?: EventType, hint?: CaptureHint): string | undefined;
 /** Registra um breadcrumb — anexado aos próximos eventos como trilha do que aconteceu antes. */
 declare function addBreadcrumb(crumb: BreadcrumbInput): void;
 declare function setTag(key: string, value: string): void;
@@ -336,4 +356,4 @@ declare function close(timeoutMs?: number): Promise<boolean>;
 
 declare function scrubSecrets(text: string): string;
 
-export { type AttachInput, Breadcrumb, type BreadcrumbInput, type CaptureAttachment, type CaptureHint, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, RunAttachmentContentType, type RunContext, type RunItemOptions, RunItemStatus, type RunItems, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withScope };
+export { type AttachInput, Breadcrumb, type BreadcrumbInput, type CaptureAttachment, type CaptureHint, Client, DEFAULT_BASE_URL, EventPayload, EventType, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, RunAttachmentContentType, type RunContext, type RunItemOptions, RunItemStatus, type RunItems, RunLogLevel, RunProgress, type RunProgressReporter, Scope, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withScope };

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 { Envelope, EnvelopeItem, ExceptionData, InstanceInfo, PollRequest, PollResponse, RunAttachmentConfirmRequest, RunAttachmentConfirmResponse, RunAttachmentCreateRequest, RunAttachmentCreateResponse, RunDescriptor, RunError, RunItemInput, RunItemsCreateRequest, RunItemsCreateResponse, RunLogEntry, RunStatus, RunUpdateRequest, RunUpdateResponse, RunUpdateStatus, StackFrame } from './protocol.js';
+import { Breadcrumb, EventUser, EventType, EventPayload, TransactionPayload, HeartbeatPayload, StepStatus, RunLogLevel, StepData, RunItemStatus, RunProgress, RunAttachmentContentType } from './protocol.js';
+export { BreadcrumbLevel, 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;
@@ -25,7 +25,7 @@ declare class Scope {
     user?: EventUser;
     contexts: Record<string, Record<string, unknown>>;
     extra: Record<string, unknown>;
-    level?: Severity;
+    type?: EventType;
     fingerprint?: string[];
     breadcrumbs: Breadcrumb[];
     setTag(key: string, value: string): this;
@@ -34,7 +34,7 @@ declare class Scope {
     setContext(name: string, context: Record<string, unknown> | null): this;
     setExtra(key: string, value: unknown): this;
     setExtras(extras: Record<string, unknown>): this;
-    setLevel(level: Severity): this;
+    setType(type: EventType): this;
     setFingerprint(fingerprint: string[]): this;
     addBreadcrumb(crumb: BreadcrumbInput, maxBreadcrumbs: number): this;
     clearBreadcrumbs(): this;
@@ -59,7 +59,7 @@ declare class Client {
     /** Serialização explícita nunca inclui o secret. */
     toJSON(): Record<string, unknown>;
     captureException(error: unknown, hint: CaptureHint | undefined, scope: Scope): string;
-    captureMessage(message: string, level: Severity, hint: CaptureHint | undefined, scope: Scope): string;
+    captureMessage(message: string, type: EventType, hint: CaptureHint | undefined, scope: Scope): string;
     captureEvent(event: EventPayload, hint: CaptureHint | undefined, scope: Scope): string;
     private prepareEvent;
     sendTransaction(payload: TransactionPayload): void;
@@ -198,6 +198,24 @@ interface RunItems {
     /** Ocorrência de negócio (ex.: "nota nº 10 não encontrada") — não é falha do bot. */
     occurrence(message: string, payload?: Record<string, unknown>, options?: RunItemOptions): void;
 }
+/**
+ * Progresso da execução (itens processados / total) — opcional e independente de
+ * `ctx.items`. Declare o total antes do loop e avance a cada item: a plataforma e o
+ * Studio mostram barra, percentual e tempo restante estimado. Sem `total()` nada é
+ * enviado. Chamadas são síncronas e baratas (≤ 1 PATCH/s, pegando carona nos logs).
+ */
+interface RunProgressReporter {
+    /** Declara (ou ajusta) o total de itens previsto — inteiro >= 1. Idempotente. */
+    total(total: number): void;
+    /** Incrementa os processados (padrão 1). Clampa em `total`. */
+    advance(count?: number): void;
+    /** Define o valor absoluto de processados e, opcionalmente, o total. */
+    set(current: number, total?: number): void;
+    /** Processados até agora (0 antes de qualquer chamada). */
+    readonly current: number;
+    /** `{ current, total }` quando há total declarado; null caso contrário. */
+    readonly snapshot: RunProgress | null;
+}
 interface RunContext {
     runId: string;
     task: string;
@@ -205,6 +223,8 @@ interface RunContext {
     log: RunLogger;
     /** Itens processados/gerados pela execução — a entrega do bot, com status e atributos */
     items: RunItems;
+    /** Progresso declarado (barra + ETA no app) — opcional, independente de `ctx.items` */
+    progress: RunProgressReporter;
     /**
      * Transaction de performance desta execução — já correlacionada à run e finalizada
      * automaticamente ao fim do handler. Use `ctx.tx.startChild(op, description)` pra medir
@@ -277,7 +297,7 @@ interface CaptureAttachment {
     contentType?: RunAttachmentContentType;
 }
 interface CaptureHint {
-    level?: Severity;
+    type?: EventType;
     tags?: Record<string, string>;
     extra?: Record<string, unknown>;
     fingerprint?: string[];
@@ -305,7 +325,7 @@ declare function getClient(): Client | undefined;
  * como miniatura na linha de log da run correspondente ao erro.
  */
 declare function captureException(error: unknown, hint?: CaptureHint): string | undefined;
-declare function captureMessage(message: string, level?: Severity, hint?: CaptureHint): string | undefined;
+declare function captureMessage(message: string, type?: EventType, hint?: CaptureHint): string | undefined;
 /** Registra um breadcrumb — anexado aos próximos eventos como trilha do que aconteceu antes. */
 declare function addBreadcrumb(crumb: BreadcrumbInput): void;
 declare function setTag(key: string, value: string): void;
@@ -336,4 +356,4 @@ declare function close(timeoutMs?: number): Promise<boolean>;
 
 declare function scrubSecrets(text: string): string;
 
-export { type AttachInput, Breadcrumb, type BreadcrumbInput, type CaptureAttachment, type CaptureHint, Client, DEFAULT_BASE_URL, EventPayload, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, RunAttachmentContentType, type RunContext, type RunItemOptions, RunItemStatus, type RunItems, RunLogLevel, Scope, Severity, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withScope };
+export { type AttachInput, Breadcrumb, type BreadcrumbInput, type CaptureAttachment, type CaptureHint, Client, DEFAULT_BASE_URL, EventPayload, EventType, EventUser, type HeartbeatOptions, HeartbeatPayload, type InitOptions, RunAttachmentContentType, type RunContext, type RunItemOptions, RunItemStatus, type RunItems, RunLogLevel, RunProgress, type RunProgressReporter, Scope, Step, StepData, type TaskHandler, type TasksOptions, Transaction, TransactionPayload, addBreadcrumb, captureException, captureMessage, close, flush, getClient, init, register, scrubSecrets, setContext, setExtra, setTag, setTags, setUser, start, startTransaction, stop, withScope };

package/dist/index.js

@@ -103,7 +103,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 ? "2.2.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -233,34 +233,34 @@ function safeString(value) {
   }
   return String(value);
 }
-function eventFromException(error, level = "error") {
-  let type;
+function eventFromException(error, type = "error") {
+  let exceptionType;
   let value;
   let frames = [];
   if (error instanceof Error) {
-    type = error.name || "Error";
+    exceptionType = error.name || "Error";
     value = scrubSecrets(error.message);
     frames = parseStacktrace(error.stack);
   } else {
-    type = "NonError";
+    exceptionType = "NonError";
     value = scrubSecrets(safeString(error));
   }
   return {
     event_id: uuid4(),
     timestamp: nowISO(),
-    level,
+    type,
     exception: {
-      type,
+      type: exceptionType,
       value,
       ...frames.length > 0 ? { stacktrace: { frames } } : {}
     }
   };
 }
-function eventFromMessage(message, level = "info") {
+function eventFromMessage(message, type = "warning") {
   return {
     event_id: uuid4(),
     timestamp: nowISO(),
-    level,
+    type,
     message: scrubSecrets(message)
   };
 }
@@ -423,10 +423,10 @@ var Client = class {
     return `Client { baseUrl: '${this.#config.baseUrl}' }`;
   }
   captureException(error, hint, scope2) {
-    return this.captureEvent(eventFromException(error, hint?.level ?? "error"), hint, scope2);
+    return this.captureEvent(eventFromException(error, hint?.type ?? "error"), hint, scope2);
   }
-  captureMessage(message, level, hint, scope2) {
-    return this.captureEvent(eventFromMessage(message, level), hint, scope2);
+  captureMessage(message, type, hint, scope2) {
+    return this.captureEvent(eventFromMessage(message, type), hint, scope2);
   }
   captureEvent(event, hint, scope2) {
     const sampleRate = this.options.sampleRate ?? 1;
@@ -448,7 +448,7 @@ var Client = class {
     const extra = { ...scope2.extra, ...event.extra, ...hint?.extra };
     return {
       ...event,
-      level: hint?.level ?? event.level ?? scope2.level ?? "error",
+      type: hint?.type ?? event.type ?? scope2.type ?? "error",
       release: event.release ?? this.options.release,
       environment: event.environment ?? this.options.environment ?? "production",
       tags: Object.keys(tags).length > 0 ? tags : void 0,
@@ -566,7 +566,7 @@ function installGlobalHandlers(client2, getScope) {
     process.on(
       "uncaughtException",
       markInternal((error) => {
-        client2.captureException(error, { level: "fatal", tags: { mechanism: "uncaughtException" } }, getScope());
+        client2.captureException(error, { type: "fatal", tags: { mechanism: "uncaughtException" } }, getScope());
         void client2.flush(2e3).then(async () => {
           if (externalListenerCount("uncaughtException") === 0) {
             await awaitEmergencyTasks(EMERGENCY_REPORT_CAP_MS);
@@ -579,7 +579,7 @@ function installGlobalHandlers(client2, getScope) {
     process.on(
       "unhandledRejection",
       markInternal((reason) => {
-        client2.captureException(reason, { level: "error", tags: { mechanism: "unhandledRejection" } }, getScope());
+        client2.captureException(reason, { type: "error", tags: { mechanism: "unhandledRejection" } }, getScope());
         void client2.flush(2e3);
       })
     );
@@ -610,7 +610,7 @@ var Scope = class _Scope {
   user;
   contexts = {};
   extra = {};
-  level;
+  type;
   fingerprint;
   breadcrumbs = [];
   setTag(key, value) {
@@ -641,8 +641,8 @@ var Scope = class _Scope {
     Object.assign(this.extra, extras);
     return this;
   }
-  setLevel(level) {
-    this.level = level;
+  setType(type) {
+    this.type = type;
     return this;
   }
   setFingerprint(fingerprint) {
@@ -666,7 +666,7 @@ var Scope = class _Scope {
     next.user = this.user ? { ...this.user } : void 0;
     next.contexts = Object.fromEntries(Object.entries(this.contexts).map(([k, v]) => [k, { ...v }]));
     next.extra = { ...this.extra };
-    next.level = this.level;
+    next.type = this.type;
     next.fingerprint = this.fingerprint ? [...this.fingerprint] : void 0;
     next.breadcrumbs = [...this.breadcrumbs];
     return next;
@@ -1143,6 +1143,7 @@ var MAX_ITEM_MESSAGE_CHARS = 2e3;
 var MAX_ITEM_PAYLOAD_BYTES = 16384;
 var ITEMS_FLUSH_AT_BUFFERED = 100;
 var ITEMS_DRAIN_MS = 15e3;
+var PROGRESS_FLUSH_MS = 1e3;
 function scrubPayloadValue(value, depth) {
   if (typeof value === "string") return scrubSecrets(value);
   if (depth >= 4 || value === null || typeof value !== "object") return value;
@@ -1177,12 +1178,28 @@ var RunReporter = class {
       failed: (message, payload, options) => this.addItem("failed", message, payload, options?.id),
       occurrence: (message, payload, options) => this.addItem("occurrence", message, payload, options?.id)
     };
+    const progress = Object.defineProperties(
+      {
+        total: (total) => this.setProgress(this.progressCurrent, total),
+        advance: (count = 1) => this.setProgress(this.progressCurrent + count, this.progressTotal),
+        set: (current, total) => this.setProgress(current, total ?? this.progressTotal)
+      },
+      {
+        current: { enumerable: true, get: () => this.progressCurrent },
+        snapshot: {
+          enumerable: true,
+          get: () => this.progressTotal == null ? null : { current: this.progressCurrent, total: this.progressTotal }
+        }
+      }
+      // defineProperties não tipa os getters adicionados — a interface é a fonte de verdade
+    );
     const signal = this.abortController.signal;
     this.context = {
       runId,
       task,
       log,
       items,
+      progress,
       tx,
       signal,
       throwIfCanceled: () => {
@@ -1226,6 +1243,14 @@ var RunReporter = class {
   uploadQueue = [];
   /** Uma vez que a instalação recusa anexos, para de tentar (e de avisar) nesta run. */
   attachmentsUnsupported = false;
+  // Progresso (ctx.progress): snapshot absoluto, enviado com throttle via piggyback
+  // em `enqueue()` — nunca gera tráfego próprio enquanto logs/heartbeat já fluem.
+  progressCurrent = 0;
+  progressTotal = null;
+  /** Snapshot ainda não entregue ao servidor. */
+  progressDirty = false;
+  progressTimer;
+  progressWarned = false;
   get isDead() {
     return this.dead;
   }
@@ -1243,6 +1268,7 @@ var RunReporter = class {
     this.abort();
     this.dead = true;
     this.clearFlushTimer();
+    this.clearProgressTimer();
     this.buffer = [];
     this.itemsClosed = true;
     this.clearItemsTimer();
@@ -1322,13 +1348,63 @@ var RunReporter = class {
   reportSuccess() {
     this.stopCancelWatch();
     this.clearFlushTimer();
+    this.forceFinalProgress();
     this.enqueue({ status: "succeeded", logs: this.takeLogs() });
   }
   reportFailure(error) {
     this.stopCancelWatch();
     this.clearFlushTimer();
+    this.forceFinalProgress();
     this.enqueue({ status: "failed", error, logs: this.takeLogs() });
   }
+  // ── Progresso ────────────────────────────────────────────────────────────────
+  /** Valida, clampa e marca o snapshot como pendente; agenda flush só se nada mais vai sair. */
+  setProgress(current, total) {
+    if (this.dead) return;
+    if (total != null && (!Number.isInteger(total) || total < 1)) {
+      if (!this.progressWarned) {
+        this.progressWarned = true;
+        this.logger.warn(`ctx.progress: total inv\xE1lido (${String(total)}) \u2014 precisa ser inteiro >= 1; ignorado`);
+      }
+      return;
+    }
+    const safeCurrent = Number.isFinite(current) ? Math.max(0, Math.floor(current)) : this.progressCurrent;
+    const next = total == null ? safeCurrent : Math.min(safeCurrent, total);
+    if (next === this.progressCurrent && total === this.progressTotal) return;
+    this.progressCurrent = next;
+    this.progressTotal = total;
+    if (total == null) return;
+    this.progressDirty = true;
+    if (this.progressTimer) return;
+    this.progressTimer = setTimeout(() => {
+      this.progressTimer = void 0;
+      this.flushProgress();
+    }, PROGRESS_FLUSH_MS);
+    unrefTimer(this.progressTimer);
+  }
+  flushProgress() {
+    this.clearProgressTimer();
+    if (this.dead || !this.progressDirty) return;
+    if (this.buffer.length > 0) this.flushLogs();
+    else this.enqueue({ status: "running" });
+  }
+  clearProgressTimer() {
+    if (this.progressTimer) {
+      clearTimeout(this.progressTimer);
+      this.progressTimer = void 0;
+    }
+  }
+  /** O PATCH terminal sempre leva o snapshot final (o app mostra "87/100" numa run que falhou). */
+  forceFinalProgress() {
+    this.clearProgressTimer();
+    this.progressDirty = this.progressTotal != null;
+  }
+  /** Consome o snapshot pendente para pegar carona no próximo PATCH. */
+  takeProgress() {
+    if (!this.progressDirty || this.progressTotal == null) return void 0;
+    this.progressDirty = false;
+    return { current: this.progressCurrent, total: this.progressTotal };
+  }
   /**
    * Heartbeat de cancelamento: enquanto o handler roda, um PATCH 'running' vazio
    * periódico faz o servidor responder 409 se a run foi cancelada no app — o que
@@ -1591,11 +1667,14 @@ var RunReporter = class {
       new Promise((resolve) => unrefTimer(setTimeout(resolve, timeoutMs)))
     ]);
   }
-  enqueue(update) {
+  enqueue(updateIn) {
     if (this.dead) {
-      this.salvageLogs(update.logs);
+      this.salvageLogs(updateIn.logs);
       return;
     }
+    this.clearProgressTimer();
+    const progress = this.takeProgress();
+    const update = progress ? { ...updateIn, progress } : updateIn;
     this.pendingUpdates++;
     this.chain = this.chain.then(async () => {
       if (this.dead) {
@@ -1621,6 +1700,7 @@ var RunReporter = class {
           this.buffer.unshift(...update.logs);
           this.scheduleFlush();
         }
+        if (update.progress && this.progressTotal != null) this.progressDirty = true;
         this.logger.error(`update da run ${this.runId} perdido:`, error);
       }
     }).finally(() => {
@@ -2026,10 +2106,10 @@ function init(options) {
 function getClient() {
   return client;
 }
-function toRunLogLevel(level) {
-  return level === "fatal" ? "error" : level;
+function toRunLogLevel(type) {
+  return type === "fatal" ? "error" : type;
 }
-function forwardAttachment(attachment, message, level) {
+function forwardAttachment(attachment, message, type) {
   const attach = currentRunAttach();
   if (!attach) {
     client?.logger.warn("attachment descartado \u2014 s\xF3 \xE9 suportado dentro de uma execu\xE7\xE3o de task (register/start)");
@@ -2038,7 +2118,7 @@ function forwardAttachment(attachment, message, level) {
   const withMeta = typeof attachment === "object" && "image" in attachment ? attachment : { image: attachment };
   void attach(withMeta.image, {
     message,
-    level: toRunLogLevel(level),
+    level: toRunLogLevel(type),
     caption: withMeta.caption,
     contentType: withMeta.contentType
   });
@@ -2046,15 +2126,15 @@ function forwardAttachment(attachment, message, level) {
 function captureException(error, hint) {
   if (hint?.attachment) {
     const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
-    forwardAttachment(hint.attachment, message, hint.level ?? "error");
+    forwardAttachment(hint.attachment, message, hint.type ?? "error");
   }
   return client?.captureException(error, hint, scope);
 }
-function captureMessage(message, level = "info", hint) {
+function captureMessage(message, type = "warning", hint) {
   if (hint?.attachment) {
-    forwardAttachment(hint.attachment, message, hint.level ?? level);
+    forwardAttachment(hint.attachment, message, hint.type ?? type);
   }
-  return client?.captureMessage(message, level, hint, scope);
+  return client?.captureMessage(message, type, hint, scope);
 }
 function addBreadcrumb(crumb) {
   scope.addBreadcrumb(crumb, client?.options.maxBreadcrumbs ?? DEFAULT_MAX_BREADCRUMBS);