@lenne.tech/nest-server 11.25.6 → 11.26.0

package/dist/core/modules/ai/services/core-ai-mcp.service.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);
+};
+var CoreAiMcpService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreAiMcpService = void 0;
+const common_1 = require("@nestjs/common");
+const ai_tool_registry_1 = require("../tools/ai-tool.registry");
+let CoreAiMcpService = CoreAiMcpService_1 = class CoreAiMcpService {
+    toolRegistry;
+    logger = new common_1.Logger(CoreAiMcpService_1.name);
+    constructor(toolRegistry) {
+        this.toolRegistry = toolRegistry;
+    }
+    mcpListTools(user) {
+        return this.toolRegistry
+            .forUser(user)
+            .map((tool) => ({ description: tool.description, inputSchema: tool.parameters, name: tool.name }));
+    }
+    async mcpCallTool(user, name, args) {
+        const tool = this.toolRegistry.forUser(user).find((t) => t.name === name);
+        if (!tool) {
+            return { content: [{ text: `Unknown or not permitted tool: ${name}`, type: 'text' }], isError: true };
+        }
+        const context = {
+            currentUser: (user ?? undefined),
+            serviceOptions: { currentUser: (user ?? undefined) },
+        };
+        try {
+            const result = await tool.execute(args ?? {}, context);
+            return { content: [{ text: JSON.stringify(result), type: 'text' }] };
+        }
+        catch (err) {
+            this.logger.warn(`MCP tool "${name}" failed: ${err.message}`);
+            return { content: [{ text: err.message, type: 'text' }], isError: true };
+        }
+    }
+    async createServer(user) {
+        const { Server } = await Promise.resolve().then(() => require('@modelcontextprotocol/sdk/server/index.js'));
+        const { CallToolRequestSchema, ListToolsRequestSchema } = await Promise.resolve().then(() => require('@modelcontextprotocol/sdk/types.js'));
+        const server = new Server({ name: 'lt-nest-server-ai', version: '1.0.0' }, { capabilities: { tools: {} } });
+        server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: this.mcpListTools(user) }));
+        server.setRequestHandler(CallToolRequestSchema, async (request) => this.mcpCallTool(user, request.params.name, request.params.arguments ?? {}));
+        return server;
+    }
+};
+exports.CoreAiMcpService = CoreAiMcpService;
+exports.CoreAiMcpService = CoreAiMcpService = CoreAiMcpService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [ai_tool_registry_1.AiToolRegistry])
+], CoreAiMcpService);
+//# sourceMappingURL=core-ai-mcp.service.js.map

package/dist/core/modules/ai/services/core-ai-mcp.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ai-mcp.service.js","sourceRoot":"","sources":["../../../../../src/core/modules/ai/services/core-ai-mcp.service.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/ai/services/core-ai-mode.service.d.ts

@@ -0,0 +1,14 @@
+import { Logger } from '@nestjs/common';
+import { Model } from 'mongoose';
+import { CrudService } from '../../../common/services/crud.service';
+import { CoreModelConstructor } from '../../../common/types/core-model-constructor.type';
+import { AiModeDocument, CoreAiMode } from '../models/core-ai-mode.model';
+export declare const AI_MODE_MODEL = "AiMode";
+export declare const AI_MODE_CLASS = "AI_MODE_CLASS";
+export declare class CoreAiModeService extends CrudService<CoreAiMode, CoreAiMode, CoreAiMode> {
+    protected readonly mainDbModel: Model<AiModeDocument>;
+    protected readonly mainModelConstructor: CoreModelConstructor<CoreAiMode>;
+    protected readonly logger: Logger;
+    constructor(mainDbModel: Model<AiModeDocument>, mainModelConstructor: CoreModelConstructor<CoreAiMode>);
+    getByName(name: string): Promise<CoreAiMode | null>;
+}

package/dist/core/modules/ai/services/core-ai-mode.service.js

@@ -0,0 +1,56 @@
+"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 CoreAiModeService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreAiModeService = exports.AI_MODE_CLASS = exports.AI_MODE_MODEL = void 0;
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("@nestjs/mongoose");
+const mongoose_2 = require("mongoose");
+const crud_service_1 = require("../../../common/services/crud.service");
+exports.AI_MODE_MODEL = 'AiMode';
+exports.AI_MODE_CLASS = 'AI_MODE_CLASS';
+let CoreAiModeService = CoreAiModeService_1 = class CoreAiModeService extends crud_service_1.CrudService {
+    mainDbModel;
+    mainModelConstructor;
+    logger = new common_1.Logger(CoreAiModeService_1.name);
+    constructor(mainDbModel, mainModelConstructor) {
+        super();
+        this.mainDbModel = mainDbModel;
+        this.mainModelConstructor = mainModelConstructor;
+    }
+    async getByName(name) {
+        if (!name) {
+            return null;
+        }
+        try {
+            const row = await this.mainDbModel
+                .findOne({ enabled: { $ne: false }, name })
+                .lean()
+                .exec();
+            return row || null;
+        }
+        catch (err) {
+            this.logger.warn(`Failed to load mode "${name}": ${err.message}`);
+            return null;
+        }
+    }
+};
+exports.CoreAiModeService = CoreAiModeService;
+exports.CoreAiModeService = CoreAiModeService = CoreAiModeService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, mongoose_1.InjectModel)(exports.AI_MODE_MODEL)),
+    __param(1, (0, common_1.Inject)(exports.AI_MODE_CLASS)),
+    __metadata("design:paramtypes", [mongoose_2.Model, Object])
+], CoreAiModeService);
+//# sourceMappingURL=core-ai-mode.service.js.map

package/dist/core/modules/ai/services/core-ai-mode.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ai-mode.service.js","sourceRoot":"","sources":["../../../../../src/core/modules/ai/services/core-ai-mode.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAA4D;AAC5D,+CAA+C;AAC/C,uCAAiC;AAEjC,wEAAoE;AAIvD,QAAA,aAAa,GAAG,QAAQ,CAAC;AACzB,QAAA,aAAa,GAAG,eAAe,CAAC;AAOtC,IAAM,iBAAiB,yBAAvB,MAAM,iBAAkB,SAAQ,0BAA+C;IAI1B;IACL;IAJlC,MAAM,GAAG,IAAI,eAAM,CAAC,mBAAiB,CAAC,IAAI,CAAC,CAAC;IAE/D,YAC0D,WAAkC,EACvC,oBAAsD;QAEzG,KAAK,EAAE,CAAC;QAHgD,gBAAW,GAAX,WAAW,CAAuB;QACvC,yBAAoB,GAApB,oBAAoB,CAAkC;IAG3G,CAAC;IAGD,KAAK,CAAC,SAAS,CAAC,IAAY;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW;iBAC/B,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC;iBAC1C,IAAI,EAAc;iBAClB,IAAI,EAAE,CAAC;YACV,OAAO,GAAG,IAAI,IAAI,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF,CAAA;AA1BY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;IAKR,WAAA,IAAA,sBAAW,EAAC,qBAAa,CAAC,CAAA;IAC1B,WAAA,IAAA,eAAM,EAAC,qBAAa,CAAC,CAAA;qCAD+C,gBAAK;GAJjE,iBAAiB,CA0B7B"}

package/dist/core/modules/ai/services/core-ai-placeholder.registry.d.ts

@@ -0,0 +1,15 @@
+import { Logger, OnModuleInit } from '@nestjs/common';
+import { AiPlaceholderContext, AiPlaceholderInfo, IAiPlaceholder } from '../interfaces/ai-placeholder.interface';
+import { CoreAiPromptHintService } from './core-ai-prompt-hint.service';
+export declare class CoreAiPlaceholderRegistry implements OnModuleInit {
+    protected readonly hintService?: CoreAiPromptHintService;
+    protected readonly logger: Logger;
+    protected readonly placeholders: Map<string, IAiPlaceholder>;
+    constructor(hintService?: CoreAiPromptHintService);
+    onModuleInit(): void;
+    register(placeholder: IAiPlaceholder): void;
+    unregister(name: string): boolean;
+    list(): AiPlaceholderInfo[];
+    resolveAll(ctx: AiPlaceholderContext): Promise<Record<string, string>>;
+    protected registerDefaults(): void;
+}

package/dist/core/modules/ai/services/core-ai-placeholder.registry.js

@@ -0,0 +1,102 @@
+"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 CoreAiPlaceholderRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreAiPlaceholderRegistry = void 0;
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../../../common/services/config.service");
+const core_ai_prompt_hint_service_1 = require("./core-ai-prompt-hint.service");
+let CoreAiPlaceholderRegistry = CoreAiPlaceholderRegistry_1 = class CoreAiPlaceholderRegistry {
+    hintService;
+    logger = new common_1.Logger(CoreAiPlaceholderRegistry_1.name);
+    placeholders = new Map();
+    constructor(hintService) {
+        this.hintService = hintService;
+    }
+    onModuleInit() {
+        this.registerDefaults();
+    }
+    register(placeholder) {
+        if (!placeholder?.name) {
+            this.logger.warn('Refusing to register a placeholder with no name.');
+            return;
+        }
+        this.placeholders.set(placeholder.name, placeholder);
+    }
+    unregister(name) {
+        return this.placeholders.delete(name);
+    }
+    list() {
+        return [...this.placeholders.values()]
+            .map((p) => ({ description: p.description, example: p.example, name: p.name }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+    }
+    async resolveAll(ctx) {
+        const out = {};
+        for (const p of this.placeholders.values()) {
+            try {
+                const value = await p.resolve(ctx);
+                out[p.name] = value === null || value === undefined ? '' : String(value);
+            }
+            catch (err) {
+                this.logger.warn(`Placeholder ${p.name} failed to resolve: ${err.message}`);
+                out[p.name] = '';
+            }
+        }
+        return out;
+    }
+    registerDefaults() {
+        this.register({
+            description: 'Comma-separated list of the current user roles (e.g. "admin, editor"). "none" when empty.',
+            example: 'admin, editor',
+            name: 'roles',
+            resolve: (ctx) => (ctx.user?.roles?.length ? ctx.user.roles.join(', ') : 'none'),
+        });
+        this.register({
+            description: 'Comma-separated list of the tools the current user may use this turn.',
+            example: 'get_user, find_users',
+            name: 'tools',
+            resolve: (ctx) => (ctx.tools?.length ? ctx.tools.map((t) => t.name).join(', ') : 'none'),
+        });
+        this.register({
+            description: 'Full tool catalog with names, descriptions and parameter schemas (LLM-readable).',
+            name: 'toolCatalog',
+            resolve: (ctx) => ctx.toolCatalog ?? '',
+        });
+        this.register({
+            description: 'System documentation injected into the prompt (from the `ai.documentation` config or a project override).',
+            name: 'documentation',
+            resolve: () => config_service_1.ConfigService.get('ai.documentation') || '',
+        });
+        this.register({
+            description: 'Admin-approved hints from the governed learning loop, scoped to the tools in use this turn. Empty when nothing applies.',
+            name: 'learnedHints',
+            resolve: async (ctx) => {
+                if (!this.hintService)
+                    return '';
+                const learned = await this.hintService.approvedHints((ctx.tools || []).map((t) => t.name));
+                return learned.length ? learned.map((h) => `- ${h}`).join('\n') : '';
+            },
+        });
+        this.register({
+            description: 'Current user id (empty when no user is in context).',
+            example: '6a16c51530d808eb40a93d66',
+            name: 'userId',
+            resolve: (ctx) => ctx.user?.id || '',
+        });
+    }
+};
+exports.CoreAiPlaceholderRegistry = CoreAiPlaceholderRegistry;
+exports.CoreAiPlaceholderRegistry = CoreAiPlaceholderRegistry = CoreAiPlaceholderRegistry_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_ai_prompt_hint_service_1.CoreAiPromptHintService])
+], CoreAiPlaceholderRegistry);
+//# sourceMappingURL=core-ai-placeholder.registry.js.map

package/dist/core/modules/ai/services/core-ai-placeholder.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ai-placeholder.registry.js","sourceRoot":"","sources":["../../../../../src/core/modules/ai/services/core-ai-placeholder.registry.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/ai/services/core-ai-prompt-builder.service.d.ts

@@ -0,0 +1,42 @@
+import { IAiTool } from '../interfaces/ai-tool.interface';
+import { LlmToolSchema } from '../interfaces/llm-provider.interface';
+import { CoreAiPlaceholderRegistry } from './core-ai-placeholder.registry';
+import { CoreAiPromptHintService } from './core-ai-prompt-hint.service';
+import { CoreAiSlotService, ResolvedPromptFragment } from './core-ai-slot.service';
+export interface BuildPromptOptions {
+    language?: string;
+    mode?: string;
+}
+export declare class CoreAiPromptBuilderService {
+    protected readonly templateService?: CoreAiSlotService;
+    protected readonly hintService?: CoreAiPromptHintService;
+    protected readonly placeholderRegistry?: CoreAiPlaceholderRegistry;
+    protected readonly autoOnlyKeys: string[];
+    protected readonly defaultSystemPrompt: string;
+    protected readonly toolKeys: string[];
+    constructor(templateService?: CoreAiSlotService, hintService?: CoreAiPromptHintService, placeholderRegistry?: CoreAiPlaceholderRegistry);
+    buildSystemPrompt(tools: IAiTool[], supportsNativeTools: boolean, user?: {
+        id?: string;
+        roles?: string[];
+    }, options?: BuildPromptOptions): Promise<string>;
+    buildPlanSystemPrompt(tools: IAiTool[], user?: {
+        id?: string;
+        roles?: string[];
+    }, options?: BuildPromptOptions): Promise<string>;
+    buildToolSchemas(tools: IAiTool[]): LlmToolSchema[];
+    protected defaultFragments(): ResolvedPromptFragment[];
+    protected getDocumentation(): string | undefined;
+    protected resolveFragments(capability: string, locale?: string, scopes?: string[]): Promise<ResolvedPromptFragment[]>;
+    protected computeScopes(tools: IAiTool[], user?: {
+        id?: string;
+        roles?: string[];
+    }, options?: BuildPromptOptions & {
+        mode?: string;
+    }): string[];
+    protected renderContext(tools: IAiTool[], user?: {
+        id?: string;
+        roles?: string[];
+    }): Promise<Record<string, string>>;
+    protected assemble(fragments: ResolvedPromptFragment[], context: Record<string, string>, toolCount: number): string;
+    protected render(template: string, context: Record<string, string>): string;
+}

package/dist/core/modules/ai/services/core-ai-prompt-builder.service.js

@@ -0,0 +1,136 @@
+"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); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreAiPromptBuilderService = void 0;
+const common_1 = require("@nestjs/common");
+const config_service_1 = require("../../../common/services/config.service");
+const core_ai_placeholder_registry_1 = require("./core-ai-placeholder.registry");
+const core_ai_prompt_hint_service_1 = require("./core-ai-prompt-hint.service");
+const core_ai_slot_service_1 = require("./core-ai-slot.service");
+let CoreAiPromptBuilderService = class CoreAiPromptBuilderService {
+    templateService;
+    hintService;
+    placeholderRegistry;
+    autoOnlyKeys = ['output_contract', 'plan_protocol', 'tool_catalog', 'tool_protocol_emulated'];
+    defaultSystemPrompt = 'You are a helpful assistant integrated into a business application. ' +
+        'Answer concisely and only use information you can obtain through the provided tools. ' +
+        'Never invent data. If a request cannot be fulfilled with the available tools, say so.';
+    toolKeys = ['output_contract', 'plan_protocol', 'tool_catalog', 'tool_protocol_emulated'];
+    constructor(templateService, hintService, placeholderRegistry) {
+        this.templateService = templateService;
+        this.hintService = hintService;
+        this.placeholderRegistry = placeholderRegistry;
+    }
+    async buildSystemPrompt(tools, supportsNativeTools, user, options) {
+        const capability = supportsNativeTools ? 'native' : 'emulated';
+        const fragments = await this.resolveFragments(capability, options?.language, this.computeScopes(tools, user, options));
+        const context = await this.renderContext(tools, user);
+        return this.assemble(fragments.filter((f) => f.key !== 'plan_protocol'), context, tools.length);
+    }
+    async buildPlanSystemPrompt(tools, user, options) {
+        const fragments = await this.resolveFragments('emulated', options?.language, this.computeScopes(tools, user, options));
+        const context = await this.renderContext(tools, user);
+        const planFragments = fragments.filter((f) => f.key === 'plan_protocol' || !this.autoOnlyKeys.includes(f.key));
+        return this.assemble(planFragments, context, tools.length);
+    }
+    buildToolSchemas(tools) {
+        return tools.map((t) => ({ description: t.description, name: t.name, parameters: t.parameters }));
+    }
+    defaultFragments() {
+        return (0, core_ai_slot_service_1.getSystemDefaultSlots)(config_service_1.ConfigService.get('ai.systemPrompt') || this.defaultSystemPrompt);
+    }
+    getDocumentation() {
+        return config_service_1.ConfigService.get('ai.documentation') || undefined;
+    }
+    async resolveFragments(capability, locale, scopes) {
+        const defaults = this.defaultFragments();
+        const activeScopes = scopes ?? [];
+        if (!this.templateService) {
+            return defaults
+                .filter((f) => !f.capability || f.capability === 'all' || f.capability === capability)
+                .filter((f) => !f.scope || activeScopes.includes(f.scope))
+                .sort((a, b) => a.order - b.order);
+        }
+        return this.templateService.resolveFragments(defaults, { capability, locale, scopes: activeScopes });
+    }
+    computeScopes(tools, user, options) {
+        const scopes = [];
+        for (const tool of tools || []) {
+            if (tool?.name) {
+                scopes.push(`tool:${tool.name}`);
+            }
+        }
+        for (const role of user?.roles || []) {
+            scopes.push(`role:${role}`);
+        }
+        if (options?.mode) {
+            scopes.push(`mode:${options.mode}`);
+        }
+        return scopes;
+    }
+    async renderContext(tools, user) {
+        const defer = config_service_1.ConfigService.get('ai.deferToolSchemas') === true;
+        const toolCatalog = defer
+            ? (tools.map((t) => `- ${t.name}: ${t.description}`).join('\n') || '(none)') +
+                '\n\n[Schemas deferred. Call `search_tools` with the tool name to fetch its parameter schema BEFORE you call it.]'
+            : tools
+                .map((t) => `- ${t.name}: ${t.description}\n  parameters (JSON schema): ${JSON.stringify(t.parameters)}`)
+                .join('\n') || '(none)';
+        if (this.placeholderRegistry) {
+            return this.placeholderRegistry.resolveAll({ toolCatalog, tools, user });
+        }
+        const learned = this.hintService ? await this.hintService.approvedHints(tools.map((t) => t.name)) : [];
+        return {
+            documentation: this.getDocumentation() || '',
+            learnedHints: learned.length ? learned.map((h) => `- ${h}`).join('\n') : '',
+            roles: user?.roles?.length ? user.roles.join(', ') : 'none',
+            toolCatalog,
+            tools: tools.map((t) => t.name).join(', ') || 'none',
+            userId: user?.id || '',
+        };
+    }
+    assemble(fragments, context, toolCount) {
+        const parts = [];
+        for (const fragment of fragments) {
+            if (fragment.key === 'documentation' && !context.documentation) {
+                continue;
+            }
+            if (fragment.key === 'learned_hints' && !context.learnedHints) {
+                continue;
+            }
+            if (this.toolKeys.includes(fragment.key) && toolCount === 0) {
+                continue;
+            }
+            const rendered = this.render(fragment.content, context).trim();
+            if (rendered) {
+                parts.push(rendered);
+            }
+        }
+        return parts.join('\n\n');
+    }
+    render(template, context) {
+        return template.replace(/\{\{\s*(\w+)\s*\}\}/g, (_match, key) => context[key] ?? '');
+    }
+};
+exports.CoreAiPromptBuilderService = CoreAiPromptBuilderService;
+exports.CoreAiPromptBuilderService = CoreAiPromptBuilderService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Optional)()),
+    __param(2, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [core_ai_slot_service_1.CoreAiSlotService,
+        core_ai_prompt_hint_service_1.CoreAiPromptHintService,
+        core_ai_placeholder_registry_1.CoreAiPlaceholderRegistry])
+], CoreAiPromptBuilderService);
+//# sourceMappingURL=core-ai-prompt-builder.service.js.map

package/dist/core/modules/ai/services/core-ai-prompt-builder.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ai-prompt-builder.service.js","sourceRoot":"","sources":["../../../../../src/core/modules/ai/services/core-ai-prompt-builder.service.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/ai/services/core-ai-prompt-hint.service.d.ts

@@ -0,0 +1,29 @@
+import { Logger } from '@nestjs/common';
+import { Model } from 'mongoose';
+import { CrudService } from '../../../common/services/crud.service';
+import { CoreModelConstructor } from '../../../common/types/core-model-constructor.type';
+import { CoreAiPromptHintCreateInput } from '../inputs/core-ai-prompt-hint-create.input';
+import { CoreAiPromptHintInput } from '../inputs/core-ai-prompt-hint.input';
+import { AiPromptHintDocument, CoreAiPromptHint } from '../models/core-ai-prompt-hint.model';
+export declare const AI_PROMPT_HINT_MODEL = "AiPromptHint";
+export declare const AI_PROMPT_HINT_CLASS = "AI_PROMPT_HINT_CLASS";
+export interface AiPromptFeedbackSignal {
+    content: string;
+    scope?: string;
+    trigger: string;
+}
+interface PromptLearningConfig {
+    autoApply: boolean;
+    enabled: boolean;
+    minOccurrences: number;
+}
+export declare class CoreAiPromptHintService extends CrudService<CoreAiPromptHint, CoreAiPromptHintCreateInput, CoreAiPromptHintInput> {
+    protected readonly mainDbModel: Model<AiPromptHintDocument>;
+    protected readonly mainModelConstructor: CoreModelConstructor<CoreAiPromptHint>;
+    protected readonly logger: Logger;
+    constructor(mainDbModel: Model<AiPromptHintDocument>, mainModelConstructor: CoreModelConstructor<CoreAiPromptHint>);
+    approvedHints(scopes?: string[]): Promise<string[]>;
+    recordSignal(signal: AiPromptFeedbackSignal): Promise<void>;
+    protected config(): PromptLearningConfig;
+}
+export {};

package/dist/core/modules/ai/services/core-ai-prompt-hint.service.js

@@ -0,0 +1,98 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var CoreAiPromptHintService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreAiPromptHintService = exports.AI_PROMPT_HINT_CLASS = exports.AI_PROMPT_HINT_MODEL = void 0;
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("@nestjs/mongoose");
+const mongoose_2 = require("mongoose");
+const config_service_1 = require("../../../common/services/config.service");
+const crud_service_1 = require("../../../common/services/crud.service");
+exports.AI_PROMPT_HINT_MODEL = 'AiPromptHint';
+exports.AI_PROMPT_HINT_CLASS = 'AI_PROMPT_HINT_CLASS';
+let CoreAiPromptHintService = CoreAiPromptHintService_1 = class CoreAiPromptHintService extends crud_service_1.CrudService {
+    mainDbModel;
+    mainModelConstructor;
+    logger = new common_1.Logger(CoreAiPromptHintService_1.name);
+    constructor(mainDbModel, mainModelConstructor) {
+        super();
+        this.mainDbModel = mainDbModel;
+        this.mainModelConstructor = mainModelConstructor;
+    }
+    async approvedHints(scopes = []) {
+        if (!this.config().enabled) {
+            return [];
+        }
+        try {
+            const rows = await this.mainDbModel
+                .find({ enabled: { $ne: false }, scope: { $in: [null, '', ...scopes] }, status: 'approved' })
+                .sort({ occurrences: -1 })
+                .lean()
+                .exec();
+            return rows.map((r) => r.content).filter((c) => !!c?.trim());
+        }
+        catch {
+            return [];
+        }
+    }
+    async recordSignal(signal) {
+        const config = this.config();
+        if (!config.enabled || !signal?.trigger || !signal?.content) {
+            return;
+        }
+        const scope = signal.scope || '';
+        try {
+            const existing = await this.mainDbModel
+                .findOne({ scope, trigger: signal.trigger })
+                .lean()
+                .exec();
+            if (existing) {
+                const occurrences = (existing.occurrences ?? 1) + 1;
+                const update = { occurrences };
+                if (config.autoApply && existing.status === 'suggested' && occurrences >= config.minOccurrences) {
+                    update.status = 'approved';
+                }
+                await this.mainDbModel.updateOne({ _id: existing._id }, { $set: update }).exec();
+                return;
+            }
+            const status = config.autoApply && config.minOccurrences <= 1 ? 'approved' : 'suggested';
+            await this.mainDbModel.create({
+                content: signal.content,
+                occurrences: 1,
+                scope,
+                status,
+                trigger: signal.trigger,
+            });
+        }
+        catch (err) {
+            this.logger.debug(`recordSignal skipped: ${err.message}`);
+        }
+    }
+    config() {
+        const raw = config_service_1.ConfigService.get('ai.promptLearning');
+        return {
+            autoApply: raw?.autoApply === true,
+            enabled: raw?.enabled !== false,
+            minOccurrences: typeof raw?.minOccurrences === 'number' && raw.minOccurrences > 0 ? raw.minOccurrences : 1,
+        };
+    }
+};
+exports.CoreAiPromptHintService = CoreAiPromptHintService;
+exports.CoreAiPromptHintService = CoreAiPromptHintService = CoreAiPromptHintService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, mongoose_1.InjectModel)(exports.AI_PROMPT_HINT_MODEL)),
+    __param(1, (0, common_1.Inject)(exports.AI_PROMPT_HINT_CLASS)),
+    __metadata("design:paramtypes", [mongoose_2.Model, Object])
+], CoreAiPromptHintService);
+//# sourceMappingURL=core-ai-prompt-hint.service.js.map

package/dist/core/modules/ai/services/core-ai-prompt-hint.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-ai-prompt-hint.service.js","sourceRoot":"","sources":["../../../../../src/core/modules/ai/services/core-ai-prompt-hint.service.ts"],"names":[],"mappings":"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"}

package/dist/core/modules/ai/services/core-ai-prompt.service.d.ts

@@ -0,0 +1,21 @@
+import { Logger } from '@nestjs/common';
+import { Model } from 'mongoose';
+import { ServiceOptions } from '../../../common/interfaces/service-options.interface';
+import { CrudService } from '../../../common/services/crud.service';
+import { CoreModelConstructor } from '../../../common/types/core-model-constructor.type';
+import { CoreAiPromptCreateInput } from '../inputs/core-ai-prompt-create.input';
+import { CoreAiPromptUpdateInput } from '../inputs/core-ai-prompt-update.input';
+import { AiPromptDocument, CoreAiPrompt } from '../models/core-ai-prompt.model';
+export declare const AI_PROMPT_MODEL = "AiPrompt";
+export declare const AI_PROMPT_CLASS = "AI_PROMPT_CLASS";
+export declare class CoreAiPromptService extends CrudService<CoreAiPrompt, CoreAiPromptCreateInput, CoreAiPromptUpdateInput> {
+    protected readonly mainDbModel: Model<AiPromptDocument>;
+    protected readonly mainModelConstructor: CoreModelConstructor<CoreAiPrompt>;
+    protected readonly logger: Logger;
+    constructor(mainDbModel: Model<AiPromptDocument>, mainModelConstructor: CoreModelConstructor<CoreAiPrompt>);
+    create(input: CoreAiPromptCreateInput, serviceOptions?: ServiceOptions): Promise<CoreAiPrompt>;
+    update(id: string, input: CoreAiPromptUpdateInput, serviceOptions?: ServiceOptions): Promise<CoreAiPrompt>;
+    delete(id: string, serviceOptions?: ServiceOptions): Promise<CoreAiPrompt>;
+    listVisible(serviceOptions?: ServiceOptions): Promise<CoreAiPrompt[]>;
+    protected assertOwner(id: string, serviceOptions: ServiceOptions): Promise<void>;
+}