@codemcp/workflows-core 3.1.16

package/dist/file-detection-manager.js

@@ -0,0 +1,221 @@
+/**
+ * File Detection Manager
+ *
+ * Handles pattern-based file discovery and suggestions for existing documentation files.
+ * Supports auto-detection of common documentation patterns in projects.
+ */
+import { readdir, access } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { createLogger } from './logger.js';
+import { PathValidationUtils } from './path-validation-utils.js';
+const logger = createLogger('FileDetectionManager');
+export class FileDetectionManager {
+    projectPath;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+    }
+    /**
+     * Detect existing documentation files in the project
+     */
+    async detectDocumentationFiles() {
+        logger.debug('Starting documentation file detection', {
+            projectPath: this.projectPath,
+        });
+        const searchLocations = this.getSearchLocations();
+        const patterns = PathValidationUtils.getCommonDocumentationPatterns();
+        const result = {
+            architecture: [],
+            requirements: [],
+            design: [],
+        };
+        // Search in each location
+        for (const location of searchLocations) {
+            try {
+                await access(location);
+                const files = await this.scanLocation(location);
+                // Match files against patterns
+                for (const file of files) {
+                    const matches = this.matchFileToPatterns(file, patterns);
+                    for (const match of matches) {
+                        result[match.type].push({
+                            path: file.path,
+                            relativePath: file.relativePath,
+                            type: match.type,
+                            confidence: match.confidence,
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                logger.debug('Search location not accessible', {
+                    location,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        // Sort by confidence and remove duplicates
+        result.architecture = this.sortAndDeduplicate(result.architecture);
+        result.requirements = this.sortAndDeduplicate(result.requirements);
+        result.design = this.sortAndDeduplicate(result.design);
+        logger.info('Documentation file detection completed', {
+            found: {
+                architecture: result.architecture.length,
+                requirements: result.requirements.length,
+                design: result.design.length,
+            },
+        });
+        return result;
+    }
+    /**
+     * Get search locations for documentation files
+     */
+    getSearchLocations() {
+        return [
+            this.projectPath, // Project root
+            join(this.projectPath, 'docs'), // docs/ folder
+            join(this.projectPath, 'doc'), // doc/ folder
+            join(this.projectPath, '.vibe', 'docs'), // .vibe/docs/ folder
+            join(this.projectPath, 'documentation'), // documentation/ folder
+        ];
+    }
+    /**
+     * Scan a location for files
+     */
+    async scanLocation(location) {
+        try {
+            const entries = await readdir(location, { withFileTypes: true });
+            const files = [];
+            for (const entry of entries) {
+                if (entry.isFile()) {
+                    const fullPath = join(location, entry.name);
+                    const relativePath = fullPath.replace(this.projectPath + '/', '');
+                    files.push({
+                        path: fullPath,
+                        relativePath,
+                    });
+                }
+            }
+            return files;
+        }
+        catch (error) {
+            logger.debug('Failed to scan location', {
+                location,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return [];
+        }
+    }
+    /**
+     * Match a file against documentation patterns
+     */
+    matchFileToPatterns(file, patterns) {
+        const fileName = basename(file.path).toLowerCase();
+        const relativePath = file.relativePath.toLowerCase();
+        const matches = [];
+        // Check architecture patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.architecture)) {
+            const confidence = this.getConfidence(fileName, 'architecture');
+            matches.push({ type: 'architecture', confidence });
+        }
+        // Check requirements patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.requirements)) {
+            const confidence = this.getConfidence(fileName, 'requirements');
+            matches.push({ type: 'requirements', confidence });
+        }
+        // Check design patterns
+        if (this.matchesPatterns(fileName, relativePath, patterns.design)) {
+            const confidence = this.getConfidence(fileName, 'design');
+            matches.push({ type: 'design', confidence });
+        }
+        return matches;
+    }
+    /**
+     * Check if file matches any of the patterns
+     */
+    matchesPatterns(fileName, relativePath, patterns) {
+        return patterns.some(pattern => {
+            const normalizedPattern = pattern.toLowerCase();
+            // Exact filename match
+            if (fileName === normalizedPattern) {
+                return true;
+            }
+            // Relative path match
+            if (relativePath === normalizedPattern) {
+                return true;
+            }
+            // Pattern matching with wildcards
+            if (normalizedPattern.includes('*')) {
+                const regex = new RegExp(normalizedPattern.replace(/\*/g, '.*'));
+                return regex.test(fileName) || regex.test(relativePath);
+            }
+            return false;
+        });
+    }
+    /**
+     * Determine confidence level for a match
+     */
+    getConfidence(fileName, type) {
+        // High confidence for exact type matches
+        if (fileName.includes(type.toLowerCase())) {
+            return 'high';
+        }
+        // Medium confidence for README files (could contain any type)
+        if (fileName.includes('readme')) {
+            return 'medium';
+        }
+        // Low confidence for other matches
+        return 'low';
+    }
+    /**
+     * Sort by confidence and remove duplicates
+     */
+    sortAndDeduplicate(files) {
+        // Remove duplicates by path
+        const unique = files.filter((file, index, array) => array.findIndex(f => f.path === file.path) === index);
+        // Sort by confidence (high first) and then by path length (shorter first)
+        return unique.sort((a, b) => {
+            const confidenceOrder = { high: 0, medium: 1, low: 2 };
+            const confidenceDiff = confidenceOrder[a.confidence] - confidenceOrder[b.confidence];
+            if (confidenceDiff !== 0) {
+                return confidenceDiff;
+            }
+            return a.relativePath.length - b.relativePath.length;
+        });
+    }
+    /**
+     * Format file suggestions for LLM responses
+     */
+    formatSuggestions(detectionResult) {
+        const suggestions = [];
+        if (detectionResult.architecture.length > 0) {
+            suggestions.push(`**Architecture files found:**`);
+            for (const file of detectionResult.architecture.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (detectionResult.requirements.length > 0) {
+            suggestions.push(`**Requirements files found:**`);
+            for (const file of detectionResult.requirements.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (detectionResult.design.length > 0) {
+            suggestions.push(`**Design files found:**`);
+            for (const file of detectionResult.design.slice(0, 3)) {
+                suggestions.push(`  - ${file.relativePath} (${file.confidence} confidence)`);
+            }
+        }
+        if (suggestions.length === 0) {
+            return 'No existing documentation files detected.';
+        }
+        return [
+            'Existing documentation files detected:',
+            '',
+            ...suggestions,
+            '',
+            'You can use these files with `setup_project_docs` by providing the file paths instead of template names.',
+            'Example: `setup_project_docs({ architecture: "README.md", requirements: "docs/requirements.md", design: "freestyle" })`',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=file-detection-manager.js.map

package/dist/file-detection-manager.js.map

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

package/dist/git-manager.d.ts

@@ -0,0 +1,14 @@
+export declare class GitManager {
+    /**
+     * Check if a directory is a git repository
+     */
+    static isGitRepository(projectPath: string): boolean;
+    /**
+     * Get the current git branch for a project
+     */
+    static getCurrentBranch(projectPath: string): string;
+    /**
+     * Get the current HEAD commit hash (for tracking start of development)
+     */
+    static getCurrentCommitHash(projectPath: string): string | null;
+}

package/dist/git-manager.js

@@ -0,0 +1,59 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { createLogger } from './logger.js';
+const logger = createLogger('GitManager');
+export class GitManager {
+    /**
+     * Check if a directory is a git repository
+     */
+    static isGitRepository(projectPath) {
+        return existsSync(`${projectPath}/.git`);
+    }
+    /**
+     * Get the current git branch for a project
+     */
+    static getCurrentBranch(projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                logger.debug('Not a git repository, using "default" as branch name', {
+                    projectPath,
+                });
+                return 'default';
+            }
+            const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            logger.debug('Detected git branch', { projectPath, branch });
+            return branch;
+        }
+        catch (_error) {
+            logger.debug('Failed to get git branch, using "default" as branch name', {
+                projectPath,
+            });
+            return 'default';
+        }
+    }
+    /**
+     * Get the current HEAD commit hash (for tracking start of development)
+     */
+    static getCurrentCommitHash(projectPath) {
+        try {
+            if (!this.isGitRepository(projectPath)) {
+                return null;
+            }
+            const hash = execSync('git rev-parse HEAD', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            }).trim();
+            return hash;
+        }
+        catch (error) {
+            logger.debug('Failed to get current commit hash', { projectPath, error });
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=git-manager.js.map

package/dist/git-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-manager.js","sourceRoot":"","sources":["../src/git-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;AAE1C,MAAM,OAAO,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAmB;QACxC,OAAO,UAAU,CAAC,GAAG,WAAW,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,WAAmB;QACzC,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE;oBACnE,WAAW;iBACZ,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,MAAM,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;gBACzD,GAAG,EAAE,WAAW;gBAChB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEV,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,0DAA0D,EAAE;gBACvE,WAAW;aACZ,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,WAAmB;QAC7C,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,oBAAoB,EAAE;gBAC1C,GAAG,EAAE,WAAW;gBAChB,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEV,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from './types.js';
+export * from './state-machine-types.js';
+export * from './state-machine.js';
+export * from './state-machine-loader.js';
+export * from './workflow-manager.js';
+export * from './transition-engine.js';
+export * from './database.js';
+export * from './conversation-manager.js';
+export * from './plan-manager.js';
+export * from './template-manager.js';
+export * from './project-docs-manager.js';
+export * from './file-detection-manager.js';
+export * from './config-manager.js';
+export * from './git-manager.js';
+export * from './logger.js';
+export * from './interaction-logger.js';
+export * from './instruction-generator.js';
+export * from './system-prompt-generator.js';
+export * from './path-validation-utils.js';

package/dist/index.js

@@ -0,0 +1,25 @@
+// Core types and interfaces
+export * from './types.js';
+export * from './state-machine-types.js';
+// State machine and workflow management
+export * from './state-machine.js';
+export * from './state-machine-loader.js';
+export * from './workflow-manager.js';
+export * from './transition-engine.js';
+// Data management
+export * from './database.js';
+export * from './conversation-manager.js';
+// Project and plan management
+export * from './plan-manager.js';
+export * from './template-manager.js';
+export * from './project-docs-manager.js';
+export * from './file-detection-manager.js';
+export * from './config-manager.js';
+export * from './git-manager.js';
+// Utilities and generators
+export * from './logger.js';
+export * from './interaction-logger.js';
+export * from './instruction-generator.js';
+export * from './system-prompt-generator.js';
+export * from './path-validation-utils.js';
+//# 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,4BAA4B;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AAEzC,wCAAwC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AAEvC,kBAAkB;AAClB,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAE1C,8BAA8B;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,2BAA2B;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC"}

package/dist/instruction-generator.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Instruction Generator
+ *
+ * Creates phase-specific guidance for the LLM based on current conversation state.
+ * Customizes instructions based on project context and development phase.
+ * Supports custom state machine definitions for dynamic instruction generation.
+ * Handles variable substitution for project artifact references.
+ */
+import type { ConversationContext } from './types.js';
+import { PlanManager } from './plan-manager.js';
+import type { YamlStateMachine } from './state-machine-types.js';
+export interface InstructionContext {
+    phase: string;
+    conversationContext: ConversationContext;
+    transitionReason: string;
+    isModeled: boolean;
+    planFileExists: boolean;
+}
+export interface GeneratedInstructions {
+    instructions: string;
+    planFileGuidance: string;
+    metadata: {
+        phase: string;
+        planFilePath: string;
+        transitionReason: string;
+        isModeled: boolean;
+    };
+}
+export declare class InstructionGenerator {
+    private planManager;
+    private projectDocsManager;
+    private stateMachine;
+    constructor(planManager: PlanManager);
+    /**
+     * Set the state machine definition for dynamic instruction generation
+     */
+    setStateMachine(stateMachine: YamlStateMachine): void;
+    /**
+     * Generate comprehensive instructions for the LLM
+     */
+    generateInstructions(baseInstructions: string, context: InstructionContext): Promise<GeneratedInstructions>;
+    /**
+     * Apply variable substitution to instructions
+     * Replaces project artifact variables with actual file paths
+     */
+    private applyVariableSubstitution;
+    /**
+     * Escape special regex characters in variable names
+     */
+    private escapeRegExp;
+    /**
+     * Enhance base instructions with context-specific information
+     */
+    private enhanceInstructions;
+    /**
+     * Get phase-specific contextual information based on state machine
+     */
+    private getPhaseSpecificContext;
+    /**
+     * Get default phase context for standard phases
+    /**
+     * Get phase-specific reminders and best practices based on state machine
+     */
+    private getPhaseReminders;
+    /**
+     * Capitalize phase name for display
+     */
+    private capitalizePhase;
+}

package/dist/instruction-generator.js

@@ -0,0 +1,133 @@
+/**
+ * Instruction Generator
+ *
+ * Creates phase-specific guidance for the LLM based on current conversation state.
+ * Customizes instructions based on project context and development phase.
+ * Supports custom state machine definitions for dynamic instruction generation.
+ * Handles variable substitution for project artifact references.
+ */
+import { ProjectDocsManager } from './project-docs-manager.js';
+export class InstructionGenerator {
+    planManager;
+    projectDocsManager;
+    stateMachine = null;
+    constructor(planManager) {
+        this.planManager = planManager;
+        this.projectDocsManager = new ProjectDocsManager();
+    }
+    /**
+     * Set the state machine definition for dynamic instruction generation
+     */
+    setStateMachine(stateMachine) {
+        this.stateMachine = stateMachine;
+    }
+    /**
+     * Generate comprehensive instructions for the LLM
+     */
+    async generateInstructions(baseInstructions, context) {
+        // Apply variable substitution to base instructions
+        const substitutedInstructions = this.applyVariableSubstitution(baseInstructions, context.conversationContext.projectPath);
+        // Get plan file guidance
+        const planFileGuidance = this.planManager.generatePlanFileGuidance(context.phase);
+        // Enhance base instructions with context-specific guidance
+        const enhancedInstructions = await this.enhanceInstructions(substitutedInstructions, context, planFileGuidance);
+        return {
+            instructions: enhancedInstructions,
+            planFileGuidance,
+            metadata: {
+                phase: context.phase,
+                planFilePath: context.conversationContext.planFilePath,
+                transitionReason: context.transitionReason,
+                isModeled: context.isModeled,
+            },
+        };
+    }
+    /**
+     * Apply variable substitution to instructions
+     * Replaces project artifact variables with actual file paths
+     */
+    applyVariableSubstitution(instructions, projectPath) {
+        const substitutions = this.projectDocsManager.getVariableSubstitutions(projectPath);
+        let result = instructions;
+        for (const [variable, value] of Object.entries(substitutions)) {
+            // Use global replace to handle multiple occurrences
+            result = result.replace(new RegExp(this.escapeRegExp(variable), 'g'), value);
+        }
+        return result;
+    }
+    /**
+     * Escape special regex characters in variable names
+     */
+    escapeRegExp(string) {
+        return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Enhance base instructions with context-specific information
+     */
+    async enhanceInstructions(baseInstructions, context, _planFileGuidance) {
+        const { phase, conversationContext, transitionReason, isModeled, planFileExists, } = context;
+        // Build plan-file-referential instructions
+        let enhanced = `Check your plan file at \`${conversationContext.planFilePath}\` and focus on the "${this.capitalizePhase(phase)}" section.
+
+${baseInstructions}
+
+**Plan File Guidance:**
+- Work on the tasks listed in the ${this.capitalizePhase(phase)} section
+- Mark completed tasks with [x] as you finish them
+- Add new tasks as they are identified during your work with the user
+- Update the "Key Decisions" section with important choices made
+- Add relevant notes to help maintain context`;
+        // Add project context
+        enhanced += `\n\n**Project Context:**
+- Project: ${conversationContext.projectPath}
+- Branch: ${conversationContext.gitBranch}
+- Current Phase: ${phase}`;
+        // Add transition context if this is a modeled transition
+        if (isModeled && transitionReason) {
+            enhanced += `\n\n**Phase Context:**
+- ${transitionReason}`;
+        }
+        // Add plan file creation note if needed
+        if (!planFileExists) {
+            enhanced +=
+                '\n\n**Note**: Plan file will be created when you first update it.';
+        }
+        return enhanced;
+    }
+    /**
+     * Get phase-specific contextual information based on state machine
+     */
+    getPhaseSpecificContext(phase) {
+        if (this.stateMachine) {
+            const phaseDefinition = this.stateMachine.states[phase];
+            if (phaseDefinition) {
+                return `**Context**: ${phaseDefinition.description}`;
+            }
+        }
+        throw new Error(`State machine not set or unknown phase: ${phase}. This should not happen as state machine is always loaded.`);
+    }
+    /**
+     * Get default phase context for standard phases
+    /**
+     * Get phase-specific reminders and best practices based on state machine
+     */
+    getPhaseReminders(phase) {
+        if (this.stateMachine) {
+            const phaseDefinition = this.stateMachine.states[phase];
+            if (phaseDefinition) {
+                return `**Remember**: \n- Focus on: ${phaseDefinition.description}\n- Update plan file with ${phase} progress\n- Mark completed tasks with [x]\n- Stay focused on current phase objectives`;
+            }
+        }
+        throw new Error(`State machine not set or unknown phase: ${phase}. This should not happen as state machine is always loaded.`);
+    }
+    /**
+     * Capitalize phase name for display
+     */
+    capitalizePhase(phase) {
+        return phase
+            .split('_')
+            .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+            .join(' ');
+    }
+}
+//# sourceMappingURL=instruction-generator.js.map

package/dist/instruction-generator.js.map

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

package/dist/interaction-logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Interaction Logger module
+ *
+ * Handles logging of tool interactions to the database for auditing and debugging.
+ */
+import { Database } from './database.js';
+import type { InteractionLog } from './types.js';
+/**
+ * Handles logging of tool interactions to the database
+ */
+export declare class InteractionLogger {
+    private database;
+    /**
+     * Create a new InteractionLogger
+     *
+     * @param database - Database instance to use for logging
+     */
+    constructor(database: Database);
+    /**
+     * Log an interaction with a tool
+     *
+     * @param conversationId - ID of the conversation
+     * @param toolName - Name of the tool that was called
+     * @param inputParams - Input parameters to the tool (will be stringified)
+     * @param responseData - Response data from the tool (will be stringified)
+     * @param currentPhase - Current development phase
+     * @returns Promise that resolves when the log is saved
+     */
+    logInteraction(conversationId: string, toolName: string, inputParams: unknown, responseData: unknown, currentPhase: string): Promise<void>;
+    /**
+     * Get all interactions for a specific conversation
+     *
+     * @param conversationId - ID of the conversation to get logs for
+     * @returns Promise that resolves to an array of interaction logs
+     */
+    getInteractionsByConversationId(conversationId: string): Promise<InteractionLog[]>;
+}