tychat-contracts 1.0.63 → 1.0.65

package/dist/ai/agent-response.dto.d.ts

@@ -5,6 +5,8 @@ export declare class AgentResponseDto {
     unitId: number;
     integration: AiIntegrationDto;
     model: string;
+    transcriptionIntegration: AiIntegrationDto;
+    transcriptionModel: string;
     systemPrompt: string;
     temperature: number;
     active: boolean;

package/dist/ai/agent-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/agent-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,gBAAgB;IAM3B,EAAE,EAAE,MAAM,CAAC;IAQX,MAAM,EAAE,MAAM,CAAC;IAOf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAO9B,KAAK,EAAE,MAAM,CAAC;IAOd,YAAY,EAAE,MAAM,CAAC;IAOrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAQhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAOtB,SAAS,EAAE,MAAM,CAAC;IAOlB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/agent-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,gBAAgB;IAM3B,EAAE,EAAE,MAAM,CAAC;IAQX,MAAM,EAAE,MAAM,CAAC;IAOf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAO9B,KAAK,EAAE,MAAM,CAAC;IAQd,wBAAwB,EAAE,gBAAgB,CAAC;IAO3C,kBAAkB,EAAE,MAAM,CAAC;IAO3B,YAAY,EAAE,MAAM,CAAC;IAOrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAQhB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAOtB,SAAS,EAAE,MAAM,CAAC;IAOlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/ai/agent-response.dto.js

@@ -19,6 +19,8 @@ class AgentResponseDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -70,6 +72,23 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AgentResponseDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Integration provider used for audio transcription',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'OPENAI',
+    }),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], AgentResponseDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Model name used for audio transcription',
+        example: 'gpt-4o-mini-transcribe',
+    }),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentResponseDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'System prompt used by this agent',

package/dist/ai/create-agent.dto.d.ts

@@ -4,6 +4,8 @@ export declare class CreateAgentDto {
     unitId: number;
     integration: AiIntegrationDto;
     model: string;
+    transcriptionIntegration?: AiIntegrationDto;
+    transcriptionModel?: string;
     systemPrompt: string;
     temperature: number;
     active: boolean;

package/dist/ai/create-agent.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/create-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAOzB,MAAM,EAAE,MAAM,CAAC;IAQf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAQ9B,KAAK,EAAE,MAAM,CAAC;IAQd,YAAY,EAAE,MAAM,CAAC;IAWrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAShB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/create-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAOzB,MAAM,EAAE,MAAM,CAAC;IAQf,MAAM,EAAE,MAAM,CAAC;IAQf,WAAW,EAAE,gBAAgB,CAAC;IAQ9B,KAAK,EAAE,MAAM,CAAC;IAUd,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAU5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAQ5B,YAAY,EAAE,MAAM,CAAC;IAWrB,WAAW,EAAE,MAAM,CAAC;IAOpB,MAAM,EAAE,OAAO,CAAC;IAShB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/ai/create-agent.dto.js

@@ -18,6 +18,8 @@ class CreateAgentDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -61,6 +63,26 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Integration provider used specifically for audio transcription. Defaults to "integration" when omitted.',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'GEMINI',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], CreateAgentDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Model name used specifically for audio transcription. Defaults to "model" when omitted.',
+        example: 'gemini-2.0-flash',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateAgentDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'System prompt applied before user messages',

package/dist/ai/update-agent.dto.d.ts

@@ -3,6 +3,8 @@ export declare class UpdateAgentDto {
     unitId?: number;
     integration?: AiIntegrationDto;
     model?: string;
+    transcriptionIntegration?: AiIntegrationDto;
+    transcriptionModel?: string;
     systemPrompt?: string;
     temperature?: number;
     active?: boolean;

package/dist/ai/update-agent.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/update-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAQzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAS/B,KAAK,CAAC,EAAE,MAAM,CAAC;IASf,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,MAAM,CAAC,EAAE,OAAO,CAAC;IASjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../src/ai/update-agent.dto.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAQzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAS/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAUf,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;IAS5C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAS5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAYtB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,MAAM,CAAC,EAAE,OAAO,CAAC;IASjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAStB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/ai/update-agent.dto.js

@@ -17,6 +17,8 @@ class UpdateAgentDto {
     unitId;
     integration;
     model;
+    transcriptionIntegration;
+    transcriptionModel;
     systemPrompt;
     temperature;
     active;
@@ -54,6 +56,26 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], UpdateAgentDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Integration provider used specifically for audio transcription',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'OPENAI',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], UpdateAgentDto.prototype, "transcriptionIntegration", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Model name used specifically for audio transcription',
+        example: 'gpt-4o-mini-transcribe',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateAgentDto.prototype, "transcriptionModel", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'System prompt applied before user messages',

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

@@ -1,3 +1,3 @@
-export declare const APPOINTMENT_STATUSES: readonly ["pending", "processing", "sended", "finished"];
+export declare const APPOINTMENT_STATUSES: readonly ["pending", "processing", "sended", "finished", "canceled"];
 export type AppointmentStatusDto = (typeof APPOINTMENT_STATUSES)[number];
 //# sourceMappingURL=appointment-status.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"appointment-status.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-status.dto.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,0DAKvB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"appointment-status.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment-status.dto.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,sEAMvB,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}

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

@@ -6,4 +6,5 @@ exports.APPOINTMENT_STATUSES = [
     'processing',
     'sended',
     'finished',
+    'canceled',
 ];

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

@@ -6,6 +6,9 @@ export interface AppointmentDto {
     date: string;
     checkinCompleted: boolean;
     checkoutCompleted: boolean;
+    exitTime?: string;
+    observation?: string;
+    cancellationReason?: string;
     status: AppointmentStatusDto;
 }
 //# sourceMappingURL=appointment.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAMX,SAAS,EAAE,MAAM,CAAC;IAKlB,MAAM,EAAE,MAAM,CAAC;IAKf,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,OAAO,CAAC;IAK1B,iBAAiB,EAAE,OAAO,CAAC;IAK3B,MAAM,EAAE,oBAAoB,CAAC;CAC9B"}
+{"version":3,"file":"appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/appointment.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IAMX,SAAS,EAAE,MAAM,CAAC;IAKlB,MAAM,EAAE,MAAM,CAAC;IAKf,IAAI,EAAE,MAAM,CAAC;IAKb,gBAAgB,EAAE,OAAO,CAAC;IAK1B,iBAAiB,EAAE,OAAO,CAAC;IAK3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAKlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAK5B,MAAM,EAAE,oBAAoB,CAAC;CAC9B"}

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

@@ -5,6 +5,9 @@ export declare class CreateAppointmentDto {
     userId: string;
     checkinCompleted?: boolean;
     checkoutCompleted?: boolean;
+    exitTime?: string;
+    observation?: string;
+    cancellationReason?: string;
     status?: AppointmentStatusDto;
 }
 //# sourceMappingURL=create-appointment.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/create-appointment.dto.ts"],"names":[],"mappings":"AASA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAItF,qBAAa,oBAAoB;IAO/B,SAAS,EAAE,MAAM,CAAC;IAOlB,IAAI,EAAE,MAAM,CAAC;IAQb,MAAM,EAAE,MAAM,CAAC;IASf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAS3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAS5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B"}
+{"version":3,"file":"create-appointment.dto.d.ts","sourceRoot":"","sources":["../../src/appointments/create-appointment.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAAwB,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAItF,qBAAa,oBAAoB;IAO/B,SAAS,EAAE,MAAM,CAAC;IAOlB,IAAI,EAAE,MAAM,CAAC;IAQb,MAAM,EAAE,MAAM,CAAC;IASf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAS3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAQ5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAQlB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAS5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B"}

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

@@ -19,6 +19,9 @@ class CreateAppointmentDto {
     userId;
     checkinCompleted;
     checkoutCompleted;
+    exitTime;
+    observation;
+    cancellationReason;
     status;
 }
 exports.CreateAppointmentDto = CreateAppointmentDto;
@@ -68,6 +71,33 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], CreateAppointmentDto.prototype, "checkoutCompleted", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Horário de saída do atendimento (ISO 8601)',
+        example: '2026-03-15T14:45:00.000Z',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "exitTime", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Observação do agendamento',
+        example: 'Paciente solicitou prioridade no retorno.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "observation", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Motivo do cancelamento',
+        example: 'Paciente não compareceu.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateAppointmentDto.prototype, "cancellationReason", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Status do agendamento',

package/package.json

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

package/src/ai/agent-response.dto.ts

@@ -40,6 +40,21 @@ export class AgentResponseDto {
   @IsString()
   model: string;
 
+  @ApiProperty({
+    description: 'Integration provider used for audio transcription',
+    enum: AI_INTEGRATIONS,
+    example: 'OPENAI',
+  })
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration: AiIntegrationDto;
+
+  @ApiProperty({
+    description: 'Model name used for audio transcription',
+    example: 'gpt-4o-mini-transcribe',
+  })
+  @IsString()
+  transcriptionModel: string;
+
   @ApiProperty({
     description: 'System prompt used by this agent',
     example: 'You are a helpful assistant.',

package/src/ai/create-agent.dto.ts

@@ -45,6 +45,26 @@ export class CreateAgentDto {
   @IsNotEmpty()
   model: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Integration provider used specifically for audio transcription. Defaults to "integration" when omitted.',
+    enum: AI_INTEGRATIONS,
+    example: 'GEMINI',
+  })
+  @IsOptional()
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration?: AiIntegrationDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Model name used specifically for audio transcription. Defaults to "model" when omitted.',
+    example: 'gemini-2.0-flash',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  transcriptionModel?: string;
+
   @ApiProperty({
     description: 'System prompt applied before user messages',
     example: 'You are an assistant for healthcare front-desk tasks.',

package/src/ai/update-agent.dto.ts

@@ -40,6 +40,25 @@ export class UpdateAgentDto {
   @IsNotEmpty()
   model?: string;
 
+  @ApiPropertyOptional({
+    description:
+      'Integration provider used specifically for audio transcription',
+    enum: AI_INTEGRATIONS,
+    example: 'OPENAI',
+  })
+  @IsOptional()
+  @IsEnum(AI_INTEGRATIONS)
+  transcriptionIntegration?: AiIntegrationDto;
+
+  @ApiPropertyOptional({
+    description: 'Model name used specifically for audio transcription',
+    example: 'gpt-4o-mini-transcribe',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  transcriptionModel?: string;
+
   @ApiPropertyOptional({
     description: 'System prompt applied before user messages',
     example: 'You are a concise assistant for customer support.',

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

@@ -3,5 +3,6 @@ export const APPOINTMENT_STATUSES = [
     'processing',
     'sended',
     'finished',
+    'canceled',
 ] as const;
 export type AppointmentStatusDto = (typeof APPOINTMENT_STATUSES)[number];

package/src/appointments/appointment.dto.ts

@@ -29,6 +29,21 @@ export interface AppointmentDto {
   */
   checkoutCompleted: boolean;
   /*
+  * Horário de saída do atendimento (ISO 8601)
+  * @example '2026-03-15T14:45:00.000Z'
+  */
+  exitTime?: string;
+  /*
+  * Observação do agendamento
+  * @example 'Paciente solicitou prioridade no retorno.'
+  */
+  observation?: string;
+  /*
+  * Motivo do cancelamento
+  * @example 'Paciente não compareceu.'
+  */
+  cancellationReason?: string;
+  /*
   * Status do agendamento
   * @example 'pending'
   */

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

@@ -5,6 +5,7 @@ import {
   IsEnum,
   IsNotEmpty,
   IsOptional,
+  IsString,
   IsUUID,
 } from 'class-validator';
 import { APPOINTMENT_STATUSES, AppointmentStatusDto } from './appointment-status.dto';
@@ -53,6 +54,30 @@ export class CreateAppointmentDto {
   @IsBoolean()
   checkoutCompleted?: boolean;
 
+  @ApiPropertyOptional({
+    description: 'Horário de saída do atendimento (ISO 8601)',
+    example: '2026-03-15T14:45:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  exitTime?: string;
+
+  @ApiPropertyOptional({
+    description: 'Observação do agendamento',
+    example: 'Paciente solicitou prioridade no retorno.',
+  })
+  @IsOptional()
+  @IsString()
+  observation?: string;
+
+  @ApiPropertyOptional({
+    description: 'Motivo do cancelamento',
+    example: 'Paciente não compareceu.',
+  })
+  @IsOptional()
+  @IsString()
+  cancellationReason?: string;
+
   @ApiPropertyOptional({
     description: 'Status do agendamento',
     enum: APPOINTMENT_STATUSES,