Skip to content

Changelog

All notable changes to the ModernPath Agents Framework are documented here. Both @modernpath/agent-framework and @modernpath/agent-ui-react follow the same versioning scheme and are released together.

0.1.27

Released: 2026-02-25

Added

  • RAG mode enhancements -- RetrievalService now supports configurable query strategies (llm-summary, clean-text, deterministic) via the RAG_QUERY_STRATEGY environment variable. The llm-summary strategy uses Gemini to generate an optimized search query before retrieval.
  • Grounding policy improvements -- The decideGrounding() function now respects the attachments_only mode, ensuring RAG chunks are excluded from the synthesis prompt while still being captured in traces.

Changed

  • Updated internal Gemini model default to gemini-3-flash-preview.

Fixed

  • Resolved an issue where retrievedTextForPrompt was not empty in attachments_only grounding mode.

0.1.26

Released: 2026-02-20

Added

  • KnowledgeBaseAdminService -- New admin service for managing File Search Stores, including create, delete, list stores, and upload/delete documents.
  • Ground-truth download -- KnowledgeBaseAdminService.downloadGroundTruthBytes() and getGroundTruthDownloadUrl() for accessing canonical document originals.

Changed

  • FirestoreTraceStore now flattens deeply nested objects (beyond 15 levels) into JSON strings to stay within Firestore document depth limits.

Fixed

  • azureHttp adapter now correctly reads request bodies via request.text() fallback when request.body is null.

0.1.25

Released: 2026-02-14

Added

  • ConversationStore interface -- New abstraction for multi-turn conversation persistence with InMemoryConversationStore and FirestoreConversationStore implementations.
  • createConversationHandler -- Handler factory for conversation CRUD endpoints.
  • CostCalculator -- Token usage and cost tracking with configurable pricing via LLM_PRICING_CONFIG_PATH.

Changed

  • BaseAgent.setTraceStore() now accepts an optional CostCalculator parameter for automatic cost tracking.

0.1.24

Released: 2026-02-07

Added

  • MCP tool registration -- registerMcpRemoteTools() discovers tools from a remote MCP server and registers them in ToolRegistry. Supports tool prefixing, categories, tags, timeouts, and retries.
  • WebResearchAgent -- New built-in agent for web research using MCP-registered tools (e.g., Tavily search).

Changed

  • ToolRegistry.register() now accepts a tags array for tool categorization.

0.1.23

Released: 2026-01-31

Added

  • SSE streaming -- createAgentExecuteStreamHandler and corresponding GCP/Azure stream endpoint factories.
  • createGcpAgentExecuteStreamEndpoint -- Convenience factory composing the stream handler with GCP SSE response writing.

Fixed

  • Fixed CORS header casing inconsistency between gcpHttp and azureHttp adapters.

0.1.22

Released: 2026-01-24

Added

  • Canonical grounding -- CanonicalGroundingService for attaching full documents to the LLM context alongside RAG chunks.
  • Document composition -- CompositionLoader for assembling multi-file document bundles.
  • Grounding policy -- GROUNDING_MODE environment variable with chunks_only, attachments_only, and hybrid modes.

0.1.21

Released: 2026-01-17

Added

  • FirestoreTraceStore -- Persistent trace storage using Google Cloud Firestore.
  • FirestoreConversationStore -- Persistent conversation storage.
  • Trace export -- TraceStore.export() for exporting traces in JSON format.

Changed

  • InMemoryTraceStore now supports captureContent and defaultTags options.

0.1.20

Released: 2026-01-10

Added

  • OrchestratorAgent -- Built-in agent for composing multiple sub-agents into a workflow.
  • DocumentAnalysisAgent -- Built-in agent for document parsing and question answering.

Changed

  • BaseAgent.execute() now wraps executeInternal() with timeout management and error handling.

Earlier Versions

Versions prior to 0.1.20 are part of the initial development phase. For details on earlier releases, contact your ModernPath representative.

Release Cadence

The framework is released on a weekly basis during active development. Releases are published to GCP Artifact Registry and are immediately available via npm.

To stay informed about new releases:

# Check for updates
npm outdated @modernpath/agent-framework
npm outdated @modernpath/agent-ui-react

# Update to latest
npm update @modernpath/agent-framework
npm update @modernpath/agent-ui-react