glirastes 0.1.0

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

@@ -0,0 +1,38 @@
+import { endpointToolsToRegistry, toolsToAiTools, } from '../../../core/index.js';
+/**
+ * Injectable service for accessing AI tool definitions at runtime.
+ */
+export class AiToolsService {
+    explorer;
+    constructor(explorer) {
+        this.explorer = explorer;
+    }
+    getEndpointTools() {
+        return this.explorer.getEndpointToolDefinitions();
+    }
+    getIntentModules() {
+        return this.explorer.getIntentModules();
+    }
+    getToolsForIntent(intent) {
+        const mod = this.explorer.getIntentModules().get(intent);
+        if (!mod)
+            return [];
+        const toolNameSet = new Set(mod.toolNames);
+        return this.explorer
+            .getEndpointToolDefinitions()
+            .filter((t) => toolNameSet.has(t.toolName));
+    }
+    buildToolRegistry() {
+        return endpointToolsToRegistry(this.explorer.getEndpointToolDefinitions());
+    }
+    async buildAiTools(context, options) {
+        const registry = this.buildToolRegistry();
+        return toolsToAiTools(registry, context, options);
+    }
+    async buildAiToolsForIntent(intent, context, options) {
+        const tools = this.getToolsForIntent(intent);
+        const registry = endpointToolsToRegistry(tools);
+        return toolsToAiTools(registry, context, options);
+    }
+}
+//# sourceMappingURL=ai-tools.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-tools.service.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/module/ai-tools.service.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,uBAAuB,EACvB,cAAc,GAEf,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,MAAM,OAAO,cAAc;IACI;IAA7B,YAA6B,QAAgC;QAAhC,aAAQ,GAAR,QAAQ,CAAwB;IAAG,CAAC;IAEjE,gBAAgB;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,0BAA0B,EAAE,CAAC;IACpD,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC;IAED,iBAAiB,CAAC,MAAc;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,QAAQ;aACjB,0BAA0B,EAAE;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAA+B,CAAC;IAC9E,CAAC;IAED,iBAAiB;QACf,OAAO,uBAAuB,CAC5B,IAAI,CAAC,QAAQ,CAAC,0BAA0B,EAAgC,CACzE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAoB,EAAE,OAA6B;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC1C,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,MAAc,EACd,OAAoB,EACpB,OAA6B;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/server/adapters/nestjs/scanner/nestjs-scanner.d.ts

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+import type { AiEndpointToolDefinition, IntentModule } from '../../../../types.js';
+export interface NestJsScanOptions {
+    controllers: Function[];
+    apiPrefix?: string;
+}
+export interface NestJsScanResult {
+    tools: AiEndpointToolDefinition[];
+    modules: IntentModule[];
+    toolsByModule: Record<string, string[]>;
+}
+/**
+ * Scan decorated NestJS controllers and produce tool/module definitions.
+ * Works at build time without a running NestJS app.
+ */
+export declare function scanNestJsControllers(options: NestJsScanOptions): NestJsScanResult;

package/dist/server/adapters/nestjs/scanner/nestjs-scanner.js

@@ -0,0 +1,115 @@
+import 'reflect-metadata';
+import { z } from 'zod';
+import { getAiModuleMeta, getAllAiTools } from '../metadata.js';
+import { buildZodSchemaFromDto, hasAiRelevantMeta, extractRouteParams } from './schema-builder.js';
+const HTTP_METHOD_MAP = {
+    0: 'GET',
+    1: 'POST',
+    2: 'PUT',
+    3: 'DELETE',
+    4: 'PATCH',
+};
+/**
+ * Scan decorated NestJS controllers and produce tool/module definitions.
+ * Works at build time without a running NestJS app.
+ */
+export function scanNestJsControllers(options) {
+    const apiPrefix = options.apiPrefix ?? '/api';
+    const allTools = [];
+    const moduleMap = new Map();
+    for (const controllerClass of options.controllers) {
+        const moduleMeta = getAiModuleMeta(controllerClass);
+        if (!moduleMeta)
+            continue;
+        const tools = getAllAiTools(controllerClass);
+        const controllerPath = Reflect.getMetadata('path', controllerClass) ?? '';
+        for (const tool of tools) {
+            const methodPath = Reflect.getMetadata('path', controllerClass.prototype[tool.methodName]) ?? '';
+            const fullPath = `${apiPrefix}/${controllerPath}/${methodPath}`
+                .replace(/\/+/g, '/')
+                .replace(/\/$/, '') || '/';
+            // Resolve HTTP method
+            const httpMethodNum = Reflect.getMetadata('method', controllerClass.prototype[tool.methodName]);
+            const httpMethod = tool.method ??
+                HTTP_METHOD_MAP[httpMethodNum ?? 0] ??
+                'GET';
+            // Resolve DTO schema
+            const paramTypes = Reflect.getMetadata('design:paramtypes', 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(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);
+                }
+            }
+            allTools.push({
+                id: `${moduleMeta.intent}.${tool.name}`,
+                toolName: tool.name,
+                module: tool.module ?? moduleMeta.intent,
+                sharedWith: tool.sharedWith,
+                description: tool.description,
+                method: httpMethod,
+                path: fullPath,
+                inputSchema,
+                needsApproval: tool.needsApproval,
+                uiActionOnSuccess: tool.uiActionOnSuccess,
+                uiPattern: tool.uiPattern,
+            });
+        }
+        // Build IntentModule
+        const intent = moduleMeta.intent;
+        const toolNames = tools.map((t) => t.name);
+        const existing = moduleMap.get(intent);
+        if (existing) {
+            existing.toolNames.push(...toolNames);
+        }
+        else {
+            const meta = {
+                classification: moduleMeta.classification,
+                execution: moduleMeta.execution,
+                systemPrompt: moduleMeta.systemPrompt,
+            };
+            moduleMap.set(intent, { type: intent, toolNames, meta });
+        }
+    }
+    // Expand sharedWith
+    const toolsByModule = {};
+    for (const [intent, mod] of moduleMap) {
+        toolsByModule[intent] = [...mod.toolNames];
+    }
+    for (const tool of allTools) {
+        if (!tool.sharedWith)
+            continue;
+        for (const sharedModule of tool.sharedWith) {
+            if (!toolsByModule[sharedModule]) {
+                toolsByModule[sharedModule] = [];
+            }
+            if (!toolsByModule[sharedModule].includes(tool.toolName)) {
+                toolsByModule[sharedModule].push(tool.toolName);
+            }
+        }
+    }
+    return {
+        tools: allTools,
+        modules: Array.from(moduleMap.values()),
+        toolsByModule,
+    };
+}
+//# sourceMappingURL=nestjs-scanner.js.map

package/dist/server/adapters/nestjs/scanner/nestjs-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs-scanner.js","sourceRoot":"","sources":["../../../../../src/server/adapters/nestjs/scanner/nestjs-scanner.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAO1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAanG,MAAM,eAAe,GAAmC;IACtD,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAA0B;IAE1B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAC9C,MAAM,QAAQ,GAA+B,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElD,KAAK,MAAM,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,UAAU,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,MAAM,KAAK,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC;QAErD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GACd,OAAO,CAAC,WAAW,CACjB,MAAM,EACN,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3C,IAAI,EAAE,CAAC;YAEV,MAAM,QAAQ,GACZ,GAAG,SAAS,IAAI,cAAc,IAAI,UAAU,EAAE;iBAC3C,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;YAE/B,sBAAsB;YACtB,MAAM,aAAa,GAAuB,OAAO,CAAC,WAAW,CAC3D,QAAQ,EACR,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3C,CAAC;YACF,MAAM,UAAU,GACb,IAAI,CAAC,MAAyB;gBAC/B,eAAe,CAAC,aAAa,IAAI,CAAC,CAAC;gBACnC,KAAK,CAAC;YAER,qBAAqB;YACrB,MAAM,UAAU,GAA2B,OAAO,CAAC,WAAW,CAC5D,mBAAmB,EACnB,eAAe,CAAC,SAAS,EACzB,IAAI,CAAC,UAAU,CAChB,CAAC;YACF,IAAI,WAAW,GAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;oBAC5B,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,UAAU,IAAI,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC;wBAC5D,WAAW,GAAG,qBAAqB,CAAC,EAAE,CAAC,CAAC;wBACxC,MAAM;oBACR,CAAC;gBACH,CAAC;YACH,CAAC;YAED,0CAA0C;YAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC,eAAe,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACxE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAiC,EAAE,CAAC;gBACnD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACnC,IAAI,CAAC,CAAC,WAAW,YAAY,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,IAAK,WAAgC,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrG,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;oBACpF,CAAC;gBACH,CAAC;gBACD,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtC,WAAW,GAAG,WAAW,YAAY,CAAC,CAAC,SAAS;wBAC9C,CAAC,CAAE,WAAgC,CAAC,MAAM,CAAC,SAAS,CAAC;wBACrD,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,GAAG,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE;gBACvC,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,MAAM;gBACxC,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,QAAQ;gBACd,WAAW;gBACX,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACjC,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAe;gBACvB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;aACtC,CAAC;YACF,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,aAAa,GAA6B,EAAE,CAAC;IACnD,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QACtC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,SAAS;QAC/B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,aAAa,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YACnC,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzD,aAAa,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACvC,aAAa;KACd,CAAC;AACJ,CAAC"}

package/dist/server/adapters/nestjs/scanner/schema-builder.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import 'reflect-metadata';
+/**
+ * Build a Zod schema from a DTO class.
+ *
+ * Resolution order per property:
+ * 1. @AiParam — explicit AI-specific description (highest priority)
+ * 2. @ApiProperty — Swagger metadata as fallback (description, required, constraints)
+ * 3. design:type — TypeScript type metadata for base type inference
+ *
+ * Constraints from @ApiProperty (minLength, maxLength, minimum, maximum, enum)
+ * are applied as Zod validations AND appended to the property description so
+ * the AI model knows the constraints before generating values.
+ */
+export declare function buildZodSchemaFromDto(dtoClass: Function): z.ZodObject<Record<string, z.ZodTypeAny>>;
+/**
+ * Check whether a DTO class has any AI-relevant property metadata
+ * (either @AiParam or @ApiProperty decorators).
+ */
+export declare function hasAiRelevantMeta(dtoClass: Function): boolean;
+/**
+ * Extract @Param() parameter names from a controller method's route arguments metadata.
+ * NestJS stores route arguments under '__routeArguments__' with keys like "5:0" where
+ * 5 = RouteParamtypes.PARAM. The `data` field holds the parameter name (e.g., 'id').
+ */
+export declare function extractRouteParams(controllerClass: Function, methodName: string): string[];

package/dist/server/adapters/nestjs/scanner/schema-builder.js

@@ -0,0 +1,255 @@
+import { z } from 'zod';
+import 'reflect-metadata';
+import { getAiParamMeta } from '../metadata.js';
+/**
+ * Metadata key used by @nestjs/swagger's @ApiProperty decorator.
+ * Properties decorated with @ApiProperty store their options under this key.
+ */
+const SWAGGER_API_MODEL_PROPERTIES = 'swagger/apiModelProperties';
+const SWAGGER_API_MODEL_PROPERTIES_ARRAY = 'swagger/apiModelPropertiesArray';
+/**
+ * Read @ApiProperty metadata for all properties on a DTO class.
+ * Returns an array of property descriptors with description and constraints.
+ */
+function getSwaggerPropertyMeta(dtoClass) {
+    const propertyNames = Reflect.getMetadata(SWAGGER_API_MODEL_PROPERTIES_ARRAY, dtoClass.prototype);
+    if (!propertyNames || propertyNames.length === 0)
+        return [];
+    const result = [];
+    for (const rawKey of propertyNames) {
+        // Swagger stores keys with a ':' prefix (e.g., ':name', ':description')
+        const propertyKey = rawKey.startsWith(':') ? rawKey.slice(1) : rawKey;
+        const meta = Reflect.getMetadata(SWAGGER_API_MODEL_PROPERTIES, dtoClass.prototype, propertyKey);
+        if (meta) {
+            result.push({ propertyKey, meta });
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Build a Zod schema from a DTO class.
+ *
+ * Resolution order per property:
+ * 1. @AiParam — explicit AI-specific description (highest priority)
+ * 2. @ApiProperty — Swagger metadata as fallback (description, required, constraints)
+ * 3. design:type — TypeScript type metadata for base type inference
+ *
+ * Constraints from @ApiProperty (minLength, maxLength, minimum, maximum, enum)
+ * are applied as Zod validations AND appended to the property description so
+ * the AI model knows the constraints before generating values.
+ */
+export function buildZodSchemaFromDto(dtoClass) {
+    const aiParams = getAiParamMeta(dtoClass);
+    const swaggerProps = getSwaggerPropertyMeta(dtoClass);
+    const mergedParams = buildMergedParamList(aiParams, swaggerProps);
+    if (mergedParams.length === 0)
+        return z.object({});
+    const shape = {};
+    for (const param of mergedParams) {
+        const designType = Reflect.getMetadata('design:type', dtoClass.prototype, param.propertyKey);
+        let fieldSchema = buildFieldSchema(designType, param.constraints);
+        // Build enriched description: base description + constraint hints
+        const enrichedDescription = buildEnrichedDescription(param.description, param.constraints);
+        if (enrichedDescription) {
+            fieldSchema = fieldSchema.describe(enrichedDescription);
+        }
+        // Apply optional
+        if (param.isOptional) {
+            fieldSchema = fieldSchema.optional();
+        }
+        else {
+            fieldSchema = detectOptionalByDefault(dtoClass, param.propertyKey, fieldSchema);
+        }
+        shape[param.propertyKey] = fieldSchema;
+    }
+    return z.object(shape);
+}
+/**
+ * Check whether a DTO class has any AI-relevant property metadata
+ * (either @AiParam or @ApiProperty decorators).
+ */
+export function hasAiRelevantMeta(dtoClass) {
+    if (getAiParamMeta(dtoClass).length > 0)
+        return true;
+    if (getSwaggerPropertyMeta(dtoClass).length > 0)
+        return true;
+    return false;
+}
+// ============================================================================
+// Internal helpers
+// ============================================================================
+function buildMergedParamList(aiParams, swaggerProps) {
+    const aiParamMap = new Map(aiParams.map((p) => [p.propertyKey, p]));
+    const swaggerMap = new Map(swaggerProps.map((p) => [p.propertyKey, p.meta]));
+    // Collect all unique property keys (preserving order)
+    const allKeys = new Set();
+    for (const p of aiParams)
+        allKeys.add(p.propertyKey);
+    for (const p of swaggerProps)
+        allKeys.add(p.propertyKey);
+    const result = [];
+    for (const key of allKeys) {
+        const aiParam = aiParamMap.get(key);
+        const swaggerMeta = swaggerMap.get(key);
+        const description = aiParam?.description ?? swaggerMeta?.description ?? '';
+        const isOptional = swaggerMeta?.required === false;
+        const constraints = {};
+        if (swaggerMeta) {
+            if (swaggerMeta.minLength !== undefined)
+                constraints.minLength = swaggerMeta.minLength;
+            if (swaggerMeta.maxLength !== undefined)
+                constraints.maxLength = swaggerMeta.maxLength;
+            if (swaggerMeta.minimum !== undefined)
+                constraints.minimum = swaggerMeta.minimum;
+            if (swaggerMeta.maximum !== undefined)
+                constraints.maximum = swaggerMeta.maximum;
+            if (swaggerMeta.enum !== undefined)
+                constraints.enum = swaggerMeta.enum;
+        }
+        result.push({ propertyKey: key, description, isOptional, constraints });
+    }
+    return result;
+}
+/**
+ * Build a Zod field schema with constraints applied.
+ */
+function buildFieldSchema(designType, constraints) {
+    const baseSchema = designTypeToZod(designType);
+    // Apply constraints based on the Zod type
+    if (baseSchema instanceof z.ZodString) {
+        return applyStringConstraints(baseSchema, constraints);
+    }
+    if (baseSchema instanceof z.ZodNumber) {
+        return applyNumberConstraints(baseSchema, constraints);
+    }
+    if (constraints.enum && constraints.enum.length > 0) {
+        return buildEnumSchema(constraints.enum);
+    }
+    return baseSchema;
+}
+function applyStringConstraints(schema, constraints) {
+    let s = schema;
+    if (constraints.minLength !== undefined)
+        s = s.min(constraints.minLength);
+    if (constraints.maxLength !== undefined)
+        s = s.max(constraints.maxLength);
+    // Enum overrides string type entirely
+    if (constraints.enum && constraints.enum.length > 0) {
+        return buildEnumSchema(constraints.enum);
+    }
+    return s;
+}
+function applyNumberConstraints(schema, constraints) {
+    let n = schema;
+    if (constraints.minimum !== undefined)
+        n = n.min(constraints.minimum);
+    if (constraints.maximum !== undefined)
+        n = n.max(constraints.maximum);
+    return n;
+}
+function buildEnumSchema(values) {
+    const stringValues = values.filter((v) => typeof v === 'string');
+    if (stringValues.length >= 2) {
+        return z.enum(stringValues);
+    }
+    if (stringValues.length === 1) {
+        return z.literal(stringValues[0]);
+    }
+    return z.unknown();
+}
+/**
+ * Append constraint hints to the base description so the AI model
+ * knows the validation rules before generating values.
+ */
+function buildEnrichedDescription(baseDescription, constraints) {
+    const hints = [];
+    if (constraints.minLength !== undefined && constraints.maxLength !== undefined) {
+        hints.push(`${constraints.minLength}-${constraints.maxLength} characters`);
+    }
+    else if (constraints.minLength !== undefined) {
+        hints.push(`min ${constraints.minLength} characters`);
+    }
+    else if (constraints.maxLength !== undefined) {
+        hints.push(`max ${constraints.maxLength} characters`);
+    }
+    if (constraints.minimum !== undefined && constraints.maximum !== undefined) {
+        hints.push(`range ${constraints.minimum}-${constraints.maximum}`);
+    }
+    else if (constraints.minimum !== undefined) {
+        hints.push(`min ${constraints.minimum}`);
+    }
+    else if (constraints.maximum !== undefined) {
+        hints.push(`max ${constraints.maximum}`);
+    }
+    if (constraints.enum && constraints.enum.length > 0) {
+        const values = constraints.enum
+            .filter((v) => typeof v === 'string' || typeof v === 'number')
+            .map((v) => String(v));
+        if (values.length > 0) {
+            hints.push(`one of: ${values.join(', ')}`);
+        }
+    }
+    if (hints.length === 0)
+        return baseDescription;
+    const constraintSuffix = `(${hints.join('; ')})`;
+    return baseDescription
+        ? `${baseDescription} ${constraintSuffix}`
+        : constraintSuffix;
+}
+function designTypeToZod(designType) {
+    if (!designType)
+        return z.unknown();
+    switch (designType) {
+        case String:
+            return z.string();
+        case Number:
+            return z.number();
+        case Boolean:
+            return z.boolean();
+        case Array:
+            return z.array(z.unknown());
+        case Date:
+            return z.string();
+        default:
+            return z.unknown();
+    }
+}
+/**
+ * Extract @Param() parameter names from a controller method's route arguments metadata.
+ * NestJS stores route arguments under '__routeArguments__' with keys like "5:0" where
+ * 5 = RouteParamtypes.PARAM. The `data` field holds the parameter name (e.g., 'id').
+ */
+export function extractRouteParams(controllerClass, methodName) {
+    const ROUTE_ARGS_METADATA = '__routeArguments__';
+    const PARAM_TYPE = '5'; // RouteParamtypes.PARAM
+    const routeArgs = Reflect.getMetadata(ROUTE_ARGS_METADATA, controllerClass, methodName) ?? {};
+    const params = [];
+    for (const [key, value] of Object.entries(routeArgs)) {
+        if (key.startsWith(`${PARAM_TYPE}:`) && value.data) {
+            params.push(value.data);
+        }
+    }
+    return params;
+}
+/**
+ * Check if a property has a default value on a constructed instance.
+ * If so, mark it as optional.
+ */
+function detectOptionalByDefault(dtoClass, propertyKey, fieldSchema) {
+    try {
+        const constructed = new dtoClass();
+        if (constructed &&
+            typeof constructed === 'object' &&
+            propertyKey in constructed) {
+            return fieldSchema.optional();
+        }
+    }
+    catch {
+        // Cannot construct, skip optional detection
+    }
+    return fieldSchema;
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/server/adapters/nestjs/scanner/schema-builder.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Walks an OpenAPI document and merges `@AiTool` decorator metadata
+ * into each matching operation as an `x-ai` extension.
+ *
+ * Mutates `document` in place.
+ */
+export declare function applyAiExtensions(document: Record<string, unknown>, controllers: Array<new (...args: unknown[]) => unknown>): void;

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

@@ -0,0 +1,37 @@
+import { getAiModuleMeta, getAllAiTools } from './metadata.js';
+/**
+ * Walks an OpenAPI document and merges `@AiTool` decorator metadata
+ * into each matching operation as an `x-ai` extension.
+ *
+ * Mutates `document` in place.
+ */
+export function applyAiExtensions(document, controllers) {
+    const paths = document['paths'];
+    if (!paths)
+        return;
+    for (const controller of controllers) {
+        const moduleMeta = getAiModuleMeta(controller);
+        const tools = getAllAiTools(controller);
+        for (const tool of tools) {
+            const toolPath = tool.path;
+            const toolMethod = tool.method?.toLowerCase();
+            if (!toolPath || !toolMethod)
+                continue;
+            const pathItem = paths[toolPath];
+            if (!pathItem)
+                continue;
+            const operation = pathItem[toolMethod];
+            if (!operation)
+                continue;
+            const extension = {
+                enabled: true,
+                toolName: tool.name,
+                description: tool.description,
+                needsApproval: tool.needsApproval,
+                module: moduleMeta?.intent,
+            };
+            operation['x-ai'] = extension;
+        }
+    }
+}
+//# sourceMappingURL=swagger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swagger.js","sourceRoot":"","sources":["../../../../src/server/adapters/nestjs/swagger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAW/D;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiC,EACjC,WAAuD;IAEvD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAEjB,CAAC;IAEd,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;YAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,EAA4B,CAAC;YAExE,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU;gBAAE,SAAS;YAEvC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YAExB,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvC,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,MAAM,SAAS,GAAuB;gBACpC,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,MAAM,EAAE,UAAU,EAAE,MAAM;aAC3B,CAAC;YAEF,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QAChC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/server/adapters/nextjs/context-helpers.d.ts

@@ -0,0 +1,22 @@
+import type { ToolContext, RuntimeContext } from '../../../types.js';
+import { type InternalApiCaller, type NextInternalApiCallerOptions } from '../../core/index.js';
+/**
+ * Extract origin from a Next.js request.
+ * Checks x-forwarded-host/host headers, falls back to req.url.
+ */
+export declare function extractOrigin(req: Request): string;
+/**
+ * Build a RuntimeContext from a Next.js request.
+ */
+export declare function buildRuntimeContext(req: Request): RuntimeContext;
+/**
+ * Build a complete ToolContext from a Next.js request.
+ */
+export declare function buildToolContext(req: Request, options?: {
+    locale?: string;
+}): ToolContext;
+/**
+ * Create an InternalApiCaller from a Next.js request.
+ * Automatically extracts origin and cookies.
+ */
+export declare function createInternalApiCallerFromRequest(req: Request, overrides?: Partial<NextInternalApiCallerOptions>): InternalApiCaller;

package/dist/server/adapters/nextjs/context-helpers.js

@@ -0,0 +1,55 @@
+import { createNextInternalApiCaller, } from '../../core/index.js';
+/**
+ * Extract origin from a Next.js request.
+ * Checks x-forwarded-host/host headers, falls back to req.url.
+ */
+export function extractOrigin(req) {
+    const forwardedHost = req.headers.get('x-forwarded-host');
+    const forwardedProto = req.headers.get('x-forwarded-proto') ?? 'https';
+    if (forwardedHost) {
+        return `${forwardedProto}://${forwardedHost}`;
+    }
+    const host = req.headers.get('host');
+    if (host) {
+        const proto = host.startsWith('localhost') ? 'http' : 'https';
+        return `${proto}://${host}`;
+    }
+    try {
+        const url = new URL(req.url);
+        return url.origin;
+    }
+    catch {
+        return 'http://localhost:3000';
+    }
+}
+/**
+ * Build a RuntimeContext from a Next.js request.
+ */
+export function buildRuntimeContext(req) {
+    return {
+        origin: extractOrigin(req),
+        cookieHeader: req.headers.get('cookie') ?? undefined,
+    };
+}
+/**
+ * Build a complete ToolContext from a Next.js request.
+ */
+export function buildToolContext(req, options) {
+    return {
+        currentDate: new Date(),
+        locale: options?.locale ?? 'en-US',
+        runtime: buildRuntimeContext(req),
+    };
+}
+/**
+ * Create an InternalApiCaller from a Next.js request.
+ * Automatically extracts origin and cookies.
+ */
+export function createInternalApiCallerFromRequest(req, overrides) {
+    return createNextInternalApiCaller({
+        origin: extractOrigin(req),
+        cookieHeader: req.headers.get('cookie') ?? undefined,
+        ...overrides,
+    });
+}
+//# sourceMappingURL=context-helpers.js.map

package/dist/server/adapters/nextjs/context-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.js","sourceRoot":"","sources":["../../../../src/server/adapters/nextjs/context-helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,2BAA2B,GAG5B,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,MAAM,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAC1D,MAAM,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC;IAEvE,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,GAAG,cAAc,MAAM,aAAa,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,OAAO,GAAG,KAAK,MAAM,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO;QACL,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;QAC1B,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS;KACrD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAY,EACZ,OAA6B;IAE7B,OAAO;QACL,WAAW,EAAE,IAAI,IAAI,EAAE;QACvB,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,OAAO;QAClC,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC;KAClC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAChD,GAAY,EACZ,SAAiD;IAEjD,OAAO,2BAA2B,CAAC;QACjC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC;QAC1B,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,SAAS;QACpD,GAAG,SAAS;KACb,CAAC,CAAC;AACL,CAAC"}