@loonylabs/llm-middleware 2.0.0

package/dist/middleware/services/model-parameter-manager/model-parameter-manager.service.js

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelParameterManagerService = void 0;
+/**
+ * Service for managing and validating model parameters for AI requests
+ * Handles parameter combination, validation, and conversion to API formats
+ */
+class ModelParameterManagerService {
+    /**
+     * Get the effective model parameters, combining config defaults and use case overrides
+     * @param modelConfig The model configuration from models.config
+     * @param overrides Optional overrides from the use case
+     * @returns Final model parameters to use
+     */
+    static getEffectiveParameters(modelConfig, overrides = {}) {
+        return {
+            temperature: overrides.temperatureOverride ?? modelConfig.temperature ?? this.DEFAULT_TEMPERATURE,
+            repeatPenalty: overrides.repeatPenalty,
+            topP: overrides.topP,
+            topK: overrides.topK,
+            frequencyPenalty: overrides.frequencyPenalty,
+            presencePenalty: overrides.presencePenalty,
+            repeatLastN: overrides.repeatLastN,
+            numPredict: overrides.num_predict,
+            numCtx: overrides.num_ctx,
+            numBatch: overrides.num_batch
+        };
+    }
+    /**
+     * Validate parameter values are within acceptable ranges
+     * @param parameters The parameters to validate
+     * @returns Validated parameters with any out-of-range values corrected
+     */
+    static validateParameters(parameters) {
+        const validated = { ...parameters };
+        // Temperature should be between 0 and 2
+        if (validated.temperature < 0)
+            validated.temperature = 0;
+        if (validated.temperature > 2)
+            validated.temperature = 2;
+        // Repeat penalty should be > 0
+        if (validated.repeatPenalty !== undefined) {
+            if (validated.repeatPenalty <= 0)
+                validated.repeatPenalty = 1.0;
+        }
+        // Top-p should be between 0 and 1
+        if (validated.topP !== undefined) {
+            if (validated.topP < 0)
+                validated.topP = 0;
+            if (validated.topP > 1)
+                validated.topP = 1;
+        }
+        // Top-k should be positive integer
+        if (validated.topK !== undefined) {
+            if (validated.topK < 1)
+                validated.topK = 1;
+            validated.topK = Math.round(validated.topK);
+        }
+        // Frequency penalty should be between 0 and 2
+        if (validated.frequencyPenalty !== undefined) {
+            if (validated.frequencyPenalty < 0)
+                validated.frequencyPenalty = 0;
+            if (validated.frequencyPenalty > 2)
+                validated.frequencyPenalty = 2;
+        }
+        // Presence penalty should be between 0 and 2
+        if (validated.presencePenalty !== undefined) {
+            if (validated.presencePenalty < 0)
+                validated.presencePenalty = 0;
+            if (validated.presencePenalty > 2)
+                validated.presencePenalty = 2;
+        }
+        // repeatLastN should be a positive number or -1 for num_ctx
+        if (validated.repeatLastN !== undefined) {
+            if (validated.repeatLastN < -1)
+                validated.repeatLastN = 64; // Default fallback
+            // If not -1 (for num_ctx), round to whole number
+            if (validated.repeatLastN !== -1) {
+                validated.repeatLastN = Math.round(validated.repeatLastN);
+            }
+        }
+        // numPredict should be a positive integer (max tokens to generate)
+        if (validated.numPredict !== undefined) {
+            if (validated.numPredict < 1)
+                validated.numPredict = 1;
+            validated.numPredict = Math.round(validated.numPredict);
+        }
+        // numCtx should be a positive integer (context window size)
+        if (validated.numCtx !== undefined) {
+            if (validated.numCtx < 128)
+                validated.numCtx = 128; // Minimum context
+            validated.numCtx = Math.round(validated.numCtx);
+        }
+        // numBatch should be a positive integer (batch size)
+        if (validated.numBatch !== undefined) {
+            if (validated.numBatch < 1)
+                validated.numBatch = 1;
+            validated.numBatch = Math.round(validated.numBatch);
+        }
+        return validated;
+    }
+    /**
+     * Create parameter subset for logging (only non-undefined values)
+     * @param parameters The parameters to filter
+     * @returns Object with only defined parameters
+     */
+    static getDefinedParameters(parameters) {
+        const result = {
+            temperature: parameters.temperature
+        };
+        if (parameters.repeatPenalty !== undefined) {
+            result.repeatPenalty = parameters.repeatPenalty;
+        }
+        if (parameters.topP !== undefined) {
+            result.topP = parameters.topP;
+        }
+        if (parameters.topK !== undefined) {
+            result.topK = parameters.topK;
+        }
+        if (parameters.frequencyPenalty !== undefined) {
+            result.frequencyPenalty = parameters.frequencyPenalty;
+        }
+        if (parameters.presencePenalty !== undefined) {
+            result.presencePenalty = parameters.presencePenalty;
+        }
+        if (parameters.repeatLastN !== undefined) {
+            result.repeatLastN = parameters.repeatLastN;
+        }
+        if (parameters.numPredict !== undefined) {
+            result.numPredict = parameters.numPredict;
+        }
+        if (parameters.numCtx !== undefined) {
+            result.numCtx = parameters.numCtx;
+        }
+        if (parameters.numBatch !== undefined) {
+            result.numBatch = parameters.numBatch;
+        }
+        return result;
+    }
+    /**
+     * Create parameter object for Ollama API request
+     * @param parameters The validated parameters
+     * @returns Object suitable for the Ollama API options field
+     */
+    static toOllamaOptions(parameters) {
+        const options = {};
+        // Add temperature (always included)
+        options.temperature = parameters.temperature;
+        // Add optional parameters with correct Ollama API names
+        if (parameters.repeatPenalty !== undefined) {
+            options.repeat_penalty = parameters.repeatPenalty;
+        }
+        if (parameters.topP !== undefined) {
+            options.top_p = parameters.topP;
+        }
+        if (parameters.topK !== undefined) {
+            options.top_k = parameters.topK;
+        }
+        if (parameters.frequencyPenalty !== undefined) {
+            options.frequency_penalty = parameters.frequencyPenalty;
+        }
+        if (parameters.presencePenalty !== undefined) {
+            options.presence_penalty = parameters.presencePenalty;
+        }
+        if (parameters.repeatLastN !== undefined) {
+            options.repeat_last_n = parameters.repeatLastN;
+        }
+        if (parameters.numPredict !== undefined) {
+            options.num_predict = parameters.numPredict;
+        }
+        if (parameters.numCtx !== undefined) {
+            options.num_ctx = parameters.numCtx;
+        }
+        if (parameters.numBatch !== undefined) {
+            options.num_batch = parameters.numBatch;
+        }
+        return options;
+    }
+    /**
+     * Create default parameters for a given model type or use case
+     *
+     * Available presets:
+     * - 'creative' / 'creative_writing': Optimized for novels, stories, narrative fiction
+     * - 'factual': Optimized for reports, documentation, journalism
+     * - 'poetic': Optimized for poetry, lyrics, artistic expression
+     * - 'dialogue': Optimized for character dialogue, conversational content
+     * - 'technical': Optimized for code documentation, technical guides
+     * - 'marketing': Optimized for advertisements, promotional content
+     * - 'analytical': General analytical tasks (legacy)
+     * - 'balanced': General balanced approach (default)
+     *
+     * @param modelType The type of model or use case
+     * @returns Default parameters for the model type
+     *
+     * For detailed documentation about each preset, see docs/OLLAMA_PARAMETERS.md
+     */
+    static getDefaultParametersForType(modelType) {
+        switch (modelType.toLowerCase()) {
+            // Creative Writing preset - for novels, stories, narrative fiction
+            case 'creative':
+            case 'creative_writing':
+                return {
+                    temperature: 0.8,
+                    repeatPenalty: 1.3,
+                    frequencyPenalty: 0.2,
+                    presencePenalty: 0.2,
+                    topP: 0.92,
+                    topK: 60,
+                    repeatLastN: 128
+                };
+            // Factual Content preset - for reports, documentation, journalism
+            case 'factual':
+                return {
+                    temperature: 0.4,
+                    repeatPenalty: 1.2,
+                    frequencyPenalty: 0.1,
+                    presencePenalty: 0.1,
+                    topP: 0.85,
+                    topK: 40,
+                    repeatLastN: 96
+                };
+            // Poetic Text preset - for poetry, lyrics, artistic expression
+            case 'poetic':
+            case 'poetry':
+                return {
+                    temperature: 1.0,
+                    repeatPenalty: 1.2,
+                    frequencyPenalty: 0.3,
+                    presencePenalty: 0.2,
+                    topP: 0.95,
+                    topK: 80,
+                    repeatLastN: 64
+                };
+            // Dialogue & Conversation preset - for character dialogue, chat
+            case 'dialogue':
+            case 'conversation':
+            case 'conversational':
+                return {
+                    temperature: 0.7,
+                    repeatPenalty: 1.1,
+                    frequencyPenalty: 0.3,
+                    presencePenalty: 0.0,
+                    topP: 0.9,
+                    topK: 50,
+                    repeatLastN: 32
+                };
+            // Technical Documentation preset - for code docs, API references
+            case 'technical':
+            case 'tech':
+            case 'documentation':
+                return {
+                    temperature: 0.3,
+                    repeatPenalty: 1.05,
+                    frequencyPenalty: 0.0,
+                    presencePenalty: 0.1,
+                    topP: 0.8,
+                    topK: 30,
+                    repeatLastN: 128
+                };
+            // Marketing Copy preset - for ads, sales copy, promotional content
+            case 'marketing':
+            case 'advertising':
+            case 'promotional':
+                return {
+                    temperature: 0.7,
+                    repeatPenalty: 1.3,
+                    frequencyPenalty: 0.4,
+                    presencePenalty: 0.3,
+                    topP: 0.9,
+                    topK: 60,
+                    repeatLastN: 96
+                };
+            // Legacy presets for backward compatibility
+            case 'analytical':
+                return {
+                    temperature: 0.3,
+                    topP: 0.8,
+                    repeatPenalty: 1.05
+                };
+            // Balanced preset (default)
+            case 'balanced':
+            default:
+                return {
+                    temperature: this.DEFAULT_TEMPERATURE,
+                    topP: 0.9,
+                    repeatPenalty: 1.1
+                };
+        }
+    }
+    /**
+     * Compare two parameter sets and return the differences
+     * @param params1 First parameter set
+     * @param params2 Second parameter set
+     * @returns Object showing differences
+     */
+    static compareParameters(params1, params2) {
+        const differences = {};
+        const allKeys = new Set([
+            ...Object.keys(params1),
+            ...Object.keys(params2)
+        ]);
+        for (const key of allKeys) {
+            if (params1[key] !== params2[key]) {
+                differences[key] = {
+                    from: params1[key],
+                    to: params2[key]
+                };
+            }
+        }
+        return differences;
+    }
+    /**
+     * Generate a summary string of the parameters for logging
+     * @param parameters The parameters to summarize
+     * @returns Human-readable parameter summary
+     */
+    static summarizeParameters(parameters) {
+        const defined = this.getDefinedParameters(parameters);
+        const parts = Object.entries(defined).map(([key, value]) => `${key}=${value}`);
+        return parts.join(', ');
+    }
+}
+exports.ModelParameterManagerService = ModelParameterManagerService;
+ModelParameterManagerService.DEFAULT_TEMPERATURE = 0.7;
+//# sourceMappingURL=model-parameter-manager.service.js.map

package/dist/middleware/services/model-parameter-manager/model-parameter-manager.service.js.map

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

package/dist/middleware/services/request-formatter/index.d.ts

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

package/dist/middleware/services/request-formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/request-formatter/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/middleware/services/request-formatter/index.js

@@ -0,0 +1,18 @@
+"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 });
+__exportStar(require("./request-formatter.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/request-formatter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/services/request-formatter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C"}

package/dist/middleware/services/request-formatter/request-formatter.service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Generic RequestFormatterService for handling complex prompt objects.
+ * - Removes domain-specific dependencies (no book-specific fields)
+ * - Supports flexible extraction and formatting of nested request structures
+ */
+export declare class RequestFormatterService {
+    /**
+     * Format user message based on the prompt type and use case template.
+     * Handles strings directly and formats objects into structured sections.
+     */
+    static formatUserMessage(prompt: any, templateFunction: (formattedPrompt: string) => string, useCaseName: string): string;
+    /**
+     * Validate that a prompt is not empty
+     */
+    static isValidPrompt(prompt: any): boolean;
+    /**
+     * Extract context information from various prompt formats (generic)
+     */
+    static extractContext(prompt: any): any | null;
+    /**
+     * Extract user instruction from various prompt formats (generic)
+     */
+    static extractInstruction(prompt: any): string;
+    /**
+     * Backward-compat alias for extractInstruction()
+     */
+    static extractUserInstruction(prompt: any): string;
+    /**
+     * Create a structured prompt object from simple inputs
+     */
+    static createStructuredPrompt(instruction: string, context?: any): object;
+    /**
+     * Merge multiple prompt components into a single formatted prompt string
+     */
+    static mergePromptComponents(components: Array<string | object>): string;
+    /**
+     * Sanitize prompt content to remove potentially problematic characters
+     */
+    static sanitizePrompt(prompt: string): string;
+    /**
+     * Get statistics about a prompt
+     */
+    static getPromptStats(prompt: any): {
+        type: 'string' | 'object' | 'unknown';
+        charCount: number;
+        wordCount: number;
+        hasContext: boolean;
+        isValid: boolean;
+    };
+    /**
+     * Extract data from various prompt formats (context + instruction + raw)
+     */
+    private static extractPromptData;
+    /**
+     * Build formatted prompt string from extracted data using FlatFormatter for context
+     */
+    private static buildFormattedPrompt;
+    /**
+     * Format a context object using FlatFormatter
+     */
+    private static formatContext;
+    /**
+     * Format a raw prompt object that doesn't match expected structure
+     */
+    private static formatRawPrompt;
+    /**
+     * Extract text content from various object structures (used by stats/merge fallbacks)
+     */
+    private static extractTextFromObject;
+}
+//# sourceMappingURL=request-formatter.service.d.ts.map

package/dist/middleware/services/request-formatter/request-formatter.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-formatter.service.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/request-formatter/request-formatter.service.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC;;;OAGG;WACW,iBAAiB,CAC7B,MAAM,EAAE,GAAG,EACX,gBAAgB,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,MAAM,EACrD,WAAW,EAAE,MAAM,GAClB,MAAM;IAUT;;OAEG;WACW,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO;IAmBjD;;OAEG;WACW,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI;IAmBrD;;OAEG;WACW,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAoBrD;;OAEG;WACW,sBAAsB,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAIzD;;OAEG;WACW,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,MAAM;IAMhF;;OAEG;WACW,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM;IAe/E;;OAEG;WACW,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAQpD;;OAEG;WACW,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG;QACzC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QACtC,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,OAAO,EAAE,OAAO,CAAC;KAClB;IAeD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAoBhC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAsBnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAY5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAa9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAwBrC"}

package/dist/middleware/services/request-formatter/request-formatter.service.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestFormatterService = void 0;
+const flat_formatter_1 = require("../flat-formatter");
+/**
+ * Generic RequestFormatterService for handling complex prompt objects.
+ * - Removes domain-specific dependencies (no book-specific fields)
+ * - Supports flexible extraction and formatting of nested request structures
+ */
+class RequestFormatterService {
+    /**
+     * Format user message based on the prompt type and use case template.
+     * Handles strings directly and formats objects into structured sections.
+     */
+    static formatUserMessage(prompt, templateFunction, useCaseName) {
+        if (typeof prompt === 'string') {
+            return templateFunction(prompt);
+        }
+        const extracted = this.extractPromptData(prompt);
+        const formattedPrompt = this.buildFormattedPrompt(extracted, useCaseName);
+        return templateFunction(formattedPrompt);
+    }
+    /**
+     * Validate that a prompt is not empty
+     */
+    static isValidPrompt(prompt) {
+        if (!prompt)
+            return false;
+        if (typeof prompt === 'string') {
+            return prompt.trim().length > 0;
+        }
+        if (typeof prompt === 'object') {
+            return Object.keys(prompt).some(key => {
+                const value = prompt[key];
+                if (typeof value === 'string')
+                    return value.trim().length > 0;
+                if (typeof value === 'object' && value !== null)
+                    return Object.keys(value).length > 0;
+                return false;
+            });
+        }
+        return false;
+    }
+    /**
+     * Extract context information from various prompt formats (generic)
+     */
+    static extractContext(prompt) {
+        if (typeof prompt !== 'object' || prompt === null)
+            return null;
+        // Prefer explicit, generic context fields
+        const contextFields = ['context', 'sessionContext', 'metadata'];
+        for (const field of contextFields) {
+            if (prompt[field]) {
+                return prompt[field];
+            }
+        }
+        // Nested prompt structure
+        if (prompt.prompt && typeof prompt.prompt === 'object') {
+            return this.extractContext(prompt.prompt);
+        }
+        return null;
+    }
+    /**
+     * Extract user instruction from various prompt formats (generic)
+     */
+    static extractInstruction(prompt) {
+        if (typeof prompt === 'string')
+            return prompt;
+        if (typeof prompt !== 'object' || prompt === null)
+            return '';
+        // Nested prompt structure support
+        if (prompt.prompt?.instruction) {
+            return prompt.prompt.instruction;
+        }
+        // Common instruction field names
+        const candidates = ['instruction', 'userInstruction', 'task', 'message', 'text', 'content', 'query', 'input', 'description'];
+        for (const key of candidates) {
+            const v = prompt[key];
+            if (typeof v === 'string' && v.trim())
+                return v;
+        }
+        // Fallback to general text extraction
+        return this.extractTextFromObject(prompt, 'instruction');
+    }
+    /**
+     * Backward-compat alias for extractInstruction()
+     */
+    static extractUserInstruction(prompt) {
+        return this.extractInstruction(prompt);
+    }
+    /**
+     * Create a structured prompt object from simple inputs
+     */
+    static createStructuredPrompt(instruction, context) {
+        const prompt = { userInstruction: instruction };
+        if (context)
+            prompt.context = context;
+        return prompt;
+    }
+    /**
+     * Merge multiple prompt components into a single formatted prompt string
+     */
+    static mergePromptComponents(components) {
+        const textParts = [];
+        for (const component of components) {
+            if (typeof component === 'string' && component.trim()) {
+                textParts.push(component.trim());
+            }
+            else if (typeof component === 'object' && component !== null) {
+                const extracted = this.extractTextFromObject(component, 'merge');
+                if (extracted.trim())
+                    textParts.push(extracted.trim());
+            }
+        }
+        return textParts.join('\n\n');
+    }
+    /**
+     * Sanitize prompt content to remove potentially problematic characters
+     */
+    static sanitizePrompt(prompt) {
+        return prompt
+            .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '')
+            .replace(/\r\n/g, '\n')
+            .replace(/\r/g, '\n')
+            .trim();
+    }
+    /**
+     * Get statistics about a prompt
+     */
+    static getPromptStats(prompt) {
+        const type = typeof prompt === 'string' ? 'string' : typeof prompt === 'object' && prompt !== null ? 'object' : 'unknown';
+        const text = type === 'string' ? prompt : this.extractTextFromObject(prompt, 'stats');
+        const charCount = text.length;
+        const wordCount = text.trim() ? text.trim().split(/\s+/).length : 0;
+        const hasContext = type === 'object' && this.extractContext(prompt) !== null;
+        const isValid = this.isValidPrompt(prompt);
+        return { type, charCount, wordCount, hasContext, isValid };
+    }
+    // ===============
+    // Internal helpers
+    // ===============
+    /**
+     * Extract data from various prompt formats (context + instruction + raw)
+     */
+    static extractPromptData(prompt) {
+        if (prompt?.prompt && typeof prompt.prompt === 'object') {
+            return {
+                context: prompt.prompt.context ?? prompt.context,
+                instruction: prompt.prompt.instruction ?? prompt.instruction ?? prompt.userInstruction,
+                rawPrompt: prompt.prompt
+            };
+        }
+        return {
+            context: prompt?.context,
+            instruction: prompt?.instruction ?? prompt?.userInstruction,
+            rawPrompt: prompt
+        };
+    }
+    /**
+     * Build formatted prompt string from extracted data using FlatFormatter for context
+     */
+    static buildFormattedPrompt(extracted, useCaseName) {
+        const sections = [];
+        if (extracted.context && typeof extracted.context === 'object') {
+            const contextStr = this.formatContext(extracted.context);
+            if (contextStr)
+                sections.push(`## CONTEXT:\n${contextStr}`);
+        }
+        if (extracted.instruction && typeof extracted.instruction === 'string') {
+            sections.push(`## INSTRUCTION:\n${extracted.instruction}`);
+        }
+        if (sections.length === 0 && extracted.rawPrompt) {
+            return this.formatRawPrompt(extracted.rawPrompt);
+        }
+        return sections.join('\n\n');
+    }
+    /**
+     * Format a context object using FlatFormatter
+     */
+    static formatContext(context) {
+        if (typeof context !== 'object' || context === null) {
+            return String(context);
+        }
+        return flat_formatter_1.FlatFormatter.flatten(context, {
+            format: 'numbered',
+            ignoreEmptyValues: true,
+            keyValueSeparator: ': '
+        });
+    }
+    /**
+     * Format a raw prompt object that doesn't match expected structure
+     */
+    static formatRawPrompt(rawPrompt) {
+        if (typeof rawPrompt === 'string')
+            return rawPrompt;
+        if (typeof rawPrompt === 'object' && rawPrompt !== null) {
+            return flat_formatter_1.FlatFormatter.flatten(rawPrompt, {
+                format: 'numbered',
+                ignoreEmptyValues: true
+            });
+        }
+        return String(rawPrompt);
+    }
+    /**
+     * Extract text content from various object structures (used by stats/merge fallbacks)
+     */
+    static extractTextFromObject(obj, context) {
+        if (typeof obj === 'string')
+            return obj;
+        if (!obj || typeof obj !== 'object')
+            return '';
+        const textFields = [
+            'instruction', 'userInstruction', 'task', 'message', 'text', 'content', 'query', 'input', 'description'
+        ];
+        for (const field of textFields) {
+            if (obj[field] && typeof obj[field] === 'string') {
+                return obj[field];
+            }
+        }
+        if (obj.prompt && typeof obj.prompt === 'object') {
+            return this.extractTextFromObject(obj.prompt, context);
+        }
+        const stringValues = Object.values(obj)
+            .filter((value) => typeof value === 'string' && value.trim().length > 0)
+            .join(' ');
+        return stringValues || '';
+    }
+}
+exports.RequestFormatterService = RequestFormatterService;
+//# sourceMappingURL=request-formatter.service.js.map