@aws/nx-plugin 1.3.0 → 1.3.2

package/src/smithy/project/__snapshots__/generator.spec.ts.snap

@@ -46,7 +46,7 @@ exports[`smithyProjectGenerator > shape libraries > should generate a shape libr
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx cp dist/{projectRoot}/smithy/source/model/model.json dist/{projectRoot}/build/model.json"
         ],
         "parallel": false,
@@ -124,7 +124,7 @@ exports[`smithyProjectGenerator > should generate smithy project with all custom
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build/openapi",
           "shx cp \\"dist/{projectRoot}/smithy/source/openapi/*.openapi.json\\" dist/{projectRoot}/build/openapi/openapi.json"
         ],
@@ -184,7 +184,7 @@ exports[`smithyProjectGenerator > should generate smithy project with custom dir
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build/openapi",
           "shx cp \\"dist/{projectRoot}/smithy/source/openapi/*.openapi.json\\" dist/{projectRoot}/build/openapi/openapi.json"
         ],
@@ -336,7 +336,7 @@ exports[`smithyProjectGenerator > should generate smithy project with default op
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build/openapi",
           "shx cp \\"dist/{projectRoot}/smithy/source/openapi/*.openapi.json\\" dist/{projectRoot}/build/openapi/openapi.json"
         ],
@@ -482,7 +482,7 @@ exports[`smithyProjectGenerator > should generate smithy project with subdirecto
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build/openapi",
           "shx cp \\"dist/{projectRoot}/smithy/source/openapi/*.openapi.json\\" dist/{projectRoot}/build/openapi/openapi.json"
         ],

package/src/smithy/ts/api/__snapshots__/generator.spec.ts.snap

@@ -416,7 +416,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -732,7 +732,7 @@ exports[`tsSmithyApiGenerator > should generate smithy ts api with Terraform pro
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -2176,7 +2176,7 @@ exports[`tsSmithyApiGenerator > should generate smithy ts api with default optio
           "shx rm -rf dist/{projectRoot}/build",
           "shx rm -rf dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build",
-          "npx -y mise@2026.10.14 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
+          "npx -y mise@2026.10.19 exec smithy@1.74.1 -- smithy build -c {projectRoot}/smithy-build.json --output dist/{projectRoot}/smithy",
           "shx mkdir -p dist/{projectRoot}/build/openapi",
           "shx cp \\"dist/{projectRoot}/smithy/source/openapi/*.openapi.json\\" dist/{projectRoot}/build/openapi/openapi.json"
         ],
@@ -2317,7 +2317,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -2630,7 +2630,7 @@ output "waf_web_acl_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -3692,7 +3692,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -4005,7 +4005,7 @@ output "waf_web_acl_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -5056,7 +5056,7 @@ exports[`tsSmithyApiGenerator > terraform iac > should generate terraform with c
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"

package/src/trpc/backend/__snapshots__/generator.spec.ts.snap

@@ -3223,7 +3223,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
   }
 }
@@ -3474,7 +3474,7 @@ output "api_log_group_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -4100,7 +4100,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
   }
 }
@@ -4351,7 +4351,7 @@ output "api_log_group_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -5050,7 +5050,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
   }
 }
@@ -5301,7 +5301,7 @@ output "api_log_group_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -5904,7 +5904,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -6217,7 +6217,7 @@ output "waf_web_acl_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -7280,7 +7280,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -7593,7 +7593,7 @@ output "waf_web_acl_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -8645,7 +8645,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -8958,7 +8958,7 @@ output "waf_web_acl_arn" {
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"

package/src/ts/agent/__snapshots__/generator.spec.ts.snap

@@ -984,7 +984,7 @@ exports[`ts#agent generator > should match snapshot for Terraform generated file
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -1307,7 +1307,7 @@ exports[`ts#agent generator > should match snapshot for Terraform generated file
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -1666,7 +1666,7 @@ resource "null_resource" "runtime_ready" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.115 python -c "
+      uv run --with boto3==1.43.118 python -c "
 import boto3
 import json
 import os

package/src/ts/agent/guardrails/__snapshots__/generator.spec.ts.snap

@@ -439,7 +439,7 @@ exports[`ts#agent#guardrails generator > protocol a2a > should generate the guar
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -988,7 +988,7 @@ exports[`ts#agent#guardrails generator > protocol ag-ui > should generate the gu
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"
@@ -1551,7 +1551,7 @@ exports[`ts#agent#guardrails generator > protocol http > should generate the gua
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"

package/src/ts/dcr-proxy/__snapshots__/generator.spec.ts.snap

@@ -579,7 +579,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     archive = {
       source  = "hashicorp/archive"

package/src/ts/dynamodb/__snapshots__/generator.spec.ts.snap

@@ -35,7 +35,7 @@ exports[`ts#dynamodb generator > should generate terraform modules when iac is t
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
   }
 }
@@ -232,7 +232,7 @@ exports[`ts#dynamodb generator > should generate terraform modules when iac is t
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     random = {
       source  = "hashicorp/random"

package/src/ts/lambda-function/__snapshots__/generator.spec.ts.snap

@@ -141,7 +141,7 @@ exports[`ts-lambda-function generator > terraform iac > should generate terrafor
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     archive = {
       source  = "hashicorp/archive"
@@ -326,7 +326,7 @@ exports[`ts-lambda-function generator > terraform iac > should match snapshot fo
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     archive = {
       source  = "hashicorp/archive"

package/src/ts/mcp-server/__snapshots__/generator.spec.ts.snap

@@ -155,7 +155,7 @@ exports[`ts#mcp-server generator > should match snapshot for Terraform generated
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -514,7 +514,7 @@ resource "null_resource" "runtime_ready" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.115 python -c "
+      uv run --with boto3==1.43.118 python -c "
 import boto3
 import json
 import os

package/src/ts/rdb/__snapshots__/generator.spec.ts.snap

@@ -848,7 +848,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -1519,7 +1519,7 @@ exports[`ts#rdb generator > should generate terraform modules when iac is Terraf
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     external = {
       source  = "hashicorp/external"
@@ -2214,7 +2214,7 @@ terraform {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -2885,7 +2885,7 @@ exports[`ts#rdb generator > should generate terraform modules with MySQL engine
     }
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     external = {
       source  = "hashicorp/external"

package/src/ts/react-website/app/__snapshots__/generator.spec.ts.snap

@@ -131,7 +131,7 @@ exports[`react-website generator > TailwindCSS integration > terraform iac > sho
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
       configuration_aliases = [aws.us_east_1]
     }
     null = {
@@ -745,7 +745,7 @@ resource "null_resource" "upload_website_files" {
   provisioner "local-exec" {
     command = <<-EOT
       cd "$ROOT_PATH"
-      uv run --with boto3==1.43.115 python3 -c "
+      uv run --with boto3==1.43.118 python3 -c "
 import os
 import sys
 import boto3
@@ -868,7 +868,7 @@ resource "null_resource" "cloudfront_invalidation" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.115 python3 -c "
+      uv run --with boto3==1.43.118 python3 -c "
 import boto3
 import os
 import sys
@@ -954,7 +954,7 @@ output "waf_web_acl_arn" {
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
       configuration_aliases = [aws.us_east_1]
     }
   }
@@ -1061,7 +1061,7 @@ runtime-config.json
 
 exports[`react-website generator > Tanstack router integration > should generate website with no router correctly > biome.json 1`] = `
 "{
-  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
   "root": true,
   "formatter": {
     "enabled": true,
@@ -1086,6 +1086,16 @@ exports[`react-website generator > Tanstack router integration > should generate
       "enabled": false
     }
   },
+  "markdown": {
+    "formatter": {
+      "enabled": false
+    }
+  },
+  "yaml": {
+    "formatter": {
+      "enabled": false
+    }
+  },
   "linter": {
     "enabled": true,
     "rules": {
@@ -1242,11 +1252,11 @@ exports[`react-website generator > Tanstack router integration > should generate
   "name": "@proj/source",
   "dependencies": {},
   "devDependencies": {
-    "@nx/js": "23.3.0",
+    "@nx/js": "23.3.1",
     "@nx/react": "catalog:",
-    "@nx/vite": "23.3.0",
+    "@nx/vite": "23.3.1",
     "@nx/vitest": "catalog:",
-    "@nx/web": "23.3.0",
+    "@nx/web": "23.3.1",
     "@swc/helpers": "~0.5.18",
     "@tailwindcss/vite": "catalog:",
     "@testing-library/dom": "10.4.0",
@@ -2377,21 +2387,21 @@ exports[`react-website generator > Tanstack router integration > should generate
   - packages/common/*
 catalog:
   '@types/node': 26.6.5
-  vite: 8.3.4
-  vitest: 5.0.4
-  '@vitest/coverage-v8': 5.0.4
+  vite: 8.3.5
+  vitest: 5.0.5
+  '@vitest/coverage-v8': 5.0.5
   jsdom: 29.1.1
-  '@nx/vitest': 23.3.0
+  '@nx/vitest': 23.3.1
   constructs: 10.8.1
-  aws-cdk-lib: 2.273.0
+  aws-cdk-lib: 2.274.0
   react: 19.3.1
   react-dom: 19.3.1
-  '@cloudscape-design/components': 3.0.1401
-  '@cloudscape-design/board-components': 3.0.238
+  '@cloudscape-design/components': 3.0.1404
+  '@cloudscape-design/board-components': 3.0.240
   '@cloudscape-design/global-styles': 1.0.71
   tailwindcss: 4.3.3
-  '@nx/react': 23.3.0
-  '@vitest/ui': 5.0.4
+  '@nx/react': 23.3.1
+  '@vitest/ui': 5.0.5
   '@tailwindcss/vite': 4.3.3
 "
 `;
@@ -2988,7 +2998,7 @@ runtime-config.json
 
 exports[`react-website generator > Tanstack router integration > should generate website with router correctly > biome.json 1`] = `
 "{
-  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.6.3/schema.json",
   "root": true,
   "formatter": {
     "enabled": true,
@@ -3013,6 +3023,16 @@ exports[`react-website generator > Tanstack router integration > should generate
       "enabled": false
     }
   },
+  "markdown": {
+    "formatter": {
+      "enabled": false
+    }
+  },
+  "yaml": {
+    "formatter": {
+      "enabled": false
+    }
+  },
   "linter": {
     "enabled": true,
     "rules": {
@@ -3169,11 +3189,11 @@ exports[`react-website generator > Tanstack router integration > should generate
   "name": "@proj/source",
   "dependencies": {},
   "devDependencies": {
-    "@nx/js": "23.3.0",
+    "@nx/js": "23.3.1",
     "@nx/react": "catalog:",
-    "@nx/vite": "23.3.0",
+    "@nx/vite": "23.3.1",
     "@nx/vitest": "catalog:",
-    "@nx/web": "23.3.0",
+    "@nx/web": "23.3.1",
     "@swc/helpers": "~0.5.18",
     "@tailwindcss/vite": "catalog:",
     "@tanstack/router-generator": "catalog:",
@@ -4308,25 +4328,25 @@ exports[`react-website generator > Tanstack router integration > should generate
   - packages/common/*
 catalog:
   '@types/node': 26.6.5
-  vite: 8.3.4
-  vitest: 5.0.4
-  '@vitest/coverage-v8': 5.0.4
+  vite: 8.3.5
+  vitest: 5.0.5
+  '@vitest/coverage-v8': 5.0.5
   jsdom: 29.1.1
-  '@nx/vitest': 23.3.0
+  '@nx/vitest': 23.3.1
   constructs: 10.8.1
-  aws-cdk-lib: 2.273.0
+  aws-cdk-lib: 2.274.0
   react: 19.3.1
   react-dom: 19.3.1
-  '@cloudscape-design/components': 3.0.1401
-  '@cloudscape-design/board-components': 3.0.238
+  '@cloudscape-design/components': 3.0.1404
+  '@cloudscape-design/board-components': 3.0.240
   '@cloudscape-design/global-styles': 1.0.71
   tailwindcss: 4.3.3
-  '@tanstack/react-router': 1.170.45
-  '@nx/react': 23.3.0
-  '@vitest/ui': 5.0.4
+  '@tanstack/react-router': 1.170.46
+  '@nx/react': 23.3.1
+  '@vitest/ui': 5.0.5
   '@tailwindcss/vite': 4.3.3
-  '@tanstack/router-plugin': 1.168.47
-  '@tanstack/router-generator': 1.167.45
+  '@tanstack/router-plugin': 1.168.48
+  '@tanstack/router-generator': 1.167.46
   '@tanstack/virtual-file-routes': 1.162.0
   '@tanstack/router-utils': 1.162.4
 "

package/src/ts/react-website/cognito-auth/__snapshots__/generator.terraform.spec.ts.snap

@@ -6,7 +6,7 @@ exports[`cognito-auth generator terraform iac > should generate terraform files
   required_providers {
     aws = {
       source  = "hashicorp/aws"
-      version = "6.69.1"
+      version = "6.70.0"
     }
     null = {
       source  = "hashicorp/null"
@@ -67,7 +67,7 @@ resource "null_resource" "add_callback_url" {
 
   provisioner "local-exec" {
     command = <<-EOT
-      uv run --with boto3==1.43.115 python -c "
+      uv run --with boto3==1.43.118 python -c "
 import boto3
 import os
 import sys

package/src/utils/agent-core-constructs/files/cdk/app/agent-core/__nameKebabCase__/__nameKebabCase__.ts.template

@@ -162,7 +162,7 @@ export class <%- nameClassName %> extends Construct implements IGrantable, IConn
     this.code = AgentRuntimeArtifact.fromCodeAsset({
       path: bundleDir,
       runtime: AgentCoreRuntime.<%- codeRuntime %>,
-      entrypoint: ['opentelemetry-instrument', '<%- codeEntryPoint %>'],
+      entrypoint: [<% if (!codeRuntime.startsWith('PYTHON_')) { %>'opentelemetry-instrument', <% } %>'<%- codeEntryPoint %>'],
     });
 <%_ } _%>
 

package/src/utils/agent-core-constructs/files/terraform/core/agent-core-code/runtime.tf.template

@@ -140,7 +140,7 @@ module "runtime" {
     # The `opentelemetry-instrument` prefix auto-instruments with the AWS Distro
     # for OpenTelemetry packaged alongside the code.
     # https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/observability-configure.html
-    entry_point = ["opentelemetry-instrument", var.code_entry_point]
+    entry_point = var.code_entry_point == "agentcore_launcher.py" ? [var.code_entry_point] : ["opentelemetry-instrument", var.code_entry_point]
     runtime     = var.code_runtime
     s3_bucket   = aws_s3_object.agent_core_code.bucket
     s3_key      = aws_s3_object.agent_core_code.key

package/src/utils/agent-core-packaging.d.ts

@@ -25,6 +25,9 @@ export declare const isContainerHosted: (infra: AgentCoreInfra) => boolean;
 export declare const agentCoreNodeRuntime: () => string;
 /** The AgentCore managed runtime a Python component targets. */
 export declare const agentCorePythonRuntime: () => string;
+export declare const PYTHON_AGENT_CORE_LAUNCHER = "agentcore_launcher.py";
+/** Run instrumentation with the managed interpreter, independent of console-script shebangs. */
+export declare const pythonAgentCoreLauncher: (entryPointFileName: string) => string;
 /**
  * Dependencies a caller must declare to add a code (`.zip`) packaging target.
  *
@@ -117,10 +120,10 @@ export interface AddPythonCodePackageTargetOptions {
  * Add a target assembling the deployable code package for a Python AgentCore
  * Runtime.
  *
- * The package is the arm64 dependency bundle (which already carries
- * `bin/opentelemetry-instrument` from `aws-opentelemetry-distro`, satisfying
- * AgentCore's requirement that OpenTelemetry be present), the project's own
- * module tree, and a root entry point script.
+ * The package contains the arm64 dependency bundle with `aws-opentelemetry-distro`,
+ * the project's module tree, its root entry point and an instrumentation launcher.
+ * The launcher calls OpenTelemetry's `run()` with `sys.executable` and the original
+ * entry point, so a console-script shebang cannot select the build machine's Python.
  *
  * The entry point sits at the package root rather than inside the module:
  * AgentCore runs it as a file path, and Python gives a script run that way no