OS AI v1.0.3

What's Changed

• docs: update CHANGELOG for v1.0.3 (91ee9d9)
• fix(ci): add libsecret-1-dev to Linux build dependencies (8828b7b)

v1.0.2 - Production Build Fixes

🐛 Bug Fixes

Production Build Issues Fixed

This release fixes critical issues that prevented the production build from launching.

What was broken in v1.0.1

• Production build (dist/OS AI.app) failed to start
• Flutter app was not found by launcher
• Error: "Flutter app not found, cannot start"

What's fixed in v1.0.2

✅ Flutter app now launches correctly in production build

• Updated launcher.py to search for the correct Flutter app name: OS AI.app (was: frontend_flutter.app)
• Updated packaging/launcher-macos.spec to bundle Flutter app using Tree() method instead of datas.append()
• This preserves the .app bundle structure and prevents PyInstaller from incorrectly processing executables

✅ Both modes now work

• Production mode (PyInstaller bundle): ✅ Working
• Development mode: ✅ Working

✅ Full functionality restored

• Backend server starts correctly
• Flutter frontend launches
• System tray integration works
• WebSocket communication established

---

📦 Installation

Download OS AI.app for macOS and run it.

First launch:

1. Right-click → Open (to bypass Gatekeeper)
2. Enter your Anthropic API key in Settings
3. Start chatting!

---

🔧 Technical Details

Files changed:

• launcher.py: Updated Flutter app paths for both production and development modes
• packaging/launcher-macos.spec: Changed from datas.append() to Tree() for proper .app bundling

Why Tree() instead of datas.append()?

• PyInstaller's datas.append() tries to process executables as binaries, which breaks code signatures
• Tree() preserves the entire directory structure without modification
• This is the correct approach for bundling macOS .app bundles

---

📝 Full Changelog

See CHANGELOG.md for complete details.

---

🤖 Generated with Claude Code

OS AI v1.0.0

What's Changed

• fix: remove missing version file reference from Windows spec (207dcb6)
• fix: remove Unicode symbols from PyInstaller spec files (ea74f79)
• fix: resolve macOS universal binary and Linux keybinder issues (1e48bbc)
• fix: add missing files for CI/CD builds (830f5da)
• fix: remove desktop-only code from web build (439b53e)
• fix: update Flutter version to 3.29.3 in all workflows (0cf0e9a)
• feat: add complete CI/CD system with unified desktop launcher (8ca6acd)
• fix: make clipboard paste test cross-platform (a9d01f8)
• fix: run only unit tests in CI to avoid flaky integration tests (c0edf67)
• fix: resolve 3 failing pytest tests on macOS (64b2ab4)

v0.2.0 - Multi-Chat Sessions & File Attachments

🎉 What's New in v0.2.0

Frontend Features

• Multi-Chat Sessions: Create and switch between multiple chat sessions, with automatic persistence using Hive
• Chat Sidebar: Visual chat list with title, message preview, and real-time usage stats
• File Attachments: Upload images via drag-drop or file picker with compression support
• Lightbox Viewer: Full-screen image viewer with zoom capabilities
• Usage Tracking: Per-chat token and cost tracking with detailed statistics screen
• Improved UI: Transparent backgrounds, smooth hover effects, and enhanced connection status indicator

Critical Bug Fixes

• Stop Button Fixed: Agent now correctly stops when clicking the stop button (resolved jobId mapping issue)
• Memory Leaks Eliminated: Proper cleanup of StreamControllers, subscriptions, and timers
• Thread Safety: Fixed race condition in JobManager with threading.Lock
• Better Error Handling: WebSocket errors now logged instead of crashing the app

Developer Experience

• Development Mode Guide: Comprehensive setup instructions for backend + frontend
• Fixed Build System: Corrected mono-repo installation paths in Makefile
• File Picker Support: Added macOS entitlements for proper file access

📋 Full Changelog

Added:

• Chat session management with Hive persistence
• File upload with image preview, compression, and progress tracking
• Usage statistics screen with per-chat breakdown
• Album view for displaying multiple images
• Lightbox for full-screen image viewing
• Hover effects on chat list items showing edit/delete buttons
• Connection status visual indicator (green/red/spinner)

Fixed:

• Stop button now correctly cancels running AI jobs
• Memory leaks in `ChatRepository` and `BackendWsClient`
• Race condition in `JobManager` (thread-safe dictionary operations)
• Double job removal bug in WebSocket handler
• File picker not opening on macOS due to missing entitlements
• Empty exception blocks now log errors properly

Changed:

• App branding from "OS AI Frontend" to "OS AI" across all platforms
• UI backgrounds now semi-transparent for modern aesthetic
• Connection status shows visual feedback (dot + spinner)
• Binary name on Windows changed to `os_ai.exe`

Developer:

• Added comprehensive Development Mode documentation
• Fixed `make dev-install` to use correct package paths
• Added macOS file access entitlements (user-selected and downloads)
• Improved error logging in backend event handlers

🚀 Getting Started

Quick Start

```bash

Install dependencies

make install
make dev-install

Start backend

export ANTHROPIC_API_KEY=sk-ant-...
os-ai-backend

Start frontend (new terminal)

cd frontend_flutter
flutter run -d macos
```

See Development Mode in README for detailed instructions.

📝 Notes

• This release includes changes to frontend state management
• Existing chat history from previous versions may not be preserved after upgrade
• macOS users: Rebuild required for file picker to work (`flutter clean && flutter run`)

🐛 Known Issues

• Orphaned background tasks continue after WebSocket disconnect (low priority)
• Album images require manual refresh in some cases

🙏 Built With

Claude Code