From 979ae84f6b8dfad03506eeb9ca296486d5e0365e Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Sun, 8 Jun 2025 06:20:40 +0100
Subject: [PATCH] docs: Add release notes for v1.0.0-beta.19
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
---
 RELEASE_NOTES_BETA19.md | 47 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 RELEASE_NOTES_BETA19.md

diff --git a/RELEASE_NOTES_BETA19.md b/RELEASE_NOTES_BETA19.md
new file mode 100644
index 0000000..ebfd9c9
--- /dev/null
+++ b/RELEASE_NOTES_BETA19.md
@@ -0,0 +1,47 @@
+# Peekaboo MCP v1.0.0-beta.19 Release Notes
+
+## 🎉 What's New
+
+### Enhanced Error Handling & User Experience
+
+This release focuses on making Peekaboo more user-friendly by gracefully handling edge cases and providing more helpful error messages.
+
+### ✨ Features
+
+#### 1. Automatic Format Fallback for Invalid Values
+- When an invalid format is provided (empty string, null, or unrecognized format), Peekaboo now automatically falls back to PNG instead of returning an error
+- This makes the tool more resilient to incorrect inputs
+
+#### 2. Screen Capture Protection
+- Screen captures with `format: "data"` now automatically fall back to PNG format
+- This prevents "Maximum call stack size exceeded" errors that occur when trying to encode large screen images as base64
+- A helpful warning message explains why the fallback occurred
+- Application window captures can still use `format: "data"` without restrictions
+
+#### 3. Enhanced Error Messages for Ambiguous App Names
+- When multiple applications match an identifier (e.g., "C" matches Calendar, Console, and Cursor), the error message now lists all matching applications with their bundle IDs
+- Example error message:
+  ```
+  Image capture failed: Multiple applications match identifier 'C'. Please be more specific.
+  Matches found: Calendar (com.apple.iCal), Console (com.apple.Console), Cursor (com.todesktop.230313mzl4w4u92)
+  ```
+- This helps users quickly identify the correct application name to use
+- Applies to both `image` and `list` tools
+
+## 🐛 Bug Fixes
+- Fixed potential stack overflow when capturing screens with `format: "data"`
+- Improved error message clarity throughout the application
+
+## 📦 Installation
+
+```bash
+npm install -g @steipete/peekaboo-mcp@beta
+```
+
+Or with npx:
+```bash
+npx @steipete/peekaboo-mcp@beta
+```
+
+## 🙏 Thanks
+Thanks to all the beta testers for your feedback! Special thanks to @mattydebie for reviewing all these changes! 😊
\ No newline at end of file