3.14.3 Release Notes

3.14.3 Release Notes#

Squirro 3.14.3 was released on October 17, 2025.

Learn more about the Squirro Release Process.

Notes for administrators

  • This release introduces important changes that may require adjustments to your existing setup. Learn more

What’s New#

  • Dedicated “Chat with Item” Agent: Added a dedicated “Chat with Item” agent type, allowing configuration of Chat with Item behavior in the same user interface as other agents. Chat with Item keeps static item context in LLM memory (e.g., first 100 pages plus summary). This static context is configurable via the default_tools of the Chat with Item Agent. During conversation, if information is missing, the paragraph-retriever is selectively triggered to load information on demand.

  • Squirro Chat Model Update: Changed default GPT model to 4.1 instead of 4o for general purpose use.

Improvements#

AI#

  • MCP Tool Error Handling: MCP tool errors (e.g., invalid parameters) are now converted to error messages that the agent can process and respond to, instead of showing red popup errors and halting execution. Graceful error handling is now the default for MCP tools.

  • MCP Header Templating: Added MCP header templating with user context injection for dynamic authentication.

  • Extended Context Control: Added project-level configuration flag genai.sqgpt.disable-extended-context to optionally disable extended context. Graceful handling of projects without extended context configuration (defaults to enabled).

  • Citation Formatting: Exposed project settings to define how citations should be formatted. Two different citation prompts are available: genai.sqgpt.citation-format-multi for general chat and genai.sqgpt.citation-format-single for chat with single item.

  • Persona Length Increase: Increased maximum length of persona value from 2000 to 4000 characters (excluding whitespace).

  • Improved Chat Context: Agents now receive complete multi-turn conversation history with full action details for better context awareness. Automatic population of simple chat_history from extended_chat_history maintains backward compatibility.

  • Enhanced Prompt Library: Added project_id field to PromptPublic response schema for better API transparency. Enhanced access control ensures only project admins can modify project-scoped prompts.

  • Stabilized Inline Citation: Improved inline citation and page navigation, citing relevant text snippets and jumping to the relevant page (e.g., “Elasticsearch Configuration / Page 44”).

  • Text Fragment Highlighting: Text fragments passed by LLM for chat source references are now highlighted for better visual guidance.

  • Custom Thinking Events: Added support for custom thinking events in LangChain event streams for better insight into agent reasoning processes.

  • Chat Widget Configuration: Added config option to Chat Widget to disable admin welcome dialog.

  • Chat History Metadata: Added metadata field to chat history conversations for storing frontend-specific context per turn, improving conversation tracking and analysis.

Bug Fixes#

  • Item Retrieval: Removed faulty de-hyphenation logic that was breaking items retrieval.

  • Prompt Library Scoping: Fixed prompts API to properly scope prompts by project_id, preventing cross-project prompt leakage.

  • GenAI Plugin Dependencies: Fixed force-install of GenAI plugin dependencies by passing ignore_installed flag when installing dependencies for asset types requiring clean installation.

  • PostgreSQL Compatibility: Fixed PostgreSQL compatibility issue in prompt library.

  • Squirro Chat UI: Fixed chat with document being pushed down in item detail sidebar.

  • Project Import: Fixed project import functionality when the workspaces feature is enabled.

Known Issues#

  • Generating new item summaries via the sidebar on the item view is not working.

  • In specific scenarios, cross-lingual information retrieval for semantic search may deliver lower-than-expected quality (SQ-28171).

  • When closing the Project Configuration dialog in the chat dashboard, a “Discard changes” modal may appear even when no changes were made (SQ-29386).

Breaking Changes#

  • Prompts API Routes Updated: Updated prompts API routes from /prompts to /projects/{project_id}/prompts. All endpoints now require project_id as a path parameter. Removed project_id field from PromptCreate request body (now passed as URL parameter).

  • Available Tools Endpoint Updated: Updated available_tools endpoint to include project_id as a path parameter (/projects/<project_id>/available_tools instead of /available_tools).

  • Chat History Compression: Chat history is now stored compressed in Redis. Older genai_proxy studio plugin versions cannot read compressed data. Rolling back requires running the decompress tool first.

Installation and Upgrade#

For new installations, find step-by-step instructions on the Install and Manage Squirro with Ansible page (recommended) and Installing Squirro on Linux pages.

To upgrade an existing installation, see the Upgrading Squirro page.


Contents