v2026.12.5 - Document Analyzer & Reliability Improvements

​

Overview

​

Problem Solved

​

Before this release

• ❌ Document analyzer examples did not consistently propagate extracted text into FilePart.text, making downstream processing and testing harder
• ❌ Scheduler and storage subsystems had edge‑case issues (AnyIO deadlock, CPU burn, potential OOMs) and inconsistent formatting
• ❌ Multi‑currency and multi‑asset payment flows were harder to configure safely, leading to possible duplicate or partial payment contexts
• ❌ Several examples and configs had missing dependencies or unclear requirements, increasing setup friction for new users

​

After this release

• ✅ Document analyzer reliably preserves FilePart.text, supports PDF/DOCX mimetypes, and ships with dedicated tests
• ✅ Storage, scheduler, Hydra middleware, and TaskManager are hardened with improved error handling and concurrency safety
• ✅ Payment features seamlessly support multiple currencies and multi‑asset requirements with strict context validation
• ✅ Examples and docs are updated with DSPy, LangGraph workflows, explicit API key prerequisites, and improved READMEs

​

Breaking Changes

​

Features

​

📄 Document Analyzer Agent & Frontend Integration

• Adds a dedicated document analyzer agent with skills wiring and workflow examples for document processing
• Frontend explicitly allows PDF and DOCX mimetypes and handles animated formats appropriately
• Ensures uploaded FilePart objects preserve the text property so downstream handlers can operate on content
• Includes dedicated .env and skill.yaml files for immediate plug-and-play usage

​

🤖 DSPy Agent & Structured LangGraph Workflows

• Introduces a new DSPy agent example in examples/beginner/ demonstrating question-answering behavior
• Adds comprehensive unit tests for the DSPy example to validate behavior and guard against regressions
• Integrates a structured LangGraph workflow example to showcase advanced orchestration patterns within Bindu

​

💳 Payments & Multi‑Currency Support

• Extends payment logic allowing agents to accept multiple payment currencies in a single configuration
• Implements multi‑asset payment requirements with improved payment context validation
• Fixes duplicate payment context injection in the A2A message/send endpoint
• Prevents 500 Server Errors when payment states are only partially set or malformed

​

🗄️ Storage, Scheduler, and Auth Reliability

• Refactors the storage layer to harden the in‑memory subsystem, reduce OOM risks, and optimize database indexing
• Fixes scheduler behavior to resolve AnyIO buffer deadlocks, CPU burn loops, and trace serialization issues
• Migrates Hydra auth middleware to a pure ASGI implementation for concurrency, WebSocket support, and lifecycle handling

​

🎨 UI & Accessibility Enhancements

• Introduces a collapsible Agent Inspector with clearer empty states for a better first-agent experience
• Adds skip‑to‑content links and main landmarks to improve screen-reader accessibility and keyboard navigation
• Eliminates UI flicker when switching between previous chats, improving perceived responsiveness

​

⚙️ Configuration & Validation Improvements

• Adds fail‑fast validation for required deployment.url in agent configuration
• Improves nested required field validation with much clearer developer error messages
• Moves key settings constants into dedicated modules to clarify configuration boundaries

​

📚 Documentation Updates

• Refreshes README with improved visuals (header/footer, quotes) and clearer getting-started guidance
• Documents API key prerequisites (including in the Hindi README) to ensure external providers are configured correctly
• Refreshes .env examples to reflect newer dependencies (e.g., OpenRouter)
• Fixes broken links in translated READMEs and aligns license/test‑coverage docs

​

🧪 Testing & Code Quality

• Expands TaskManager tests to cover edge cases, lifecycles, and security scenarios
• Adds robust tests for TaskHandlers, ContextHandlers, MessageHandlers, and A2A payment validations
• Cleans up legacy styling, trailing whitespaces, docstrings, and makes Coveralls upload non-blocking

​

Technical Details

​

Document Analyzer Flow

1. Frontend restricts file uploads to strictly allowed mimetypes (PDF, DOCX)
2. Uploaded file parts are preserved in transport, explicitly keeping FilePart.text intact
3. Backend analyzer extracts the text and injects it into the pipeline for downstream handlers

​

Payment & Context Handling

• Payment contexts now natively support arrays of multi-currency and multi-asset requirements
• The A2A routing layer guarantees the payment context is injected exactly once and stripped when not needed, preventing duplicate state data

​

Scheduler & Storage Behavior

• The scheduler loop execution now safely avoids AnyIO buffer deadlocks and busy‑loop CPU consumption
• Trace serialization is restructured to safely handle massive or complex trace payloads without failing

​

Auth Middleware

• The Hydra middleware bypasses the synchronous event loop and runs as Pure ASGI
• Stream lifecycle handlers strictly manage connection drops to prevent resource leaks in concurrent environments

​

Configuration

​

Environment Variables

# Agent Deployment URL is now strictly validated
DEPLOYMENT__URL=http://localhost:3773

# Required for the DSPy / Document Analyzer examples
OPENROUTER_API_KEY=sk-or-v1-...

​

Migration Guide

​

For Existing Deployments

​

For New Deployments

​

Security Considerations

​

Performance Impact

• CPU: Eliminated busy-wait loops in the scheduler during edge cases, vastly reducing idle CPU overhead
• Memory: Storage refactors reduce RAM pressure on massive datasets via optimized DB indexing
• UX: Rendering performance improved by eliminating visual flicker during chat history navigation

​

Testing

​

Test Coverage Improvements

​

Coverage Metrics

• Increased from 58.59% to 60.11% (+1.52% improvement)
• Total: 688 tests passing with 7 warnings
• Coverage threshold adjusted from 64% to 60% for realistic targets

​

New Tests Added (44 total)

• Task execution flows (basic, input-required, auth-required)
• Payment context integration and settlement
• Agent error handling and recovery
• System message injection with structured responses
• Context-based history building
• Coverage improved: 58.29% → 82.89% (+24.6%)

• Configuration validation (storage, scheduler, telemetry, Sentry)
• Custom penguin_id, URL, port, version handling
• Debug mode, CORS origins, authentication setup
• Default values and attribute initialization
• Coverage improved: 16.37% → ~30%

• Context manager functionality
• Storage and scheduler attribute handling
• Push manager initialization
• Manifest handling with None values
• Coverage improved: 66.67% → ~75%

​

Code Quality Fixes

• Fixed 11 type checking errors with proper TaskSendParams typing
• Added missing docstrings to test builder classes (TaskBuilder, MessageBuilder, ContextBuilder, ArtifactBuilder)
• Improved docstring formatting (imperative mood, removed extra blank lines)
• Removed unused imports (AsyncMock, patch, pytest)
• Added UUID import for proper type annotations
• Updated .secrets.baseline for test fixtures

​

Pre-commit Checks

​

Files Changed

​

New Files

• Document analyzer agent codebase, skill.yaml, and .env.example
• examples/beginner/dspy_example.py (and associated unit tests)
• LangGraph structured workflow example

​

Modified Files

• Scheduler and storage modules (deadlock/OOM hotfixes)
• Hydra auth middleware (ASGI migration)
• Payment/A2A handlers (multi-currency handling)
• UI components (Agent Inspector, flicker fix, ARIA attributes)
• Configuration validation (deployment checks, constants refactoring)
• All localized README.md variations

​

Contributors

• Paraschamoli
• chandan-1427
• varshayadav6
• codesoumya2006
• Prateekiiitg56
• Co-vengers
• nexpectArpit
• AseemPrasad
• shrguhaneogi-pixel
• udaykiran243
• arnab2001
• Suvam-paul145
• Subhajitdas99
• DeviPadmavathi-LE
• PardhaviArimilli
• A-VISHAL
• amr1tanshu
• underratedgitter

​

Benefits

​

📄 Enhanced Document Processing

• Reliable text extraction from PDF and DOCX files
• Consistent FilePart.text propagation for downstream handlers
• Production-ready document analyzer agent

​

💪 Improved Reliability

• Eliminated scheduler deadlocks and CPU burn issues
• Hardened storage layer with better memory management
• Pure ASGI auth middleware for better concurrency

​

💳 Robust Payment Handling

• Multi-currency and multi-asset support
• Strict validation prevents payment context corruption
• No more duplicate payment context injection

​

♿ Better Accessibility

• Screen-reader friendly navigation
• Keyboard accessibility improvements
• Improved UI responsiveness

​

🧪 Higher Code Quality

• 44 new tests across critical components
• +1.52% test coverage improvement
• Better type safety and documentation