glirastes 0.3.0 → 0.3.1

package/dist/cjs/server/adapters/nestjs/chat/ai-chat.module.d.ts

@@ -0,0 +1,9 @@
+import { DynamicModule } from '@nestjs/common';
+import type { INestApplication } from '@nestjs/common';
+import { type AiChatModuleAsyncOptions, type AiChatModuleOptions } from './ai-chat-module-options.interface.js';
+export declare class AiChatModule {
+    private static initialized;
+    static forRoot(options: AiChatModuleOptions): DynamicModule;
+    static forRootAsync(asyncOptions: AiChatModuleAsyncOptions): DynamicModule;
+    static attachWebSockets(app: INestApplication): Promise<void>;
+}

package/dist/cjs/server/adapters/nestjs/chat/ai-chat.module.js

@@ -0,0 +1,119 @@
+"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 AiChatModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiChatModule = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const core_1 = require("@nestjs/core");
+const ai_tools_explorer_service_js_1 = require("../module/ai-tools-explorer.service.js");
+const ai_tools_service_js_1 = require("../module/ai-tools.service.js");
+const ai_tools_module_js_1 = require("../module/ai-tools.module.js");
+const ws_loader_js_1 = require("./ws-loader.js");
+const ai_chat_controller_js_1 = require("./ai-chat.controller.js");
+const ai_chat_service_js_1 = require("./ai-chat.service.js");
+const ai_chat_module_options_interface_js_1 = require("./ai-chat-module-options.interface.js");
+const speech_stream_gateway_js_1 = require("./speech-stream.gateway.js");
+const ai_chat_auth_guard_js_1 = require("./ai-chat-auth.guard.js");
+let AiChatModule = class AiChatModule {
+    static { AiChatModule_1 = this; }
+    static initialized = false;
+    static forRoot(options) {
+        AiChatModule_1.initialized = true;
+        const aiProviders = (0, ai_tools_module_js_1.createAiToolsProviders)();
+        return {
+            module: AiChatModule_1,
+            imports: [core_1.DiscoveryModule],
+            controllers: [ai_chat_controller_js_1.AiChatController],
+            providers: [
+                {
+                    provide: ai_chat_module_options_interface_js_1.AI_CHAT_MODULE_OPTIONS,
+                    useValue: options,
+                },
+                {
+                    provide: ai_tools_explorer_service_js_1.AiToolsExplorerService,
+                    useFactory: (discoveryService, reflector) => aiProviders.createExplorer(discoveryService, reflector),
+                    inject: [core_1.DiscoveryService, core_1.Reflector],
+                },
+                {
+                    provide: ai_tools_service_js_1.AiToolsService,
+                    useFactory: (explorer) => aiProviders.createService(explorer),
+                    inject: [ai_tools_explorer_service_js_1.AiToolsExplorerService],
+                },
+                ai_chat_auth_guard_js_1.AiChatAuthGuard,
+                ai_chat_service_js_1.AiChatService,
+            ],
+            exports: [ai_tools_service_js_1.AiToolsService],
+        };
+    }
+    static forRootAsync(asyncOptions) {
+        AiChatModule_1.initialized = true;
+        return {
+            module: AiChatModule_1,
+            imports: [core_1.DiscoveryModule, ...(asyncOptions.imports ?? [])],
+            controllers: [ai_chat_controller_js_1.AiChatController],
+            providers: [
+                {
+                    provide: ai_chat_module_options_interface_js_1.AI_CHAT_MODULE_OPTIONS,
+                    useFactory: asyncOptions.useFactory,
+                    inject: asyncOptions.inject ?? [],
+                },
+                {
+                    provide: ai_tools_explorer_service_js_1.AiToolsExplorerService,
+                    useFactory: (_options, discoveryService, reflector) => {
+                        const aiProviders = (0, ai_tools_module_js_1.createAiToolsProviders)();
+                        return aiProviders.createExplorer(discoveryService, reflector);
+                    },
+                    inject: [ai_chat_module_options_interface_js_1.AI_CHAT_MODULE_OPTIONS, core_1.DiscoveryService, core_1.Reflector],
+                },
+                {
+                    provide: ai_tools_service_js_1.AiToolsService,
+                    useFactory: (explorer) => new ai_tools_service_js_1.AiToolsService(explorer),
+                    inject: [ai_tools_explorer_service_js_1.AiToolsExplorerService],
+                },
+                ai_chat_auth_guard_js_1.AiChatAuthGuard,
+                ai_chat_service_js_1.AiChatService,
+            ],
+            exports: [ai_tools_service_js_1.AiToolsService],
+        };
+    }
+    static async attachWebSockets(app) {
+        if (!AiChatModule_1.initialized) {
+            throw new Error('AiChatModule.forRoot() or forRootAsync() must be called before attachWebSockets()');
+        }
+        const options = app.get(ai_chat_module_options_interface_js_1.AI_CHAT_MODULE_OPTIONS);
+        if (!options?.features?.speechToText) {
+            return;
+        }
+        const logger = new common_1.Logger('AiChatModule');
+        const configService = app.get(config_1.ConfigService);
+        const deepgramKey = configService.get('DEEPGRAM_API_KEY');
+        if (!deepgramKey) {
+            throw new Error('DEEPGRAM_API_KEY environment variable is required when speechToText feature is enabled');
+        }
+        const { WebSocketServer } = await (0, ws_loader_js_1.loadWs)();
+        const httpServer = app.getHttpServer();
+        const wss = new WebSocketServer({ noServer: true });
+        const handleSpeechStream = (0, speech_stream_gateway_js_1.createSpeechStreamHandler)(configService);
+        httpServer.on('upgrade', (req, socket, head) => {
+            if (req.url?.startsWith('/api/ai/speech-stream')) {
+                wss.handleUpgrade(req, socket, head, (ws) => {
+                    handleSpeechStream(ws, req);
+                });
+            }
+            else {
+                socket.destroy();
+            }
+        });
+        logger.log('Speech-to-text WebSocket attached at /api/ai/speech-stream');
+    }
+};
+exports.AiChatModule = AiChatModule;
+exports.AiChatModule = AiChatModule = AiChatModule_1 = __decorate([
+    (0, common_1.Module)({})
+], AiChatModule);

package/dist/cjs/server/adapters/nestjs/chat/ai-chat.service.d.ts

@@ -0,0 +1,13 @@
+import { AiToolsService } from '../module/ai-tools.service.js';
+import { ConfigService } from '@nestjs/config';
+import type { ChatMessageDto } from './dto/index.js';
+import { type AiChatModuleOptions } from './ai-chat-module-options.interface.js';
+export declare class AiChatService {
+    private readonly options;
+    private readonly aiToolsService;
+    private readonly configService;
+    private readonly logger;
+    constructor(options: AiChatModuleOptions | null, aiToolsService: AiToolsService, configService: ConfigService);
+    streamChat(messages: ChatMessageDto[], authHeader: string): Promise<Response>;
+    private getInternalApiUrl;
+}

package/dist/cjs/server/adapters/nestjs/chat/ai-chat.service.js

@@ -0,0 +1,131 @@
+"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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var AiChatService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AiChatService = void 0;
+const common_1 = require("@nestjs/common");
+const ai_tools_service_js_1 = require("../module/ai-tools.service.js");
+const index_js_1 = require("../../../core/index.js");
+const types_js_1 = require("../../../../types.js");
+const config_1 = require("@nestjs/config");
+const ai_1 = require("ai");
+const ai_chat_module_options_interface_js_1 = require("./ai-chat-module-options.interface.js");
+function wrapToolsForVercelAi(sdkTools) {
+    const wrapped = {};
+    for (const [name, raw] of Object.entries(sdkTools)) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const t = raw;
+        wrapped[name] = (0, ai_1.tool)({
+            description: t.description,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            inputSchema: (0, ai_1.zodSchema)(t.parameters),
+            needsApproval: t.needsApproval,
+            execute: t.execute,
+        });
+    }
+    return wrapped;
+}
+let AiChatService = AiChatService_1 = class AiChatService {
+    options;
+    aiToolsService;
+    configService;
+    logger = new common_1.Logger(AiChatService_1.name);
+    constructor(options, aiToolsService, configService) {
+        this.options = options;
+        this.aiToolsService = aiToolsService;
+        this.configService = configService;
+    }
+    async streamChat(messages, authHeader) {
+        if (!this.options) {
+            throw new common_1.ServiceUnavailableException('AI chat is not configured');
+        }
+        const options = this.options;
+        const toolContext = {
+            currentDate: new Date(),
+            locale: 'en-US',
+            callEndpoint: (0, index_js_1.createFetchInternalApiCaller)({
+                baseUrl: this.getInternalApiUrl(),
+                defaultHeaders: { Authorization: authHeader },
+            }),
+        };
+        const registry = this.aiToolsService.buildToolRegistry();
+        const sdkTools = await (0, index_js_1.toolsToAiTools)(registry, toolContext, {
+            onError: (toolId, error) => {
+                this.logger.error(`Tool "${toolId}" execution error: ${error}`, error instanceof Error ? error.stack : undefined);
+            },
+            onAudit: options.onAudit,
+            sessionId: `nestjs-${Date.now()}`,
+        });
+        const vercelTools = wrapToolsForVercelAi(sdkTools);
+        this.logger.log(`Chat request, ${Object.keys(vercelTools).length} tools available`);
+        this.logger.debug(`Available tools: ${Object.keys(vercelTools).join(', ')}`);
+        const currentDate = new Date().toISOString().split('T')[0];
+        let systemPrompt = typeof options.systemPrompt === 'function'
+            ? options.systemPrompt({ currentDate })
+            : options.systemPrompt;
+        // Apply runtime prompt overrides from Glirastes (Pro feature)
+        if (options.lancer) {
+            try {
+                const configResult = await options.lancer.config.fetch(['prompts']);
+                const prompts = configResult.prompts;
+                // Apply first matching override (NestJS adapter doesn't classify intents yet,
+                // so apply if there's a single module override as a reasonable default)
+                if (prompts && prompts.length === 1) {
+                    systemPrompt = (0, types_js_1.applyPromptOverride)(systemPrompt, prompts[0]);
+                }
+            }
+            catch {
+                // Graceful degradation: use local prompt
+            }
+        }
+        const modelMessages = await (0, ai_1.convertToModelMessages)(messages);
+        this.logger.debug(`Model messages: ${JSON.stringify(modelMessages.map((m) => ({ role: m.role, contentLength: JSON.stringify(m.content).length })))}`);
+        const maxSteps = options.maxSteps ?? 4;
+        const stream = (0, ai_1.createUIMessageStream)({
+            execute: async ({ writer }) => {
+                const result = (0, ai_1.streamText)({
+                    model: options.model,
+                    system: systemPrompt,
+                    messages: modelMessages,
+                    tools: vercelTools,
+                    stopWhen: (0, ai_1.stepCountIs)(maxSteps),
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    onStepFinish: (step) => {
+                        this.logger.debug(`Step finished: toolCalls=${JSON.stringify(step.toolCalls)}, toolResults=${JSON.stringify(step.toolResults)}, finishReason=${step.finishReason}`);
+                    },
+                });
+                writer.merge(result.toUIMessageStream());
+                try {
+                    await result.response;
+                }
+                catch (error) {
+                    this.logger.error(`Stream error: ${error}`, error instanceof Error ? error.stack : undefined);
+                    throw error;
+                }
+            },
+        });
+        return (0, ai_1.createUIMessageStreamResponse)({ stream });
+    }
+    getInternalApiUrl() {
+        const port = this.configService.get('PORT', 3001);
+        return `http://localhost:${port}/api`;
+    }
+};
+exports.AiChatService = AiChatService;
+exports.AiChatService = AiChatService = AiChatService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(ai_chat_module_options_interface_js_1.AI_CHAT_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, ai_tools_service_js_1.AiToolsService,
+        config_1.ConfigService])
+], AiChatService);

package/dist/cjs/server/adapters/nestjs/chat/dto/ai-chat-request.dto.d.ts

@@ -0,0 +1,7 @@
+import { ChatMessageDto } from './chat-message.dto.js';
+export declare class AiChatRequestDto {
+    id?: string;
+    messages: ChatMessageDto[];
+    trigger?: string;
+    messageId?: string;
+}

package/dist/cjs/server/adapters/nestjs/chat/dto/ai-chat-request.dto.js

@@ -0,0 +1,52 @@
+"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.AiChatRequestDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const chat_message_dto_js_1 = require("./chat-message.dto.js");
+class AiChatRequestDto {
+    id;
+    messages;
+    trigger;
+    messageId;
+}
+exports.AiChatRequestDto = AiChatRequestDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Unique chat session identifier sent by the Vercel AI SDK transport' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], AiChatRequestDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Chat messages in Vercel AI SDK UIMessage format',
+        type: [chat_message_dto_js_1.ChatMessageDto],
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => chat_message_dto_js_1.ChatMessageDto),
+    __metadata("design:type", Array)
+], AiChatRequestDto.prototype, "messages", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Trigger type: submit-message or regenerate-message' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], AiChatRequestDto.prototype, "trigger", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'ID of the message to regenerate (for regenerate-message trigger)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], AiChatRequestDto.prototype, "messageId", void 0);

package/dist/cjs/server/adapters/nestjs/chat/dto/chat-message-part.dto.d.ts

@@ -0,0 +1,19 @@
+export declare class ChatMessagePartDto {
+    type: string;
+    text?: string;
+    state?: string;
+    toolInvocation?: unknown;
+    toolCallId?: string;
+    toolName?: string;
+    input?: unknown;
+    output?: unknown;
+    approval?: unknown;
+    providerExecuted?: boolean;
+    callProviderMetadata?: unknown;
+    errorText?: string;
+    providerMetadata?: unknown;
+    data?: unknown;
+    source?: unknown;
+    mimeType?: unknown;
+    url?: unknown;
+}

package/dist/cjs/server/adapters/nestjs/chat/dto/chat-message-part.dto.js

@@ -0,0 +1,108 @@
+"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.ChatMessagePartDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+class ChatMessagePartDto {
+    type;
+    text;
+    state;
+    toolInvocation;
+    toolCallId;
+    toolName;
+    input;
+    output;
+    approval;
+    providerExecuted;
+    callProviderMetadata;
+    errorText;
+    providerMetadata;
+    data;
+    source;
+    mimeType;
+    url;
+}
+exports.ChatMessagePartDto = ChatMessagePartDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'The type of the message part (e.g. text, tool-invocation)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "type", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The text content of this part' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "text", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Streaming state of the part' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "state", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "toolInvocation", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "toolCallId", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "toolName", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "input", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "output", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "approval", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Boolean)
+], ChatMessagePartDto.prototype, "providerExecuted", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "callProviderMetadata", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", String)
+], ChatMessagePartDto.prototype, "errorText", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "providerMetadata", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "source", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "mimeType", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessagePartDto.prototype, "url", void 0);

package/dist/cjs/server/adapters/nestjs/chat/dto/chat-message.dto.d.ts

@@ -0,0 +1,8 @@
+import { ChatMessagePartDto } from './chat-message-part.dto.js';
+export declare class ChatMessageDto {
+    id?: string;
+    role: string;
+    content?: string;
+    parts?: ChatMessagePartDto[];
+    metadata?: unknown;
+}

package/dist/cjs/server/adapters/nestjs/chat/dto/chat-message.dto.js

@@ -0,0 +1,59 @@
+"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.ChatMessageDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const chat_message_part_dto_js_1 = require("./chat-message-part.dto.js");
+class ChatMessageDto {
+    id;
+    role;
+    content;
+    parts;
+    metadata;
+}
+exports.ChatMessageDto = ChatMessageDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Unique message identifier' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ChatMessageDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'The role of the message sender (e.g. user, assistant)',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ChatMessageDto.prototype, "role", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'The text content of the message (legacy format)' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], ChatMessageDto.prototype, "content", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Message parts in Vercel AI SDK UIMessage format',
+        type: [chat_message_part_dto_js_1.ChatMessagePartDto],
+    }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => chat_message_part_dto_js_1.ChatMessagePartDto),
+    __metadata("design:type", Array)
+], ChatMessageDto.prototype, "parts", void 0);
+__decorate([
+    (0, class_validator_1.Allow)(),
+    __metadata("design:type", Object)
+], ChatMessageDto.prototype, "metadata", void 0);

package/dist/cjs/server/adapters/nestjs/chat/dto/index.d.ts

@@ -0,0 +1,3 @@
+export { AiChatRequestDto } from './ai-chat-request.dto.js';
+export { ChatMessageDto } from './chat-message.dto.js';
+export { ChatMessagePartDto } from './chat-message-part.dto.js';

package/dist/cjs/server/adapters/nestjs/chat/dto/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatMessagePartDto = exports.ChatMessageDto = exports.AiChatRequestDto = void 0;
+var ai_chat_request_dto_js_1 = require("./ai-chat-request.dto.js");
+Object.defineProperty(exports, "AiChatRequestDto", { enumerable: true, get: function () { return ai_chat_request_dto_js_1.AiChatRequestDto; } });
+var chat_message_dto_js_1 = require("./chat-message.dto.js");
+Object.defineProperty(exports, "ChatMessageDto", { enumerable: true, get: function () { return chat_message_dto_js_1.ChatMessageDto; } });
+var chat_message_part_dto_js_1 = require("./chat-message-part.dto.js");
+Object.defineProperty(exports, "ChatMessagePartDto", { enumerable: true, get: function () { return chat_message_part_dto_js_1.ChatMessagePartDto; } });

package/dist/cjs/server/adapters/nestjs/chat/index.d.ts

@@ -0,0 +1,3 @@
+export { AiChatModule } from './ai-chat.module.js';
+export type { AiChatModuleOptions, AiChatModuleAsyncOptions, AiChatModuleFeatures, } from './ai-chat-module-options.interface.js';
+export { AiChatRequestDto, ChatMessageDto, ChatMessagePartDto } from './dto/index.js';

package/dist/cjs/server/adapters/nestjs/chat/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatMessagePartDto = exports.ChatMessageDto = exports.AiChatRequestDto = exports.AiChatModule = void 0;
+var ai_chat_module_js_1 = require("./ai-chat.module.js");
+Object.defineProperty(exports, "AiChatModule", { enumerable: true, get: function () { return ai_chat_module_js_1.AiChatModule; } });
+var index_js_1 = require("./dto/index.js");
+Object.defineProperty(exports, "AiChatRequestDto", { enumerable: true, get: function () { return index_js_1.AiChatRequestDto; } });
+Object.defineProperty(exports, "ChatMessageDto", { enumerable: true, get: function () { return index_js_1.ChatMessageDto; } });
+Object.defineProperty(exports, "ChatMessagePartDto", { enumerable: true, get: function () { return index_js_1.ChatMessagePartDto; } });

package/dist/cjs/server/adapters/nestjs/chat/speech-stream.gateway.d.ts

@@ -0,0 +1,4 @@
+import { ConfigService } from '@nestjs/config';
+import type { IncomingMessage } from 'http';
+import type WebSocket from 'ws';
+export declare function createSpeechStreamHandler(configService: ConfigService): (clientSocket: WebSocket, req: IncomingMessage) => Promise<void>;

package/dist/cjs/server/adapters/nestjs/chat/speech-stream.gateway.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpeechStreamHandler = createSpeechStreamHandler;
+const common_1 = require("@nestjs/common");
+const ws_loader_js_1 = require("./ws-loader.js");
+function createSpeechStreamHandler(configService) {
+    const logger = new common_1.Logger('SpeechStreamGateway');
+    return async (clientSocket, req) => {
+        const { WebSocket: WebSocketCtor } = await (0, ws_loader_js_1.loadWs)();
+        const WS_OPEN = WebSocketCtor.OPEN;
+        const url = new URL(req.url ?? '', `http://${req.headers.host}`);
+        const token = url.searchParams.get('token');
+        if (!token) {
+            logger.warn('Speech stream connection rejected: missing token');
+            clientSocket.close(4401, 'Missing authentication token');
+            return;
+        }
+        // Auth enforcement is the consumer's responsibility — the SDK just requires
+        // a token to be present. Validate it upstream (auth guard, reverse proxy, etc.).
+        const apiKey = configService.get('DEEPGRAM_API_KEY');
+        if (!apiKey) {
+            logger.error('DEEPGRAM_API_KEY not configured');
+            clientSocket.close(1011, 'Speech-to-text not configured');
+            return;
+        }
+        const language = url.searchParams.get('language') ?? 'en';
+        const dgUrl = new URL('wss://api.deepgram.com/v1/listen');
+        dgUrl.searchParams.set('model', 'nova-3');
+        dgUrl.searchParams.set('language', language);
+        dgUrl.searchParams.set('punctuate', 'true');
+        dgUrl.searchParams.set('interim_results', 'true');
+        dgUrl.searchParams.set('encoding', 'linear16');
+        dgUrl.searchParams.set('sample_rate', '16000');
+        const dgSocket = new WebSocketCtor(dgUrl.toString(), {
+            headers: { Authorization: `Token ${apiKey}` },
+        });
+        dgSocket.on('open', () => {
+            logger.log(`Deepgram connected (language=${language})`);
+        });
+        dgSocket.on('message', (data) => {
+            if (clientSocket.readyState === WS_OPEN) {
+                clientSocket.send(data.toString());
+            }
+        });
+        dgSocket.on('error', (err) => {
+            logger.error(`Deepgram error: ${err.message}`);
+            if (clientSocket.readyState === WS_OPEN) {
+                clientSocket.send(JSON.stringify({ type: 'error', message: 'Transcription error' }));
+            }
+        });
+        dgSocket.on('close', () => {
+            if (clientSocket.readyState === WS_OPEN) {
+                clientSocket.close();
+            }
+        });
+        clientSocket.on('message', (data) => {
+            if (dgSocket.readyState === WS_OPEN) {
+                dgSocket.send(data);
+            }
+        });
+        clientSocket.on('close', () => {
+            if (dgSocket.readyState === WS_OPEN) {
+                dgSocket.close();
+            }
+        });
+        clientSocket.on('error', (err) => {
+            logger.error(`Client socket error: ${err.message}`);
+            if (dgSocket.readyState === WS_OPEN) {
+                dgSocket.close();
+            }
+        });
+    };
+}

package/dist/cjs/server/adapters/nestjs/chat/ws-loader.d.ts

@@ -0,0 +1,5 @@
+export interface WsModule {
+    WebSocketServer: any;
+    WebSocket: any;
+}
+export declare function loadWs(): Promise<WsModule>;