Genkit MCP

# Changelog All notable changes to the Genkit Python SDK will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [0.5.0] - 2026-02-04 This is a major release with **178 commits** and **680 files changed** over **8 months** since 0.4.0 (May 2025), representing the most significant update to the Genkit Python SDK to date. ### Impact Summary | Category | Impact Level | Description | |----------|-------------|-------------| | **New Plugins** | 🟢 High | 7 new model providers and 3 new telemetry plugins | | **Core Features** | 🟢 High | Rerankers, tool calling, background models, Dotprompt integration | | **Type Safety** | 🟡 Medium | Comprehensive type checking with ty/pyrefly/pyright | | **Breaking Changes** | 🟡 Medium | PluginV2 refactor requires migration | | **Developer Experience** | 🟢 High | Hot reloading, improved samples, better docs | | **Security** | 🟢 High | Ruff audit, PySentry scanning, SigV4 signing | | **Performance** | 🟢 High | Per-event-loop HTTP caching, release pipeline 15x faster | ### Added #### New Model Provider Plugins - **`genkit-plugin-anthropic`**: Full Anthropic Claude model support (#3919) - **`genkit-plugin-amazon-bedrock`**: AWS Bedrock integration for Claude, Titan, Llama models (#4389) - **`genkit-plugin-microsoft-foundry`**: Azure OpenAI (Microsoft Foundry) support (#4383) - **`genkit-plugin-cloudflare-workers-ai`**: Cloudflare Workers AI models (#4405) - **`genkit-plugin-deepseek`**: DeepSeek models with structured output (#4051) - **`genkit-plugin-xai`**: xAI (Grok) models with plugin config (#4001, #4289) - **`genkit-plugin-mistral`**: Mistral AI models (Large, Small, Codestral, Pixtral) (#4406) - **`genkit-plugin-huggingface`**: Hugging Face Inference API with 17+ providers (#4406) #### New Telemetry Plugins - **`genkit-plugin-aws`**: AWS X-Ray telemetry with SigV4 signing (#4390, #4402) - **`genkit-plugin-observability`**: Third-party telemetry (Sentry, Honeycomb, Datadog) - **`genkit-plugin-google-cloud`**: GCP telemetry parity with JS/Go implementations (#4281) #### Core Framework Features - **Agentive Tool Calling**: Define tools with `@ai.tool()` decorator for AI agents - **Rerankers**: Initial reranker implementation for RAG pipelines (#4065) - **Background Models**: Dynamic model discovery and background action support (#4327) - **Resource Support**: Full resource management with MCP integration (#4204, #4048) - **Evaluator Metrics**: ANSWER_RELEVANCY, FAITHFULNESS, MALICIOUSNESS metrics (#3806) - **MCP Plugin**: Model Context Protocol integration with tests (#4054) - **Retriever/Embedder References**: Reference support matching JS SDK (#3922, #3936) - **Output Formats**: Array, enum, and JSONL formats for JS parity (#4230) - **Pydantic Output**: Return Pydantic instances when output schema passed (#4413) #### Dotprompt Integration (via [google/dotprompt](https://github.com/google/dotprompt)) - **Dotpromptz 0.1.5**: Upgraded to latest version with type-safe schema fields - **Python 3.14 Support**: PyO3/maturin ABI compatibility for Rust-based Handlebars engine - **Directory/File Prompt Loading**: Automatic prompt discovery matching JS SDK (#3955, #3971) - **Handlebars Partials**: `define_partial` for template reuse (#4088) - **Render System Prompts**: `render_system_prompt` and `render_user_prompt` methods (#3503, #3705) - **Callable Support**: Prompts can now be used as callables (#4053) - **Cycle Detection**: Partial resolution with cycle detection prevents infinite recursion - **Path Traversal Hardening**: Security fix for CWE-22 vulnerability - **Helper Parity**: Consistent Handlebars helper behavior across all runtimes - **Release Pipeline**: Automated PyPI publishing, release time reduced from 30 min to 2 min #### Developer Experience - **Hot Reloading**: [Watchdog](https://github.com/gorakhargosh/watchdog)-based autoreloading for all samples (#4268) - **Security Scanning**: PySentry-rs integration in hooks and CI (#4273) - **TODO Linting**: Automated issue creation for TODO comments (#4376) - **Centralized Action Latency**: Built-in performance tracking (#4267) - **Sample Improvements**: Preamble scripts, browser auto-open, rich tracebacks (#4375, #4373) - **Release Automation**: `bin/release_check`, `bin/bump_version` scripts - **Consistency Checks**: `bin/check_consistency` for package validation #### Type Safety Improvements - **ty Integration**: Stricter, faster type checking from Astral (#4094) - **pyrefly Integration**: Meta's type checker for additional coverage (#4316) - **pyright Enforcement**: Full Microsoft type checking (#4310) - **Comprehensive Fixes**: Zero type errors across all packages (#4249-4260, #4270) #### Documentation - **Module Docstrings**: Terminology tables and ASCII data flow diagrams (#4322) - **GEMINI.md Updates**: Test file naming, import guidelines, TODO format (#4381, #4393, #4397) - **Sample Documentation**: Testing notes for all samples (#4294) - **HTTP Client Guidelines**: Event loop binding best practices (#4430) - **Roadmap**: Plugin API conformance analysis (#4431) #### Samples & Demos - **New Samples**: tool-interrupt, short-n-long, media-models-demo, prompt samples - **Run Script Standardization**: Central script for running samples with `genkit start` - **Rich Tracebacks**: Improved error output in samples ### Changed #### Breaking Changes - **PluginV2 Refactor**: Major plugin architecture update - existing plugins may need migration (#4132) - Plugins now use a standardized registration pattern - Configuration options are more consistent across plugins - **Async-First Architecture**: Removed sync base, fully async by default (#4244) - **Embed API**: Refactored `embed/embed_many` for JS parity (#4269) #### Improvements - **Python 3.14 Support**: Full compatibility with Python 3.14 (#3947) - **Gemini 2.5/3.0 Upgrade**: Default models updated to Gemini 2.5/3.0 (#3771, #4277) - **Dotpromptz 0.1.5**: Latest template engine with improved features (#4324) - **PEP 8 Compliance**: All in-function imports moved to top-level (#4396-4400) - **CI Consolidation**: Single workflow, every commit is release-worthy (#4410) - **Reflection API**: Improved multi-runtime handling and health checks - **Dev UI Defaults**: Better default configurations ### Fixed #### Critical Fixes - **Race Condition**: Dev server startup race condition resolved (#4225) - **Thread Safety**: Per-event-loop HTTP client caching prevents event loop binding errors (#4419, #4429) - **Infinite Recursion**: Cycle detection in Handlebars partial resolution (via Dotprompt) - **Real-Time Telemetry**: Trace ID formatting and streaming fixes (#4285) - **Structured Output**: DeepSeek model structured output generation (#4374) - **JSON Schema**: None type handling per JSON Schema spec (#4247) - **Windows Support**: File-safe timestamp format for runtime files (#3727) #### Model/Plugin Fixes - **Gemini Models**: Various bug fixes (#4432) - **TTS/Veo Models**: System prompt support in model config (#4411) - **Google GenAI**: Model config and README updates (#4306, #4323) - **Ollama**: Sample fixes and model server management (#4133, #4227) - **Embedders**: Reflection health check fixes (#3969) - **Complex Schemas**: Support for complex schemas in Gemini (#3049) #### Sample Fixes - Extensive sample fixes across all demos (#4122-4418) - System prompt fields added to all Gemini samples (#4391) - Missing dependencies resolved (#4282) - Consistent `genkit start` usage (#4226) - GCloud auto-setup for Vertex AI samples (#4427) #### Type Errors - Resolved all `ty`, `pyrefly`, and `pyright` type errors - Re-enabled disabled tests and improved coverage - Fixed evaluator plugin imports and StrEnum compatibility ### Security - **Ruff Security Audit**: Addressed all security and code quality warnings (#4409) - **SigV4 Signing**: AWS X-Ray OTLP exporter now uses proper AWS signatures (#4402) - **Path Traversal Hardening**: CWE-22 vulnerability fix in Dotprompt (via google/dotprompt) - **License Compliance**: Fixed license headers in all configuration files (#3930) - **PySentry Integration**: Continuous security vulnerability scanning (#4273) ### Performance - **Per-Event-Loop HTTP Client Caching**: Reuses HTTP connections within event loops, prevents connection overhead - **Dotprompt Release Pipeline**: Reduced from 30 minutes to 2 minutes (15x faster) - **CI Consolidation**: Single workflow, every commit is release-worthy (#4410) - **ty Type Checker**: Faster type checking than pyright alone (#4094) ### Deprecated - Sync API base classes are removed in favor of async-first architecture ### Contributors This release includes contributions from **13 developers** across **188 PRs**. Thank you to everyone who contributed! | Contributor | PRs | Commits | Key Contributions | |-------------|-----|---------|-------------------| | [**@yesudeep**](https://github.com/yesudeep) | 91 | 93 | **Core**: async-first architecture (#4244), Genkit class methods (#4274), embed/embed_many API refactor (#4269), centralized action latency (#4267), array/enum/jsonl output formats (#4230). **Plugins**: AWS Bedrock (#4389), AWS X-Ray with SigV4 (#4390, #4402), Azure OpenAI (#4383), Cloudflare Workers AI (#4405), Mistral AI (#4406), Hugging Face (#4406), GCP telemetry (#4281). **Type Safety**: ty integration (#4094), pyrefly (#4316), pyright (#4310), comprehensive fixes (#4249-4270). **DevEx**: hot reloading (#4268), per-event-loop HTTP caching (#4419, #4429), PySentry security (#4273), TODO linting (#4376), CI consolidation (#4410), session/chat API (#4278, #4275), background models (#4327), docs (#4322, #4393, #4430). **Samples**: 20+ sample fixes and improvements (#4283, #4373, #4375, #4427). | | [**@MengqinShen**](https://github.com/MengqinShen) (Elisa Shen) | 42 | 42 | **Core**: Resource support implementation (#4204). **Samples**: menu sample fixes (#4239, #4403), short-n-long (#4404), tool-interrupt (#4408), prompt sample (#4223, #4183), ollama-hello (#4133), genai-image (#4122, #4234), code-execution (#4134), anthropic sample (#4131). **Models**: Google GenAI model config (#4306), TTS/Veo model config (#4411), Gemini bug fixes (#4432), system prompt fields (#4391, #4418). **Docs**: README updates (#4323), multi-round flow logic (#4137). | | [**@AbeJLazaro**](https://github.com/AbeJLazaro) | 11 | 8 | **Plugins**: Model Garden resolve/list actions (#3040), Ollama resolve action (#2972), type coverage and tests (#3011). **Fixes**: Gemini complex schema support (#3049), Firestore plugin naming (#3085), evaluator plugin requirements (#3166), optional dependencies setup (#3012). **Tests**: Model Garden tests (#3083). | | [**@pavelgj**](https://github.com/pavelgj) | 10 | 7 | **Core**: Reflection API multi-runtime support (#3970), health check fixes (#3969). **Fixes**: Embedders reflection (#3969), Gemini version upgrades to 2.5 (#3909). | | [**@zarinn3pal**](https://github.com/zarinn3pal) | 9 | 9 | **Plugins**: Anthropic (#3919), DeepSeek (#4051, structured output fix #4374), xAI/Grok (#4001, config #4289), ModelGarden (#2568). **Telemetry**: GCP telemetry for Firebase observability (#3826, #4386). **Samples**: OpenAI Compat tools (#3684). | | [**@huangjeff5**](https://github.com/huangjeff5) | 7 | 7 | **Core**: PluginV2 refactor with new registration pattern (#4132), type safety improvements (#4310), Pydantic output instances (#4413), session/chat refactor (#4321). **Telemetry**: Real-time telemetry and trace ID formatting (#4285). | | [**@hendrixmar**](https://github.com/hendrixmar) | 7 | 7 | **Evaluators**: ANSWER_RELEVANCY, FAITHFULNESS, MALICIOUSNESS metrics (#3806), ModelReference support (#3949, #3951). **Plugins**: OpenAI compat list_actions (#3240), resolve_method (#3055). **Dotprompt**: render_system_prompt (#3503), render_user_prompt (#3705). | | [**@ssbushi**](https://github.com/ssbushi) | 6 | 2 | **Evaluators**: Simple evaluators plugin (#2835). **Docs**: MkDocs API reference updates (#2852), genkit-tools model optional (#3918). | | [**@shrutip90**](https://github.com/shrutip90) | 1 | 1 | **Types**: ResourcePartSchema exports via genkit-tools (#3239). | | [**@schlich**](https://github.com/schlich) | 1 | 1 | **Types**: Type annotations for ai module. | | [**@ktsmadhav**](https://github.com/ktsmadhav) | 1 | 1 | **Fixes**: Windows support with file-safe timestamp format (#3727). | | [**@junhyukhan**](https://github.com/junhyukhan) | 1 | 1 | **Docs**: Typo fixes. | | [**@CorieW**](https://github.com/CorieW) | 1 | 1 | Community contribution. | **[google/dotprompt](https://github.com/google/dotprompt) Contributors** (Dotprompt Python integration): | Contributor | PRs | Commits | Key Contributions | |-------------|-----|---------|-------------------| | [**@yesudeep**](https://github.com/yesudeep) | 50+ | 100+ | **Rust Engine**: dotpromptz-handlebars with PyO3/maturin (#365), Python 3.14 ABI support, Rust Handlebars runtime. **Features**: Cycle detection in partial resolution, path traversal hardening (CWE-22), directory/file prompt loading (#3955, #3971), Handlebars partials (#4088), callable prompts (#4053). **Build**: Bazel rules_dart/rules_flutter, release pipeline 15x faster (30min→2min), maturin wheel builds. **IDE**: Monaco syntax highlighting, CodeMirror 6 integration, Storybook demos. **Polyglot**: Python, Go, Dart, Rust, TypeScript implementations. | | [**@MengqinShen**](https://github.com/MengqinShen) | 42 | 45 | **CI/CD**: GitHub Actions workflows for Python package publishing, automated release-please, dotpromptz PyPI releases (0.1.2-0.1.5), handlebarrz releases, wheel artifact management. | | [**@Zereker**](https://github.com/Zereker) | 1 | 1 | **Go**: Closure fix preventing template sharing between instances. | --- ## [0.4.0] - 2025-05-26 ### Added - **Telemetry Plugins** - `genkit-plugin-microsoft-foundry`: Azure Application Insights integration (consolidated with model access) - `genkit-plugin-cf`: Generic OTLP export for Cloudflare and other backends - `genkit-plugin-observability`: Unified presets for Sentry, Honeycomb, Datadog, Grafana Cloud, Axiom - **Model Provider Plugins** - `genkit-plugin-mistral`: Mistral AI models (Large, Small, Codestral, Pixtral) - `genkit-plugin-huggingface`: Hugging Face Inference API with 17+ inference providers - **Core Framework** - Improved tracing and observability support - Enhanced type safety across all modules ### Changed - All plugins now share the same version number as the core framework - Improved documentation and README files for all packages ## [0.3.0] - 2025-04-08 ### Added - Initial public release of Genkit Python SDK - Core framework (`genkit`) - Model plugins: Anthropic, Google GenAI, Ollama, Vertex AI, xAI, DeepSeek - Telemetry plugins: AWS, Google Cloud, Firebase - Utility plugins: Flask, MCP, Evaluators, Dev Local Vectorstore [Unreleased]: https://github.com/firebase/genkit/compare/genkit-python@0.5.0...HEAD [0.5.0]: https://github.com/firebase/genkit/compare/genkit-python@0.4.0...genkit-python@0.5.0 [0.4.0]: https://github.com/firebase/genkit/compare/genkit-python@0.3.0...genkit-python@0.4.0 [0.3.0]: https://github.com/firebase/genkit/releases/tag/genkit-python@0.3.0