agents.md

Agent Reference

Reference information for AI agents working with this codebase.

Source Repository

• Repository: https://github.com/aws-solutions/innovation-sandbox-on-aws
• Documentation: https://docs.aws.amazon.com/solutions/latest/innovation-sandbox-on-aws/solution-overview.html

API Specification

OpenAPI spec downloaded from upstream:

https://raw.githubusercontent.com/aws-solutions/innovation-sandbox-on-aws/refs/heads/main/docs/openapi/innovation-sandbox-api.yaml

Use make update-spec to fetch the latest version.

Client Implementation

See spec-reference.md for complete function mapping, types, and constants.

Upstream Handler Files

Endpoint	Handler File
/leases/*	source/lambdas/api/leases/src/leases-handler.ts
/leaseTemplates/*	source/lambdas/api/lease-templates/src/lease-templates-handler.ts
/accounts/*	source/lambdas/api/accounts/src/accounts-handler.ts
/configurations	source/lambdas/api/configurations/src/configurations-handler.ts

Known Spec Issues

ReviewLease Action Values

Spec incorrectly references ThresholdAction enum (ALERT, FREEZE_ACCOUNT). Actual values are "Approve" and "Deny". Our client is correct.

GlobalConfiguration Structure

Spec is incomplete. Actual API merges GlobalConfig + ReportingConfig. Our client includes fields from both:

• costReportGroups, requireCostReportGroup (from ReportingConfig)
• isbManagedRegions (from getGlobalConfigForUI)
• requireMaxBudget, requireMaxDuration, ttl (from GlobalLeasesConfig)