Skip to content

Changelog

All notable changes to the Akordi Agents SDK.

[0.0.30] - 2026-02-18

Added

  • Agent Utilities Module (akordi_agents/utils/agent.py)
  • get_system_prompt(): Fetch system prompt templates from DynamoDB with caching
  • get_agent_by_code(): Retrieve active agent configurations from AKORDI_AGENT_TABLE

  • get_agent(): Build CustomAgent from DynamoDB agent records

  • LangGraphAgent Token Tracking

  • Token usage tracking for LangGraph workflows
  • _skip_token_tracking flag propagation to prevent double-tracking

Enhanced

  • Test Coverage: Improved from 77.72% to 81.03%
  • 46 new tests across multiple modules
  • New tests/test_agent_utils.py with 22 tests

  • Added tests to tests/test_agent_builder.py and tests/test_model_service.py

  • Model Service: Added pricing cache and model pricing lookup tests

  • Coverage improved from 70.47% to 98.45%

Fixed

  • Module Import Performance: Fixed lazy initialization in llm_service.py
  • Prevents AWS client creation at import time

[0.0.27] - 2026-02-10

Added

  • Comprehensive DynamoDB Client Documentation
  • Full API reference with usage examples for all CRUD operations
  • Real-world example: Querying agent registry by team code
  • Best practices guide for DynamoDB operations
  • Local development setup with DynamoDB Local
  • Type serialization documentation
  • Enhanced Test Coverage
  • Added 52 new tests for orchestration module
  • Test coverage for orchestration.py now at 94.83%
  • Async tests for all orchestrator types (Coordinator, Peer-to-Peer, Hierarchical)
  • Edge case tests for AgentProfile, ResultAggregator, TaskDecomposer
  • Tests for OrchestratedMultiAgentWorkflow

Changed

  • Updated pytest configuration to omit CLI from test coverage
  • Added DynamoDBClient.get() method docstring with usage examples
  • Improved documentation navigation with dedicated DynamoDB Client page

Documentation

  • New docs/api/dynamodb-client.md - Comprehensive DynamoDB client guide
  • Updated docs/api/services.md - Added DynamoDB Client section
  • Updated mkdocs.yml - Added DynamoDB Client to navigation

[0.0.20] - 2024-12-09

Added

  • Comprehensive MkDocs documentation
  • Improved test coverage (71%+)
  • Additional examples and tutorials

Changed

  • Enhanced workflow routing in LangGraph
  • Improved error handling in chat history service

Fixed

  • Chat history truncation bug
  • Test isolation issues with Pydantic models

[0.0.19] - 2024-12-01

Added

  • Token usage tracking service
  • DynamoDB-based usage statistics
  • Agent performance monitoring

Changed

  • Improved LLM response handling
  • Enhanced logging throughout

[0.0.18] - 2024-11-15

Added

  • LangGraph Integration - Advanced workflow orchestration
  • ToolUseWorkflow for intelligent tool selection
  • MultiAgentWorkflow for agent coordination
  • BaseAgentWorkflow for custom workflows
  • Multi-Agent Orchestration
  • Coordinator pattern
  • Peer-to-peer pattern
  • Hierarchical pattern
  • A2A Protocol - Agent-to-Agent communication
  • Conditional Routing - Dynamic workflow paths
  • Streaming Support - Real-time response generation

Changed

  • AgentBuilder now supports LangGraph configuration
  • Improved state management in workflows
  • Enhanced tool execution with retry logic

[0.0.17] - 2024-11-01

Added

  • AWS Bedrock Guardrails integration
  • BedrockGuardrail class for content safety
  • Guardrail CLI commands

Fixed

  • Memory leak in chat history service
  • Timeout issues with large responses

[0.0.16] - 2024-10-15

Added

  • Chat history persistence with DynamoDB
  • ChatHistoryService for session management
  • ChatHistoryManager utilities

Changed

  • Improved chat message formatting
  • Enhanced context handling

[0.0.15] - 2024-10-01

Added

  • Custom tool support
  • Tool base class
  • Tool execution nodes

Changed

  • Refactored agent initialization
  • Improved error messages

[0.0.14] - 2024-09-15

Added

  • AgentBuilder fluent interface
  • Component registry system
  • Custom validator support

Changed

  • Simplified agent creation
  • Enhanced configuration options

[0.0.13] - 2024-09-01

Added

  • Initial public release
  • CustomAgent class
  • AWS Bedrock integration
  • Knowledge base search
  • Basic CLI interface

Migration Guide

From 0.0.17 to 0.0.18

The 0.0.18 release introduces LangGraph integration. To migrate:

  1. Update imports:
# Old
from akordi_agents.core import CustomAgent

# New - for LangGraph features
from akordi_agents.core import create_langgraph_agent, LangGraphAgent
  1. Update agent creation:
# Old
agent = CustomAgent(name="my_agent", llm_service=llm_service)

# New - with LangGraph
agent = create_langgraph_agent(
    name="my_agent",
    llm_service=llm_service,
    config={"enable_tools": True}
)
  1. Update tool usage:
# Old - manual tool execution
result = tool.execute(**args)

# New - automatic tool orchestration
agent = create_langgraph_agent(
    name="my_agent",
    llm_service=llm_service,
    tools=[tool],
    config={"enable_tools": True}
)
# Tools are executed automatically
response = agent.process_request({"query": "..."})

From 0.0.16 to 0.0.17

The 0.0.17 release adds guardrails. To use:

# Add guardrail configuration
import os
os.environ["GUARDRAIL_ID"] = "your-guardrail-id"
os.environ["GUARDRAIL_VERSION"] = "1"

# Create agent with validation
agent = create_langgraph_agent(
    name="safe_agent",
    llm_service=llm_service,
    validator=my_validator,
    config={"enable_validation": True}
)

Version Policy

  • Major version (X.0.0): Breaking changes
  • Minor version (0.X.0): New features, backward compatible
  • Patch version (0.0.X): Bug fixes, backward compatible

Deprecation Policy

  • Deprecated features are marked with warnings
  • Deprecated features are removed after 2 minor versions
  • Migration guides are provided for breaking changes