What's Changed

• feat(agent): add offset and absolute position to click, type and move… by @programminx-askui in https://github.com/askui/vision-agent/pull/174
• Fix python 3 14 by @programminx-askui in https://github.com/askui/vision-agent/pull/177
• Feat/chat migrate persistence by @adi-wan-askui in https://github.com/askui/vision-agent/pull/179

🚀 Features

• Offset and Absolute Positioning: Enhanced the click(), type(), and mouse_move() methods with more precise positioning capabilities:

• Offset Parameter: Added offset parameter to fine-tune click and mouse positions relative to a target element ```python # Click 10 pixels right and 5 pixels up from "Submit" button agent.click("Submit", offset=(10, -5))

  Move mouse 5 pixels right and 10 pixels down from "Menu"

  agent.mouse_move("Menu", offset=(5, 10))

  Type text in input field with offset

  agent.type("text", locator="Input field", offset=(5, 0)) * **Absolute Coordinates**: Added support for `Point` tuples to specify exact screen coordinatespython

  Click at absolute coordinates (100, 200)

  agent.click((100, 200))

  Move cursor to absolute coordinates (300, 150)

  agent.mouse_move((300, 150))

  Click at coordinates then type

  agent.type("username", locator=(200, 100)) ``` * Offset coordinates follow screen conventions: positive x moves right, negative x moves left, positive y moves down, negative y moves up

• SQLite Database Migration: Migrated chat persistence layer from JSON files to SQLite database for improved performance, reliability, and scalability:

• Automatic Migrations: Database migrations run automatically on startup by default (configurable via ASKUI__CHAT_API__DB__AUTO_MIGRATE)
• Migrated Components:
  • Assistants configuration
  • Messages, runs, and threads
  • File storage metadata
  • MCP (Model Context Protocol) configurations
• Migration Framework: Added Alembic for database schema versioning and migrations
• Backwards Compatibility: Original JSON files are preserved during migration, allowing easy rollback by installing an older version
• Migration Documentation: Comprehensive documentation added in docs/migrations.md covering:
  • Migration strategy and execution flow
  • Manual migration commands
  • Troubleshooting and best practices
  • Database configuration options

• Migration Commands: ```bash # Run all pending migrations pdm run alembic upgrade head

  Show current migration status

  pdm run alembic current

  Disable auto-migration for debugging

  export ASKUI__CHAT_API__DB__AUTO_MIGRATE=false ```

🐛 Bug Fixes

• Python 3.13 Support: Updated maximum Python version requirement to 3.13 as version 3.14 is not yet supported

Full Changelog: https://github.com/askui/vision-agent/compare/v0.21.1...v0.22.0