# Changelog

All notable changes to KimaAI are documented here.

## 1.4.9 - 2026-05-01

### Added

- Added Ollama provider support.
- Added OpenRouter provider support.
- Added PDF media embeddings support.
- Added custom embedding configuration controls.
- Added tabbed settings navigation in the admin UI.
- Added chatbot session retention cleanup controls.
- Added a dark theme for the settings UI.
- Added temperature, reasoning effort, and verbosity controls to AI Presets.
- Added automatic re-embedding when posts are published or updated.
- Added an extensible chatbot theme token system.

### Improved

- Updated Node packages and refreshed WordPress DataViews modal and actions usage in the admin UI.
- Improved the embedding sync modal with vector details and clearer bulk sync progress.
- Improved the admin theme toggle UI.

### Fixed

- Fixed chatbot REST requests on sites using plain permalinks.
- Fixed chatbot API error handling in both streaming and JSON modes.
- Fixed cascade feedback cleanup when deleting chatbot sessions.
- Fixed custom chatbot icon mode handling.
- Fixed dark theme styling issues in the settings UI.
- Fixed admin theme state synchronization across settings screens.

### Developer

- Added a Storybook workbench for admin and chatbot UI development.
- Refactored AI provider and chatbot request handling internals for better extensibility and testability.
- Extracted the vector database SDK into a dedicated package.

## 1.4.8 - 2026-04-06

### Added

- Added post type selection for chatbot content awareness.
- Added a raw AI request/response debugging panel to the chatbot history and feedback analysis dashboards.
- Added bulk delete action for chatbot history entries.
- Added copy-to-clipboard button for AI responses in the chatbot widget.
- Added avatar image support for both the AI and the user in chatbot settings.
- Added WooCommerce integration for product-aware chatbot answers.
- Added WooCommerce Product Recommendation tool to suggest relevant products based on user queries.
- Added WooCommerce Similar Products tool to surface products similar to a given product or query.
- Added WooCommerce Product Card tool to display product information in a visual card format within the chat.
- Added multilingual WooCommerce support for WPML and Polylang.

### Improved

- Improved feedback analysis dashboard to show related message, user information, and a debugging panel per entry.
- Improved export settings security by stripping sensitive data by default, with an opt-in to include it.
- Improved chatbot history readability by grouping messages into sessions.

### Fixed

- Fixed chatbot widget offset setting not displaying correctly in the settings dashboard.
- Fixed Qdrant query calls and results.
- Fixed layout issues with CodeMirror in the settings page.
- Fixed import/export preview settings panel height.
- Fixed minor chatbot API communication issues.

## 1.4.7 - 2026-03-13

### Added

- Added a KimaAI status report to the WordPress Site Health section for easier troubleshooting.
- Added a log level setting to control plugin log verbosity.

### Changed

- Restricted content awareness to published, public posts and pages only.
- Updated default chatbot instructions for easier out-of-box configuration.

### Fixed

- Fixed styling issues in the chatbot widget and settings page.
- Fixed `rest_cookie_invalid_nonce` error for non-logged-in users when a caching plugin is active.
- Fixed chatbot input sanitization to prevent XSS vulnerabilities.

## 1.4.6 - 2026-03-06

### Added

- Added export/import settings feature for easier backup and migration of plugin configurations.

### Fixed

- Fixed test connection to ensure a default collection named after the domain is created.
- Fixed minor styling issues in the settings page and chatbot widget.

## 1.4.5 - 2026-02-23

### Added

- Added "open link" action type for quick actions.

### Changed

- Centralized sanitization and validation logic for all settings fields.
- Simplified the playground chat hook to avoid mutating settings state.

### Fixed

- Fixed sticky positioning behavior in the settings field renderer.

## 1.4.4 - 2026-02-20

### Added

- Added loading/typing indicators for quick actions while they are being fetched.

### Improved

- Improved chatbot greeting field to support HTML formatting.

### Fixed

- Fixed feedback buttons appearing on the latest bot message while it is still streaming.
- Fixed various minor styling issues (popover width, font sizes).

## 1.4.3 - 2026-02-19

### Added

- Added smooth scrolling to the feedback textarea when users select thumbs-down feedback.
- Added send-on-Enter keyboard support in the chatbot widget.

### Fixed

- Fixed embedding bulk sync issues.
- Fixed chatbot widget UI and UX issues.
- Fixed quick action button triggering before GDPR consent is accepted.
- Fixed full-screen mode on mobile screen sizes.
- Fixed textarea caret position after a quick action prefills the input.
- Fixed feedback textarea background color in active state.

## 1.4.2 - 2026-02-09

### Added

- Added multilingual embedding support.
- Added "Powered by KimaAI" branding to the chatbot footer.

### Changed

- Replaced legacy embedding presets with the new embedding environment configuration.

### Fixed

- Fixed embedding bulk sync issues.

### Developer

- Added `kimaai_chatbot_should_load` hook to allow or deny chatbot loading based on custom logic.

## 1.4.1 - 2026-02-04

### Added

- Added reasoning effort and verbosity controls for reasoning models.
- Added streaming support for chatbot responses.

### Changed

- Refactored chatbot class and UI code structure for better maintainability.

## 1.4.0 - 2026-01-30

### Added

- Added setup wizard for first-time configuration.
- Added chatbot feedback mechanism to collect user ratings on responses.
- Added vector database search tool for the chatbot.
- Added translatable dynamic settings via Polylang and WPML.
- Added configurable quick actions to the chatbot interface.
- Added an attention popover displayed before the chatbot opens for the first time.

### Fixed

- Fixed fatal error when `mb_strcut` is not available on the server.
- Fixed playground with updated API endpoints.
- Fixed content awareness in Gutenberg editor content.
- Fixed chatbot widget visual issues.

### Changed

- Refactored AI-related classes for improved maintainability.
- Refactored settings API.

### Developer

- Added `kimaai_tools_registry` filter to register custom tools.
- Added `kimaai_tool_call_allowed` filter to allow or deny tool calls based on custom logic.
- Added `kimaai_tool_execute` action triggered on tool execution.

## 1.3.9 - 2025-12-15

### Changed

- Separated the internal link suggestions feature into its own add-on.
- Increased AI call timeout to 300 seconds.

### Fixed

- Fixed initial save behavior for dependent settings options.

## 1.3.7 - 2025-12-13

### Added

- Added chatbot preview in the settings page.
- Added add-on API for third-party integrations.
- Added vector database support for the chatbot and AI Assistant.

### Changed

- Updated Freemius WP SDK to version 2.13.0.
- Updated all Node.js dependencies to their latest versions.

### Fixed

- Fixed function calling using the wrong setting ID and hook.
- Fixed pro features to use proper dependency injection architecture.
- Fixed third-party plugin admin notices appearing on the KimaAI settings page.

## 1.3.6

### Added

- Added support for GPT-5 models.

## 1.3.5

### Added

- Added support for `gpt-image-1` model arguments in the image playground.

### Changed

- Refactored DI container registration and code structure for better maintainability.

### Developer

- Added `kimaai_chatbot_theme` filter for customizing chatbot theme colors.
- Added `kimaai_chatbot_prompt` filter for modifying the prompt before sending to AI.
- Added `kimaai_chatbot_gate` filter to allow or deny chatbot messages (`kimaai_chatbot_allowed` is now deprecated).
- Added `kimaai_chatbot_blocked` action triggered when a message is blocked by the gate.
- Added `kimaai_chatbot_rate_limited` action triggered when a message is rate limited.
- Added `kimaai_chatbot_tools_registry` filter to customize the chatbot tools registry.
- Added `kimaai_chatbot_ai_payload` filter to customize the AI request payload before sending.
- Added `kimaai_chatbot_before_request` action triggered before sending a request to the AI service.
- Added `kimaai_chatbot_response_payload` filter to customize the AI response payload before processing.
- Added `kimaai_chatbot_after_response` action triggered after receiving the AI response.
- Added `kimaai_chatbot_default_tools` filter to customize the default chatbot tools.

## 1.3.4

### Added

- Added date and time picker field to the settings page.

### Fixed

- Fixed TextareaField to support the `isComingSoon` state.
- Fixed ToggleField to correctly pass extra props.
- Fixed settings option save and load behavior.
- Fixed loading of the WooCommerce Action Scheduler package.

## 1.3.3

### Added

- Added function calling support for the chatbot (Pro feature).

### Changed

- Updated Freemius WP SDK to version 2.12.2.

### Fixed

- Fixed WordPress Playground test compatibility.
- Fixed responsive layout issue on smaller screens in the settings page.
- Fixed pro feature badge display in the settings page.

## 1.3.2

### Added

- Added 4 new chatbot icon options.
- Added Markdown rendering support in the chatbot.
- Added custom chatbot icon support (Pro feature).
- Added custom chatbot widget offset support (Pro feature).

### Fixed

- Fixed SelectField not showing the premium-only message for Pro features.
- Fixed empty repeatable fields being saved incorrectly.

## 1.3.1

### Added

- Added embedding indexing support (Pro feature).

## 1.3.0

### Added

- Added the ability to show or hide API keys in text fields for better security.

## 1.2.9

### Fixed

- Fixed max message limit to be based on IP address instead of session ID.
- Fixed chatbot position in RTL mode.
- Fixed Persian translation strings.

## 1.2.8

### Fixed

- Fixed chatbot styling issues in RTL mode.

## 1.2.7

### Fixed

- Fixed build script in `package.json`.

## 1.2.6

### Fixed

- Fixed build script in `package.json`.

## 1.2.5

### Added

- Added Persian language and RTL layout support.
- Added GDPR consent setting for the chatbot.
- Added content awareness feature for the chatbot.
- Added clear history button with an in-button loading indicator.
- Added banned words moderation option.
- Added banned IPs moderation option.
- Added API key connection test from the settings page.
- Added WP admin notices, including a "no API key" notice.
- Added reset-to-default option for the color picker setting.
- Added disclaimer text, also shown in the chatbot footer.
- Added support for the `gpt-image-1` model in AI Image.

### Improved

- Redesigned and reorganized the settings page for better UX.
- Improved chatbot and icon position settings layout.

### Changed

- Refactored `AiService` for improved robustness.

### Fixed

- Fixed repeatable fields deletion issue.
- Fixed conflict between chatbot setting fields.
- Fixed chatbot spacing when positioned on the left in full-screen mode.
- Fixed "Test connection" button colors for different states.

### Removed

- Removed legacy and unused code.

## 1.2.4

### Fixed

- Fixed Freemius SDK integration conflict between the free and premium versions.

## 1.2.3

### Added

- Added Freemius SDK integration for the Pro version.
- Added support for reasoning models (o3/o4) in the chatbot.
- Added full-screen mode for the chatbot widget.
- Added maximum chatbot message count setting.
- Added maximum input length setting for the chatbot.
- Added maximum context length setting for content awareness.
- Added ability to order settings tabs via an `order` key in the schema.
- Added `save_key` support to store options in separate database keys.
- Added image history search and JSON beautify in the playground.

### Improved

- Improved AI call pipeline for simplicity and reliability.
- Improved request logging to correctly handle Persian and Arabic text.

### Fixed

- Fixed plugin ZIP script compatibility with the WP Deploy GitHub Action.
- Fixed `kimaai-settings` element not present in the DOM.
- Fixed admin menu icon display on submenu pages.
- Fixed chatbot width on smaller screens.
- Removed unwanted border on the chatbot trigger button with the WordPress 2025 theme.

## 1.2.2

### Added

- Added test mode API for OpenAI Chat Completions and Responses endpoints.
- Added initial chatbot test suite.
- Added logger class and backend log-file viewer.
- Added selectable AI provider and model in chatbot settings.
- Added full color customization options for the chatbot.

### Fixed

- Fixed default AI engine selection for the auto-article feature.
- Fixed frontend and admin test failures.
- Fixed log menu ordering and "Target container is not a DOM element" errors.
- Fixed log file viewer color and layout issues.
- Fixed chatbot styling issues with Tailwind v4.
- Fixed settings save regressions.

### Changed

- Migrated chatbot styles from SCSS to plain CSS.

### Developer

- Added trigger-button JS hook and settings-extension filter.

## 1.2.1

### Changed

- Tested with WordPress 6.8.

## 1.2.0

### Added

- Added AI Playground.
- Added the ability to change the chatbot model.
- Added image generation support with DALL-E and Replicate.

## 1.1.2

### Added

- Added Persian font to the admin settings page.

## 1.1.1

### Added

- Translated the plugin into Persian.

## 1.1.0

### Added

- Added chatbot content awareness feature.

## 1.0.9

### Fixed

- Fixed chatbot position issue.

## 1.0.8

### Changed

- Updated the plugin title.

## 1.0.7

### Added

- Added the ability to change the chatbot position.

## 1.0.6

### Added

- Added the ability to change the chatbot icon.

### Improved

- Improved the Save Changes button in the admin settings page.

### Fixed

- Fixed various minor issues.

## 1.0.5

### Added

- Added the ability to disable the chatbot.
- Added `[kimaai_chatbot]` shortcode.
- Added RTL layout support.

### Fixed

- Fixed various issues and improved performance.

## 1.0.4

### Fixed

- Fixed plugin contributors metadata.

## 1.0.3

### Fixed

- Fixed plugin tag issue.

## 1.0.2

- Official release on WordPress.org.

## 1.0.1

### Fixed

- Fixed issues reported via the official WordPress support forum.

## 1.0.0

- Initial release.
