tychat-contracts 1.3.1 → 1.3.3

package/dist/appointments/appointment-calendar.dto.d.ts

@@ -3,11 +3,18 @@ export declare class AppointmentCalendarItemDto {
     id: string;
     date: string;
 }
+/** Agendamentos agrupados por hora civil UTC. */
+export declare class AppointmentCalendarHourDto {
+    hour: string;
+    countAppointment: number;
+    appointments: AppointmentCalendarItemDto[];
+}
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 export declare class AppointmentCalendarDayDto {
     date: string;
     countAppointment: number;
     appointments: AppointmentCalendarItemDto[];
+    hours?: AppointmentCalendarHourDto[];
 }
 export declare class AppointmentCalendarResponseDto {
     startDate: string;

package/dist/appointments/appointment-calendar.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appointment-calendar.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-calendar.dto.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,qBAAa,0BAA0B;IAErC,EAAE,EAAE,MAAM,CAAC;IAMX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uFAAuF;AACvF,qBAAa,yBAAyB;IAKpC,IAAI,EAAE,MAAM,CAAC;IAMb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED,qBAAa,8BAA8B;IAEzC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAOhB,IAAI,EAAE,yBAAyB,EAAE,CAAC;CACnC"}
+{"version":3,"file":"appointment-calendar.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-calendar.dto.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,qBAAa,0BAA0B;IAErC,EAAE,EAAE,MAAM,CAAC;IAMX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iDAAiD;AACjD,qBAAa,0BAA0B;IAKrC,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;CAC5C;AAED,uFAAuF;AACvF,qBAAa,yBAAyB;IAKpC,IAAI,EAAE,MAAM,CAAC;IAMb,gBAAgB,EAAE,MAAM,CAAC;IAGzB,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAQ3C,KAAK,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACtC;AAED,qBAAa,8BAA8B;IAEzC,SAAS,EAAE,MAAM,CAAC;IAGlB,OAAO,EAAE,MAAM,CAAC;IAOhB,IAAI,EAAE,yBAAyB,EAAE,CAAC;CACnC"}

package/dist/appointments/appointment-calendar.dto.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AppointmentCalendarResponseDto = exports.AppointmentCalendarDayDto = exports.AppointmentCalendarItemDto = void 0;
+exports.AppointmentCalendarResponseDto = exports.AppointmentCalendarDayDto = exports.AppointmentCalendarHourDto = exports.AppointmentCalendarItemDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 /** Um agendamento no calendário. */
 class AppointmentCalendarItemDto {
@@ -28,11 +28,36 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], AppointmentCalendarItemDto.prototype, "date", void 0);
+/** Agendamentos agrupados por hora civil UTC. */
+class AppointmentCalendarHourDto {
+    hour;
+    countAppointment;
+    appointments;
+}
+exports.AppointmentCalendarHourDto = AppointmentCalendarHourDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Hora UTC no formato ISO 8601 arredondada para início da hora',
+        example: '2026-04-10T14:00:00.000Z',
+    }),
+    __metadata("design:type", String)
+], AppointmentCalendarHourDto.prototype, "hour", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Quantidade de agendamentos nesta hora UTC dentro do intervalo solicitado.',
+    }),
+    __metadata("design:type", Number)
+], AppointmentCalendarHourDto.prototype, "countAppointment", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [AppointmentCalendarItemDto] }),
+    __metadata("design:type", Array)
+], AppointmentCalendarHourDto.prototype, "appointments", void 0);
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 class AppointmentCalendarDayDto {
     date;
     countAppointment;
     appointments;
+    hours;
 }
 exports.AppointmentCalendarDayDto = AppointmentCalendarDayDto;
 __decorate([
@@ -52,6 +77,14 @@ __decorate([
     (0, swagger_1.ApiProperty)({ type: [AppointmentCalendarItemDto] }),
     __metadata("design:type", Array)
 ], AppointmentCalendarDayDto.prototype, "appointments", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        required: false,
+        description: 'Quando o intervalo tiver exatamente 7 dias, agrega por hora UTC com `countAppointment` por hora e até 2 itens em `appointments` por hora.',
+        type: [AppointmentCalendarHourDto],
+    }),
+    __metadata("design:type", Array)
+], AppointmentCalendarDayDto.prototype, "hours", void 0);
 class AppointmentCalendarResponseDto {
     startDate;
     endDate;
@@ -68,7 +101,7 @@ __decorate([
 ], AppointmentCalendarResponseDto.prototype, "endDate", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Um elemento por dia civil no intervalo (UTC). Em intervalos multi-dia, `appointments` traz no máximo 2 itens por dia (primeiros por horário naquele dia UTC); `countAppointment` é sempre o total do dia.',
+        description: 'Um elemento por dia civil no intervalo (UTC). 1 dia: retorna todos os agendamentos em `appointments`. Exatamente 7 dias: `hours` traz até 2 agendamentos por hora e contagem por hora; `appointments` agrega esses previews do dia. Maior que 7 dias: `appointments` traz no máximo 2 itens por dia e `countAppointment` é o total diário.',
         type: [AppointmentCalendarDayDto],
     }),
     __metadata("design:type", Array)

package/dist/configurations/ai-tool-policy.dto.d.ts

@@ -0,0 +1,26 @@
+import { type AiToolFallbackMode, type AiToolKey, type AiToolPolicyLevel } from './ai-tool-policy.enums';
+export declare class AiToolPolicyDto {
+    toolKey: AiToolKey;
+    enabled: boolean;
+    fallbackMode?: AiToolFallbackMode;
+    level?: AiToolPolicyLevel;
+}
+export declare class UpdateAiToolPolicyDto {
+    toolKey: AiToolKey;
+    enabled: boolean;
+    fallbackMode?: AiToolFallbackMode;
+}
+export declare class UpdateAiToolPoliciesDto {
+    policies: UpdateAiToolPolicyDto[];
+}
+export declare class ResolveAiToolPoliciesQueryDto {
+    tenantId: string;
+    unitId?: number;
+}
+export declare class EffectiveAiToolPolicyDto extends AiToolPolicyDto {
+    reasonCode?: string;
+}
+export declare class EffectiveAiToolPoliciesDto {
+    policies: EffectiveAiToolPolicyDto[];
+}
+//# sourceMappingURL=ai-tool-policy.dto.d.ts.map

package/dist/configurations/ai-tool-policy.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-policy.dto.d.ts","sourceRoot":"","sources":["../../src/configurations/ai-tool-policy.dto.ts"],"names":[],"mappings":"AAaA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACvB,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,eAAe;IAG1B,OAAO,EAAE,SAAS,CAAC;IAInB,OAAO,EAAE,OAAO,CAAC;IAKjB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAKlC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,qBAAa,qBAAqB;IAGhC,OAAO,EAAE,SAAS,CAAC;IAInB,OAAO,EAAE,OAAO,CAAC;IAKjB,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,qBAAa,uBAAuB;IAKlC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAED,qBAAa,6BAA6B;IAIxC,QAAQ,EAAE,MAAM,CAAC;IAMjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,wBAAyB,SAAQ,eAAe;IAI3D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,0BAA0B;IAKrC,QAAQ,EAAE,wBAAwB,EAAE,CAAC;CACtC"}

package/dist/configurations/ai-tool-policy.dto.js

@@ -0,0 +1,117 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EffectiveAiToolPoliciesDto = exports.EffectiveAiToolPolicyDto = exports.ResolveAiToolPoliciesQueryDto = exports.UpdateAiToolPoliciesDto = exports.UpdateAiToolPolicyDto = exports.AiToolPolicyDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ai_tool_policy_enums_1 = require("./ai-tool-policy.enums");
+class AiToolPolicyDto {
+    toolKey;
+    enabled;
+    fallbackMode;
+    level;
+}
+exports.AiToolPolicyDto = AiToolPolicyDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ai_tool_policy_enums_1.AI_TOOL_KEYS }),
+    (0, class_validator_1.IsEnum)(ai_tool_policy_enums_1.AI_TOOL_KEYS),
+    __metadata("design:type", String)
+], AiToolPolicyDto.prototype, "toolKey", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AiToolPolicyDto.prototype, "enabled", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ enum: ai_tool_policy_enums_1.AI_TOOL_FALLBACK_MODES }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ai_tool_policy_enums_1.AI_TOOL_FALLBACK_MODES),
+    __metadata("design:type", String)
+], AiToolPolicyDto.prototype, "fallbackMode", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ enum: ai_tool_policy_enums_1.AI_TOOL_POLICY_LEVELS }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ai_tool_policy_enums_1.AI_TOOL_POLICY_LEVELS),
+    __metadata("design:type", String)
+], AiToolPolicyDto.prototype, "level", void 0);
+class UpdateAiToolPolicyDto {
+    toolKey;
+    enabled;
+    fallbackMode;
+}
+exports.UpdateAiToolPolicyDto = UpdateAiToolPolicyDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ enum: ai_tool_policy_enums_1.AI_TOOL_KEYS }),
+    (0, class_validator_1.IsEnum)(ai_tool_policy_enums_1.AI_TOOL_KEYS),
+    __metadata("design:type", String)
+], UpdateAiToolPolicyDto.prototype, "toolKey", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateAiToolPolicyDto.prototype, "enabled", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ enum: ai_tool_policy_enums_1.AI_TOOL_FALLBACK_MODES }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ai_tool_policy_enums_1.AI_TOOL_FALLBACK_MODES),
+    __metadata("design:type", String)
+], UpdateAiToolPolicyDto.prototype, "fallbackMode", void 0);
+class UpdateAiToolPoliciesDto {
+    policies;
+}
+exports.UpdateAiToolPoliciesDto = UpdateAiToolPoliciesDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => [UpdateAiToolPolicyDto] }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => UpdateAiToolPolicyDto),
+    __metadata("design:type", Array)
+], UpdateAiToolPoliciesDto.prototype, "policies", void 0);
+class ResolveAiToolPoliciesQueryDto {
+    tenantId;
+    unitId;
+}
+exports.ResolveAiToolPoliciesQueryDto = ResolveAiToolPoliciesQueryDto;
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResolveAiToolPoliciesQueryDto.prototype, "tenantId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ minimum: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], ResolveAiToolPoliciesQueryDto.prototype, "unitId", void 0);
+class EffectiveAiToolPolicyDto extends AiToolPolicyDto {
+    reasonCode;
+}
+exports.EffectiveAiToolPolicyDto = EffectiveAiToolPolicyDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], EffectiveAiToolPolicyDto.prototype, "reasonCode", void 0);
+class EffectiveAiToolPoliciesDto {
+    policies;
+}
+exports.EffectiveAiToolPoliciesDto = EffectiveAiToolPoliciesDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: () => [EffectiveAiToolPolicyDto] }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => EffectiveAiToolPolicyDto),
+    __metadata("design:type", Array)
+], EffectiveAiToolPoliciesDto.prototype, "policies", void 0);

package/dist/configurations/ai-tool-policy.enums.d.ts

@@ -0,0 +1,7 @@
+export declare const AI_TOOL_KEYS: readonly ["get_procedures_clinic", "get_clinic_opening_hours", "get_available_slots", "search_health_professionals", "update_patient", "search_patients_by_phone", "create_patient", "create_appointment", "add_appointment_procedures", "list_patient_appointments", "cancel_appointment", "submit_satisfaction"];
+export type AiToolKey = (typeof AI_TOOL_KEYS)[number];
+export declare const AI_TOOL_POLICY_LEVELS: readonly ["global", "plan", "tenant", "unit"];
+export type AiToolPolicyLevel = (typeof AI_TOOL_POLICY_LEVELS)[number];
+export declare const AI_TOOL_FALLBACK_MODES: readonly ["transfer_to_human", "unavailable_message"];
+export type AiToolFallbackMode = (typeof AI_TOOL_FALLBACK_MODES)[number];
+//# sourceMappingURL=ai-tool-policy.enums.d.ts.map

package/dist/configurations/ai-tool-policy.enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool-policy.enums.d.ts","sourceRoot":"","sources":["../../src/configurations/ai-tool-policy.enums.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,oTAaf,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,qBAAqB,+CAAgD,CAAC;AACnF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,sBAAsB,uDAGzB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/configurations/ai-tool-policy.enums.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_TOOL_FALLBACK_MODES = exports.AI_TOOL_POLICY_LEVELS = exports.AI_TOOL_KEYS = void 0;
+exports.AI_TOOL_KEYS = [
+    'get_procedures_clinic',
+    'get_clinic_opening_hours',
+    'get_available_slots',
+    'search_health_professionals',
+    'update_patient',
+    'search_patients_by_phone',
+    'create_patient',
+    'create_appointment',
+    'add_appointment_procedures',
+    'list_patient_appointments',
+    'cancel_appointment',
+    'submit_satisfaction',
+];
+exports.AI_TOOL_POLICY_LEVELS = ['global', 'plan', 'tenant', 'unit'];
+exports.AI_TOOL_FALLBACK_MODES = [
+    'transfer_to_human',
+    'unavailable_message',
+];

package/dist/configurations/index.d.ts

@@ -1,6 +1,8 @@
 export * from './opening-hours-slot.dto';
 export * from './update-clinic-configuration.dto';
 export * from './clinic-configuration.dto';
+export * from './ai-tool-policy.enums';
+export * from './ai-tool-policy.dto';
 export * from './plan-summary.dto';
 export * from './tenant-limits-summary.dto';
 export * from './configuration-tenant-summary.dto';

package/dist/configurations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configurations/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configurations/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oCAAoC,CAAC;AACnD,cAAc,wCAAwC,CAAC"}

package/dist/configurations/index.js

@@ -17,6 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./opening-hours-slot.dto"), exports);
 __exportStar(require("./update-clinic-configuration.dto"), exports);
 __exportStar(require("./clinic-configuration.dto"), exports);
+__exportStar(require("./ai-tool-policy.enums"), exports);
+__exportStar(require("./ai-tool-policy.dto"), exports);
 __exportStar(require("./plan-summary.dto"), exports);
 __exportStar(require("./tenant-limits-summary.dto"), exports);
 __exportStar(require("./configuration-tenant-summary.dto"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/appointments/appointment-calendar.dto.ts

@@ -12,6 +12,23 @@ export class AppointmentCalendarItemDto {
   date: string;
 }
 
+/** Agendamentos agrupados por hora civil UTC. */
+export class AppointmentCalendarHourDto {
+  @ApiProperty({
+    description: 'Hora UTC no formato ISO 8601 arredondada para início da hora',
+    example: '2026-04-10T14:00:00.000Z',
+  })
+  hour: string;
+
+  @ApiProperty({
+    description: 'Quantidade de agendamentos nesta hora UTC dentro do intervalo solicitado.',
+  })
+  countAppointment: number;
+
+  @ApiProperty({ type: [AppointmentCalendarItemDto] })
+  appointments: AppointmentCalendarItemDto[];
+}
+
 /** Agendamentos agrupados por dia civil (UTC a partir do timestamp do agendamento). */
 export class AppointmentCalendarDayDto {
   @ApiProperty({
@@ -28,6 +45,14 @@ export class AppointmentCalendarDayDto {
 
   @ApiProperty({ type: [AppointmentCalendarItemDto] })
   appointments: AppointmentCalendarItemDto[];
+
+  @ApiProperty({
+    required: false,
+    description:
+      'Quando o intervalo tiver exatamente 7 dias, agrega por hora UTC com `countAppointment` por hora e até 2 itens em `appointments` por hora.',
+    type: [AppointmentCalendarHourDto],
+  })
+  hours?: AppointmentCalendarHourDto[];
 }
 
 export class AppointmentCalendarResponseDto {
@@ -39,7 +64,7 @@ export class AppointmentCalendarResponseDto {
 
   @ApiProperty({
     description:
-      'Um elemento por dia civil no intervalo (UTC). Em intervalos multi-dia, `appointments` traz no máximo 2 itens por dia (primeiros por horário naquele dia UTC); `countAppointment` é sempre o total do dia.',
+      'Um elemento por dia civil no intervalo (UTC). 1 dia: retorna todos os agendamentos em `appointments`. Exatamente 7 dias: `hours` traz até 2 agendamentos por hora e contagem por hora; `appointments` agrega esses previews do dia. Maior que 7 dias: `appointments` traz no máximo 2 itens por dia e `countAppointment` é o total diário.',
     type: [AppointmentCalendarDayDto],
   })
   days: AppointmentCalendarDayDto[];

package/src/configurations/ai-tool-policy.dto.ts

@@ -0,0 +1,92 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsArray,
+  IsBoolean,
+  IsEnum,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+import {
+  AI_TOOL_FALLBACK_MODES,
+  AI_TOOL_KEYS,
+  AI_TOOL_POLICY_LEVELS,
+  type AiToolFallbackMode,
+  type AiToolKey,
+  type AiToolPolicyLevel,
+} from './ai-tool-policy.enums';
+
+export class AiToolPolicyDto {
+  @ApiProperty({ enum: AI_TOOL_KEYS })
+  @IsEnum(AI_TOOL_KEYS)
+  toolKey: AiToolKey;
+
+  @ApiProperty()
+  @IsBoolean()
+  enabled: boolean;
+
+  @ApiPropertyOptional({ enum: AI_TOOL_FALLBACK_MODES })
+  @IsOptional()
+  @IsEnum(AI_TOOL_FALLBACK_MODES)
+  fallbackMode?: AiToolFallbackMode;
+
+  @ApiPropertyOptional({ enum: AI_TOOL_POLICY_LEVELS })
+  @IsOptional()
+  @IsEnum(AI_TOOL_POLICY_LEVELS)
+  level?: AiToolPolicyLevel;
+}
+
+export class UpdateAiToolPolicyDto {
+  @ApiProperty({ enum: AI_TOOL_KEYS })
+  @IsEnum(AI_TOOL_KEYS)
+  toolKey: AiToolKey;
+
+  @ApiProperty()
+  @IsBoolean()
+  enabled: boolean;
+
+  @ApiPropertyOptional({ enum: AI_TOOL_FALLBACK_MODES })
+  @IsOptional()
+  @IsEnum(AI_TOOL_FALLBACK_MODES)
+  fallbackMode?: AiToolFallbackMode;
+}
+
+export class UpdateAiToolPoliciesDto {
+  @ApiProperty({ type: () => [UpdateAiToolPolicyDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => UpdateAiToolPolicyDto)
+  policies: UpdateAiToolPolicyDto[];
+}
+
+export class ResolveAiToolPoliciesQueryDto {
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  tenantId: string;
+
+  @ApiPropertyOptional({ minimum: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+}
+
+export class EffectiveAiToolPolicyDto extends AiToolPolicyDto {
+  @ApiPropertyOptional()
+  @IsOptional()
+  @IsString()
+  reasonCode?: string;
+}
+
+export class EffectiveAiToolPoliciesDto {
+  @ApiProperty({ type: () => [EffectiveAiToolPolicyDto] })
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => EffectiveAiToolPolicyDto)
+  policies: EffectiveAiToolPolicyDto[];
+}

package/src/configurations/ai-tool-policy.enums.ts

@@ -0,0 +1,25 @@
+export const AI_TOOL_KEYS = [
+  'get_procedures_clinic',
+  'get_clinic_opening_hours',
+  'get_available_slots',
+  'search_health_professionals',
+  'update_patient',
+  'search_patients_by_phone',
+  'create_patient',
+  'create_appointment',
+  'add_appointment_procedures',
+  'list_patient_appointments',
+  'cancel_appointment',
+  'submit_satisfaction',
+] as const;
+
+export type AiToolKey = (typeof AI_TOOL_KEYS)[number];
+
+export const AI_TOOL_POLICY_LEVELS = ['global', 'plan', 'tenant', 'unit'] as const;
+export type AiToolPolicyLevel = (typeof AI_TOOL_POLICY_LEVELS)[number];
+
+export const AI_TOOL_FALLBACK_MODES = [
+  'transfer_to_human',
+  'unavailable_message',
+] as const;
+export type AiToolFallbackMode = (typeof AI_TOOL_FALLBACK_MODES)[number];

package/src/configurations/index.ts

@@ -1,6 +1,8 @@
 export * from './opening-hours-slot.dto';
 export * from './update-clinic-configuration.dto';
 export * from './clinic-configuration.dto';
+export * from './ai-tool-policy.enums';
+export * from './ai-tool-policy.dto';
 export * from './plan-summary.dto';
 export * from './tenant-limits-summary.dto';
 export * from './configuration-tenant-summary.dto';