​
Changelog

All notable changes to the Kubiya Workflow SDK will be documented here.

​
[3.1.0] - 2024-01-26

​
Documentation Updates

  • 🎯 Provider Clarity - Updated all documentation to accurately reflect ADK as the current orchestration provider
  • 🐳 Containerized Execution - Emphasized serverless Docker container execution throughout docs
  • 🛡️ Application Layer Focus - New “Why Kubiya” guide explaining safety vs god-mode AI systems
  • 📝 DSL Reference - Comprehensive DSL reference with all workflow schema features
  • 🚀 Deterministic Workflows - New concept guide explaining determinism in workflows

​
Added

  • Created /concepts/why-kubiya.mdx - Application-layer vs infrastructure-level AI orchestration
  • Created /workflows/dsl-reference.mdx - Complete DSL reference with AI-friendly explanations
  • Created /concepts/deterministic-workflows.mdx - Understanding deterministic execution

​
Changed

  • Provider Overview - Rewritten to accurately show ADK as the orchestration provider
  • Architecture Docs - Emphasized serverless, containerized execution model
  • README - Updated to highlight containerized execution and ADK orchestration
  • All Provider References - Removed misleading mentions of multiple providers

​
Key Messages

  • Every workflow step runs in its own Docker container
  • Workflows are stateless with zero pollution between executions
  • ADK provides intelligent orchestration at the application layer
  • No infrastructure god-mode permissions required
  • Simple, deterministic schema that AI can easily generate

​
[3.0.0] - 2024-01-25

​
Added

  • 🎯 Compose API - Unified interface for plan and act modes in ADK provider
  • 🌊 Execute Workflow - Complete implementation in ADK provider with streaming support
  • 📖 Comprehensive ADK Docs - Agent architecture, streaming guide, API reference
  • 🎓 AI Automation Tutorial - Step-by-step guide for natural language workflows
  • 🏃 Default Runner Change - Changed from “auto” to “kubiya-hosted” for better reliability
  • 🔧 Context Loading Fix - Direct platform context loading without MockContext issues

​
Changed

  • ADK Provider now supports both SSE and Vercel AI SDK streaming formats
  • Organization Info - Now uses client initialization parameter instead of API calls
  • Workflow Generator - Includes smart runner selection logic based on user requirements
  • Loop Orchestrator - Loads platform context using tools directly
  • Config Handling - Fixed enum handling for model_provider configuration

​
Fixed

  • MockContext missing ADK attributes (response_modalities, speech_config, etc.)
  • Authentication error handling in ADK provider
  • API endpoint issues with non-existent organization endpoint
  • Streaming event formatting for both SSE and Vercel formats

​
Documentation

  • Created /providers/adk/agents.mdx - Multi-agent architecture deep dive
  • Created /providers/adk/streaming.mdx - Comprehensive streaming guide
  • Created /api-reference/compose.mdx - Complete compose API reference
  • Created /tutorials/ai-powered-automation.mdx - Hands-on AI workflow tutorial
  • Updated /workflows/architecture.mdx - Added AI-powered generation section
  • Updated README.md - Prominent AI workflow generation section

​
[2.0.0] - 2024-01-20

​
Added

  • 🤖 ADK Provider - AI-powered workflow generation using Google’s Agent Development Kit
  • 🚀 SDK Server - Production-ready FastAPI server with REST endpoints
  • 📡 SSE Streaming - Real-time workflow execution updates
  • 🔌 Provider System - Pluggable architecture for AI providers
  • 📚 Comprehensive Docs - New documentation site with MDX support
  • 🧪 Jupyter Notebooks - Interactive examples for learning
  • 🐳 Docker Support - Complete Docker and Docker Compose configurations
  • 🛠️ Makefile - Development automation commands

​
Changed

  • Enhanced Client class with new platform methods
  • Fixed API endpoint format to use operation=execute_workflow
  • Added native_sse=true parameter for standard SSE streaming
  • Improved error handling and Python 3.9 compatibility
  • Updated default runner to “auto” for automatic selection

​
Fixed

  • SSE streaming parsing for Kubiya’s custom event format
  • Byte/string handling in stream parser
  • Response parsing for runners/integrations API

​
[1.5.0] - 2023-12-15

​
Added

  • Workflow DSL with fluent interface
  • Basic Kubernetes integration
  • Testing framework with mocking support

​
Changed

  • Improved workflow validation
  • Better error messages
  • Performance optimizations

​
Fixed

  • Memory leaks in long-running workflows
  • Race conditions in parallel execution

​
[1.0.0] - 2023-10-01

​
Added

  • Initial release
  • Core workflow engine
  • Basic step execution
  • Simple retry logic

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