hobots 1.7.6 → 1.8.0

package/README.md

@@ -1,8 +1,8 @@
 # hobots
 
-SDK JavaScript/TypeScript da **Hobots** para instrumentar funcionários digitais (RPAs) e integrações.
+SDK JavaScript/TypeScript da **Hobots** para instrumentar agentes (RPAs) e integrações.
 
-- **Telemetria** — o que o programa **emite** sozinho: erros com stack trace (módulo **Issues** do app), performance (transactions/etapas) e heartbeats de uptime (módulo **Agentes**), check-ins de cron (módulo **Monitores**).
+- **Telemetria** — o que o programa **emite** sozinho: erros com stack trace (módulo **Issues** do app), performance (transactions/etapas) e heartbeats de uptime (módulo **Agentes**).
 - **Tasks** — execução **sob demanda**: o agente faz polling no app da Hobots, executa handlers registrados e reporta status e logs (módulo **Solicitações**).
 
 **Um único import e um único `init()`** cobrem as duas capabilities. Cliente HTTP puro, **sem dependências de runtime**. Requer **Node 18+** (usa o `fetch` global); a telemetria também roda no browser para captura de erros.
@@ -30,7 +30,7 @@ O SDK expõe **duas capabilities** autenticadas pelo **mesmo Client Secret do ag
 
 | Capability | Como habilita | Para quê | Ciclo de vida |
 | --- | --- | --- | --- |
-| **Telemetria** | sempre ativa no `init()` | O que o programa emite sozinho: erros, transactions/etapas, crons, heartbeat. | Timers `unref`'d — **não** segura o processo. Chame `close()` no fim. |
+| **Telemetria** | sempre ativa no `init()` | O que o programa emite sozinho: erros, transactions/etapas, heartbeat. | Timers `unref`'d — **não** segura o processo. Chame `close()` no fim. |
 | **Tasks** | `tasks: true` (ou opções) no `init()` | Execução remota sob demanda via polling. | `start()` **segura o processo vivo** até `stop()`/`close()`. |
 
 Você usa **uma, outra ou as duas**:
@@ -181,26 +181,6 @@ tx.finish();         // só aqui a transaction é enviada (respeitando tracesSam
 
 Dentro de um handler de task, `startTransaction()` **retorna a transaction da própria run** (`ctx.tx`) em vez de criar uma segunda — cada execução tem exatamente **uma** transaction. Conceitos: [Transaction](./docs/concepts.md#transaction) · [Step](./docs/concepts.md#step).
 
-### Crons (check-ins)
-
-Monitora jobs agendados no módulo **Monitores** do app: check-in `in_progress` na entrada, `ok`/`error` na saída, com duração medida. O jeito recomendado é `withMonitor`, que faz o par e captura exceções:
-
-```js
-await Hobots.withMonitor(
-  'sync-notas',
-  () => executarSync(),
-  { schedule: '0 */2 * * *', timezone: 'America/Fortaleza' }
-);
-```
-
-O `schedule` (expressão cron) faz o servidor **criar/atualizar o monitor automaticamente** (upsert) e habilita a detecção de **execução perdida**. Para controle manual:
-
-```js
-const id = Hobots.checkIn({ monitorSlug: 'sync-notas', status: 'in_progress' });
-// … trabalho …
-Hobots.checkIn({ monitorSlug: 'sync-notas', status: 'ok', checkInId: id, durationMs: 1234 });
-```
-
 ### Heartbeat (uptime)
 
 Bate "estou vivo" periodicamente; o servidor acusa o robô **offline** quando os batimentos param.
@@ -353,7 +333,7 @@ Para parar de aceitar execuções **sem** derrubar a telemetria, use `stop(timeo
 
 | Import | Conteúdo |
 | --- | --- |
-| `hobots` | Tudo: `init`, telemetria (captura, transactions, crons, heartbeat), tasks (`register`/`start`/`stop`), `close`, classes e tipos. |
+| `hobots` | Tudo: `init`, telemetria (captura, transactions, heartbeat), tasks (`register`/`start`/`stop`), `close`, classes e tipos. |
 | `hobots/protocol` | Tipos do wire format (telemetria e tasks). |
 
 Empacotado em **ESM e CommonJS** com **definições de tipos** (`.d.ts`) para todas as entradas.
@@ -368,7 +348,7 @@ Novo no vocabulário de observabilidade (transaction, step, breadcrumb, tag, con
 
 - [Conceitos](./docs/concepts.md) — o que cada coisa é, por que existe e quando escolher uma em vez da outra.
 - [Getting started](./docs/getting-started.md) — instalação, Client Secret, primeiro `init`, telemetria e tasks.
-- [Telemetria](./docs/monitor.md) — erros, breadcrumbs, escopo, transactions/etapas, crons, heartbeat.
+- [Telemetria](./docs/telemetry.md) — erros, breadcrumbs, escopo, transactions/etapas, heartbeat.
 - [Tasks](./docs/tasks.md) — handlers, `RunContext`, cancelamento, concorrência, idempotência.
 - [Referência de API](./docs/api-reference.md) — todas as funções e tabelas de opções com defaults.
 - [Protocolo & transporte](./docs/protocol.md) — o Client Secret, endpoints, envelope, retries.

package/dist/index.cjs

@@ -38,7 +38,6 @@ __export(src_exports, {
   addBreadcrumb: () => addBreadcrumb,
   captureException: () => captureException,
   captureMessage: () => captureMessage,
-  checkIn: () => checkIn,
   close: () => close,
   flush: () => flush,
   getClient: () => getClient,
@@ -53,7 +52,6 @@ __export(src_exports, {
   start: () => start,
   startTransaction: () => startTransaction,
   stop: () => stop,
-  withMonitor: () => withMonitor,
   withScope: () => withScope
 });
 module.exports = __toCommonJS(src_exports);
@@ -163,7 +161,7 @@ function scrubSecrets(text) {
 
 // src/utils.ts
 var SDK_NAME = "hobots";
-var SDK_VERSION = true ? "1.7.6" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.8.0" : "0.0.0-dev";
 function isNode() {
   return typeof process !== "undefined" && typeof process.versions?.node === "string";
 }
@@ -517,16 +515,6 @@ var Client = class {
       }
     });
   }
-  sendCheckIn(payload) {
-    this.transport.enqueue({
-      type: "check_in",
-      payload: {
-        ...payload,
-        release: payload.release ?? this.options.release,
-        environment: payload.environment ?? this.options.environment ?? "production"
-      }
-    });
-  }
   sendHeartbeat(payload) {
     this.transport.enqueue({
       type: "heartbeat",
@@ -891,34 +879,6 @@ var Transaction = class {
   }
 };
 
-// src/checkin.ts
-function sendCheckIn(client2, options) {
-  const checkInId = options.checkInId ?? uuid4();
-  client2.sendCheckIn({
-    check_in_id: checkInId,
-    monitor_slug: options.monitorSlug,
-    status: options.status,
-    duration_ms: options.durationMs,
-    schedule: options.schedule,
-    timezone: options.timezone
-  });
-  return checkInId;
-}
-async function withMonitorImpl(client2, captureError, monitorSlug, fn, options) {
-  const base = { monitorSlug, schedule: options?.schedule, timezone: options?.timezone };
-  const checkInId = sendCheckIn(client2, { ...base, status: "in_progress" });
-  const startedAt = Date.now();
-  try {
-    const result = await fn();
-    sendCheckIn(client2, { ...base, status: "ok", checkInId, durationMs: Date.now() - startedAt });
-    return result;
-  } catch (error) {
-    sendCheckIn(client2, { ...base, status: "error", checkInId, durationMs: Date.now() - startedAt });
-    captureError(error);
-    throw error;
-  }
-}
-
 // src/tasks/api.ts
 var POLL_TIMEOUT_MS = 3e4;
 var UPDATE_TIMEOUT_MS = 1e4;
@@ -1464,7 +1424,7 @@ var TaskAgent = class {
         {
           agent: {
             // identidade canônica do agente no painel — o mesmo instanceId do
-            // heartbeat do Monitor, então os dois canais convergem em um agente
+            // heartbeat da Telemetria, então os dois canais convergem em um agente
             instance_id: this.instanceId,
             version: SDK_VERSION,
             host: hostname(),
@@ -1666,19 +1626,6 @@ function startTransaction(name, op) {
   const sampled = rate >= 1 || Math.random() < rate;
   return new Transaction(client, name, op, sampled);
 }
-function checkIn(options) {
-  return client ? sendCheckIn(client, options) : void 0;
-}
-async function withMonitor(monitorSlug, fn, options) {
-  if (!client) return fn();
-  return withMonitorImpl(
-    client,
-    (error) => captureException(error, { tags: { monitor: monitorSlug } }),
-    monitorSlug,
-    fn,
-    options
-  );
-}
 function flush(timeoutMs) {
   return client ? client.flush(timeoutMs) : Promise.resolve(true);
 }