@lexnode/legal-data-sdk 1.18.0 → 1.24.0

package/README.md

@@ -75,6 +75,7 @@ await lexnode.subscriptions.create({ tribunalAlias, processNumber, externalRef }
 await lexnode.searchJobs.get(jobId);
 await lexnode.events.list({ limit: 50 });
 await lexnode.webhooks.endpoints.list();
+await lexnode.webhooks.unsubscribedEventTypes();
 await lexnode.usage.get();
 ```
 
@@ -160,6 +161,9 @@ A afirmação é sua: sem ela, um `POST` repetido cria um **segundo** recurso
 endpoints para a mesma URL entregam cada evento em dobro, e o segredo do
 primeiro fica órfão. Em toda outra rota o `requestId` é só rastreio.
 
+A exceção é o `UPSTREAM_TIMEOUT` da leitura de um processo, que a política não
+repete — ver [a seção da fonte lenta](#ler-um-processo-quando-a-fonte-está-lenta).
+
 ## Webhooks
 
 ```ts
@@ -252,6 +256,56 @@ if (desfecho.kind === "sync") {
 }
 ```
 
+## Ler um processo quando a fonte está lenta
+
+A ficha (`processes.get`) vai à fonte processual quando o acervo não tem o
+processo fresco; o retrato (`processes.snapshot`) vai sempre, e só recorre ao
+acervo quando a fonte falha. A fonte às vezes leva perto de um minuto por
+consulta. `waitSeconds` diz quanto o motor espera por ela: de 10 a 180
+segundos, padrão 20 na API.
+
+```ts
+const { data, meta } = await lexnode.processes.get(numero, {
+  tribunalAlias: "api_publica_tjsp",
+  waitSeconds: 120,
+});
+```
+
+**O prazo da chamada acompanha a espera.** Sem `timeoutMs` na chamada, o SDK
+usa o maior entre o prazo do cliente e a espera mais 15 s: depois da fonte, a
+ficha ainda espera até 10 s pelo resumo das publicações do processo, e o resto
+é a rede. Com `waitSeconds: 120`, a chamada desiste aos 135 s, e não aos 30 s do
+padrão; sem `waitSeconds`, o SDK conta a espera padrão da API, e a chamada
+desiste aos 35 s. Um `timeoutMs` explícito sempre vence. O mesmo vale para a
+chamada genérica (`request`) nessas duas rotas.
+
+**O tempo esgotado não se repete sozinho.** `UPSTREAM_TIMEOUT` (504) nessas
+duas leituras é lentidão da fonte, não ausência do processo, e a política de
+retentativa não o repete: a espera já correu inteira, e repetir na hora a
+dobraria diante da mesma fonte lenta. As outras recusas retentáveis seguem a
+política. Para insistir, a decisão é sua — uma nova chamada com espera maior,
+ou a vigília do processo (`watchProcess`), que consulta em segundo plano.
+
+**`meta.partialIndex`: o processo veio de parte do índice.** Quando a fonte
+responde com só parte do índice e o processo estava na parte que respondeu, ele
+é servido, e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`),
+de quantas (`shardsTotal`, nulo quando a fonte não as contou) e se o prazo
+interno dela estourou (`timedOut`). O processo servido é o que a fonte tem, mas
+outra instância do mesmo número — outro grau — pode estar na parte que não
+respondeu. A resposta parcial que não serve o processo — sem ele, ou com uma
+instância diferente da que o acervo já guarda — é 502 `UPSTREAM_UNAVAILABLE`
+retentável, nunca 404.
+
+```ts
+if (meta.partialIndex) {
+  // Outro grau deste número, se existir, pode não ter vindo.
+}
+```
+
+**Agentes têm a espera deles.** No canal para agentes (MCP), as tools
+`ler_processo` e `consultar_processo` escolhem a espera em `maxWaitSeconds`, na
+mesma faixa e com padrão de 120 s; esse canal não passa pelo SDK.
+
 ## Frescor: o `total: 0` qualificado
 
 Um resultado vazio não distingue sozinho "não existe" de "a fonte ainda não

package/dist/client.d.ts

@@ -10,7 +10,11 @@ export interface LexNodeClientOptions {
     apiKey: string;
     /** Sub-tenant padrão (`X-Office-Id`). Cada chamada pode trocá-lo ou omiti-lo. */
     officeId?: string;
-    /** Prazo de cada chamada, em ms. Padrão: 30 s. */
+    /**
+     * Prazo de cada chamada, em ms. Padrão: 30 s. A ficha e o retrato de um
+     * processo levam o maior entre este prazo e a espera pela fonte mais 15 s —
+     * `waitSeconds`, ou o padrão de 20 s da API quando ele falta.
+     */
     timeoutMs?: number;
     /** Transporte alternativo — o `fetch` global é o padrão. */
     fetch?: typeof globalThis.fetch;
@@ -90,6 +94,7 @@ export declare function createLexNodeClient(options: LexNodeClientOptions): {
         };
         deliveries: (query?: Query<"/v1/webhooks/deliveries", "get">, opts?: CallOptions) => Promise<LexNodeResult<"/v1/webhooks/deliveries", "get">>;
         health: (opts?: CallOptions) => Promise<LexNodeResult<"/v1/webhooks/health", "get">>;
+        unsubscribedEventTypes: (opts?: CallOptions) => Promise<LexNodeResult<"/v1/webhooks/unsubscribed-event-types", "get">>;
     };
 };
 export type LexNodeClient = ReturnType<typeof createLexNodeClient>;

package/dist/client.js

@@ -17,6 +17,24 @@ const IDEMPOTENT_METHODS = new Set(["get", "delete"]);
 const REQUEST_ID_IDEMPOTENT_WRITES = new Set([
     "post /v1/publications/text-searches",
 ]);
+/**
+ * As leituras de UM processo em que quem chama escolhe, em `waitSeconds`,
+ * quanto o motor espera pela fonte processual.
+ */
+const SOURCE_WAIT_ROUTES = new Set([
+    "get /v1/processes/{processNumber}",
+    "get /v1/processes/{processNumber}/snapshot",
+]);
+/**
+ * A espera que o motor aplica a essas leituras quando a chamada não traz
+ * `waitSeconds`: o padrão do parâmetro no contrato.
+ */
+const SOURCE_WAIT_API_DEFAULT_SECONDS = 20;
+/**
+ * O que a chamada espera além da espera do motor: na ficha, até 10 s de
+ * enriquecimento depois da fonte, e a rede.
+ */
+const SOURCE_WAIT_MARGIN_MS = 15_000;
 /** O que um valor de cabeçalho não pode conter: `fetch` recusa montá-lo. */
 const FORBIDDEN_HEADER_CHARS = /[\r\n\0]/u;
 /** Hosts em que falar claro é desenvolvimento, não credencial exposta. */
@@ -87,6 +105,23 @@ function appendQuery(url, query) {
         }
     }
 }
+/**
+ * O prazo da chamada que não trouxe `timeoutMs` próprio.
+ *
+ * Numa leitura que espera pela fonte, o motor pode levar a espera inteira
+ * antes de responder — a de `waitSeconds` ou, sem ele, a padrão da API: o
+ * prazo cobre essa espera mais a margem e nunca fica abaixo do prazo do
+ * cliente. Nas outras rotas, vale o prazo do cliente.
+ */
+function defaultCallTimeoutMs(method, path, query, clientTimeoutMs) {
+    if (!SOURCE_WAIT_ROUTES.has(`${method} ${path}`))
+        return clientTimeoutMs;
+    const requested = Number(query?.waitSeconds);
+    const waitSeconds = Number.isFinite(requested) && requested > 0
+        ? requested
+        : SOURCE_WAIT_API_DEFAULT_SECONDS;
+    return Math.max(clientTimeoutMs, waitSeconds * 1_000 + SOURCE_WAIT_MARGIN_MS);
+}
 /**
  * Junta o prazo do cliente ao `signal` de quem chamou.
  *
@@ -146,10 +181,19 @@ function sleep(ms, signal) {
  * repetir é seguro. Uma escrita fora da lista só é repetida quando quem chama
  * declara `idempotent: true` — quem conhece o próprio uso pode afirmar o que o
  * contrato não afirma, mas a afirmação é dele, e explícita.
+ *
+ * O tempo esgotado da fonte (`UPSTREAM_TIMEOUT`) numa leitura que espera por
+ * ela não se repete: o motor já esperou tudo o que a chamada pediu, e repetir
+ * na hora dobra a espera diante da mesma fonte lenta. As demais recusas
+ * retentáveis dessas leituras seguem a política.
  */
 function mayRetry(error, method, path, options) {
     if (!(error instanceof LexNodeError) || !error.retryable)
         return false;
+    if (error.code === "UPSTREAM_TIMEOUT" &&
+        SOURCE_WAIT_ROUTES.has(`${method} ${path}`)) {
+        return false;
+    }
     if (IDEMPOTENT_METHODS.has(method))
         return true;
     if (options.idempotent === true)
@@ -212,7 +256,8 @@ export function createLexNodeClient(options) {
         catch (error) {
             throw LexNodeError.invalidRequest("O corpo da chamada não é serializável em JSON.", error);
         }
-        const timeoutMs = args.timeoutMs ?? defaultTimeoutMs;
+        const timeoutMs = args.timeoutMs ??
+            defaultCallTimeoutMs(String(method), String(path), bag.params?.query, defaultTimeoutMs);
         const link = linkAbort(timeoutMs, args.signal);
         let response;
         let raw;
@@ -425,6 +470,7 @@ export function createLexNodeClient(options) {
                 ...opts,
             }),
             health: (opts = {}) => request("/v1/webhooks/health", "get", { ...opts }),
+            unsubscribedEventTypes: (opts = {}) => request("/v1/webhooks/unsubscribed-event-types", "get", { ...opts }),
         },
     };
 }

package/dist/errors.d.ts

@@ -9,7 +9,7 @@ import type { RateLimitSnapshot } from "./types.js";
  * os dois por literal redigitado descobre o engano em produção. A lista é
  * fechada para o que se conhece e aberta para o que vier (ver `LexNodeError`).
  */
-export declare const LEXNODE_ERROR_CODES: readonly ["INVALID_MONITOR", "TRIBUNAL_NOT_SUPPORTED", "VALIDATION_ERROR", "UNAUTHORIZED", "QUOTA_EXCEEDED", "INSUFFICIENT_SCOPE", "LGPD_FORBIDDEN", "PLAN_FEATURE_NOT_INCLUDED", "SANDBOX_UPSTREAM_DISABLED", "MOVEMENTS_NOT_AVAILABLE", "PRECEDENT_NOT_FOUND", "PROCESS_NOT_FOUND", "RESOURCE_NOT_FOUND", "RESOURCE_CONFLICT", "QUERY_TOO_BROAD", "RATE_LIMITED", "UPSTREAM_RATE_LIMITED", "INTERNAL_ERROR", "UPSTREAM_UNAVAILABLE", "DATABASE_TIMEOUT", "DATABASE_UNAVAILABLE", "SYNC_ABANDONED", "UPSTREAM_TIMEOUT", "ACCOUNT_SUSPENDED", "ENTITLEMENT_EXPIRED", "PROJECT_DISABLED", "SUBSCRIPTION_INACTIVE", "MONITOR_ALREADY_EXISTS", "MONITOR_NOT_FOUND", "SEARCH_JOB_NOT_FOUND", "PUBLICATION_NOT_FOUND", "EVENT_NOT_FOUND", "TEXT_ALERT_NOT_FOUND", "TEXT_SEARCH_NOT_FOUND", "CLIENT_TIMEOUT", "CLIENT_NETWORK_ERROR", "CLIENT_INVALID_REQUEST", "CLIENT_MISSING_PATH_PARAM", "INVALID_RESPONSE", "SEARCH_JOB_BUDGET_EXCEEDED", "PAGINATION_LIMIT_REACHED"];
+export declare const LEXNODE_ERROR_CODES: readonly ["INVALID_MONITOR", "TRIBUNAL_NOT_SUPPORTED", "PERSONAL_DOCUMENT_QUERY_NOT_ALLOWED", "VALIDATION_ERROR", "UNAUTHORIZED", "QUOTA_EXCEEDED", "INSUFFICIENT_SCOPE", "LGPD_FORBIDDEN", "PLAN_FEATURE_NOT_INCLUDED", "SUB_TENANT_LIMIT_EXCEEDED", "SANDBOX_UPSTREAM_DISABLED", "MOVEMENTS_NOT_AVAILABLE", "PRECEDENT_NOT_FOUND", "PROCESS_NOT_FOUND", "RESOURCE_NOT_FOUND", "RESOURCE_CONFLICT", "QUERY_TOO_BROAD", "RATE_LIMITED", "UPSTREAM_RATE_LIMITED", "INTERNAL_ERROR", "UPSTREAM_UNAVAILABLE", "DATABASE_TIMEOUT", "DATABASE_UNAVAILABLE", "SYNC_ABANDONED", "UPSTREAM_TIMEOUT", "ACCOUNT_SUSPENDED", "ENTITLEMENT_EXPIRED", "PROJECT_DISABLED", "SUBSCRIPTION_INACTIVE", "MONITOR_ALREADY_EXISTS", "MONITOR_NOT_FOUND", "SEARCH_JOB_NOT_FOUND", "PUBLICATION_NOT_FOUND", "EVENT_NOT_FOUND", "TEXT_ALERT_NOT_FOUND", "TEXT_SEARCH_NOT_FOUND", "CLIENT_TIMEOUT", "CLIENT_NETWORK_ERROR", "CLIENT_INVALID_REQUEST", "CLIENT_MISSING_PATH_PARAM", "INVALID_RESPONSE", "SEARCH_JOB_BUDGET_EXCEEDED", "PAGINATION_LIMIT_REACHED"];
 /**
  * Um código conhecido — ou qualquer outro.
  *

package/dist/errors.js

@@ -11,12 +11,14 @@
 export const LEXNODE_ERROR_CODES = [
     "INVALID_MONITOR",
     "TRIBUNAL_NOT_SUPPORTED",
+    "PERSONAL_DOCUMENT_QUERY_NOT_ALLOWED",
     "VALIDATION_ERROR",
     "UNAUTHORIZED",
     "QUOTA_EXCEEDED",
     "INSUFFICIENT_SCOPE",
     "LGPD_FORBIDDEN",
     "PLAN_FEATURE_NOT_INCLUDED",
+    "SUB_TENANT_LIMIT_EXCEEDED",
     "SANDBOX_UPSTREAM_DISABLED",
     "MOVEMENTS_NOT_AVAILABLE",
     "PRECEDENT_NOT_FOUND",

package/dist/types.d.ts

@@ -150,7 +150,10 @@ export interface CallOptions {
     officeId?: string | null;
     /** Aborta a chamada. É COMBINADO com o prazo, nunca o substitui. */
     signal?: AbortSignal;
-    /** Prazo desta chamada, em ms. Vence o do construtor. */
+    /**
+     * Prazo desta chamada, em ms. Vence o do construtor e o que o cliente
+     * calcula para a ficha e o retrato de um processo a partir da espera.
+     */
     timeoutMs?: number;
     /**
      * `X-Request-Id`. Cunhado quando ausente.

package/dist/webhooks.d.ts

@@ -127,6 +127,13 @@ export interface PublicationCreatedPayload {
     /** Só na vigília por nome de parte. */
     partyName?: string;
     partyRole?: string | null;
+    /** Só na vigília por CNPJ: o literal vigiado — o documento pontuado
+     *  inteiro, ou a raiz `NN.NNN.NNN` quando `includeBranches`. */
+    partyDocument?: string;
+    includeBranches?: boolean;
+    /** `document`: o CNPJ consta no teor — a empresa foi citada no ato, seja
+     *  ou não parte. */
+    matchedBy?: "document";
 }
 export interface MonitorSyncSucceededPayload {
     monitorId: string;
@@ -177,6 +184,8 @@ export interface MonitorSyncSucceededPayload {
     refusedDays?: string[];
     term?: string;
     partyName?: string;
+    partyDocument?: string;
+    includeBranches?: boolean;
     publicationsMatched?: number;
 }
 export interface MonitorSyncFailedPayload {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lexnode/legal-data-sdk",
-  "version": "1.18.0",
-  "description": "Cliente TypeScript do LexNode, o motor de dados jurídicos do Brasil: transporte tipado, erros classificados, verificação de webhook e os tipos gerados do contrato OpenAPI.",
+  "version": "1.24.0",
+  "description": "Cliente TypeScript do LexNode, o motor de dados jur\u00eddicos do Brasil: transporte tipado, erros classificados, verifica\u00e7\u00e3o de webhook e os tipos gerados do contrato OpenAPI.",
   "license": "MIT",
   "homepage": "https://www.lexnode.com.br/docs",
   "keywords": [

package/schema.d.ts

@@ -73,7 +73,7 @@ export interface paths {
         };
         /**
          * Estado público do motor
-         * @description Estado operacional de cada capacidade, sem autenticação: é a página que se consulta antes de abrir chamado. Devolve estado, nunca volume — se uma capacidade está de pé, não quantas requisições ela serviu. `NO_SIGNAL` significa que não houve consulta à fonte na última hora, então não há o que medir. A resposta é cacheada por 30 segundos.
+         * @description Estado operacional de cada capacidade, sem autenticação: é a página que se consulta antes de abrir chamado. Devolve estado, nunca volume — se uma capacidade está de pé, não quantas requisições ela serviu. `NO_SIGNAL` significa que não houve consulta à fonte na última hora, então não há o que medir. Cada capacidade carrega também quando a fonte foi lida (`lastReadAt`) e, onde existe uma data de conteúdo para o acervo inteiro, até quando ela está lida (`readThrough`) — é com ela que se escreve "nada encontrado" sem confundir ausência com atraso. A resposta é cacheada por 30 segundos.
          */
         get: operations["getPublicStatus"];
         put?: never;
@@ -93,7 +93,7 @@ export interface paths {
         };
         /**
          * Listar os tribunais suportados
-         * @description Retorna os tribunais suportados e, para cada um, as fontes que o servem em `sources`: o eixo de processo, o diário e, onde existe, o acervo de jurisprudência. A entrada do ramo `ADMINISTRATIVE` tem só o acervo — consulta de processo, busca e colheita no diário, vigília e calendário forense a recusam com `TRIBUNAL_NOT_SUPPORTED`. É daqui que sai a grafia aceita nas demais rotas, pela sigla (`code`) ou pelo apelido da fonte (`alias`); a chave que liga uma publicação ao catálogo é `code`.
+         * @description Retorna os tribunais suportados e, para cada um, as fontes que o servem em `sources`: o eixo de processo, o diário e, onde existe, o acervo de jurisprudência. A entrada do ramo `ADMINISTRATIVE` tem só o acervo — consulta de processo, busca e colheita no diário, vigília e calendário forense a recusam com `TRIBUNAL_NOT_SUPPORTED`. É daqui que sai a grafia aceita nas demais rotas, pela sigla (`code`) ou pelo apelido da fonte (`alias`); a chave que liga uma publicação ao catálogo é `code`. Cada entrada traz também `processIndex`: até quando o índice da fonte foi lido no eixo do processo daquele tribunal — a data com que se escreve "não encontrei" sem confundir ausência com atraso.
          *
          *     **Escopo exigido na chave de API:** `TRIBUNALS_READ`
          */
@@ -115,7 +115,7 @@ export interface paths {
         };
         /**
          * Calendário forense do tribunal
-         * @description Retorna os feriados forenses estaduais de um tribunal dentro de uma janela de datas. O tribunal vai em `court`, pela sigla (`court=TJSP`) ou pelo apelido da fonte; `tribunalAlias` continua aceito como sinônimo. A janela vai em `from`/`to`, no formato AAAA-MM-DD. Feriados nacionais e o recesso de fim de ano (art. 220 do CPC) ficam a cargo do motor de prazos do próprio consumidor; este endpoint devolve a camada estadual que o tribunal acrescenta por cima, derivada da UF do tribunal.
+         * @description Retorna os dias em que o prazo não corre num tribunal dentro de uma janela de datas: os feriados nacionais, o Dia da Justiça (8/12) em todo tribunal, os feriados forenses que a lei federal dá à Justiça Federal e aos tribunais superiores, e que as justiças do Trabalho e Eleitoral adotam (segunda de Carnaval, Semana Santa de quarta a domingo, 11/8 e 1º/11), todos com `scope` NATIONAL, o recesso de fim de ano (art. 220 do CPC), os feriados estaduais da UF do tribunal e, com `municipalityIbgeCode`, os municipais da comarca. O tribunal vai em `court`, pela sigla (`court=TJSP`) ou pelo apelido da fonte; `tribunalAlias` continua aceito como sinônimo. A janela vai em `from`/`to`, no formato AAAA-MM-DD. Quando o tribunal transferiu um feriado por ato próprio e o motor conhece o ato, o feriado sai no dia que o ato fixa, com `transfer` dizendo de qual dia veio. `coverage` diz, camada a camada, o que esta resposta consultou.
          *
          *     **Escopo exigido na chave de API:** `TRIBUNALS_READ`
          */
@@ -159,7 +159,7 @@ export interface paths {
         };
         /**
          * Obter um processo pelo número
-         * @description Retorna o registro exato do processo para o tribunal e o número informados, com resolução cache-first quando disponível.
+         * @description Retorna o registro exato do processo para o tribunal e o número informados, com resolução cache-first quando disponível. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404.
          *
          *     **Escopo exigido na chave de API:** `PROCESSES_READ`
          */
@@ -203,7 +203,7 @@ export interface paths {
         };
         /**
          * Obter um snapshot vivo do processo
-         * @description Busca o hit exato do processo no upstream do CNJ e retorna o registro normalizado do processo, o payload bruto da fonte e as movimentações CNJ normalizadas.
+         * @description Busca o hit exato do processo no upstream do CNJ e retorna o registro normalizado do processo, o payload bruto da fonte e as movimentações CNJ normalizadas. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404.
          *
          *     **Escopo exigido na chave de API:** `PROCESSES_READ`
          */
@@ -269,7 +269,7 @@ export interface paths {
         };
         /**
          * Listar monitores
-         * @description Paginação keyset: passe em `cursor` o `meta.nextCursor` da resposta anterior. `officeScoped=true` restringe aos monitores atribuídos ao `X-Office-Id` da chamada. Os campos de alvo (`tribunalAlias`, `processNumber`, `oabNumber`, `oabState`, `term`, `partyName`) filtram pelo que o monitor vigia, nas mesmas grafias que a criação aceita — quem mantém um sensor por alvo pergunta pelo alvo em vez de paginar a conta inteira.
+         * @description Paginação keyset: passe em `cursor` o `meta.nextCursor` da resposta anterior. `officeScoped=true` restringe aos monitores atribuídos ao `X-Office-Id` da chamada. Os campos de alvo (`tribunalAlias`, `processNumber`, `oabNumber`, `oabState`, `term`, `partyName`, `partyDocument`) filtram pelo que o monitor vigia, nas mesmas grafias que a criação aceita — quem mantém um sensor por alvo pergunta pelo alvo em vez de paginar a conta inteira.
          *
          *     **Escopo exigido na chave de API:** `MONITORS_READ`
          */
@@ -277,7 +277,7 @@ export interface paths {
         put?: never;
         /**
          * Criar um monitor
-         * @description Cria um monitor PROCESS, OAB ou TERM. O motor varre as fontes na própria agenda: monitor OAB emite `PUBLICATION_CREATED` a cada publicação nova do advogado; monitor TERM vigia a edição diária do diário por um termo livre (mínimo 5 caracteres — piso da fonte —, casamento por palavra inteira, varredura nacional) e emite `PUBLICATION_CREATED` — com o campo `term` no payload — para cada menção compartilhável nova; monitor PROCESS emite `MONITOR_SYNC_SUCCEEDED` (com o campo `changed`) a cada varredura e `MONITOR_SYNC_FAILED` quando a varredura falha. Para ser notificado de movimentação nova de um processo, use POST /v1/subscriptions. **Vigília de aparição:** um monitor PROCESS cujo alvo a fonte ainda não indexou é aceito e fica esperando — `targetSeenAt: null` na resposta marca a espera, a varredura em espera emite `MONITOR_SYNC_SUCCEEDED` com `awaitingAppearance: true`, e a primeira aparição chega com `firstAppearance: true`. Informe `distributedAt` (AAAA-MM-DD, nunca no futuro; imutável depois de criado — corrigir a data é recriar o monitor) para a espera ter critério de parada: enquanto a data-limite do índice da fonte não alcança a data, o alvo nem é consultado; quando a ultrapassa com folga de 3 dias e nada apareceu, o monitor entra em ERROR — cadastro provavelmente errado — sem deixar de tentar. **Alvo já vigiado:** o monitor é único por alvo dentro da conta e do projeto, e o segundo pedido responde 409 `MONITOR_ALREADY_EXISTS` com `error.details.monitorId` — o id do que já está lá, para quem compõe sensor e assinatura seguir sem procurar na lista.
+         * @description Cria um monitor PROCESS, OAB, TERM, PARTY ou DOCUMENT. O motor varre as fontes na própria agenda: monitor OAB emite `PUBLICATION_CREATED` a cada publicação nova do advogado; monitor TERM vigia a edição diária do diário por um termo livre (mínimo 5 caracteres — piso da fonte —, casamento por palavra inteira, varredura nacional) e emite `PUBLICATION_CREATED` — com o campo `term` no payload — para cada menção compartilhável nova; monitor PARTY vigia pelo nome de parte no cadastro da publicação e emite `PUBLICATION_CREATED` com `partyName` e `partyRole`; monitor DOCUMENT vigia pelo CNPJ no TEOR (`partyDocument`, nos 14 dígitos ou pontuado — normalizado para a grafia pontuada, a única que o teor escreve) e emite `PUBLICATION_CREATED` com `partyDocument`, `includeBranches` e `matchedBy: "document"` — a empresa foi citada no ato, seja ou não parte, o que alcança a decisão que manda citá-la antes de ela figurar nos destinatários; `includeBranches: true` vigia a raiz de 8 dígitos e alcança matriz e filiais (muda a contagem; nunca é o padrão). TERM, PARTY e DOCUMENT dividem a mesma vaga do plano. Monitor PROCESS emite `MONITOR_SYNC_SUCCEEDED` (com o campo `changed`) a cada varredura — cadência de 15 minutos, até 96 por dia por monitor, quase todos sem novidade — e `MONITOR_SYNC_FAILED` quando a varredura falha. Para ser notificado de movimentação nova de um processo, use POST /v1/subscriptions. **Vigília de aparição:** um monitor PROCESS cujo alvo a fonte ainda não indexou é aceito e fica esperando — `targetSeenAt: null` na resposta marca a espera, a varredura em espera emite `MONITOR_SYNC_SUCCEEDED` com `awaitingAppearance: true`, e a primeira aparição chega com `firstAppearance: true`. Informe `distributedAt` (AAAA-MM-DD, nunca no futuro; imutável depois de criado — corrigir a data é recriar o monitor) para a espera ter critério de parada: enquanto a data-limite do índice da fonte não alcança a data, o alvo nem é consultado; quando a ultrapassa com folga de 3 dias e nada apareceu, o monitor entra em ERROR — cadastro provavelmente errado — sem deixar de tentar. **Alvo já vigiado:** o monitor é único por alvo dentro da conta e do projeto, e o segundo pedido responde 409 `MONITOR_ALREADY_EXISTS` com `error.details.monitorId` — o id do que já está lá, para quem compõe sensor e assinatura seguir sem procurar na lista.
          *
          *     **Escopo exigido na chave de API:** `MONITORS_WRITE`
          */
@@ -497,7 +497,7 @@ export interface paths {
         };
         /**
          * Listar publicações
-         * @description Retorna as publicações que casam com os filtros informados. Uma consulta com escopo de processo é lake-first e incremental: a primeira busca faz a captura completa no DJEN e grava no data lake; as seguintes buscam apenas o delta desde a publicação mais recente conhecida e servem as linhas consolidadas do lake. `text`, `partyName` e `lawyerName` filtram na própria fonte; os matches de `text` são adicionalmente revalidados localmente com fronteira de palavra, então itens cujo conteúdo só casa por substring são descartados (`total` permanece a contagem reportada pela fonte). **Antes de concluir que uma publicação não existe, leia `sourceIndex.lastEditionDate`:** é a última edição do diário que o motor detectou no ar. O diário publica uma edição por dia útil, e `total: 0` sem a edição do dia detectada significa *ainda não saiu*, não *não existe*. A prova vale numa direção só: edição detectada NÃO garante o índice do dia completo — ele continua recebendo itens ao longo do dia, então um zero com a edição de hoje no ar ainda pode virar publicação horas depois. O campo acompanha toda resposta, sem custo adicional.
+         * @description Retorna as publicações que casam com os filtros informados. Uma consulta com escopo de processo é lake-first e incremental: a primeira busca faz a captura completa na fonte e grava no data lake; as seguintes buscam apenas o delta desde a publicação mais recente conhecida e servem as linhas consolidadas do lake. `text`, `partyName`, `lawyerName` e `partyDocument` filtram na própria fonte; os matches de `text` são adicionalmente revalidados localmente com fronteira de palavra, então itens cujo conteúdo só casa por substring são descartados (`total` permanece a contagem reportada pela fonte). **Os três eixos de empresa se completam:** `partyName` casa por continência de palavras e acha as irmãs de uma família de razões sociais; `lawyerName` confirma quais pertencem ao mesmo grupo, porque o corpo de procuradores é compartilhado; `partyDocument` — o CNPJ nos 14 dígitos ou pontuado, normalizado para `NN.NNN.NNN/NNNN-NN` — casa o documento no TEOR e acha a empresa citada no ato (mandada citar, garantidora, penhorada) antes de ela figurar como parte. A reconfirmação local por documento é substring literal, e cada item assim casado vem com `matchedBy: "document"`; compare com `parties` para saber se a empresa já é parte. `includeBranches=true` busca pela raiz de 8 dígitos e alcança matriz e filiais — opção declarada, porque muda a contagem; nunca é o padrão. `partyDocument` não se combina com `text`. Um CPF em qualquer desses campos é recusado com `PERSONAL_DOCUMENT_QUERY_NOT_ALLOWED`. **Antes de concluir que uma publicação não existe, leia `sourceIndex.lastEditionDate`:** é a última edição do diário que o motor detectou no ar. O diário publica uma edição por dia útil, e `total: 0` sem a edição do dia detectada significa *ainda não saiu*, não *não existe*. A prova vale numa direção só: edição detectada NÃO garante o índice do dia completo — ele continua recebendo itens ao longo do dia, então um zero com a edição de hoje no ar ainda pode virar publicação horas depois. O campo acompanha toda resposta, sem custo adicional.
          *
          *     **Escopo exigido na chave de API:** `PUBLICATIONS_READ`
          */
@@ -757,7 +757,7 @@ export interface paths {
         };
         /**
          * Consultar o uso do projeto da API key atual
-         * @description Retorna o uso do período, os créditos restantes, métricas de uso agrupadas e os eventos de uso recentes da conta e do projeto autenticados. `byOffice` reparte o consumo pelos valores de `X-Office-Id` que as requisições informaram — é o recorte para repassar custo a sub-contas. A entrada com `officeId: null` reúne o que nenhuma requisição atribuiu mais o trabalho recorrente (varredura de monitor, entrega de webhook), então a soma das partes fecha com o total.
+         * @description Retorna o uso do período, os créditos restantes, métricas de uso agrupadas e os eventos de uso recentes da conta e do projeto autenticados. `byOffice` reparte o consumo pelos valores de `X-Office-Id` que as requisições informaram — é o recorte para repassar custo a sub-contas. A entrada com `officeId: null` reúne o que nenhuma requisição atribuiu mais o trabalho recorrente (varredura de monitor, entrega de webhook), então a soma das partes fecha com o total. `subTenantLimit` é quantos sub-tenants o plano admite por período (nulo é sem teto) e `subTenantsUsed` quantos já receberam requisição no período da conta inteira — um office novo além do teto é recusado com 403 `SUB_TENANT_LIMIT_EXCEEDED`; os já atendidos passam sempre.
          *
          *     **Escopo exigido na chave de API:** `USAGE_READ`
          */
@@ -814,6 +814,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/webhooks/unsubscribed-event-types": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Tipos de evento que a conta produz e nenhum receptor assina
+         * @description Os tipos de evento que a conta produziu nos últimos 30 dias e que nenhum endpoint ativo assina — com a contagem, o último instante e a classe: `DATA` é o produto (movimentação, publicação, achado, busca ou colheita concluída) e `OPERATIONAL` é sinal sobre a operação (`MONITOR_SYNC_FAILED` e os avisos comerciais). Um evento nasce como registro mesmo sem assinante e fica disponível por 180 dias: para fechar a lacuna, assine o tipo no endpoint (`PATCH /v1/webhooks/endpoints/{endpointId}`) e reenvie a janela (`POST /v1/webhooks/endpoints/{endpointId}/replay`) — nada é assinado nem reenviado sozinho. `MONITOR_SYNC_SUCCEEDED` nunca aparece aqui: é o sinal de vida da vigília, sai a cada varredura e não assiná-lo é a escolha esperada. O endpoint suspenso pelo motor conta como assinante; o pausado pelo dono, não. Os tipos operacionais dispensados no portal vêm em `dismissed`. A lacuna é medida por conta: qualquer endpoint ativo da conta conta como assinante, independentemente do projeto a que ele se limite. Custa 0 créditos.
+         *
+         *     **Escopo exigido na chave de API:** `EVENTS_READ`
+         */
+        get: operations["listUnsubscribedEventTypes"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/events": {
         parameters: {
             query?: never;
@@ -925,7 +947,7 @@ export interface paths {
         put?: never;
         /**
          * Disparar uma entrega de teste
-         * @description Envia na hora, de forma síncrona, uma entrega sintética assinada (type `WEBHOOK_TEST`) ao endpoint e responde com o resultado: alcançou o receptor? Qual status HTTP voltou? Nada é gravado na fila — é a forma de validar conectividade e verificação de assinatura antes do primeiro evento real. Endpoint de outra conta responde 404.
+         * @description Envia na hora, de forma síncrona, uma entrega sintética assinada (type `WEBHOOK_TEST`) ao endpoint e responde com o resultado: alcançou o receptor? Qual status HTTP voltou? Nada é gravado na fila e nada conta como entrega: o desfecho fica carimbado no próprio receptor (`lastTestAt`, `lastTestStatus`, `lastTestError`, visíveis em `GET /v1/webhooks/endpoints` e `GET /v1/webhooks/health`), sem tocar na série de recusas nem na suspensão. É a forma de validar conectividade e verificação de assinatura antes do primeiro evento real. Endpoint de outra conta responde 404.
          *
          *     **Escopo exigido na chave de API:** `WEBHOOKS_WRITE`
          */
@@ -1181,6 +1203,10 @@ export interface operations {
                             /** @enum {string} */
                             status: "OPERATIONAL" | "DEGRADED" | "OUTAGE" | "NO_SIGNAL";
                             detail: string;
+                            /** @description Quando esta capacidade leu a fonte com sucesso pela última vez, ISO. Nulo quando não houve leitura na janela medida — o que é silêncio, não queda. */
+                            lastReadAt: string | null;
+                            /** @description Até quando o conteúdo da fonte está lido, no recorte que a capacidade serve (AAAA-MM-DD). É a data com que se escreve 'nada encontrado' sem mentir: o que é posterior a ela ainda não chegou. Nulo na capacidade que não tem data de conteúdo para o acervo inteiro — ali a data vem com o recorte, na própria resposta da consulta. */
+                            readThrough: string | null;
                         }[];
                     };
                 };
@@ -1221,6 +1247,12 @@ export interface operations {
                                 segment: number;
                                 code: number;
                             } | null;
+                            processIndex: {
+                                /** Format: date-time */
+                                updatedThrough: string | null;
+                                /** Format: date-time */
+                                checkedAt: string;
+                            } | null;
                         }[];
                         meta: {
                             /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
@@ -1456,6 +1488,13 @@ export interface operations {
                                 label: string;
                                 uf: string | null;
                                 municipalityIbgeCode?: number;
+                                /** @description Presente quando o tribunal transferiu o feriado por ato próprio: date é o dia em que o tribunal o observa, fromDate o dia que a lei fixa (que não sai na lista), e act e url o ato e onde ele foi lido. */
+                                transfer?: {
+                                    fromDate: string;
+                                    act: string;
+                                    /** Format: uri */
+                                    url: string;
+                                };
                             }[];
                             coverage: {
                                 /** @enum {string} */
@@ -2002,6 +2041,8 @@ export interface operations {
             query: {
                 tribunalAlias: string;
                 since?: unknown;
+                /** @description Quanto esperar pela fonte processual quando o processo precisa ser buscado nela, em segundos: de 10 a 180, padrão 20. É o teto da consulta à fonte: ela às vezes leva até ~60 s por consulta, cada ida a ela espera no máximo 60 s, e a segunda ida só sai depois de uma recusa por volume ou de um erro da fonte, nunca depois de tempo esgotado. Depois dela, a ficha ainda espera até 10 s pelo resumo das publicações do processo. Tempo esgotado é 504 `UPSTREAM_TIMEOUT` (lentidão, não ausência). Dê ao seu cliente HTTP um tempo limite que cubra a espera, esses segundos da ficha e a rede: no padrão, mais de 30 s. */
+                waitSeconds?: number;
             };
             header?: {
                 /** @description Identificador da requisição escolhido pelo cliente, ecoado em meta.requestId e no corpo de erro. Tem DOIS papéis: (1) rastreio, em toda rota — é por ele que o suporte encontra a chamada; (2) idempotência por conta em POST /v1/publications/text-searches e POST /v1/search-jobs, onde reenviar o mesmo valor reapresenta o resultado já produzido, sem nova cobrança. Fora dessas duas rotas o valor não deduplica nada: para repetir uma chamada de propósito, mande um valor novo. Aceita [A-Za-z0-9_.:-], até 200 caracteres; valor fora disso é ignorado e o motor cunha o próprio. */
@@ -2081,6 +2122,15 @@ export interface operations {
                             requestId: string;
                             credits?: number;
                             cacheHit?: boolean;
+                            /** @description Presente só quando a fonte respondeu com parte do índice e o processo estava na parte que respondeu: outra instância do mesmo número, se existir, pode não ter vindo. */
+                            partialIndex?: {
+                                /** @description Partes do índice da fonte que não responderam. */
+                                shardsFailed: number;
+                                /** @description Total de partes do índice; nulo quando a fonte não as contou. */
+                                shardsTotal: number | null;
+                                /** @description A fonte estourou o próprio prazo interno e devolveu só o que deu tempo de olhar. */
+                                timedOut: boolean;
+                            };
                         } & {
                             [key: string]: unknown;
                         };
@@ -2612,6 +2662,8 @@ export interface operations {
             query: {
                 tribunalAlias: string;
                 since?: unknown;
+                /** @description Quanto esperar pela fonte processual quando o processo precisa ser buscado nela, em segundos: de 10 a 180, padrão 20. É o teto da consulta à fonte: ela às vezes leva até ~60 s por consulta, cada ida a ela espera no máximo 60 s, e a segunda ida só sai depois de uma recusa por volume ou de um erro da fonte, nunca depois de tempo esgotado. Depois dela, a ficha ainda espera até 10 s pelo resumo das publicações do processo. Tempo esgotado é 504 `UPSTREAM_TIMEOUT` (lentidão, não ausência). Dê ao seu cliente HTTP um tempo limite que cubra a espera, esses segundos da ficha e a rede: no padrão, mais de 30 s. */
+                waitSeconds?: number;
             };
             header?: {
                 /** @description Identificador da requisição escolhido pelo cliente, ecoado em meta.requestId e no corpo de erro. Tem DOIS papéis: (1) rastreio, em toda rota — é por ele que o suporte encontra a chamada; (2) idempotência por conta em POST /v1/publications/text-searches e POST /v1/search-jobs, onde reenviar o mesmo valor reapresenta o resultado já produzido, sem nova cobrança. Fora dessas duas rotas o valor não deduplica nada: para repetir uma chamada de propósito, mande um valor novo. Aceita [A-Za-z0-9_.:-], até 200 caracteres; valor fora disso é ignorado e o motor cunha o próprio. */
@@ -2703,6 +2755,15 @@ export interface operations {
                             requestId: string;
                             credits?: number;
                             cacheHit?: boolean;
+                            /** @description Presente só quando a fonte respondeu com parte do índice e o processo estava na parte que respondeu: outra instância do mesmo número, se existir, pode não ter vindo. */
+                            partialIndex?: {
+                                /** @description Partes do índice da fonte que não responderam. */
+                                shardsFailed: number;
+                                /** @description Total de partes do índice; nulo quando a fonte não as contou. */
+                                shardsTotal: number | null;
+                                /** @description A fonte estourou o próprio prazo interno e devolveu só o que deu tempo de olhar. */
+                                timedOut: boolean;
+                            };
                         } & {
                             [key: string]: unknown;
                         };
@@ -3490,7 +3551,7 @@ export interface operations {
                 cursor?: string;
                 limit?: number;
                 status?: "ACTIVE" | "PAUSED" | "DISABLED" | "ERROR";
-                type?: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                type?: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                 officeScoped?: "true" | "false";
                 tribunalAlias?: string;
                 processNumber?: string;
@@ -3498,6 +3559,7 @@ export interface operations {
                 oabState?: string;
                 term?: string;
                 partyName?: string;
+                partyDocument?: string;
             };
             header?: {
                 /** @description Identificador da requisição escolhido pelo cliente, ecoado em meta.requestId e no corpo de erro. Tem DOIS papéis: (1) rastreio, em toda rota — é por ele que o suporte encontra a chamada; (2) idempotência por conta em POST /v1/publications/text-searches e POST /v1/search-jobs, onde reenviar o mesmo valor reapresenta o resultado já produzido, sem nova cobrança. Fora dessas duas rotas o valor não deduplica nada: para repetir uma chamada de propósito, mande um valor novo. Aceita [A-Za-z0-9_.:-], até 200 caracteres; valor fora disso é ignorado e o motor cunha o próprio. */
@@ -3520,7 +3582,7 @@ export interface operations {
                         data: ({
                             id: string;
                             /** @enum {string} */
-                            type: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                            type: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                             /** @enum {string} */
                             status: "ACTIVE" | "PAUSED" | "DISABLED" | "ERROR";
                             label?: string | null;
@@ -3531,6 +3593,7 @@ export interface operations {
                             oabState?: string | null;
                             term?: string | null;
                             partyName?: string | null;
+                            partyDocument?: string | null;
                             /** Format: date-time */
                             lastCheckedAt?: string | null;
                             /** Format: date-time */
@@ -3763,7 +3826,7 @@ export interface operations {
             content: {
                 "application/json": {
                     /** @enum {string} */
-                    type: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                    type: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                     label?: string;
                     tribunalAlias?: string;
                     processNumber?: string;
@@ -3771,6 +3834,10 @@ export interface operations {
                     oabState?: string;
                     term?: string;
                     partyName?: string;
+                    /** @description CNPJ vigiado no teor, nos 14 dígitos ou pontuado; normalizado para NN.NNN.NNN/NNNN-NN. CPF é recusado. */
+                    partyDocument?: string;
+                    /** @description Com true, busca pela raiz de 8 dígitos do CNPJ (NN.NNN.NNN) e alcança a matriz e todas as filiais; muda a contagem. Padrão false: só o estabelecimento informado. */
+                    includeBranches?: boolean;
                     distributedAt?: string;
                 };
             };
@@ -3786,7 +3853,7 @@ export interface operations {
                         data: {
                             id: string;
                             /** @enum {string} */
-                            type: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                            type: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                             /** @enum {string} */
                             status: "ACTIVE" | "PAUSED" | "DISABLED" | "ERROR";
                             label?: string | null;
@@ -3797,6 +3864,7 @@ export interface operations {
                             oabState?: string | null;
                             term?: string | null;
                             partyName?: string | null;
+                            partyDocument?: string | null;
                             /** Format: date-time */
                             lastCheckedAt?: string | null;
                             /** Format: date-time */
@@ -4277,7 +4345,7 @@ export interface operations {
                         data: {
                             id: string;
                             /** @enum {string} */
-                            type: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                            type: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                             /** @enum {string} */
                             status: "ACTIVE" | "PAUSED" | "DISABLED" | "ERROR";
                             label?: string | null;
@@ -4288,6 +4356,7 @@ export interface operations {
                             oabState?: string | null;
                             term?: string | null;
                             partyName?: string | null;
+                            partyDocument?: string | null;
                             /** Format: date-time */
                             lastCheckedAt?: string | null;
                             /** Format: date-time */
@@ -4818,7 +4887,7 @@ export interface operations {
                         data: {
                             id: string;
                             /** @enum {string} */
-                            type: "PROCESS" | "OAB" | "TERM" | "PARTY";
+                            type: "PROCESS" | "OAB" | "TERM" | "PARTY" | "DOCUMENT";
                             /** @enum {string} */
                             status: "ACTIVE" | "PAUSED" | "DISABLED" | "ERROR";
                             label?: string | null;
@@ -4829,6 +4898,7 @@ export interface operations {
                             oabState?: string | null;
                             term?: string | null;
                             partyName?: string | null;
+                            partyDocument?: string | null;
                             /** Format: date-time */
                             lastCheckedAt?: string | null;
                             /** Format: date-time */
@@ -7091,6 +7161,10 @@ export interface operations {
                 text?: string;
                 partyName?: string;
                 lawyerName?: string;
+                /** @description CNPJ citado no teor, nos 14 dígitos ou pontuado; normalizado para NN.NNN.NNN/NNNN-NN. Acha a empresa citada no ato antes de ela ser parte. CPF é recusado. */
+                partyDocument?: string;
+                /** @description Com true, busca pela raiz de 8 dígitos do CNPJ (NN.NNN.NNN) e alcança a matriz e todas as filiais; muda a contagem. Padrão false: só o estabelecimento informado. */
+                includeBranches?: boolean;
                 availableFrom?: string;
                 availableTo?: string;
                 page?: number;
@@ -7162,6 +7236,11 @@ export interface operations {
                                 /** @description Órgão julgador da publicação, como a fonte o escreve. Presente nos dois eixos; `null` quando a fonte não o declara. */
                                 courtBody?: string | null;
                                 shareable?: boolean;
+                                /**
+                                 * @description Como o item casou a consulta por documento: `document` = o CNPJ consta no teor, a empresa foi citada no ato. Compare com `parties` para saber se ela já figura como parte.
+                                 * @enum {string}
+                                 */
+                                matchedBy?: "document";
                                 rawPayload?: unknown;
                             }[];
                             sourceItemCount?: number;
@@ -7729,6 +7808,11 @@ export interface operations {
                                     /** @description Órgão julgador da publicação, como a fonte o escreve. Presente nos dois eixos; `null` quando a fonte não o declara. */
                                     courtBody?: string | null;
                                     shareable?: boolean;
+                                    /**
+                                     * @description Como o item casou a consulta por documento: `document` = o CNPJ consta no teor, a empresa foi citada no ato. Compare com `parties` para saber se ela já figura como parte.
+                                     * @enum {string}
+                                     */
+                                    matchedBy?: "document";
                                 } & {
                                     [key: string]: unknown;
                                 }) | null;
@@ -8086,6 +8170,11 @@ export interface operations {
                                     /** @description Órgão julgador da publicação, como a fonte o escreve. Presente nos dois eixos; `null` quando a fonte não o declara. */
                                     courtBody?: string | null;
                                     shareable?: boolean;
+                                    /**
+                                     * @description Como o item casou a consulta por documento: `document` = o CNPJ consta no teor, a empresa foi citada no ato. Compare com `parties` para saber se ela já figura como parte.
+                                     * @enum {string}
+                                     */
+                                    matchedBy?: "document";
                                 } & {
                                     [key: string]: unknown;
                                 }) | null;
@@ -9888,6 +9977,11 @@ export interface operations {
                                 /** @description Órgão julgador da publicação, como a fonte o escreve. Presente nos dois eixos; `null` quando a fonte não o declara. */
                                 courtBody?: string | null;
                                 shareable?: boolean;
+                                /**
+                                 * @description Como o item casou a consulta por documento: `document` = o CNPJ consta no teor, a empresa foi citada no ato. Compare com `parties` para saber se ela já figura como parte.
+                                 * @enum {string}
+                                 */
+                                matchedBy?: "document";
                             } & {
                                 [key: string]: unknown;
                             };
@@ -11003,6 +11097,8 @@ export interface operations {
                                 backgroundWork: number;
                                 credits: number;
                             }[];
+                            subTenantLimit: number | null;
+                            subTenantsUsed: number;
                             recentEvents: {
                                 requestId: string;
                                 kind: string;
@@ -11012,6 +11108,10 @@ export interface operations {
                                 credits: number;
                                 /** Format: date-time */
                                 createdAt: string;
+                                /** @description O código do erro que recusou a requisição ou o trabalho de fundo. Ausente quando foi servido. */
+                                errorCode?: string;
+                                /** @description Num 400 de validação, os campos recusados em notação de ponto (`root` é o corpo ou a query inteira). Só o nome do campo, nunca o valor enviado. */
+                                fieldPaths?: string[];
                             }[];
                         };
                         meta: {
@@ -11247,6 +11347,10 @@ export interface operations {
                                 suspendedAt: string | null;
                                 /** Format: date-time */
                                 oldestPendingAt: string | null;
+                                /** Format: date-time */
+                                lastTestAt: string | null;
+                                lastTestStatus: number | null;
+                                lastTestError: string | null;
                             } & {
                                 [key: string]: unknown;
                             })[];
@@ -11685,6 +11789,242 @@ export interface operations {
             };
         };
     };
+    listUnsubscribedEventTypes: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Identificador da requisição escolhido pelo cliente, ecoado em meta.requestId e no corpo de erro. Tem DOIS papéis: (1) rastreio, em toda rota — é por ele que o suporte encontra a chamada; (2) idempotência por conta em POST /v1/publications/text-searches e POST /v1/search-jobs, onde reenviar o mesmo valor reapresenta o resultado já produzido, sem nova cobrança. Fora dessas duas rotas o valor não deduplica nada: para repetir uma chamada de propósito, mande um valor novo. Aceita [A-Za-z0-9_.:-], até 200 caracteres; valor fora disso é ignorado e o motor cunha o próprio. */
+                "x-request-id"?: string;
+                /** @description Atribui a chamada a um sub-tenant seu (por exemplo, um escritório) na medição de uso e no roteamento de eventos. Opcional. */
+                "x-office-id"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Resposta padrão */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        data: {
+                            windowDays: number;
+                            items: ({
+                                /** @enum {string} */
+                                type: "PROCESS_MOVEMENT_CREATED" | "PUBLICATION_CREATED" | "MONITOR_SYNC_SUCCEEDED" | "MONITOR_SYNC_FAILED" | "SEARCH_JOB_COMPLETED" | "PUBLICATION_TEXT_ALERT_MATCHED" | "PUBLICATION_HARVEST_COMPLETED" | "QUOTA_LOW" | "PERIOD_ENDING" | "SUBSCRIPTION_PAST_DUE";
+                                /** @enum {string} */
+                                class: "DATA" | "OPERATIONAL";
+                                count: number;
+                                /** Format: date-time */
+                                lastOccurredAt: string;
+                            } & {
+                                [key: string]: unknown;
+                            })[];
+                            dismissed: ({
+                                /** @enum {string} */
+                                type: "PROCESS_MOVEMENT_CREATED" | "PUBLICATION_CREATED" | "MONITOR_SYNC_SUCCEEDED" | "MONITOR_SYNC_FAILED" | "SEARCH_JOB_COMPLETED" | "PUBLICATION_TEXT_ALERT_MATCHED" | "PUBLICATION_HARVEST_COMPLETED" | "QUOTA_LOW" | "PERIOD_ENDING" | "SUBSCRIPTION_PAST_DUE";
+                                /** Format: date-time */
+                                dismissedAt: string;
+                            } & {
+                                [key: string]: unknown;
+                            })[];
+                        };
+                        meta: {
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            credits?: number;
+                            cacheHit?: boolean;
+                        } & {
+                            [key: string]: unknown;
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+            /** @description Resposta padrão */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        error: {
+                            /** @description Código estável da taxonomia (VALIDATION_ERROR, QUOTA_EXCEEDED, UPSTREAM_TIMEOUT…). É por ele que se programa, não pela mensagem. */
+                            code: string;
+                            /** @description Descrição legível, sujeita a mudança. */
+                            message: string;
+                            /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
+                            requestId: string;
+                            /**
+                             * @description Classificação da falha. TERMINAL não melhora com nova tentativa; RETRYABLE sim.
+                             * @enum {string}
+                             */
+                            class: "RETRYABLE" | "TERMINAL";
+                            /** @description Atalho booleano de `class`, para quem só precisa decidir se repete. */
+                            retryable: boolean;
+                            /** @description Status HTTP real devolvido pela fonte externa, quando a falha veio dela. Preservado sem tradução. */
+                            upstreamStatus?: number;
+                            details: {
+                                [key: string]: unknown;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
     listEvents: {
         parameters: {
             query?: {
@@ -11725,6 +12065,8 @@ export interface operations {
                             deliveries: {
                                 total: number;
                                 delivered: number;
+                                failed: number;
+                                pending: number;
                             };
                         } & {
                             [key: string]: unknown;
@@ -11956,6 +12298,8 @@ export interface operations {
                             deliveries: {
                                 total: number;
                                 delivered: number;
+                                failed: number;
+                                pending: number;
                             };
                         } & {
                             [key: string]: unknown;
@@ -12212,10 +12556,20 @@ export interface operations {
                             isActive: boolean;
                             /** Format: date-time */
                             suspendedAt: string | null;
+                            /** Format: date-time */
+                            lastTestAt: string | null;
+                            lastTestStatus: number | null;
+                            lastTestError: string | null;
                             project: {
                                 id: string;
                                 name: string;
                             } | null;
+                            reach: {
+                                /** @enum {string} */
+                                scope: "ACCOUNT" | "PROJECT";
+                                projects: number;
+                                includesFutureProjects: boolean;
+                            };
                         }[];
                         meta: {
                             /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */
@@ -12452,10 +12806,20 @@ export interface operations {
                                 isActive: boolean;
                                 /** Format: date-time */
                                 suspendedAt: string | null;
+                                /** Format: date-time */
+                                lastTestAt: string | null;
+                                lastTestStatus: number | null;
+                                lastTestError: string | null;
                                 project: {
                                     id: string;
                                     name: string;
                                 } | null;
+                                reach: {
+                                    /** @enum {string} */
+                                    scope: "ACCOUNT" | "PROJECT";
+                                    projects: number;
+                                    includesFutureProjects: boolean;
+                                };
                             };
                             signingSecret: string;
                         };
@@ -12915,10 +13279,20 @@ export interface operations {
                             isActive: boolean;
                             /** Format: date-time */
                             suspendedAt: string | null;
+                            /** Format: date-time */
+                            lastTestAt: string | null;
+                            lastTestStatus: number | null;
+                            lastTestError: string | null;
                             project: {
                                 id: string;
                                 name: string;
                             } | null;
+                            reach: {
+                                /** @enum {string} */
+                                scope: "ACCOUNT" | "PROJECT";
+                                projects: number;
+                                includesFutureProjects: boolean;
+                            };
                         };
                         meta: {
                             /** @description Identificador da requisição, para suporte e rastreamento. É o X-Request-Id enviado pelo cliente quando há um; senão, um req_<uuid> cunhado pelo motor. */