glirastes 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/server/adapters/nestjs/chat/dto/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/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/server/adapters/nestjs/chat/index.js

@@ -0,0 +1,3 @@
+export { AiChatModule } from './ai-chat.module.js';
+export { AiChatRequestDto, ChatMessageDto, ChatMessagePartDto } from './dto/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

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

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

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

@@ -0,0 +1,69 @@
+import { Logger } from '@nestjs/common';
+import WebSocket from 'ws';
+export function createSpeechStreamHandler(configService) {
+    const logger = new Logger('SpeechStreamGateway');
+    return async (clientSocket, req) => {
+        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 WebSocket(dgUrl.toString(), {
+            headers: { Authorization: `Token ${apiKey}` },
+        });
+        dgSocket.on('open', () => {
+            logger.log(`Deepgram connected (language=${language})`);
+        });
+        dgSocket.on('message', (data) => {
+            if (clientSocket.readyState === WebSocket.OPEN) {
+                clientSocket.send(data.toString());
+            }
+        });
+        dgSocket.on('error', (err) => {
+            logger.error(`Deepgram error: ${err.message}`);
+            if (clientSocket.readyState === WebSocket.OPEN) {
+                clientSocket.send(JSON.stringify({ type: 'error', message: 'Transcription error' }));
+            }
+        });
+        dgSocket.on('close', () => {
+            if (clientSocket.readyState === WebSocket.OPEN) {
+                clientSocket.close();
+            }
+        });
+        clientSocket.on('message', (data) => {
+            if (dgSocket.readyState === WebSocket.OPEN) {
+                dgSocket.send(data);
+            }
+        });
+        clientSocket.on('close', () => {
+            if (dgSocket.readyState === WebSocket.OPEN) {
+                dgSocket.close();
+            }
+        });
+        clientSocket.on('error', (err) => {
+            logger.error(`Client socket error: ${err.message}`);
+            if (dgSocket.readyState === WebSocket.OPEN) {
+                dgSocket.close();
+            }
+        });
+    };
+}
+//# sourceMappingURL=speech-stream.gateway.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"speech-stream.gateway.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/chat/speech-stream.gateway.ts"],"names":[],"mappings":"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"}

package/dist/server/adapters/nestjs/decorators/ai-module.decorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import type { AiModuleOptions } from '../metadata.js';
+/**
+ * Class decorator that marks a NestJS controller as an AI intent module.
+ */
+export declare function AiModule(options: AiModuleOptions): ClassDecorator;

package/dist/server/adapters/nestjs/decorators/ai-module.decorator.js

@@ -0,0 +1,11 @@
+import 'reflect-metadata';
+import { AI_MODULE_METADATA } from './constants.js';
+/**
+ * Class decorator that marks a NestJS controller as an AI intent module.
+ */
+export function AiModule(options) {
+    return (target) => {
+        Reflect.defineMetadata(AI_MODULE_METADATA, options, target);
+    };
+}
+//# sourceMappingURL=ai-module.decorator.js.map

package/dist/server/adapters/nestjs/decorators/ai-module.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-module.decorator.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/decorators/ai-module.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,kBAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/adapters/nestjs/decorators/ai-param.decorator.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+/**
+ * Property decorator that adds an AI-readable description to a DTO property.
+ */
+export declare function AiParam(description: string): PropertyDecorator;

package/dist/server/adapters/nestjs/decorators/ai-param.decorator.js

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+import { AI_PARAM_METADATA } from './constants.js';
+/**
+ * Property decorator that adds an AI-readable description to a DTO property.
+ */
+export function AiParam(description) {
+    return (target, propertyKey) => {
+        const existing = Reflect.getMetadata(AI_PARAM_METADATA, target.constructor) ?? [];
+        existing.push({ propertyKey: String(propertyKey), description });
+        Reflect.defineMetadata(AI_PARAM_METADATA, existing, target.constructor);
+    };
+}
+//# sourceMappingURL=ai-param.decorator.js.map

package/dist/server/adapters/nestjs/decorators/ai-param.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-param.decorator.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/decorators/ai-param.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,WAAmB;IACzC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;QAC7B,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1E,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/adapters/nestjs/decorators/ai-tool.decorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import type { AiToolOptions } from '../metadata.js';
+/**
+ * Method decorator that exposes a controller method as an AI tool.
+ */
+export declare function AiTool(options: AiToolOptions): MethodDecorator;

package/dist/server/adapters/nestjs/decorators/ai-tool.decorator.js

@@ -0,0 +1,20 @@
+import 'reflect-metadata';
+import { AI_TOOL_METADATA, AI_TOOL_METHODS_METADATA } from './constants.js';
+/**
+ * Method decorator that exposes a controller method as an AI tool.
+ */
+export function AiTool(options) {
+    return (target, propertyKey, _descriptor) => {
+        const methodName = String(propertyKey);
+        const meta = { ...options, methodName };
+        // Store per-method metadata
+        Reflect.defineMetadata(AI_TOOL_METADATA, meta, target, propertyKey);
+        // Maintain array of decorated method names on the class
+        const existingTools = Reflect.getMetadata(AI_TOOL_METHODS_METADATA, target.constructor) ?? [];
+        if (!existingTools.includes(methodName)) {
+            existingTools.push(methodName);
+        }
+        Reflect.defineMetadata(AI_TOOL_METHODS_METADATA, existingTools, target.constructor);
+    };
+}
+//# sourceMappingURL=ai-tool.decorator.js.map

package/dist/server/adapters/nestjs/decorators/ai-tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tool.decorator.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/decorators/ai-tool.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAG5E;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE;QAC1C,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,IAAI,GAAe,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC;QAEpD,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAEpE,wDAAwD;QACxD,MAAM,aAAa,GACjB,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC1E,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,CAAC,cAAc,CACpB,wBAAwB,EACxB,aAAa,EACb,MAAM,CAAC,WAAW,CACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/server/adapters/nestjs/decorators/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const AI_MODULE_METADATA: unique symbol;
+export declare const AI_TOOL_METADATA: unique symbol;
+export declare const AI_TOOL_METHODS_METADATA: unique symbol;
+export declare const AI_PARAM_METADATA: unique symbol;

package/dist/server/adapters/nestjs/decorators/constants.js

@@ -0,0 +1,5 @@
+export const AI_MODULE_METADATA = Symbol('AI_MODULE_METADATA');
+export const AI_TOOL_METADATA = Symbol('AI_TOOL_METADATA');
+export const AI_TOOL_METHODS_METADATA = Symbol('AI_TOOL_METHODS_METADATA');
+export const AI_PARAM_METADATA = Symbol('AI_PARAM_METADATA');
+//# sourceMappingURL=constants.js.map

package/dist/server/adapters/nestjs/decorators/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/decorators/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,14 @@
+export { AiModule } from './decorators/ai-module.decorator.js';
+export { AiTool } from './decorators/ai-tool.decorator.js';
+export { AiParam } from './decorators/ai-param.decorator.js';
+export { getAiModuleMeta, getAiToolMeta, getAllAiToolNames, getAllAiTools, getAiParamMeta, } from './metadata.js';
+export type { AiModuleOptions, AiToolOptions, AiModuleMeta, AiToolMeta, AiParamDescription, } from './metadata.js';
+export { AiToolsExplorerService } from './module/ai-tools-explorer.service.js';
+export { AiToolsService } from './module/ai-tools.service.js';
+export { createAiToolsProviders, type AiToolsModuleOptions, } from './module/ai-tools.module.js';
+export { scanNestJsControllers, type NestJsScanOptions, type NestJsScanResult, } from './scanner/nestjs-scanner.js';
+export { buildZodSchemaFromDto, hasAiRelevantMeta, extractRouteParams } from './scanner/schema-builder.js';
+export { applyAiExtensions } from './swagger.js';
+export { AiChatModule } from './chat/ai-chat.module.js';
+export type { AiChatModuleOptions, AiChatModuleAsyncOptions, AiChatModuleFeatures } from './chat/ai-chat-module-options.interface.js';
+export { AiChatRequestDto, ChatMessageDto, ChatMessagePartDto } from './chat/dto/index.js';

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

@@ -0,0 +1,20 @@
+// Decorators
+export { AiModule } from './decorators/ai-module.decorator.js';
+export { AiTool } from './decorators/ai-tool.decorator.js';
+export { AiParam } from './decorators/ai-param.decorator.js';
+// Metadata readers
+export { getAiModuleMeta, getAiToolMeta, getAllAiToolNames, getAllAiTools, getAiParamMeta, } from './metadata.js';
+// Module (DI)
+export { AiToolsExplorerService } from './module/ai-tools-explorer.service.js';
+export { AiToolsService } from './module/ai-tools.service.js';
+export { createAiToolsProviders, } from './module/ai-tools.module.js';
+// Build-time scanner
+export { scanNestJsControllers, } from './scanner/nestjs-scanner.js';
+// Schema builder
+export { buildZodSchemaFromDto, hasAiRelevantMeta, extractRouteParams } from './scanner/schema-builder.js';
+// Swagger / OpenAPI
+export { applyAiExtensions } from './swagger.js';
+// Chat module
+export { AiChatModule } from './chat/ai-chat.module.js';
+export { AiChatRequestDto, ChatMessageDto, ChatMessagePartDto } from './chat/dto/index.js';
+//# sourceMappingURL=index.js.map

package/dist/server/adapters/nestjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/adapters/nestjs/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EACL,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAWvB,cAAc;AACd,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AAErC,qBAAqB;AACrB,OAAO,EACL,qBAAqB,GAGtB,MAAM,6BAA6B,CAAC;AAErC,iBAAiB;AACjB,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE3G,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server/adapters/nestjs/metadata.d.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import type { ModuleClassificationConfig, ModuleExecutionConfig, EndpointMethod, UiActionTemplate, UiPattern } from '../../../types.js';
+import type { z } from 'zod';
+export interface AiModuleOptions {
+    intent: string;
+    classification: ModuleClassificationConfig;
+    execution?: Partial<ModuleExecutionConfig>;
+    systemPrompt?: string;
+}
+export interface AiToolOptions {
+    name: string;
+    description: string;
+    needsApproval?: boolean;
+    sharedWith?: string[];
+    uiActionOnSuccess?: UiActionTemplate;
+    uiPattern?: UiPattern;
+    method?: EndpointMethod;
+    path?: string;
+    /**
+     * Optional Zod schema describing the tool's response shape.
+     * When provided, a compact description is auto-appended to the tool description.
+     */
+    outputSchema?: z.ZodTypeAny;
+}
+export interface AiParamDescription {
+    propertyKey: string;
+    description: string;
+}
+export type AiModuleMeta = AiModuleOptions;
+export interface AiToolMeta extends AiToolOptions {
+    methodName: string;
+}
+export declare function getAiModuleMeta(controllerClass: Function): AiModuleMeta | undefined;
+export declare function getAiToolMeta(controllerClass: Function, methodName: string): AiToolMeta | undefined;
+export declare function getAllAiToolNames(controllerClass: Function): string[];
+export declare function getAllAiTools(controllerClass: Function): Array<AiToolMeta & {
+    module?: string;
+}>;
+export declare function getAiParamMeta(dtoClass: Function): AiParamDescription[];

package/dist/server/adapters/nestjs/metadata.js

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+import { AI_MODULE_METADATA, AI_TOOL_METADATA, AI_TOOL_METHODS_METADATA, AI_PARAM_METADATA, } from './decorators/constants.js';
+// ---------------------------------------------------------------------------
+// Metadata readers
+// ---------------------------------------------------------------------------
+export function getAiModuleMeta(controllerClass) {
+    return Reflect.getMetadata(AI_MODULE_METADATA, controllerClass);
+}
+export function getAiToolMeta(controllerClass, methodName) {
+    return Reflect.getMetadata(AI_TOOL_METADATA, controllerClass.prototype, methodName);
+}
+export function getAllAiToolNames(controllerClass) {
+    return (Reflect.getMetadata(AI_TOOL_METHODS_METADATA, controllerClass) ?? []);
+}
+export function getAllAiTools(controllerClass) {
+    const moduleMeta = getAiModuleMeta(controllerClass);
+    const toolNames = getAllAiToolNames(controllerClass);
+    return toolNames
+        .map((methodName) => {
+        const toolMeta = getAiToolMeta(controllerClass, methodName);
+        if (!toolMeta)
+            return null;
+        return { ...toolMeta, module: moduleMeta?.intent };
+    })
+        .filter((t) => t !== null);
+}
+export function getAiParamMeta(dtoClass) {
+    return Reflect.getMetadata(AI_PARAM_METADATA, dtoClass) ?? [];
+}
+//# sourceMappingURL=metadata.js.map

package/dist/server/adapters/nestjs/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../../src/server/adapters/nestjs/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AAgDnC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,UAAU,eAAe,CAC7B,eAAyB;IAEzB,OAAO,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,eAAyB,EACzB,UAAkB;IAElB,OAAO,OAAO,CAAC,WAAW,CACxB,gBAAgB,EAChB,eAAe,CAAC,SAAS,EACzB,UAAU,CACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,eAAyB;IACzD,OAAO,CACL,OAAO,CAAC,WAAW,CAAC,wBAAwB,EAAE,eAAe,CAAC,IAAI,EAAE,CACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,eAAyB;IAEzB,MAAM,UAAU,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAErD,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAClB,MAAM,QAAQ,GAAG,aAAa,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAkB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAChE,CAAC"}

package/dist/server/adapters/nestjs/module/ai-tools-explorer.service.d.ts

@@ -0,0 +1,36 @@
+import 'reflect-metadata';
+import type { AiEndpointToolDefinition, IntentModule } from '../../../../types.js';
+import { type AiModuleMeta, type AiToolMeta } from '../metadata.js';
+interface DiscoveredController {
+    controllerClass: Function;
+    moduleMeta: AiModuleMeta;
+    tools: Array<AiToolMeta & {
+        module: string;
+    }>;
+}
+/**
+ * Discovers AI-decorated controllers at runtime using NestJS DiscoveryService.
+ * Injectable as a NestJS provider.
+ */
+export declare class AiToolsExplorerService {
+    private readonly discoveryService;
+    private readonly reflector;
+    private readonly options?;
+    private readonly discovered;
+    private readonly endpointToolDefs;
+    private readonly intentModules;
+    constructor(discoveryService: unknown, reflector: unknown, options?: {
+        controllers?: Function[];
+    } | undefined);
+    /**
+     * Called during module initialization to scan all controllers.
+     */
+    explore(): void;
+    private scanControllers;
+    private buildToolDefinitions;
+    private buildIntentModules;
+    getEndpointToolDefinitions(): ReadonlyArray<AiEndpointToolDefinition>;
+    getIntentModules(): ReadonlyMap<string, IntentModule>;
+    getDiscoveredControllers(): ReadonlyArray<DiscoveredController>;
+}
+export {};

package/dist/server/adapters/nestjs/module/ai-tools-explorer.service.js

@@ -0,0 +1,156 @@
+import 'reflect-metadata';
+import { z } from 'zod';
+import { getAiModuleMeta, getAllAiTools } from '../metadata.js';
+import { buildZodSchemaFromDto, hasAiRelevantMeta, extractRouteParams } from '../scanner/schema-builder.js';
+const HTTP_METHOD_MAP = {
+    0: 'GET',
+    1: 'POST',
+    2: 'PUT',
+    3: 'DELETE',
+    4: 'PATCH',
+};
+/**
+ * Discovers AI-decorated controllers at runtime using NestJS DiscoveryService.
+ * Injectable as a NestJS provider.
+ */
+export class AiToolsExplorerService {
+    discoveryService;
+    reflector;
+    options;
+    discovered = [];
+    endpointToolDefs = [];
+    intentModules = new Map();
+    constructor(discoveryService, reflector, options) {
+        this.discoveryService = discoveryService;
+        this.reflector = reflector;
+        this.options = options;
+    }
+    /**
+     * Called during module initialization to scan all controllers.
+     */
+    explore() {
+        this.scanControllers();
+        this.buildToolDefinitions();
+        this.buildIntentModules();
+    }
+    scanControllers() {
+        const ds = this.discoveryService;
+        const controllers = ds.getControllers();
+        for (const wrapper of controllers) {
+            const controllerClass = wrapper.metatype;
+            if (!controllerClass)
+                continue;
+            const moduleMeta = getAiModuleMeta(controllerClass);
+            if (!moduleMeta)
+                continue;
+            if (this.options?.controllers &&
+                !this.options.controllers.includes(controllerClass)) {
+                continue;
+            }
+            const tools = getAllAiTools(controllerClass);
+            this.discovered.push({
+                controllerClass,
+                moduleMeta,
+                tools: tools.map((t) => ({
+                    ...t,
+                    module: t.module ?? moduleMeta.intent,
+                })),
+            });
+        }
+    }
+    buildToolDefinitions() {
+        const ref = this.reflector;
+        for (const ctrl of this.discovered) {
+            const controllerPath = ref.get('path', ctrl.controllerClass) ?? '';
+            for (const tool of ctrl.tools) {
+                const httpMethodNum = ref.get('method', ctrl.controllerClass.prototype[tool.methodName]);
+                const httpMethod = tool.method ??
+                    HTTP_METHOD_MAP[httpMethodNum ?? 0] ??
+                    'GET';
+                const methodPath = ref.get('path', ctrl.controllerClass.prototype[tool.methodName]) ?? '';
+                const fullPath = `/api/${controllerPath}/${methodPath}`
+                    .replace(/\/+/g, '/')
+                    .replace(/\/$/, '') || '/';
+                // Resolve DTO
+                const paramTypes = Reflect.getMetadata('design:paramtypes', ctrl.controllerClass.prototype, tool.methodName);
+                let inputSchema = z.object({});
+                if (paramTypes) {
+                    for (const pt of paramTypes) {
+                        if (pt && typeof pt === 'function' && hasAiRelevantMeta(pt)) {
+                            inputSchema = buildZodSchemaFromDto(pt);
+                            break;
+                        }
+                    }
+                }
+                // Merge path parameters into input schema
+                const pathParams = extractRouteParams(ctrl.controllerClass, tool.methodName);
+                if (pathParams.length > 0) {
+                    const pathShape = {};
+                    for (const paramName of pathParams) {
+                        if (!(inputSchema instanceof z.ZodObject) || !(paramName in inputSchema.shape)) {
+                            pathShape[paramName] = z.string().uuid().describe(`Path parameter: ${paramName}`);
+                        }
+                    }
+                    if (Object.keys(pathShape).length > 0) {
+                        inputSchema = inputSchema instanceof z.ZodObject
+                            ? inputSchema.extend(pathShape)
+                            : z.object(pathShape);
+                    }
+                }
+                this.endpointToolDefs.push({
+                    id: `${ctrl.moduleMeta.intent}.${tool.name}`,
+                    toolName: tool.name,
+                    module: tool.module,
+                    sharedWith: tool.sharedWith,
+                    description: tool.description,
+                    method: httpMethod,
+                    path: fullPath,
+                    inputSchema,
+                    outputSchema: tool.outputSchema,
+                    needsApproval: tool.needsApproval,
+                    uiActionOnSuccess: tool.uiActionOnSuccess,
+                    uiPattern: tool.uiPattern,
+                });
+            }
+        }
+    }
+    buildIntentModules() {
+        for (const ctrl of this.discovered) {
+            const intent = ctrl.moduleMeta.intent;
+            const toolNames = ctrl.tools.map((t) => t.name);
+            const existing = this.intentModules.get(intent);
+            if (existing) {
+                existing.toolNames.push(...toolNames);
+            }
+            else {
+                const meta = {
+                    classification: ctrl.moduleMeta.classification,
+                    execution: ctrl.moduleMeta.execution,
+                    systemPrompt: ctrl.moduleMeta.systemPrompt,
+                };
+                this.intentModules.set(intent, { type: intent, toolNames, meta });
+            }
+        }
+        // Expand sharedWith
+        for (const def of this.endpointToolDefs) {
+            if (!def.sharedWith)
+                continue;
+            for (const sharedModule of def.sharedWith) {
+                const mod = this.intentModules.get(sharedModule);
+                if (mod && !mod.toolNames.includes(def.toolName)) {
+                    mod.toolNames.push(def.toolName);
+                }
+            }
+        }
+    }
+    getEndpointToolDefinitions() {
+        return this.endpointToolDefs;
+    }
+    getIntentModules() {
+        return this.intentModules;
+    }
+    getDiscoveredControllers() {
+        return this.discovered;
+    }
+}
+//# sourceMappingURL=ai-tools-explorer.service.js.map

package/dist/server/adapters/nestjs/module/ai-tools-explorer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools-explorer.service.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/module/ai-tools-explorer.service.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,37 @@
+import { AiToolsExplorerService } from './ai-tools-explorer.service.js';
+import { AiToolsService } from './ai-tools.service.js';
+export interface AiToolsModuleOptions {
+    controllers?: Function[];
+    global?: boolean;
+}
+/**
+ * Configuration factory for NestJS module registration.
+ *
+ * Usage in a NestJS module:
+ * ```ts
+ * import { Module } from '@nestjs/common';
+ * import { DiscoveryModule, DiscoveryService, Reflector } from '@nestjs/core';
+ * import { createAiToolsProviders } from '../index.js';
+ *
+ * @Module({
+ *   imports: [DiscoveryModule],
+ *   providers: [...createAiToolsProviders()],
+ *   exports: [AiToolsService],
+ * })
+ * export class AiToolsModule {}
+ * ```
+ */
+export declare function createAiToolsProviders(options?: AiToolsModuleOptions): {
+    options: AiToolsModuleOptions;
+    ExplorerService: typeof AiToolsExplorerService;
+    ToolsService: typeof AiToolsService;
+    /**
+     * Factory function to create the explorer service with NestJS DI.
+     * Call this in a custom provider factory.
+     */
+    createExplorer(discoveryService: unknown, reflector: unknown): AiToolsExplorerService;
+    /**
+     * Factory function to create the tools service.
+     */
+    createService(explorer: AiToolsExplorerService): AiToolsService;
+};

package/dist/server/adapters/nestjs/module/ai-tools.module.js

@@ -0,0 +1,42 @@
+import { AiToolsExplorerService } from './ai-tools-explorer.service.js';
+import { AiToolsService } from './ai-tools.service.js';
+/**
+ * Configuration factory for NestJS module registration.
+ *
+ * Usage in a NestJS module:
+ * ```ts
+ * import { Module } from '@nestjs/common';
+ * import { DiscoveryModule, DiscoveryService, Reflector } from '@nestjs/core';
+ * import { createAiToolsProviders } from '../index.js';
+ *
+ * @Module({
+ *   imports: [DiscoveryModule],
+ *   providers: [...createAiToolsProviders()],
+ *   exports: [AiToolsService],
+ * })
+ * export class AiToolsModule {}
+ * ```
+ */
+export function createAiToolsProviders(options) {
+    return {
+        options: options ?? {},
+        ExplorerService: AiToolsExplorerService,
+        ToolsService: AiToolsService,
+        /**
+         * Factory function to create the explorer service with NestJS DI.
+         * Call this in a custom provider factory.
+         */
+        createExplorer(discoveryService, reflector) {
+            const explorer = new AiToolsExplorerService(discoveryService, reflector, options);
+            explorer.explore();
+            return explorer;
+        },
+        /**
+         * Factory function to create the tools service.
+         */
+        createService(explorer) {
+            return new AiToolsService(explorer);
+        },
+    };
+}
+//# sourceMappingURL=ai-tools.module.js.map

package/dist/server/adapters/nestjs/module/ai-tools.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.module.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/module/ai-tools.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAOvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA8B;IACnE,OAAO;QACL,OAAO,EAAE,OAAO,IAAI,EAAE;QACtB,eAAe,EAAE,sBAAsB;QACvC,YAAY,EAAE,cAAc;QAE5B;;;WAGG;QACH,cAAc,CAAC,gBAAyB,EAAE,SAAkB;YAC1D,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CACzC,gBAAgB,EAChB,SAAS,EACT,OAAO,CACR,CAAC;YACF,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED;;WAEG;QACH,aAAa,CAAC,QAAgC;YAC5C,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/adapters/nestjs/module/ai-tools.service.d.ts

@@ -0,0 +1,28 @@
+import type { AiEndpointToolDefinition, IntentModule, ToolContext, ToolRegistry } from '../../../../types.js';
+import { type ToolToAiToolOptions } from '../../../core/index.js';
+import type { AiToolsExplorerService } from './ai-tools-explorer.service.js';
+/**
+ * Injectable service for accessing AI tool definitions at runtime.
+ */
+export declare class AiToolsService {
+    private readonly explorer;
+    constructor(explorer: AiToolsExplorerService);
+    getEndpointTools(): ReadonlyArray<AiEndpointToolDefinition>;
+    getIntentModules(): ReadonlyMap<string, IntentModule>;
+    getToolsForIntent(intent: string): AiEndpointToolDefinition[];
+    buildToolRegistry(): ToolRegistry;
+    buildAiTools(context: ToolContext, options?: ToolToAiToolOptions): Promise<Record<string, {
+        _toolId: string;
+        description: string;
+        parameters: import("zod").ZodType<any, import("zod").ZodTypeDef, any>;
+        needsApproval: ((input: unknown) => Promise<boolean>) | undefined;
+        execute: (input: unknown) => Promise<unknown>;
+    }>>;
+    buildAiToolsForIntent(intent: string, context: ToolContext, options?: ToolToAiToolOptions): Promise<Record<string, {
+        _toolId: string;
+        description: string;
+        parameters: import("zod").ZodType<any, import("zod").ZodTypeDef, any>;
+        needsApproval: ((input: unknown) => Promise<boolean>) | undefined;
+        execute: (input: unknown) => Promise<unknown>;
+    }>>;
+}