@zihin/agent-client 0.7.0 → 0.9.0

package/README.md

@@ -23,7 +23,8 @@ simples, e oferece **dois estilos** de invocação:
 npm install @zihin/agent-client
 ```
 
-Requer Node >= 18 (usa `fetch`/`ReadableStream` globais).
+Requer Node >= 20.16 (usa `fetch`/`ReadableStream` globais; o `signRequest` do build ESM usa
+`process.getBuiltinModule`, 20.16+). Node 18 saiu de suporte em 04/2025 e deixou de ser testado a partir da 0.8.
 
 ## Uso — caminho direto
 
@@ -418,7 +419,7 @@ correlacionar com o console.
   `delayMs`/`reason`/`status`) e `onError(err)` — chamado quando uma operação falha em definitivo
   (inclusive `aborted`; filtre por `err.kind`). Exceção lançada dentro do hook é engolida e nunca
   mascara o erro original.
-- **`fetch` injetável** — `fetch?` na config; por padrão usa `globalThis.fetch` (Node ≥18). Um
+- **`fetch` injetável** — `fetch?` na config; por padrão usa `globalThis.fetch` (Node ≥20.16). Um
   preflight dá erro `config` claro se não houver fetch.
 - **Portável** — sem `Buffer`; `node:crypto` só é carregado se você usar `signRequest`. Roda em Node;
   para edge/serverless, injete `fetch` se necessário. O pacote publica **CJS e ESM** (`exports` map):
@@ -447,6 +448,29 @@ const zihin = createClient({
 > um host que **resolva** para IP privado (DNS rebinding) passa. Isto não substitui bloqueio de
 > egresso na borda de rede — mantenha o whitelist (default) em ambiente sensível.
 
+## Runtime injetável (`@zihin/agent-client/core`)
+
+O entry principal já usa os timers globais e `process.emitWarning` — nada muda para quem importa
+`@zihin/agent-client`. O entry `@zihin/agent-client/core` é o mesmo núcleo **sem** essas
+referências globais, para hosts que as proíbem no código publicado (o scanner de nó verificado do
+n8n reprova `setTimeout`, `globalThis`, `process` e `console`). Ali o cliente exige `runtime`:
+
+```ts
+import { createClient } from '@zihin/agent-client/core';
+import { sleepWithAbort } from 'n8n-workflow';
+
+const zihin = createClient({
+  apiKey,
+  runtime: {
+    sleep: sleepWithAbort,               // backoff entre tentativas e relógio do deadline
+    warn: (code, msg) => logger.warn(`[${code}] ${msg}`), // opcional; ausente = silencioso
+  },
+});
+```
+
+`sleep(ms, signal)` deve resolver após `ms`, rejeitar se `signal` abortar e manter o processo vivo
+enquanto pendente. Qualquer rejeição vira `ZihinAgentError` com `kind: 'aborted'`.
+
 ## Segurança
 
 Reusa as primitivas de `security.ts`: validação SSRF da base URL (whitelist Zihin por padrão; libere