We're excited to announce AgenticGoKit v0.4.0, a major milestone that introduces a comprehensive plugin architecture, stabilizes the public API, and significantly improves the developer experience. This release represents a fundamental restructuring of the framework to provide better modularity, extensibility, and maintainability.

Highlights

Public API Stabilization

• Clean, stable API surface in core/ package
• Implementation details moved to internal/ and plugins/
• Breaking changes minimize future API churn
• Enhanced backward compatibility where possible

Plugin Architecture

• Modular plugin system for runners, orchestrators, LLM providers, and more
• Easy extensibility without core modifications
• Standardized plugin interfaces and registration

Config-Driven Runtime

• Configuration-first approach with agentflow.toml
• NewRunnerFromConfig replaces complex builders
• Simplified lifecycle management with Start/Emit/Stop

New Features

Core/Public API

Agent System

• Unified Agent Interface: New Agent interface with composable scaffolding
• Backward Compatibility: AgentHandler retained as alias for smooth migration
• Enhanced Composition: Better support for complex agent hierarchies

Runner System

• Config-Driven Construction: NewRunnerFromConfig for declarative setup
• Standardized Lifecycle: Clean Start/Emit/Stop methods for runner management
• Plugin-Backed Implementation: Flexible runner implementations via plugins

LLM Integration

• Provider Registry: Centralized ModelProvider registration system
• Helper Adapters: Simplified integration patterns
• Enhanced Error Messages: Clear guidance when providers are missing
• Plugin Support: Extensible LLM provider ecosystem

MCP (Model Context Protocol)

• Consolidated API: Unified interfaces and initialization hooks
• Plugin Factories: Modular manager/cache/registry implementations
• Actionable Errors: Clear messages when required plugins are missing

Plugin Ecosystem

Runner Plugins

• plugins/runner/default: Standard runner implementation

Orchestrator Plugins

• plugins/orchestrator/route: Request routing orchestration
• plugins/orchestrator/sequential: Sequential execution patterns
• plugins/orchestrator/collaborative: Multi-agent collaboration
• plugins/orchestrator/loop: Iterative processing loops
• plugins/orchestrator/mixed: Hybrid orchestration strategies

LLM Provider Plugins

• plugins/llm/ollama: Local Ollama integration
• plugins/llm/openai: OpenAI API support
• plugins/llm/azureopenai: Azure OpenAI integration

MCP Plugins

• Transports: plugins/mcp/tcp, plugins/mcp/stdio
• Management: Default manager, memory cache, memory registry
• Extensible: Easy addition of new transport mechanisms

Memory Provider Plugins

• plugins/memory/memory: In-memory storage
• plugins/memory/weaviate: Weaviate vector database
• plugins/memory/pgvector: PostgreSQL with pgvector extension

Enhanced CLI (agentcli)

Configuration Management

• New Commands: config load, config validate, config generate
• Stronger Validation: Comprehensive configuration validation with detailed error reporting
• Template Support: Enhanced scaffolding with better templates

Improved User Experience

• Better Help System: More informative help messages and examples
• Enhanced Flags: Improved command-line argument handling
• Visualization: CLI-based visualization tools (removed from runtime)

Technical Improvements

Internal Reorganization

Modular Structure

• internal/agents: Agent implementation details
• internal/orchestrator: Orchestration logic
• internal/memory: Memory management internals
• internal/llm: LLM integration internals
• internal/config: Configuration system
• internal/visualization: Mermaid diagram generation
• internal/core/error_handling: Centralized error management
• internal/factory: Factory pattern implementations

Configuration System

• Enhanced Loader: Robust configuration loading with validation
• Config Resolver: Advanced resolution strategies
• Config Validator: Comprehensive validation framework
• Config Reloader: Hot-reload capabilities with extensive testing

Error Handling & Tracing

Unified Error Management

• Consolidated Routing: Centralized error handling patterns
• Enhanced Callbacks: Before/AfterEventHandling, BeforeAgentRun, AgentError hooks
• Circuit Breaker: Moved to internal/core/error_handling with public bridges
• Retry Logic: Improved retry mechanisms with better configurability

Enhanced Tracing

• Trace Dumping: Runner.DumpTrace for debugging and monitoring
• Better Observability: Improved tracing throughout the system
• Performance Insights: Enhanced monitoring capabilities

Memory & Embeddings

Centralized Management

• Provider Abstraction: Unified memory provider interface
• Embedding Support: Centralized embedding management under internal/
• Fallback Patterns: Maintained backward compatibility with improved patterns
• Plugin Architecture: Extensible memory providers

Documentation & Examples

Updated Documentation

• Migration Guides: Comprehensive guides for upgrading from previous versions
• Plugin Development: Detailed guides for creating custom plugins
• Configuration Reference: Complete configuration system documentation
• API Reference: Updated public API documentation

Enhanced Examples

• Standardized Runtime: All examples use Ollama gemma3:1b for consistency
• Plugin Demonstrations: Examples showcasing plugin usage patterns
• Configuration Examples: Real-world configuration scenarios
• Migration Examples: Before/after comparisons for upgrades

Improved Tutorials

• Getting Started: Streamlined onboarding experience
• Advanced Patterns: Complex orchestration and plugin development
• Best Practices: Recommended patterns and anti-patterns

Breaking Changes & Migration

API Changes

• Core Package: Clean separation between public API and implementation
• Import Paths: Some imports moved from core/ to internal/ or plugins/
• Runner Construction: NewRunnerFromConfig replaces previous builder patterns
• Configuration Format: Enhanced agentflow.toml structure

Migration Support

• Compatibility Layer: AgentHandler alias maintains backward compatibility
• Migration Guides: Step-by-step upgrade instructions
• Tooling Support: CLI tools to assist with migration
• Gradual Migration: Ability to migrate incrementally

Plugin Development

Getting Started

• Plugin Interface: Standardized plugin contracts
• Registration System: Simple plugin registration mechanisms
• Development Tools: CLI support for plugin scaffolding
• Testing Framework: Plugin testing utilities

Plugin Types

• Runner Plugins: Custom execution engines
• Orchestrator Plugins: Custom orchestration strategies
• LLM Plugins: Custom model providers
• Memory Plugins: Custom storage backends
• MCP Plugins: Custom transport and management

Best Practices

• Error Handling: Consistent error reporting patterns
• Configuration: Plugin configuration standards
• Testing: Plugin testing strategies
• Documentation: Plugin documentation requirements

Installation & Upgrade

New Installation

go get github.com/kunalkushwaha/[email protected]

Upgrading from Previous Versions

1. Review Breaking Changes: Check the migration guide for your version
2. Update Dependencies: go get -u github.com/kunalkushwaha/[email protected]
3. Update Imports: Adjust import paths as needed
4. Update Configuration: Migrate to new agentflow.toml format
5. Test Thoroughly: Verify functionality with updated APIs

CLI Installation

# Install agentcli
go install github.com/kunalkushwaha/agenticgokit/cmd/[email protected]

# Verify installation
agentcli version

Testing & Quality

Enhanced Testing

• Plugin Testing: Comprehensive plugin test framework
• Integration Tests: End-to-end testing improvements
• Configuration Testing: Robust configuration validation testing
• Error Scenario Testing: Better error handling test coverage

Quality Improvements

• Code Coverage: Improved test coverage across all packages
• Static Analysis: Enhanced linting and static analysis
• Performance: Benchmarking and performance improvements
• Documentation: Better code documentation and examples

Community & Contribution

Contributor Experience

• Enhanced Guidelines: Updated contributor documentation
• Plugin Development: Streamlined plugin development process
• Code Standards: Clear coding standards and review processes
• Testing Requirements: Comprehensive testing guidelines

Community Resources

• Examples Repository: Rich collection of working examples
• Plugin Registry: Community plugin directory
• Discussion Forums: Enhanced community support channels
• Issue Templates: Improved bug reporting and feature request templates

Looking Forward

Upcoming Features

• Enhanced Plugin Discovery: Automatic plugin discovery and installation
• Performance Optimizations: Continued performance improvements
• Additional Providers: More LLM and memory provider plugins
• Advanced Orchestration: More sophisticated orchestration patterns

Feedback & Contributions

We welcome feedback, bug reports, and contributions! Please visit our GitHub repository to:

• Report issues
• Request features
• Contribute code
• Share examples
• Join discussions