Changelog — April 2026

Platform changes for April 2026

changelogrelease-notes

Updated 2026-04-29

Verified 2026-04-29

Late April Refresh

Added Python SDK documentation covering CosmosClient, ADK V2 streaming, local tools, Storage/DMS, file adapters, and examples.
Refreshed TypeScript SDK docs for ADK V2 callbacks, versioned skills, additionalCollectionIds, excludeTools, appName, and tool argument deltas.
Documented that SDK LLM helpers use Configurator model/BYOT metadata and local providers, not the LLM Gateway completion path.

Added Evals user guide for datasets, dataset versions, metrics, experiments, runs, prompt suggestions, and eval observability sessions.
Updated Model Garden docs for datasets, fine-tuning jobs, adapters, node pools, API keys, and Docker image management.

Documented ADK V2 fatal errors, lower-case server events, tool_call_args_delta, additional_instructions, additional_collection_ids, max_output_tokens, and app_name.
Added MCP get_current_user inbuilt tool and refreshed provider/middleware diagrams.
Added Observer session_type=standard|eval filtering and provider-aware cost notes.
Added RAGflow graph build/visualization and retrieval evaluation endpoints.

Rewrote JumpStart architecture, integration, and deployment docs around durable worker jobs and ADK V2 through @cosmos/sdk.
Marked the old chat stream route as compatibility-only and documented the current worker/job ownership boundary.
Documented DMS-backed uploads/previews, local connector tool execution, project RBAC, and worker deployment requirements.

Added frontend support for source-controlled diagrams.net/draw.io diagrams in docs pages.
Replaced high-value ASCII diagrams with editable .drawio assets.
Added maintenance guidance to prune removed or overly verbose docs during submodule refreshes.

Upgraded from Next.js 15 to Next.js 16.2.3 with React Compiler and View Transitions API
Replaced inline <script> tags with useEffect-based client components (WindowsZoom.tsx) — React 19 errors on <script> inside components
Fixed /docs/ route 404 after upgrade — added resolveDocsRoot() fallback for cross-environment path resolution (Docker dev, CI/CD, local)
Fixed Dockerfile runner stage missing cosmos-docs directory for runtime SSR

Removed proxy.ts — incompatible with multi-domain K8s architecture (frontend and user-service on different subdomains)
Fixed redirect loop in AuthGuard with hasRedirected guard and soft navigation

Bearer token tool — cosmos_get_bearer_token returns session JWT for direct REST API calls
File management — Added cosmos_get_file, cosmos_create_folder, cosmos_import_file_from_url, cosmos_upload_files, cosmos_get_direct_endpoints
Skills — Full CRUD: cosmos_get_skill, cosmos_list_skills, cosmos_create_skill, cosmos_update_skill, cosmos_deploy_skill, cosmos_delete_skill
Templates — Full CRUD: cosmos_get_template, cosmos_list_templates, cosmos_create_template, cosmos_update_template, cosmos_deploy_template, cosmos_delete_template
Prompts — Full CRUD: cosmos_get_prompt, cosmos_list_prompts, cosmos_create_prompt, cosmos_update_prompt, cosmos_deploy_prompt, cosmos_delete_prompt
Business Events — Full CRUD + categories: cosmos_get_business_event, cosmos_list_business_events, cosmos_create_business_event, cosmos_update_business_event, cosmos_deploy_business_event, cosmos_delete_business_event, cosmos_list_business_event_categories
Guardrails — cosmos_get_guardrails_schema
Bulk operations — cosmos_bulk_deploy for deploying multiple resources in parallel
Total cosmos_* tools: ~70 (up from 30)

Progressive tool discovery via BM25 search transform — clients discover tools by searching instead of listing all 70+
Five tools pinned (always visible): cosmos_list_organizations, cosmos_list_files, cosmos_upload_file, cosmos_get_direct_endpoints, cosmos_get_bearer_token

Skill generation API (POST /api/v1/adk/skills/generate) with orchestrator sub-agent prompt support
Recursive agent tree walking for orchestrator agents (Sequential, Parallel, Loop) up to 3 levels deep
Versioned skills attachment per-request via V2 WebSocket start message
Fence stripping and skill output guidance improvements

Added session metadata JSONB column + PATCH /api/v1/adk/sessions/{id}/metadata endpoint
exclude_tools support for filtering tools per-request
Session reset and app_name normalization fixes

Created cosmos-docs/ living wiki system with 18 service pages, SCHEMA.md conventions, and log.md change tracking
Integrated docs into frontend at /docs/ with lunr.js search, auth gating, and staleness tracking

Standardized chat port from 8010 to 8108
Removed UAT environment; gateway only in Azure
Added adk-consumer service for Kafka event processing
Added storage service to Azure/GCP compose files
Optional services (voice, email, observer) now opt-in only via ./manage.sh dev start <service>