@hed-hog/core 0.0.387 → 0.0.390

package/dist/ai/dto/chat.dto.js

@@ -23,7 +23,7 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsIn)(['openai', 'gemini']),
+    (0, class_validator_1.IsIn)(['openai', 'gemini', 'deepseek']),
     __metadata("design:type", String)
 ], ChatDTO.prototype, "provider", void 0);
 __decorate([
@@ -42,4 +42,26 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], ChatDTO.prototype, "file_id", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(2),
+    __metadata("design:type", Number)
+], ChatDTO.prototype, "temperature", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(200000),
+    __metadata("design:type", Number)
+], ChatDTO.prototype, "max_tokens", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsIn)(['text', 'json_object']),
+    __metadata("design:type", String)
+], ChatDTO.prototype, "response_format", void 0);
 //# sourceMappingURL=chat.dto.js.map

package/dist/ai/dto/chat.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/chat.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAAgF;AAEhF,MAAa,OAAO;CAsBnB;AAtBD,0BAsBC;AAnBC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wCACG;AAKhB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;;yCACI;AAI/B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;sCACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACW;AAKtB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,IAAA,uBAAK,GAAE;;wCACS"}
+{"version":3,"file":"chat.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/chat.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDASyB;AAEzB,MAAa,OAAO;CA2CnB;AA3CD,0BA2CC;AAxCC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;wCACG;AAKhB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;;yCACK;AAI5C;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;sCACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACW;AAKtB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,IAAA,uBAAK,GAAE;;wCACS;AASjB;IALC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,IAAA,0BAAQ,GAAE;IACV,IAAA,qBAAG,EAAC,CAAC,CAAC;IACN,IAAA,qBAAG,EAAC,CAAC,CAAC;;4CACc;AAOrB;IALC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IAClB,IAAA,uBAAK,GAAE;IACP,IAAA,qBAAG,EAAC,CAAC,CAAC;IACN,IAAA,qBAAG,EAAC,MAAM,CAAC;;2CACQ;AAKpB;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;;gDACW"}

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

@@ -1,6 +1,6 @@
 export declare class CreateAgentDTO {
     slug: string;
-    provider?: 'openai' | 'gemini';
+    provider?: 'openai' | 'gemini' | 'deepseek';
     model?: string;
     instructions?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../../src/ai/dto/create-agent.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAGzB,IAAI,EAAE,MAAM,CAAC;IAKb,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAI/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"create-agent.dto.d.ts","sourceRoot":"","sources":["../../../src/ai/dto/create-agent.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAGzB,IAAI,EAAE,MAAM,CAAC;IAKb,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAI5C,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

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

@@ -22,7 +22,7 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsIn)(['openai', 'gemini']),
+    (0, class_validator_1.IsIn)(['openai', 'gemini', 'deepseek']),
     __metadata("design:type", String)
 ], CreateAgentDTO.prototype, "provider", void 0);
 __decorate([

package/dist/ai/dto/create-agent.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/create-agent.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAyE;AAEzE,MAAa,cAAc;CAiB1B;AAjBD,wCAiBC;AAdC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;4CACA;AAKb;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;;gDACI;AAI/B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDACW"}
+{"version":3,"file":"create-agent.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/create-agent.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAAyE;AAEzE,MAAa,cAAc;CAiB1B;AAjBD,wCAiBC;AAdC;IAFC,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;4CACA;AAKb;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;;gDACK;AAI5C;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDACW"}

package/dist/ai/dto/update-agent.dto.d.ts

@@ -1,6 +1,6 @@
 export declare class UpdateAgentDTO {
     slug?: string;
-    provider?: 'openai' | 'gemini';
+    provider?: 'openai' | 'gemini' | 'deepseek';
     model?: string;
     instructions?: string;
 }

package/dist/ai/dto/update-agent.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../../src/ai/dto/update-agent.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAGzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAI/B,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"update-agent.dto.d.ts","sourceRoot":"","sources":["../../../src/ai/dto/update-agent.dto.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAc;IAGzB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAI5C,KAAK,CAAC,EAAE,MAAM,CAAC;IAIf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/ai/dto/update-agent.dto.js

@@ -22,7 +22,7 @@ __decorate([
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsIn)(['openai', 'gemini']),
+    (0, class_validator_1.IsIn)(['openai', 'gemini', 'deepseek']),
     __metadata("design:type", String)
 ], UpdateAgentDTO.prototype, "provider", void 0);
 __decorate([

package/dist/ai/dto/update-agent.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-agent.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/update-agent.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA6D;AAE7D,MAAa,cAAc;CAiB1B;AAjBD,wCAiBC;AAdC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4CACG;AAKd;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;;gDACI;AAI/B;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDACW"}
+{"version":3,"file":"update-agent.dto.js","sourceRoot":"","sources":["../../../src/ai/dto/update-agent.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,qDAA6D;AAE7D,MAAa,cAAc;CAiB1B;AAjBD,wCAiBC;AAdC;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4CACG;AAKd;IAHC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,sBAAI,EAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;;gDACK;AAI5C;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACI;AAIf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;oDACW"}

package/dist/ai-instruction/ai-instruction.controller.d.ts

@@ -1,25 +1,79 @@
 import { DeleteDTO } from '../dto/delete.dto';
 import { AiInstructionService } from './ai-instruction.service';
 import { CreateAiInstructionDTO } from './dto/create-ai-instruction.dto';
+import { PreviewAiInstructionDTO } from './dto/preview-ai-instruction.dto';
 import { UpdateAiInstructionDTO } from './dto/update-ai-instruction.dto';
+import type { AiInstructionLayer } from './types/ai-instruction.types';
 export declare class AiInstructionController {
     private readonly aiInstructionService;
     constructor(aiInstructionService: AiInstructionService);
-    list(paginationParams: any): Promise<{
-        data: import("./types/ai-instruction.types").AiInstructionRecord[];
+    list(paginationParams: any, layer?: AiInstructionLayer, moduleSlug?: string, isActive?: string): Promise<{
+        data: import("..").AiInstructionRecord[];
         total: number;
         page: number;
         pageSize: number;
         totalPages: number;
     }>;
-    getById(id: number): Promise<import("./types/ai-instruction.types").AiInstructionRecord>;
-    getBySlug(slug: string): Promise<import("./types/ai-instruction.types").AiInstructionRecord>;
-    create(dto: CreateAiInstructionDTO): Promise<import("./types/ai-instruction.types").AiInstructionRecord>;
-    update(id: number, dto: UpdateAiInstructionDTO): Promise<import("./types/ai-instruction.types").AiInstructionRecord>;
+    listModules(): Promise<string[]>;
+    listRegistry(moduleSlug?: string): Promise<{
+        slug: string;
+        name: string;
+        module_slug: string;
+        locale: string;
+        fallback: string;
+        variables: Record<string, import("./ai-prompt-template.util").VariableSpec>;
+        security_sensitive: boolean;
+        required_phrases: string[];
+        defaults: {
+            model?: string;
+            temperature?: number;
+            maxTokens?: number;
+        };
+        exists_in_db: boolean;
+        db_matches_fallback: boolean;
+    }[]>;
+    preview(dto: PreviewAiInstructionDTO): Promise<{
+        rendered: string;
+        render_error: string;
+        char_count: number;
+        estimated_tokens: number;
+        missing_required: string[];
+        unknown_placeholders: string[];
+        unbalanced_blocks: string[];
+        warnings: string[];
+    }>;
+    getById(id: number): Promise<import("..").AiInstructionRecord>;
+    getBySlug(slug: string, activeOnly?: string): Promise<import("..").AiInstructionRecord>;
+    create({ id }: {
+        id: number;
+    }, dto: CreateAiInstructionDTO): Promise<import("..").AiInstructionRecord>;
+    update({ id: userId }: {
+        id: number;
+    }, id: number, dto: UpdateAiInstructionDTO): Promise<{
+        warnings: string[];
+        id: number;
+        slug: string;
+        layer: AiInstructionLayer;
+        name: string;
+        content: string;
+        variables_schema: Record<string, any> | null;
+        locale: string;
+        module_slug: string | null;
+        is_active: boolean;
+        version: number;
+        model: string | null;
+        temperature: number | null;
+        max_tokens: number | null;
+        is_locked: boolean;
+        created_at: Date;
+        updated_at: Date;
+    }>;
     delete(data: DeleteDTO): Promise<{
         count: number;
     }>;
     listVersions(id: number): Promise<unknown>;
-    restoreVersion(id: number, version: number): Promise<import("./types/ai-instruction.types").AiInstructionRecord>;
+    restoreVersion({ id: userId }: {
+        id: number;
+    }, id: number, version: number): Promise<import("..").AiInstructionRecord>;
 }
 //# sourceMappingURL=ai-instruction.controller.d.ts.map

package/dist/ai-instruction/ai-instruction.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instruction.controller.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.controller.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,qBAEa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,oBAAoB;IAIvD,IAAI,CAAe,gBAAgB,KAAA;;;;;;;IAKnC,OAAO,CAA4B,EAAE,EAAE,MAAM;IAK7C,SAAS,CAAgB,IAAI,EAAE,MAAM;IAKrC,MAAM,CAAS,GAAG,EAAE,sBAAsB;IAK1C,MAAM,CACiB,EAAE,EAAE,MAAM,EAC7B,GAAG,EAAE,sBAAsB;IAM/B,MAAM,CAAS,IAAI,EAAE,SAAS;;;IAK9B,YAAY,CAA4B,EAAE,EAAE,MAAM;IAKlD,cAAc,CACS,EAAE,EAAE,MAAM,EACL,OAAO,EAAE,MAAM;CAIlD"}
+{"version":3,"file":"ai-instruction.controller.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.controller.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,qBAEa,uBAAuB;IAGhC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBAApB,oBAAoB,EAAE,oBAAoB;IAIvD,IAAI,CACM,gBAAgB,KAAA,EACd,KAAK,CAAC,EAAE,kBAAkB,EACpB,UAAU,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM;;;;;;;IAYjC,WAAW;IAKX,YAAY,CAAuB,UAAU,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;IAKtD,OAAO,CAAS,GAAG,EAAE,uBAAuB;;;;;;;;;;IAK5C,OAAO,CAA4B,EAAE,EAAE,MAAM;IAK7C,SAAS,CAAgB,IAAI,EAAE,MAAM,EAAuB,UAAU,CAAC,EAAE,MAAM;IAK/E,MAAM,CAAS,EAAE,EAAE,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAAU,GAAG,EAAE,sBAAsB;IAK1E,MAAM,CACF,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACX,EAAE,EAAE,MAAM,EAC7B,GAAG,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;IAM/B,MAAM,CAAS,IAAI,EAAE,SAAS;;;IAK9B,YAAY,CAA4B,EAAE,EAAE,MAAM;IAKlD,cAAc,CACV,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EACX,EAAE,EAAE,MAAM,EACL,OAAO,EAAE,MAAM;CAIlD"}

package/dist/ai-instruction/ai-instruction.controller.js

@@ -19,25 +19,41 @@ const common_1 = require("@nestjs/common");
 const delete_dto_1 = require("../dto/delete.dto");
 const ai_instruction_service_1 = require("./ai-instruction.service");
 const create_ai_instruction_dto_1 = require("./dto/create-ai-instruction.dto");
+const preview_ai_instruction_dto_1 = require("./dto/preview-ai-instruction.dto");
 const update_ai_instruction_dto_1 = require("./dto/update-ai-instruction.dto");
 let AiInstructionController = class AiInstructionController {
     constructor(aiInstructionService) {
         this.aiInstructionService = aiInstructionService;
     }
-    async list(paginationParams) {
-        return this.aiInstructionService.list(paginationParams);
+    async list(paginationParams, layer, moduleSlug, isActive) {
+        return this.aiInstructionService.list(paginationParams, {
+            layer: layer || undefined,
+            module_slug: moduleSlug || undefined,
+            is_active: isActive === undefined || isActive === '' ? undefined : isActive === 'true',
+        });
+    }
+    // Single-segment routes must be declared before `@Get(':id')`, otherwise
+    // ParseIntPipe rejects them with a 400.
+    async listModules() {
+        return this.aiInstructionService.listModules();
+    }
+    async listRegistry(moduleSlug) {
+        return this.aiInstructionService.listRegistry(moduleSlug || undefined);
+    }
+    async preview(dto) {
+        return this.aiInstructionService.previewPrompt(dto);
     }
     async getById(id) {
         return this.aiInstructionService.getById(id);
     }
-    async getBySlug(slug) {
-        return this.aiInstructionService.getBySlug(slug);
+    async getBySlug(slug, activeOnly) {
+        return this.aiInstructionService.getBySlug(slug, activeOnly === 'true');
     }
-    async create(dto) {
-        return this.aiInstructionService.create(dto);
+    async create({ id }, dto) {
+        return this.aiInstructionService.create(dto, id);
     }
-    async update(id, dto) {
-        return this.aiInstructionService.update(id, dto);
+    async update({ id: userId }, id, dto) {
+        return this.aiInstructionService.update(id, dto, userId);
     }
     async delete(data) {
         return this.aiInstructionService.delete(data);
@@ -45,18 +61,41 @@ let AiInstructionController = class AiInstructionController {
     async listVersions(id) {
         return this.aiInstructionService.listVersions(id);
     }
-    async restoreVersion(id, version) {
-        return this.aiInstructionService.restoreVersion(id, version);
+    async restoreVersion({ id: userId }, id, version) {
+        return this.aiInstructionService.restoreVersion(id, version, userId);
     }
 };
 exports.AiInstructionController = AiInstructionController;
 __decorate([
     (0, common_1.Get)(),
     __param(0, (0, api_pagination_1.Pagination)()),
+    __param(1, (0, common_1.Query)('layer')),
+    __param(2, (0, common_1.Query)('module_slug')),
+    __param(3, (0, common_1.Query)('is_active')),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
+    __metadata("design:paramtypes", [Object, String, String, String]),
     __metadata("design:returntype", Promise)
 ], AiInstructionController.prototype, "list", null);
+__decorate([
+    (0, common_1.Get)('modules'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", []),
+    __metadata("design:returntype", Promise)
+], AiInstructionController.prototype, "listModules", null);
+__decorate([
+    (0, common_1.Get)('registry'),
+    __param(0, (0, common_1.Query)('module_slug')),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], AiInstructionController.prototype, "listRegistry", null);
+__decorate([
+    (0, common_1.Post)('preview'),
+    __param(0, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [preview_ai_instruction_dto_1.PreviewAiInstructionDTO]),
+    __metadata("design:returntype", Promise)
+], AiInstructionController.prototype, "preview", null);
 __decorate([
     (0, common_1.Get)(':id'),
     __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
@@ -67,23 +106,26 @@ __decorate([
 __decorate([
     (0, common_1.Get)('slug/:slug'),
     __param(0, (0, common_1.Param)('slug')),
+    __param(1, (0, common_1.Query)('activeOnly')),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String]),
+    __metadata("design:paramtypes", [String, String]),
     __metadata("design:returntype", Promise)
 ], AiInstructionController.prototype, "getBySlug", null);
 __decorate([
     (0, common_1.Post)(),
-    __param(0, (0, common_1.Body)()),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Body)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [create_ai_instruction_dto_1.CreateAiInstructionDTO]),
+    __metadata("design:paramtypes", [Object, create_ai_instruction_dto_1.CreateAiInstructionDTO]),
     __metadata("design:returntype", Promise)
 ], AiInstructionController.prototype, "create", null);
 __decorate([
     (0, common_1.Patch)(':id'),
-    __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
-    __param(1, (0, common_1.Body)()),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Body)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Number, update_ai_instruction_dto_1.UpdateAiInstructionDTO]),
+    __metadata("design:paramtypes", [Object, Number, update_ai_instruction_dto_1.UpdateAiInstructionDTO]),
     __metadata("design:returntype", Promise)
 ], AiInstructionController.prototype, "update", null);
 __decorate([
@@ -102,10 +144,11 @@ __decorate([
 ], AiInstructionController.prototype, "listVersions", null);
 __decorate([
     (0, common_1.Post)(':id/versions/:version/restore'),
-    __param(0, (0, common_1.Param)('id', common_1.ParseIntPipe)),
-    __param(1, (0, common_1.Param)('version', common_1.ParseIntPipe)),
+    __param(0, (0, api_1.User)()),
+    __param(1, (0, common_1.Param)('id', common_1.ParseIntPipe)),
+    __param(2, (0, common_1.Param)('version', common_1.ParseIntPipe)),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Number, Number]),
+    __metadata("design:paramtypes", [Object, Number, Number]),
     __metadata("design:returntype", Promise)
 ], AiInstructionController.prototype, "restoreVersion", null);
 exports.AiInstructionController = AiInstructionController = __decorate([

package/dist/ai-instruction/ai-instruction.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instruction.controller.js","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,sCAAoC;AACpC,4DAAqD;AACrD,2CAWwB;AACxB,kDAA8C;AAC9C,qEAAgE;AAChE,+EAAyE;AACzE,+EAAyE;AAIlE,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YAEmB,oBAA0C;QAA1C,yBAAoB,GAApB,oBAAoB,CAAsB;IAC1D,CAAC;IAGE,AAAN,KAAK,CAAC,IAAI,CAAe,gBAAgB;QACvC,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1D,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAA4B,EAAU;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CAAgB,IAAY;QACzC,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAS,GAA2B;QAC9C,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CACiB,EAAU,EAC7B,GAA2B;QAEnC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAS,IAAe;QAClC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAGK,AAAN,KAAK,CAAC,YAAY,CAA4B,EAAU;QACtD,OAAO,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAGK,AAAN,KAAK,CAAC,cAAc,CACS,EAAU,EACL,OAAe;QAE/C,OAAO,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;CACF,CAAA;AAnDY,0DAAuB;AAO5B;IADL,IAAA,YAAG,GAAE;IACM,WAAA,IAAA,2BAAU,GAAE,CAAA;;;;mDAEvB;AAGK;IADL,IAAA,YAAG,EAAC,KAAK,CAAC;IACI,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;;;;sDAEvC;AAGK;IADL,IAAA,YAAG,EAAC,YAAY,CAAC;IACD,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;;;;wDAE7B;AAGK;IADL,IAAA,aAAI,GAAE;IACO,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,kDAAsB;;qDAE/C;AAGK;IADL,IAAA,cAAK,EAAC,KAAK,CAAC;IAEV,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,aAAI,GAAE,CAAA;;6CAAM,kDAAsB;;qDAGpC;AAGK;IADL,IAAA,eAAM,GAAE;IACK,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAO,sBAAS;;qDAEnC;AAGK;IADL,IAAA,YAAG,EAAC,cAAc,CAAC;IACA,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;;;;2DAE5C;AAGK;IADL,IAAA,aAAI,EAAC,+BAA+B,CAAC;IAEnC,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,cAAK,EAAC,SAAS,EAAE,qBAAY,CAAC,CAAA;;;;6DAGhC;kCAlDU,uBAAuB;IAFnC,IAAA,UAAI,GAAE;IACN,IAAA,mBAAU,EAAC,gBAAgB,CAAC;IAGxB,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,6CAAoB,CAAC,CAAC,CAAA;qCACR,6CAAoB;GAHlD,uBAAuB,CAmDnC"}
+{"version":3,"file":"ai-instruction.controller.js","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,sCAA0C;AAC1C,4DAAqD;AACrD,2CAYwB;AACxB,kDAA8C;AAC9C,qEAAgE;AAChE,+EAAyE;AACzE,iFAA2E;AAC3E,+EAAyE;AAKlE,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAClC,YAEmB,oBAA0C;QAA1C,yBAAoB,GAApB,oBAAoB,CAAsB;IAC1D,CAAC;IAGE,AAAN,KAAK,CAAC,IAAI,CACM,gBAAgB,EACd,KAA0B,EACpB,UAAmB,EACrB,QAAiB;QAErC,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,EAAE;YACtD,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,WAAW,EAAE,UAAU,IAAI,SAAS;YACpC,SAAS,EAAE,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM;SACvF,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,wCAAwC;IAElC,AAAN,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,oBAAoB,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC;IAGK,AAAN,KAAK,CAAC,YAAY,CAAuB,UAAmB;QAC1D,OAAO,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;IACzE,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAAS,GAA4B;QAChD,OAAO,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IAGK,AAAN,KAAK,CAAC,OAAO,CAA4B,EAAU;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAGK,AAAN,KAAK,CAAC,SAAS,CAAgB,IAAY,EAAuB,UAAmB;QACnF,OAAO,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,KAAK,MAAM,CAAC,CAAC;IAC1E,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAS,EAAE,EAAE,EAAkB,EAAU,GAA2B;QAC9E,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CACF,EAAE,EAAE,EAAE,MAAM,EAAkB,EACX,EAAU,EAC7B,GAA2B;QAEnC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAS,IAAe;QAClC,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAGK,AAAN,KAAK,CAAC,YAAY,CAA4B,EAAU;QACtD,OAAO,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAGK,AAAN,KAAK,CAAC,cAAc,CACV,EAAE,EAAE,EAAE,MAAM,EAAkB,EACX,EAAU,EACL,OAAe;QAE/C,OAAO,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvE,CAAC;CACF,CAAA;AA/EY,0DAAuB;AAO5B;IADL,IAAA,YAAG,GAAE;IAEH,WAAA,IAAA,2BAAU,GAAE,CAAA;IACZ,WAAA,IAAA,cAAK,EAAC,OAAO,CAAC,CAAA;IACd,WAAA,IAAA,cAAK,EAAC,aAAa,CAAC,CAAA;IACpB,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;;;;mDAOpB;AAKK;IADL,IAAA,YAAG,EAAC,SAAS,CAAC;;;;0DAGd;AAGK;IADL,IAAA,YAAG,EAAC,UAAU,CAAC;IACI,WAAA,IAAA,cAAK,EAAC,aAAa,CAAC,CAAA;;;;2DAEvC;AAGK;IADL,IAAA,aAAI,EAAC,SAAS,CAAC;IACD,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAM,oDAAuB;;sDAEjD;AAGK;IADL,IAAA,YAAG,EAAC,KAAK,CAAC;IACI,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;;;;sDAEvC;AAGK;IADL,IAAA,YAAG,EAAC,YAAY,CAAC;IACD,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IAAgB,WAAA,IAAA,cAAK,EAAC,YAAY,CAAC,CAAA;;;;wDAEhE;AAGK;IADL,IAAA,aAAI,GAAE;IACO,WAAA,IAAA,UAAI,GAAE,CAAA;IAA0B,WAAA,IAAA,aAAI,GAAE,CAAA;;6CAAM,kDAAsB;;qDAE/E;AAGK;IADL,IAAA,cAAK,EAAC,KAAK,CAAC;IAEV,WAAA,IAAA,UAAI,GAAE,CAAA;IACN,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,aAAI,GAAE,CAAA;;qDAAM,kDAAsB;;qDAGpC;AAGK;IADL,IAAA,eAAM,GAAE;IACK,WAAA,IAAA,aAAI,GAAE,CAAA;;qCAAO,sBAAS;;qDAEnC;AAGK;IADL,IAAA,YAAG,EAAC,cAAc,CAAC;IACA,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;;;;2DAE5C;AAGK;IADL,IAAA,aAAI,EAAC,+BAA+B,CAAC;IAEnC,WAAA,IAAA,UAAI,GAAE,CAAA;IACN,WAAA,IAAA,cAAK,EAAC,IAAI,EAAE,qBAAY,CAAC,CAAA;IACzB,WAAA,IAAA,cAAK,EAAC,SAAS,EAAE,qBAAY,CAAC,CAAA;;;;6DAGhC;kCA9EU,uBAAuB;IAFnC,IAAA,UAAI,GAAE;IACN,IAAA,mBAAU,EAAC,gBAAgB,CAAC;IAGxB,WAAA,IAAA,eAAM,EAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,6CAAoB,CAAC,CAAC,CAAA;qCACR,6CAAoB;GAHlD,uBAAuB,CA+EnC"}

package/dist/ai-instruction/ai-instruction.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instruction.module.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.module.ts"],"names":[],"mappings":"AAOA,qBAMa,mBAAmB;CAAG"}
+{"version":3,"file":"ai-instruction.module.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.module.ts"],"names":[],"mappings":"AAQA,qBAgBa,mBAAmB;CAAG"}

package/dist/ai-instruction/ai-instruction.module.js

@@ -13,6 +13,7 @@ const ai_execution_service_1 = require("./ai-execution.service");
 const ai_instruction_controller_1 = require("./ai-instruction.controller");
 const ai_instruction_service_1 = require("./ai-instruction.service");
 const ai_prompt_builder_service_1 = require("./ai-prompt-builder.service");
+const ai_prompt_resolver_service_1 = require("./ai-prompt-resolver.service");
 let AiInstructionModule = class AiInstructionModule {
 };
 exports.AiInstructionModule = AiInstructionModule;
@@ -20,8 +21,18 @@ exports.AiInstructionModule = AiInstructionModule = __decorate([
     (0, common_1.Module)({
         imports: [(0, common_1.forwardRef)(() => api_prisma_1.PrismaModule)],
         controllers: [ai_instruction_controller_1.AiInstructionController],
-        providers: [ai_instruction_service_1.AiInstructionService, ai_execution_service_1.AiExecutionService, ai_prompt_builder_service_1.AiPromptBuilderService],
-        exports: [ai_instruction_service_1.AiInstructionService, ai_execution_service_1.AiExecutionService, ai_prompt_builder_service_1.AiPromptBuilderService],
+        providers: [
+            ai_instruction_service_1.AiInstructionService,
+            ai_execution_service_1.AiExecutionService,
+            ai_prompt_builder_service_1.AiPromptBuilderService,
+            ai_prompt_resolver_service_1.AiPromptResolverService,
+        ],
+        exports: [
+            ai_instruction_service_1.AiInstructionService,
+            ai_execution_service_1.AiExecutionService,
+            ai_prompt_builder_service_1.AiPromptBuilderService,
+            ai_prompt_resolver_service_1.AiPromptResolverService,
+        ],
     })
 ], AiInstructionModule);
 //# sourceMappingURL=ai-instruction.module.js.map

package/dist/ai-instruction/ai-instruction.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instruction.module.js","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,2CAAoD;AACpD,iEAA4D;AAC5D,2EAAsE;AACtE,qEAAgE;AAChE,2EAAqE;AAQ9D,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAN/B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC,CAAC;QACzC,WAAW,EAAE,CAAC,mDAAuB,CAAC;QACtC,SAAS,EAAE,CAAC,6CAAoB,EAAE,yCAAkB,EAAE,kDAAsB,CAAC;QAC7E,OAAO,EAAE,CAAC,6CAAoB,EAAE,yCAAkB,EAAE,kDAAsB,CAAC;KAC5E,CAAC;GACW,mBAAmB,CAAG"}
+{"version":3,"file":"ai-instruction.module.js","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,oDAAmD;AACnD,2CAAoD;AACpD,iEAA4D;AAC5D,2EAAsE;AACtE,qEAAgE;AAChE,2EAAqE;AACrE,6EAAuE;AAkBhE,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAhB/B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,IAAA,mBAAU,EAAC,GAAG,EAAE,CAAC,yBAAY,CAAC,CAAC;QACzC,WAAW,EAAE,CAAC,mDAAuB,CAAC;QACtC,SAAS,EAAE;YACT,6CAAoB;YACpB,yCAAkB;YAClB,kDAAsB;YACtB,oDAAuB;SACxB;QACD,OAAO,EAAE;YACP,6CAAoB;YACpB,yCAAkB;YAClB,kDAAsB;YACtB,oDAAuB;SACxB;KACF,CAAC;GACW,mBAAmB,CAAG"}

package/dist/ai-instruction/ai-instruction.service.d.ts

@@ -1,36 +1,161 @@
 import { PaginationDTO } from '@hed-hog/api-pagination';
 import { PrismaService } from '@hed-hog/api-prisma';
-import { OnModuleInit } from '@nestjs/common';
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
 import { DeleteDTO } from '../dto/delete.dto';
 import { CreateAiInstructionDTO } from './dto/create-ai-instruction.dto';
+import { PreviewAiInstructionDTO } from './dto/preview-ai-instruction.dto';
 import { UpdateAiInstructionDTO } from './dto/update-ai-instruction.dto';
-import type { AiInstructionLayer, AiInstructionRecord } from './types/ai-instruction.types';
-export declare class AiInstructionService implements OnModuleInit {
+import type { AiInstructionLayer, AiInstructionListFilters, AiInstructionRecord } from './types/ai-instruction.types';
+export declare const FALLBACK_SYSTEM_PROMPT: string;
+export declare class AiInstructionService implements OnModuleInit, OnModuleDestroy {
     private readonly prisma;
     private readonly logger;
     private readonly cache;
+    private readonly instanceId;
+    private readonly redisChannel;
+    private readonly versionCheckIntervalMs;
+    private localCacheVersion;
+    private lastVersionCheckAt;
+    private versionCheckInFlight;
+    private versionStateEnsured;
+    private lastVersionCheckErrorLogAt;
+    private pubsub;
     constructor(prisma: PrismaService);
     onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+    /**
+     * Reports prompts declared in code that have no row yet. Without this, a
+     * forgotten seed only surfaces the first time that AI flow runs — which for
+     * essay grading means the first graded exam.
+     */
+    private warnAboutUnseededPrompts;
     getLayer(layer: AiInstructionLayer, moduleSlug?: string): Promise<string>;
     getAgentInstruction(agentSlug: string): Promise<string>;
+    /**
+     * Full record by exact slug, cached. This is what `AiPromptResolverService`
+     * uses for task prompts — it needs the model params and `is_locked`, not just
+     * the content.
+     */
+    getRecordBySlug(slug: string): Promise<AiInstructionRecord | null>;
+    /** One query for pipelines that resolve several prompts per call. */
+    getRecordsBySlugs(slugs: string[]): Promise<Map<string, AiInstructionRecord | null>>;
     invalidateCache(slug?: string): void;
-    list(paginationParams: PaginationDTO): Promise<{
+    /** `undefined` = cache miss/expired. `null` = cached absence. */
+    private readCache;
+    private writeCache;
+    private handleInvalidationMessage;
+    private ensureVersionState;
+    /** BIGINT comes back from `$queryRawUnsafe` as a `bigint`, not a number. */
+    private parseVersionValue;
+    private getCacheVersionFromDatabase;
+    private syncCacheVersionFromDatabase;
+    private bumpCacheVersion;
+    /**
+     * Catches up with writes from other pods when Redis is unavailable. Throttled
+     * and coalesced, so a burst of prompt resolutions costs one query at most.
+     */
+    private ensureCacheVersionFresh;
+    private runVersionCheck;
+    private logVersionCheckError;
+    /**
+     * Tells the other pods to drop these slugs. Bumps the database version first
+     * so pods without Redis still catch up on their next version check.
+     */
+    private publishInvalidation;
+    list(paginationParams: PaginationDTO, filters?: AiInstructionListFilters): Promise<{
         data: AiInstructionRecord[];
         total: number;
         page: number;
         pageSize: number;
         totalPages: number;
     }>;
+    /** Distinct module slugs, for the module filter in the admin. */
+    listModules(): Promise<string[]>;
+    /**
+     * The prompts declared in code, paired with what the database currently holds.
+     *
+     * `dbMatchesFallback` is what lets the admin show "default" vs "customized"
+     * and offer "restore default"; it is also the fidelity check after a seed —
+     * every freshly seeded prompt must report `true`.
+     */
+    listRegistry(moduleSlug?: string): Promise<{
+        slug: string;
+        name: string;
+        module_slug: string;
+        locale: string;
+        fallback: string;
+        variables: Record<string, import("./ai-prompt-template.util").VariableSpec>;
+        security_sensitive: boolean;
+        required_phrases: string[];
+        defaults: {
+            model?: string;
+            temperature?: number;
+            maxTokens?: number;
+        };
+        exists_in_db: boolean;
+        db_matches_fallback: boolean;
+    }[]>;
+    /** Renders a draft without saving it, so the admin can check interpolation. */
+    previewPrompt(input: PreviewAiInstructionDTO): {
+        rendered: string;
+        render_error: string;
+        char_count: number;
+        estimated_tokens: number;
+        missing_required: string[];
+        unknown_placeholders: string[];
+        unbalanced_blocks: string[];
+        warnings: string[];
+    };
     getById(id: number): Promise<AiInstructionRecord>;
-    getBySlug(slug: string): Promise<AiInstructionRecord>;
+    /**
+     * Inactive records are returned on purpose: the admin needs to open one to
+     * reactivate it. Pass `activeOnly` for the resolution path.
+     */
+    getBySlug(slug: string, activeOnly?: boolean): Promise<AiInstructionRecord>;
     create(dto: CreateAiInstructionDTO, createdById?: number): Promise<AiInstructionRecord>;
-    update(id: number, dto: UpdateAiInstructionDTO, updatedById?: number): Promise<AiInstructionRecord>;
+    update(id: number, dto: UpdateAiInstructionDTO, updatedById?: number): Promise<{
+        warnings: string[];
+        id: number;
+        slug: string;
+        layer: AiInstructionLayer;
+        name: string;
+        content: string;
+        variables_schema: Record<string, any> | null;
+        locale: string;
+        module_slug: string | null;
+        is_active: boolean;
+        version: number;
+        model: string | null;
+        temperature: number | null;
+        max_tokens: number | null;
+        is_locked: boolean;
+        created_at: Date;
+        updated_at: Date;
+    }>;
     delete({ ids }: DeleteDTO): Promise<{
         count: number;
     }>;
     listVersions(id: number): Promise<unknown>;
     restoreVersion(id: number, version: number, restoredById?: number): Promise<AiInstructionRecord>;
+    /**
+     * Rejects content that would break at render time, and returns non-fatal
+     * warnings for the caller to surface.
+     *
+     * An unclosed block is a hard 422: it silently swallows the rest of the
+     * prompt. A removed required variable is also a 422, overridable with
+     * `allow_missing_variables` — sometimes a rewrite genuinely no longer needs a
+     * variable. An unknown placeholder is only a warning: it renders literally,
+     * which is ugly but harmless.
+     */
+    private validateContent;
+    /**
+     * Guard phrases are the runtime protection for security-sensitive prompts: if
+     * the stored content contains none of them, `AiPromptResolverService` discards
+     * it. Warn loudly here so the editor learns it before the first graded essay.
+     */
+    private missingPhraseWarnings;
     private findById;
+    private findBySlug;
     private findActiveBySlug;
     private findActiveByLayer;
     private saveVersion;

package/dist/ai-instruction/ai-instruction.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-instruction.service.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAU,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAML,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAWtC,qBACa,oBAAqB,YAAW,YAAY;IAMrD,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;gBAIpC,MAAM,EAAE,aAAa;IAGlC,YAAY;IAYZ,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzE,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc7D,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM;IAoBvB,IAAI,CAAC,gBAAgB,EAAE,aAAa;;;;;;;IAmCpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAMrD,MAAM,CAAC,GAAG,EAAE,sBAAsB,EAAE,WAAW,CAAC,EAAE,MAAM;IA6BxD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,sBAAsB,EAAE,WAAW,CAAC,EAAE,MAAM;IAgCpE,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,SAAS;;;IAmBzB,YAAY,CAAC,EAAE,EAAE,MAAM;IAYvB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;YAoCzD,QAAQ;YASR,gBAAgB;YAShB,iBAAiB;YA6BjB,WAAW;CAiB1B"}
+{"version":3,"file":"ai-instruction.service.d.ts","sourceRoot":"","sources":["../../src/ai-instruction/ai-instruction.service.ts"],"names":[],"mappings":"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"}