@windagency/valora 2.0.1

package/dist/executor/input-pre-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input-pre-resolver.js","sourceRoot":"","sources":["../../src/executor/input-pre-resolver.ts"],"names":[],"mappings":"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"}

package/dist/executor/interactive-question-handler.service.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Interactive Question Handler Service
+ *
+ * Handles clarifying questions from LLM responses by prompting the user
+ * via console for answers before proceeding with file modifications.
+ *
+ * This service is used during pipeline execution when the "refine" stage
+ * produces clarifying questions that need user input.
+ */
+import { type PromptAdapter } from '../ui/prompt-adapter.interface.js';
+/**
+ * Structure of a clarifying question from the refine-requirements prompt
+ */
+export interface ClarifyingQuestion {
+    context?: string;
+    id: string;
+    options: string[];
+    priority: 'P0' | 'P1' | 'P2';
+    question: string;
+}
+/**
+ * User's answer to a clarifying question
+ */
+export interface QuestionAnswer {
+    customAnswer?: string;
+    question: string;
+    questionId: string;
+    selectedOption: string;
+}
+/**
+ * Result of processing all clarifying questions
+ */
+export interface InteractiveQuestionResult {
+    answeredCount: number;
+    answers: QuestionAnswer[];
+    skipped: boolean;
+    summary: string;
+}
+export declare class InteractiveQuestionHandlerService {
+    private readonly color;
+    private readonly console;
+    private readonly logger;
+    private readonly promptAdapter;
+    constructor(promptAdapter?: PromptAdapter);
+    /**
+     * Check if stage outputs contain clarifying questions that need user input
+     */
+    hasQuestions(stageOutputs: Record<string, unknown>): boolean;
+    /**
+     * Extract clarifying questions from stage outputs
+     */
+    extractQuestions(stageOutputs: Record<string, unknown>): ClarifyingQuestion[];
+    /**
+     * Validate that an object is a valid ClarifyingQuestion
+     */
+    private isValidQuestion;
+    /**
+     * Prompt user for answers to all clarifying questions
+     */
+    promptForAnswers(questions: ClarifyingQuestion[]): Promise<InteractiveQuestionResult>;
+    /**
+     * Display header before prompting questions
+     */
+    private displayQuestionsHeader;
+    /**
+     * Prompt user for a single question
+     */
+    private promptSingleQuestion;
+    /**
+     * Build a summary of all answers for display and storage
+     */
+    private buildAnswersSummary;
+    /**
+     * Format answers for passing to subsequent pipeline stages
+     */
+    formatAnswersForStage(answers: QuestionAnswer[]): Record<string, string>;
+}
+export declare function getInteractiveQuestionHandler(): InteractiveQuestionHandlerService;
+//# sourceMappingURL=interactive-question-handler.service.d.ts.map

package/dist/executor/interactive-question-handler.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-question-handler.service.d.ts","sourceRoot":"","sources":["../../src/executor/interactive-question-handler.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAoB,KAAK,aAAa,EAAqB,MAAM,6BAA6B,CAAC;AAEtG;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,iCAAiC;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAElC,aAAa,CAAC,EAAE,aAAa;IAIzC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAK5D;;OAEG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,kBAAkB,EAAE;IAkC7E;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC;IA+B3F;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;YACW,oBAAoB;IAyFlC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA8B3B;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CASxE;AAOD,wBAAgB,6BAA6B,IAAI,iCAAiC,CAGjF"}

package/dist/executor/interactive-question-handler.service.js

@@ -0,0 +1,250 @@
+/**
+ * Interactive Question Handler Service
+ *
+ * Handles clarifying questions from LLM responses by prompting the user
+ * via console for answers before proceeding with file modifications.
+ *
+ * This service is used during pipeline execution when the "refine" stage
+ * produces clarifying questions that need user input.
+ */
+import { getColorAdapter } from '../output/color-adapter.interface.js';
+import { getConsoleOutput } from '../output/console-output.js';
+import { getLogger } from '../output/logger.js';
+import { getPromptAdapter } from '../ui/prompt-adapter.interface.js';
+export class InteractiveQuestionHandlerService {
+    color = getColorAdapter();
+    console = getConsoleOutput();
+    logger = getLogger();
+    promptAdapter;
+    constructor(promptAdapter) {
+        this.promptAdapter = promptAdapter ?? getPromptAdapter();
+    }
+    /**
+     * Check if stage outputs contain clarifying questions that need user input
+     */
+    hasQuestions(stageOutputs) {
+        const questions = this.extractQuestions(stageOutputs);
+        return questions.length > 0;
+    }
+    /**
+     * Extract clarifying questions from stage outputs
+     */
+    extractQuestions(stageOutputs) {
+        const questions = [];
+        // Check for clarifying_questions in outputs
+        const rawQuestions = stageOutputs['clarifying_questions'];
+        if (Array.isArray(rawQuestions)) {
+            for (const q of rawQuestions) {
+                if (this.isValidQuestion(q)) {
+                    questions.push(q);
+                }
+            }
+        }
+        // Also check nested in result object (fallback)
+        const result = stageOutputs['result'];
+        if (typeof result === 'string') {
+            try {
+                const parsed = JSON.parse(result);
+                if (Array.isArray(parsed['clarifying_questions'])) {
+                    for (const q of parsed['clarifying_questions']) {
+                        if (this.isValidQuestion(q)) {
+                            questions.push(q);
+                        }
+                    }
+                }
+            }
+            catch {
+                // Not JSON, ignore
+            }
+        }
+        return questions;
+    }
+    /**
+     * Validate that an object is a valid ClarifyingQuestion
+     */
+    isValidQuestion(obj) {
+        if (typeof obj !== 'object' || obj === null) {
+            return false;
+        }
+        const q = obj;
+        return (typeof q['id'] === 'string' &&
+            typeof q['question'] === 'string' &&
+            Array.isArray(q['options']) &&
+            q['options'].length > 0);
+    }
+    /**
+     * Prompt user for answers to all clarifying questions
+     */
+    async promptForAnswers(questions) {
+        if (questions.length === 0) {
+            return {
+                answeredCount: 0,
+                answers: [],
+                skipped: true,
+                summary: 'No clarifying questions to answer.'
+            };
+        }
+        this.displayQuestionsHeader(questions);
+        const answers = [];
+        for (const question of questions) {
+            const answer = await this.promptSingleQuestion(question);
+            if (answer) {
+                answers.push(answer);
+            }
+        }
+        const summary = this.buildAnswersSummary(answers, questions);
+        return {
+            answeredCount: answers.length,
+            answers,
+            skipped: false,
+            summary
+        };
+    }
+    /**
+     * Display header before prompting questions
+     */
+    displayQuestionsHeader(questions) {
+        const p0Count = questions.filter((q) => q.priority === 'P0').length;
+        const p1Count = questions.filter((q) => q.priority === 'P1').length;
+        const p2Count = questions.filter((q) => q.priority === 'P2').length;
+        this.console.blank();
+        this.console.print(this.color.getRawFn('bold.cyan')('━━━ Clarification Needed ━━━'));
+        this.console.dim(`${questions.length} question(s) to answer before proceeding`);
+        this.console.blank();
+        if (p0Count > 0) {
+            this.console.print(this.color.red(`  ● ${p0Count} Critical (P0)`));
+        }
+        if (p1Count > 0) {
+            this.console.print(this.color.yellow(`  ● ${p1Count} Important (P1)`));
+        }
+        if (p2Count > 0) {
+            this.console.dim(`  ● ${p2Count} Minor (P2)`);
+        }
+        this.console.blank();
+    }
+    /**
+     * Prompt user for a single question
+     */
+    async promptSingleQuestion(question) {
+        const priorityColorFn = question.priority === 'P0'
+            ? this.color.red.bind(this.color)
+            : question.priority === 'P1'
+                ? this.color.yellow.bind(this.color)
+                : this.color.gray.bind(this.color);
+        this.console.print(priorityColorFn(`[${question.priority}] `) + this.color.bold(question.question));
+        if (question.context) {
+            this.console.dim(`  Context: ${question.context}`);
+        }
+        // Build choices from options
+        const choices = question.options.map((opt, index) => ({
+            name: opt,
+            short: `Option ${index + 1}`,
+            value: opt
+        }));
+        // Add "Other" option for custom input
+        choices.push({
+            name: 'Other (enter custom answer)',
+            short: 'Custom',
+            value: '__custom__'
+        });
+        // Add skip option
+        choices.push({
+            name: 'Skip this question',
+            short: 'Skip',
+            value: '__skip__'
+        });
+        try {
+            const result = await this.promptAdapter.prompt([
+                {
+                    choices,
+                    message: 'Select your answer:',
+                    name: 'answer',
+                    pageSize: 10,
+                    type: 'list'
+                }
+            ]);
+            if (result.answer === '__skip__') {
+                this.console.dim('  → Skipped');
+                this.console.blank();
+                return null;
+            }
+            if (result.answer === '__custom__') {
+                const customResult = await this.promptAdapter.prompt([
+                    {
+                        message: 'Enter your answer:',
+                        name: 'customAnswer',
+                        type: 'input'
+                    }
+                ]);
+                this.console.print(this.color.green(`  → ${customResult.customAnswer}`));
+                this.console.blank();
+                return {
+                    customAnswer: customResult.customAnswer,
+                    question: question.question,
+                    questionId: question.id,
+                    selectedOption: 'Custom'
+                };
+            }
+            this.console.print(this.color.green(`  → ${result.answer}`));
+            this.console.blank();
+            return {
+                question: question.question,
+                questionId: question.id,
+                selectedOption: result.answer
+            };
+        }
+        catch (error) {
+            this.logger.warn('Failed to get answer for question', {
+                error: error.message,
+                questionId: question.id
+            });
+            return null;
+        }
+    }
+    /**
+     * Build a summary of all answers for display and storage
+     */
+    buildAnswersSummary(answers, questions) {
+        if (answers.length === 0) {
+            return 'No questions were answered.';
+        }
+        const lines = ['## User Clarifications', ''];
+        for (const answer of answers) {
+            const q = questions.find((q) => q.id === answer.questionId);
+            const priority = q?.priority ?? 'P2';
+            lines.push(`### ${answer.questionId}: ${answer.question}`);
+            lines.push(`**Priority**: ${priority}`);
+            if (answer.customAnswer) {
+                lines.push(`**Answer**: ${answer.customAnswer} (custom)`);
+            }
+            else {
+                lines.push(`**Answer**: ${answer.selectedOption}`);
+            }
+            lines.push('');
+        }
+        const skippedCount = questions.length - answers.length;
+        if (skippedCount > 0) {
+            lines.push(`*${skippedCount} question(s) were skipped.*`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format answers for passing to subsequent pipeline stages
+     */
+    formatAnswersForStage(answers) {
+        const formatted = {};
+        for (const answer of answers) {
+            formatted[answer.questionId] = answer.customAnswer ?? answer.selectedOption;
+        }
+        return formatted;
+    }
+}
+/**
+ * Singleton instance
+ */
+let serviceInstance = null;
+export function getInteractiveQuestionHandler() {
+    serviceInstance ??= new InteractiveQuestionHandlerService();
+    return serviceInstance;
+}
+//# sourceMappingURL=interactive-question-handler.service.js.map

package/dist/executor/interactive-question-handler.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-question-handler.service.js","sourceRoot":"","sources":["../../src/executor/interactive-question-handler.service.ts"],"names":[],"mappings":"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"}

package/dist/executor/message-builder.service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Message Builder Service
+ *
+ * Constructs system and user messages for LLM prompts.
+ * Extracted from StageExecutor to follow Single Responsibility Principle.
+ *
+ * Responsibilities:
+ * - System message construction with agent profile, prompt, and context
+ * - Output format instruction generation
+ * - Escalation instruction generation
+ * - User message formatting with input resolution
+ */
+import type { getLogger } from '../output/logger.js';
+type Logger = ReturnType<typeof getLogger>;
+/**
+ * Options for building a system message
+ */
+export interface SystemMessageOptions {
+    /** Agent profile/role description */
+    agentProfile: string;
+    /** Pre-loaded available agents content */
+    availableAgents?: null | string;
+    /** Escalation criteria to include */
+    escalationCriteria?: string[];
+    /** Expected output property names */
+    expectedOutputs?: string[];
+    /** Project guidance content */
+    projectGuidance?: null | string;
+    /** Project knowledge content */
+    projectKnowledge?: null | string;
+    /** Task-specific prompt content */
+    promptContent: string;
+}
+/**
+ * Service for building LLM messages
+ */
+export declare class MessageBuilderService {
+    constructor(_logger?: Logger);
+    /**
+     * Build system message with all components
+     *
+     * Structure:
+     * 1. Project Guidance - AI behaviour instructions
+     * 2. Agent Profile - Role-specific instructions
+     * 3. Prompt Content - Task-specific instructions
+     * 4. Available Agents - Pre-loaded team references
+     * 5. Project Knowledge - Context for this task
+     * 6. Output Format Instructions - Expected response structure
+     * 7. Escalation Instructions - When to escalate
+     */
+    buildSystemMessage(options: SystemMessageOptions): string;
+    /**
+     * Build output format instruction to enforce JSON structure
+     */
+    buildOutputFormatInstruction(expectedOutputs: string[]): string;
+    /**
+     * Build escalation protocol instructions for the LLM
+     */
+    buildEscalationInstruction(escalationCriteria: string[]): string;
+    /**
+     * Build user message with resolved inputs
+     * Formats file contents in a clear, readable way for the LLM
+     */
+    buildUserMessage(inputs: Record<string, unknown>): string;
+    /**
+     * Separate inputs into regular inputs and file contents
+     */
+    private separateInputs;
+    /**
+     * Format a regular input value for the message
+     */
+    private formatRegularInput;
+}
+/**
+ * Get the singleton MessageBuilderService instance
+ */
+export declare function getMessageBuilderService(): MessageBuilderService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetMessageBuilderService(): void;
+export {};
+//# sourceMappingURL=message-builder.service.d.ts.map

package/dist/executor/message-builder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builder.service.d.ts","sourceRoot":"","sources":["../../src/executor/message-builder.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAChC,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAChC,gCAAgC;IAChC,gBAAgB,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACjC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,qBAAqB;gBACrB,OAAO,CAAC,EAAE,MAAM;IAI5B;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAuDzD;;OAEG;IACH,4BAA4B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM;IA4B/D;;OAEG;IACH,0BAA0B,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,MAAM;IAuChE;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAwBzD;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAW1B;AAOD;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAGhE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/executor/message-builder.service.js

@@ -0,0 +1,211 @@
+/**
+ * Message Builder Service
+ *
+ * Constructs system and user messages for LLM prompts.
+ * Extracted from StageExecutor to follow Single Responsibility Principle.
+ *
+ * Responsibilities:
+ * - System message construction with agent profile, prompt, and context
+ * - Output format instruction generation
+ * - Escalation instruction generation
+ * - User message formatting with input resolution
+ */
+/**
+ * Service for building LLM messages
+ */
+export class MessageBuilderService {
+    constructor(_logger) {
+        // Logger available for future debugging needs
+    }
+    /**
+     * Build system message with all components
+     *
+     * Structure:
+     * 1. Project Guidance - AI behaviour instructions
+     * 2. Agent Profile - Role-specific instructions
+     * 3. Prompt Content - Task-specific instructions
+     * 4. Available Agents - Pre-loaded team references
+     * 5. Project Knowledge - Context for this task
+     * 6. Output Format Instructions - Expected response structure
+     * 7. Escalation Instructions - When to escalate
+     */
+    buildSystemMessage(options) {
+        const { agentProfile, availableAgents, escalationCriteria, expectedOutputs, projectGuidance, projectKnowledge, promptContent } = options;
+        const messageParts = [];
+        // 1. Prepend project-level guidance if available (highest priority - AI behaviour)
+        if (projectGuidance) {
+            messageParts.push(projectGuidance);
+            messageParts.push('');
+        }
+        // 2. Add agent profile
+        messageParts.push(agentProfile);
+        messageParts.push('');
+        messageParts.push('---');
+        messageParts.push('');
+        // 3. Add prompt content (task-specific instructions)
+        messageParts.push(promptContent);
+        // 4. Add available agents if provided (pre-loaded team references)
+        if (availableAgents) {
+            messageParts.push('');
+            messageParts.push(availableAgents);
+        }
+        // 5. Append project knowledge if available (context for this task)
+        if (projectKnowledge) {
+            messageParts.push('');
+            messageParts.push(projectKnowledge);
+        }
+        let message = messageParts.join('\n');
+        // Append output format enforcement if expected outputs are defined
+        if (expectedOutputs && expectedOutputs.length > 0) {
+            message += '\n\n' + this.buildOutputFormatInstruction(expectedOutputs);
+        }
+        // Append escalation instructions if criteria are defined
+        if (escalationCriteria && escalationCriteria.length > 0) {
+            message += '\n\n' + this.buildEscalationInstruction(escalationCriteria);
+        }
+        return message;
+    }
+    /**
+     * Build output format instruction to enforce JSON structure
+     */
+    buildOutputFormatInstruction(expectedOutputs) {
+        const outputList = expectedOutputs.map((o) => `  - "${o}"`).join('\n');
+        return `---
+
+## CRITICAL: Required Output Format
+
+Your response MUST include a JSON object with ALL of the following required properties:
+
+${outputList}
+
+**Format Requirements:**
+1. Return your response as a valid JSON object inside a markdown code block
+2. Include ALL properties listed above - missing properties will cause failures
+3. Use the exact property names shown (case-sensitive)
+4. For score properties, use numbers (0-10 scale unless otherwise specified)
+5. For list properties (concerns, gaps, issues, steps, etc.), use arrays
+
+**Example structure:**
+\`\`\`json
+{
+${expectedOutputs.map((o) => `  "${o}": <appropriate value>`).join(',\n')}
+}
+\`\`\`
+
+**IMPORTANT:** Do not omit any of the required properties. Provide empty arrays [] for list properties with no items, and appropriate default values for other properties if analysis yields no specific findings.`;
+    }
+    /**
+     * Build escalation protocol instructions for the LLM
+     */
+    buildEscalationInstruction(escalationCriteria) {
+        const criteriaList = escalationCriteria.map((c, i) => `${i + 1}. ${c}`).join('\n');
+        return `---
+
+## CRITICAL: Escalation Protocol
+
+You MUST evaluate your response against these escalation criteria before completing your response.
+
+**Escalation Criteria:**
+${criteriaList}
+
+**Required Output Structure:**
+You MUST include this JSON block at the END of your response, after all other content:
+
+\`\`\`json
+{
+  "_escalation": {
+    "requires_escalation": boolean,
+    "confidence": number,
+    "triggered_criteria": ["list of criteria that matched, if any"],
+    "reasoning": "Brief explanation of why escalation is or isn't required",
+    "proposed_action": "What you plan to do or recommend",
+    "risk_level": "low" | "medium" | "high" | "critical"
+  }
+}
+\`\`\`
+
+**Field Descriptions:**
+- \`requires_escalation\`: Set to true if ANY of the escalation criteria are triggered
+- \`confidence\`: Your confidence level (0-100) in the proposed action
+- \`triggered_criteria\`: Array of specific criteria that were triggered (empty if none)
+- \`reasoning\`: Brief explanation of your escalation decision
+- \`proposed_action\`: What you plan to do or what you recommend
+- \`risk_level\`: Overall risk assessment of the proposed action
+
+**IMPORTANT:** This escalation block is MANDATORY. Always include it at the end of your response.`;
+    }
+    /**
+     * Build user message with resolved inputs
+     * Formats file contents in a clear, readable way for the LLM
+     */
+    buildUserMessage(inputs) {
+        if (Object.keys(inputs).length === 0) {
+            return 'Please proceed with the task.';
+        }
+        const { fileContents, regularInputs } = this.separateInputs(inputs);
+        const messageParts = [];
+        // Add regular inputs with clear formatting
+        regularInputs.forEach(([key, value]) => {
+            const formatted = this.formatRegularInput(key, value);
+            if (formatted) {
+                messageParts.push(formatted);
+            }
+        });
+        // Add file contents with clear formatting
+        fileContents.forEach(([filePath, content]) => {
+            messageParts.push(`\n--- File: ${filePath} ---\n${content}\n--- End of File ---`);
+        });
+        return messageParts.join('\n');
+    }
+    /**
+     * Separate inputs into regular inputs and file contents
+     */
+    separateInputs(inputs) {
+        const regularInputs = [];
+        const fileContents = [];
+        for (const [key, value] of Object.entries(inputs)) {
+            if (key.endsWith('_content') && typeof value === 'string') {
+                const baseName = key.replace(/_content$/, '');
+                const filePath = inputs[baseName];
+                fileContents.push([filePath ?? baseName, value]);
+            }
+            else if (!key.endsWith('_content')) {
+                const contentKey = `${key}_content`;
+                if (!Object.prototype.hasOwnProperty.call(inputs, contentKey)) {
+                    regularInputs.push([key, value]);
+                }
+            }
+        }
+        return { fileContents, regularInputs };
+    }
+    /**
+     * Format a regular input value for the message
+     */
+    formatRegularInput(key, value) {
+        if (value === undefined || value === null || value === '') {
+            return null;
+        }
+        if (typeof value === 'object' && value !== null) {
+            return `## Input: ${key}\n\n\`\`\`json\n${JSON.stringify(value, null, 2)}\n\`\`\``;
+        }
+        return `**${key}**: ${String(value)}`;
+    }
+}
+/**
+ * Singleton instance
+ */
+let messageBuilderServiceInstance = null;
+/**
+ * Get the singleton MessageBuilderService instance
+ */
+export function getMessageBuilderService() {
+    messageBuilderServiceInstance ??= new MessageBuilderService();
+    return messageBuilderServiceInstance;
+}
+/**
+ * Reset the singleton instance (for testing)
+ */
+export function resetMessageBuilderService() {
+    messageBuilderServiceInstance = null;
+}
+//# sourceMappingURL=message-builder.service.js.map

package/dist/executor/message-builder.service.js.map

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