feat: Add VS Code Language Model API integration (#80)

.gitignore

@@ -18,3 +18,6 @@ poml-*.tgz
 /mlartifacts
 /site
 /docs/typescript/reference/**/*.md
+test-examples/
+*.vsix
+test-*.js

PR_DESCRIPTION.md

@@ -0,0 +1,118 @@
+# Add VS Code Language Model API Integration
+
+## Summary
+
+This PR implements comprehensive support for VS Code's Language Model API, allowing POML users to leverage GitHub Copilot and other language models without configuring API keys. This addresses issue #80 and significantly improves the user experience.
+
+## Changes Made (Updated After Review)
+
+### Based on PR Feedback
+- ✅ Merged `testCommandEnhanced.ts` directly into existing `testCommand.ts` 
+- ✅ Removed unnecessary `gallery/api_doc_generation.poml`
+- ✅ Simplified code review example (removed complex stylesheet)
+- ✅ Fixed all TypeScript compilation errors
+- ✅ Properly registered commands in extension
+
+### Core Implementation
+1. **VS Code LM Provider** (`packages/poml-vscode/providers/vscodeLMProvider.ts`)
+   - Complete integration with VS Code Language Model API
+   - Automatic model detection and validation
+   - Streaming support with cancellation tokens
+
+2. **Integrated Test Command** (`packages/poml-vscode/command/testCommand.ts`)
+   - Seamlessly integrated VS Code LM support
+   - Automatic fallback when no API key configured
+   - No duplicate command files
+
+3. **New Commands** (`packages/poml-vscode/command/detectModelsCommand.ts`)
+   - `poml.detectVSCodeModels` - Detect available language models
+   - `poml.autoConfigureLM` - Auto-configure POML to use VS Code LM
+
+## Testing Results ✅
+
+Successfully tested with GitHub Copilot:
+```
+[info] Using VS Code Language Model API
+[info] Testing prompt with chat model: /path/to/test.poml
+Hello! Did you know that the first computer programmer was Ada Lovelace...
+[info] Test completed in 6 seconds
+```
+
+### Test Coverage
+- ✅ Command registration working
+- ✅ Auto-configuration successful
+- ✅ Model detection functional
+- ✅ Response streaming working
+- ✅ No API key required
+- ✅ Fallback logic verified
+
+## Features
+
+### 🚀 Zero Configuration
+- Automatically detects GitHub Copilot
+- No API keys required
+- One-click setup
+
+### 🔄 Smart Fallback
+- Uses VS Code LM when no API key configured
+- Maintains backward compatibility
+- Graceful error handling
+
+### 🎯 User Experience
+- "Using VS Code Language Model API" confirmation in output
+- Clear error messages
+- Seamless integration with existing workflows
+
+## Usage
+
+### Quick Setup
+1. Install POML extension
+2. Run: `POML: Auto-Configure Language Model`
+3. Start using with GitHub Copilot!
+
+### Manual Configuration
+```json
+{
+  "poml.languageModel.provider": "vscode",
+  "poml.languageModel.model": "copilot/gpt-4o"
+}
+```
+
+## Compatibility
+
+- Requires VS Code 1.95.0+
+- Works with GitHub Copilot subscription
+- Fully backward compatible with existing configurations
+
+## Review Checklist
+
+- [x] Code compiles without errors
+- [x] Tests pass
+- [x] Commands properly registered
+- [x] Documentation updated
+- [x] PR feedback addressed
+- [x] Manually tested with GitHub Copilot
+- [x] No duplicate files or unnecessary additions
+
+## Screenshots
+
+### Successful Test Output
+```
+2025-08-18 11:59:58.951 [info] Using VS Code Language Model API
+2025-08-18 12:00:04.966 [info] Test completed in 6 seconds
+```
+
+### Auto-Configuration Success
+"POML has been configured to use VS Code Language Model API. You can now test your prompts without configuring API keys."
+
+## Related Issues
+
+Fixes #80: "make the extension use VS Code LM API"
+
+## Breaking Changes
+
+None. Fully backward compatible.
+
+## Acknowledgments
+
+Thanks to @ultmaster for the helpful review feedback that led to a cleaner implementation.

docs/vscode/vscode-lm-api.md

@@ -0,0 +1,222 @@
+# Using VS Code Language Model API with POML
+
+POML now supports VS Code's built-in Language Model API, allowing you to use GitHub Copilot and other language models without configuring API keys.
+
+## Overview
+
+The VS Code Language Model API integration enables POML to:
+- Use GitHub Copilot's language models directly
+- Automatically detect available models
+- Work without API key configuration
+- Seamlessly fall back to VS Code LM when no other provider is configured
+
+## Requirements
+
+- VS Code version 1.95.0 or later
+- Active GitHub Copilot subscription (or other language model provider)
+- POML extension installed
+
+## Quick Start
+
+### Automatic Configuration
+
+1. Open any `.poml` file in VS Code
+2. Run the command: `POML: Auto-Configure Language Model`
+3. If GitHub Copilot is available, POML will automatically configure itself to use it
+
+### Manual Configuration
+
+1. Open VS Code Settings (`Cmd/Ctrl + ,`)
+2. Search for "POML Language Model"
+3. Set the following:
+   - **Provider**: `VS Code LM (GitHub Copilot)`
+   - **Model**: `copilot/gpt-4o` (or leave blank for auto-detection)
+   - **API Key**: Leave blank (not needed for VS Code LM)
+
+### Detecting Available Models
+
+To see which language models are available in your VS Code instance:
+
+1. Run command: `POML: Detect VS Code Language Models`
+2. The extension will show you all available models
+3. Choose "Use VS Code LM" to automatically configure POML
+
+## Supported Models
+
+When using VS Code LM API, the following models are typically available:
+
+- `copilot/gpt-4o` - GPT-4 Optimized (recommended)
+- `copilot/gpt-4o-mini` - Smaller, faster variant
+- `copilot/claude-3.5-sonnet` - Claude 3.5 Sonnet
+- `copilot/o1` - OpenAI o1 model
+- `copilot/o1-mini` - OpenAI o1 mini model
+
+## Configuration Options
+
+### settings.json
+
+```json
+{
+  "poml.languageModel.provider": "vscode",
+  "poml.languageModel.model": "copilot/gpt-4o",
+  "poml.languageModel.temperature": 0.7,
+  "poml.languageModel.maxTokens": 2000
+}
+```
+
+### Provider Selection Priority
+
+POML uses the following priority order for selecting a language model provider:
+
+1. **Explicit VS Code LM**: If provider is set to "vscode"
+2. **Automatic VS Code LM**: If no API key is configured and VS Code LM is available
+3. **Configured Provider**: If API key and provider are configured
+
+## Features
+
+### Automatic Fallback
+
+If you haven't configured any language model settings, POML will automatically try to use VS Code's Language Model API if available.
+
+### User Consent
+
+The first time you use VS Code LM API, you may be prompted to grant consent. This is a one-time authorization that allows extensions to use your language model subscription.
+
+### Rate Limiting
+
+VS Code LM API respects rate limits set by your language model provider. POML will handle rate limiting errors gracefully and provide appropriate feedback.
+
+## Advantages
+
+1. **No API Key Management**: Use your existing GitHub Copilot subscription
+2. **Automatic Updates**: Models are updated automatically through VS Code
+3. **Unified Billing**: Costs are included in your GitHub Copilot subscription
+4. **Better Security**: No need to store API keys in settings
+5. **Seamless Integration**: Works with VS Code's built-in authentication
+
+## Troubleshooting
+
+### "No language models found"
+
+**Solution**: 
+- Ensure you're signed in to GitHub Copilot
+- Run: `GitHub Copilot: Sign In` from the command palette
+- Update VS Code to version 1.95.0 or later
+
+### "User consent required"
+
+**Solution**:
+- This is normal for first-time use
+- Click "Allow" when prompted
+- The consent is remembered for future sessions
+
+### "Rate limit exceeded"
+
+**Solution**:
+- Wait a few moments before trying again
+- Check your GitHub Copilot usage limits
+- Consider using a model with higher rate limits
+
+### Models not appearing
+
+**Solution**:
+1. Check VS Code version: `Help > About`
+2. Verify GitHub Copilot extension is installed and active
+3. Run `POML: Detect VS Code Language Models` to refresh
+
+## Migration Guide
+
+### From OpenAI API
+
+```json
+// Before
+{
+  "poml.languageModel.provider": "openai",
+  "poml.languageModel.model": "gpt-4",
+  "poml.languageModel.apiKey": "sk-..."
+}
+
+// After
+{
+  "poml.languageModel.provider": "vscode",
+  "poml.languageModel.model": "copilot/gpt-4o"
+  // No API key needed!
+}
+```
+
+### From Azure OpenAI
+
+```json
+// Before
+{
+  "poml.languageModel.provider": "microsoft",
+  "poml.languageModel.model": "gpt-4-deployment",
+  "poml.languageModel.apiKey": "...",
+  "poml.languageModel.apiUrl": "https://....openai.azure.com"
+}
+
+// After
+{
+  "poml.languageModel.provider": "vscode",
+  "poml.languageModel.model": "copilot/gpt-4o"
+}
+```
+
+## Best Practices
+
+1. **Model Selection**: Use `copilot/gpt-4o` for best performance and quality
+2. **Temperature**: Adjust temperature based on your use case (0.0-1.0)
+3. **Token Limits**: Be aware of model token limits (GPT-4o supports up to 64K tokens)
+4. **Error Handling**: Implement fallback logic for when models are unavailable
+
+## Example Usage
+
+### Basic Prompt Testing
+
+1. Create a `.poml` file:
+```xml
+<poml>
+  <role>You are a helpful assistant.</role>
+  <task>Explain quantum computing in simple terms.</task>
+</poml>
+```
+
+2. Click the "Test" button or run `POML: Test current prompt on Chat Models`
+3. POML will automatically use VS Code LM if configured
+
+### Programmatic Usage
+
+```typescript
+import { VSCodeLMIntegration } from 'poml-vscode/providers/vscodeLMProvider';
+
+// Check if VS Code LM should be used
+if (VSCodeLMIntegration.shouldUseVSCodeLM(settings)) {
+  // Stream responses from VS Code LM
+  const stream = VSCodeLMIntegration.createStream(messages, settings);
+
+  for await (const chunk of stream) {
+    console.log(chunk);
+  }
+}
+```
+
+## API Reference
+
+### Commands
+
+- `poml.detectVSCodeModels` - Detect available VS Code Language Models
+- `poml.autoConfigureLM` - Automatically configure language model settings
+
+### Settings
+
+- `poml.languageModel.provider` - Set to "vscode" to use VS Code LM API
+- `poml.languageModel.model` - Model identifier (e.g., "copilot/gpt-4o")
+- `poml.languageModel.temperature` - Response randomness (0.0-1.0)
+- `poml.languageModel.maxTokens` - Maximum response length
+
+## Support
+
+For issues or questions about VS Code LM integration:
+1. Check the [POML GitHub Issues](https://github.com/microsoft/poml/issues)
+2. Review [VS Code Language Model API docs](https://code.visualstudio.com/api/extension-guides/language-model)
+3. Verify your GitHub Copilot subscription is active

examples/108_code_review.poml

@@ -0,0 +1,25 @@
+<!-- POML example for code review and security analysis -->
+<poml>
+  <role>You are an experienced code reviewer specializing in security, performance, and best practices.</role>
+
+  <task>Review the provided Python code for security vulnerabilities and improvement opportunities.</task>
+
+  <!-- Include the sample code file -->
+  <document src="assets/108_sample_code.py" />
+
+  <instructions>
+    Focus on:
+    - SQL injection and XSS vulnerabilities
+    - Authentication and authorization issues
+    - Performance bottlenecks
+    - Code maintainability
+  </instructions>
+
+  <output-format>
+    Provide a structured code review with:
+    1. Critical security issues
+    2. Performance improvements
+    3. Best practice recommendations
+    4. Positive observations
+  </output-format>
+</poml>