@loonylabs/llm-middleware 2.0.0

package/dist/examples/tweet-generator/tweet-generator.usecase.d.ts

@@ -0,0 +1,92 @@
+import { BaseAIUseCase } from '../../middleware/usecases/base/base-ai.usecase';
+import { BaseAIRequest, BaseAIResult } from '../../middleware/shared/types/base-request.types';
+import { ModelParameterOverrides } from '../../middleware/services/model-parameter-manager/model-parameter-manager.service';
+/**
+ * Tweet generation request interface
+ */
+export interface TweetGeneratorRequest extends BaseAIRequest<string> {
+    topic: string;
+    includeHashtags?: boolean;
+}
+/**
+ * Tweet generation result interface
+ */
+export interface TweetGeneratorResult extends BaseAIResult {
+    tweet: string;
+    characterCount: number;
+    withinLimit: boolean;
+}
+/**
+ * Tweet Generator Use Case
+ *
+ * Demonstrates parameter configuration for token limiting and concise output.
+ *
+ * Key Features:
+ * - Token limiting via `num_predict` parameter (max ~70 tokens for 280 chars)
+ * - Marketing preset for engaging, varied content
+ * - Lower temperature for focused, on-brand output
+ * - Character count validation
+ *
+ * This use case is particularly useful for:
+ * - Social media content generation
+ * - Testing parameter effectiveness
+ * - Demonstrating output length control
+ * - Validating token limiting functionality
+ */
+export declare class TweetGeneratorUseCase extends BaseAIUseCase<string, TweetGeneratorRequest, TweetGeneratorResult> {
+    /**
+     * System message emphasizing brevity and Twitter best practices
+     */
+    protected readonly systemMessage = "You are an expert social media content creator specializing in Twitter/X posts.\n\nCRITICAL REQUIREMENTS:\n1. Be concise, engaging, and impactful\n2. Use clear, accessible language\n3. Avoid hashtags unless specifically requested\n4. NO explanations, NO preamble - ONLY output the tweet text\n\nSTYLE GUIDELINES:\n- Start with a hook or attention-grabbing statement\n- Use active voice and present tense when possible\n- Include a call-to-action or thought-provoking question when appropriate\n- Break complex ideas into simple, digestible statements\n\nOUTPUT FORMAT:\nReturn ONLY the tweet text. Nothing else.";
+    /**
+     * Get the user template from message file
+     */
+    protected getUserTemplate(): (formattedPrompt: string) => string;
+    /**
+     * Format the user message - pass through the topic
+     */
+    protected formatUserMessage(prompt: any): string;
+    /**
+     * Override model parameters for tweet generation
+     *
+     * This configuration is optimized for generating short, engaging tweets
+     * while staying within Twitter's 280 character limit.
+     *
+     * @returns ModelParameterOverrides with Marketing-inspired preset + token limiting
+     *
+     * **Parameter Selection Rationale:**
+     *
+     * **Token Limiting:**
+     * - `num_predict: 70` - Strictly limits output to ~70 tokens (roughly 280 characters)
+     *   This is the key parameter for enforcing length constraints.
+     *
+     * **Creative Control:**
+     * - `temperature: 0.7` - Balanced creativity for engaging but focused content
+     * - `repeatPenalty: 1.3` - Strong penalty to avoid repetitive phrasing in short text
+     * - `frequencyPenalty: 0.3` - Encourages word variety in limited space
+     * - `presencePenalty: 0.2` - Promotes diverse concepts even in brief content
+     *
+     * **Quality Control:**
+     * - `topP: 0.9` - Moderate nucleus sampling for reliable quality
+     * - `topK: 50` - Balanced vocabulary selection for natural language
+     * - `repeatLastN: 32` - Short window appropriate for tweet-length text
+     *
+     * **Expected Impact:**
+     * - Tweets will be under 280 characters (enforced by num_predict)
+     * - Content will be varied and engaging without repetition
+     * - Output will be focused and on-topic
+     * - Language will be natural and conversational
+     *
+     * **Testing Note:**
+     * This configuration allows testing of token limiting functionality.
+     * Increase num_predict to see longer outputs; decrease for shorter ones.
+     *
+     * For more information about parameters, see docs/OLLAMA_PARAMETERS.md
+     */
+    protected getParameterOverrides(): ModelParameterOverrides;
+    /**
+     * Create the result with character count validation
+     */
+    protected createResult(content: string, usedPrompt: string, thinking?: string): TweetGeneratorResult;
+}
+//# sourceMappingURL=tweet-generator.usecase.d.ts.map

package/dist/examples/tweet-generator/tweet-generator.usecase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-generator.usecase.d.ts","sourceRoot":"","sources":["../../../src/examples/tweet-generator/tweet-generator.usecase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kDAAkD,CAAC;AAK/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,mFAAmF,CAAC;AAE5H;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,aAAa,CAAC,MAAM,CAAC;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAsB,SAAQ,aAAa,CAAC,MAAM,EAAE,qBAAqB,EAAE,oBAAoB,CAAC;IAE3G;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,ymBAAkC;IAElE;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,CAAC,eAAe,EAAE,MAAM,KAAK,MAAM;IAIhE;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAIhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACH,SAAS,CAAC,qBAAqB,IAAI,uBAAuB;IAkB1D;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB;CAgBrG"}

package/dist/examples/tweet-generator/tweet-generator.usecase.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TweetGeneratorUseCase = void 0;
+const base_ai_usecase_1 = require("../../middleware/usecases/base/base-ai.usecase");
+const tweet_generator_messages_1 = require("./tweet-generator.messages");
+/**
+ * Tweet Generator Use Case
+ *
+ * Demonstrates parameter configuration for token limiting and concise output.
+ *
+ * Key Features:
+ * - Token limiting via `num_predict` parameter (max ~70 tokens for 280 chars)
+ * - Marketing preset for engaging, varied content
+ * - Lower temperature for focused, on-brand output
+ * - Character count validation
+ *
+ * This use case is particularly useful for:
+ * - Social media content generation
+ * - Testing parameter effectiveness
+ * - Demonstrating output length control
+ * - Validating token limiting functionality
+ */
+class TweetGeneratorUseCase extends base_ai_usecase_1.BaseAIUseCase {
+    constructor() {
+        super(...arguments);
+        /**
+         * System message emphasizing brevity and Twitter best practices
+         */
+        this.systemMessage = tweet_generator_messages_1.TWEET_GENERATOR_SYSTEM_MESSAGE;
+    }
+    /**
+     * Get the user template from message file
+     */
+    getUserTemplate() {
+        return tweet_generator_messages_1.TWEET_GENERATOR_USER_TEMPLATE;
+    }
+    /**
+     * Format the user message - pass through the topic
+     */
+    formatUserMessage(prompt) {
+        return typeof prompt === 'string' ? prompt : prompt.topic;
+    }
+    /**
+     * Override model parameters for tweet generation
+     *
+     * This configuration is optimized for generating short, engaging tweets
+     * while staying within Twitter's 280 character limit.
+     *
+     * @returns ModelParameterOverrides with Marketing-inspired preset + token limiting
+     *
+     * **Parameter Selection Rationale:**
+     *
+     * **Token Limiting:**
+     * - `num_predict: 70` - Strictly limits output to ~70 tokens (roughly 280 characters)
+     *   This is the key parameter for enforcing length constraints.
+     *
+     * **Creative Control:**
+     * - `temperature: 0.7` - Balanced creativity for engaging but focused content
+     * - `repeatPenalty: 1.3` - Strong penalty to avoid repetitive phrasing in short text
+     * - `frequencyPenalty: 0.3` - Encourages word variety in limited space
+     * - `presencePenalty: 0.2` - Promotes diverse concepts even in brief content
+     *
+     * **Quality Control:**
+     * - `topP: 0.9` - Moderate nucleus sampling for reliable quality
+     * - `topK: 50` - Balanced vocabulary selection for natural language
+     * - `repeatLastN: 32` - Short window appropriate for tweet-length text
+     *
+     * **Expected Impact:**
+     * - Tweets will be under 280 characters (enforced by num_predict)
+     * - Content will be varied and engaging without repetition
+     * - Output will be focused and on-topic
+     * - Language will be natural and conversational
+     *
+     * **Testing Note:**
+     * This configuration allows testing of token limiting functionality.
+     * Increase num_predict to see longer outputs; decrease for shorter ones.
+     *
+     * For more information about parameters, see docs/OLLAMA_PARAMETERS.md
+     */
+    getParameterOverrides() {
+        return {
+            // TOKEN LIMITING - This is the key parameter we're testing
+            // Approximately 70 tokens ≈ 280 characters for English text
+            // Adjust this value to control output length
+            num_predict: 70,
+            // Marketing-inspired preset for engaging social media content
+            temperatureOverride: 0.7,
+            repeatPenalty: 1.3,
+            frequencyPenalty: 0.3,
+            presencePenalty: 0.2,
+            topP: 0.9,
+            topK: 50,
+            repeatLastN: 32
+        };
+    }
+    /**
+     * Create the result with character count validation
+     */
+    createResult(content, usedPrompt, thinking) {
+        // Clean the content - remove any thinking tags or extra whitespace
+        const cleanedTweet = content.trim();
+        const characterCount = cleanedTweet.length;
+        const withinLimit = characterCount <= 280;
+        return {
+            generatedContent: content,
+            model: this.modelConfig.name,
+            usedPrompt: usedPrompt,
+            thinking: thinking,
+            tweet: cleanedTweet,
+            characterCount: characterCount,
+            withinLimit: withinLimit
+        };
+    }
+}
+exports.TweetGeneratorUseCase = TweetGeneratorUseCase;
+//# sourceMappingURL=tweet-generator.usecase.js.map

package/dist/examples/tweet-generator/tweet-generator.usecase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-generator.usecase.js","sourceRoot":"","sources":["../../../src/examples/tweet-generator/tweet-generator.usecase.ts"],"names":[],"mappings":";;;AAAA,oFAA+E;AAE/E,yEAGoC;AAoBpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,qBAAsB,SAAQ,+BAAkE;IAA7G;;QAEE;;WAEG;QACgB,kBAAa,GAAG,yDAA8B,CAAC;IA0FpE,CAAC;IAxFC;;OAEG;IACO,eAAe;QACvB,OAAO,wDAA6B,CAAC;IACvC,CAAC;IAED;;OAEG;IACO,iBAAiB,CAAC,MAAW;QACrC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAC5D,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG;IACO,qBAAqB;QAC7B,OAAO;YACL,2DAA2D;YAC3D,4DAA4D;YAC5D,6CAA6C;YAC7C,WAAW,EAAE,EAAE;YAEf,8DAA8D;YAC9D,mBAAmB,EAAE,GAAG;YACxB,aAAa,EAAE,GAAG;YAClB,gBAAgB,EAAE,GAAG;YACrB,eAAe,EAAE,GAAG;YACpB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,EAAE;YACR,WAAW,EAAE,EAAE;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,YAAY,CAAC,OAAe,EAAE,UAAkB,EAAE,QAAiB;QAC3E,mEAAmE;QACnE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC;QAC3C,MAAM,WAAW,GAAG,cAAc,IAAI,GAAG,CAAC;QAE1C,OAAO;YACL,gBAAgB,EAAE,OAAO;YACzB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC5B,UAAU,EAAE,UAAU;YACtB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,YAAY;YACnB,cAAc,EAAE,cAAc;YAC9B,WAAW,EAAE,WAAW;SACzB,CAAC;IACJ,CAAC;CACF;AA/FD,sDA+FC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './middleware';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Main export file for the llm-middleware package
+__exportStar(require("./middleware"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,+CAA6B"}

package/dist/middleware/controllers/base/base.controller.d.ts

@@ -0,0 +1,16 @@
+import { Response } from 'express';
+import { RequestWithUser } from '../../shared/types/base-request.types';
+/**
+ * Base controller class providing common functionality for all controllers
+ * Includes error handling and standardized response formatting
+ */
+export declare abstract class BaseController {
+    /**
+     * Generic request handler with error handling and logging
+     * @param req - Express request with user and client info
+     * @param res - Express response
+     * @param handler - Function to execute the actual logic
+     */
+    protected handleRequest(req: RequestWithUser, res: Response, handler: () => Promise<any>): Promise<void>;
+}
+//# sourceMappingURL=base.controller.d.ts.map

package/dist/middleware/controllers/base/base.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.controller.d.ts","sourceRoot":"","sources":["../../../../src/middleware/controllers/base/base.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAIxE;;;GAGG;AACH,8BAAsB,cAAc;IAClC;;;;;OAKG;cACa,aAAa,CAC3B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAC1B,OAAO,CAAC,IAAI,CAAC;CAwBjB"}

package/dist/middleware/controllers/base/base.controller.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+const logging_utils_1 = require("../../shared/utils/logging.utils");
+const http_utils_1 = require("../../shared/utils/http.utils");
+/**
+ * Base controller class providing common functionality for all controllers
+ * Includes error handling and standardized response formatting
+ */
+class BaseController {
+    /**
+     * Generic request handler with error handling and logging
+     * @param req - Express request with user and client info
+     * @param res - Express response
+     * @param handler - Function to execute the actual logic
+     */
+    async handleRequest(req, res, handler) {
+        try {
+            const result = await handler();
+            (0, http_utils_1.sendSuccessResponse)(res, result, req.clientInfo);
+        }
+        catch (error) {
+            logging_utils_1.logger.error('Controller error', {
+                context: this.constructor.name,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                metadata: {
+                    path: req.path,
+                    method: req.method,
+                    query: req.query,
+                    params: req.params
+                }
+            });
+            (0, http_utils_1.sendErrorResponse)(res, 500, error instanceof Error ? error.message : 'Unknown error', req.clientInfo);
+        }
+    }
+}
+exports.BaseController = BaseController;
+//# sourceMappingURL=base.controller.js.map

package/dist/middleware/controllers/base/base.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.controller.js","sourceRoot":"","sources":["../../../../src/middleware/controllers/base/base.controller.ts"],"names":[],"mappings":";;;AAEA,oEAA0D;AAC1D,8DAAuF;AAEvF;;;GAGG;AACH,MAAsB,cAAc;IAClC;;;;;OAKG;IACO,KAAK,CAAC,aAAa,CAC3B,GAAoB,EACpB,GAAa,EACb,OAA2B;QAE3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;YAC/B,IAAA,gCAAmB,EAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sBAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE;gBAC/B,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC9B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;gBAC/D,QAAQ,EAAE;oBACR,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,MAAM,EAAE,GAAG,CAAC,MAAM;oBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;oBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;iBACnB;aACF,CAAC,CAAC;YAEH,IAAA,8BAAiB,EACf,GAAG,EACH,GAAG,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EACxD,GAAG,CAAC,UAAU,CACf,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAnCD,wCAmCC"}

package/dist/middleware/controllers/base/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base.controller';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/controllers/base/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/controllers/base/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC"}

package/dist/middleware/controllers/base/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Export base controller
+__exportStar(require("./base.controller"), exports);
+//# sourceMappingURL=index.js.map

package/dist/middleware/controllers/base/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/controllers/base/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yBAAyB;AACzB,oDAAkC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,7 @@
+export * from './controllers/base';
+export * from './usecases/base';
+export * from './services';
+export * from './shared/config';
+export * from './shared/types';
+export * from './shared/utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAG3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/middleware/index.js

@@ -0,0 +1,27 @@
+"use strict";
+// Export all middleware components
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Base classes
+__exportStar(require("./controllers/base"), exports);
+__exportStar(require("./usecases/base"), exports);
+// Services
+__exportStar(require("./services"), exports); // Exports all services including ResponseProcessorService
+// Shared utilities and types
+__exportStar(require("./shared/config"), exports);
+__exportStar(require("./shared/types"), exports);
+__exportStar(require("./shared/utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":";AAAA,mCAAmC;;;;;;;;;;;;;;;;AAEnC,eAAe;AACf,qDAAmC;AACnC,kDAAgC;AAEhC,WAAW;AACX,6CAA2B,CAAC,0DAA0D;AAEtF,6BAA6B;AAC7B,kDAAgC;AAChC,iDAA+B;AAC/B,iDAA+B"}

package/dist/middleware/services/data-flow-logger/data-flow-logger.service.d.ts

@@ -0,0 +1,127 @@
+export interface LLMRequest {
+    stage: string;
+    prompt: string;
+    systemMessage: string;
+    modelName: string;
+    temperature?: number;
+    maxTokens?: number;
+    contextInfo?: any;
+}
+export interface LLMResponse {
+    rawResponse: string;
+    cleanedResponse?: string;
+    processingTime: number;
+    tokensUsed?: number;
+    error?: any;
+}
+export interface DataFlowEntry {
+    timestamp: string;
+    requestId: string;
+    stage: string;
+    operation: 'request' | 'response' | 'error' | 'context-prep' | 'json-cleaning';
+    contextId: string;
+    contextType: string;
+    data: any;
+}
+/**
+ * Enhanced service for logging data flow in AI processing pipelines
+ * Features:
+ * - Ring buffer (max 1000 entries per file)
+ * - Full prompt/response storage
+ * - Request flow tracking
+ * - Stage flow summaries
+ * - Pluggable context identifier generation (generic by default)
+ */
+export declare class DataFlowLoggerService {
+    private static instance;
+    private readonly logDir;
+    private currentRequestId;
+    private readonly MAX_ENTRIES_PER_FILE;
+    private contextIdentifierGenerator?;
+    private constructor();
+    static getInstance(): DataFlowLoggerService;
+    /**
+     * Configure a custom context identifier generator
+     * @param generator Function that extracts a context identifier from the context object
+     * @example
+     * // For book-based applications:
+     * logger.setContextIdentifierGenerator(ctx => `C${ctx.chapter}P${ctx.page}`);
+     * // For session-based applications:
+     * logger.setContextIdentifierGenerator(ctx => ctx.sessionId || 'general');
+     */
+    setContextIdentifierGenerator(generator: (context: any) => string): void;
+    private ensureLogDirectoryExists;
+    /**
+     * Generate a unique request ID
+     */
+    private generateRequestId;
+    /**
+     * Get context identifier for logging
+     * Uses custom generator if configured, otherwise falls back to generic identifiers
+     */
+    private getContextIdentifier;
+    /**
+     * Start a new request and return request ID
+     */
+    startRequest(stage: string, context?: any): string;
+    /**
+     * Log LLM request with full prompt/system message storage
+     */
+    logLLMRequest(request: LLMRequest, context?: any, requestId?: string): void;
+    /**
+     * Log LLM response with full response storage
+     */
+    logLLMResponse(stage: string, response: LLMResponse, context?: any, requestId?: string): void;
+    /**
+     * Log context preparation
+     */
+    logContextPreparation(stage: string, context: any, contextPreparationDetails: any): void;
+    /**
+     * Log JSON cleaning operation
+     */
+    logJsonCleaning(stage: string, context: any, cleaningDetails: {
+        input: string;
+        output?: string;
+        method: string;
+        success: boolean;
+        iterations?: number;
+        error?: any;
+    }): void;
+    /**
+     * Log complete flow for a stage
+     */
+    logStageFlow(stage: string, context: any, flowSummary: {
+        totalDuration: number;
+        contextPrepDuration?: number;
+        llmRequestDuration?: number;
+        jsonCleaningDuration?: number;
+        success: boolean;
+        outputSize?: number;
+        error?: any;
+    }): void;
+    /**
+     * Extract context features for detailed logging
+     */
+    private extractContextFeatures;
+    /**
+     * Get log file path for a context
+     */
+    private getLogFilePath;
+    /**
+     * Log entry with ring buffer (max 1000 entries per file)
+     */
+    private logEntry;
+    /**
+     * Get flow entries for a specific request
+     */
+    getRequestFlow(context: any, requestId: string): DataFlowEntry[];
+    /**
+     * Get current request ID
+     */
+    getCurrentRequestId(): string | null;
+    /**
+     * Clear current request ID
+     */
+    clearCurrentRequestId(): void;
+}
+//# sourceMappingURL=data-flow-logger.service.d.ts.map

package/dist/middleware/services/data-flow-logger/data-flow-logger.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-flow-logger.service.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/data-flow-logger/data-flow-logger.service.ts"],"names":[],"mappings":"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"}