feat: enhance error handling with detailed logging and structured err…

[demeyerthom]

This pull request introduces enhanced error handling and logging capabilities across the codebase. The changes include defining a new Error model, updating error extraction logic to provide more detailed error messages, and adding structured error definitions to the OpenAPI specification.

Error Handling Enhancements:

• Added Error model to SDK: Defined a new Error struct in internal/sdk/main.gen.go to represent API error responses, including fields for Details, Message, RequestId, and Sys.
• Improved error extraction logic: Updated the ExtractErrorResponse function in internal/utils/client.go to parse API error responses into the new Error model, log serialization issues, and include structured error details in the output.

Logging Improvements:

• Enhanced error logging: Added better error logging to include descriptive messages and additional details, as documented in .changes/unreleased/Fixed-20250613-111754.yaml.
• Integrated logging library: Imported the terraform-plugin-log/tflog package in internal/utils/client.go for structured logging.

OpenAPI Specification Updates:

• Defined Error schema: Added an Error object definition to the OpenAPI specification in openapi.yaml, ensuring consistency between the API contract and the new Error model.