tychat-contracts 1.0.39 → 1.0.41

package/dist/ai/ai-action.dto.d.ts

@@ -0,0 +1,27 @@
+export declare const AI_RESPONSE_TYPES: readonly ["message", "action"];
+export type AiResponseTypeDto = (typeof AI_RESPONSE_TYPES)[number];
+export declare const AI_ACTION_TYPES: readonly ["create_patient", "create_appointment", "cancel_appointment"];
+export type AiActionTypeDto = (typeof AI_ACTION_TYPES)[number];
+export declare class AiActionDataDto {
+    patientId?: string;
+    name?: string;
+    cpf?: string;
+    birthDate?: string;
+    hasDisability?: boolean;
+    disabilityDescription?: string;
+    initialObservation?: string;
+    observation?: string;
+    procedureIds?: string[];
+    userId?: string;
+    date?: string;
+    appointmentId?: string;
+    reason?: string;
+    missingFields?: string[];
+}
+export declare class AiStructuredResponseDto {
+    type: AiResponseTypeDto;
+    actionType?: AiActionTypeDto;
+    message?: string;
+    data?: AiActionDataDto;
+}
+//# sourceMappingURL=ai-action.dto.d.ts.map

package/dist/ai/ai-action.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-action.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-action.dto.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iBAAiB,gCAAiC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,eAAe,yEAIlB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,qBAAa,eAAe;IAO1B,SAAS,CAAC,EAAE,MAAM,CAAC;IASnB,IAAI,CAAC,EAAE,MAAM,CAAC;IASd,GAAG,CAAC,EAAE,MAAM,CAAC;IAQb,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,aAAa,CAAC,EAAE,OAAO,CAAC;IAQxB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAQ/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAQ5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAUrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAQxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,IAAI,CAAC,EAAE,MAAM,CAAC;IAQd,aAAa,CAAC,EAAE,MAAM,CAAC;IAQvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAUhB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,qBAAa,uBAAuB;IAOlC,IAAI,EAAE,iBAAiB,CAAC;IASxB,UAAU,CAAC,EAAE,eAAe,CAAC;IAQ7B,OAAO,CAAC,EAAE,MAAM,CAAC;IAOjB,IAAI,CAAC,EAAE,eAAe,CAAC;CACxB"}

package/dist/ai/ai-action.dto.js

@@ -0,0 +1,212 @@
+"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.AiStructuredResponseDto = exports.AiActionDataDto = exports.AI_ACTION_TYPES = exports.AI_RESPONSE_TYPES = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+exports.AI_RESPONSE_TYPES = ['message', 'action'];
+exports.AI_ACTION_TYPES = [
+    'create_patient',
+    'create_appointment',
+    'cancel_appointment',
+];
+class AiActionDataDto {
+    patientId;
+    name;
+    cpf;
+    birthDate;
+    hasDisability;
+    disabilityDescription;
+    initialObservation;
+    observation;
+    procedureIds;
+    userId;
+    date;
+    appointmentId;
+    reason;
+    missingFields;
+}
+exports.AiActionDataDto = AiActionDataDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Suggested patient id when the patient already exists',
+        example: '550e8400-e29b-41d4-a716-446655440000',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Patient full name',
+        example: 'Joao da Silva',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Patient CPF with 11 digits',
+        example: '12345678909',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(11, 11),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "cpf", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Patient birth date in ISO format (YYYY-MM-DD)',
+        example: '1990-01-01',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "birthDate", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Indicates whether the patient has a disability',
+        example: false,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], AiActionDataDto.prototype, "hasDisability", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Disability description when applicable',
+        example: 'Visual impairment',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "disabilityDescription", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Initial patient observation',
+        example: 'Patient has back pain for two weeks',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "initialObservation", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Optional observation for history',
+        example: 'Patient is allergic to penicillin',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "observation", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Procedure ids selected by the user',
+        type: [String],
+        example: ['550e8400-e29b-41d4-a716-446655440010'],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsUUID)('4', { each: true }),
+    __metadata("design:type", Array)
+], AiActionDataDto.prototype, "procedureIds", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Professional user id selected by the user',
+        example: '550e8400-e29b-41d4-a716-446655440001',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "userId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Requested appointment date/time in ISO format',
+        example: '2026-03-15T14:00:00.000Z',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsDateString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "date", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Existing appointment id for cancellation',
+        example: '550e8400-e29b-41d4-a716-446655440002',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "appointmentId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Optional human-readable reason or assistant notes',
+        example: 'User asked to cancel due to travel',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiActionDataDto.prototype, "reason", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Fields still required to complete the action',
+        type: [String],
+        example: ['cpf', 'birthDate'],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], AiActionDataDto.prototype, "missingFields", void 0);
+class AiStructuredResponseDto {
+    type;
+    actionType;
+    message;
+    data;
+}
+exports.AiStructuredResponseDto = AiStructuredResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Response type returned by AI',
+        enum: exports.AI_RESPONSE_TYPES,
+        example: 'action',
+    }),
+    (0, class_validator_1.IsEnum)(exports.AI_RESPONSE_TYPES),
+    __metadata("design:type", String)
+], AiStructuredResponseDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Action type when the response type is action',
+        enum: exports.AI_ACTION_TYPES,
+        example: 'create_patient',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(exports.AI_ACTION_TYPES),
+    __metadata("design:type", String)
+], AiStructuredResponseDto.prototype, "actionType", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Message returned to the user',
+        example: 'I need your CPF and birth date to create the patient.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiStructuredResponseDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Structured payload extracted from the conversation',
+        type: AiActionDataDto,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", AiActionDataDto)
+], AiStructuredResponseDto.prototype, "data", void 0);

package/dist/ai/ai-integration-request.dto.d.ts

@@ -2,6 +2,7 @@ export declare class AiIntegrationRequestDto {
     tenant: string;
     unitId?: number;
     message: string;
+    id: string;
     is_document: boolean;
     documents_url?: string[];
 }

package/dist/ai/ai-integration-request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-integration-request.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-integration-request.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,uBAAuB;IAOlC,MAAM,EAAE,MAAM,CAAC;IASf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,OAAO,EAAE,MAAM,CAAC;IAOhB,WAAW,EAAE,OAAO,CAAC;IAUrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"ai-integration-request.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-integration-request.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,uBAAuB;IAOlC,MAAM,EAAE,MAAM,CAAC;IASf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,OAAO,EAAE,MAAM,CAAC;IAQhB,EAAE,EAAE,MAAM,CAAC;IAOX,WAAW,EAAE,OAAO,CAAC;IAUrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B"}

package/dist/ai/ai-integration-request.dto.js

@@ -16,6 +16,7 @@ class AiIntegrationRequestDto {
     tenant;
     unitId;
     message;
+    id;
     is_document;
     documents_url;
 }
@@ -48,6 +49,15 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AiIntegrationRequestDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Conversation identifier used for context isolation',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiIntegrationRequestDto.prototype, "id", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Indicates whether the input is document-based',

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

@@ -1,5 +1,7 @@
+import { AiStructuredResponseDto } from './ai-action.dto';
 export declare class AiIntegrationResponseDto {
     tenant: string;
-    output: string;
+    response: AiStructuredResponseDto;
+    output?: string;
 }
 //# sourceMappingURL=ai-integration-response.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ai-integration-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-integration-response.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,wBAAwB;IAOnC,MAAM,EAAE,MAAM,CAAC;IAQf,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"ai-integration-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-integration-response.dto.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,qBAAa,wBAAwB;IAOnC,MAAM,EAAE,MAAM,CAAC;IAQf,QAAQ,EAAE,uBAAuB,CAAC;IAUlC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

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

@@ -11,9 +11,12 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiIntegrationResponseDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ai_action_dto_1 = require("./ai-action.dto");
 class AiIntegrationResponseDto {
     tenant;
+    response;
     output;
 }
 exports.AiIntegrationResponseDto = AiIntegrationResponseDto;
@@ -28,9 +31,20 @@ __decorate([
 ], AiIntegrationResponseDto.prototype, "tenant", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Model output content',
+        description: 'Structured AI response',
+        type: ai_action_dto_1.AiStructuredResponseDto,
+    }),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ai_action_dto_1.AiStructuredResponseDto),
+    __metadata("design:type", ai_action_dto_1.AiStructuredResponseDto)
+], AiIntegrationResponseDto.prototype, "response", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Model output content (legacy field, use response.message)',
         example: 'Sure, I can help you reschedule your appointment.',
+        required: false,
     }),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)

package/dist/ai/index.d.ts

@@ -5,4 +5,5 @@ export * from './agent-response.dto';
 export * from './ai-integration-request.dto';
 export * from './ai-integration-response.dto';
 export * from './list-models.dto';
+export * from './ai-action.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/ai/index.js

@@ -21,3 +21,4 @@ __exportStar(require("./agent-response.dto"), exports);
 __exportStar(require("./ai-integration-request.dto"), exports);
 __exportStar(require("./ai-integration-response.dto"), exports);
 __exportStar(require("./list-models.dto"), exports);
+__exportStar(require("./ai-action.dto"), exports);

package/dist/auth/login.dto.d.ts

@@ -1,5 +1,5 @@
 export declare class LoginDto {
-    username: string;
+    email: string;
     password: string;
 }
 //# sourceMappingURL=login.dto.d.ts.map

package/dist/auth/login.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"login.dto.d.ts","sourceRoot":"","sources":["../../src/auth/login.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,QAAQ;IAInB,QAAQ,EAAE,MAAM,CAAC;IAKjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"login.dto.d.ts","sourceRoot":"","sources":["../../src/auth/login.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,QAAQ;IAKnB,KAAK,EAAE,MAAM,CAAC;IAKd,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/auth/login.dto.js

@@ -13,16 +13,17 @@ exports.LoginDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 class LoginDto {
-    username;
+    email;
     password;
 }
 exports.LoginDto = LoginDto;
 __decorate([
-    (0, swagger_1.ApiProperty)({ description: 'Nome de usuário', example: 'usuario' }),
+    (0, swagger_1.ApiProperty)({ description: 'E-mail do usuário', example: 'usuario@empresa.com' }),
+    (0, class_validator_1.IsEmail)({}, { message: 'email deve ser um e-mail válido' }),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MinLength)(1, { message: 'username não pode ser vazio' }),
+    (0, class_validator_1.MinLength)(1, { message: 'email não pode ser vazio' }),
     __metadata("design:type", String)
-], LoginDto.prototype, "username", void 0);
+], LoginDto.prototype, "email", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Senha do usuário', example: 'senha123' }),
     (0, class_validator_1.IsString)(),

package/dist/patients/create-patient.dto.d.ts

@@ -2,6 +2,10 @@ export declare class CreatePatientDto {
     name: string;
     cpf: string;
     birthDate: string;
+    email?: string | null;
+    phone?: string | null;
+    gender?: string | null;
+    address?: string | null;
     hasDisability: boolean;
     disabilityDescription?: string | null;
     initialObservation?: string | null;

package/dist/patients/create-patient.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-patient.dto.d.ts","sourceRoot":"","sources":["../../src/patients/create-patient.dto.ts"],"names":[],"mappings":"AAYA,qBAAa,gBAAgB;IAS3B,IAAI,EAAE,MAAM,CAAC;IAUb,GAAG,EAAE,MAAM,CAAC;IAOZ,SAAS,EAAE,MAAM,CAAC;IAOlB,aAAa,EAAE,OAAO,CAAC;IAWvB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAYnC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}
+{"version":3,"file":"create-patient.dto.d.ts","sourceRoot":"","sources":["../../src/patients/create-patient.dto.ts"],"names":[],"mappings":"AAaA,qBAAa,gBAAgB;IAS3B,IAAI,EAAE,MAAM,CAAC;IAUb,GAAG,EAAE,MAAM,CAAC;IAOZ,SAAS,EAAE,MAAM,CAAC;IAUlB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAOxB,aAAa,EAAE,OAAO,CAAC;IAWvB,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUtC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAYnC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B"}

package/dist/patients/create-patient.dto.js

@@ -17,6 +17,10 @@ class CreatePatientDto {
     name;
     cpf;
     birthDate;
+    email;
+    phone;
+    gender;
+    address;
     hasDisability;
     disabilityDescription;
     initialObservation;
@@ -53,6 +57,50 @@ __decorate([
     (0, class_validator_1.IsDateString)(),
     __metadata("design:type", String)
 ], CreatePatientDto.prototype, "birthDate", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'E-mail do paciente',
+        example: 'joao.silva@email.com',
+        maxLength: 255,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEmail)({}, { message: 'email deve ser um e-mail válido' }),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", Object)
+], CreatePatientDto.prototype, "email", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Telefone de contato do paciente',
+        example: '+55 11 99999-9999',
+        maxLength: 30,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(30),
+    __metadata("design:type", Object)
+], CreatePatientDto.prototype, "phone", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Gênero do paciente',
+        example: 'masculino',
+        maxLength: 50,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(50),
+    __metadata("design:type", Object)
+], CreatePatientDto.prototype, "gender", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Endereço completo do paciente',
+        example: 'Rua Exemplo, 123 - São Paulo/SP',
+        maxLength: 500,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", Object)
+], CreatePatientDto.prototype, "address", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Indica se o paciente possui alguma deficiência',

package/dist/procedures/create-procedure.dto.d.ts

@@ -1,5 +1,10 @@
 export declare class CreateProcedureDto {
     name: string;
+    category?: string | null;
+    description?: string | null;
+    blockTime?: number | null;
+    defaultValue?: number | null;
+    returnDays?: number | null;
     value: number;
     duration: number;
     side_effects?: string | null;

package/dist/procedures/create-procedure.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-procedure.dto.d.ts","sourceRoot":"","sources":["../../src/procedures/create-procedure.dto.ts"],"names":[],"mappings":"AAWA,qBAAa,kBAAkB;IAS7B,IAAI,EAAE,MAAM,CAAC;IAQb,KAAK,EAAE,MAAM,CAAC;IAQd,QAAQ,EAAE,MAAM,CAAC;IAUjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ7B,WAAW,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"create-procedure.dto.d.ts","sourceRoot":"","sources":["../../src/procedures/create-procedure.dto.ts"],"names":[],"mappings":"AAYA,qBAAa,kBAAkB;IAS7B,IAAI,EAAE,MAAM,CAAC;IAUb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAUzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAS5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAS1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAS7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ3B,KAAK,EAAE,MAAM,CAAC;IAQd,QAAQ,EAAE,MAAM,CAAC;IAUjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ7B,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/procedures/create-procedure.dto.js

@@ -14,6 +14,11 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 class CreateProcedureDto {
     name;
+    category;
+    description;
+    blockTime;
+    defaultValue;
+    returnDays;
     value;
     duration;
     side_effects;
@@ -31,6 +36,58 @@ __decorate([
     (0, class_validator_1.MaxLength)(255),
     __metadata("design:type", String)
 ], CreateProcedureDto.prototype, "name", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Categoria do procedimento',
+        example: 'Consulta',
+        maxLength: 100,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], CreateProcedureDto.prototype, "category", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Descrição detalhada do procedimento',
+        example: 'Consulta clínica com anamnese e avaliação geral',
+        maxLength: 5000,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.MaxLength)(5000),
+    __metadata("design:type", Object)
+], CreateProcedureDto.prototype, "description", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tempo de bloqueio da agenda em minutos',
+        example: 30,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Object)
+], CreateProcedureDto.prototype, "blockTime", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Valor padrão sugerido para o procedimento',
+        example: 150.5,
+    }),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Object)
+], CreateProcedureDto.prototype, "defaultValue", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Quantidade de dias sugerida para retorno',
+        example: 30,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Object)
+], CreateProcedureDto.prototype, "returnDays", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Valor monetário do procedimento',

package/dist/users/create-user.dto.d.ts

@@ -6,7 +6,7 @@ export declare const CREATABLE_USER_ROLES: readonly ["attendant", "health_profes
 export type CreatableUserRole = (typeof CREATABLE_USER_ROLES)[number];
 export declare class CreateUserDto {
     name: string;
-    username: string;
+    email: string;
     password: string;
     role: CreatableUserRole;
 }

package/dist/users/create-user.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-user.dto.d.ts","sourceRoot":"","sources":["../../src/users/create-user.dto.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+CAAgD,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,qBAAa,aAAa;IASxB,IAAI,EAAE,MAAM,CAAC;IAUb,QAAQ,EAAE,MAAM,CAAC;IAUjB,QAAQ,EAAE,MAAM,CAAC;IAWjB,IAAI,EAAE,iBAAiB,CAAC;CACzB"}
+{"version":3,"file":"create-user.dto.d.ts","sourceRoot":"","sources":["../../src/users/create-user.dto.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+CAAgD,CAAC;AAClF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,qBAAa,aAAa;IASxB,IAAI,EAAE,MAAM,CAAC;IAWb,KAAK,EAAE,MAAM,CAAC;IAUd,QAAQ,EAAE,MAAM,CAAC;IAWjB,IAAI,EAAE,iBAAiB,CAAC;CACzB"}

package/dist/users/create-user.dto.js

@@ -19,7 +19,7 @@ const class_validator_1 = require("class-validator");
 exports.CREATABLE_USER_ROLES = ['attendant', 'health_professional'];
 class CreateUserDto {
     name;
-    username;
+    email;
     password;
     role;
 }
@@ -37,15 +37,16 @@ __decorate([
 ], CreateUserDto.prototype, "name", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Login do usuário (único no tenant)',
-        example: 'maria.silva',
+        description: 'E-mail do usuário (único no tenant)',
+        example: 'maria.silva@empresa.com',
         maxLength: 255,
     }),
+    (0, class_validator_1.IsEmail)({}, { message: 'email deve ser um e-mail válido' }),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MinLength)(1, { message: 'username não pode ser vazio' }),
+    (0, class_validator_1.MinLength)(1, { message: 'email não pode ser vazio' }),
     (0, class_validator_1.MaxLength)(255),
     __metadata("design:type", String)
-], CreateUserDto.prototype, "username", void 0);
+], CreateUserDto.prototype, "email", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Senha (será hasheada com bcrypt)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.39",
+  "version": "1.0.41",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,6 +12,7 @@
   "dependencies": {
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
+    "ioredis": "^5.10.0",
     "reflect-metadata": "*"
   },
   "devDependencies": {

package/src/ai/ai-action.dto.ts

@@ -0,0 +1,176 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsArray,
+  IsBoolean,
+  IsDateString,
+  IsEnum,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Length,
+} from 'class-validator';
+
+export const AI_RESPONSE_TYPES = ['message', 'action'] as const;
+export type AiResponseTypeDto = (typeof AI_RESPONSE_TYPES)[number];
+
+export const AI_ACTION_TYPES = [
+  'create_patient',
+  'create_appointment',
+  'cancel_appointment',
+] as const;
+export type AiActionTypeDto = (typeof AI_ACTION_TYPES)[number];
+
+export class AiActionDataDto {
+  @ApiPropertyOptional({
+    description: 'Suggested patient id when the patient already exists',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  patientId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Patient full name',
+    example: 'Joao da Silva',
+  })
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  name?: string;
+
+  @ApiPropertyOptional({
+    description: 'Patient CPF with 11 digits',
+    example: '12345678909',
+  })
+  @IsOptional()
+  @IsString()
+  @Length(11, 11)
+  cpf?: string;
+
+  @ApiPropertyOptional({
+    description: 'Patient birth date in ISO format (YYYY-MM-DD)',
+    example: '1990-01-01',
+  })
+  @IsOptional()
+  @IsDateString()
+  birthDate?: string;
+
+  @ApiPropertyOptional({
+    description: 'Indicates whether the patient has a disability',
+    example: false,
+  })
+  @IsOptional()
+  @IsBoolean()
+  hasDisability?: boolean;
+
+  @ApiPropertyOptional({
+    description: 'Disability description when applicable',
+    example: 'Visual impairment',
+  })
+  @IsOptional()
+  @IsString()
+  disabilityDescription?: string;
+
+  @ApiPropertyOptional({
+    description: 'Initial patient observation',
+    example: 'Patient has back pain for two weeks',
+  })
+  @IsOptional()
+  @IsString()
+  initialObservation?: string;
+
+  @ApiPropertyOptional({
+    description: 'Optional observation for history',
+    example: 'Patient is allergic to penicillin',
+  })
+  @IsOptional()
+  @IsString()
+  observation?: string;
+
+  @ApiPropertyOptional({
+    description: 'Procedure ids selected by the user',
+    type: [String],
+    example: ['550e8400-e29b-41d4-a716-446655440010'],
+  })
+  @IsOptional()
+  @IsArray()
+  @IsUUID('4', { each: true })
+  procedureIds?: string[];
+
+  @ApiPropertyOptional({
+    description: 'Professional user id selected by the user',
+    example: '550e8400-e29b-41d4-a716-446655440001',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  userId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Requested appointment date/time in ISO format',
+    example: '2026-03-15T14:00:00.000Z',
+  })
+  @IsOptional()
+  @IsDateString()
+  date?: string;
+
+  @ApiPropertyOptional({
+    description: 'Existing appointment id for cancellation',
+    example: '550e8400-e29b-41d4-a716-446655440002',
+  })
+  @IsOptional()
+  @IsUUID('4')
+  appointmentId?: string;
+
+  @ApiPropertyOptional({
+    description: 'Optional human-readable reason or assistant notes',
+    example: 'User asked to cancel due to travel',
+  })
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  @ApiPropertyOptional({
+    description: 'Fields still required to complete the action',
+    type: [String],
+    example: ['cpf', 'birthDate'],
+  })
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  missingFields?: string[];
+}
+
+export class AiStructuredResponseDto {
+  @ApiProperty({
+    description: 'Response type returned by AI',
+    enum: AI_RESPONSE_TYPES,
+    example: 'action',
+  })
+  @IsEnum(AI_RESPONSE_TYPES)
+  type: AiResponseTypeDto;
+
+  @ApiPropertyOptional({
+    description: 'Action type when the response type is action',
+    enum: AI_ACTION_TYPES,
+    example: 'create_patient',
+  })
+  @IsOptional()
+  @IsEnum(AI_ACTION_TYPES)
+  actionType?: AiActionTypeDto;
+
+  @ApiPropertyOptional({
+    description: 'Message returned to the user',
+    example: 'I need your CPF and birth date to create the patient.',
+  })
+  @IsOptional()
+  @IsString()
+  message?: string;
+
+  @ApiPropertyOptional({
+    description: 'Structured payload extracted from the conversation',
+    type: AiActionDataDto,
+  })
+  @IsOptional()
+  data?: AiActionDataDto;
+}

package/src/ai/ai-integration-request.dto.ts

@@ -27,6 +27,14 @@ export class AiIntegrationRequestDto {
   @IsNotEmpty()
   message: string;
 
+  @ApiProperty({
+    description: 'Conversation identifier used for context isolation',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
   @ApiProperty({
     description: 'Indicates whether the input is document-based',
     example: false,

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

@@ -1,5 +1,7 @@
 import { ApiProperty } from '@nestjs/swagger';
-import { IsNotEmpty, IsString } from 'class-validator';
+import { Type } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { AiStructuredResponseDto } from './ai-action.dto';
 
 export class AiIntegrationResponseDto {
   @ApiProperty({
@@ -11,10 +13,20 @@ export class AiIntegrationResponseDto {
   tenant: string;
 
   @ApiProperty({
-    description: 'Model output content',
+    description: 'Structured AI response',
+    type: AiStructuredResponseDto,
+  })
+  @ValidateNested()
+  @Type(() => AiStructuredResponseDto)
+  response: AiStructuredResponseDto;
+
+  @ApiProperty({
+    description: 'Model output content (legacy field, use response.message)',
     example: 'Sure, I can help you reschedule your appointment.',
+    required: false,
   })
+  @IsOptional()
   @IsString()
   @IsNotEmpty()
-  output: string;
+  output?: string;
 }

package/src/ai/index.ts

@@ -5,3 +5,4 @@ export * from './agent-response.dto';
 export * from './ai-integration-request.dto';
 export * from './ai-integration-response.dto';
 export * from './list-models.dto';
+export * from './ai-action.dto';

package/src/auth/login.dto.ts

@@ -1,11 +1,12 @@
 import { ApiProperty } from '@nestjs/swagger';
-import { IsString, MinLength } from 'class-validator';
+import { IsEmail, IsString, MinLength } from 'class-validator';
 
 export class LoginDto {
-  @ApiProperty({ description: 'Nome de usuário', example: 'usuario' })
+  @ApiProperty({ description: 'E-mail do usuário', example: 'usuario@empresa.com' })
+  @IsEmail({}, { message: 'email deve ser um e-mail válido' })
   @IsString()
-  @MinLength(1, { message: 'username não pode ser vazio' })
-  username: string;
+  @MinLength(1, { message: 'email não pode ser vazio' })
+  email: string;
 
   @ApiProperty({ description: 'Senha do usuário', example: 'senha123' })
   @IsString()

package/src/patients/create-patient.dto.ts

@@ -2,6 +2,7 @@ import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import {
   IsBoolean,
   IsDateString,
+  IsEmail,
   IsNotEmpty,
   IsOptional,
   IsString,
@@ -38,6 +39,46 @@ export class CreatePatientDto {
   @IsDateString()
   birthDate: string;
 
+  @ApiPropertyOptional({
+    description: 'E-mail do paciente',
+    example: 'joao.silva@email.com',
+    maxLength: 255,
+  })
+  @IsOptional()
+  @IsEmail({}, { message: 'email deve ser um e-mail válido' })
+  @MaxLength(255)
+  email?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Telefone de contato do paciente',
+    example: '+55 11 99999-9999',
+    maxLength: 30,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(30)
+  phone?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Gênero do paciente',
+    example: 'masculino',
+    maxLength: 50,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(50)
+  gender?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Endereço completo do paciente',
+    example: 'Rua Exemplo, 123 - São Paulo/SP',
+    maxLength: 500,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(500)
+  address?: string | null;
+
   @ApiProperty({
     description: 'Indica se o paciente possui alguma deficiência',
     example: true,

package/src/procedures/create-procedure.dto.ts

@@ -1,5 +1,6 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import {
+  IsInt,
   IsNotEmpty,
   IsNumber,
   IsOptional,
@@ -20,6 +21,53 @@ export class CreateProcedureDto {
   @MaxLength(255)
   name: string;
 
+  @ApiPropertyOptional({
+    description: 'Categoria do procedimento',
+    example: 'Consulta',
+    maxLength: 100,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(100)
+  category?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Descrição detalhada do procedimento',
+    example: 'Consulta clínica com anamnese e avaliação geral',
+    maxLength: 5000,
+  })
+  @IsString()
+  @IsOptional()
+  @MaxLength(5000)
+  description?: string | null;
+
+  @ApiPropertyOptional({
+    description: 'Tempo de bloqueio da agenda em minutos',
+    example: 30,
+  })
+  @IsInt()
+  @IsOptional()
+  @Min(1)
+  blockTime?: number | null;
+
+  @ApiPropertyOptional({
+    description: 'Valor padrão sugerido para o procedimento',
+    example: 150.5,
+  })
+  @IsNumber({ maxDecimalPlaces: 2 })
+  @IsOptional()
+  @Min(0)
+  defaultValue?: number | null;
+
+  @ApiPropertyOptional({
+    description: 'Quantidade de dias sugerida para retorno',
+    example: 30,
+  })
+  @IsInt()
+  @IsOptional()
+  @Min(0)
+  returnDays?: number | null;
+
   @ApiProperty({
     description: 'Valor monetário do procedimento',
     example: 150.5,

package/src/users/create-user.dto.ts

@@ -1,5 +1,6 @@
 import { ApiProperty } from '@nestjs/swagger';
 import {
+  IsEmail,
   IsString,
   IsIn,
   MinLength,
@@ -25,14 +26,15 @@ export class CreateUserDto {
   name: string;
 
   @ApiProperty({
-    description: 'Login do usuário (único no tenant)',
-    example: 'maria.silva',
+    description: 'E-mail do usuário (único no tenant)',
+    example: 'maria.silva@empresa.com',
     maxLength: 255,
   })
+  @IsEmail({}, { message: 'email deve ser um e-mail válido' })
   @IsString()
-  @MinLength(1, { message: 'username não pode ser vazio' })
+  @MinLength(1, { message: 'email não pode ser vazio' })
   @MaxLength(255)
-  username: string;
+  email: string;
 
   @ApiProperty({
     description: 'Senha (será hasheada com bcrypt)',