AWS Powertools for Lambda Files

Summary

In this release, the Parameters utility gains support for the AWS AppConfig Agent Lambda extension. A new getConfig function fetches application configurations from the agent's local HTTP endpoint, without the AWS SDK and without a cache to manage, since caching, polling, and prefetching are all handled by the agent.

In Logger, the log buffer and the debug sampling log level are now scoped per invocation under Lambda Managed Instances concurrency, so concurrent invocations no longer clear each other's buffered logs or override each other's sampling decision. Logger also now accepts IANA timezone aliases such as Asia/Kolkata in the TZ environment variable, which were previously rejected and produced timestamps for the wrong instant. When a timezone can't be resolved at all, Logger now falls back to UTC consistently and emits a warning, instead of doing so silently.

The Parser utility adds a schema for Amazon Connect Outbound Campaigns custom action events.

Finally, the documentation site has been restyled to match the AWS Developer Guide.

[!IMPORTANT] The project's Discord server has been shut down. Community conversations now happen in GitHub Discussions, and all Discord links in the READMEs, docs, and issue templates now point there.

⭐ Congratulations to @leiwilson for their first PR merged in the project 🎉

AppConfig Agent support

If you use the AWS AppConfig Agent Lambda extension, you can now fetch application configurations from the agent's local HTTP endpoint with getConfig:

:::typescript
import { getConfig } from '@aws-lambda-powertools/parameters/appconfig-agent';

const config = await getConfig('my-configuration', {
  environment: 'my-env',
  application: 'my-app',
  transform: 'json',
});

export const handler = async (): Promise<void> => {
  console.log(config);
};

A few things to know:

• You must add the AppConfig Agent Lambda extension layer to your function. getConfig talks to it over the agent's local endpoint, so it doesn't need the AWS SDK.
• Because the agent handles caching, polling, and prefetching, the maxAge and forceFetch options don't apply. You can reduce cold start latency by setting AWS_APPCONFIG_EXTENSION_PREFETCH_LIST so the agent fetches your configuration before your handler runs.
• When the configuration doesn't exist, getConfig returns undefined, so you can fall back with ??, or set throwOnMissing to get a ParameterNotFoundError instead. Any other failure to reach the agent throws a GetParameterError.
• Outside of Lambda, or when POWERTOOLS_DEV is enabled, getConfig returns undefined without making a request, so your tests never need to mock the agent. Set POWERTOOLS_APPCONFIG_AGENT_RETURN_VALUE when you want it to return a value instead.

Changes

• refactor(logger): isolate log level InvokeStore access in a store (#5548) by @vishwakt
• fix(logger): scope log buffer per invocation under LMI concurrency (#5543) by @vishwakt
• fix(logger): scope debug sampling log level per invocation under LMI concurrency (#5544) by @vishwakt
• chore(ci): remove boring-cyborg and semantic config files (#5535) by @dreamorosi
• chore(ci): remove greetings now handled by oss-automation (#5532) by @dreamorosi
• chore: replace Discord server with GitHub Discussions (#5530) by @dreamorosi
• docs: restyle documentation to match AWS Developer Guide (#5426) by @dreamorosi
• chore(ci): group CodeQL Action Dependabot updates (#5521) by @dreamorosi
• docs(metrics): document InvokeStore isolation and local testing (#5486) by @leiwilson
• ci: replace CodeQL default setup with advanced setup for fork PRs (#5507) by @svozza
• feat(parser): add schema for Amazon Connect Outbound Campaigns (#5502) by @dreamorosi
• feat(ci): auto-trigger make-release and docs rebuild on PR merge (#5487) by @svozza
• feat(ci): fold GovCloud/China layer publishing into Make Release (#5462) by @svozza
• feat(parameters): add support for AppConfig Agent (#5399) by @svozza
• chore: clean up issue templates (#5470) by @dreamorosi
• chore(ci): remove SonarCloud integration (#5468) by @dreamorosi
• docs(readme): add Signer, Data Masking, and Kafka utilities (#5464) by @svozza
• fix(logger): accept resolvable IANA timezone aliases in timestamps (#5458) by @dreamorosi
• fix(ci): skip paused regions in update_layer_arn.sh (#5457) by @dreamorosi
• docs(maintainers): remove stale layer version note-taking instruction (#5454) by @svozza

🔧 Maintenance

• chore(deps): bump the aws-cdk group across 1 directory with 3 updates (#5524) by @dependabot[bot]
• chore(deps-dev): bump @valkey/valkey-glide from 2.5.0 to 2.5.1 (#5559) by @dependabot[bot]
• chore(deps): bump the codeql-action group across 1 directory with 3 updates (#5562) by @dependabot[bot]
• chore(deps-dev): bump @biomejs/biome from 2.5.7 to 2.5.8 (#5560) by @dependabot[bot]
• chore(deps-dev): bump @redis/client from 6.2.0 to 6.2.1 (#5558) by @dependabot[bot]
• chore(deps): bump the aws-sdk-v3 group across 1 directory with 48 updates (#5553) by @dependabot[bot]
• chore(deps-dev): bump protobufjs from 8.7.1 to 8.7.2 (#5551) by @dependabot[bot]
• chore(deps): bump esbuild from 0.28.1 to 0.28.2 (#5552) by @dependabot[bot]
• chore(deps): bump zgosalvez/github-actions-ensure-sha-pinned-actions from 5.0.6 to 5.0.7 (#5549) by @dependabot[bot]
• chore(deps): bump @types/node from 26.1.2 to 26.2.0 (#5550) by @dependabot[bot]
• chore(deps-dev): bump @biomejs/biome from 2.5.6 to 2.5.7 (#5547) by @dependabot[bot]
• chore(deps): bump pymdown-extensions from 11.0 to 11.0.1 in /docs (#5546) by @dependabot[bot]
• chore(deps): bump gitpython from 3.1.57 to 3.1.58 in /docs (#5545) by @dependabot[bot]
• chore(deps): bump the codeql-action group across 1 directory with 3 updates (#5540) by @dependabot[bot]
• chore(deps-dev): bump undici-types from 8.9.0 to 8.10.0 (#5539) by @dependabot[bot]
• chore(deps): bump constructs from 10.8.0 to 10.8.1 (#5538) by @dependabot[bot]
• chore(deps): bump the codeql-action group across 1 directory with 3 updates (#5536) by @dependabot[bot]
• chore(deps): bump the aws-sdk-v3 group across 1 directory with 13 updates (#5534) by @dependabot[bot]
• chore(deps): bump gitpython from 3.1.54 to 3.1.57 in /docs (#5529) by @dependabot[bot]
• chore(deps-dev): bump @redis/client from 6.1.0 to 6.2.0 (#5527) by @dependabot[bot]
• chore(deps): bump zgosalvez/github-actions-ensure-sha-pinned-actions from 5.0.5 to 5.0.6 (#5528) by @dependabot[bot]
• chore(deps): bump the aws-sdk-v3 group across 1 directory with 65 updates (#5523) by @dependabot[bot]
• chore(deps-dev): bump lint-staged from 17.2.0 to 17.3.0 (#5525) by @dependabot[bot]
• chore(deps): bump the codeql-action group across 1 directory with 3 updates (#5526) by @dependabot[bot]
• chore(deps-dev): bump @biomejs/biome from 2.5.5 to 2.5.6 (#5510) by @dependabot[bot]
• chore(deps): bump release-drafter/release-drafter from 7.6.0 to 7.7.0 (#5513) by @dependabot[bot]
• chore(deps): bump @types/node from 26.1.1 to 26.1.2 (#5509) by @dependabot[bot]
• chore(deps): bump constructs from 10.7.1 to 10.8.0 (#5517) by @dependabot[bot]
• chore(deps): bump actions/stale from 10.4.0 to 11.0.0 (#5508) by @dependabot[bot]
• chore(deps-dev): bump markdownlint-cli2 from 0.23.1 to 0.23.2 (#5505) by @dependabot[bot]
• chore(deps): bump pymdown-extensions from 10.21.3 to 11.0 in /docs (#5504) by @dependabot[bot]
• chore(deps): bump gitpython from 3.1.52 to 3.1.54 in /docs (#5503) by @dependabot[bot]
• chore(deps-dev): bump @aws-crypto/client-node from 5.0.0 to 5.0.2 (#5499) by @dependabot[bot]
• chore(deps-dev): bump lint-staged from 17.1.1 to 17.2.0 (#5496) by @dependabot[bot]
• chore(deps): bump aws-actions/configure-aws-credentials from 6.2.2 to 6.2.3 (#5495) by @dependabot[bot]
• chore(deps): bump actions/checkout from 7.0.0 to 7.0.1 (#5497) by @dependabot[bot]
• chore(deps): bump ossf/scorecard-action from 2.4.3 to 2.4.4 (#5498) by @dependabot[bot]
• chore(deps-dev): bump undici-types from 8.8.0 to 8.9.0 (#5500) by @dependabot[bot]
• chore(deps): bump gitpython from 3.1.50 to 3.1.52 in /docs (#5494) by @dependabot[bot]
• chore(deps-dev): bump lint-staged from 17.1.0 to 17.1.1 (#5493) by @dependabot[bot]
• chore(deps): bump github/codeql-action/upload-sarif from 4.37.1 to 4.37.3 (#5492) by @dependabot[bot]
• chore(deps-dev): bump @biomejs/biome from 2.5.4 to 2.5.5 (#5489) by @dependabot[bot]
• chore(deps-dev): bump undici-types from 8.7.0 to 8.8.0 (#5490) by @dependabot[bot]
• chore(deps): bump actions/checkout from 7.0.0 to 7.0.1 (#5488) by @dependabot[bot]
• chore(deps): bump the aws-cdk group across 1 directory with 2 updates (#5485) by @dependabot[bot]
• chore(deps-dev): bump lint-staged from 17.0.8 to 17.1.0 (#5483) by @dependabot[bot]
• chore(deps): bump constructs from 10.7.0 to 10.7.1 (#5482) by @dependabot[bot]
• chore(deps): bump actions/setup-python from 6.3.0 to 7.0.0 (#5481) by @dependabot[bot]
• chore(deps): bump release-drafter/release-drafter from 7.5.1 to 7.6.0 (#5480) by @dependabot[bot]
• chore(deps): bump squidfunk/mkdocs-material from 868ad4d to 51b8714 in /docs (#5479) by @dependabot[bot]
• chore(deps): bump mkdocs-material from 9.7.6 to 9.7.7 in /docs (#5478) by @dependabot[bot]
• chore(deps): bump the aws-sdk-v3 group across 1 directory with 67 updates (#5484) by @dependabot[bot]
• chore(deps-dev): bump @aws/durable-execution-sdk-js from 2.1.0 to 2.2.0 (#5477) by @dependabot[bot]
• chore(deps-dev): bump markdownlint-cli2 from 0.23.0 to 0.23.1 (#5476) by @dependabot[bot]
• chore(deps-dev): bump @biomejs/biome from 2.5.3 to 2.5.4 (#5472) by @dependabot[bot]
• chore(deps): bump github/codeql-action/upload-sarif from 4.37.0 to 4.37.1 (#5475) by @dependabot[bot]
• chore(deps): bump constructs from 10.6.0 to 10.7.0 (#5474) by @dependabot[bot]
• chore(deps): bump actions/setup-go from 6.5.0 to 7.0.0 (#5473) by @dependabot[bot]
• chore(deps-dev): bump @valkey/valkey-glide from 2.4.2 to 2.5.0 (#5471) by @dependabot[bot]
• chore(deps): bump actions/setup-node from 6.4.0 to 7.0.0 (#5466) by @dependabot[bot]
• chore(deps): bump the aws-cdk group across 1 directory with 2 updates (#5461) by @dependabot[bot]
• chore(deps-dev): bump protobufjs from 8.7.0 to 8.7.1 (#5459) by @dependabot[bot]
• chore(deps): bump the aws-sdk-v3 group across 1 directory with 69 updates (#5460) by @dependabot[bot]
• chore(deps): bump actions/stale from 10.3.0 to 10.4.0 (#5452) by @dependabot[bot]

This release was made possible by the following contributors:

@dreamorosi, @leiwilson, @svozza, @vishwakt, @dependabot[bot] and @sdangol