Skip to content

Improve AWS error reporting and document proxy support#43

Merged
GrahamCampbell merged 1 commit into
mainfrom
fix/error-reporting-and-docs
Jun 11, 2026
Merged

Improve AWS error reporting and document proxy support#43
GrahamCampbell merged 1 commit into
mainfrom
fix/error-reporting-and-docs

Conversation

@GrahamCampbell

Copy link
Copy Markdown
Contributor

Unhandled AWS service errors, such as an access denial while polling the remote state stack, previously rendered as framework crashes with full stack traces. The exception tokenizer now classifies errors carrying an own $metadata property as user errors and, when no code is present, synthesizes a stable one from the AWS error name, for example AWS_ACCESS_DENIED; explicit codes are preserved, and the gate is strict so genuine bugs keep their stack traces. This matches the behavior osls ships, and the stack trace remains available in the verbose log either way.

The getAwsErrorCode helper was duplicated inline in three state modules; it now lives in src/utils/aws/ and is exported alongside the other AWS utilities, with the three consumers importing it from there. The behavior is unchanged.

The README gains a note that compose honors the same proxy, custom certificate authority, and timeout environment variables as osls for its own AWS requests, linking to the new proxy section in the osls credentials guide. While touching those links it turned out the existing documentation links pointed at a main branch that does not exist on the osls repository, so they returned not-found pages; they now point at 4.x.

@GrahamCampbell GrahamCampbell merged commit 5f49399 into main Jun 11, 2026
4 checks passed
@GrahamCampbell GrahamCampbell deleted the fix/error-reporting-and-docs branch June 11, 2026 21:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant