Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.2.1] - 2026-03-06

Changed

• Replaced pymupdf with pypdf in PDF ingestion loader implementation.
• Updated project dependencies and lockfile to remove pymupdf and use pypdf.
• Updated documentation references for PdfLoader to reflect pypdf usage.

[1.2.0] - 2026-03-04

Added

• Added MCP OAuth integration in amsdal_ml/mcp_server/mcp_oauth, enabling MCP server authorization via AMSDAL authentication.

Security

• MCP OAuth flow now preserves AMSDAL permission checks during authenticated MCP access.

[1.1.0] - 2026-02-25

Changed

• Upgraded to amsdal[cli]>=0.8.0, consolidating amsdal, amsdal_cli, and amsdal_server into a single dependency.

[1.0.1] - 2026-02-18

Changed

• Documentation: recommend Chatbox AI (desktop) as the primary MCP client and document setup steps (provider token + custom MCP server + auth headers).
• Documentation: clarify LibreChat usage as local-only via ngrok tunnel (deployed server URLs may fail), and note ngrok-skip-browser-warning=1 header for tunnels.

[1.0.0] - 2026-02-17

Added

• First MCP server release for AMSDAL apps via server_model_explorer, including:
  • list_available_models for model discovery,
  • get_model_schema for full JSON schema + computed property source,
  • get_model_relationships for outgoing and incoming FK graph inspection,
  • get_model_field_values_by_ids for id-based field inspection (with history support),
  • perform_crud_operation for NL-driven read/create/update/delete with two-step confirmation.
• Added NLQueryCreatorExecutor with a 3-phase create pipeline:
  • resolution planning for nested entities,
  • context retrieval for candidate related objects,
  • payload synthesis + persistence with required-field checks and reference/file preprocessing.
• Added NLQueryUpdaterExecutor with advanced update flow:
  • split of natural language into find_query + update_query,
  • filter generation + preview of direct/FK/JSONB changes,
  • intent detection (UPDATE_DIRECT, REASSIGN_FK, UPDATE_RELATED, MIXED),
  • related-entity update handling and transactional apply.
• Added NLQueryDeleterExecutor with split/analyze/execute delete flow, preview support, and transactional deletion.
• Expanded NLQueryExecutor (retriever) behavior for robust filter parsing, related-queryset application, preview summaries, and strict single-record execution checks.
• Added support for ingester workflows with new HTTP MCP functionality.

Changed

• This is the first major MCP release line (1.x) for AMSDAL ML.
• Query execution in perform_crud_operation uses an explicit two-step confirmation flow:
  • confirm=false returns analysis/preview only,
  • confirm=true executes using the returned analysis payload.
• Context resolution pipeline was reworked to better resolve nested entities and references in NLQ payloads.
• get_model_field_values_by_ids is the primary MCP tool for explicit "show object by id" verification before user confirmation.
• Dynamic dimension sizing for embeddings is now configurable from environment variables.
• Improved flexible-filter behavior in the React agent.
• Global improvements:
  • Dynamic dimension sizing in the embedding model (env),
  • Improvements to the flexible filter in the React agent,
  • Fixes for the MCP stdio client,
  • Support for the ingester with new HTTP MCP functionality,
  • Tenacity-based retry logic in the OpenAI model / OpenAI retriever,
  • New tests added.

Security

• Permission checks are enforced at two levels in MCP operations:
  • class-level authorization before operation planning/execution,
  • object-level authorization while objects are loaded, saved, or deleted.
• Request context bridging (with_amsdal_context) propagates MCP request user/auth into AMSDAL context for permission evaluation in execution hooks.

[0.3.2] - 2026-02-06

Added

• AMSDAL EULA license
• CHANGELOG.md in Keep a Changelog format
• Consolidated CI/CD workflows

[0.3.1] - 2026-02-06

Fixed

• Fixed on_setup for AppConfig

[0.3.0] - 2026-02-06

Changed

• Update to amsdal v0.6.0

[0.2.2] - 2026-01-19

Fixed

• Added support for JSON_SCHEMA response format when using attachments in OpenAI Responses API
• Support for images in OpenAI Responses API (automatically selects input_image based on MIME type)
• Added mime_type support to FileAttachment and OpenAIFileLoader

[0.2.1] - 2025-12-23

Changed

• Upgraded dependencies: pydantic~=2.12, pydantic-settings~=2.12

[0.2.0] - 2025-12-16

Added

• PythonTool: Tool for executing Python functions within agents
• FunctionalCallingAgent: Agent specialized in functional calling with configurable tools
• NLQueryRetriever: Retriever for natural language queries on AMSDAL querysets
• DefaultIngestionPipeline: Pipeline for document ingestion including loader, cleaner, splitter, embedder, and store
• ModelIngester: High-level ingester for processing models with customizable pipelines and metadata
• PdfLoader: Document loader using pymupdf for PDF processing
• TextCleaner: Processor for cleaning and normalizing text
• TokenSplitter: Splitter for dividing text into chunks based on token count
• OpenAIEmbedder: Embedder for generating embeddings via OpenAI API
• EmbeddingDataStore: Store for saving embedding data linked to source objects

[0.1.4] - 2025-10-15

Fixed

• Fixed lazy initialization of OpenAIRetriever to ensure env vars are loaded
• Added missing env parameter to stdio_client for non-persistent sessions
• Environment variables now properly passed to MCP stdio subprocesses
• Updated README.md to be production-ready
• Added RELEASE.md with step-by-step release guide

[0.1.3] - 2025-10-13

Fixed

• Pass env vars into stdio server
• Cleanup of app.py

[0.1.2] - 2025-10-08

Fixed

• Fix for UserWarning: Field name "object_id" in "EmbeddingModel" shadows an attribute in parent "Model"

[0.1.1] - 2025-10-08

Added

• BaseFileLoader interface and OpenAI Files API implementation

[0.1.0] - 2025-09-22

Added

• Interfaces and default OpenAI-based implementations