evo360-types 1.3.736 → 1.3.746

package/dist/types/evo-reports/index.d.ts

@@ -32,6 +32,16 @@ export interface IUsageCapabilities {
      * desenhada antes dessa data, porque ausência de medição não é consumo zero.
      */
     telemedicine_since: string | null;
+    /**
+     * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+     * Opcional: produtor antigo não envia; ausente = série não desenhada.
+     */
+    transcription?: boolean;
+    /**
+     * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+     * backfill). `null`/ausente antes do deploy do emissor.
+     */
+    transcription_since?: string | null;
 }
 /**
  * Uma linha da abertura por departamento dentro de um mês.
@@ -94,6 +104,46 @@ export interface IUsageLlm {
     tokens_output: number;
     tokens_cache_write: number;
     tokens_cache_read: number;
+    /**
+     * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+     * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+     * preço conhecido. Opcional: produtor antigo não envia.
+     */
+    cost_usd_est?: number | null;
+    /**
+     * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+     * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+     * Opcional: produtor antigo não envia.
+     */
+    por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+export interface IUsageLlmCategory {
+    /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+    turnos: number;
+    tokens_total: number;
+    /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+    cost_usd_est: number | null;
+}
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+    audios: number;
+    segundos: number;
+    /** `segundos / 60`, 2 casas. */
+    minutos: number;
+    /** US$ estimado (preço de lista); `null` sem duração/preço. */
+    cost_usd_est: number | null;
 }
 /**
  * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
@@ -119,6 +169,8 @@ export interface IMonthlyUsageRow {
     notificacoes: IUsageNotifications;
     ia: IUsageLlm | null;
     telemedicina: IUsageTelemedicine | null;
+    /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+    transcricao?: IUsageTranscription | null;
 }
 export interface IMonthlyUsageResponse {
     ok: true;

package/dist/types/evo-reports/index.ts

@@ -48,6 +48,16 @@ export interface IUsageCapabilities {
    * desenhada antes dessa data, porque ausência de medição não é consumo zero.
    */
   telemedicine_since: string | null;
+  /**
+   * feat-302 F2 — transcrição de áudio medida (evento `media.transcription`).
+   * Opcional: produtor antigo não envia; ausente = série não desenhada.
+   */
+  transcription?: boolean;
+  /**
+   * Data (`YYYY-MM-DD`) do primeiro evento de transcrição medido (sem
+   * backfill). `null`/ausente antes do deploy do emissor.
+   */
+  transcription_since?: string | null;
 }
 
 /**
@@ -114,6 +124,49 @@ export interface IUsageLlm {
   tokens_output: number;
   tokens_cache_write: number;
   tokens_cache_read: number;
+  /**
+   * feat-302 F2 — custo ESTIMADO em US$ (preço de lista, `cost_usd_est` dos
+   * eventos). Informativo, não é fatura. `null` quando nenhum evento do mês tem
+   * preço conhecido. Opcional: produtor antigo não envia.
+   */
+  cost_usd_est?: number | null;
+  /**
+   * feat-302 F2 — quebra por categoria de produto (visão de custo por tenant).
+   * Só categorias com uso no mês aparecem. A soma bate com o total do bloco.
+   * Opcional: produtor antigo não envia.
+   */
+  por_categoria?: Partial<Record<UsageAiCategory, IUsageLlmCategory>>;
+}
+
+/**
+ * feat-302 F2 — categorias de uso de IA do TENANT (espelho de
+ * `AiUsageCategory` do `@evo/hubia`, sem as internas como `csq_judge`).
+ * - `hubia`: atendimento (turnos do LLM, reativação, busca de família).
+ * - `attachment_analysis`: leitura de foto/PDF pelo classificador de anexos.
+ * - `audio_synthesis`: resposta em áudio (reservada; ainda sem emissor).
+ */
+export type UsageAiCategory = "hubia" | "attachment_analysis" | "audio_synthesis";
+
+export interface IUsageLlmCategory {
+  /** Chamadas ao LLM nesta categoria (execuções/análises, dedup por evento). */
+  turnos: number;
+  tokens_total: number;
+  /** US$ estimado (preço de lista); `null` sem preço conhecido. */
+  cost_usd_est: number | null;
+}
+
+/**
+ * feat-302 F2 — transcrição de áudio no mês (Whisper; evento
+ * `media.transcription`, 1 por áudio, dedup por mensagem). Informativo: não é
+ * cobrado. Bloco `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTranscription {
+  audios: number;
+  segundos: number;
+  /** `segundos / 60`, 2 casas. */
+  minutos: number;
+  /** US$ estimado (preço de lista); `null` sem duração/preço. */
+  cost_usd_est: number | null;
 }
 
 /**
@@ -141,6 +194,8 @@ export interface IMonthlyUsageRow {
   notificacoes: IUsageNotifications;
   ia: IUsageLlm | null;
   telemedicina: IUsageTelemedicine | null;
+  /** feat-302 F2 — opcional: produtor antigo não envia; `null` = capability desligada. */
+  transcricao?: IUsageTranscription | null;
 }
 
 export interface IMonthlyUsageResponse {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.736",
+  "version": "1.3.746",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",