@zihin/agent-client 0.8.0 → 0.9.0

package/README.md

@@ -448,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