Add Report Builder API, models, and extension clients

[jfrench9]

Summary

Introduces full report builder functionality to the robosystems_client SDK, including new ledger API endpoints, data models, and high-level extension clients for report lifecycle management.

Key Accomplishments

New API Endpoints (7)

Added seven new ledger API modules supporting the complete report lifecycle:

• create_report – Create new reports from a ledger
• get_report – Retrieve a specific report by ID
• list_reports – List all available reports
• delete_report – Remove an existing report
• regenerate_report – Trigger regeneration of a report
• share_report – Share a report with other users/entities
• get_statement – Retrieve financial statement data associated with a report

New Data Models (10)

Introduced strongly-typed request/response models to support the new API surface:

• CreateReportRequest, RegenerateReportRequest, ShareReportRequest – request payloads
• ReportResponse, ReportListResponse – report retrieval responses
• ShareReportResponse, ShareResultItem – sharing workflow responses
• StatementResponse, FactRowResponse – financial statement data models
• StructureSummary, ValidationCheckResponse – supporting metadata models

Extension Clients (2)

• LedgerClient – High-level client wrapping ledger API operations, including a new create_mapping_structure method for building report mapping structures
• ReportClient – Dedicated client providing a clean interface for report CRUD, regeneration, sharing, and statement retrieval

Updated Module Exports

• extensions/__init__.py and extensions/extensions.py updated to register and expose the new LedgerClient and ReportClient
• models/__init__.py updated to export all new model classes

Breaking Changes

None. This is a purely additive feature with no modifications to existing APIs or models.

Testing Notes

• Verify all new API endpoint modules handle both sync and async invocation patterns consistently with existing endpoints
• Test the LedgerClient.create_mapping_structure method with various ledger configurations
• Validate ReportClient operations end-to-end: create → get → list → regenerate → share → delete
• Confirm StatementResponse and FactRowResponse correctly deserialize nested financial data structures
• Ensure new model serialization/deserialization round-trips cleanly (especially ReportResponse at 330 lines, the largest new model)

Infrastructure Considerations

• No new dependencies introduced; all new code builds on the existing client framework and patterns
• The 10 new models and 7 new API modules add ~3,200 lines; ensure documentation generation pipelines pick up the new modules
• Extension client registration should be validated in any integration or environment bootstrap tests

---

🤖 Generated with Claude Code

Branch Info:

• Source: feature/report-builder
• Target: main
• Type: feature

Co-Authored-By: Claude noreply@anthropic.com