diff --git a/README.md b/README.md index 6425541..e802f85 100755 --- a/README.md +++ b/README.md @@ -73,7 +73,8 @@ The API is currently in a transitional state between legacy (V1/V2) patterns and - [Unified Agent Arch](documentation/ARCH__UNIFIED_AGENT.md): Vision for cross-stack AI agent awareness. ### **Integration Guides** -- [V3 Frontend API Guide](documentation/GUIDE__V3_FRONTEND_API.md): How to use the V3 CRUD and Search endpoints. +- [V3 Frontend API Guide](documentation/GUIDE__AE_API_V3_for_Frontend.md): How to use the V3 CRUD, Search, and Action endpoints. +- [V3 Frontend Websockets Guide](documentation/GUIDE__AE_API_V3_for_Frontend_websockets.md): Websocket integration patterns. - [Frontend Code Samples](documentation/FRONTEND_API_SAMPLES.md): TypeScript snippets for common API calls. ### **Security** diff --git a/documentation/TODO__Agents.md b/documentation/TODO__Agents.md index 7d9d611..726126e 100644 --- a/documentation/TODO__Agents.md +++ b/documentation/TODO__Agents.md @@ -56,6 +56,14 @@ - [ ] **Lookup System Batch 2:** Migration of `post_topic`, `user_status`, `file_purpose`. - [ ] **Zoom Events Integration:** Implement cron synchronization for OAuth2 ticket retrieval. +## 📝 Session Notes (March 11, 2026) +- **Media Methods Hardened:** `clip_video_method` and `convert_file_method` in `app/methods/lib_media.py` updated with improved error logging, PDF validation, and guaranteed temp-file cleanup. +- **V3 Action Migration:** `clip_video` endpoint promoted from legacy `hosted_file` router to V3 action (`/v3/action/hosted_file/{id}/clip_video`). Legacy route now issues a `307` redirect for backward compatibility. +- **Background Scheduling:** `clip_video` V3 action supports `?background=true` (returns `202 Accepted`), enabling async clipping for large files. +- **Robust Deletion:** `delete_file_action` unlink wrapped in `try/except OSError` — filesystem errors are now logged and non-fatal. +- **Unit Tests Added:** `tests/unit/test_unit_media_methods.py` covers `clip_video_method` and `convert_file_method` with full async mocking. +- **Docs Renamed & Updated:** `GUIDE__V3_FRONTEND_API.md` → `GUIDE__AE_API_V3_for_Frontend.md`; `GUIDE__V3_FRONTEND_WEBSOCKETS.md` → `GUIDE__AE_API_V3_for_Frontend_websockets.md`. Frontend guide updated with V3 action paths, background scheduling notes, and correct example URLs. + ## 📝 Session Notes (March 10, 2026) - **Unified Stack:** Merged API orchestration into the master environment. - **Root Assets:** Docker assets are now part of this git repo again.