evo360-types 1.3.574 → 1.3.578

package/dist/apps/shared/zod-schemas.d.ts

@@ -90,6 +90,7 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     email: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     phone: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -97,6 +98,7 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     email: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     phone: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
@@ -104,4 +106,5 @@ export declare const zContactSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     instagram_username: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bsuid: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.ZodTypeAny, "passthrough">>;

package/dist/apps/shared/zod-schemas.js

@@ -89,4 +89,6 @@ exports.zContactSchema = zod_1.z.object({
     type: zod_1.z.string().nullable().optional(),
     instagram: zod_1.z.string().nullable().optional(),
     instagram_username: zod_1.z.string().nullable().optional(),
+    // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
+    bsuid: zod_1.z.string().nullable().optional(),
 }).passthrough();

package/dist/apps/shared/zod-schemas.ts

@@ -104,4 +104,6 @@ export const zContactSchema = z.object({
   type: z.string().nullable().optional(),
   instagram: z.string().nullable().optional(),
   instagram_username: z.string().nullable().optional(),
+  // WhatsApp BSUID (Business-Scoped User ID) — contato que a Meta entrega sem telefone
+  bsuid: z.string().nullable().optional(),
 }).passthrough();

package/dist/types/evo-finops/common/contract.d.ts

@@ -76,6 +76,14 @@ export declare const NexFinopsMetricCatalog: {
         readonly label: "E-mails enviados";
         readonly unit: "mensagens";
     };
+    readonly teleconsultations_unrecorded: {
+        readonly label: "Teleconsultas sem gravação";
+        readonly unit: "consultas";
+    };
+    readonly teleconsultations_recorded: {
+        readonly label: "Teleconsultas com gravação";
+        readonly unit: "consultas";
+    };
 };
 /**
  * Chaves conhecidas do catálogo — para iterar e para tipar escolha de métrica

package/dist/types/evo-finops/common/contract.js

@@ -11,6 +11,13 @@ exports.NexFinopsMetricCatalog = {
     attendances: { label: 'Atendimentos', unit: 'contatos' },
     sms: { label: 'SMS enviados', unit: 'mensagens' },
     email: { label: 'E-mails enviados', unit: 'mensagens' },
+    // feat-160 F18 (D33) — DISJUNTAS: uma teleconsulta realizada consome
+    // exatamente UMA das duas. `_recorded` NAO e subconjunto de um total; o total
+    // e derivado na tela. A transcricao esta dentro de `_recorded`, nao tem
+    // franquia propria. Ler uma como subconjunto da outra cobra o mesmo encontro
+    // duas vezes.
+    teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
+    teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
 };
 /** Doc de config global dos alertas de consumo (convenção `/platform/<app>`). */
 exports.EVO_BILLING_USAGE_ALERTS_CONFIG_PATH = 'platform/evo-billing/usage-alerts/config';

package/dist/types/evo-finops/common/contract.ts

@@ -80,6 +80,13 @@ export const NexFinopsMetricCatalog = {
   attendances: { label: 'Atendimentos', unit: 'contatos' },
   sms: { label: 'SMS enviados', unit: 'mensagens' },
   email: { label: 'E-mails enviados', unit: 'mensagens' },
+  // feat-160 F18 (D33) — DISJUNTAS: uma teleconsulta realizada consome
+  // exatamente UMA das duas. `_recorded` NAO e subconjunto de um total; o total
+  // e derivado na tela. A transcricao esta dentro de `_recorded`, nao tem
+  // franquia propria. Ler uma como subconjunto da outra cobra o mesmo encontro
+  // duas vezes.
+  teleconsultations_unrecorded: { label: 'Teleconsultas sem gravação', unit: 'consultas' },
+  teleconsultations_recorded: { label: 'Teleconsultas com gravação', unit: 'consultas' },
 } as const;
 
 /**

package/dist/types/evo-med/calendar/index.d.ts

@@ -131,6 +131,93 @@ export declare const MedCalendarNotificationConfigKeys: {
     readonly TelemedicineJoinReminder: "telemedicine_join_reminder";
 };
 export type MedCalendarNotificationConfigKey = (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
+/** `recording.mode` da agenda (feat-160 F15). `off` esconde "Solicitar gravação". */
+export declare const VirtualCareRecordingModeEnum: {
+    /** Gravação indisponível nesta agenda. */
+    readonly Off: "off";
+    /** Médico solicita em sala e o paciente aceita ali (comportamento do MVP). */
+    readonly Manual: "manual";
+    /** Inicia sozinha, só áudio; o aceite é colhido ANTES de o paciente entrar. */
+    readonly AutoAudio: "auto_audio";
+    /** Idem, com vídeo. */
+    readonly AutoVideo: "auto_video";
+};
+export type VirtualCareRecordingMode = (typeof VirtualCareRecordingModeEnum)[keyof typeof VirtualCareRecordingModeEnum];
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+export declare const VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+export declare const VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+/** Limites de `max_duration_minutes`. */
+export declare const VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+export declare const VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = 480;
+/** O que está GRAVADO no doc da agenda — tudo parcial (ausente = default). */
+export interface IMedCalendarVirtualCareConfig {
+    /**
+     * Admite o paciente sozinho quando o médico já está em sala
+     * (`waiting_policy` default `auto_when_doctor_present`). Exige a capability
+     * `auto_admit` do entitlement e NUNCA vale sem identidade verificada (D9).
+     */
+    auto_admit?: boolean | null;
+    recording?: {
+        mode?: VirtualCareRecordingMode | null;
+        /** Transcrição da gravação. Gate D12 + capability `transcription`. */
+        transcription?: boolean | null;
+        /**
+         * Retenção de gravação/transcrição em dias, 7..730 (D32). O sweep é a
+         * verdade (`artifact.expires_at` = fim + N dias); o lifecycle do bucket é
+         * só defesa de último caso. O prazo escolhido entra no texto de gravação
+         * mostrado ao paciente (`{{retention}}`).
+         */
+        retention_days?: number | null;
+    } | null;
+    identity?: {
+        require_name?: boolean | null;
+        /** Só é exigível quando o cadastro TEM data de nascimento (spec §8.3). */
+        require_birth_date?: boolean | null;
+        /** `true` ⇒ `identity_level: 'weak'`; nunca habilita auto-admit (D9). */
+        skip?: boolean | null;
+    } | null;
+    /** Antecedência de acesso à sala, por papel, em minutos. */
+    allow_early_start_minutes?: {
+        doctor?: number | null;
+        patient?: number | null;
+    } | null;
+    /** `true` = passar do fim previsto não encerra a consulta (comportamento atual). */
+    allow_late_end?: boolean | null;
+    /** Teto absoluto; o sweep encerra ao exceder (`reason: max_duration`). 15..480. */
+    max_duration_minutes?: number | null;
+    /** Aviso ao médico no SPA quando faltar N min para o fim. 0 = sem aviso. */
+    end_warning_minutes?: number | null;
+}
+/** Config já RESOLVIDA (doc + defaults) — é com isto que o backend decide. */
+export interface IMedCalendarVirtualCareSettings {
+    auto_admit: boolean;
+    recording: {
+        mode: VirtualCareRecordingMode;
+        transcription: boolean;
+        retention_days: number;
+    };
+    identity: {
+        require_name: boolean;
+        require_birth_date: boolean;
+        skip: boolean;
+    };
+    allow_early_start_minutes: {
+        doctor: number;
+        patient: number;
+    };
+    allow_late_end: boolean;
+    max_duration_minutes: number;
+    end_warning_minutes: number;
+}
+/**
+ * Defaults da spec (plan §12 / D13 / D32). Agenda sem `virtual_care` vale
+ * exatamente isto — é o que faz "sem migração de dado" ser verdade.
+ *
+ * Congelado (`as const` + `Readonly`) de propósito: é referência compartilhada,
+ * e um consumidor que mutasse um nível aninhado mudaria o default de todos.
+ * Para resolver, faça merge por nível (`{ ...DEFAULTS.recording, ...cfg.recording }`).
+ */
+export declare const CALENDAR_VIRTUAL_CARE_DEFAULTS: IMedCalendarVirtualCareSettings;
 export interface IMedCalendar extends IFireDoc {
     calendarId: string;
     color?: string;
@@ -160,5 +247,16 @@ export interface IMedCalendar extends IFireDoc {
     available_for_hubia?: boolean | null;
     integration?: IMedCalendarIntegration | null;
     notification_config?: IMedCalendarNotificationConfig | null;
+    /**
+     * Config de telemedicina por-agenda (feat-160 F16). Ausente = defaults de
+     * `CALENDAR_VIRTUAL_CARE_DEFAULTS`; só tem efeito com `modules.telemedicine`.
+     */
+    virtual_care?: IMedCalendarVirtualCareConfig | null;
+    /**
+     * Profissional (médico) padrão da agenda — feat-160 F16, fora do módulo de
+     * telemedicina (pedido do usuário, mesmo editor). Ref para
+     * `tenants/{t}/apps/evo-med/professionals/{id}`; `null` = sem padrão.
+     */
+    default_professional_ref?: FirestoreDocumentReference | null;
     [key: string]: unknown;
 }

package/dist/types/evo-med/calendar/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MedCalendarNotificationConfigKeys = exports.EvoMedCalendarPermissions = void 0;
+exports.CALENDAR_VIRTUAL_CARE_DEFAULTS = exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = exports.VIRTUAL_CARE_RETENTION_DAYS_MAX = exports.VIRTUAL_CARE_RETENTION_DAYS_MIN = exports.VirtualCareRecordingModeEnum = exports.MedCalendarNotificationConfigKeys = exports.EvoMedCalendarPermissions = void 0;
 __exportStar(require("../../evo-people/fb_collections"), exports);
 // Permissões para o calendário
 exports.EvoMedCalendarPermissions = {
@@ -66,3 +66,62 @@ exports.MedCalendarNotificationConfigKeys = {
      */
     TelemedicineJoinReminder: "telemedicine_join_reminder",
 };
+// ----- Virtual Care (inline no calendar doc) — feat-160 F16
+// Config por-agenda do módulo de telemedicina ("Hub Médica Virtual Care"), lida
+// pelo backend no `join`/`admit`/sweep e editada na seção própria do Calendar V2
+// (visível só com o entitlement `modules.telemedicine`).
+//
+// Bloco e campos são TODOS opcionais: agenda sem o bloco (a maioria) vale
+// exatamente `CALENDAR_VIRTUAL_CARE_DEFAULTS`, sem migração de dado (plan §12).
+// Por isso existem DOIS tipos: `IMedCalendarVirtualCareConfig` é o que está
+// gravado (parcial), e `IMedCalendarVirtualCareSettings` é o resultado de
+// aplicar os defaults sobre ele — o que o backend efetivamente decide com.
+//
+// `| null` em todo campo, como no `notification_config`: o editor do FE grava
+// "não escolhido" como `null` explícito e `.passthrough()` não cobre null em
+// chave declarada — sem `.nullable()` o doc inteiro do calendário reprovaria.
+/** `recording.mode` da agenda (feat-160 F15). `off` esconde "Solicitar gravação". */
+exports.VirtualCareRecordingModeEnum = {
+    /** Gravação indisponível nesta agenda. */
+    Off: "off",
+    /** Médico solicita em sala e o paciente aceita ali (comportamento do MVP). */
+    Manual: "manual",
+    /** Inicia sozinha, só áudio; o aceite é colhido ANTES de o paciente entrar. */
+    AutoAudio: "auto_audio",
+    /** Idem, com vídeo. */
+    AutoVideo: "auto_video",
+};
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+exports.VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+exports.VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+/** Limites de `max_duration_minutes`. */
+exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+exports.VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = 480;
+/**
+ * Defaults da spec (plan §12 / D13 / D32). Agenda sem `virtual_care` vale
+ * exatamente isto — é o que faz "sem migração de dado" ser verdade.
+ *
+ * Congelado (`as const` + `Readonly`) de propósito: é referência compartilhada,
+ * e um consumidor que mutasse um nível aninhado mudaria o default de todos.
+ * Para resolver, faça merge por nível (`{ ...DEFAULTS.recording, ...cfg.recording }`).
+ */
+exports.CALENDAR_VIRTUAL_CARE_DEFAULTS = {
+    auto_admit: false,
+    recording: {
+        mode: exports.VirtualCareRecordingModeEnum.Manual,
+        transcription: false,
+        retention_days: exports.VIRTUAL_CARE_RETENTION_DAYS_MIN,
+    },
+    identity: {
+        require_name: true,
+        require_birth_date: true,
+        skip: false,
+    },
+    allow_early_start_minutes: {
+        doctor: 30,
+        patient: 15,
+    },
+    allow_late_end: true,
+    max_duration_minutes: 120,
+    end_warning_minutes: 5,
+};

package/dist/types/evo-med/calendar/index.ts

@@ -152,6 +152,135 @@ export const MedCalendarNotificationConfigKeys = {
 export type MedCalendarNotificationConfigKey =
   (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
 
+// ----- Virtual Care (inline no calendar doc) — feat-160 F16
+// Config por-agenda do módulo de telemedicina ("Hub Médica Virtual Care"), lida
+// pelo backend no `join`/`admit`/sweep e editada na seção própria do Calendar V2
+// (visível só com o entitlement `modules.telemedicine`).
+//
+// Bloco e campos são TODOS opcionais: agenda sem o bloco (a maioria) vale
+// exatamente `CALENDAR_VIRTUAL_CARE_DEFAULTS`, sem migração de dado (plan §12).
+// Por isso existem DOIS tipos: `IMedCalendarVirtualCareConfig` é o que está
+// gravado (parcial), e `IMedCalendarVirtualCareSettings` é o resultado de
+// aplicar os defaults sobre ele — o que o backend efetivamente decide com.
+//
+// `| null` em todo campo, como no `notification_config`: o editor do FE grava
+// "não escolhido" como `null` explícito e `.passthrough()` não cobre null em
+// chave declarada — sem `.nullable()` o doc inteiro do calendário reprovaria.
+
+/** `recording.mode` da agenda (feat-160 F15). `off` esconde "Solicitar gravação". */
+export const VirtualCareRecordingModeEnum = {
+  /** Gravação indisponível nesta agenda. */
+  Off: "off",
+  /** Médico solicita em sala e o paciente aceita ali (comportamento do MVP). */
+  Manual: "manual",
+  /** Inicia sozinha, só áudio; o aceite é colhido ANTES de o paciente entrar. */
+  AutoAudio: "auto_audio",
+  /** Idem, com vídeo. */
+  AutoVideo: "auto_video",
+} as const;
+
+export type VirtualCareRecordingMode =
+  (typeof VirtualCareRecordingModeEnum)[keyof typeof VirtualCareRecordingModeEnum];
+
+/** Limites de `recording.retention_days` (D32; D13 mantém 7 como default). */
+export const VIRTUAL_CARE_RETENTION_DAYS_MIN = 7;
+export const VIRTUAL_CARE_RETENTION_DAYS_MAX = 730;
+
+/** Limites de `max_duration_minutes`. */
+export const VIRTUAL_CARE_MAX_DURATION_MINUTES_MIN = 15;
+export const VIRTUAL_CARE_MAX_DURATION_MINUTES_MAX = 480;
+
+/** O que está GRAVADO no doc da agenda — tudo parcial (ausente = default). */
+export interface IMedCalendarVirtualCareConfig {
+  /**
+   * Admite o paciente sozinho quando o médico já está em sala
+   * (`waiting_policy` default `auto_when_doctor_present`). Exige a capability
+   * `auto_admit` do entitlement e NUNCA vale sem identidade verificada (D9).
+   */
+  auto_admit?: boolean | null;
+  recording?: {
+    mode?: VirtualCareRecordingMode | null;
+    /** Transcrição da gravação. Gate D12 + capability `transcription`. */
+    transcription?: boolean | null;
+    /**
+     * Retenção de gravação/transcrição em dias, 7..730 (D32). O sweep é a
+     * verdade (`artifact.expires_at` = fim + N dias); o lifecycle do bucket é
+     * só defesa de último caso. O prazo escolhido entra no texto de gravação
+     * mostrado ao paciente (`{{retention}}`).
+     */
+    retention_days?: number | null;
+  } | null;
+  identity?: {
+    require_name?: boolean | null;
+    /** Só é exigível quando o cadastro TEM data de nascimento (spec §8.3). */
+    require_birth_date?: boolean | null;
+    /** `true` ⇒ `identity_level: 'weak'`; nunca habilita auto-admit (D9). */
+    skip?: boolean | null;
+  } | null;
+  /** Antecedência de acesso à sala, por papel, em minutos. */
+  allow_early_start_minutes?: {
+    doctor?: number | null;
+    patient?: number | null;
+  } | null;
+  /** `true` = passar do fim previsto não encerra a consulta (comportamento atual). */
+  allow_late_end?: boolean | null;
+  /** Teto absoluto; o sweep encerra ao exceder (`reason: max_duration`). 15..480. */
+  max_duration_minutes?: number | null;
+  /** Aviso ao médico no SPA quando faltar N min para o fim. 0 = sem aviso. */
+  end_warning_minutes?: number | null;
+}
+
+/** Config já RESOLVIDA (doc + defaults) — é com isto que o backend decide. */
+export interface IMedCalendarVirtualCareSettings {
+  auto_admit: boolean;
+  recording: {
+    mode: VirtualCareRecordingMode;
+    transcription: boolean;
+    retention_days: number;
+  };
+  identity: {
+    require_name: boolean;
+    require_birth_date: boolean;
+    skip: boolean;
+  };
+  allow_early_start_minutes: {
+    doctor: number;
+    patient: number;
+  };
+  allow_late_end: boolean;
+  max_duration_minutes: number;
+  end_warning_minutes: number;
+}
+
+/**
+ * Defaults da spec (plan §12 / D13 / D32). Agenda sem `virtual_care` vale
+ * exatamente isto — é o que faz "sem migração de dado" ser verdade.
+ *
+ * Congelado (`as const` + `Readonly`) de propósito: é referência compartilhada,
+ * e um consumidor que mutasse um nível aninhado mudaria o default de todos.
+ * Para resolver, faça merge por nível (`{ ...DEFAULTS.recording, ...cfg.recording }`).
+ */
+export const CALENDAR_VIRTUAL_CARE_DEFAULTS: IMedCalendarVirtualCareSettings = {
+  auto_admit: false,
+  recording: {
+    mode: VirtualCareRecordingModeEnum.Manual,
+    transcription: false,
+    retention_days: VIRTUAL_CARE_RETENTION_DAYS_MIN,
+  },
+  identity: {
+    require_name: true,
+    require_birth_date: true,
+    skip: false,
+  },
+  allow_early_start_minutes: {
+    doctor: 30,
+    patient: 15,
+  },
+  allow_late_end: true,
+  max_duration_minutes: 120,
+  end_warning_minutes: 5,
+} as const;
+
 // ----- MedCalendarTypes
 export interface IMedCalendar extends IFireDoc {
   calendarId: string;
@@ -187,5 +316,16 @@ export interface IMedCalendar extends IFireDoc {
   integration?: IMedCalendarIntegration | null;
   // Config de notificações por-agenda (feat-048). Opcional — agendas sem lembrete não têm o bloco.
   notification_config?: IMedCalendarNotificationConfig | null;
+  /**
+   * Config de telemedicina por-agenda (feat-160 F16). Ausente = defaults de
+   * `CALENDAR_VIRTUAL_CARE_DEFAULTS`; só tem efeito com `modules.telemedicine`.
+   */
+  virtual_care?: IMedCalendarVirtualCareConfig | null;
+  /**
+   * Profissional (médico) padrão da agenda — feat-160 F16, fora do módulo de
+   * telemedicina (pedido do usuário, mesmo editor). Ref para
+   * `tenants/{t}/apps/evo-med/professionals/{id}`; `null` = sem padrão.
+   */
+  default_professional_ref?: FirestoreDocumentReference | null;
   [key: string]: unknown; // index signature
 }

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

@@ -21,6 +21,17 @@ export interface IUsageCapabilities {
      * antes dessa data: ausência de medição não é consumo zero.
      */
     llm_since: string | null;
+    /**
+     * feat-160 F18 — entitlement `modules.telemedicine` ativo OU uso de
+     * teleconsulta medido na janela.
+     */
+    telemedicine: boolean;
+    /**
+     * Data (`YYYY-MM-DD`) a partir da qual existe medição de teleconsulta — o
+     * emissor não tem backfill. `null` antes do deploy dele; a série não é
+     * desenhada antes dessa data, porque ausência de medição não é consumo zero.
+     */
+    telemedicine_since: string | null;
 }
 /**
  * Uma linha da abertura por departamento dentro de um mês.
@@ -84,6 +95,21 @@ export interface IUsageLlm {
     tokens_cache_write: number;
     tokens_cache_read: number;
 }
+/**
+ * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
+ * começou (`started_at`) E o paciente esteve conectado (`connected_at`): médico
+ * entrando em sala vazia não conta.
+ *
+ * Os dois campos são DISJUNTOS — uma consulta cai em exatamente um. O total é a
+ * soma; não há campo de total, para não haver duas verdades.
+ *
+ * `com_gravacao` = teve ao menos um artifact `recording_*` em `ready`. Bloco
+ * inteiro `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTelemedicine {
+    realizadas_sem_gravacao: number;
+    realizadas_com_gravacao: number;
+}
 export interface IMonthlyUsageRow {
     /** Primeiro dia do mês em UTC, `YYYY-MM-DD`. */
     mes: string;
@@ -92,6 +118,7 @@ export interface IMonthlyUsageRow {
     contatos: IUsageContacts;
     notificacoes: IUsageNotifications;
     ia: IUsageLlm | null;
+    telemedicina: IUsageTelemedicine | null;
 }
 export interface IMonthlyUsageResponse {
     ok: true;

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

@@ -37,6 +37,17 @@ export interface IUsageCapabilities {
    * antes dessa data: ausência de medição não é consumo zero.
    */
   llm_since: string | null;
+  /**
+   * feat-160 F18 — entitlement `modules.telemedicine` ativo OU uso de
+   * teleconsulta medido na janela.
+   */
+  telemedicine: boolean;
+  /**
+   * Data (`YYYY-MM-DD`) a partir da qual existe medição de teleconsulta — o
+   * emissor não tem backfill. `null` antes do deploy dele; a série não é
+   * desenhada antes dessa data, porque ausência de medição não é consumo zero.
+   */
+  telemedicine_since: string | null;
 }
 
 /**
@@ -105,6 +116,22 @@ export interface IUsageLlm {
   tokens_cache_read: number;
 }
 
+/**
+ * Teleconsultas REALIZADAS no mês (feat-160 F18 / D33). Realizada = a consulta
+ * começou (`started_at`) E o paciente esteve conectado (`connected_at`): médico
+ * entrando em sala vazia não conta.
+ *
+ * Os dois campos são DISJUNTOS — uma consulta cai em exatamente um. O total é a
+ * soma; não há campo de total, para não haver duas verdades.
+ *
+ * `com_gravacao` = teve ao menos um artifact `recording_*` em `ready`. Bloco
+ * inteiro `null` = capability desligada (não é consumo zero).
+ */
+export interface IUsageTelemedicine {
+  realizadas_sem_gravacao: number;
+  realizadas_com_gravacao: number;
+}
+
 export interface IMonthlyUsageRow {
   /** Primeiro dia do mês em UTC, `YYYY-MM-DD`. */
   mes: string;
@@ -113,6 +140,7 @@ export interface IMonthlyUsageRow {
   contatos: IUsageContacts;
   notificacoes: IUsageNotifications;
   ia: IUsageLlm | null;
+  telemedicina: IUsageTelemedicine | null;
 }
 
 export interface IMonthlyUsageResponse {