@botozap/sdk 0.3.2 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +47 -1
- package/dist/index.cjs +5205 -6
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3074 -2
- package/dist/index.d.ts +3074 -2
- package/dist/index.js +5167 -5
- package/dist/index.js.map +1 -1
- package/package.json +7 -8
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# @botozap/sdk
|
|
2
2
|
|
|
3
|
+
## 0.4.0
|
|
4
|
+
|
|
5
|
+
> Candidata ainda não publicada no npm (#498); a publicação depende de autorização explícita.
|
|
6
|
+
|
|
7
|
+
### Minor Changes
|
|
8
|
+
|
|
9
|
+
- Add complete shared saved replies, Inbox notes/reminders/operator state, CRM opportunities and demands, Radar stage criteria and appointment alerts, journey configuration and run control, appointment scheduling and Google Calendar operations, and complete BYOK AI agents with versioned configuration, provider credentials, knowledge, memory, skills, follow-up graphs, routing, cases, alerts, notices, reviewed proposals, executions and usage. Add contact stage/field discovery and complete assignment management in CLI/MCP. Preserve server CAS, pagination, idempotency and account identity boundaries. Previously published methods remain available. The unpublished legacy agents draft is replaced by /ai; no managed credits or paid agent slots. Include #498 agent parity: commercial proposals, eligibility gate with explicit open-to-all confirmation, inference ledger, operator promises, knowledge diagnostics/catalog sync/citations/coverage, memory reactivation, skill near-miss curation, notice diagnostics, provider catalog snapshots, case timeline, bulk alert resolution, promised returns, the unified follow-up queue, capability usage, the evolution panel, style adjustments and the additive execution security trail; granular BYOK purposes, extended agent configuration and 20 MiB direct document uploads. Contacts accept `tags` on create, `tags`/`add_tags`/`remove_tags` on update and return `tags` (up to 20 × 40 characters).
|
|
10
|
+
|
|
3
11
|
## 0.3.2
|
|
4
12
|
|
|
5
13
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -258,7 +258,10 @@ Passe um `AbortSignal` quando a leitura fizer parte de um tail cancelável:
|
|
|
258
258
|
|
|
259
259
|
```ts
|
|
260
260
|
const controller = new AbortController();
|
|
261
|
-
const page = await boto.events.list({
|
|
261
|
+
const page = await boto.events.list({
|
|
262
|
+
after: ultimoCursor,
|
|
263
|
+
signal: controller.signal,
|
|
264
|
+
});
|
|
262
265
|
controller.abort(); // interrompe o I/O se a assinatura deixou de existir
|
|
263
266
|
```
|
|
264
267
|
|
|
@@ -308,3 +311,46 @@ Exemplos mínimos e rodáveis na raiz do monorepo, em [`examples/`](../../exampl
|
|
|
308
311
|
## Licença
|
|
309
312
|
|
|
310
313
|
MIT
|
|
314
|
+
|
|
315
|
+
## Atendimento, CRM e Agenda
|
|
316
|
+
|
|
317
|
+
Recursos tipados: `savedReplies`, `inbox`, `opportunities`, `demands`, `radar`,
|
|
318
|
+
`journeys`, `appointments` (inclui `services`, `schedules`, `exceptions`),
|
|
319
|
+
`calendar`, `contactStages` e `contactFields`. As edições preservam os campos CAS
|
|
320
|
+
exigidos pela API. Notas internas nunca enviam mensagem ao contato; rascunhos e
|
|
321
|
+
respostas pessoais pertencem à sessão do Painel. Autorize Google Calendar no
|
|
322
|
+
Painel antes de gerenciar conexões pelo SDK.
|
|
323
|
+
|
|
324
|
+
Exemplo: `client.savedReplies.update(id, { body, expected_updated_at: row.updated_at })`.
|
|
325
|
+
Não arredonde `updated_at`: preserve a precisão recebida do servidor.
|
|
326
|
+
Criação de compromisso aceita segundo argumento `{ idempotencyKey: 'chave-estavel' }`.
|
|
327
|
+
[Contratos, exemplos e roteiro de release](https://github.com/bytecraft-fernando/botozap-js/blob/main/docs/attendance-release.md).
|
|
328
|
+
|
|
329
|
+
IA usa exclusivamente credenciais próprias (BYOK): SDK `client.ai`, CLI `botozap ai`
|
|
330
|
+
e ferramentas MCP `ai_*`. Agentes versionados, provedores, credenciais, conhecimento,
|
|
331
|
+
memória, skills, follow-ups e retornos prometidos, roteadores, casos, alertas,
|
|
332
|
+
avisos, propostas de aprendizado e comerciais, controle de acesso (elegibilidade),
|
|
333
|
+
inferências, promessas do operador, catálogo de modelos, execuções e uso. Scopes
|
|
334
|
+
`agents:read/write`; aprovação exige chave criada por
|
|
335
|
+
owner/admin ainda autorizado. Prévia não envia WhatsApp. Não há carteira, créditos
|
|
336
|
+
ou compra de vagas de IA. [Contratos e exemplos IA](https://github.com/bytecraft-fernando/botozap-js/blob/main/docs/ai.md).
|
|
337
|
+
|
|
338
|
+
### Tarifas próprias de transcrição
|
|
339
|
+
|
|
340
|
+
`client.ai.usage.saveRate` aceita `audio_pricing` separado das tarifas de texto.
|
|
341
|
+
Omitir preserva a configuração anterior; `null` remove a tarifa de áudio.
|
|
342
|
+
Informe os preços do contrato da sua chave, sem assumir valores padrão:
|
|
343
|
+
|
|
344
|
+
- `{ unit: "duration", usd_per_minute }` cobra por duração verificada.
|
|
345
|
+
- `{ unit: "tokens", input_audio_usd_per_million, input_text_usd_per_million, output_text_usd_per_million, max_input_tokens, max_output_tokens }` usa as unidades de áudio/texto informadas pelo provedor.
|
|
346
|
+
|
|
347
|
+
Preços: 0–100.000, até oito casas decimais. Reservas de tokens: inteiros de
|
|
348
|
+
1–100.000.000. São estimativas para admissão, não limites técnicos impostos ao
|
|
349
|
+
provedor; o custo real pode superar a reserva. Cada chamada preserva sua tarifa.
|
|
350
|
+
A ausência de preço ou de medição compatível mantém o custo desconhecido e pode
|
|
351
|
+
bloquear novas chamadas. `usage.reprice`, com confirmação explícita, também estima
|
|
352
|
+
transcrições anteriores com unidades compatíveis e sem tarifa registrada; não
|
|
353
|
+
substitui snapshots nem transforma uma inferência incerta em custo zero.
|
|
354
|
+
|
|
355
|
+
A CLI `ai usage save-rate` recebe o mesmo JSON por `--input-file`; o MCP expõe
|
|
356
|
+
`audio_pricing` opcional e anulável na ferramenta `ai_usage_save_rate`.
|