Bindu Files

Release: Document Analyzer & Reliability Improvements Version: 2026.12.5 Date: March 19, 2026

OVERVIEW

Maintenance and feature release focused on document analysis, payment robustness, scheduler and storage reliability, and usability improvements across the UI and configuration. This release also introduces a DSPy agent example, structured LangGraph workflow integration, and multiple accessibility and documentation enhancements contributed by the community.

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

FEATURES

1. Document Analyzer Agent & Frontend Integration
2. Adds a dedicated document analyzer agent with skills wiring and workflow examples for document processing
3. Frontend explicitly allows PDF and DOCX mimetypes and handles animated formats appropriately
4. Ensures uploaded FilePart objects preserve the text property so downstream handlers can operate on content

5. Includes dedicated .env and skill.yaml files for immediate plug-and-play usage

6. DSPy Agent & Structured LangGraph Workflows

7. Introduces a new DSPy agent example in examples/beginner/ demonstrating question-answering behavior
8. Adds comprehensive unit tests for the DSPy example to validate behavior and guard against regressions

9. Integrates a structured LangGraph workflow example to showcase advanced orchestration patterns within Bindu

10. Payments & Multi‑Currency Support

11. Extends payment logic allowing agents to accept multiple payment currencies in a single configuration
12. Implements multi‑asset payment requirements with improved payment context validation
13. Fixes duplicate payment context injection in the A2A message/send endpoint

14. Prevents 500 Server Errors when payment states are only partially set or malformed

15. Storage, Scheduler, and Auth Reliability

16. Refactors the storage layer to harden the in‑memory subsystem, reduce OOM risks, and optimize database indexing
17. Fixes scheduler behavior to resolve AnyIO buffer deadlocks, CPU burn loops, and trace serialization issues

18. Migrates Hydra auth middleware to a pure ASGI implementation for concurrency, WebSocket support, and lifecycle handling

19. UI & Accessibility Enhancements

20. Introduces a collapsible Agent Inspector with clearer empty states for a better first-agent experience
21. Adds skip‑to‑content links and main landmarks to improve screen-reader accessibility and keyboard navigation

22. Eliminates UI flicker when switching between previous chats, improving perceived responsiveness

23. Configuration & Validation Improvements

24. Adds fail‑fast validation for required deployment.url in agent configuration
25. Improves nested required field validation with much clearer developer error messages

26. Moves key settings constants into dedicated modules to clarify configuration boundaries

27. Documentation Updates

28. Refreshes README with improved visuals (header/footer, quotes) and clearer getting-started guidance
29. Documents API key prerequisites (including in the Hindi README) to ensure external providers are configured correctly
30. Refreshes .env examples to reflect newer dependencies (e.g., OpenRouter)

31. Fixes broken links in translated READMEs and aligns license/test‑coverage docs

32. Testing & Code Quality

33. Expands TaskManager tests to cover edge cases, lifecycles, and security scenarios
34. Adds robust tests for TaskHandlers, ContextHandlers, MessageHandlers, and A2A payment validations
35. 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 (Example):

:::bash
# 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-...

BREAKING CHANGES

• Stricter Configuration Validation
• Impact: Previously misconfigured deployments missing a deployment.url or nested fields will now fail fast on boot instead of failing silently later.
• Migration: Ensure your agent_config.json includes all strictly required deployment routing fields.
• Constants Reorganization
• Impact: Example projects relying on older, deeply imported constants may fail to import.
• Migration: Update your imports to use the new dedicated constants modules.

MIGRATION NOTES

For Existing Deployments:

1. Review agent configurations and ensure deployment.url is properly set.
2. Confirm any custom payment configurations map correctly to the new multi-currency validation rules.
3. If you use custom scheduler, storage, or Hydra auth extensions, rebase your forks onto the new modules to inherit the deadlock and ASGI safety fixes.

For New Deployments:

1. Use the new DSPy, LangGraph, or Document Analyzer templates to bootstrap advanced agents.
2. Base your initial .env and skill.yaml files strictly on the newly provided examples to ensure all API prerequisites are satisfied.
3. Consult the updated API prerequisites section in the README.

SECURITY CONSIDERATIONS

• Pure ASGI Hydra middleware significantly reduces the attack surface for slowloris/DoS attacks.
• Tightened exception blocks prevent the system from swallowing errors and masking hidden failures.
• Strict payment context validation prevents bad actors from spoofing billing or corrupting payment states.

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

✅ Unit tests for TaskManager edge cases, lifecycle, and security behavior ✅ Tests for TaskHandlers, ContextHandlers, MessageHandlers, and A2A payment validations ✅ Document analyzer tests for file‑part text propagation and mimetype handling ✅ Additional tests for auth, configuration validation, and example dependencies ✅ All existing test suites updated and passing

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

DOCUMENTATION

• Updated UI elements on READMEs with modern styling
• Expanded setup docs including explicit API provider prerequisites
• Fixed localization routing for Hindi documentation
• Adjusted Test Coverage and License notes to match CI workflows

TEST COVERAGE IMPROVEMENTS

Major expansion of test coverage and code quality 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):

• ManifestWorker: +15 comprehensive async tests
• 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%)

• BinduApplication: +20 initialization tests

• 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%

• TaskManager: +9 tests

• 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: ✅ All checks passing: ruff, type checking (ty), pydocstyle, bandit, secrets baseline ✅ YAML validation, trailing whitespace, end of files ✅ Pytest with coverage (60%+ requirement met)

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