@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 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({ after: ultimoCursor, signal: controller.signal });
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`.