v0.4.0

[0.4.0]

⚠️ IMPORTANT NOTICE - SIGNIFICANT CONFIGURATION CHANGES

This release introduces significant changes to the accelerator configuration for defining document classes and attributes. The configuration format has been migrated to JSON Schema standards, which provides enhanced flexibility and validation capabilities.

While automatic migration is provided for backward compatibility, customers MUST fully test this update in a non-production environment before upgrading production systems. We strongly recommend:

1. Deploy the update to a test/development environment first
2. Verify all document processing workflows function as expected
3. Test with representative samples of your production documents
4. Review the migration guide at docs/json-schema-migration.md
5. Only proceed with production upgrade after thorough validation

Do not upgrade production systems without completing validation testing.

Added

• Agent Companion Chat Experience

  • Added comprehensive interactive AI assistant interface providing real-time conversational support for the IDP Accelerator
  • Session-Based Architecture: Transformed from job-based (single request/response) to session-based (multi-turn conversations) with unified agentic chat experience
  • Persistent Chat Memory: DynamoDB-backed conversation history with automatic loading of last 20 turns, turn-based message grouping, and intelligent context management with sliding window optimization
  • Real-Time Streaming: AppSync GraphQL subscriptions enable incremental response streaming with proper async task cleanup and thinking tag removal for clean display
  • Code Intelligence Agent: New specialized agent for code-related assistance with DeepWiki MCP server integration, security guardrails to prevent sensitive data exposure, and user-controlled opt-in toggle (default: enabled)
  • Rich Chat Interface: Modern UI with CloudScape Design System featuring real-time message streaming, multi-agent support (Analytics, Code Intelligence, Error Analyzer, General), Markdown rendering with syntax highlighting, structured data visualization (charts via Chart.js, sortable tables), expandable tool usage sections, sample prompts, and auto-scroll behavior
  • Privacy & Security: Explicit user consent for Code Intelligence third-party services, session isolation with unique session IDs, error boundary protection, input validation

• JSON Schema Format for Class Definitions - docs/json-schema-migration.md

  • Document class definitions now use industry-standard JSON Schema Draft 2020-12 format for improved flexibility and tooling integration
  • Standards-Based Validation: Leverage standard JSON Schema validators and tooling ecosystem for better configuration validation
  • Enhanced Extensibility: Custom IDP properties use standard JSON Schema extension pattern (x-aws-idp-* prefix) for clean separation of concerns
  • Modern Data Contract: Define document structures using widely-adopted JSON Schema format with robust type system (string, number, boolean, object, array)
  • Nested Structure Support: Natural representation of complex documents with nested objects and arrays using JSON Schema's native properties and items keywords
  • Automatic Migration: Existing legacy configurations automatically migrate to JSON Schema format on first load - completely transparent to users
  • Backward Compatible: Legacy format remains supported through automatic migration - no manual configuration updates required
  • Comprehensive Documentation: New migration guide with format comparison, field mapping table, and best practices

• IDP CLI Single Document Status Support with Programmatic Output

  • Enhanced status command to support checking individual document status via new --document-id option as alternative to --batch-id
  • Added programmatic output capabilities with exit codes (0=success, 1=failure, 2=processing) for scripting and automation
  • JSON format output (--format json) provides structured data for parsing in CI/CD pipelines and scripts
  • Live monitoring support with --wait flag works for both batch and single document status checks
  • Mutual exclusion validation ensures only one of --batch-id or --document-id is specified

• Error Analyzer CloudWatch Tool Enhancements

  • Enhanced CloudWatch log filtering with request ID-based filtering for more targeted error analysis
  • Improved XRay tool tracing and logging capabilities for better diagnostic accuracy
  • Enhanced error context correlation between CloudWatch logs and X-Ray traces
  • Consolidated and renamed tools
  • Provided tools access to agent
  • Updated system prompt

• Error Analyzer CloudWatch Tool Enhancements

  • Enhanced CloudWatch log filtering with request ID-based filtering for more targeted error analysis
  • Improved XRay tool tracing and logging capabilities for better diagnostic accuracy
  • Enhanced error context correlation between CloudWatch logs and X-Ray traces
  • Consolidated and renamed tools
  • Provided tools access to agent
  • Updated system prompt

Fixed

• UI Robustness for Orphaned List Entries - #102
  • Fixed UI error banner "failed to get document details - please try again later" appearing when orphaned list entries exist (list# items without corresponding doc# items in DynamoDB tracking table)
  • Root Cause: When a document had a list entry but no corresponding document record, the error would trigger UI banner and prevent display of all documents in the same time shard
  • Solution: Enhanced error handling to gracefully handle missing documents - now only shows error banner if ALL documents fail to load, not just one
  • Enhanced Debugging: Added detailed console logging with full PK/SK information for both list entries and expected document entries to facilitate cleanup of orphaned records
  • User Impact: All valid documents now display correctly even when orphaned list entries exist; debugging information available in browser console for identifying problematic entries