tychat-contracts 1.0.38 → 1.0.40

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

@@ -2,6 +2,7 @@ import { AiIntegrationDto } from './integration-provider.dto';
 export declare class AgentResponseDto {
     id: string;
     tenant: string;
+    unitId: number;
     integration: AiIntegrationDto;
     model: string;
     systemPrompt: string;

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;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;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"}

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

@@ -16,6 +16,7 @@ const integration_provider_dto_1 = require("./integration-provider.dto");
 class AgentResponseDto {
     id;
     tenant;
+    unitId;
     integration;
     model;
     systemPrompt;
@@ -44,6 +45,14 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AgentResponseDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tenant unit id where this agent will be used',
+        example: 1,
+    }),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], AgentResponseDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Integration provider used by the agent',

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

@@ -1,7 +1,9 @@
 export declare class AiIntegrationRequestDto {
     tenant: string;
+    unitId?: number;
     message: string;
-    isDocument: boolean;
-    documentsUrl?: string[];
+    id: string;
+    is_document: boolean;
+    documents_url?: string[];
 }
 //# sourceMappingURL=ai-integration-request.dto.d.ts.map

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;IAQf,OAAO,EAAE,MAAM,CAAC;IAOhB,UAAU,EAAE,OAAO,CAAC;IAUpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
+{"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

@@ -14,9 +14,11 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 class AiIntegrationRequestDto {
     tenant;
+    unitId;
     message;
-    isDocument;
-    documentsUrl;
+    id;
+    is_document;
+    documents_url;
 }
 exports.AiIntegrationRequestDto = AiIntegrationRequestDto;
 __decorate([
@@ -28,6 +30,16 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AiIntegrationRequestDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tenant unit id used to select the active agent',
+        example: 1,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], AiIntegrationRequestDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'User message used as model input',
@@ -37,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',
@@ -44,7 +65,7 @@ __decorate([
     }),
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
-], AiIntegrationRequestDto.prototype, "isDocument", void 0);
+], AiIntegrationRequestDto.prototype, "is_document", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Document URLs used as additional context',
@@ -55,4 +76,4 @@ __decorate([
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
-], AiIntegrationRequestDto.prototype, "documentsUrl", void 0);
+], AiIntegrationRequestDto.prototype, "documents_url", void 0);

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/create-agent.dto.d.ts

@@ -1,6 +1,7 @@
 import { AiIntegrationDto } from './integration-provider.dto';
 export declare class CreateAgentDto {
     tenant: string;
+    unitId: number;
     integration: AiIntegrationDto;
     model: string;
     systemPrompt: string;

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":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAOzB,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;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"}

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

@@ -15,6 +15,7 @@ const class_validator_1 = require("class-validator");
 const integration_provider_dto_1 = require("./integration-provider.dto");
 class CreateAgentDto {
     tenant;
+    unitId;
     integration;
     model;
     systemPrompt;
@@ -33,6 +34,15 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], CreateAgentDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Tenant unit id where this agent will be used',
+        example: 1,
+    }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateAgentDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
         description: 'Integration provider used by the agent',

package/dist/ai/index.d.ts

@@ -4,4 +4,6 @@ export * from './update-agent.dto';
 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"}
+{"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

@@ -20,3 +20,5 @@ __exportStar(require("./update-agent.dto"), exports);
 __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/ai/list-models.dto.d.ts

@@ -0,0 +1,10 @@
+import { AiIntegrationDto } from './integration-provider.dto';
+export declare class ListAiModelsRequestDto {
+    integration: AiIntegrationDto;
+    apiKey?: string;
+}
+export declare class ListAiModelsResponseDto {
+    integration: AiIntegrationDto;
+    models: string[];
+}
+//# sourceMappingURL=list-models.dto.d.ts.map

package/dist/ai/list-models.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-models.dto.d.ts","sourceRoot":"","sources":["../../src/ai/list-models.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,sBAAsB;IAOjC,WAAW,EAAE,gBAAgB,CAAC;IAS9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAuB;IAOlC,WAAW,EAAE,gBAAgB,CAAC;IAS9B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/ai/list-models.dto.js

@@ -0,0 +1,62 @@
+"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.ListAiModelsResponseDto = exports.ListAiModelsRequestDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const integration_provider_dto_1 = require("./integration-provider.dto");
+class ListAiModelsRequestDto {
+    integration;
+    apiKey;
+}
+exports.ListAiModelsRequestDto = ListAiModelsRequestDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Integration provider to list available models',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'OPENAI',
+    }),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], ListAiModelsRequestDto.prototype, "integration", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Optional provider API key used to list models. Falls back to env key when omitted.',
+        example: 'sk-****',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ListAiModelsRequestDto.prototype, "apiKey", void 0);
+class ListAiModelsResponseDto {
+    integration;
+    models;
+}
+exports.ListAiModelsResponseDto = ListAiModelsResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Integration provider',
+        enum: integration_provider_dto_1.AI_INTEGRATIONS,
+        example: 'GEMINI',
+    }),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], ListAiModelsResponseDto.prototype, "integration", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Available model ids for the selected integration',
+        type: [String],
+        example: ['gpt-4.1-mini', 'gpt-4o-mini'],
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], ListAiModelsResponseDto.prototype, "models", void 0);

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

@@ -1,5 +1,6 @@
 import { AiIntegrationDto } from './integration-provider.dto';
 export declare class UpdateAgentDto {
+    unitId?: number;
     integration?: AiIntegrationDto;
     model?: string;
     systemPrompt?: string;

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":"AAWA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E,qBAAa,cAAc;IAQzB,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;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"}

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

@@ -14,6 +14,7 @@ const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const integration_provider_dto_1 = require("./integration-provider.dto");
 class UpdateAgentDto {
+    unitId;
     integration;
     model;
     systemPrompt;
@@ -23,6 +24,16 @@ class UpdateAgentDto {
     geminiApiKey;
 }
 exports.UpdateAgentDto = UpdateAgentDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Tenant unit id where this agent will be used',
+        example: 1,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], UpdateAgentDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiPropertyOptional)({
         description: 'Integration provider used by the agent',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.38",
+  "version": "1.0.40",
   "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/agent-response.dto.ts

@@ -18,6 +18,13 @@ export class AgentResponseDto {
   @IsNotEmpty()
   tenant: string;
 
+  @ApiProperty({
+    description: 'Tenant unit id where this agent will be used',
+    example: 1,
+  })
+  @IsNumber()
+  unitId: number;
+
   @ApiProperty({
     description: 'Integration provider used by the agent',
     enum: AI_INTEGRATIONS,

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

@@ -1,5 +1,5 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsArray, IsBoolean, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IsArray, IsBoolean, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
 
 export class AiIntegrationRequestDto {
   @ApiProperty({
@@ -10,6 +10,15 @@ export class AiIntegrationRequestDto {
   @IsNotEmpty()
   tenant: string;
 
+  @ApiPropertyOptional({
+    description: 'Tenant unit id used to select the active agent',
+    example: 1,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
   @ApiProperty({
     description: 'User message used as model input',
     example: 'Hello, how can I reschedule my appointment?',
@@ -18,12 +27,20 @@ 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,
   })
   @IsBoolean()
-  isDocument: boolean;
+  is_document: boolean;
 
   @ApiPropertyOptional({
     description: 'Document URLs used as additional context',
@@ -33,5 +50,5 @@ export class AiIntegrationRequestDto {
   @IsOptional()
   @IsArray()
   @IsString({ each: true })
-  documentsUrl?: string[];
+  documents_url?: string[];
 }

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/create-agent.dto.ts

@@ -1,5 +1,15 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsBoolean, IsEnum, IsNotEmpty, IsNumber, IsOptional, IsString, Max, Min } from 'class-validator';
+import {
+  IsBoolean,
+  IsEnum,
+  IsInt,
+  IsNotEmpty,
+  IsNumber,
+  IsOptional,
+  IsString,
+  Max,
+  Min,
+} from 'class-validator';
 import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
 
 export class CreateAgentDto {
@@ -11,6 +21,14 @@ export class CreateAgentDto {
   @IsNotEmpty()
   tenant: string;
 
+  @ApiProperty({
+    description: 'Tenant unit id where this agent will be used',
+    example: 1,
+  })
+  @IsInt()
+  @Min(1)
+  unitId: number;
+
   @ApiProperty({
     description: 'Integration provider used by the agent',
     enum: AI_INTEGRATIONS,

package/src/ai/index.ts

@@ -4,3 +4,5 @@ export * from './update-agent.dto';
 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/ai/list-models.dto.ts

@@ -0,0 +1,41 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
+import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
+
+export class ListAiModelsRequestDto {
+  @ApiProperty({
+    description: 'Integration provider to list available models',
+    enum: AI_INTEGRATIONS,
+    example: 'OPENAI',
+  })
+  @IsEnum(AI_INTEGRATIONS)
+  integration: AiIntegrationDto;
+
+  @ApiPropertyOptional({
+    description:
+      'Optional provider API key used to list models. Falls back to env key when omitted.',
+    example: 'sk-****',
+  })
+  @IsOptional()
+  @IsString()
+  apiKey?: string;
+}
+
+export class ListAiModelsResponseDto {
+  @ApiProperty({
+    description: 'Integration provider',
+    enum: AI_INTEGRATIONS,
+    example: 'GEMINI',
+  })
+  @IsEnum(AI_INTEGRATIONS)
+  integration: AiIntegrationDto;
+
+  @ApiProperty({
+    description: 'Available model ids for the selected integration',
+    type: [String],
+    example: ['gpt-4.1-mini', 'gpt-4o-mini'],
+  })
+  @IsArray()
+  @IsString({ each: true })
+  models: string[];
+}

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

@@ -2,6 +2,7 @@ import { ApiPropertyOptional } from '@nestjs/swagger';
 import {
   IsBoolean,
   IsEnum,
+  IsInt,
   IsNotEmpty,
   IsNumber,
   IsOptional,
@@ -12,6 +13,15 @@ import {
 import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
 
 export class UpdateAgentDto {
+  @ApiPropertyOptional({
+    description: 'Tenant unit id where this agent will be used',
+    example: 1,
+  })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
   @ApiPropertyOptional({
     description: 'Integration provider used by the agent',
     enum: AI_INTEGRATIONS,