@aws/nx-plugin 1.0.0-rc.56 → 1.0.0-rc.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (179) hide show
  1. package/LICENSE-THIRD-PARTY +2917 -1295
  2. package/migrations.json +34 -24
  3. package/package.json +13 -13
  4. package/src/agentcore-gateway/generator.d.ts +16 -1
  5. package/src/agentcore-gateway/generator.js +3 -2
  6. package/src/agentcore-gateway/generator.js.map +1 -1
  7. package/src/agentcore-gateway/schema.json +1 -0
  8. package/src/connection/scaffold-catalog.d.ts +160 -0
  9. package/src/connection/scaffold-catalog.js +207 -0
  10. package/src/connection/scaffold-catalog.js.map +1 -0
  11. package/src/connection/schema-resolver.d.ts +5 -0
  12. package/src/connection/schema-resolver.js +27 -0
  13. package/src/connection/schema-resolver.js.map +1 -0
  14. package/src/infra/app/__snapshots__/generator.spec.ts.snap +7 -7
  15. package/src/migrations/latest/smithy-ssdk-bundle-pins/migration.js +78 -0
  16. package/src/migrations/latest/smithy-ssdk-bundle-pins/migration.js.map +1 -0
  17. package/src/migrations/v1.0.0-rc.50/modernize-function-props-cast/migration.js.map +1 -0
  18. package/src/migrations/v1.0.0-rc.50/restrict-cors-to-custom-domains/migration.js.map +1 -0
  19. package/src/migrations/v1.0.0-rc.50/terraform-bootstrap-adopt-existing-bucket/migration.d.ts +6 -0
  20. package/src/migrations/v1.0.0-rc.50/terraform-bootstrap-adopt-existing-bucket/migration.js.map +1 -0
  21. package/src/migrations/v1.0.0-rc.52/user-identity-waf-allow-localhost-callback/migration.js.map +1 -0
  22. package/src/migrations/v1.0.0-rc.54/order-access-log-delivery-after-bucket-policy/migration.js.map +1 -0
  23. package/src/migrations/v1.0.0-rc.55/backfill-generator-metadata/migration.js.map +1 -0
  24. package/src/migrations/v1.0.0-rc.56/dynamodb-local-remove-optimize-flag/migration.js.map +1 -0
  25. package/src/migrations/v1.0.0-rc.57/ts-agent-session-management-support/migration.d.ts +6 -0
  26. package/src/migrations/v1.0.0-rc.57/ts-agent-session-management-support/migration.js +449 -0
  27. package/src/migrations/v1.0.0-rc.57/ts-agent-session-management-support/migration.js.map +1 -0
  28. package/src/preset/__snapshots__/generator.spec.ts.snap +5 -5
  29. package/src/py/agent/__snapshots__/generator.constructs.spec.ts.snap +11 -9
  30. package/src/py/agent/__snapshots__/generator.frameworks.spec.ts.snap +20 -20
  31. package/src/py/agent/__snapshots__/generator.protocols.spec.ts.snap +3 -3
  32. package/src/py/agent/a2a-connection/__snapshots__/generator.spec.ts.snap +2 -1
  33. package/src/py/agent/a2a-connection/files/agent-connection/app/__targetAgentSnakeCase___client_strands.py.template +2 -1
  34. package/src/py/agent/a2a-connection/files/langchain/agent-connection/app/__targetAgentSnakeCase___client_langchain.py.template +2 -1
  35. package/src/py/agent/a2a-connection/generator.d.ts +1 -1
  36. package/src/py/agent/gateway-connection/generator.d.ts +1 -1
  37. package/src/py/agent/generator.js +4 -0
  38. package/src/py/agent/generator.js.map +1 -1
  39. package/src/py/agent/mcp-connection/__snapshots__/generator.spec.ts.snap +2 -1
  40. package/src/py/agent/mcp-connection/files/agent-connection/app/__mcpServerSnakeCase___client_strands.py.template +2 -1
  41. package/src/py/agent/mcp-connection/files/langchain/agent-connection/app/__mcpServerSnakeCase___client_langchain.py.template +2 -1
  42. package/src/py/agent/mcp-connection/generator.d.ts +1 -1
  43. package/src/py/agent/react-connection/__snapshots__/generator.spec.ts.snap +6 -0
  44. package/src/py/agent/schema.d.js.map +1 -1
  45. package/src/py/agent/schema.d.ts +3 -0
  46. package/src/py/agent/schema.json +9 -0
  47. package/src/py/dynamodb/__snapshots__/generator.spec.ts.snap +2 -2
  48. package/src/py/dynamodb/schema.json +1 -0
  49. package/src/py/fast-api/__snapshots__/generator.terraform.spec.ts.snap +12 -12
  50. package/src/py/fast-api/generator.d.ts +5 -0
  51. package/src/py/fast-api/generator.js +3 -2
  52. package/src/py/fast-api/generator.js.map +1 -1
  53. package/src/py/fast-api/schema.json +1 -0
  54. package/src/py/lambda-function/__snapshots__/generator.spec.ts.snap +2 -2
  55. package/src/py/mcp-server/__snapshots__/generator.spec.ts.snap +9 -7
  56. package/src/py/mcp-server/schema.json +1 -0
  57. package/src/py/rdb/__snapshots__/generator.spec.ts.snap +2 -2
  58. package/src/py/rdb/schema.json +1 -0
  59. package/src/smithy/project/__snapshots__/generator.spec.ts.snap +4 -4
  60. package/src/smithy/project/files/service/build.Dockerfile.template +2 -2
  61. package/src/smithy/project/generator.d.ts +25 -0
  62. package/src/smithy/project/generator.js +24 -3
  63. package/src/smithy/project/generator.js.map +1 -1
  64. package/src/smithy/ts/api/__snapshots__/generator.spec.ts.snap +7 -7
  65. package/src/smithy/ts/api/generator.d.ts +6 -1
  66. package/src/smithy/ts/api/generator.js +3 -2
  67. package/src/smithy/ts/api/generator.js.map +1 -1
  68. package/src/smithy/ts/api/schema.json +1 -0
  69. package/src/trpc/backend/__snapshots__/generator.spec.ts.snap +12 -12
  70. package/src/trpc/backend/generator.d.ts +6 -1
  71. package/src/trpc/backend/generator.js +3 -2
  72. package/src/trpc/backend/generator.js.map +1 -1
  73. package/src/trpc/backend/schema.json +1 -0
  74. package/src/ts/agent/__snapshots__/generator.spec.ts.snap +668 -24
  75. package/src/ts/agent/a2a-connection/__snapshots__/generator.spec.ts.snap +2 -1
  76. package/src/ts/agent/a2a-connection/files/agent-connection/app/__targetAgentKebabCase__-client-strands.ts.template +1 -1
  77. package/src/ts/agent/files/ag-ui/index.ts.template +10 -1
  78. package/src/ts/agent/files/common/agent.ts.template +11 -3
  79. package/src/ts/agent/files/common/session.ts.template +43 -0
  80. package/src/ts/agent/gateway-connection/__snapshots__/generator.spec.ts.snap +1 -0
  81. package/src/ts/agent/generator.d.ts +36 -1
  82. package/src/ts/agent/generator.js +28 -4
  83. package/src/ts/agent/generator.js.map +1 -1
  84. package/src/ts/agent/mcp-connection/__snapshots__/generator.spec.ts.snap +2 -1
  85. package/src/ts/agent/mcp-connection/files/agent-connection/app/__mcpServerKebabCase__-client-strands.ts.template +2 -1
  86. package/src/ts/agent/react-connection/__snapshots__/generator.spec.ts.snap +8 -4
  87. package/src/ts/agent/react-connection/files/src/components/__agentNameClassName__AgentClientProvider.tsx.template +2 -1
  88. package/src/ts/agent/schema.d.js.map +1 -1
  89. package/src/ts/agent/schema.d.ts +3 -0
  90. package/src/ts/agent/schema.json +9 -0
  91. package/src/ts/dcr-proxy/__snapshots__/generator.spec.ts.snap +1 -1
  92. package/src/ts/dynamodb/__snapshots__/generator.spec.ts.snap +2 -2
  93. package/src/ts/dynamodb/schema.json +1 -0
  94. package/src/ts/lambda-function/__snapshots__/generator.spec.ts.snap +2 -2
  95. package/src/ts/mcp-server/__snapshots__/generator.spec.ts.snap +6 -4
  96. package/src/ts/mcp-server/generator.d.ts +32 -1
  97. package/src/ts/mcp-server/generator.js +7 -4
  98. package/src/ts/mcp-server/generator.js.map +1 -1
  99. package/src/ts/mcp-server/schema.json +1 -0
  100. package/src/ts/rdb/__snapshots__/generator.spec.ts.snap +6 -6
  101. package/src/ts/rdb/generator.d.ts +8 -0
  102. package/src/ts/rdb/generator.js +3 -2
  103. package/src/ts/rdb/generator.js.map +1 -1
  104. package/src/ts/rdb/schema.json +1 -0
  105. package/src/ts/react-website/app/__snapshots__/generator.spec.ts.snap +61 -45
  106. package/src/ts/react-website/app/generator.d.ts +6 -1
  107. package/src/ts/react-website/app/generator.js +3 -2
  108. package/src/ts/react-website/app/generator.js.map +1 -1
  109. package/src/ts/react-website/app/schema.json +1 -0
  110. package/src/ts/react-website/cognito-auth/__snapshots__/generator.terraform.spec.ts.snap +2 -2
  111. package/src/ts/react-website/cognito-auth/generator.d.ts +6 -1
  112. package/src/ts/react-website/cognito-auth/generator.js +3 -2
  113. package/src/ts/react-website/cognito-auth/generator.js.map +1 -1
  114. package/src/utils/agent-chat/files/common/agentcore.ts.template +2 -2
  115. package/src/utils/agent-connection/agent-connection.js +4 -0
  116. package/src/utils/agent-connection/agent-connection.js.map +1 -1
  117. package/src/utils/agent-connection/files/core-runtime-config/runtime-config.ts.template +11 -1
  118. package/src/utils/agent-connection/files/core-strands/base/model-errors-strands.ts.template +26 -15
  119. package/src/utils/agent-connection/files/core-strands/base/tool-errors-strands.ts.template +23 -16
  120. package/src/utils/agent-connection/files/py-core-runtime-config/runtime_config.py.template +4 -3
  121. package/src/utils/agent-core-constructs/agent-core-constructs.d.ts +22 -0
  122. package/src/utils/agent-core-constructs/agent-core-constructs.js +29 -2
  123. package/src/utils/agent-core-constructs/agent-core-constructs.js.map +1 -1
  124. package/src/utils/agent-core-constructs/files/cdk/app/agent-core/__nameKebabCase__/__nameKebabCase__.ts.template +131 -3
  125. package/src/utils/agent-core-constructs/files/terraform/app/agent-core/__nameKebabCase__/__nameKebabCase__.tf.template +180 -1
  126. package/src/utils/api-constructs/api-constructs.d.ts +9 -0
  127. package/src/utils/api-constructs/api-constructs.js +11 -1
  128. package/src/utils/api-constructs/api-constructs.js.map +1 -1
  129. package/src/utils/ast.d.ts +5 -0
  130. package/src/utils/ast.js +25 -0
  131. package/src/utils/ast.js.map +1 -1
  132. package/src/utils/connection/open-api/files/components/__apiNameClassName__Provider.tsx.template +2 -0
  133. package/src/utils/docker.d.ts +27 -2
  134. package/src/utils/docker.js +31 -2
  135. package/src/utils/docker.js.map +1 -1
  136. package/src/utils/identity-constructs/identity-constructs.d.ts +10 -0
  137. package/src/utils/identity-constructs/identity-constructs.js +11 -1
  138. package/src/utils/identity-constructs/identity-constructs.js.map +1 -1
  139. package/src/utils/shared-constructs-constants.d.ts +6 -0
  140. package/src/utils/shared-constructs-constants.js +5 -0
  141. package/src/utils/shared-constructs-constants.js.map +1 -1
  142. package/src/utils/version-upgrade-migration/owned-dependencies.d.ts +26 -0
  143. package/src/utils/version-upgrade-migration/owned-dependencies.js +52 -4
  144. package/src/utils/version-upgrade-migration/owned-dependencies.js.map +1 -1
  145. package/src/utils/version-upgrade-migration/register.d.ts +5 -1
  146. package/src/utils/version-upgrade-migration/register.js +6 -2
  147. package/src/utils/version-upgrade-migration/register.js.map +1 -1
  148. package/src/utils/version-upgrade-migration/sync-embedded-versions.d.ts +26 -0
  149. package/src/utils/version-upgrade-migration/sync-embedded-versions.js +304 -0
  150. package/src/utils/version-upgrade-migration/sync-embedded-versions.js.map +1 -0
  151. package/src/utils/version-upgrade-migration/sync-vended-versions.js +14 -0
  152. package/src/utils/version-upgrade-migration/sync-vended-versions.js.map +1 -1
  153. package/src/utils/versions.d.ts +90 -77
  154. package/src/utils/versions.js +86 -75
  155. package/src/utils/versions.js.map +1 -1
  156. package/src/utils/website-constructs/website-constructs.d.ts +11 -0
  157. package/src/utils/website-constructs/website-constructs.js +12 -1
  158. package/src/utils/website-constructs/website-constructs.js.map +1 -1
  159. package/src/migrations/latest/backfill-generator-metadata/migration.js.map +0 -1
  160. package/src/migrations/latest/dynamodb-local-remove-optimize-flag/migration.js.map +0 -1
  161. package/src/migrations/latest/modernize-function-props-cast/migration.js.map +0 -1
  162. package/src/migrations/latest/order-access-log-delivery-after-bucket-policy/migration.js.map +0 -1
  163. package/src/migrations/latest/restrict-cors-to-custom-domains/migration.js.map +0 -1
  164. package/src/migrations/latest/terraform-bootstrap-adopt-existing-bucket/migration.js.map +0 -1
  165. package/src/migrations/latest/user-identity-waf-allow-localhost-callback/migration.js.map +0 -1
  166. /package/src/migrations/latest/{modernize-function-props-cast → smithy-ssdk-bundle-pins}/migration.d.ts +0 -0
  167. /package/src/migrations/{latest/restrict-cors-to-custom-domains → v1.0.0-rc.50/modernize-function-props-cast}/migration.d.ts +0 -0
  168. /package/src/migrations/{latest → v1.0.0-rc.50}/modernize-function-props-cast/migration.js +0 -0
  169. /package/src/migrations/{latest/terraform-bootstrap-adopt-existing-bucket → v1.0.0-rc.50/restrict-cors-to-custom-domains}/migration.d.ts +0 -0
  170. /package/src/migrations/{latest → v1.0.0-rc.50}/restrict-cors-to-custom-domains/migration.js +0 -0
  171. /package/src/migrations/{latest → v1.0.0-rc.50}/terraform-bootstrap-adopt-existing-bucket/migration.js +0 -0
  172. /package/src/migrations/{latest/dynamodb-local-remove-optimize-flag → v1.0.0-rc.52/user-identity-waf-allow-localhost-callback}/migration.d.ts +0 -0
  173. /package/src/migrations/{latest → v1.0.0-rc.52}/user-identity-waf-allow-localhost-callback/migration.js +0 -0
  174. /package/src/migrations/{latest → v1.0.0-rc.54}/order-access-log-delivery-after-bucket-policy/migration.d.ts +0 -0
  175. /package/src/migrations/{latest → v1.0.0-rc.54}/order-access-log-delivery-after-bucket-policy/migration.js +0 -0
  176. /package/src/migrations/{latest → v1.0.0-rc.55}/backfill-generator-metadata/migration.d.ts +0 -0
  177. /package/src/migrations/{latest → v1.0.0-rc.55}/backfill-generator-metadata/migration.js +0 -0
  178. /package/src/migrations/{latest/user-identity-waf-allow-localhost-callback → v1.0.0-rc.56/dynamodb-local-remove-optimize-flag}/migration.d.ts +0 -0
  179. /package/src/migrations/{latest → v1.0.0-rc.56}/dynamodb-local-remove-optimize-flag/migration.js +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../packages/nx-plugin/src/migrations/v1.0.0-rc.55/backfill-generator-metadata/migration.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { relative } from 'node:path';\nimport {\n getProjects,\n joinPathFragments,\n type MigrationReturnObject,\n type ProjectConfiguration,\n readJson,\n type Tree,\n updateProjectConfiguration,\n} from '@nx/devkit';\nimport { AGENTCORE_GATEWAY_GATEWAY_CONNECTION_GENERATOR_INFO } from '../../../agentcore-gateway/gateway-connection/generator';\nimport { AGENTCORE_GATEWAY_GENERATOR_INFO } from '../../../agentcore-gateway/generator';\nimport { AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO } from '../../../agentcore-gateway/mcp-connection/generator';\nimport { PY_AGENT_A2A_CONNECTION_GENERATOR_INFO } from '../../../py/agent/a2a-connection/generator';\nimport { PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO } from '../../../py/agent/gateway-connection/generator';\nimport { PY_AGENT_GENERATOR_INFO } from '../../../py/agent/generator';\nimport { PY_AGENT_MCP_CONNECTION_GENERATOR_INFO } from '../../../py/agent/mcp-connection/generator';\nimport { PY_AGENT_REACT_CONNECTION_GENERATOR_INFO } from '../../../py/agent/react-connection/generator';\nimport { PY_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO } from '../../../py/dynamodb/agent-connection/generator';\nimport { PY_DYNAMODB_FAST_API_CONNECTION_GENERATOR_INFO } from '../../../py/dynamodb/fast-api-connection/generator';\nimport { PY_DYNAMODB_GENERATOR_INFO } from '../../../py/dynamodb/generator';\nimport { PY_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO } from '../../../py/dynamodb/mcp-server-connection/generator';\nimport { FAST_API_GENERATOR_INFO } from '../../../py/fast-api/generator';\nimport { FAST_API_REACT_GENERATOR_INFO } from '../../../py/fast-api/react/generator';\nimport { LAMBDA_FUNCTION_GENERATOR_INFO as PY_LAMBDA_FUNCTION_GENERATOR_INFO } from '../../../py/lambda-function/generator';\nimport { PY_MCP_SERVER_GENERATOR_INFO } from '../../../py/mcp-server/generator';\nimport { PY_RDB_AGENT_CONNECTION_GENERATOR_INFO } from '../../../py/rdb/agent-connection/generator';\nimport { PY_RDB_FAST_API_CONNECTION_GENERATOR_INFO } from '../../../py/rdb/fast-api-connection/generator';\nimport { PY_RDB_GENERATOR_INFO } from '../../../py/rdb/generator';\nimport { PY_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO } from '../../../py/rdb/mcp-server-connection/generator';\nimport { SMITHY_PROJECT_GENERATOR_INFO } from '../../../smithy/project/generator';\nimport { SMITHY_REACT_CONNECTION_GENERATOR_INFO } from '../../../smithy/react-connection/generator';\nimport { TS_SMITHY_API_GENERATOR_INFO } from '../../../smithy/ts/api/generator';\nimport { TRPC_BACKEND_GENERATOR_INFO } from '../../../trpc/backend/generator';\nimport { TRPC_REACT_GENERATOR_INFO } from '../../../trpc/react/generator';\nimport { TS_AGENT_A2A_CONNECTION_GENERATOR_INFO } from '../../../ts/agent/a2a-connection/generator';\nimport { TS_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO } from '../../../ts/agent/gateway-connection/generator';\nimport { TS_AGENT_GENERATOR_INFO } from '../../../ts/agent/generator';\nimport { TS_AGENT_MCP_CONNECTION_GENERATOR_INFO } from '../../../ts/agent/mcp-connection/generator';\nimport { TS_AGENT_REACT_CONNECTION_GENERATOR_INFO } from '../../../ts/agent/react-connection/generator';\nimport { TS_DCR_PROXY_GENERATOR_INFO } from '../../../ts/dcr-proxy/generator';\nimport { TS_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO } from '../../../ts/dynamodb/agent-connection/generator';\nimport { TS_DYNAMODB_GENERATOR_INFO } from '../../../ts/dynamodb/generator';\nimport { TS_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO } from '../../../ts/dynamodb/mcp-server-connection/generator';\nimport { TS_DYNAMODB_SMITHY_CONNECTION_GENERATOR_INFO } from '../../../ts/dynamodb/smithy-connection/generator';\nimport { TS_DYNAMODB_TRPC_CONNECTION_GENERATOR_INFO } from '../../../ts/dynamodb/trpc-connection/generator';\nimport { TS_LAMBDA_FUNCTION_GENERATOR_INFO } from '../../../ts/lambda-function/generator';\nimport { TS_LIB_GENERATOR_INFO } from '../../../ts/lib/generator';\nimport { TS_MCP_SERVER_GENERATOR_INFO } from '../../../ts/mcp-server/generator';\nimport { TS_RDB_AGENT_CONNECTION_GENERATOR_INFO } from '../../../ts/rdb/agent-connection/generator';\nimport { TS_RDB_GENERATOR_INFO } from '../../../ts/rdb/generator';\nimport { TS_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO } from '../../../ts/rdb/mcp-server-connection/generator';\nimport { TS_RDB_SMITHY_CONNECTION_GENERATOR_INFO } from '../../../ts/rdb/smithy-connection/generator';\nimport { TS_RDB_TRPC_CONNECTION_GENERATOR_INFO } from '../../../ts/rdb/trpc-connection/generator';\nimport { REACT_WEBSITE_APP_GENERATOR_INFO } from '../../../ts/react-website/app/generator';\nimport { COGNITO_AUTH_GENERATOR_INFO } from '../../../ts/react-website/cognito-auth/generator';\nimport {\n PY_CLIENT_NAMING,\n resolveAgentFramework,\n} from '../../../utils/agent-connection/agent-connection';\nimport { matchGritQL } from '../../../utils/ast';\nimport { DCR_PROXY_HANDLERS } from '../../../utils/dcr-proxy-constructs/dcr-proxy-constructs';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport {\n camelCase,\n kebabCase,\n pascalCase,\n toClassName,\n toSnakeCase,\n} from '../../../utils/names';\nimport type { ComponentMetadata } from '../../../utils/nx';\nimport {\n PACKAGES_DIR,\n SHARED_CONSTRUCTS_DIR,\n SHARED_TERRAFORM_DIR,\n} from '../../../utils/shared-constructs-constants';\n\n/**\n * Backfill the project metadata the version sync reads.\n *\n * The sync owns a generator's dependencies only for the runs it can see, and it\n * sees a run through the metadata that generator recorded — narrowing each run to\n * the branch it took by replaying the declaration's `when` predicates against that\n * metadata. Workspaces generated before this release recorded less, in three ways\n * that each cost ownership:\n *\n * - No connection generator recorded anything at all, so the packages they add\n * (the agent Layer-2 clients, AG-UI, the tRPC and OpenAPI react clients) are\n * invisible to the sync and their versions would never move again.\n * - `ts#dcr-proxy` was attributed to the `ts#project` that creates its project.\n * - No project recorded an `iac`, and a predicate reading absent metadata counts\n * as not applying, so the infrastructure helpers' packages go unowned.\n *\n * Every connection is recorded, including those that add no dependencies today.\n * The sync reads the recorded metadata rather than the generators, so a connection\n * recorded now is picked up the moment its generator starts owning packages —\n * otherwise a later release needs a second backfill for the workspaces this one\n * already ran on.\n *\n * Every field is recovered from evidence the generators left behind — the files\n * they wrote, the clients they imported, the dev chains and build dependencies they\n * registered — rather than guessed, and anything that can't be established is left\n * alone. A wrong value is worse than a missing one: it has the sync claim packages\n * a project never received.\n *\n * How to write a migration:\n * - https://nx.dev/docs/kb/migration-generators\n * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject\n */\n\ntype Iac = 'cdk' | 'terraform';\n\n/** Metadata as a project records it, over the fields this backfill reads. */\ninterface ProjectMetadata {\n generator?: string;\n components?: ComponentMetadata[];\n iac?: string;\n smithyType?: string;\n namespace?: string;\n tailwind?: boolean;\n tanstackRouter?: boolean;\n [key: string]: unknown;\n}\n\n/** The shared project each provider generates its infrastructure into. */\nconst SHARED_INFRA_ROOT: Record<Iac, string> = {\n cdk: joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR),\n terraform: joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR),\n};\n\n/**\n * The provider each project's infrastructure was generated with.\n *\n * Every infra helper registers `<project>:build` on the build target of the shared\n * project belonging to the provider it ran with, so those lists name exactly the\n * projects that received infrastructure, and which provider gave it to them.\n *\n * Read per project rather than per workspace because `iac` is a per-generator\n * option: one workspace can hold both providers.\n */\nconst infrastructureProviders = (tree: Tree): Map<string, Iac> => {\n const providers = new Map<string, Iac>();\n for (const iac of ['cdk', 'terraform'] as const) {\n const configPath = joinPathFragments(\n SHARED_INFRA_ROOT[iac],\n 'project.json',\n );\n if (!tree.exists(configPath)) {\n continue;\n }\n const config = readJson<ProjectConfiguration>(tree, configPath);\n for (const dependency of config.targets?.build?.dependsOn ?? []) {\n // Registered as `<project>:build`, either as that string or as an object.\n const name =\n typeof dependency === 'string'\n ? dependency.split(':')[0]\n : (dependency.projects as string | undefined);\n if (name) {\n providers.set(name, iac);\n }\n }\n }\n return providers;\n};\n\n/**\n * Where a component's infrastructure lives under a provider's shared project,\n * keyed by the generator that created it.\n *\n * These components belong to a project rather than being one, and each records its\n * own `iac` — a project can hold a CDK-deployed agent alongside one generated with\n * `infra: 'none'` — so the project-level build dependency isn't precise enough.\n * Each component gets its own entry under the app directory below, which is.\n *\n * `paths` lists the candidates because the two providers don't lay out every\n * component the same way: a Lambda function is one CDK file but a Terraform\n * directory.\n */\nconst COMPONENT_INFRA: Record<\n string,\n { readonly appDirectory: string; readonly paths: (name: string) => string[] }\n> = {\n ...Object.fromEntries(\n (\n [\n [TS_AGENT_GENERATOR_INFO.id, 'agents'],\n [PY_AGENT_GENERATOR_INFO.id, 'agents'],\n [TS_MCP_SERVER_GENERATOR_INFO.id, 'mcp-servers'],\n [PY_MCP_SERVER_GENERATOR_INFO.id, 'mcp-servers'],\n ] as const\n ).map(([id, appDirectory]) => [\n id,\n { appDirectory, paths: (name: string) => [name] },\n ]),\n ),\n ...Object.fromEntries(\n [\n TS_LAMBDA_FUNCTION_GENERATOR_INFO.id,\n PY_LAMBDA_FUNCTION_GENERATOR_INFO.id,\n ].map((id) => [\n id,\n {\n appDirectory: 'lambda-functions',\n // CDK vends `<name>.ts`; Terraform vends `<name>/<name>.tf`.\n paths: (name: string) => [`${name}.ts`, name],\n },\n ]),\n ),\n};\n\n/**\n * The provider a component's own infrastructure was generated with, from the entry\n * the infra helper created for it under one provider's shared project.\n *\n * That entry is named after the component, which for these generators is the name\n * the component records.\n */\nconst componentInfrastructureProvider = (\n tree: Tree,\n component: ComponentMetadata,\n): Iac | undefined => {\n const layout = component.generator\n ? COMPONENT_INFRA[component.generator]\n : undefined;\n if (!layout || !component.name) {\n return undefined;\n }\n for (const iac of ['cdk', 'terraform'] as const) {\n for (const entry of layout.paths(component.name)) {\n if (\n tree.exists(\n joinPathFragments(\n SHARED_INFRA_ROOT[iac],\n 'src',\n 'app',\n layout.appDirectory,\n entry,\n ),\n )\n ) {\n return iac;\n }\n }\n }\n return undefined;\n};\n\n/**\n * `ts#dcr-proxy` creates its handler project through `ts#project`, which recorded\n * its own id — so an existing workspace attributes the project to `ts#project` and\n * owns none of the proxy's dependencies. The six vended handlers are its\n * signature; a project carrying every one of them is a DCR proxy.\n */\nconst isDcrProxyProject = (tree: Tree, projectRoot: string): boolean =>\n DCR_PROXY_HANDLERS.every((handler) =>\n tree.exists(\n joinPathFragments(projectRoot, 'src', 'handlers', `${handler}.ts`),\n ),\n );\n\n/**\n * What a Smithy project models, from the `smithy-build.json` each kind gets: a\n * service builds an OpenAPI spec and a TypeScript SSDK from its model, so it has\n * the plugins to do so, while a shape library only shares shapes and has none.\n */\nconst smithyProjectType = (\n tree: Tree,\n projectRoot: string,\n): 'service' | 'shapes' | undefined => {\n const buildPath = joinPathFragments(projectRoot, 'smithy-build.json');\n if (!tree.exists(buildPath)) {\n return undefined;\n }\n const build = readJson<{ plugins?: Record<string, unknown> }>(\n tree,\n buildPath,\n );\n return build.plugins && Object.keys(build.plugins).length > 0\n ? 'service'\n : 'shapes';\n};\n\n/**\n * The Smithy namespace a project's shapes are declared in, read from the model\n * rather than derived from the npm scope: the generator takes it as an option, so\n * a project may not carry the default.\n */\nconst smithyNamespace = (\n tree: Tree,\n project: ProjectConfiguration,\n): string | undefined => {\n const modelPath = joinPathFragments(\n project.sourceRoot ?? joinPathFragments(project.root, 'src'),\n 'main.smithy',\n );\n if (!tree.exists(modelPath)) {\n return undefined;\n }\n // Smithy is not a language GritQL parses, and `namespace <x>` is a single\n // declaration on its own line rather than a structure worth an AST for.\n return /^namespace\\s+(\\S+)\\s*$/m\n .exec(tree.read(modelPath, 'utf-8') ?? '')\n ?.at(1);\n};\n\n/**\n * Whether a website's vite config registers the given plugin, which is how\n * `tailwind` and `tanstackRouter` show up in a generated workspace: both default\n * to true, so only the config proves one was turned off.\n *\n * Matched on the AST rather than the text so the plugin's arguments, and any\n * reformatting since, don't hide it.\n */\nconst usesVitePlugin = (\n tree: Tree,\n projectRoot: string,\n plugin: string,\n): Promise<boolean> =>\n matchGritQL(\n tree,\n joinPathFragments(projectRoot, 'vite.config.mts'),\n `\\`${plugin}\\``,\n );\n\n/**\n * A connection generator, and how to recognise a run of it.\n *\n * A connection is found from the source component it was made from and the target\n * it reaches: `evidence` is a check that only passes if that exact pair was wired\n * up — a client import named after the target, a vended file named after it, or\n * the dev-target dependency on its project. So `name` and `sourcePath` are\n * recovered facts rather than guesses.\n *\n * Every connection generator is listed, including those that add no dependencies\n * today. The sync reads the metadata rather than the generator, so recording a\n * connection now is what lets it be picked up the moment its generator starts\n * owning packages — a later release would otherwise need another backfill.\n */\ninterface ConnectionKind {\n /** The generator id to record. */\n readonly id: string;\n /**\n * The generator that created a source component of this connection, or\n * undefined when the connection is made from the project as a whole.\n */\n readonly sourceGenerator?: string;\n /** The generators that could have created its target. */\n readonly targetGenerators: readonly string[];\n /**\n * Whether this connection was made from `source` to `target`, and what to record\n * as the component's `path` if so. Undefined means it was not.\n */\n readonly evidence: (\n context: ConnectionContext,\n ) => string | undefined | Promise<string | undefined>;\n /**\n * The `name` this connection records, when it is not the target's class name.\n * Matched to what each generator writes so a re-run recognises its own entry.\n */\n readonly recordedName?: (context: ConnectionContext) => string;\n /** What this connection records beyond the path, which its predicates read. */\n readonly metadata?: (\n context: ConnectionContext,\n ) => Record<string, unknown> | undefined;\n}\n\n/** `<sourceComponent>-<target>`, the name the database connections record. */\nconst sourceQualifiedName =\n (target: (context: ConnectionContext) => string, fallback: string) =>\n (context: ConnectionContext) =>\n `${context.source.name ?? fallback}-${target(context)}`;\n\n/** The database name as each language's connections case it. */\nconst camelDatabase = ({ target }: ConnectionContext) =>\n camelCase(target.databaseName);\nconst targetProjectName = ({ target }: ConnectionContext) => target.projectName;\n\n/** What a connection's evidence check has to work from. */\ninterface ConnectionContext {\n readonly tree: Tree;\n /** The project the connection lives on — the source side. */\n readonly project: ProjectConfiguration;\n /**\n * The source component, or the project's own metadata standing in for it when\n * the connection is made from the project as a whole.\n */\n readonly source: ComponentMetadata;\n /** The target being connected to. */\n readonly target: ConnectionTarget;\n}\n\n/** Prefix a GritQL pattern to match against Python rather than TypeScript. */\nconst py = (pattern: string) => `language python\\n${pattern}`;\n\n/**\n * Whether the source project's `dev` chain runs the target project's, which every\n * connection wires up so `nx run <source>:dev` starts what it depends on.\n *\n * This is the only trace left by the connections that vend no code (the DynamoDB\n * ones grant IAM in the target's infrastructure instead). It identifies the pair\n * because the dependency names the target project.\n */\nconst dependsOnTargetDev = (\n project: ProjectConfiguration,\n target: ConnectionTarget,\n devTarget: string,\n): boolean =>\n (project.targets?.[devTarget]?.dependsOn ?? []).some((dependency) => {\n const projects =\n typeof dependency === 'string'\n ? dependency.split(':')[0]\n : (dependency.projects as string | string[] | undefined);\n return Array.isArray(projects)\n ? projects.includes(target.projectName)\n : projects === target.projectName;\n });\n\n/**\n * An agent-to-service connection, which imports a Layer-2 client named after the\n * target into the source agent's entry point.\n */\nconst agentClientConnection = (\n id: string,\n language: 'ts' | 'py',\n targetGenerators: readonly string[],\n): ConnectionKind => ({\n id,\n sourceGenerator:\n language === 'ts' ? TS_AGENT_GENERATOR_INFO.id : PY_AGENT_GENERATOR_INFO.id,\n targetGenerators,\n evidence: async ({ tree, project, source, target }) => {\n const path = joinPathFragments(\n source.path ?? 'src',\n language === 'ts' ? 'agent.ts' : 'agent.py',\n );\n // The Python client's class suffix follows the source agent's framework, read\n // from the same naming table the generators use.\n const client =\n language === 'ts'\n ? `${target.className}ClientStrands`\n : `${target.className}Client${\n PY_CLIENT_NAMING[resolveAgentFramework(source.framework)]\n .clientClassSuffix\n }`;\n const pattern = `\\`${client}\\``;\n return (await matchGritQL(\n tree,\n joinPathFragments(project.root, path),\n language === 'ts' ? pattern : py(pattern),\n ))\n ? path\n : undefined;\n },\n ...(language === 'py'\n ? {\n metadata: ({ source }) => ({\n framework: resolveAgentFramework(source.framework),\n }),\n }\n : {}),\n});\n\n/**\n * A database-to-component connection, which imports the database's client getter\n * into the component it connects to and aliases it after the database.\n */\nconst rdbConnection = (\n id: string,\n options: {\n readonly sourceGenerator?: string;\n readonly targetGenerator: string;\n readonly entryPoint: (source: ComponentMetadata) => string;\n readonly recordedName?: ConnectionKind['recordedName'];\n },\n): ConnectionKind => ({\n id,\n sourceGenerator: options.sourceGenerator,\n targetGenerators: [options.targetGenerator],\n recordedName: options.recordedName,\n evidence: async ({ tree, project, source, target }) => {\n const path = options.entryPoint(source);\n return (await matchGritQL(\n tree,\n joinPathFragments(project.root, path),\n // Aliased to `get<Database>` on import, so the alias names the target.\n `\\`get${pascalCase(target.databaseName)}\\``,\n ))\n ? path\n : undefined;\n },\n});\n\n/**\n * A connection that vends no code, recognised by the dev chain it wires from the\n * source component to the target project.\n */\nconst devChainConnection = (\n id: string,\n options: {\n readonly sourceGenerator?: string;\n readonly targetGenerator: string;\n /** The source project's target whose chain this connection extends. */\n readonly devTarget?: (source: ComponentMetadata) => string;\n readonly recordedName?: ConnectionKind['recordedName'];\n },\n): ConnectionKind => ({\n id,\n sourceGenerator: options.sourceGenerator,\n targetGenerators: [options.targetGenerator],\n recordedName: options.recordedName,\n evidence: ({ project, source, target }) =>\n dependsOnTargetDev(project, target, options.devTarget?.(source) ?? 'dev')\n ? target.projectRoot\n : undefined,\n});\n\n/** The `<component>-dev` target a component generator authors for itself. */\nconst componentDevTarget = (source: ComponentMetadata) =>\n `${source.name ?? 'agent'}-dev`;\n\n/** The tRPC-over-HTTP integration patterns, whose extra client packages differ. */\nconst REST_API_INFRA = new Set(['rest-lambda', 'serverlessapigatewayrestapi']);\n\n/**\n * A website connection, recognised by the provider component it vends for its\n * target under the website's source root.\n */\nconst websiteConnection = (\n id: string,\n options: {\n readonly targetGenerator: string;\n readonly provider: (targetClassName: string) => string;\n readonly metadata?: ConnectionKind['metadata'];\n },\n): ConnectionKind => ({\n id,\n sourceGenerator: REACT_WEBSITE_APP_GENERATOR_INFO.id,\n targetGenerators: [options.targetGenerator],\n evidence: ({ tree, project, target }) => {\n const sourceRoot =\n project.sourceRoot ?? joinPathFragments(project.root, 'src');\n const provider = joinPathFragments(\n 'components',\n options.provider(target.className),\n );\n return tree.exists(joinPathFragments(sourceRoot, `${provider}.tsx`))\n ? joinPathFragments(relative(project.root, sourceRoot), provider)\n : undefined;\n },\n metadata: options.metadata,\n});\n\n/**\n * Every connection generator, and the trace each leaves on the project it connects\n * from.\n *\n * Grouped by how a run is recognised, since that follows what the generator does\n * rather than which pair it joins.\n */\nexport const CONNECTION_KINDS: readonly ConnectionKind[] = [\n // Agent to service: imports a Layer-2 client named after the target.\n agentClientConnection(TS_AGENT_MCP_CONNECTION_GENERATOR_INFO.id, 'ts', [\n TS_MCP_SERVER_GENERATOR_INFO.id,\n PY_MCP_SERVER_GENERATOR_INFO.id,\n ]),\n agentClientConnection(TS_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO.id, 'ts', [\n AGENTCORE_GATEWAY_GENERATOR_INFO.id,\n ]),\n agentClientConnection(TS_AGENT_A2A_CONNECTION_GENERATOR_INFO.id, 'ts', [\n TS_AGENT_GENERATOR_INFO.id,\n PY_AGENT_GENERATOR_INFO.id,\n ]),\n agentClientConnection(PY_AGENT_MCP_CONNECTION_GENERATOR_INFO.id, 'py', [\n TS_MCP_SERVER_GENERATOR_INFO.id,\n PY_MCP_SERVER_GENERATOR_INFO.id,\n ]),\n agentClientConnection(PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO.id, 'py', [\n AGENTCORE_GATEWAY_GENERATOR_INFO.id,\n ]),\n agentClientConnection(PY_AGENT_A2A_CONNECTION_GENERATOR_INFO.id, 'py', [\n TS_AGENT_GENERATOR_INFO.id,\n PY_AGENT_GENERATOR_INFO.id,\n ]),\n\n // Website to backend: vends a provider component named after the target.\n websiteConnection(TRPC_REACT_GENERATOR_INFO.id, {\n targetGenerator: TRPC_BACKEND_GENERATOR_INFO.id,\n provider: (className) => `${className}ClientProvider`,\n metadata: ({ target }) => ({\n auth: String(target.project.auth ?? 'iam').toLowerCase(),\n isRestApi: REST_API_INFRA.has(\n String(\n target.project.infra ?? target.project.computeType ?? '',\n ).toLowerCase(),\n ),\n }),\n }),\n // Both OpenAPI react clients vend the same provider shape.\n websiteConnection(SMITHY_REACT_CONNECTION_GENERATOR_INFO.id, {\n targetGenerator: TS_SMITHY_API_GENERATOR_INFO.id,\n provider: (className) => `${className}Provider`,\n }),\n websiteConnection(FAST_API_REACT_GENERATOR_INFO.id, {\n targetGenerator: FAST_API_GENERATOR_INFO.id,\n provider: (className) => `${className}Provider`,\n }),\n websiteConnection(TS_AGENT_REACT_CONNECTION_GENERATOR_INFO.id, {\n targetGenerator: TS_AGENT_GENERATOR_INFO.id,\n provider: (className) => `${className}AgentClientProvider`,\n }),\n websiteConnection(PY_AGENT_REACT_CONNECTION_GENERATOR_INFO.id, {\n targetGenerator: PY_AGENT_GENERATOR_INFO.id,\n provider: (className) => `${className}AgentClientProvider`,\n }),\n\n // Database to component: imports the database's `get<Database>` client getter.\n rdbConnection(TS_RDB_AGENT_CONNECTION_GENERATOR_INFO.id, {\n sourceGenerator: TS_AGENT_GENERATOR_INFO.id,\n targetGenerator: TS_RDB_GENERATOR_INFO.id,\n entryPoint: (source) =>\n joinPathFragments('src', source.name ?? 'agent', 'agent.ts'),\n recordedName: sourceQualifiedName(camelDatabase, 'agent'),\n }),\n rdbConnection(TS_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO.id, {\n sourceGenerator: TS_MCP_SERVER_GENERATOR_INFO.id,\n targetGenerator: TS_RDB_GENERATOR_INFO.id,\n entryPoint: (source) =>\n joinPathFragments('src', source.name ?? 'mcp-server', 'server.ts'),\n recordedName: sourceQualifiedName(camelDatabase, 'mcp-server'),\n }),\n rdbConnection(TS_RDB_SMITHY_CONNECTION_GENERATOR_INFO.id, {\n targetGenerator: TS_RDB_GENERATOR_INFO.id,\n entryPoint: () => joinPathFragments('src', 'context.ts'),\n recordedName: camelDatabase,\n }),\n\n // Vends a middleware or dependency module named after the database.\n {\n id: TS_RDB_TRPC_CONNECTION_GENERATOR_INFO.id,\n targetGenerators: [TS_RDB_GENERATOR_INFO.id],\n recordedName: camelDatabase,\n evidence: ({ tree, project, target }) => {\n const path = joinPathFragments(\n 'src',\n 'middleware',\n `${kebabCase(target.databaseName)}.ts`,\n );\n return tree.exists(joinPathFragments(project.root, path))\n ? path\n : undefined;\n },\n },\n {\n id: PY_RDB_FAST_API_CONNECTION_GENERATOR_INFO.id,\n targetGenerators: [PY_RDB_GENERATOR_INFO.id],\n recordedName: ({ target }) => toSnakeCase(target.databaseName),\n evidence: ({ tree, project, target }) => {\n const dependencies = pythonDependenciesDir(tree, project);\n if (!dependencies) {\n return undefined;\n }\n const path = joinPathFragments(\n dependencies,\n `${toSnakeCase(target.databaseName)}.py`,\n );\n return tree.exists(joinPathFragments(project.root, path))\n ? path\n : undefined;\n },\n },\n\n // Python database connections vend no code into the source, so the dev chain and\n // the workspace dependency on the database project are the trace.\n devChainConnection(PY_RDB_AGENT_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'agent'),\n sourceGenerator: PY_AGENT_GENERATOR_INFO.id,\n targetGenerator: PY_RDB_GENERATOR_INFO.id,\n devTarget: componentDevTarget,\n }),\n devChainConnection(PY_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'mcp-server'),\n sourceGenerator: PY_MCP_SERVER_GENERATOR_INFO.id,\n targetGenerator: PY_RDB_GENERATOR_INFO.id,\n devTarget: (source) => `${source.name ?? 'mcp-server'}-dev`,\n }),\n\n // DynamoDB connections grant IAM in the target's infrastructure rather than\n // vending code, so the dev chain is all they leave behind.\n devChainConnection(TS_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'agent'),\n sourceGenerator: TS_AGENT_GENERATOR_INFO.id,\n targetGenerator: TS_DYNAMODB_GENERATOR_INFO.id,\n devTarget: componentDevTarget,\n }),\n devChainConnection(TS_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'mcp-server'),\n sourceGenerator: TS_MCP_SERVER_GENERATOR_INFO.id,\n targetGenerator: TS_DYNAMODB_GENERATOR_INFO.id,\n devTarget: (source) => `${source.name ?? 'mcp-server'}-dev`,\n }),\n devChainConnection(TS_DYNAMODB_TRPC_CONNECTION_GENERATOR_INFO.id, {\n recordedName: targetProjectName,\n targetGenerator: TS_DYNAMODB_GENERATOR_INFO.id,\n }),\n devChainConnection(TS_DYNAMODB_SMITHY_CONNECTION_GENERATOR_INFO.id, {\n recordedName: targetProjectName,\n targetGenerator: TS_DYNAMODB_GENERATOR_INFO.id,\n }),\n devChainConnection(PY_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'agent'),\n sourceGenerator: PY_AGENT_GENERATOR_INFO.id,\n targetGenerator: PY_DYNAMODB_GENERATOR_INFO.id,\n devTarget: componentDevTarget,\n }),\n devChainConnection(PY_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO.id, {\n recordedName: sourceQualifiedName(targetProjectName, 'mcp-server'),\n sourceGenerator: PY_MCP_SERVER_GENERATOR_INFO.id,\n targetGenerator: PY_DYNAMODB_GENERATOR_INFO.id,\n devTarget: (source) => `${source.name ?? 'mcp-server'}-dev`,\n }),\n devChainConnection(PY_DYNAMODB_FAST_API_CONNECTION_GENERATOR_INFO.id, {\n recordedName: targetProjectName,\n targetGenerator: PY_DYNAMODB_GENERATOR_INFO.id,\n }),\n\n // Gateway to upstream: registers the upstream in the gateway's local-dev.ts,\n // under the kebab-cased class name the deployed gateway also uses.\n ...(\n [\n [\n AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO.id,\n [TS_MCP_SERVER_GENERATOR_INFO.id, PY_MCP_SERVER_GENERATOR_INFO.id],\n ],\n [\n AGENTCORE_GATEWAY_GATEWAY_CONNECTION_GENERATOR_INFO.id,\n [AGENTCORE_GATEWAY_GENERATOR_INFO.id],\n ],\n ] as const\n ).map(([id, targetGenerators]) => ({\n id,\n sourceGenerator: AGENTCORE_GATEWAY_GENERATOR_INFO.id,\n targetGenerators,\n recordedName: ({ target }: ConnectionContext) =>\n kebabCase(target.className),\n evidence: async ({ tree, project, target }: ConnectionContext) =>\n (await matchGritQL(\n tree,\n joinPathFragments(project.root, 'local-dev.ts'),\n `\\`'${kebabCase(target.className)}'\\``,\n ))\n ? target.projectRoot\n : undefined,\n })),\n];\n\n/**\n * A thing in the workspace a connection could have been made to, by the names its\n * generated code is derived from.\n */\ninterface ConnectionTarget {\n /** The class name a client or provider for this target is named after. */\n readonly className: string;\n /**\n * The last segment of the target project's name, which the database connections\n * derive their identifiers from.\n */\n readonly databaseName: string;\n /** The target project's name, which a dev-target dependency names. */\n readonly projectName: string;\n /** The target project's root, recorded as `path` by the connections that vend no file. */\n readonly projectRoot: string;\n /** The target project's metadata, which a connection's own fields come from. */\n readonly project: ProjectMetadata;\n}\n\n/**\n * Every connection target in the workspace, keyed by the generator that created it.\n *\n * A target may be a component of a project (an agent, an MCP server) or a whole\n * project (a gateway, an API, a database), so both are indexed. Agents, MCP servers\n * and gateways record the class name directly as `rc`; an API's is derived from its\n * `apiName` the same way its connection generator derives it.\n */\nconst connectionTargets = (tree: Tree): Map<string, ConnectionTarget[]> => {\n const targets = new Map<string, ConnectionTarget[]>();\n for (const [projectName, project] of getProjects(tree)) {\n const metadata = project.metadata as ProjectMetadata | undefined;\n if (!metadata) {\n continue;\n }\n const shared = {\n // The database generators split on `/` for TypeScript and `.` for Python.\n databaseName: projectName.split(/[/.]/).pop() ?? projectName,\n projectName,\n projectRoot: project.root,\n project: metadata,\n };\n const add = (generator: string | undefined, className: unknown) => {\n if (!generator || typeof className !== 'string') {\n return;\n }\n targets.set(generator, [\n ...(targets.get(generator) ?? []),\n { ...shared, className },\n ]);\n };\n add(\n metadata.generator,\n metadata.rc ??\n (typeof metadata.apiName === 'string'\n ? toClassName(metadata.apiName)\n : // A database is named by its project, not a recorded class name.\n shared.databaseName),\n );\n for (const component of metadata.components ?? []) {\n add(component.generator, component.rc);\n }\n }\n return targets;\n};\n\n/**\n * The Python module a FastAPI project's sources live in, found by looking for the\n * `dependencies` directory the connections vend into.\n *\n * The module name mixes the workspace's npm scope with the API name, so it is read\n * off the tree rather than derived — a scope that has since changed would make a\n * derived name wrong.\n */\nconst pythonDependenciesDir = (\n tree: Tree,\n project: ProjectConfiguration,\n): string | undefined =>\n tree\n .children(project.root)\n .map((child) => joinPathFragments(child, 'dependencies'))\n .find((dir) => tree.exists(joinPathFragments(project.root, dir)));\n\nexport default async function migration(\n tree: Tree,\n): Promise<MigrationReturnObject> {\n const providers = infrastructureProviders(tree);\n const targets = connectionTargets(tree);\n\n for (const [projectName, project] of getProjects(tree)) {\n const metadata = project.metadata as ProjectMetadata | undefined;\n if (!metadata?.generator && !metadata?.components?.length) {\n // Not a project this plugin generated, so none of this is ours to record.\n continue;\n }\n\n const next: ProjectMetadata = { ...metadata };\n let changed = false;\n\n if (\n next.generator === TS_LIB_GENERATOR_INFO.id &&\n isDcrProxyProject(tree, project.root)\n ) {\n next.generator = TS_DCR_PROXY_GENERATOR_INFO.id;\n changed = true;\n }\n\n // The provider this project's infrastructure was generated with. Left unset\n // where the project received none, matching what the generators record: the\n // sync reads a set `iac` as \"infrastructure was generated\", and would claim\n // the helpers' packages for a project that never got them.\n const iac = providers.get(projectName);\n if (iac && next.iac === undefined) {\n next.iac = iac;\n changed = true;\n }\n\n // What a Smithy project models, and the namespace it declares. Neither gates a\n // dependency yet, but recording them now means a future gate reads them in a\n // workspace this backfill has already run on.\n if (next.generator === SMITHY_PROJECT_GENERATOR_INFO.id) {\n if (next.smithyType === undefined) {\n const smithyType = smithyProjectType(tree, project.root);\n if (smithyType) {\n next.smithyType = smithyType;\n changed = true;\n }\n }\n if (next.namespace === undefined) {\n const namespace = smithyNamespace(tree, project);\n if (namespace) {\n next.namespace = namespace;\n changed = true;\n }\n }\n }\n\n if (next.generator === REACT_WEBSITE_APP_GENERATOR_INFO.id) {\n if (next.tailwind === undefined) {\n next.tailwind = await usesVitePlugin(tree, project.root, 'tailwindcss');\n changed = true;\n }\n if (next.tanstackRouter === undefined) {\n next.tanstackRouter = await usesVitePlugin(\n tree,\n project.root,\n 'tanstackRouter',\n );\n changed = true;\n }\n }\n\n // The provider each of this project's components generated with. Recorded on\n // the component because that is where these generators record it — an agent\n // and an MCP server each choose their own provider.\n //\n // Left absent rather than set to an empty list where the project has no\n // components, so a project this backfill has nothing to add to is untouched.\n next.components = next.components?.map((component) => {\n if (component.iac !== undefined) {\n return component;\n }\n const componentIac =\n // The auth component vends no infrastructure of its own; it always\n // generates the shared constructs, so it took the project's provider.\n component.generator === COGNITO_AUTH_GENERATOR_INFO.id\n ? iac\n : componentInfrastructureProvider(tree, component);\n if (!componentIac) {\n return component;\n }\n changed = true;\n return { ...component, iac: componentIac };\n });\n\n // A connection already recorded is left as it is: re-recording it would\n // duplicate the entry, and the sync counts entries.\n const recorded = new Set(\n (next.components ?? []).map(\n (component) => `${component.generator}:${component.name}`,\n ),\n );\n const record = (component: ComponentMetadata) => {\n next.components = [...(next.components ?? []), component];\n recorded.add(`${component.generator}:${component.name}`);\n changed = true;\n };\n // The connections made from this project, each found by the trace its\n // generator left for the exact pair it wired up.\n for (const kind of CONNECTION_KINDS) {\n // A connection made from a component starts at each matching component. One\n // made from the project as a whole — a website, a tRPC API — starts at the\n // project's own metadata, which stands in for the source.\n const componentSources = (next.components ?? []).filter(\n (component) => component.generator === kind.sourceGenerator,\n );\n const sources: ComponentMetadata[] = componentSources.length\n ? componentSources\n : (kind.sourceGenerator === undefined ||\n kind.sourceGenerator === next.generator) &&\n next.generator\n ? [{ ...next, generator: next.generator }]\n : [];\n const candidates = kind.targetGenerators.flatMap(\n (generator) => targets.get(generator) ?? [],\n );\n for (const source of sources) {\n for (const target of candidates) {\n // A connection from a component to itself is not one any generator makes.\n if (\n target.projectName === projectName &&\n target.className === source.rc\n ) {\n continue;\n }\n const context: ConnectionContext = { tree, project, source, target };\n const name = kind.recordedName?.(context) ?? target.className;\n if (recorded.has(`${kind.id}:${name}`)) {\n continue;\n }\n const path = await kind.evidence(context);\n if (path === undefined) {\n continue;\n }\n record({\n generator: kind.id,\n path,\n name,\n ...(kind.sourceGenerator && source.path\n ? { sourcePath: source.path }\n : {}),\n ...kind.metadata?.(context),\n });\n }\n }\n }\n\n if (changed) {\n // Keep metadata before targets so the serialized key order matches what the\n // generators write, leaving this a pure metadata edit.\n const { targets: projectTargets, ...rest } = project;\n updateProjectConfiguration(tree, projectName, {\n ...rest,\n metadata: next as ProjectConfiguration['metadata'],\n ...(projectTargets ? { targets: projectTargets } : {}),\n });\n }\n }\n\n await formatFilesInSubtree(tree);\n\n return { nextSteps: [] };\n}\n"],"names":["relative","getProjects","joinPathFragments","readJson","updateProjectConfiguration","AGENTCORE_GATEWAY_GATEWAY_CONNECTION_GENERATOR_INFO","AGENTCORE_GATEWAY_GENERATOR_INFO","AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO","PY_AGENT_A2A_CONNECTION_GENERATOR_INFO","PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO","PY_AGENT_GENERATOR_INFO","PY_AGENT_MCP_CONNECTION_GENERATOR_INFO","PY_AGENT_REACT_CONNECTION_GENERATOR_INFO","PY_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO","PY_DYNAMODB_FAST_API_CONNECTION_GENERATOR_INFO","PY_DYNAMODB_GENERATOR_INFO","PY_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO","FAST_API_GENERATOR_INFO","FAST_API_REACT_GENERATOR_INFO","LAMBDA_FUNCTION_GENERATOR_INFO","PY_LAMBDA_FUNCTION_GENERATOR_INFO","PY_MCP_SERVER_GENERATOR_INFO","PY_RDB_AGENT_CONNECTION_GENERATOR_INFO","PY_RDB_FAST_API_CONNECTION_GENERATOR_INFO","PY_RDB_GENERATOR_INFO","PY_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO","SMITHY_PROJECT_GENERATOR_INFO","SMITHY_REACT_CONNECTION_GENERATOR_INFO","TS_SMITHY_API_GENERATOR_INFO","TRPC_BACKEND_GENERATOR_INFO","TRPC_REACT_GENERATOR_INFO","TS_AGENT_A2A_CONNECTION_GENERATOR_INFO","TS_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO","TS_AGENT_GENERATOR_INFO","TS_AGENT_MCP_CONNECTION_GENERATOR_INFO","TS_AGENT_REACT_CONNECTION_GENERATOR_INFO","TS_DCR_PROXY_GENERATOR_INFO","TS_DYNAMODB_AGENT_CONNECTION_GENERATOR_INFO","TS_DYNAMODB_GENERATOR_INFO","TS_DYNAMODB_MCP_SERVER_CONNECTION_GENERATOR_INFO","TS_DYNAMODB_SMITHY_CONNECTION_GENERATOR_INFO","TS_DYNAMODB_TRPC_CONNECTION_GENERATOR_INFO","TS_LAMBDA_FUNCTION_GENERATOR_INFO","TS_LIB_GENERATOR_INFO","TS_MCP_SERVER_GENERATOR_INFO","TS_RDB_AGENT_CONNECTION_GENERATOR_INFO","TS_RDB_GENERATOR_INFO","TS_RDB_MCP_SERVER_CONNECTION_GENERATOR_INFO","TS_RDB_SMITHY_CONNECTION_GENERATOR_INFO","TS_RDB_TRPC_CONNECTION_GENERATOR_INFO","REACT_WEBSITE_APP_GENERATOR_INFO","COGNITO_AUTH_GENERATOR_INFO","PY_CLIENT_NAMING","resolveAgentFramework","matchGritQL","DCR_PROXY_HANDLERS","formatFilesInSubtree","camelCase","kebabCase","pascalCase","toClassName","toSnakeCase","PACKAGES_DIR","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_DIR","SHARED_INFRA_ROOT","cdk","terraform","infrastructureProviders","tree","providers","Map","iac","configPath","exists","config","dependency","targets","build","dependsOn","name","split","projects","set","COMPONENT_INFRA","Object","fromEntries","id","map","appDirectory","paths","componentInfrastructureProvider","component","layout","generator","undefined","entry","isDcrProxyProject","projectRoot","every","handler","smithyProjectType","buildPath","plugins","keys","length","smithyNamespace","project","modelPath","sourceRoot","root","exec","read","at","usesVitePlugin","plugin","sourceQualifiedName","target","fallback","context","source","camelDatabase","databaseName","targetProjectName","projectName","py","pattern","dependsOnTargetDev","devTarget","some","Array","isArray","includes","agentClientConnection","language","targetGenerators","sourceGenerator","evidence","path","client","className","framework","clientClassSuffix","metadata","rdbConnection","options","targetGenerator","recordedName","entryPoint","devChainConnection","componentDevTarget","REST_API_INFRA","Set","websiteConnection","provider","CONNECTION_KINDS","auth","String","toLowerCase","isRestApi","has","infra","computeType","dependencies","pythonDependenciesDir","connectionTargets","shared","pop","add","get","rc","apiName","components","children","child","find","dir","migration","next","changed","smithyType","namespace","tailwind","tanstackRouter","componentIac","recorded","record","kind","componentSources","filter","sources","candidates","flatMap","sourcePath","projectTargets","rest","nextSteps"],"mappings":"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"}
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../packages/nx-plugin/src/migrations/v1.0.0-rc.56/dynamodb-local-remove-optimize-flag/migration.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { MigrationReturnObject, Tree } from '@nx/devkit';\nimport { applyGritQL } from '../../../utils/ast';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport {\n PACKAGES_DIR,\n SHARED_SCRIPTS_DIR,\n} from '../../../utils/shared-constructs-constants';\n\n/**\n * Drop -optimizeDbBeforeStartup from the vended DynamoDB Local container script\n *\n * DynamoDB Local's startup vacuum drops primary key / GSI uniqueness on the\n * underlying sqlite file, letting PutItem/UpdateItem write duplicate rows for\n * the same key.\n *\n * The edit is expressed as a GritQL rewrite so the script is matched on its\n * AST rather than its formatting. The rewrite matches the whole `runArgs`\n * array rather than just the flag, because this GritQL/tree-sitter grammar\n * can't match a partial slice of array elements, and a literal backtick\n * template string breaks matching anywhere it appears alongside other\n * elements - so every templated element (the port/volume args) is matched via\n * a metavariable instead of being spelled out.\n *\n * How to write a migration:\n * - https://nx.dev/docs/kb/migration-generators\n * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject\n *\n * Guardrails:\n * - Pattern-match before writing: skip files that have diverged from the shape\n * the generator produces and report them via `nextSteps`.\n * - Idempotent: re-running must be a no-op.\n * - Format what you write: finish with `formatFilesInSubtree`.\n */\n\nconst START_CONTAINER_FILE = `${PACKAGES_DIR}/${SHARED_SCRIPTS_DIR}/src/dynamodb/start-container.ts`;\n\nconst FLAG = \"'-optimizeDbBeforeStartup'\";\n\nconst REMOVE_FLAG_PATTERN = `\\`[\n 'run',\n ...(containerEngine === 'docker' ? ['--rm'] : []),\n '--name', containerName,\n '-u', 'root',\n '-w', '/home/dynamodblocal',\n $flagP, $portColonPort,\n '-v', $volume,\n '-d', image,\n '-jar', 'DynamoDBLocal.jar',\n '-sharedDb',\n '-dbPath', './data',\n '-port', $portArg,\n ${FLAG},\n ]\\` => \\`[\n 'run',\n ...(containerEngine === 'docker' ? ['--rm'] : []),\n '--name', containerName,\n '-u', 'root',\n '-w', '/home/dynamodblocal',\n $flagP, $portColonPort,\n '-v', $volume,\n '-d', image,\n '-jar', 'DynamoDBLocal.jar',\n '-sharedDb',\n '-dbPath', './data',\n '-port', $portArg,\n ]\\``;\n\nconst divergedNextStep = `${START_CONTAINER_FILE}: the container script has diverged from the generated shape - left untouched. Manually drop ${FLAG} from the DynamoDB Local container run args - its startup vacuum can drop primary key / GSI uniqueness on the sqlite file, letting PutItem/UpdateItem write duplicate rows for the same key.`;\n\nexport default async function migration(\n tree: Tree,\n): Promise<MigrationReturnObject> {\n const nextSteps: string[] = [];\n\n if (!tree.exists(START_CONTAINER_FILE)) {\n return { nextSteps };\n }\n\n const contents = tree.read(START_CONTAINER_FILE, 'utf-8') ?? '';\n if (!contents.includes(FLAG)) {\n // Already migrated, or doesn't use this shape.\n return { nextSteps };\n }\n\n const rewrote = await applyGritQL(\n tree,\n START_CONTAINER_FILE,\n REMOVE_FLAG_PATTERN,\n );\n\n if (!rewrote) {\n nextSteps.push(divergedNextStep);\n return { nextSteps };\n }\n\n await formatFilesInSubtree(tree);\n\n return { nextSteps };\n}\n"],"names":["applyGritQL","formatFilesInSubtree","PACKAGES_DIR","SHARED_SCRIPTS_DIR","START_CONTAINER_FILE","FLAG","REMOVE_FLAG_PATTERN","divergedNextStep","migration","tree","nextSteps","exists","contents","read","includes","rewrote","push"],"mappings":"AAAA;;;CAGC,GAED,SAASA,WAAW,QAAQ,wBAAqB;AACjD,SAASC,oBAAoB,QAAQ,2BAAwB;AAC7D,SACEC,YAAY,EACZC,kBAAkB,QACb,gDAA6C;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GAED,MAAMC,uBAAuB,GAAGF,aAAa,CAAC,EAAEC,mBAAmB,gCAAgC,CAAC;AAEpG,MAAME,OAAO;AAEb,MAAMC,sBAAsB,CAAC;;;;;;;;;;;;;IAazB,EAAED,KAAK;;;;;;;;;;;;;;KAcN,CAAC;AAEN,MAAME,mBAAmB,GAAGH,qBAAqB,6FAA6F,EAAEC,KAAK,4LAA4L,CAAC;AAElV,eAAe,eAAeG,UAC5BC,IAAU;IAEV,MAAMC,YAAsB,EAAE;IAE9B,IAAI,CAACD,KAAKE,MAAM,CAACP,uBAAuB;QACtC,OAAO;YAAEM;QAAU;IACrB;IAEA,MAAME,WAAWH,KAAKI,IAAI,CAACT,sBAAsB,YAAY;IAC7D,IAAI,CAACQ,SAASE,QAAQ,CAACT,OAAO;QAC5B,+CAA+C;QAC/C,OAAO;YAAEK;QAAU;IACrB;IAEA,MAAMK,UAAU,MAAMf,YACpBS,MACAL,sBACAE;IAGF,IAAI,CAACS,SAAS;QACZL,UAAUM,IAAI,CAACT;QACf,OAAO;YAAEG;QAAU;IACrB;IAEA,MAAMT,qBAAqBQ;IAE3B,OAAO;QAAEC;IAAU;AACrB"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */
5
+ import { type MigrationReturnObject, type Tree } from '@nx/devkit';
6
+ export default function migration(tree: Tree): Promise<MigrationReturnObject>;
@@ -0,0 +1,449 @@
1
+ /**
2
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ * SPDX-License-Identifier: Apache-2.0
4
+ */ import { getProjects, joinPathFragments, visitNotIgnoredFiles } from "@nx/devkit";
5
+ import { TS_AGENT_GENERATOR_INFO } from "../../../ts/agent/generator.js";
6
+ import { AGENT_CONNECTION_PROJECT_DIR } from "../../../utils/agent-connection/agent-connection.js";
7
+ import { applyGritQL, captureGritQLVariable, matchGritQL } from "../../../utils/ast.js";
8
+ import { formatFilesInSubtree } from "../../../utils/format.js";
9
+ import { isEsmWorkspace } from "../../../utils/module-format.js";
10
+ import { kebabCase } from "../../../utils/names.js";
11
+ import { getRelativePathToRootByDirectory, toProjectRelativePath } from "../../../utils/paths.js";
12
+ /**
13
+ * Add session management support to ts#agent.
14
+ *
15
+ * How to write a migration:
16
+ * - https://nx.dev/docs/kb/migration-generators
17
+ * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject
18
+ *
19
+ * Guardrails:
20
+ * - Pattern-match before writing: skip files that have diverged from the shape
21
+ * your generators produce and report them via `nextSteps`, or consider a
22
+ * hybrid migration, rather than clobbering the user's changes.
23
+ * - Idempotent: re-running must be a no-op.
24
+ * - Format what you write: finish with `formatFilesInSubtree` so the files your
25
+ * migration wrote are formatted correctly.
26
+ */ // Reshapes an `agentRuntimes` rc.set entry from a bare ARN to `{ arn }`. Only
27
+ // the 'agentcore' namespace — 'connection' (client-facing) stays a string,
28
+ // since it shouldn't carry the session bucket name to the browser. No
29
+ // `session` field added here; a fresh session.ts (created below) defaults to
30
+ // in-memory. Idempotent: only matches the pre-migration shape.
31
+ const CDK_RC_SET_PATTERN = `\`rc.set('agentcore', 'agentRuntimes', { ...rc.get('agentcore').agentRuntimes, $name: this.agentCoreRuntime.agentRuntimeArn });\` => raw\`rc.set('agentcore', 'agentRuntimes', {
32
+ ...rc.get('agentcore').agentRuntimes,
33
+ $name: {
34
+ arn: this.agentCoreRuntime.agentRuntimeArn,
35
+ },
36
+ });\``;
37
+ // Terraform equivalent, anchored on the module's fixed name/shape so it
38
+ // doesn't also match the 'connection' module's identical-looking `value` line.
39
+ const TF_VALUE_PATTERN = `language hcl\n\`module "add_agent_runtime_to_runtime_config" {
40
+ source = "../../../core/runtime-config/entry"
41
+
42
+ namespace = "agentcore"
43
+ key = "agentRuntimes"
44
+ value = { "$name" = module.agent_core_runtime.agent_core_runtime_arn }
45
+
46
+ depends_on = [module.agent_core_runtime]
47
+ }\` => \`module "add_agent_runtime_to_runtime_config" {
48
+ source = "../../../core/runtime-config/entry"
49
+
50
+ namespace = "agentcore"
51
+ key = "agentRuntimes"
52
+ value = { "$name" = { arn = module.agent_core_runtime.agent_core_runtime_arn } }
53
+
54
+ depends_on = [module.agent_core_runtime]
55
+ }\``;
56
+ // Shared `AgentCoreRuntimeConfig` interface, vended into
57
+ // `packages/common/agent-connection/src/core/runtime-config.ts`.
58
+ const TS_RUNTIME_CONFIG_INTERFACE_PATTERN = `\`export interface AgentCoreRuntimeConfig {
59
+ agentRuntimes?: Record<string, string>;
60
+ gateways?: Record<string, string>;
61
+ }\` => raw\`export interface AgentRuntimeEntry {
62
+ arn: string;
63
+ /** Session storage details. Only set when the agent has S3 session storage configured. */
64
+ session?: {
65
+ /** Name of the S3 bucket storing session data. */
66
+ bucketName: string;
67
+ };
68
+ }
69
+
70
+ export interface AgentCoreRuntimeConfig {
71
+ agentRuntimes?: Record<string, AgentRuntimeEntry>;
72
+ gateways?: Record<string, string>;
73
+ }\``;
74
+ // `config.agentRuntimes?.['Name']` as read by generated TS a2a/mcp clients and
75
+ // the agent-chat CLI. Idempotent via the `not contains ?.arn` guard.
76
+ const TS_CLIENT_ARN_PATTERNS = [
77
+ '`config.agentRuntimes?.[$name]` => `config.agentRuntimes?.[$name]?.arn` where { $program <: not contains `config.agentRuntimes?.[$name]?.arn` }',
78
+ '`config?.agentRuntimes?.[$name]` => `config?.agentRuntimes?.[$name]?.arn` where { $program <: not contains `config?.agentRuntimes?.[$name]?.arn` }'
79
+ ];
80
+ // The agent-chat CLI's agentcore.ts calls `getAppConfig` directly rather than
81
+ // the shared `AgentCoreRuntimeConfig` type, so its own inline cast needs the
82
+ // same { arn } reshape TS_RUNTIME_CONFIG_INTERFACE_PATTERN gives the shared
83
+ // interface.
84
+ const AGENTCORE_CHAT_SCRIPT_TYPE_PATTERN = '`{ agentRuntimes?: Record<string, string> }` => `{ agentRuntimes?: Record<string, { arn: string }> }`';
85
+ // Python equivalent (Strands + LangChain client templates).
86
+ const PY_CLIENT_ARN_PATTERN = 'language python\n`agent_runtime_arn = config.get("agentRuntimes", {}).get($name)` => `agent_runtime = config.get("agentRuntimes", {}).get($name)\nagent_runtime_arn = agent_runtime.get("arn") if agent_runtime else None`';
87
+ // Removes the imperative logModelErrors(agent)/logToolErrors(agent) calls.
88
+ // Required for AG-UI (its adapter clones the template agent per-thread, and
89
+ // hooks added directly to the template don't carry over — the equivalent
90
+ // behaviour is restored via the AGUI_INDEX_* plugins below). For HTTP/A2A
91
+ // it's a style unification, since the imperative form already worked there.
92
+ const AGENT_TS_LOG_MODEL_CALL_PATTERN = '`logModelErrors(agent);` => .';
93
+ const AGENT_TS_LOG_TOOL_CALL_PATTERN = '`logToolErrors(agent);` => .';
94
+ // HTTP/A2A agents build one Agent per session, so wiring `sessionManager`
95
+ // directly into the constructor is safe. Generic over `$props` so this works
96
+ // regardless of customised systemPrompt/tools, as long as it's an inline
97
+ // object literal. Prepended (not appended) to sidestep a trailing-comma
98
+ // double-comma when `$props` is captured as raw source text.
99
+ const AGENT_TS_SESSION_MANAGER_CONSTRUCTOR_PATTERN = '`new Agent({ $props })` => `new Agent({ sessionManager: await getSessionManager(), $props })` where { $props <: not contains `sessionManager` }';
100
+ // Match-only gate for the rewrites above/below: only applies when the Agent
101
+ // is an inline object literal, not e.g. a variable.
102
+ const AGENT_TS_CONSTRUCTOR_MATCH_PATTERN = '`new Agent({ $props })`';
103
+ // Moves the model/tool error hooks to Agent constructor plugins, mirroring
104
+ // the AG-UI rewrite for consistency (HTTP/A2A already worked with the
105
+ // imperative form).
106
+ const AGENT_TS_PLUGINS_CONSTRUCTOR_PATTERN = '`new Agent({ $props })` => `new Agent({ plugins: [new ModelErrorLoggingPlugin(), new ToolErrorLoggingPlugin()], $props })` where { $props <: not contains `plugins` }';
107
+ // Captures the agent-connection package specifier so the new imports (and the
108
+ // session.ts this migration creates) target the same module. Generic over
109
+ // `$names` since a connection generator may have merged its own import here.
110
+ const AGENT_TS_LOG_IMPORT_CAPTURE_PATTERN = "`import { $names } from '$mod';` where { $names <: contains `logModelErrors`, $names <: contains `logToolErrors` }";
111
+ // Removes `logModelErrors`/`logToolErrors` from the import, preserving any
112
+ // other merged specifiers (or the whole statement if none remain). Decomposed
113
+ // via `import_clause(name=named_imports($imports))` since a naive
114
+ // `$rest`-based rewrite silently fails once 2+ other specifiers are merged in.
115
+ const AGENT_TS_REMOVE_LOG_ERRORS_IMPORT_PATTERN = "`import $clause from '$mod';` as $import where { $clause <: import_clause(name=named_imports($imports)), $imports <: contains `logModelErrors`, $imports <: contains `logToolErrors`, if ($imports <: [`logModelErrors`, `logToolErrors`]) { $import => . } else { $imports <: some import_specifier(name=or { `logModelErrors`, `logToolErrors` }) => . } }";
116
+ // Existing agents predate session.ts, so there's no prior storage to
117
+ // preserve — default to in-memory.
118
+ const legacySessionManagerContent = (agentConnectionModule, localSessionsDir)=>`import { SessionManager } from '@strands-agents/sdk';
119
+ import { InMemoryStorage, LocalFileStorage } from '@strands-agents/sdk/storage';
120
+ import { getCurrentSessionId } from '${agentConnectionModule}';
121
+
122
+ /**
123
+ * Returns a SessionManager for persisting conversation state across
124
+ * invocations. Local development always uses local file storage for
125
+ * convenience, regardless of the configured session option. Without a
126
+ * configured session option, conversation state is kept in memory only and
127
+ * does not survive process restarts.
128
+ */
129
+ export const getSessionManager = async (): Promise<SessionManager> => {
130
+ const sessionId = getCurrentSessionId();
131
+ if (!sessionId) {
132
+ throw new Error(
133
+ 'No current session id — cannot resolve a SessionManager outside of a request scope.',
134
+ );
135
+ }
136
+ if (process.env.LOCAL_DEV === 'true') {
137
+ return new SessionManager({
138
+ sessionId,
139
+ storage: new LocalFileStorage('${localSessionsDir}'),
140
+ });
141
+ }
142
+ return new SessionManager({ sessionId, storage: new InMemoryStorage() });
143
+ };
144
+ `;
145
+ /** The Nx project owning `dirPath`, if any (the longest-matching project.root). */ const findOwningProject = (tree, dirPath)=>{
146
+ let best;
147
+ for (const project of getProjects(tree).values()){
148
+ if ((dirPath === project.root || dirPath.startsWith(`${project.root}/`)) && (!best || project.root.length > best.root.length)) {
149
+ best = project;
150
+ }
151
+ }
152
+ return best;
153
+ };
154
+ /** This agent's own ComponentMetadata entry, as written by the ts#agent generator. */ const findAgentComponentMetadata = (project, dirRelativeToProjectRoot)=>project.metadata?.components?.find((component)=>component.generator === TS_AGENT_GENERATOR_INFO.id && component.path === dirRelativeToProjectRoot);
155
+ /** This agent's real kebab-case name, from ComponentMetadata's `rc` (class-name) field. */ const agentTmpNameFor = (project, dir)=>{
156
+ const dirRelativeToProjectRoot = toProjectRelativePath(project, dir);
157
+ const rc = findAgentComponentMetadata(project, dirRelativeToProjectRoot)?.rc;
158
+ return rc ? kebabCase(rc) : undefined;
159
+ };
160
+ /** This agent's protocol, from ComponentMetadata's `protocol` field. */ const agentProtocolFor = (project, dir)=>{
161
+ const dirRelativeToProjectRoot = toProjectRelativePath(project, dir);
162
+ return findAgentComponentMetadata(project, dirRelativeToProjectRoot)?.protocol;
163
+ };
164
+ /** The relative path from `projectRoot` up to this agent's workspace-root-level local session storage. */ const localSessionsDirFor = (projectRoot, agentTmpName)=>joinPathFragments(getRelativePathToRootByDirectory(projectRoot), `tmp/agents/strands/${agentTmpName}`);
165
+ // Wires ModelErrorLoggingPlugin/ToolErrorLoggingPlugin into the StrandsAgent
166
+ // constructor, restoring the error-logging behaviour removed from agent.ts.
167
+ const AGUI_INDEX_IMPORT_PATTERN = "`import { $names } from '$mod'` => `import { ModelErrorLoggingPlugin, ToolErrorLoggingPlugin, $names } from '$mod'` where { $names <: contains `runWithSessionId`, $names <: not contains `ModelErrorLoggingPlugin` }";
168
+ // Match-only form of the target shape, used to gate before touching the
169
+ // sibling agent.ts, and before committing to the rewrite here.
170
+ const AGUI_INDEX_CONSTRUCTOR_MATCH_PATTERN = '`new StrandsAgent({ agent, name: $name, description: $desc })`';
171
+ const AGUI_INDEX_CONSTRUCTOR_PATTERN = `${AGUI_INDEX_CONSTRUCTOR_MATCH_PATTERN} => \`new StrandsAgent({ agent, name: $name, description: $desc, plugins: [new ModelErrorLoggingPlugin(), new ToolErrorLoggingPlugin()] })\``;
172
+ const AGUI_INDEX_IMPORT_CAPTURE_PATTERN = "`import { $names } from '$mod';` where { $names <: contains `runWithSessionId` }";
173
+ // AG-UI's StrandsAgent adapter needs a sessionManagerProvider (called once
174
+ // per threadId), mirroring AGENT_TS_SESSION_MANAGER_CONSTRUCTOR_PATTERN.
175
+ const aguiIndexSessionManagerImportPattern = (esm)=>`\`import { getAgent } from '$mod';\` => raw\`import { getAgent } from '$mod';
176
+ import { getSessionManager } from './session${esm ? '.js' : ''}';\` where { $program <: not contains \`getSessionManager\` }`;
177
+ // Anchored on the exact 4-property shape produced above, so this only fires
178
+ // once plugins are wired in. Used both to gate and to rewrite.
179
+ const AGUI_INDEX_SESSION_MANAGER_MATCH_PATTERN = '`new StrandsAgent({ agent, name: $name, description: $desc, plugins: $plugins })`';
180
+ const AGUI_INDEX_SESSION_MANAGER_CONSTRUCTOR_PATTERN = `${AGUI_INDEX_SESSION_MANAGER_MATCH_PATTERN} => \`new StrandsAgent({ agent, name: $name, description: $desc, plugins: $plugins, config: { sessionManagerProvider: getSessionManager } })\``;
181
+ // The plugin classes referenced above only exist once model-errors-strands.ts
182
+ // / tool-errors-strands.ts are converted from their plain logXErrors function
183
+ // form (see checkPluginClass/applyPluginClass below). Anchored on the
184
+ // `agent.addHook(...)` call so this doesn't re-match its own output.
185
+ const MODEL_ERRORS_IMPORT_PATTERN = "`import { AfterModelCallEvent, type LocalAgent } from '@strands-agents/sdk';` => `import { AfterModelCallEvent, type LocalAgent, type Plugin } from '@strands-agents/sdk';`";
186
+ // Match-only form of the target shape, checked before committing to either
187
+ // this or the sibling tool-errors conversion — see checkPluginClass.
188
+ const MODEL_ERRORS_CLASS_MATCH_PATTERN = '`export const logModelErrors = (agent: LocalAgent): void => { agent.addHook(AfterModelCallEvent, $callback); };`';
189
+ const MODEL_ERRORS_CLASS_PATTERN = `${MODEL_ERRORS_CLASS_MATCH_PATTERN} => raw\`export class ModelErrorLoggingPlugin implements Plugin {\n readonly name = 'model-error-logging';\n\n initAgent(agent: LocalAgent): void {\n agent.addHook(AfterModelCallEvent, $callback);\n }\n}\``;
190
+ const TOOL_ERRORS_IMPORT_PATTERN = "`import { AfterToolCallEvent, type LocalAgent, TextBlock } from '@strands-agents/sdk';` => `import { AfterToolCallEvent, type LocalAgent, type Plugin, TextBlock } from '@strands-agents/sdk';`";
191
+ const TOOL_ERRORS_CLASS_MATCH_PATTERN = '`export const logToolErrors = (agent: LocalAgent): void => { agent.addHook(AfterToolCallEvent, $callback); };`';
192
+ const TOOL_ERRORS_CLASS_PATTERN = `${TOOL_ERRORS_CLASS_MATCH_PATTERN} => raw\`export class ToolErrorLoggingPlugin implements Plugin {\n readonly name = 'tool-error-logging';\n\n initAgent(agent: LocalAgent): void {\n agent.addHook(AfterToolCallEvent, $callback);\n }\n}\``;
193
+ /**
194
+ * Checks (without writing) whether `filePath` still needs converting from its
195
+ * plain `logXErrors` function to `className`, and whether the conversion
196
+ * pattern would actually apply. `'done'` covers both "already converted" and
197
+ * "file doesn't exist" — either way there's nothing to do and nothing
198
+ * blocking the sibling conversion.
199
+ */ async function checkPluginClass(tree, filePath, className, classMatchPattern) {
200
+ if (!tree.exists(filePath)) {
201
+ return 'done';
202
+ }
203
+ if ((tree.read(filePath, 'utf-8') ?? '').includes(`class ${className}`)) {
204
+ return 'done';
205
+ }
206
+ return await matchGritQL(tree, filePath, classMatchPattern) ? 'ready' : 'diverged';
207
+ }
208
+ /** Applies the class + import rewrite for a file already confirmed `'ready'`. */ async function applyPluginClass(tree, filePath, importPattern, classPattern) {
209
+ // The class rewrite is applied first, and the import only added once it's
210
+ // confirmed to have actually happened here — not because either could fail
211
+ // at this point (checkPluginClass already confirmed the pattern matches),
212
+ // but to keep this file's own edit order self-evidently safe to read.
213
+ await applyGritQL(tree, filePath, classPattern);
214
+ await applyGritQL(tree, filePath, importPattern);
215
+ }
216
+ export default async function migration(tree) {
217
+ const nextSteps = [];
218
+ let anyChanges = false;
219
+ // Both classes live in one shared agent-connection package, so their
220
+ // readiness is resolved once up front rather than per agent.
221
+ const modelErrorsPath = joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'core', 'model-errors-strands.ts');
222
+ const toolErrorsPath = joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'core', 'tool-errors-strands.ts');
223
+ // Checked together, before writing either: all-or-nothing, so a run either
224
+ // converts both or leaves both untouched — never just one.
225
+ const modelPluginStatus = await checkPluginClass(tree, modelErrorsPath, 'ModelErrorLoggingPlugin', MODEL_ERRORS_CLASS_MATCH_PATTERN);
226
+ const toolPluginStatus = await checkPluginClass(tree, toolErrorsPath, 'ToolErrorLoggingPlugin', TOOL_ERRORS_CLASS_MATCH_PATTERN);
227
+ const pluginsReady = modelPluginStatus !== 'diverged' && toolPluginStatus !== 'diverged';
228
+ if (pluginsReady) {
229
+ if (modelPluginStatus === 'ready') {
230
+ await applyPluginClass(tree, modelErrorsPath, MODEL_ERRORS_IMPORT_PATTERN, MODEL_ERRORS_CLASS_PATTERN);
231
+ }
232
+ if (toolPluginStatus === 'ready') {
233
+ await applyPluginClass(tree, toolErrorsPath, TOOL_ERRORS_IMPORT_PATTERN, TOOL_ERRORS_CLASS_PATTERN);
234
+ }
235
+ } else {
236
+ if (modelPluginStatus === 'diverged') {
237
+ nextSteps.push(`${modelErrorsPath}: diverged from the generated shape - left as-is. Manually convert it to a \`ModelErrorLoggingPlugin\` class implementing \`Plugin\` (see the ts#agent generator's template); agent.ts/index.ts files that reference it are left unmigrated until both this and ${toolErrorsPath} are converted.`);
238
+ }
239
+ if (toolPluginStatus === 'diverged') {
240
+ nextSteps.push(`${toolErrorsPath}: diverged from the generated shape - left as-is. Manually convert it to a \`ToolErrorLoggingPlugin\` class implementing \`Plugin\` (see the ts#agent generator's template); agent.ts/index.ts files that reference it are left unmigrated until both this and ${modelErrorsPath} are converted.`);
241
+ }
242
+ }
243
+ const filePaths = [];
244
+ visitNotIgnoredFiles(tree, '', (filePath)=>filePaths.push(filePath));
245
+ for (const filePath of filePaths){
246
+ if (filePath === modelErrorsPath || filePath === toolErrorsPath) {
247
+ continue;
248
+ }
249
+ if (filePath.endsWith('.d.ts')) {
250
+ continue;
251
+ }
252
+ // session.ts already targets the new { arn, session } shape via
253
+ // `config.agentRuntimes?.[$name]?.session?.bucketName` — the generic
254
+ // reshape branch below would otherwise corrupt that into `?.arn?.session?.bucketName`.
255
+ if (filePath.endsWith('/session.ts')) {
256
+ continue;
257
+ }
258
+ if (filePath.endsWith('/agent.ts')) {
259
+ const dir = filePath.split('/').slice(0, -1).join('/');
260
+ const project = findOwningProject(tree, dir);
261
+ // Without a registered project there's no ComponentMetadata, so this
262
+ // agent's protocol/name/agent-connection module can't be resolved — and
263
+ // a pre-migration AG-UI agent.ts is textually identical to an
264
+ // HTTP/A2A one, so there's nothing left to safely guess from.
265
+ if (!project) {
266
+ if (await matchGritQL(tree, filePath, AGENT_TS_LOG_IMPORT_CAPTURE_PATTERN)) {
267
+ nextSteps.push(`${filePath}: could not determine the project root — manually verify whether this is an AG-UI or HTTP/A2A agent and complete its session-manager/error-logging-plugin migration accordingly (see the ts#agent generator's template).`);
268
+ }
269
+ continue;
270
+ }
271
+ const protocol = agentProtocolFor(project, dir);
272
+ if (protocol === 'ag-ui') {
273
+ const hasLogCalls = await matchGritQL(tree, filePath, AGENT_TS_LOG_MODEL_CALL_PATTERN) || await matchGritQL(tree, filePath, AGENT_TS_LOG_TOOL_CALL_PATTERN);
274
+ if (!hasLogCalls) {
275
+ continue;
276
+ }
277
+ // The sibling index.ts restores error-logging via StrandsAgent
278
+ // plugins — removing the calls here without that succeeding would
279
+ // drop error logging rather than move it.
280
+ const indexPath = `${dir}/index.ts`;
281
+ const indexReady = pluginsReady && await matchGritQL(tree, indexPath, AGUI_INDEX_CONSTRUCTOR_MATCH_PATTERN);
282
+ if (!indexReady) {
283
+ nextSteps.push(`${filePath}: left the logModelErrors/logToolErrors calls in place — ${indexPath} could not be automatically wired with the equivalent StrandsAgent plugins. Move error logging to plugins there manually (see the ts#agent generator's template), then remove these calls.`);
284
+ continue;
285
+ }
286
+ const rewroteImport = await applyGritQL(tree, filePath, AGENT_TS_REMOVE_LOG_ERRORS_IMPORT_PATTERN);
287
+ const rewroteModelCall = await applyGritQL(tree, filePath, AGENT_TS_LOG_MODEL_CALL_PATTERN);
288
+ const rewroteToolCall = await applyGritQL(tree, filePath, AGENT_TS_LOG_TOOL_CALL_PATTERN);
289
+ if (rewroteImport || rewroteModelCall || rewroteToolCall) {
290
+ anyChanges = true;
291
+ }
292
+ continue;
293
+ }
294
+ if (!protocol) {
295
+ if (await matchGritQL(tree, filePath, AGENT_TS_LOG_IMPORT_CAPTURE_PATTERN)) {
296
+ nextSteps.push(`${filePath}: could not determine this agent's protocol from its ComponentMetadata — manually verify whether it's AG-UI or HTTP/A2A and wire sessionManager/the error-logging plugins in accordingly (see the ts#agent generator's template).`);
297
+ }
298
+ continue;
299
+ }
300
+ // HTTP/A2A: wire sessionManager into the Agent constructor and create
301
+ // the sibling session.ts if it doesn't exist yet.
302
+ if (!await matchGritQL(tree, filePath, AGENT_TS_LOG_IMPORT_CAPTURE_PATTERN)) {
303
+ continue;
304
+ }
305
+ const sessionPath = `${dir}/session.ts`;
306
+ // Checked before any writes: if the plugin classes aren't available, or
307
+ // the Agent isn't an inline object literal, leave the file untouched
308
+ // entirely rather than ending up half-migrated.
309
+ if (!pluginsReady) {
310
+ nextSteps.push(`${filePath}: left as-is — ModelErrorLoggingPlugin/ToolErrorLoggingPlugin are not available yet (see the model-errors-strands.ts/tool-errors-strands.ts next step above). Wire sessionManager and the plugins in manually once those classes exist.`);
311
+ continue;
312
+ }
313
+ if (!await matchGritQL(tree, filePath, AGENT_TS_CONSTRUCTOR_MATCH_PATTERN)) {
314
+ nextSteps.push(`${filePath}: the Agent is not constructed with an inline object literal (\`new Agent({ ... })\`), so sessionManager and the error-logging plugins could not be wired in automatically. Manually add \`sessionManager: await getSessionManager()\` and \`plugins: [new ModelErrorLoggingPlugin(), new ToolErrorLoggingPlugin()]\` to its constructor (see the ts#agent generator's template), creating ${sessionPath} first if it doesn't already exist.`);
315
+ continue;
316
+ }
317
+ if (!tree.exists(sessionPath)) {
318
+ const mod = await captureGritQLVariable(tree, filePath, AGENT_TS_LOG_IMPORT_CAPTURE_PATTERN, 'mod');
319
+ const agentName = agentTmpNameFor(project, dir);
320
+ if (mod && agentName) {
321
+ tree.write(sessionPath, legacySessionManagerContent(mod, localSessionsDirFor(project.root, agentName)));
322
+ } else {
323
+ nextSteps.push(`${filePath}: could not determine the agent-connection module or this agent's name from its ComponentMetadata — manually create a session.ts (see the ts#agent generator's template) and wire \`sessionManager: await getSessionManager()\` into the Agent constructor.`);
324
+ continue;
325
+ }
326
+ }
327
+ // Merges the plugin imports into the existing logModelErrors/
328
+ // logToolErrors import clause (rather than a redundant second import),
329
+ // and adds getSessionManager as its own line. The old specifiers are
330
+ // stripped separately below, after this rewrite anchors on them.
331
+ const esm = isEsmWorkspace(tree);
332
+ await applyGritQL(tree, filePath, `\`import { $names } from '$mod';\` => raw\`import { ModelErrorLoggingPlugin, ToolErrorLoggingPlugin, $names } from '$mod';
333
+ import { getSessionManager } from './session${esm ? '.js' : ''}';\` where { $names <: contains \`logModelErrors\`, $names <: contains \`logToolErrors\`, $program <: not contains \`getSessionManager\` }`);
334
+ // Only rewrite the constructor once the import is confirmed present.
335
+ if (!(tree.read(filePath, 'utf-8') ?? '').includes('getSessionManager')) {
336
+ nextSteps.push(`${filePath}: found ${sessionPath} but couldn't confirm the getSessionManager import — wire \`sessionManager: await getSessionManager()\` into the Agent constructor manually.`);
337
+ continue;
338
+ }
339
+ await applyGritQL(tree, filePath, AGENT_TS_LOG_MODEL_CALL_PATTERN);
340
+ await applyGritQL(tree, filePath, AGENT_TS_LOG_TOOL_CALL_PATTERN);
341
+ await applyGritQL(tree, filePath, AGENT_TS_REMOVE_LOG_ERRORS_IMPORT_PATTERN);
342
+ const rewrotePlugins = await applyGritQL(tree, filePath, AGENT_TS_PLUGINS_CONSTRUCTOR_PATTERN);
343
+ const rewroteConstructor = await applyGritQL(tree, filePath, AGENT_TS_SESSION_MANAGER_CONSTRUCTOR_PATTERN);
344
+ if (rewrotePlugins || rewroteConstructor) {
345
+ anyChanges = true;
346
+ }
347
+ continue;
348
+ }
349
+ if (filePath.endsWith('/index.ts') && (tree.read(filePath, 'utf-8') ?? '').includes('@ag-ui/aws-strands')) {
350
+ const alreadyWired = (tree.read(filePath, 'utf-8') ?? '').includes('ModelErrorLoggingPlugin');
351
+ if (!alreadyWired) {
352
+ // Import and constructor only apply cleanly together — adding the
353
+ // import while the constructor can't be rewritten would leave an
354
+ // unused import and no plugins wired in.
355
+ const needsPluginWiring = await matchGritQL(tree, filePath, AGUI_INDEX_CONSTRUCTOR_MATCH_PATTERN);
356
+ if (!pluginsReady) {
357
+ if (needsPluginWiring) {
358
+ nextSteps.push(`${filePath}: left the StrandsAgent constructor as-is — ModelErrorLoggingPlugin/ToolErrorLoggingPlugin are not available yet (see the model-errors-strands.ts/tool-errors-strands.ts next step above). Wire them in manually once those classes exist.`);
359
+ }
360
+ continue;
361
+ }
362
+ if (!needsPluginWiring) {
363
+ nextSteps.push(`${filePath}: the StrandsAgent constructor has diverged from the generated shape - left as-is. Manually add \`plugins: [new ModelErrorLoggingPlugin(), new ToolErrorLoggingPlugin()]\` to it (see the ts#agent generator's template).`);
364
+ continue;
365
+ }
366
+ const rewroteImport = await applyGritQL(tree, filePath, AGUI_INDEX_IMPORT_PATTERN);
367
+ const rewroteConstructor = await applyGritQL(tree, filePath, AGUI_INDEX_CONSTRUCTOR_PATTERN);
368
+ if (rewroteImport || rewroteConstructor) {
369
+ anyChanges = true;
370
+ }
371
+ }
372
+ // Create the sibling session.ts (once plugins are present) and wire in
373
+ // sessionManagerProvider. Gated on the exact post-plugins shape, so a
374
+ // customised constructor is left alone rather than creating an unused
375
+ // session.ts.
376
+ if (!await matchGritQL(tree, filePath, AGUI_INDEX_SESSION_MANAGER_MATCH_PATTERN)) {
377
+ continue;
378
+ }
379
+ const dir = filePath.split('/').slice(0, -1).join('/');
380
+ const sessionPath = `${dir}/session.ts`;
381
+ if (!tree.exists(sessionPath)) {
382
+ const project = findOwningProject(tree, dir);
383
+ const mod = await captureGritQLVariable(tree, filePath, AGUI_INDEX_IMPORT_CAPTURE_PATTERN, 'mod');
384
+ const agentName = project && agentTmpNameFor(project, dir);
385
+ if (project && mod && agentName) {
386
+ tree.write(sessionPath, legacySessionManagerContent(mod, localSessionsDirFor(project.root, agentName)));
387
+ } else {
388
+ nextSteps.push(`${filePath}: could not determine the project root, agent-connection module, or this agent's name from its ComponentMetadata — manually create a session.ts (see the ts#agent generator's template) and wire \`config: { sessionManagerProvider: getSessionManager }\` into the StrandsAgent constructor.`);
389
+ continue;
390
+ }
391
+ }
392
+ const esm = isEsmWorkspace(tree);
393
+ await applyGritQL(tree, filePath, aguiIndexSessionManagerImportPattern(esm));
394
+ if (!(tree.read(filePath, 'utf-8') ?? '').includes('getSessionManager')) {
395
+ nextSteps.push(`${filePath}: found ${sessionPath} but couldn't confirm the getSessionManager import — wire \`config: { sessionManagerProvider: getSessionManager }\` into the StrandsAgent constructor manually.`);
396
+ continue;
397
+ }
398
+ const rewroteSessionManagerConstructor = await applyGritQL(tree, filePath, AGUI_INDEX_SESSION_MANAGER_CONSTRUCTOR_PATTERN);
399
+ if (rewroteSessionManagerConstructor) {
400
+ anyChanges = true;
401
+ }
402
+ continue;
403
+ }
404
+ if (filePath.endsWith('.ts') || filePath.endsWith('.tsx')) {
405
+ const contents = tree.read(filePath, 'utf-8') ?? '';
406
+ if (!contents.includes('agentRuntimes')) {
407
+ continue;
408
+ }
409
+ // Only the 'agentcore' namespace is reshaped — see CDK_RC_SET_PATTERN.
410
+ const rewroteAgentcoreRcSet = await applyGritQL(tree, filePath, CDK_RC_SET_PATTERN);
411
+ const rewroteInterface = await applyGritQL(tree, filePath, TS_RUNTIME_CONFIG_INTERFACE_PATTERN);
412
+ let rewroteClientArn = false;
413
+ for (const pattern of TS_CLIENT_ARN_PATTERNS){
414
+ rewroteClientArn = await applyGritQL(tree, filePath, pattern) ? true : rewroteClientArn;
415
+ }
416
+ const rewroteChatScriptType = await applyGritQL(tree, filePath, AGENTCORE_CHAT_SCRIPT_TYPE_PATTERN);
417
+ if (rewroteAgentcoreRcSet || rewroteInterface || rewroteClientArn || rewroteChatScriptType) {
418
+ anyChanges = true;
419
+ }
420
+ } else if (filePath.endsWith('.tf')) {
421
+ const contents = tree.read(filePath, 'utf-8') ?? '';
422
+ if (!contents.includes('"agentRuntimes"')) {
423
+ continue;
424
+ }
425
+ const rewrote = await applyGritQL(tree, filePath, TF_VALUE_PATTERN);
426
+ if (rewrote) {
427
+ anyChanges = true;
428
+ }
429
+ } else if (filePath.endsWith('.py')) {
430
+ const contents = tree.read(filePath, 'utf-8') ?? '';
431
+ if (!contents.includes('agentRuntimes')) {
432
+ continue;
433
+ }
434
+ const rewrote = await applyGritQL(tree, filePath, PY_CLIENT_ARN_PATTERN);
435
+ if (rewrote) {
436
+ anyChanges = true;
437
+ }
438
+ }
439
+ }
440
+ if (anyChanges) {
441
+ nextSteps.push('If you have custom code reading the runtime config `agentcore.agentRuntimes` entries ' + 'as plain ARN strings (e.g. custom Lambda handlers or agent code), update it to read ' + 'the ARN from `.arn` on the new `{ arn }` shape.');
442
+ }
443
+ await formatFilesInSubtree(tree);
444
+ return {
445
+ nextSteps
446
+ };
447
+ }
448
+
449
+ //# sourceMappingURL=migration.js.map