tychat-contracts 1.0.60 → 1.0.62

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

@@ -3,5 +3,6 @@ export declare class AiIntegrationResponseDto {
     tenant: string;
     response: AiStructuredResponseDto;
     output?: string;
+    aiUsageId?: 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,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"}
+{"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;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

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

@@ -18,6 +18,7 @@ class AiIntegrationResponseDto {
     tenant;
     response;
     output;
+    aiUsageId;
 }
 exports.AiIntegrationResponseDto = AiIntegrationResponseDto;
 __decorate([
@@ -49,3 +50,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AiIntegrationResponseDto.prototype, "output", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'AI usage record ID generated after the generation call — used to link token costs to a conversation message',
+        example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AiIntegrationResponseDto.prototype, "aiUsageId", void 0);

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

@@ -0,0 +1,16 @@
+import { AiIntegrationDto } from './integration-provider.dto';
+/**
+ * Represents a persisted AI token-usage record returned by the API.
+ */
+export declare class AiUsageResponseDto {
+    id: string;
+    tenant: string;
+    unitId?: number;
+    integration: AiIntegrationDto;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    createdAt: string;
+}
+//# sourceMappingURL=ai-usage-response.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-usage-response.dto.d.ts","sourceRoot":"","sources":["../../src/ai/ai-usage-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;GAEG;AACH,qBAAa,kBAAkB;IAI7B,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,gBAAgB,CAAC;IAK9B,KAAK,EAAE,MAAM,CAAC;IAGd,YAAY,EAAE,MAAM,CAAC;IAGrB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,WAAW,EAAE,MAAM,CAAC;IAQpB,SAAS,EAAE,MAAM,CAAC;CACnB"}

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

@@ -0,0 +1,77 @@
+"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.AiUsageResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Represents a persisted AI token-usage record returned by the API.
+ */
+class AiUsageResponseDto {
+    id;
+    tenant;
+    unitId;
+    integration;
+    model;
+    promptTokens;
+    completionTokens;
+    totalTokens;
+    createdAt;
+}
+exports.AiUsageResponseDto = AiUsageResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'AI usage record UUID', example: 'a1b2c3d4-...' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiUsageResponseDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiUsageResponseDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], AiUsageResponseDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'AI integration used', example: 'OPENAI' }),
+    __metadata("design:type", String)
+], AiUsageResponseDto.prototype, "integration", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Model name', example: 'gpt-4.1-mini' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiUsageResponseDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Number of prompt tokens consumed', example: 120 }),
+    __metadata("design:type", Number)
+], AiUsageResponseDto.prototype, "promptTokens", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Number of completion tokens generated', example: 60 }),
+    __metadata("design:type", Number)
+], AiUsageResponseDto.prototype, "completionTokens", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total tokens (prompt + completion)', example: 180 }),
+    __metadata("design:type", Number)
+], AiUsageResponseDto.prototype, "totalTokens", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Creation timestamp (ISO 8601)',
+        example: '2024-01-01T00:00:00.000Z',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AiUsageResponseDto.prototype, "createdAt", void 0);

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

@@ -0,0 +1,14 @@
+import { AiIntegrationDto } from './integration-provider.dto';
+/**
+ * Payload used to persist an AI token-usage record after a generation call.
+ */
+export declare class CreateAiUsageDto {
+    tenant: string;
+    unitId?: number;
+    integration: AiIntegrationDto;
+    model: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+//# sourceMappingURL=create-ai-usage.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-ai-usage.dto.d.ts","sourceRoot":"","sources":["../../src/ai/create-ai-usage.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE/E;;GAEG;AACH,qBAAa,gBAAgB;IAI3B,MAAM,EAAE,MAAM,CAAC;IAMf,MAAM,CAAC,EAAE,MAAM,CAAC;IAIhB,WAAW,EAAE,gBAAgB,CAAC;IAK9B,KAAK,EAAE,MAAM,CAAC;IAKd,YAAY,EAAE,MAAM,CAAC;IAKrB,gBAAgB,EAAE,MAAM,CAAC;IAKzB,WAAW,EAAE,MAAM,CAAC;CACrB"}

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

@@ -0,0 +1,70 @@
+"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.CreateAiUsageDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const integration_provider_dto_1 = require("./integration-provider.dto");
+/**
+ * Payload used to persist an AI token-usage record after a generation call.
+ */
+class CreateAiUsageDto {
+    tenant;
+    unitId;
+    integration;
+    model;
+    promptTokens;
+    completionTokens;
+    totalTokens;
+}
+exports.CreateAiUsageDto = CreateAiUsageDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateAiUsageDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateAiUsageDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'AI integration used', enum: integration_provider_dto_1.AI_INTEGRATIONS }),
+    (0, class_validator_1.IsEnum)(integration_provider_dto_1.AI_INTEGRATIONS),
+    __metadata("design:type", String)
+], CreateAiUsageDto.prototype, "integration", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Model name used for generation', example: 'gpt-4.1-mini' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateAiUsageDto.prototype, "model", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Number of prompt tokens consumed', example: 120 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateAiUsageDto.prototype, "promptTokens", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Number of completion tokens generated', example: 60 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateAiUsageDto.prototype, "completionTokens", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Total tokens (prompt + completion)', example: 180 }),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateAiUsageDto.prototype, "totalTokens", void 0);

package/dist/ai/index.d.ts

@@ -6,4 +6,6 @@ export * from './ai-integration-request.dto';
 export * from './ai-integration-response.dto';
 export * from './list-models.dto';
 export * from './ai-action.dto';
+export * from './create-ai-usage.dto';
+export * from './ai-usage-response.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;AAClC,cAAc,iBAAiB,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;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/ai/index.js

@@ -22,3 +22,5 @@ __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);
+__exportStar(require("./create-ai-usage.dto"), exports);
+__exportStar(require("./ai-usage-response.dto"), exports);

package/dist/conversations/conversation-response.dto.d.ts

@@ -0,0 +1,16 @@
+import { ConversationTypeDto } from './conversation-type.dto';
+/**
+ * Represents a persisted conversation message returned by the API.
+ */
+export declare class ConversationResponseDto {
+    id: string;
+    tenant: string;
+    unitId?: number;
+    patientId: string;
+    sessionUuid: string;
+    type: ConversationTypeDto;
+    message: string;
+    aiUsageId?: string;
+    createdAt: string;
+}
+//# sourceMappingURL=conversation-response.dto.d.ts.map

package/dist/conversations/conversation-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,qBAAa,uBAAuB;IAIlC,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,WAAW,EAAE,MAAM,CAAC;IAMpB,IAAI,EAAE,mBAAmB,CAAC;IAQ1B,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/conversations/conversation-response.dto.js

@@ -0,0 +1,98 @@
+"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.ConversationResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Represents a persisted conversation message returned by the API.
+ */
+class ConversationResponseDto {
+    id;
+    tenant;
+    unitId;
+    patientId;
+    sessionUuid;
+    type;
+    message;
+    aiUsageId;
+    createdAt;
+}
+exports.ConversationResponseDto = ConversationResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Conversation message UUID', example: 'a1b2c3d4-...' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], ConversationResponseDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Patient identifier (e.g. phone number)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Session UUID grouping messages within the 24-hour window',
+        example: 'a1b2c3d4-...',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "sessionUuid", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Conversation type: "ia" or "human"',
+        example: 'ia',
+    }),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Message content',
+        example: 'Sure! Let me look up available slots for you.',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'AI usage record ID (only present when type is "ia")',
+        example: 'a1b2c3d4-...',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "aiUsageId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Creation timestamp (ISO 8601)',
+        example: '2024-01-01T00:00:00.000Z',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationResponseDto.prototype, "createdAt", void 0);

package/dist/conversations/conversation-session-response.dto.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents a conversation session record returned by the API.
+ * A session is valid for 24 hours from its start time.
+ */
+export declare class ConversationSessionResponseDto {
+    id: string;
+    sessionUuid: string;
+    tenant: string;
+    patientId: string;
+    unitId?: number;
+    startedAt: string;
+    expiresAt: string;
+}
+//# sourceMappingURL=conversation-session-response.dto.d.ts.map

package/dist/conversations/conversation-session-response.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-session-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-session-response.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,8BAA8B;IAIzC,EAAE,EAAE,MAAM,CAAC;IAQX,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IAQf,SAAS,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/conversations/conversation-session-response.dto.js

@@ -0,0 +1,81 @@
+"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.ConversationSessionResponseDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Represents a conversation session record returned by the API.
+ * A session is valid for 24 hours from its start time.
+ */
+class ConversationSessionResponseDto {
+    id;
+    sessionUuid;
+    tenant;
+    patientId;
+    unitId;
+    startedAt;
+    expiresAt;
+}
+exports.ConversationSessionResponseDto = ConversationSessionResponseDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Session primary key (UUID)', example: 'a1b2c3d4-...' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Session UUID used to group all messages within the 24-hour window',
+        example: 'a1b2c3d4-...',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "sessionUuid", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Patient identifier (e.g. phone number)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], ConversationSessionResponseDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Session start timestamp (ISO 8601)',
+        example: '2024-01-01T00:00:00.000Z',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "startedAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Session expiration timestamp (ISO 8601, 24 h after start)',
+        example: '2024-01-02T00:00:00.000Z',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConversationSessionResponseDto.prototype, "expiresAt", void 0);

package/dist/conversations/conversation-type.dto.d.ts

@@ -0,0 +1,3 @@
+export declare const CONVERSATION_TYPES: readonly ["ia", "human"];
+export type ConversationTypeDto = (typeof CONVERSATION_TYPES)[number];
+//# sourceMappingURL=conversation-type.dto.d.ts.map

package/dist/conversations/conversation-type.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-type.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-type.dto.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,0BAA2B,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/conversations/conversation-type.dto.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONVERSATION_TYPES = void 0;
+// Allowed conversation types.
+// "ia"    → patient interacting with the AI.
+// "human" → human staff member responding to the patient.
+exports.CONVERSATION_TYPES = ['ia', 'human'];

package/dist/conversations/create-conversation-session.dto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Payload used to obtain (or create) an active 24-hour conversation session
+ * for a given patient + tenant combination.
+ */
+export declare class CreateConversationSessionDto {
+    tenant: string;
+    patientId: string;
+    unitId?: number;
+}
+//# sourceMappingURL=create-conversation-session.dto.d.ts.map

package/dist/conversations/create-conversation-session.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-conversation-session.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation-session.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,4BAA4B;IAIvC,MAAM,EAAE,MAAM,CAAC;IAQf,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/conversations/create-conversation-session.dto.js

@@ -0,0 +1,46 @@
+"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.CreateConversationSessionDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Payload used to obtain (or create) an active 24-hour conversation session
+ * for a given patient + tenant combination.
+ */
+class CreateConversationSessionDto {
+    tenant;
+    patientId;
+    unitId;
+}
+exports.CreateConversationSessionDto = CreateConversationSessionDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateConversationSessionDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Patient identifier (e.g. phone number or WhatsApp id)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateConversationSessionDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateConversationSessionDto.prototype, "unitId", void 0);

package/dist/conversations/create-conversation.dto.d.ts

@@ -0,0 +1,15 @@
+import { ConversationTypeDto } from './conversation-type.dto';
+/**
+ * Payload used to persist a single conversation message.
+ * AiUsageId must be provided whenever type is "ia" so token costs can be tracked.
+ */
+export declare class CreateConversationDto {
+    tenant: string;
+    unitId?: number;
+    patientId: string;
+    sessionUuid: string;
+    type: ConversationTypeDto;
+    message: string;
+    aiUsageId?: string;
+}
+//# sourceMappingURL=create-conversation.dto.d.ts.map

package/dist/conversations/create-conversation.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-conversation.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;GAGG;AACH,qBAAa,qBAAqB;IAIhC,MAAM,EAAE,MAAM,CAAC;IAMf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAOlB,WAAW,EAAE,MAAM,CAAC;IASpB,IAAI,EAAE,mBAAmB,CAAC;IAQ1B,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/conversations/create-conversation.dto.js

@@ -0,0 +1,86 @@
+"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.CreateConversationDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const conversation_type_dto_1 = require("./conversation-type.dto");
+/**
+ * Payload used to persist a single conversation message.
+ * AiUsageId must be provided whenever type is "ia" so token costs can be tracked.
+ */
+class CreateConversationDto {
+    tenant;
+    unitId;
+    patientId;
+    sessionUuid;
+    type;
+    message;
+    aiUsageId;
+}
+exports.CreateConversationDto = CreateConversationDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Tenant slug', example: 'clinic-alpha' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Tenant unit id', example: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateConversationDto.prototype, "unitId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Patient identifier (e.g. phone number)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Session UUID that groups messages within the 24-hour window',
+        example: 'a1b2c3d4-...',
+    }),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "sessionUuid", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Conversation type: "ia" when the AI responds to the patient, "human" when a staff member responds',
+        enum: conversation_type_dto_1.CONVERSATION_TYPES,
+        example: 'ia',
+    }),
+    (0, class_validator_1.IsEnum)(conversation_type_dto_1.CONVERSATION_TYPES),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Message content',
+        example: 'Hello, I need to schedule an appointment.',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "message", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'AI usage record ID — required when type is "ia"',
+        example: 'a1b2c3d4-...',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateConversationDto.prototype, "aiUsageId", void 0);

package/dist/conversations/index.d.ts

@@ -0,0 +1,6 @@
+export * from './conversation-type.dto';
+export * from './create-conversation-session.dto';
+export * from './conversation-session-response.dto';
+export * from './create-conversation.dto';
+export * from './conversation-response.dto';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC"}

package/dist/conversations/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./conversation-type.dto"), exports);
+__exportStar(require("./create-conversation-session.dto"), exports);
+__exportStar(require("./conversation-session-response.dto"), exports);
+__exportStar(require("./create-conversation.dto"), exports);
+__exportStar(require("./conversation-response.dto"), exports);

package/dist/index.d.ts

@@ -12,4 +12,5 @@ export * from './ai';
 export * from './storage';
 export * from './notifications';
 export * from './tenants';
+export * from './conversations';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -28,3 +28,4 @@ __exportStar(require("./ai"), exports);
 __exportStar(require("./storage"), exports);
 __exportStar(require("./notifications"), exports);
 __exportStar(require("./tenants"), exports);
+__exportStar(require("./conversations"), exports);

package/dist/tenants/tenant-public-by-address-response.dto.d.ts

@@ -8,5 +8,7 @@ export declare class TenantPublicByAddressResponseDto {
     status: 'active' | 'inactive';
     dokploy_frontend_host: string;
     dokploy_backend_host: string;
+    logoWhite: string;
+    logoDark: string;
 }
 //# sourceMappingURL=tenant-public-by-address-response.dto.d.ts.map

package/dist/tenants/tenant-public-by-address-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-public-by-address-response.dto.d.ts","sourceRoot":"","sources":["../../src/tenants/tenant-public-by-address-response.dto.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,gCAAgC;IAE3C,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAO9B,qBAAqB,EAAE,MAAM,CAAC;IAO9B,oBAAoB,EAAE,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"tenant-public-by-address-response.dto.d.ts","sourceRoot":"","sources":["../../src/tenants/tenant-public-by-address-response.dto.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,gCAAgC;IAE3C,IAAI,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,MAAM,CAAC;IAGb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAGxB,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;IAO9B,qBAAqB,EAAE,MAAM,CAAC;IAO9B,oBAAoB,EAAE,MAAM,CAAC;IAO7B,SAAS,EAAE,MAAM,CAAC;IAOlB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/tenants/tenant-public-by-address-response.dto.js

@@ -21,6 +21,8 @@ class TenantPublicByAddressResponseDto {
     status;
     dokploy_frontend_host;
     dokploy_backend_host;
+    logoWhite;
+    logoDark;
 }
 exports.TenantPublicByAddressResponseDto = TenantPublicByAddressResponseDto;
 __decorate([
@@ -53,3 +55,17 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], TenantPublicByAddressResponseDto.prototype, "dokploy_backend_host", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'URL da logo do tenant para fundo claro',
+        example: 'https://cdn.seusistema.com/tenants/acme-logo-white.png',
+    }),
+    __metadata("design:type", String)
+], TenantPublicByAddressResponseDto.prototype, "logoWhite", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'URL da logo do tenant para fundo escuro',
+        example: 'https://cdn.seusistema.com/tenants/acme-logo-dark.png',
+    }),
+    __metadata("design:type", String)
+], TenantPublicByAddressResponseDto.prototype, "logoDark", void 0);

package/package.json

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

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

@@ -1,4 +1,4 @@
-import { ApiProperty } from '@nestjs/swagger';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { Type } from 'class-transformer';
 import { IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
 import { AiStructuredResponseDto } from './ai-action.dto';
@@ -29,4 +29,12 @@ export class AiIntegrationResponseDto {
   @IsString()
   @IsNotEmpty()
   output?: string;
+
+  @ApiPropertyOptional({
+    description: 'AI usage record ID generated after the generation call — used to link token costs to a conversation message',
+    example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890',
+  })
+  @IsOptional()
+  @IsString()
+  aiUsageId?: string;
 }

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

@@ -0,0 +1,47 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { AiIntegrationDto } from './integration-provider.dto';
+
+/**
+ * Represents a persisted AI token-usage record returned by the API.
+ */
+export class AiUsageResponseDto {
+  @ApiProperty({ description: 'AI usage record UUID', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({ description: 'AI integration used', example: 'OPENAI' })
+  integration: AiIntegrationDto;
+
+  @ApiProperty({ description: 'Model name', example: 'gpt-4.1-mini' })
+  @IsString()
+  @IsNotEmpty()
+  model: string;
+
+  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
+  promptTokens: number;
+
+  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
+  completionTokens: number;
+
+  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
+  totalTokens: number;
+
+  @ApiProperty({
+    description: 'Creation timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  createdAt: string;
+}

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

@@ -0,0 +1,43 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsEnum, IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { AI_INTEGRATIONS, AiIntegrationDto } from './integration-provider.dto';
+
+/**
+ * Payload used to persist an AI token-usage record after a generation call.
+ */
+export class CreateAiUsageDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
+  @ApiProperty({ description: 'AI integration used', enum: AI_INTEGRATIONS })
+  @IsEnum(AI_INTEGRATIONS)
+  integration: AiIntegrationDto;
+
+  @ApiProperty({ description: 'Model name used for generation', example: 'gpt-4.1-mini' })
+  @IsString()
+  @IsNotEmpty()
+  model: string;
+
+  @ApiProperty({ description: 'Number of prompt tokens consumed', example: 120 })
+  @IsInt()
+  @Min(0)
+  promptTokens: number;
+
+  @ApiProperty({ description: 'Number of completion tokens generated', example: 60 })
+  @IsInt()
+  @Min(0)
+  completionTokens: number;
+
+  @ApiProperty({ description: 'Total tokens (prompt + completion)', example: 180 })
+  @IsInt()
+  @Min(0)
+  totalTokens: number;
+}

package/src/ai/index.ts

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

package/src/conversations/conversation-response.dto.ts

@@ -0,0 +1,68 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { ConversationTypeDto } from './conversation-type.dto';
+
+/**
+ * Represents a persisted conversation message returned by the API.
+ */
+export class ConversationResponseDto {
+  @ApiProperty({ description: 'Conversation message UUID', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Patient identifier (e.g. phone number)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Session UUID grouping messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsString()
+  @IsNotEmpty()
+  sessionUuid: string;
+
+  @ApiProperty({
+    description: 'Conversation type: "ia" or "human"',
+    example: 'ia',
+  })
+  type: ConversationTypeDto;
+
+  @ApiProperty({
+    description: 'Message content',
+    example: 'Sure! Let me look up available slots for you.',
+  })
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+
+  @ApiPropertyOptional({
+    description: 'AI usage record ID (only present when type is "ia")',
+    example: 'a1b2c3d4-...',
+  })
+  @IsOptional()
+  @IsString()
+  aiUsageId?: string;
+
+  @ApiProperty({
+    description: 'Creation timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  createdAt: string;
+}

package/src/conversations/conversation-session-response.dto.ts

@@ -0,0 +1,54 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Represents a conversation session record returned by the API.
+ * A session is valid for 24 hours from its start time.
+ */
+export class ConversationSessionResponseDto {
+  @ApiProperty({ description: 'Session primary key (UUID)', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({
+    description: 'Session UUID used to group all messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsString()
+  @IsNotEmpty()
+  sessionUuid: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({
+    description: 'Patient identifier (e.g. phone number)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Session start timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  startedAt: string;
+
+  @ApiProperty({
+    description: 'Session expiration timestamp (ISO 8601, 24 h after start)',
+    example: '2024-01-02T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  expiresAt: string;
+}

package/src/conversations/conversation-type.dto.ts

@@ -0,0 +1,5 @@
+// Allowed conversation types.
+// "ia"    → patient interacting with the AI.
+// "human" → human staff member responding to the patient.
+export const CONVERSATION_TYPES = ['ia', 'human'] as const;
+export type ConversationTypeDto = (typeof CONVERSATION_TYPES)[number];

package/src/conversations/create-conversation-session.dto.ts

@@ -0,0 +1,27 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+
+/**
+ * Payload used to obtain (or create) an active 24-hour conversation session
+ * for a given patient + tenant combination.
+ */
+export class CreateConversationSessionDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({
+    description: 'Patient identifier (e.g. phone number or WhatsApp id)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+}

package/src/conversations/create-conversation.dto.ts

@@ -0,0 +1,68 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsEnum,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Min,
+} from 'class-validator';
+import { CONVERSATION_TYPES, ConversationTypeDto } from './conversation-type.dto';
+
+/**
+ * Payload used to persist a single conversation message.
+ * AiUsageId must be provided whenever type is "ia" so token costs can be tracked.
+ */
+export class CreateConversationDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Patient identifier (e.g. phone number)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Session UUID that groups messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsUUID()
+  sessionUuid: string;
+
+  @ApiProperty({
+    description:
+      'Conversation type: "ia" when the AI responds to the patient, "human" when a staff member responds',
+    enum: CONVERSATION_TYPES,
+    example: 'ia',
+  })
+  @IsEnum(CONVERSATION_TYPES)
+  type: ConversationTypeDto;
+
+  @ApiProperty({
+    description: 'Message content',
+    example: 'Hello, I need to schedule an appointment.',
+  })
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+
+  @ApiPropertyOptional({
+    description: 'AI usage record ID — required when type is "ia"',
+    example: 'a1b2c3d4-...',
+  })
+  @IsOptional()
+  @IsString()
+  aiUsageId?: string;
+}

package/src/conversations/index.ts

@@ -0,0 +1,5 @@
+export * from './conversation-type.dto';
+export * from './create-conversation-session.dto';
+export * from './conversation-session-response.dto';
+export * from './create-conversation.dto';
+export * from './conversation-response.dto';

package/src/index.ts

@@ -12,3 +12,4 @@ export * from './ai';
 export * from './storage';
 export * from './notifications';
 export * from './tenants';
+export * from './conversations';

package/src/tenants/tenant-public-by-address-response.dto.ts

@@ -29,4 +29,18 @@ export class TenantPublicByAddressResponseDto {
     example: 'acme-backend.tychat.app',
   })
   dokploy_backend_host: string;
+
+  @ApiProperty({
+    description:
+    'URL da logo do tenant para fundo claro',
+    example: 'https://cdn.seusistema.com/tenants/acme-logo-white.png',
+  })
+  logoWhite: string;
+
+  @ApiProperty({
+    description:
+    'URL da logo do tenant para fundo escuro',
+    example: 'https://cdn.seusistema.com/tenants/acme-logo-dark.png',
+  })
+  logoDark: string;
 }