v1.4.0 - Project ID Mapping & Model Configuration

🎉 Major Features

📁 Project ID Mapping

Map short, memorable project IDs to workspace paths for easier API calls.

Key Features:

• ✅ Web management UI at /manage
• ✅ Auto-generated unique IDs (10 characters)
• ✅ Full CRUD API for project management
• ✅ Persistent storage in ~/.cursor-agent-a2a/projects.json
• ✅ URL parameter support: POST /messages/:projectId

Example:
```bash

Create project mapping

curl -X POST "http://localhost:4937/projects" \
-H "Authorization: Bearer your-api-key" \
-d '{"name": "My Project", "workspace": "/path/to/project"}'

Use project ID (much simpler!)

curl -X POST "http://localhost:4937/messages/abc123xyz" \
-H "Authorization: Bearer your-api-key" \
-d '{"message": "Hello"}'
```

🤖 Model Configuration

Choose which Cursor model to use for each request.

Available Models:

• 💎 Claude 4.5 Sonnet (default) - Balanced performance
• 🧠 Claude 4.5 Opus - Most capable
• 💻 GPT-5.2 Codex - Code-optimized
• ⚡ Gemini 3 Flash - Fast responses
• And many more...

Configuration Methods:

1. Per-request (highest priority):
   ```json
   {"message": "Hello", "model": "sonnet-4.5"}
   ```

2. Environment variable:
   ```bash
   export CURSOR_DEFAULT_MODEL=sonnet-4.5
   ```

3. System default: sonnet-4.5 (fallback)

🔧 Enhanced Cursor CLI Integration

• Auto-discovers Cursor CLI location
• No manual PATH configuration required
• Works out-of-the-box on macOS

📚 Documentation

• CHANGELOG.md - Complete version history
• EXAMPLES.md - Practical usage examples
• README.md - Updated with new features

🔄 Migration from v1.3.x

No Breaking Changes! All existing API calls work as before.

New Features to Try:

1. Visit http://localhost:4937/manage to set up project mappings
2. Add "model": "sonnet-4.5" to your requests
3. Set CURSOR_DEFAULT_MODEL environment variable

📦 Installation

```bash

Update to latest version

npm update -g cursor-agent-a2a

or

pnpm update -g cursor-agent-a2a

Restart service

cursor-agent-a2a restart
```

🐛 Bug Fixes

• Fixed "Cursor command not found" error with auto-discovery
• Resolved Opus slow pool quota issues by defaulting to Sonnet

🙏 Acknowledgments

Thanks to all users who requested these features and provided feedback!

---

Full Changelog: v1.3.1...v1.4.0