@houtini/lm 1.0.5 → 1.0.7

package/README.md

@@ -1,203 +1,294 @@
-# Houtini LM - LM Studio MCP Server with Expert Prompt Library and Custom Prompting
-
-**Version**: 1.0.1  
-**Your unlimited AI companion: This MCP server connects Claude to LM Studio for code analysis, generation, and creativity**
-
-Transform your development workflow with our expert-level prompt library for code analysis, professional documentation generation, and creative project scaffolding - all running locally without API costs. For developers, vibe coders and creators alike.
-
-## What This Does
-
-Houtini LM **saves your Claude context window** by offloading detailed analysis tasks to LM Studio locally or on your company network whilst Claude focuses on strategy and complex problem-solving. Think of it as your intelligent coding assistant that never runs out of tokens.
-
-**Perfect for:**
-- 🔍 **Code analysis** - Deep insights into quality, security, and architecture
-- 📝 **Documentation generation** - Professional docs from code analysis
-- 🏗️ **Project scaffolding** - Complete applications, themes, and components
-- 🎮 **Creative projects** - Games, CSS art, and interactive experiences
-- 🛡️ **Security audits** - OWASP compliance and vulnerability detection
-
-## Quick Start Prompt Guide
-
-Once installed, simply use natural language prompts with Claude:
-
-```
-Use houtini-lm to analyse the code quality in C:/my-project/src/UserAuth.js
-```
-
-```
-Generate comprehensive unit tests using houtini-lm for my React component at C:/components/Dashboard.jsx
-```
-
-```
-Use houtini-lm to create a WordPress plugin called "Event Manager" with custom post types and admin interface
-```
-
-```
-Audit the security of my WordPress theme using houtini-lm at C:/themes/my-theme
-```
-
-```
-Create a CSS art generator project using houtini-lm with space theme and neon colours
-```
-
-```
-Use houtini-lm to convert my JavaScript file to TypeScript with strict mode enabled
-```
-
-```
-Generate responsive HTML components using houtini-lm for a pricing card with dark mode support
-```
-
-## Prerequisites
-
-**Essential Requirements:**
-
-1. **LM Studio** - Download from [lmstudio.ai](https://lmstudio.ai)
-   - Must be running at `ws://127.0.0.1:1234`
-   - Model loaded and ready (13B+ parameters recommended)
-
-2. **Desktop Commander MCP** - Essential for file operations
-   - Repository: [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP)
-   - Required for reading files and writing generated code
-
-3. **Node.js 24.6.0 or later** - For MCP server functionality
-   - Download from [nodejs.org](https://nodejs.org)
-
-4. **Claude Desktop** - For the best experience
-   - Download from [claude.ai/download](https://claude.ai/download)
-
-## Installation
-
-### 1. Install Dependencies
-
-```bash
-# Clone the repository
-git clone https://github.com/houtini-ai/lm.git
-cd lm
-
-# Install Node.js dependencies
-npm install
-```
-
-### 2. Configure Claude Desktop
-
-Add to your Claude Desktop configuration file:
-
-**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`  
-**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "houtini-lm": {
-      "command": "node",
-      "args": ["path/to/houtini-lm/index.js"],
-      "env": {
-        "LLM_MCP_ALLOWED_DIRS": "C:/your-projects,C:/dev,C:/websites"
-      }
-    }
-  }
-}
-```
-
-### 3. Start LM Studio
-
-1. Launch LM Studio
-2. Load a model (13B+ parameters recommended for best results)
-3. Start the server at `ws://127.0.0.1:1234`
-4. Verify the model is ready and responding
-
-### 4. Verify Installation
-
-Restart Claude Desktop, then test with:
-
-```
-Use houtini-lm health check to verify everything is working
-```
-
-## Available Functions
-
-### 🔍 Analysis Functions (17 functions)
-- **`analyze_single_file`** - Deep code analysis and quality assessment
-- **`count_files`** - Project structure with beautiful markdown trees
-- **`find_unused_files`** - Dead code detection with risk assessment
-- **`security_audit`** - OWASP compliance and vulnerability scanning
-- **`analyze_dependencies`** - Circular dependencies and unused imports
-- And 12 more specialized analysis tools...
-
-### 🛠️ Generation Functions (10 functions)
-- **`generate_unit_tests`** - Comprehensive test suites with framework patterns
-- **`generate_documentation`** - Professional docs from code analysis
-- **`convert_to_typescript`** - JavaScript to TypeScript with type safety
-- **`generate_wordpress_plugin`** - Complete WordPress plugin creation
-- **`generate_responsive_component`** - Accessible HTML/CSS components
-- And 5 more generation tools...
-
-### 🎮 Creative Functions (3 functions)
-- **`css_art_generator`** - Pure CSS art and animations
-- **`arcade_game`** - Complete playable HTML5 games
-- **`create_text_adventure`** - Interactive fiction with branching stories
-
-### ⚙️ System Functions (5 functions)
-- **`health_check`** - Verify LM Studio connection
-- **`list_functions`** - Discover all available functions
-- **`resolve_path`** - Path analysis and suggestions
-- And 2 more system utilities...
-
-## Documentation
-
-**Complete guides available:**
-- [Analysis Functions Guide](docs/analysis-functions-md.md) - All 17 analysis tools
-- [Generation Functions Guide](docs/generation-functions-md.md) - All 10 creation tools  
-- [Creative Functions Guide](docs/creative-functions-md.md) - Games and art tools
-- [System Functions Guide](docs/system-functions-md.md) - Utilities and diagnostics
-- [Complete User Guide](docs/user-guide-md.md) - Comprehensive usage manual
-
-## Recommended Setup
-
-**For Professional Development:**
-- **CPU**: 8-core or better (for local LLM processing)
-- **RAM**: 32GB (24GB for model, 8GB for development)
-- **Storage**: SSD with 100GB+ free space
-- **Model**: Qwen2.5-Coder-14B-Instruct or similar
-
-**Performance Tips:**
-- Use 13B+ parameter models for professional-quality results
-- Configure `LLM_MCP_ALLOWED_DIRS` to include your project directories
-- Install Desktop Commander MCP for complete file operation support
-- Keep LM Studio running and model loaded for instant responses
-
-## Version History
-
-### Version 1.0.0 (Current)
-- ✅ Complete function library (35+ functions)
-- ✅ Professional documentation system
-- ✅ WordPress-specific tools and auditing
-- ✅ Creative project generators
-- ✅ Comprehensive security analysis
-- ✅ TypeScript conversion and test generation
-- ✅ Cross-file integration analysis
-
-## License
-
-**MIT License** - Use this project freely for personal and commercial projects. See [LICENSE](LICENSE) for details.
-
-## Contributing
-
-We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
-- Code standards and patterns
-- Testing requirements
-- Documentation updates
-- Issue reporting
-
-## Support
-
-- **Issues**: [GitHub Issues](https://github.com/houtini-ai/lm/issues)
-- **Discussions**: [GitHub Discussions](https://github.com/houtini-ai/lm/discussions)
-- **Documentation**: Complete guides in the `docs/` directory
-
----
-
-**Ready to supercharge your development workflow?** Install Houtini LM and start building amazing things with unlimited local AI assistance.
-
+# Houtini LM - LM Studio MCP Server with Expert Prompt Library and Custom Prompting
+
+**Your unlimited AI companion: This MCP server connects Claude to LM Studio for code analysis, generation, and creativity**
+
+Transform your development workflow with our expert-level prompt library for code analysis, professional documentation generation, and creative project scaffolding - all running locally without API costs. For developers, vibe coders and creators alike.
+
+## What This Does
+
+Houtini LM **saves your Claude context window** by offloading detailed analysis tasks to LM Studio locally or on your company network whilst Claude focuses on strategy and complex problem-solving. Think of it as your intelligent coding assistant that never runs out of tokens.
+
+**Perfect for:**
+- 🔍 **Code analysis** - Deep insights into quality, security, and architecture
+- 📝 **Documentation generation** - Professional docs from code analysis
+- 🏗️ **Project scaffolding** - Complete applications, themes, and components
+- 🎮 **Creative projects** - Games, CSS art, and interactive experiences
+- 🛡️ **Security audits** - OWASP compliance and vulnerability detection
+
+## Quick Start Prompt Guide
+
+Once installed, simply use natural language prompts with Claude:
+
+```
+Use houtini-lm to analyse the code quality in C:/my-project/src/UserAuth.js
+```
+
+```
+Generate comprehensive unit tests using houtini-lm for my React component at C:/components/Dashboard.jsx
+```
+
+```
+Use houtini-lm to create a WordPress plugin called "Event Manager" with custom post types and admin interface
+```
+
+```
+Audit the security of my WordPress theme using houtini-lm at C:/themes/my-theme
+```
+
+```
+Create a CSS art generator project using houtini-lm with space theme and neon colours
+```
+
+```
+Use houtini-lm to convert my JavaScript file to TypeScript with strict mode enabled
+```
+
+```
+Generate responsive HTML components using houtini-lm for a pricing card with dark mode support
+```
+
+## Prerequisites
+
+**Essential Requirements:**
+
+1. **LM Studio** - Download from [lmstudio.ai](https://lmstudio.ai)
+   - Must be running at `ws://127.0.0.1:1234`
+   - Model loaded and ready (13B+ parameters recommended)
+
+2. **Desktop Commander MCP** - Essential for file operations
+   - Repository: [DesktopCommanderMCP](https://github.com/wonderwhy-er/DesktopCommanderMCP)
+   - Required for reading files and writing generated code
+
+3. **Node.js 24.6.0 or later** - For MCP server functionality
+   - Download from [nodejs.org](https://nodejs.org)
+
+4. **Claude Desktop** - For the best experience
+   - Download from [claude.ai/download](https://claude.ai/download)
+
+## Installation
+
+### 1. Install Dependencies
+
+```bash
+# Clone the repository
+git clone https://github.com/houtini-ai/lm.git
+cd lm
+
+# Install Node.js dependencies
+npm install
+```
+
+### 2. Configure Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`  
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "houtini-lm": {
+      "command": "node",
+      "args": ["path/to/houtini-lm/index.js"],
+      "env": {
+        "LLM_MCP_ALLOWED_DIRS": "C:/your-projects,C:/dev,C:/websites"
+      }
+    }
+  }
+}
+```
+
+### 3. Start LM Studio
+
+1. Launch LM Studio
+2. Load a model (13B+ parameters recommended for best results)
+3. Start the server at `ws://127.0.0.1:1234`
+4. Verify the model is ready and responding
+
+### 4. Verify Installation
+
+Restart Claude Desktop, then test with:
+
+```
+Use houtini-lm health check to verify everything is working
+```
+
+## Available Functions
+
+### 🔍 Analysis Functions (17 functions)
+- **`analyze_single_file`** - Deep code analysis and quality assessment
+- **`count_files`** - Project structure with beautiful markdown trees
+- **`find_unused_files`** - Dead code detection with risk assessment
+- **`security_audit`** - OWASP compliance and vulnerability scanning
+- **`analyze_dependencies`** - Circular dependencies and unused imports
+- And 12 more specialized analysis tools...
+
+### 🛠️ Generation Functions (10 functions)
+- **`generate_unit_tests`** - Comprehensive test suites with framework patterns
+- **`generate_documentation`** - Professional docs from code analysis
+- **`convert_to_typescript`** - JavaScript to TypeScript with type safety
+- **`generate_wordpress_plugin`** - Complete WordPress plugin creation
+- **`generate_responsive_component`** - Accessible HTML/CSS components
+- And 5 more generation tools...
+
+### 🎮 Creative Functions (3 functions)
+- **`css_art_generator`** - Pure CSS art and animations
+- **`arcade_game`** - Complete playable HTML5 games
+- **`create_text_adventure`** - Interactive fiction with branching stories
+
+### ⚙️ System Functions (5 functions)
+- **`health_check`** - Verify LM Studio connection
+- **`list_functions`** - Discover all available functions
+- **`resolve_path`** - Path analysis and suggestions
+- And 2 more system utilities...
+
+## Context Window Management
+
+Houtini LM implements intelligent context window management to maximize the efficiency of your local LM models while ensuring reliable processing of large files and complex analysis tasks.
+
+### Dynamic Context Allocation
+
+**Adaptive Context Utilization**: Unlike systems with hardcoded token limits, Houtini LM dynamically detects your model's context window and allocates **95% of available tokens** for optimal performance:
+
+```typescript
+// Context detection from your loaded model
+const contextLength = await model.getContextLength(); // e.g., 16,384 tokens
+
+// Dynamic allocation - 95% utilization
+const responseTokens = Math.floor(contextLength * 0.95); // 15,565 tokens available
+```
+
+**Benefits:**
+- ✅ **Maximum efficiency** - No wasted context space
+- ✅ **Model-agnostic** - Works with any context size (4K, 16K, 32K+)
+- ✅ **Future-proof** - Automatically adapts to larger models
+
+### Three-Stage Prompt System
+
+Houtini LM uses a sophisticated prompt architecture that separates concerns for optimal token management:
+
+**Stage 1: System Context** - Expert persona and analysis methodology  
+**Stage 2: Data Payload** - Your code, files, or project content  
+**Stage 3: Output Instructions** - Structured response requirements  
+
+```
+┌─────────────────────┐
+│   System Context   │  ← Expert role, methodologies
+├─────────────────────┤
+│   Data Payload     │  ← Your files/code (chunked if needed)
+├─────────────────────┤
+│ Output Instructions │  ← Response format, requirements
+└─────────────────────┘
+```
+
+**Intelligent Processing:**
+- **Small files** → Single-stage execution for speed
+- **Large files** → Automatic chunking with coherent aggregation
+- **Multi-file projects** → Optimized batch processing
+
+### Automatic Chunking Capability
+
+When files exceed available context space, Houtini LM automatically chunks content while maintaining analysis quality:
+
+**Smart Chunking Features:**
+- 🔍 **Natural boundaries** - Splits at logical sections, not arbitrary points
+- 🔄 **Context preservation** - Maintains analysis continuity across chunks
+- 📊 **Intelligent aggregation** - Combines chunk results into coherent reports
+- ⚡ **Performance optimization** - Parallel processing where possible
+
+**Example Chunking Process:**
+```
+Large File (50KB) → Context Analysis → Exceeds Limit
+    ↓
+Split into 3 logical chunks → Process each chunk → Aggregate results
+    ↓
+Single comprehensive analysis report
+```
+
+### Timeout Configuration
+
+Houtini LM uses **120-second timeouts** (2 minutes) to accommodate thorough analysis on lower-powered systems:
+
+**Why Extended Timeouts:**
+- 🔍 **Complex analysis** - Security audits, architecture analysis, and comprehensive code reviews take time
+- 💻 **System compatibility** - Works reliably on older hardware and resource-constrained environments  
+- 🧠 **Model processing** - Larger local models (13B-33B parameters) require more inference time
+- 📊 **Quality over speed** - Comprehensive reports are worth the wait
+
+**Timeout Guidelines:**
+- **Simple analysis** (100 lines): 15-30 seconds
+- **Medium files** (500 lines): 30-60 seconds  
+- **Large files** (1000+ lines): 60-120 seconds
+- **Multi-file projects**: 90-180 seconds
+
+**Performance Tips:**
+- Use faster models (13B vs 33B) for quicker responses
+- Enable GPU acceleration in LM Studio for better performance
+- Consider using `analysisDepth="basic"` for faster results when appropriate
+
+### Memory Efficiency
+
+**Intelligent Caching**: Results are cached to prevent redundant processing  
+**Resource Management**: Automatic cleanup of large contexts after processing  
+**Streaming Responses**: Progressive output delivery for better user experience
+
+This architecture ensures Houtini LM can handle everything from small utility functions to entire enterprise codebases while maintaining consistent quality and performance across different hardware configurations.
+
+## Documentation
+
+**Complete guides available:**
+- [Analysis Functions Guide](docs/analysis-functions-md.md) - All 17 analysis tools
+- [Generation Functions Guide](docs/generation-functions-md.md) - All 10 creation tools  
+- [Creative Functions Guide](docs/creative-functions-md.md) - Games and art tools
+- [System Functions Guide](docs/system-functions-md.md) - Utilities and diagnostics
+- [Complete User Guide](docs/user-guide-md.md) - Comprehensive usage manual
+
+## Recommended Setup
+
+**For Professional Development:**
+- **CPU**: 8-core or better (for local LLM processing)
+- **RAM**: 32GB (24GB for model, 8GB for development)
+- **Storage**: SSD with 100GB+ free space
+- **Model**: Qwen2.5-Coder-14B-Instruct or similar
+
+**Performance Tips:**
+- Use 13B+ parameter models for professional-quality results
+- Configure `LLM_MCP_ALLOWED_DIRS` to include your project directories
+- Install Desktop Commander MCP for complete file operation support
+- Keep LM Studio running and model loaded for instant responses
+
+## Version History
+
+### Version 1.0.0 (Current)
+- ✅ Complete function library (35+ functions)
+- ✅ Professional documentation system
+- ✅ WordPress-specific tools and auditing
+- ✅ Creative project generators
+- ✅ Comprehensive security analysis
+- ✅ TypeScript conversion and test generation
+- ✅ Cross-file integration analysis
+
+## License
+
+**MIT License** - Use this project freely for personal and commercial projects. See [LICENSE](LICENSE) for details.
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on:
+- Code standards and patterns
+- Testing requirements
+- Documentation updates
+- Issue reporting
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/houtini-ai/lm/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/houtini-ai/lm/discussions)
+- **Documentation**: Complete guides in the `docs/` directory
+
+---
+
+**Ready to supercharge your development workflow?** Install Houtini LM and start building amazing things with unlimited local AI assistance.
+
 *Built for developers who think clearly but can't afford to think expensively.*

package/dist/config.d.ts

@@ -22,21 +22,19 @@ export declare const fileProcessingLimits: {
 };
 /**
  * Model parameters for different operation types
+ * maxTokens now calculated dynamically by TokenCalculator based on context window
  */
 export declare const modelParameters: {
     analysis: {
         temperature: number;
-        maxTokens: number;
         topP: number;
     };
     generation: {
         temperature: number;
-        maxTokens: number;
         topP: number;
     };
     creative: {
         temperature: number;
-        maxTokens: number;
         topP: number;
     };
 };

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,eAAO,MAAM,MAAM,EAAE,MA6BpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;CAgB3B,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,eAAO,MAAM,MAAM,EAAE,MA6BpB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc;;;CAG1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;CAKhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAgB3B,CAAC"}

package/dist/config.js

@@ -6,9 +6,9 @@ export const config = {
     lmStudioUrl: process.env.LM_STUDIO_URL || 'ws://localhost:1234',
     modelName: process.env.LM_STUDIO_MODEL || 'auto',
     temperature: 0.1,
-    maxTokens: 2000,
+    // maxTokens removed - now calculated dynamically by TokenCalculator
     topP: 0.95,
-    timeout: 30000,
+    timeout: 120000, // Increased from 30s to 2 minutes for complex analysis
     maxFileSize: 200 * 1024 * 1024, // 200MB limit
     supportedFileTypes: [
         '.csv', '.json', '.txt', '.js', '.ts', '.py', '.md', '.log',
@@ -49,22 +49,23 @@ export const fileProcessingLimits = {
 };
 /**
  * Model parameters for different operation types
+ * maxTokens now calculated dynamically by TokenCalculator based on context window
  */
 export const modelParameters = {
     analysis: {
         temperature: 0.1,
-        maxTokens: 2000,
         topP: 0.95
+        // maxTokens removed - calculated dynamically
     },
     generation: {
         temperature: 0.3,
-        maxTokens: 4000,
         topP: 0.9
+        // maxTokens removed - calculated dynamically
     },
     creative: {
         temperature: 0.7,
-        maxTokens: 4000,
         topP: 0.9
+        // maxTokens removed - calculated dynamically
     }
 };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,qBAAqB;IAC/D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM;IAChD,WAAW,EAAE,GAAG;IAChB,SAAS,EAAE,IAAI;IACf,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAG,cAAc;IAC/C,kBAAkB,EAAE;QAClB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;QAC3D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;QAC3D,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;QAC1D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;KACzD;IAED,yBAAyB;IACzB,QAAQ,EAAE;QACR,kBAAkB,EAAE,IAAI;QACxB,wBAAwB,EAAE,IAAI;QAC9B,oBAAoB,EAAE,KAAK,EAAE,uCAAuC;QACpE,kBAAkB,EAAE,GAAG,EAAE,sCAAsC;QAC/D,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;QAC1F,YAAY,EAAE;YACZ,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC,WAAW;IAC/B,cAAc,EAAE,MAAM,CAAC,kBAAkB;IACzC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,8BAA8B;IAC3D,2BAA2B,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,yCAAyC;CACxF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE;QACR,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,IAAI;KACX;IACD,UAAU,EAAE;QACV,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,GAAG;KACV;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,GAAG;KACV;CACF,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,MAAM,GAAW;IAC5B,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,qBAAqB;IAC/D,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM;IAChD,WAAW,EAAE,GAAG;IAChB,oEAAoE;IACpE,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,MAAM,EAAE,uDAAuD;IACxE,WAAW,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,EAAG,cAAc;IAC/C,kBAAkB,EAAE;QAClB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;QAC3D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;QAC3D,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;QAC1D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;KACzD;IAED,yBAAyB;IACzB,QAAQ,EAAE;QACR,kBAAkB,EAAE,IAAI;QACxB,wBAAwB,EAAE,IAAI;QAC9B,oBAAoB,EAAE,KAAK,EAAE,uCAAuC;QACpE,kBAAkB,EAAE,GAAG,EAAE,sCAAsC;QAC/D,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;QAC1F,YAAY,EAAE;YACZ,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,MAAM;YACd,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;SAChB;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,MAAM,CAAC,WAAW;IAC/B,cAAc,EAAE,MAAM,CAAC,kBAAkB;IACzC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,8BAA8B;IAC3D,2BAA2B,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,yCAAyC;CACxF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE;QACR,WAAW,EAAE,GAAG;QAChB,IAAI,EAAE,IAAI;QACV,6CAA6C;KAC9C;IACD,UAAU,EAAE;QACV,WAAW,EAAE,GAAG;QAChB,IAAI,EAAE,GAAG;QACT,6CAA6C;KAC9C;IACD,QAAQ,EAAE;QACR,WAAW,EAAE,GAAG;QAChB,IAAI,EAAE,GAAG;QACT,6CAA6C;KAC9C;CACF,CAAC"}

package/dist/core/ThreeStagePromptManager.d.ts

@@ -2,38 +2,22 @@
  * 3-Stage Prompt Manager
  * Handles the breakdown of prompts into managed stages for optimal context usage
  */
-import { PromptStages, StageMetrics, ChunkedConversation } from '../types/prompt-stages.js';
+import { PromptStages, ChunkedConversation } from '../types/prompt-stages.js';
 export declare class ThreeStagePromptManager {
-    private contextLimit;
-    private safetyMargin;
-    constructor(contextLimit: number, safetyMargin?: number);
+    constructor();
     /**
-     * Estimate token count (rough approximation: 4 chars ≈ 1 token)
+     * Split data payload into chunks of specified size
+     * Now receives chunk size from TokenCalculator
      */
-    private estimateTokens;
-    /**
-     * Calculate stage metrics to determine available space for data
-     */
-    calculateStageMetrics(stages: PromptStages): StageMetrics;
-    /**
-     * Check if data payload needs chunking
-     */
-    needsChunking(stages: PromptStages): boolean;
-    /**
-     * Split data payload into appropriately sized chunks
-     */
-    chunkDataPayload(dataPayload: string, availableTokens: number): string[];
+    chunkDataPayload(dataPayload: string, maxChunkSize: number): string[];
     /**
      * Split a large section that doesn't fit in one chunk
      */
     private splitLargeSection;
     /**
      * Create a chunked conversation from prompt stages
+     * Now receives pre-calculated chunks from TokenCalculator
      */
-    createChunkedConversation(stages: PromptStages): ChunkedConversation;
-    /**
-     * Get metrics for debugging/logging
-     */
-    getDebugInfo(stages: PromptStages): any;
+    createChunkedConversation(stages: PromptStages, dataChunks: string[]): ChunkedConversation;
 }
 //# sourceMappingURL=ThreeStagePromptManager.d.ts.map

package/dist/core/ThreeStagePromptManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreeStagePromptManager.d.ts","sourceRoot":"","sources":["../../src/core/ThreeStagePromptManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE5F,qBAAa,uBAAuB;IAClC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAe;gBAEvB,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAY;IAK5D;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY;IAkBzD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAK5C;;OAEG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,EAAE;IAuDxE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;OAEG;IACH,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,mBAAmB;IAwCpE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,GAAG;CAcxC"}
+{"version":3,"file":"ThreeStagePromptManager.d.ts","sourceRoot":"","sources":["../../src/core/ThreeStagePromptManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAE9E,qBAAa,uBAAuB;;IAKlC;;;OAGG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAmDrE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;OAGG;IACH,yBAAyB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,mBAAmB;CA8B3F"}