@aws/nx-plugin 1.0.0-rc.96 → 1.0.0-rc.97

package/src/ts/react-website/app/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/app/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  detectPackageManager,\n  generateFiles,\n  joinPathFragments,\n  names,\n  OverwriteStrategy,\n  readProjectConfiguration,\n  removeDependenciesFromPackageJson,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applicationGenerator } from '@nx/react';\nimport { relative, sep } from 'path';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../../utils/format.js';\nimport { resolveIac } from '../../../utils/iac.js';\nimport { installDependencies } from '../../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics.js';\nimport { kebabCase, toClassName, toKebabCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { getRelativePathToRoot } from '../../../utils/paths.js';\nimport { getPackageManagerDisplayCommands } from '../../../utils/pkg-manager.js';\nimport { assignPort } from '../../../utils/port.js';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../../utils/shared-constructs.js';\nimport {\n  type IacMetadata,\n  PACKAGES_DIR,\n  SHARED_SHADCN_DIR,\n  TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n} from '../../../utils/shared-constructs-constants.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { withVersions } from '../../../utils/versions.js';\nimport {\n  addWebsiteInfra,\n  WEBSITE_CONSTRUCTS_PY_DEPENDENCIES,\n} from '../../../utils/website-constructs/website-constructs.js';\nimport {\n  configureTsProject,\n  TS_PROJECT_DEPENDENCIES,\n} from '../../lib/ts-project-utils.js';\nimport { VITEST_DEPENDENCIES } from '../../lib/vitest.js';\n// typescript factory imports removed — now using GritQL for vite config transforms\nimport type {\n  TsReactWebsiteGeneratorSchema,\n  WebsiteInfraOption,\n} from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsReactWebsiteMetadata extends IacMetadata {\n  readonly ux: UxOption;\n  readonly framework: string;\n  readonly infra: WebsiteInfraOption;\n  readonly tailwind: boolean;\n  readonly tanstackRouter: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsReactWebsiteMetadata>()({\n  ts: [\n    { name: 'react' },\n    { name: 'react-dom' },\n    // Build/test tooling imported only from vite.config.mts stays at the root.\n    { name: '@nx/react', dev: true, root: true },\n    { name: '@vitest/ui', dev: true, root: true },\n    {\n      name: '@cloudscape-design/components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/board-components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/global-styles',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    // Shared shadcn components live in the common/shadcn package, but the\n    // website's own generated components (e.g. the tanstack-router sidebar)\n    // import lucide-react directly, so the website must declare it.\n    {\n      name: 'lucide-react',\n      when: (m) => m.ux === 'shadcn' && m.tanstackRouter,\n    },\n    { name: 'tailwindcss', when: (m) => m.tailwind },\n    {\n      name: '@tailwindcss/vite',\n      when: (m) => m.tailwind,\n      dev: true,\n      root: true,\n    },\n    { name: '@tanstack/react-router', when: (m) => m.tanstackRouter },\n    {\n      name: '@tanstack/router-plugin',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-generator',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/virtual-file-routes',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-utils',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    // Declared for its pinned version, which goes into npm's `overrides` below.\n    { name: 'express', versionOnly: true },\n    ...ownedElsewhere(TS_PROJECT_DEPENDENCIES),\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n    ...ownedElsewhere(VITEST_DEPENDENCIES),\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n  py: ownedElsewhere(WEBSITE_CONSTRUCTS_PY_DEPENDENCIES),\n});\n\nexport const SUPPORTED_UX_PROVIDERS = ['none', 'cloudscape', 'shadcn'] as const;\n\nexport type UxOption = (typeof SUPPORTED_UX_PROVIDERS)[number];\n\nexport type Ux = UxOption;\n\nexport const REACT_WEBSITE_APP_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsReactWebsiteGenerator(\n  tree: Tree,\n  schema: TsReactWebsiteGeneratorSchema,\n) {\n  const tailwind = schema.tailwind ?? true;\n  const tanstackRouter = schema.tanstackRouter ?? true;\n  const ux: Ux = schema.ux ?? 'shadcn';\n  if (ux === 'shadcn' && !tailwind) {\n    throw new Error('Shadcn requires TailwindCSS to be enabled.');\n  }\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const scopeAlias = npmScopePrefix;\n  const websiteNameClassName = toClassName(schema.name);\n  const websiteNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${websiteNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const websiteContentPath = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || websiteNameKebabCase,\n  );\n\n  const projectAlreadyExists = tree.exists(\n    joinPathFragments(websiteContentPath, 'project.json'),\n  );\n\n  // TODO: consider exposing and supporting e2e tests\n  const e2eTestRunner = 'none';\n\n  if (!projectAlreadyExists) {\n    await applicationGenerator(tree, {\n      ...schema,\n      name: fullyQualifiedName,\n      directory: websiteContentPath,\n      routing: false,\n      e2eTestRunner,\n      linter: 'none',\n      bundler: 'vite',\n      unitTestRunner: 'vitest',\n      useProjectJson: true,\n      style: 'css',\n      // Register the @nx/vite and @nx/vitest plugins so build/serve/test\n      // targets are inferred rather than emitting deprecated executor targets.\n      addPlugin: true,\n    });\n\n    // Pin the inferred target names. The vite production build is exposed as\n    // `bundle` (which produces the deployable artifact), leaving `build` as an\n    // aggregator over lint/compile/test/bundle. vite's own typecheck is dropped\n    // in favour of the tsc `compile`.\n    updateJson(tree, 'nx.json', (nxJson) => {\n      for (const plugin of nxJson.plugins ?? []) {\n        if (typeof plugin === 'string') continue;\n        if (plugin.plugin === '@nx/vite/plugin') {\n          plugin.options = {\n            ...plugin.options,\n            buildTargetName: 'bundle',\n            // Map both of vite's inferred dev-server targets onto `serve` so the\n            // plugin doesn't emit a separate `dev`; we author our own `dev`\n            // below running the local-dev vite mode.\n            serveTargetName: 'serve',\n            devTargetName: 'serve',\n            previewTargetName: 'preview',\n            serveStaticTargetName: 'serve-static',\n            typecheckTargetName: 'vite:typecheck',\n          };\n        } else if (plugin.plugin === '@nx/vitest') {\n          plugin.options = {\n            ...plugin.options,\n            testTargetName: 'test',\n          };\n        }\n      }\n      return nxJson;\n    });\n\n    // Replace with simpler sample source code\n    tree.delete(joinPathFragments(websiteContentPath, 'src'));\n  }\n\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n\n  const targets = projectConfiguration.targets;\n\n  // Each website gets its own explicit dev-server port. Vite itself already\n  // auto-increments past a port already in use, so two websites don't actually\n  // collide — but which port each one lands on then depends on start order and\n  // can't be known ahead of time. An explicit, per-project port is what lets\n  // the Cognito callback URL allow-list (added when auth is configured) be\n  // computed deterministically instead.\n  const port = assignPort(tree, projectConfiguration, 4200);\n  // @nx/react's vite config defaults to 4200 for the dev server and 4300 for\n  // preview; keep that +100 relationship so the pair stays predictable.\n  const previewPort = port + 100;\n\n  const infra = schema.infra ?? 'cloudfront-s3';\n\n  // Configure load-runtime-config target based on IaC provider (only when infra is not none)\n  const iac = infra !== 'none' ? await resolveIac(tree, schema.iac) : undefined;\n\n  if (iac === 'cdk') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description: `Load runtime config from your deployed stack for dev purposes. You must set your AWS CLI credentials whilst calling '${getPackageManagerDisplayCommands().exec} nx load-runtime-config ${fullyQualifiedName}'`,\n      },\n      options: {\n        command: `aws s3 cp s3://\\`aws cloudformation describe-stacks --query \"Stacks[?starts_with(StackName, '${kebabCase(npmScopePrefix)}-')][].Outputs[] | [?contains(OutputKey, '${websiteNameClassName}WebsiteBucketName')].OutputValue\" --output text\\`/runtime-config.json \"{projectRoot}/public/runtime-config.json\"`,\n      },\n    };\n  } else if (iac === 'terraform') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description:\n          \"Load runtime config from most recently applied terraform env for dev purposes. Copies the runtime config from the Terraform dist directory to the website's public directory.\",\n      },\n      options: {\n        command:\n          'node -e \"const fs=require(\\'fs\\');fs.mkdirSync(process.env.DEST_DIR,{recursive:true});fs.copyFileSync(process.env.SRC_FILE,process.env.DEST_FILE);\"',\n        env: {\n          SRC_FILE: TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n          DEST_DIR: `{projectRoot}/public`,\n          DEST_FILE: `{projectRoot}/public/runtime-config.json`,\n        },\n      },\n    };\n  }\n\n  if (!projectAlreadyExists) {\n    targets['compile'] = {\n      // `tsc` needs its dependencies' declarations, which `compile` emits — not\n      // their lint or test results.\n      dependsOn: ['^compile'],\n      executor: 'nx:run-commands',\n      outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],\n      options: {\n        command: 'tsc --build tsconfig.app.json',\n        cwd: '{projectRoot}',\n      },\n    };\n    // bundle is the @nx/vite/plugin inferred `vite build` (writing to the\n    // bundle dir configured in vite.config) — it produces the deployable\n    // artifact. build aggregates lint/compile/test/bundle.\n    targets['build'] = {\n      dependsOn: ['lint', 'compile', 'test', 'bundle'],\n    };\n    targets['assemble'] = {\n      dependsOn: ['compile', 'bundle'],\n    };\n\n    // Run the website and its connected dependencies locally. Mirrors the\n    // inferred `serve` target but with the local-dev vite mode.\n    targets['dev'] = {\n      executor: 'nx:run-commands',\n      continuous: true,\n      options: {\n        command: 'vite --mode local-dev',\n        cwd: '{projectRoot}',\n      },\n    };\n  }\n\n  projectConfiguration.targets = sortObjectKeys(targets);\n\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsReactWebsiteMetadata = {\n    ux,\n    framework: 'react',\n    infra,\n    tailwind,\n    tanstackRouter,\n    // Undefined when no infrastructure was generated, so neither provider's\n    // packages were added.\n    ...(iac ? { iac } : {}),\n  };\n  addGeneratorMetadata(\n    tree,\n    projectConfiguration.name,\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n    metadata,\n  );\n\n  await configureTsProject(\n    tree,\n    {\n      dir: websiteContentPath,\n      fullyQualifiedName,\n    },\n    DEPENDENCIES,\n  );\n\n  if (ux === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, websiteContentPath);\n  }\n\n  if (iac) {\n    await sharedConstructsGenerator(\n      tree,\n      {\n        iac,\n      },\n      DEPENDENCIES,\n    );\n\n    await addWebsiteInfra(tree, {\n      iac,\n      websiteProjectName: fullyQualifiedName,\n      scopeAlias,\n      websiteContentPath: joinPathFragments('dist', websiteContentPath),\n      websiteNameKebabCase,\n      websiteNameClassName,\n    });\n  }\n\n  const projectConfig = readProjectConfiguration(tree, fullyQualifiedName);\n  const libraryRoot = projectConfig.root;\n  const sharedShadcnStylesImport = relative(\n    joinPathFragments(libraryRoot, 'src'),\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'src',\n      'styles',\n      'globals.css',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const sharedShadcnTsconfigRef = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    joinPathFragments(\n      tree.root,\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'tsconfig.json',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const templateOptions = {\n    ...schema,\n    fullyQualifiedName,\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    tailwind,\n    tanstackRouter,\n    scopeAlias,\n    sharedShadcnStylesImport,\n  };\n  tree.delete(joinPathFragments(libraryRoot, 'src', 'app'));\n  const appCommonTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    './files/app/common',\n  );\n  const appTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    `./files/app/${ux.toLowerCase()}`,\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appCommonTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (tanstackRouter) {\n    const routerCommonTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      './files/tanstack-router/common',\n    );\n    const routerTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      `./files/tanstack-router/${ux.toLowerCase()}`,\n    );\n\n    generateFiles(\n      tree,\n      routerCommonTemplatePath,\n      libraryRoot,\n      templateOptions,\n      {\n        // User-editable source (and the TanStack-managed route tree) - preserve on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n\n    generateFiles(\n      tree,\n      routerTemplatePath,\n      libraryRoot,\n      templateOptions, // config object to replace variable in file templates\n      {\n        // User-editable source - preserve any edits on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    tree.delete(joinPathFragments(websiteContentPath, 'src', 'app.tsx'));\n  }\n\n  if (e2eTestRunner !== 'none') {\n    const e2eFullyQualifiedName = `${fullyQualifiedName}-e2e`;\n    const e2eRoot = readProjectConfiguration(tree, e2eFullyQualifiedName).root;\n    generateFiles(\n      tree, // the virtual file system\n      joinPathFragments(import.meta.dirname, `./files/e2e/${e2eTestRunner}`), // path to the file templates\n      e2eRoot, // destination path of the files\n      { ...schema, ...names(fullyQualifiedName) },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    await configureTsProject(\n      tree,\n      {\n        fullyQualifiedName: e2eFullyQualifiedName,\n        dir: e2eRoot,\n      },\n      DEPENDENCIES,\n    );\n  }\n  const viteConfigPath = joinPathFragments(libraryRoot, 'vite.config.mts');\n\n  if (tree.exists(viteConfigPath)) {\n    // Add Tanstack Router import if enabled\n    if (tanstackRouter) {\n      await addDestructuredImport(\n        tree,\n        viteConfigPath,\n        ['tanstackRouter'],\n        '@tanstack/router-plugin/vite',\n      );\n\n      await addDestructuredImport(tree, viteConfigPath, ['resolve'], 'path');\n    }\n\n    // Add TailwindCSS import if enabled\n    if (tailwind) {\n      await addSingleImport(\n        tree,\n        viteConfigPath,\n        'tailwindcss',\n        '@tailwindcss/vite',\n      );\n    }\n\n    // Update build.outDir. The inferred `vite build` target writes here, so\n    // point it at the bundle dir the website infrastructure consumes.\n    const outDir = joinPathFragments(\n      getRelativePathToRoot(tree, fullyQualifiedName),\n      'dist',\n      websiteContentPath,\n      'bundle',\n    );\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`build: { $bprops }\\` where { $bprops <: contains \\`outDir: $_\\` => \\`outDir: '${outDir}'\\` }`,\n    );\n\n    // Replace @nx/react's default dev-server port (4200) with the one assigned above.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`server: { $sprops }\\` where { $sprops <: contains \\`port: $_\\` => \\`port: ${port}\\` }`,\n    );\n\n    // Likewise for the preview port (@nx/react's default is 4300), so `vite preview`\n    // doesn't collide across websites either.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`preview: { $pprops }\\` where { $pprops <: contains \\`port: $_\\` => \\`port: ${previewPort}\\` }`,\n    );\n\n    // Add plugins to the plugins array\n    if (tanstackRouter) {\n      // Prepend tanstackRouter (must be first plugin) — rewrite works for both single/multi-element\n      await applyGritQL(\n        tree,\n        viteConfigPath,\n        \"`plugins: [$items]` => `plugins: [tanstackRouter({ routesDirectory: resolve(import.meta.dirname, 'src/routes'), generatedRouteTree: resolve(import.meta.dirname, 'src/routeTree.gen.ts') }), $items]` where { $items <: within `defineConfig($_)`, $items <: not contains `tanstackRouter` }\",\n      );\n    }\n\n    if (tailwind) {\n      await appendToArrayViaGritQL(\n        tree,\n        viteConfigPath,\n        'plugins:',\n        'tailwindcss()',\n        { scope: 'defineConfig($_)' },\n      );\n    }\n\n    // Use Vite's native tsconfig paths resolution (replaces vite-tsconfig-paths).\n    // `dedupe` forces a single copy of react/react-dom into the bundle: each\n    // project declares its own react dependency, so without this a workspace\n    // library's hoisted copy can produce a second React instance and the\n    // \"Invalid hook call\" runtime crash.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      \"or { `defineConfig(() => ({ $props }))` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` }, `defineConfig({ $props })` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` } }\",\n    );\n\n    // Add define: { global: {} } to the config (handles both callback and direct forms)\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      'or { `defineConfig(() => ({ $props }))` where { $props <: not contains `define`, $props += `define: { global: {} }` }, `defineConfig({ $props })` where { $props <: not contains `define`, $props += `define: { global: {} }` } }',\n    );\n  }\n\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        moduleResolution: 'Bundler',\n        module: 'Preserve',\n      },\n    }),\n  );\n  const outDirToRootRelativePath = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    tree.root,\n  );\n  const distDir = joinPathFragments(\n    outDirToRootRelativePath,\n    'dist',\n    websiteContentPath,\n    'tsc',\n  );\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.app.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        outDir: distDir,\n        tsBuildInfoFile: joinPathFragments(distDir, 'tsconfig.lib.tsbuildinfo'),\n        lib: ['DOM'],\n      },\n      references:\n        ux === 'shadcn'\n          ? [\n              ...(tsconfig.references ?? []).filter(\n                (ref) => ref.path !== sharedShadcnTsconfigRef,\n              ),\n              {\n                path: sharedShadcnTsconfigRef,\n              },\n            ]\n          : tsconfig.references,\n    }),\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: libraryRoot });\n\n  // @nx/react declares an optional `express` peer on the major behind the one\n  // vended here, for a module-federation dev-server this never runs. npm alone\n  // fails the whole install on an optional peer it cannot satisfy, so it gets a\n  // scoped override; the other package managers only warn.\n  if (detectPackageManager() === 'npm') {\n    updateJson(tree, 'package.json', (packageJson) => {\n      packageJson.overrides = {\n        ...packageJson.overrides,\n        '@nx/react': {\n          ...packageJson.overrides?.['@nx/react'],\n          ...withVersions(DEPENDENCIES, ['express']),\n        },\n      };\n      return packageJson;\n    });\n  }\n\n  // @nx/react's applicationGenerator seeds react/react-dom into the root\n  // manifest. The website now declares its own pinned versions, so drop the\n  // root copies: without catalogs (npm) the root's floating range resolves to\n  // a different version than the website's pin, installing a second React and\n  // producing the \"Invalid hook call\" runtime crash.\n  removeDependenciesFromPackageJson(tree, ['react', 'react-dom'], []);\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n  ]);\n\n  // TanStack Router's vite plugin owns this website's route tree and rewrites it\n  // in its own (unformatted) shape whenever the config is loaded — including when\n  // Nx computes the project graph — so formatting it here would only make\n  // generation non-idempotent. The vended biome config excludes `**/*.gen.*`, so\n  // the workspace's own `format` target leaves it alone too.\n  await formatFilesInSubtree(tree, undefined, {\n    ignore: tanstackRouter\n      ? [joinPathFragments(libraryRoot, 'src', 'routeTree.gen.ts')]\n      : [],\n  });\n  // The generated vite.config.mts imports these, and Nx's inferred `@nx/vite`\n  // plugin loads that config when computing the project graph — so they must be\n  // installed even if the caller would otherwise prefer to defer.\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n      ensureResolvable: [\n        ...(tailwind ? (['@tailwindcss/vite'] as const) : []),\n        ...(tanstackRouter ? (['@tanstack/router-plugin'] as const) : []),\n      ],\n    });\n}\nexport default tsReactWebsiteGenerator;\n"],"names":["detectPackageManager","generateFiles","joinPathFragments","names","OverwriteStrategy","readProjectConfiguration","removeDependenciesFromPackageJson","updateJson","updateProjectConfiguration","applicationGenerator","relative","sep","addTsDependencies","addDestructuredImport","addSingleImport","appendToArrayViaGritQL","applyGritQL","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","sortObjectKeys","getRelativePathToRoot","getPackageManagerDisplayCommands","assignPort","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","PACKAGES_DIR","SHARED_SHADCN_DIR","TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","withVersions","addWebsiteInfra","WEBSITE_CONSTRUCTS_PY_DEPENDENCIES","configureTsProject","TS_PROJECT_DEPENDENCIES","VITEST_DEPENDENCIES","DEPENDENCIES","ts","name","dev","root","when","m","ux","tanstackRouter","tailwind","versionOnly","py","SUPPORTED_UX_PROVIDERS","REACT_WEBSITE_APP_GENERATOR_INFO","filename","tsReactWebsiteGenerator","tree","schema","Error","npmScopePrefix","scopeAlias","websiteNameClassName","websiteNameKebabCase","fullyQualifiedName","websiteContentPath","directory","subDirectory","projectAlreadyExists","exists","e2eTestRunner","routing","linter","bundler","unitTestRunner","useProjectJson","style","addPlugin","nxJson","plugin","plugins","options","buildTargetName","serveTargetName","devTargetName","previewTargetName","serveStaticTargetName","typecheckTargetName","testTargetName","delete","projectConfiguration","targets","port","previewPort","infra","iac","undefined","executor","metadata","description","exec","command","env","SRC_FILE","DEST_DIR","DEST_FILE","dependsOn","outputs","cwd","continuous","framework","dir","websiteProjectName","projectConfig","libraryRoot","sharedShadcnStylesImport","split","join","sharedShadcnTsconfigRef","templateOptions","pkgMgrCmd","appCommonTemplatePath","dirname","appTemplatePath","toLowerCase","overwriteStrategy","KeepExisting","routerCommonTemplatePath","routerTemplatePath","e2eFullyQualifiedName","e2eRoot","viteConfigPath","outDir","scope","tsconfig","compilerOptions","moduleResolution","module","outDirToRootRelativePath","distDir","tsBuildInfoFile","lib","references","filter","ref","path","projectRoot","packageJson","overrides","ignore","preferInstallDependencies","languages","ensureResolvable"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/app/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  detectPackageManager,\n  generateFiles,\n  joinPathFragments,\n  names,\n  OverwriteStrategy,\n  readProjectConfiguration,\n  removeDependenciesFromPackageJson,\n  type Tree,\n  updateJson,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applicationGenerator } from '@nx/react';\nimport { relative, sep } from 'path';\nimport { addTsDependencies } from '../../../utils/add-dependencies.js';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n} from '../../../utils/ast.js';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies.js';\nimport { formatFilesInSubtree } from '../../../utils/format.js';\nimport { resolveIac } from '../../../utils/iac.js';\nimport { installDependencies } from '../../../utils/install.js';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics.js';\nimport { kebabCase, toClassName, toKebabCase } from '../../../utils/names.js';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope.js';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n} from '../../../utils/nx.js';\nimport { sortObjectKeys } from '../../../utils/object.js';\nimport { getRelativePathToRoot } from '../../../utils/paths.js';\nimport { getPackageManagerDisplayCommands } from '../../../utils/pkg-manager.js';\nimport { assignPort } from '../../../utils/port.js';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../../../utils/shared-constructs.js';\nimport {\n  type IacMetadata,\n  PACKAGES_DIR,\n  SHARED_SHADCN_DIR,\n  TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n} from '../../../utils/shared-constructs-constants.js';\nimport {\n  addSharedShadcnDependency,\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn.js';\nimport { withVersions } from '../../../utils/versions.js';\nimport {\n  addWebsiteInfra,\n  WEBSITE_CONSTRUCTS_PY_DEPENDENCIES,\n} from '../../../utils/website-constructs/website-constructs.js';\nimport {\n  configureTsProject,\n  mergeTsProjectDirReference,\n  TS_PROJECT_DEPENDENCIES,\n} from '../../lib/ts-project-utils.js';\nimport { VITEST_DEPENDENCIES } from '../../lib/vitest.js';\n// typescript factory imports removed — now using GritQL for vite config transforms\nimport type {\n  TsReactWebsiteGeneratorSchema,\n  WebsiteInfraOption,\n} from './schema';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface TsReactWebsiteMetadata extends IacMetadata {\n  readonly ux: UxOption;\n  readonly framework: string;\n  readonly infra: WebsiteInfraOption;\n  readonly tailwind: boolean;\n  readonly tanstackRouter: boolean;\n}\n\n// Each entry names the branch it belongs to, so the same declaration drives both\n// adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<TsReactWebsiteMetadata>()({\n  ts: [\n    { name: 'react' },\n    { name: 'react-dom' },\n    // Build/test tooling imported only from vite.config.mts stays at the root.\n    { name: '@nx/react', dev: true, root: true },\n    { name: '@vitest/ui', dev: true, root: true },\n    {\n      name: '@cloudscape-design/components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/board-components',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    {\n      name: '@cloudscape-design/global-styles',\n      when: (m) => m.ux === 'cloudscape',\n    },\n    // Shared shadcn components live in the common/shadcn package, but the\n    // website's own generated components (e.g. the tanstack-router sidebar)\n    // import lucide-react directly, so the website must declare it.\n    {\n      name: 'lucide-react',\n      when: (m) => m.ux === 'shadcn' && m.tanstackRouter,\n    },\n    { name: 'tailwindcss', when: (m) => m.tailwind },\n    {\n      name: '@tailwindcss/vite',\n      when: (m) => m.tailwind,\n      dev: true,\n      root: true,\n    },\n    { name: '@tanstack/react-router', when: (m) => m.tanstackRouter },\n    {\n      name: '@tanstack/router-plugin',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-generator',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/virtual-file-routes',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    {\n      name: '@tanstack/router-utils',\n      when: (m) => m.tanstackRouter,\n      dev: true,\n      root: true,\n    },\n    // Declared for its pinned version, which goes into npm's `overrides` below.\n    { name: 'express', versionOnly: true },\n    ...ownedElsewhere(TS_PROJECT_DEPENDENCIES),\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n    ...ownedElsewhere(VITEST_DEPENDENCIES),\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n  py: ownedElsewhere(WEBSITE_CONSTRUCTS_PY_DEPENDENCIES),\n});\n\nexport const SUPPORTED_UX_PROVIDERS = ['none', 'cloudscape', 'shadcn'] as const;\n\nexport type UxOption = (typeof SUPPORTED_UX_PROVIDERS)[number];\n\nexport type Ux = UxOption;\n\nexport const REACT_WEBSITE_APP_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport async function tsReactWebsiteGenerator(\n  tree: Tree,\n  schema: TsReactWebsiteGeneratorSchema,\n) {\n  const tailwind = schema.tailwind ?? true;\n  const tanstackRouter = schema.tanstackRouter ?? true;\n  const ux: Ux = schema.ux ?? 'shadcn';\n  if (ux === 'shadcn' && !tailwind) {\n    throw new Error('Shadcn requires TailwindCSS to be enabled.');\n  }\n  const npmScopePrefix = getNpmScopePrefix(tree);\n  const scopeAlias = npmScopePrefix;\n  const websiteNameClassName = toClassName(schema.name);\n  const websiteNameKebabCase = toKebabCase(schema.name);\n  const fullyQualifiedName = `${npmScopePrefix}${websiteNameKebabCase}`;\n  // NB: interactive nx generator cli can pass empty string\n  const websiteContentPath = joinPathFragments(\n    schema.directory || '.',\n    schema.subDirectory || websiteNameKebabCase,\n  );\n\n  const projectAlreadyExists = tree.exists(\n    joinPathFragments(websiteContentPath, 'project.json'),\n  );\n\n  // TODO: consider exposing and supporting e2e tests\n  const e2eTestRunner = 'none';\n\n  if (!projectAlreadyExists) {\n    await applicationGenerator(tree, {\n      ...schema,\n      name: fullyQualifiedName,\n      directory: websiteContentPath,\n      routing: false,\n      e2eTestRunner,\n      linter: 'none',\n      bundler: 'vite',\n      unitTestRunner: 'vitest',\n      useProjectJson: true,\n      style: 'css',\n      // Register the @nx/vite and @nx/vitest plugins so build/serve/test\n      // targets are inferred rather than emitting deprecated executor targets.\n      addPlugin: true,\n    });\n\n    // Pin the inferred target names. The vite production build is exposed as\n    // `bundle` (which produces the deployable artifact), leaving `build` as an\n    // aggregator over lint/compile/test/bundle. vite's own typecheck is dropped\n    // in favour of the tsc `compile`.\n    updateJson(tree, 'nx.json', (nxJson) => {\n      for (const plugin of nxJson.plugins ?? []) {\n        if (typeof plugin === 'string') continue;\n        if (plugin.plugin === '@nx/vite/plugin') {\n          plugin.options = {\n            ...plugin.options,\n            buildTargetName: 'bundle',\n            // Map both of vite's inferred dev-server targets onto `serve` so the\n            // plugin doesn't emit a separate `dev`; we author our own `dev`\n            // below running the local-dev vite mode.\n            serveTargetName: 'serve',\n            devTargetName: 'serve',\n            previewTargetName: 'preview',\n            serveStaticTargetName: 'serve-static',\n            typecheckTargetName: 'vite:typecheck',\n          };\n        } else if (plugin.plugin === '@nx/vitest') {\n          plugin.options = {\n            ...plugin.options,\n            testTargetName: 'test',\n          };\n        }\n      }\n      return nxJson;\n    });\n\n    // Replace with simpler sample source code\n    tree.delete(joinPathFragments(websiteContentPath, 'src'));\n  }\n\n  const projectConfiguration = readProjectConfiguration(\n    tree,\n    fullyQualifiedName,\n  );\n\n  const targets = projectConfiguration.targets;\n\n  // Each website gets its own explicit dev-server port. Vite itself already\n  // auto-increments past a port already in use, so two websites don't actually\n  // collide — but which port each one lands on then depends on start order and\n  // can't be known ahead of time. An explicit, per-project port is what lets\n  // the Cognito callback URL allow-list (added when auth is configured) be\n  // computed deterministically instead.\n  const port = assignPort(tree, projectConfiguration, 4200);\n  // @nx/react's vite config defaults to 4200 for the dev server and 4300 for\n  // preview; keep that +100 relationship so the pair stays predictable.\n  const previewPort = port + 100;\n\n  const infra = schema.infra ?? 'cloudfront-s3';\n\n  // Configure load-runtime-config target based on IaC provider (only when infra is not none)\n  const iac = infra !== 'none' ? await resolveIac(tree, schema.iac) : undefined;\n\n  if (iac === 'cdk') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description: `Load runtime config from your deployed stack for dev purposes. You must set your AWS CLI credentials whilst calling '${getPackageManagerDisplayCommands().exec} nx load-runtime-config ${fullyQualifiedName}'`,\n      },\n      options: {\n        command: `aws s3 cp s3://\\`aws cloudformation describe-stacks --query \"Stacks[?starts_with(StackName, '${kebabCase(npmScopePrefix)}-')][].Outputs[] | [?contains(OutputKey, '${websiteNameClassName}WebsiteBucketName')].OutputValue\" --output text\\`/runtime-config.json \"{projectRoot}/public/runtime-config.json\"`,\n      },\n    };\n  } else if (iac === 'terraform') {\n    targets['load-runtime-config'] = {\n      executor: 'nx:run-commands',\n      metadata: {\n        description:\n          \"Load runtime config from most recently applied terraform env for dev purposes. Copies the runtime config from the Terraform dist directory to the website's public directory.\",\n      },\n      options: {\n        command:\n          'node -e \"const fs=require(\\'fs\\');fs.mkdirSync(process.env.DEST_DIR,{recursive:true});fs.copyFileSync(process.env.SRC_FILE,process.env.DEST_FILE);\"',\n        env: {\n          SRC_FILE: TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE,\n          DEST_DIR: `{projectRoot}/public`,\n          DEST_FILE: `{projectRoot}/public/runtime-config.json`,\n        },\n      },\n    };\n  }\n\n  if (!projectAlreadyExists) {\n    targets['compile'] = {\n      // `tsc` needs its dependencies' declarations, which `compile` emits — not\n      // their lint or test results.\n      dependsOn: ['^compile'],\n      executor: 'nx:run-commands',\n      outputs: ['{workspaceRoot}/dist/{projectRoot}/tsc'],\n      options: {\n        command: 'tsc --build tsconfig.app.json',\n        cwd: '{projectRoot}',\n      },\n    };\n    // bundle is the @nx/vite/plugin inferred `vite build` (writing to the\n    // bundle dir configured in vite.config) — it produces the deployable\n    // artifact. build aggregates lint/compile/test/bundle.\n    targets['build'] = {\n      dependsOn: ['lint', 'compile', 'test', 'bundle'],\n    };\n    targets['assemble'] = {\n      dependsOn: ['compile', 'bundle'],\n    };\n\n    // Run the website and its connected dependencies locally. Mirrors the\n    // inferred `serve` target but with the local-dev vite mode.\n    targets['dev'] = {\n      executor: 'nx:run-commands',\n      continuous: true,\n      options: {\n        command: 'vite --mode local-dev',\n        cwd: '{projectRoot}',\n      },\n    };\n  }\n\n  projectConfiguration.targets = sortObjectKeys(targets);\n\n  updateProjectConfiguration(tree, fullyQualifiedName, projectConfiguration);\n\n  // Recorded here and read by the declaration's predicates, so the packages\n  // added below are exactly the ones the version sync will own.\n  const metadata: TsReactWebsiteMetadata = {\n    ux,\n    framework: 'react',\n    infra,\n    tailwind,\n    tanstackRouter,\n    // Undefined when no infrastructure was generated, so neither provider's\n    // packages were added.\n    ...(iac ? { iac } : {}),\n  };\n  addGeneratorMetadata(\n    tree,\n    projectConfiguration.name,\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n    metadata,\n  );\n\n  await configureTsProject(\n    tree,\n    {\n      dir: websiteContentPath,\n      fullyQualifiedName,\n    },\n    DEPENDENCIES,\n  );\n\n  if (ux === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n    addSharedShadcnDependency(tree, websiteContentPath);\n  }\n\n  if (iac) {\n    await sharedConstructsGenerator(\n      tree,\n      {\n        iac,\n      },\n      DEPENDENCIES,\n    );\n\n    await addWebsiteInfra(tree, {\n      iac,\n      websiteProjectName: fullyQualifiedName,\n      scopeAlias,\n      websiteContentPath: joinPathFragments('dist', websiteContentPath),\n      websiteNameKebabCase,\n      websiteNameClassName,\n    });\n  }\n\n  const projectConfig = readProjectConfiguration(tree, fullyQualifiedName);\n  const libraryRoot = projectConfig.root;\n  const sharedShadcnStylesImport = relative(\n    joinPathFragments(libraryRoot, 'src'),\n    joinPathFragments(\n      PACKAGES_DIR,\n      SHARED_SHADCN_DIR,\n      'src',\n      'styles',\n      'globals.css',\n    ),\n  )\n    .split(sep)\n    .join('/');\n  const sharedShadcnProjectRef = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    joinPathFragments(tree.root, PACKAGES_DIR, SHARED_SHADCN_DIR),\n  )\n    .split(sep)\n    .join('/');\n  const templateOptions = {\n    ...schema,\n    fullyQualifiedName,\n    pkgMgrCmd: getPackageManagerDisplayCommands().exec,\n    tailwind,\n    tanstackRouter,\n    scopeAlias,\n    sharedShadcnStylesImport,\n  };\n  tree.delete(joinPathFragments(libraryRoot, 'src', 'app'));\n  const appCommonTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    './files/app/common',\n  );\n  const appTemplatePath = joinPathFragments(\n    import.meta.dirname,\n    `./files/app/${ux.toLowerCase()}`,\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appCommonTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  generateFiles(\n    tree, // the virtual file system\n    appTemplatePath, // path to the file templates\n    libraryRoot, // destination path of the files\n    templateOptions, // config object to replace variable in file templates\n    {\n      // User-editable source - preserve any edits on re-run\n      overwriteStrategy: OverwriteStrategy.KeepExisting,\n    },\n  );\n\n  if (tanstackRouter) {\n    const routerCommonTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      './files/tanstack-router/common',\n    );\n    const routerTemplatePath = joinPathFragments(\n      import.meta.dirname,\n      `./files/tanstack-router/${ux.toLowerCase()}`,\n    );\n\n    generateFiles(\n      tree,\n      routerCommonTemplatePath,\n      libraryRoot,\n      templateOptions,\n      {\n        // User-editable source (and the TanStack-managed route tree) - preserve on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n\n    generateFiles(\n      tree,\n      routerTemplatePath,\n      libraryRoot,\n      templateOptions, // config object to replace variable in file templates\n      {\n        // User-editable source - preserve any edits on re-run\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    tree.delete(joinPathFragments(websiteContentPath, 'src', 'app.tsx'));\n  }\n\n  if (e2eTestRunner !== 'none') {\n    const e2eFullyQualifiedName = `${fullyQualifiedName}-e2e`;\n    const e2eRoot = readProjectConfiguration(tree, e2eFullyQualifiedName).root;\n    generateFiles(\n      tree, // the virtual file system\n      joinPathFragments(import.meta.dirname, `./files/e2e/${e2eTestRunner}`), // path to the file templates\n      e2eRoot, // destination path of the files\n      { ...schema, ...names(fullyQualifiedName) },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n    await configureTsProject(\n      tree,\n      {\n        fullyQualifiedName: e2eFullyQualifiedName,\n        dir: e2eRoot,\n      },\n      DEPENDENCIES,\n    );\n  }\n  const viteConfigPath = joinPathFragments(libraryRoot, 'vite.config.mts');\n\n  if (tree.exists(viteConfigPath)) {\n    // Add Tanstack Router import if enabled\n    if (tanstackRouter) {\n      await addDestructuredImport(\n        tree,\n        viteConfigPath,\n        ['tanstackRouter'],\n        '@tanstack/router-plugin/vite',\n      );\n\n      await addDestructuredImport(tree, viteConfigPath, ['resolve'], 'path');\n    }\n\n    // Add TailwindCSS import if enabled\n    if (tailwind) {\n      await addSingleImport(\n        tree,\n        viteConfigPath,\n        'tailwindcss',\n        '@tailwindcss/vite',\n      );\n    }\n\n    // Update build.outDir. The inferred `vite build` target writes here, so\n    // point it at the bundle dir the website infrastructure consumes.\n    const outDir = joinPathFragments(\n      getRelativePathToRoot(tree, fullyQualifiedName),\n      'dist',\n      websiteContentPath,\n      'bundle',\n    );\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`build: { $bprops }\\` where { $bprops <: contains \\`outDir: $_\\` => \\`outDir: '${outDir}'\\` }`,\n    );\n\n    // Replace @nx/react's default dev-server port (4200) with the one assigned above.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`server: { $sprops }\\` where { $sprops <: contains \\`port: $_\\` => \\`port: ${port}\\` }`,\n    );\n\n    // Likewise for the preview port (@nx/react's default is 4300), so `vite preview`\n    // doesn't collide across websites either.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      `\\`preview: { $pprops }\\` where { $pprops <: contains \\`port: $_\\` => \\`port: ${previewPort}\\` }`,\n    );\n\n    // Add plugins to the plugins array\n    if (tanstackRouter) {\n      // Prepend tanstackRouter (must be first plugin) — rewrite works for both single/multi-element\n      await applyGritQL(\n        tree,\n        viteConfigPath,\n        \"`plugins: [$items]` => `plugins: [tanstackRouter({ routesDirectory: resolve(import.meta.dirname, 'src/routes'), generatedRouteTree: resolve(import.meta.dirname, 'src/routeTree.gen.ts') }), $items]` where { $items <: within `defineConfig($_)`, $items <: not contains `tanstackRouter` }\",\n      );\n    }\n\n    if (tailwind) {\n      await appendToArrayViaGritQL(\n        tree,\n        viteConfigPath,\n        'plugins:',\n        'tailwindcss()',\n        { scope: 'defineConfig($_)' },\n      );\n    }\n\n    // Use Vite's native tsconfig paths resolution (replaces vite-tsconfig-paths).\n    // `dedupe` forces a single copy of react/react-dom into the bundle: each\n    // project declares its own react dependency, so without this a workspace\n    // library's hoisted copy can produce a second React instance and the\n    // \"Invalid hook call\" runtime crash.\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      \"or { `defineConfig(() => ({ $props }))` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` }, `defineConfig({ $props })` where { $props <: not some `resolve: $_`, $props += `resolve: { tsconfigPaths: true, dedupe: ['react', 'react-dom'] }` } }\",\n    );\n\n    // Add define: { global: {} } to the config (handles both callback and direct forms)\n    await applyGritQL(\n      tree,\n      viteConfigPath,\n      'or { `defineConfig(() => ({ $props }))` where { $props <: not contains `define`, $props += `define: { global: {} }` }, `defineConfig({ $props })` where { $props <: not contains `define`, $props += `define: { global: {} }` } }',\n    );\n  }\n\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        moduleResolution: 'Bundler',\n        module: 'Preserve',\n      },\n    }),\n  );\n  const outDirToRootRelativePath = relative(\n    joinPathFragments(tree.root, websiteContentPath),\n    tree.root,\n  );\n  const distDir = joinPathFragments(\n    outDirToRootRelativePath,\n    'dist',\n    websiteContentPath,\n    'tsc',\n  );\n  updateJson(\n    tree,\n    joinPathFragments(websiteContentPath, 'tsconfig.app.json'),\n    (tsconfig) => ({\n      ...tsconfig,\n      compilerOptions: {\n        ...tsconfig.compilerOptions,\n        outDir: distDir,\n        tsBuildInfoFile: joinPathFragments(distDir, 'tsconfig.lib.tsbuildinfo'),\n        lib: ['DOM'],\n      },\n      references:\n        ux === 'shadcn'\n          ? mergeTsProjectDirReference(\n              tsconfig.references,\n              sharedShadcnProjectRef,\n            )\n          : tsconfig.references,\n    }),\n  );\n\n  addTsDependencies(tree, DEPENDENCIES, { metadata, projectRoot: libraryRoot });\n\n  // @nx/react declares an optional `express` peer on the major behind the one\n  // vended here, for a module-federation dev-server this never runs. npm alone\n  // fails the whole install on an optional peer it cannot satisfy, so it gets a\n  // scoped override; the other package managers only warn.\n  if (detectPackageManager() === 'npm') {\n    updateJson(tree, 'package.json', (packageJson) => {\n      packageJson.overrides = {\n        ...packageJson.overrides,\n        '@nx/react': {\n          ...packageJson.overrides?.['@nx/react'],\n          ...withVersions(DEPENDENCIES, ['express']),\n        },\n      };\n      return packageJson;\n    });\n  }\n\n  // @nx/react's applicationGenerator seeds react/react-dom into the root\n  // manifest. The website now declares its own pinned versions, so drop the\n  // root copies: without catalogs (npm) the root's floating range resolves to\n  // a different version than the website's pin, installing a second React and\n  // producing the \"Invalid hook call\" runtime crash.\n  removeDependenciesFromPackageJson(tree, ['react', 'react-dom'], []);\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    REACT_WEBSITE_APP_GENERATOR_INFO,\n  ]);\n\n  // TanStack Router's vite plugin owns this website's route tree and rewrites it\n  // in its own (unformatted) shape whenever the config is loaded — including when\n  // Nx computes the project graph — so formatting it here would only make\n  // generation non-idempotent. The vended biome config excludes `**/*.gen.*`, so\n  // the workspace's own `format` target leaves it alone too.\n  await formatFilesInSubtree(tree, undefined, {\n    ignore: tanstackRouter\n      ? [joinPathFragments(libraryRoot, 'src', 'routeTree.gen.ts')]\n      : [],\n  });\n\n  // The generated vite.config.mts imports these, and Nx's inferred `@nx/vite`\n  // plugin loads that config when computing the project graph — so they must be\n  // installed even if the caller would otherwise prefer to defer.\n  return () =>\n    installDependencies(tree, schema.preferInstallDependencies, {\n      languages: ['typescript'],\n      ensureResolvable: [\n        ...(tailwind ? (['@tailwindcss/vite'] as const) : []),\n        ...(tanstackRouter ? (['@tanstack/router-plugin'] as const) : []),\n      ],\n    });\n}\nexport default tsReactWebsiteGenerator;\n"],"names":["detectPackageManager","generateFiles","joinPathFragments","names","OverwriteStrategy","readProjectConfiguration","removeDependenciesFromPackageJson","updateJson","updateProjectConfiguration","applicationGenerator","relative","sep","addTsDependencies","addDestructuredImport","addSingleImport","appendToArrayViaGritQL","applyGritQL","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toKebabCase","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","sortObjectKeys","getRelativePathToRoot","getPackageManagerDisplayCommands","assignPort","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","PACKAGES_DIR","SHARED_SHADCN_DIR","TERRAFORM_WEBSITE_RUNTIME_CONFIG_FILE","addSharedShadcnDependency","SHADCN_DEPENDENCIES","sharedShadcnGenerator","withVersions","addWebsiteInfra","WEBSITE_CONSTRUCTS_PY_DEPENDENCIES","configureTsProject","mergeTsProjectDirReference","TS_PROJECT_DEPENDENCIES","VITEST_DEPENDENCIES","DEPENDENCIES","ts","name","dev","root","when","m","ux","tanstackRouter","tailwind","versionOnly","py","SUPPORTED_UX_PROVIDERS","REACT_WEBSITE_APP_GENERATOR_INFO","filename","tsReactWebsiteGenerator","tree","schema","Error","npmScopePrefix","scopeAlias","websiteNameClassName","websiteNameKebabCase","fullyQualifiedName","websiteContentPath","directory","subDirectory","projectAlreadyExists","exists","e2eTestRunner","routing","linter","bundler","unitTestRunner","useProjectJson","style","addPlugin","nxJson","plugin","plugins","options","buildTargetName","serveTargetName","devTargetName","previewTargetName","serveStaticTargetName","typecheckTargetName","testTargetName","delete","projectConfiguration","targets","port","previewPort","infra","iac","undefined","executor","metadata","description","exec","command","env","SRC_FILE","DEST_DIR","DEST_FILE","dependsOn","outputs","cwd","continuous","framework","dir","websiteProjectName","projectConfig","libraryRoot","sharedShadcnStylesImport","split","join","sharedShadcnProjectRef","templateOptions","pkgMgrCmd","appCommonTemplatePath","dirname","appTemplatePath","toLowerCase","overwriteStrategy","KeepExisting","routerCommonTemplatePath","routerTemplatePath","e2eFullyQualifiedName","e2eRoot","viteConfigPath","outDir","scope","tsconfig","compilerOptions","moduleResolution","module","outDirToRootRelativePath","distDir","tsBuildInfoFile","lib","references","projectRoot","packageJson","overrides","ignore","preferInstallDependencies","languages","ensureResolvable"],"mappings":"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"}

package/src/utils/agent-connection/agent-connection.d.ts

@@ -181,7 +181,8 @@ export interface PyMcpFamilyConnection extends PyClientNaming {
 export declare const PY_MCP_FAMILY_CONNECTIONS: Record<AgentFramework, PyMcpFamilyConnection>;
 /**
  * Add a re-export to the Python agent-connection module's __init__.py.
- * Equivalent to addStarExport for TS.
+ * Equivalent to addStarExport for TS, including creating the file when it does
+ * not yet exist in the tree.
  * Uses `__all__` to mark re-exports as public (satisfies ruff F401).
  * Uses GritQL for AST-aware transforms where possible.
  */

package/src/utils/agent-connection/agent-connection.js

@@ -569,7 +569,8 @@ export const PY_MCP_FAMILY_CONNECTIONS = {
 };
 /**
  * Add a re-export to the Python agent-connection module's __init__.py.
- * Equivalent to addStarExport for TS.
+ * Equivalent to addStarExport for TS, including creating the file when it does
+ * not yet exist in the tree.
  * Uses `__all__` to mark re-exports as public (satisfies ruff F401).
  * Uses GritQL for AST-aware transforms where possible.
  */ export async function addPythonReExport(tree, initFilePath, fromModule, importName) {
@@ -579,6 +580,10 @@ export const PY_MCP_FAMILY_CONNECTIONS = {
     }
     const importLine = `from ${fromModule} import ${importName}`;
     const allEntry = `"${importName}"`;
+    if (!tree.exists(initFilePath)) {
+        tree.write(initFilePath, `${importLine}\n\n__all__ = [${allEntry}]\n`);
+        return;
+    }
     // If there's already an import from the same module, merge into its name list
     // (ruff I001 rejects two `from X import ...` lines for the same module).
     const mergedImport = await applyGritQL(tree, initFilePath, py(`\`from ${fromModule} import $names\` where {

package/src/utils/agent-connection/agent-connection.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/agent-connection/agent-connection.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n} from '@nx/devkit';\nimport pyProjectGenerator, {\n  getPyProjectDetails,\n} from '../../py/project/generator.js';\nimport tsProjectGenerator from '../../ts/lib/generator.js';\nimport {\n  addStarExport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n  matchGritQL,\n} from '../ast.js';\nimport {\n  type DependencyDeclaration,\n  forDependencies,\n  type MustDeclare,\n  type MustDeclarePy,\n} from '../declared-dependencies.js';\nimport { addDependenciesToPackageJson } from '../dependencies.js';\nimport { esmVars } from '../module-format.js';\nimport { addDependenciesToPyProjectToml } from '../py.js';\nimport {\n  type IPyDepVersion,\n  type ITsDepVersion,\n  withVersions,\n} from '../versions.js';\n\n/** TypeScript dependencies a caller must declare to emit agent-connection clients. */\nexport const AGENT_CONNECTION_DEPENDENCIES = [\n  { name: '@aws-lambda-powertools/parameters' },\n  { name: '@aws-sdk/credential-providers' },\n  { name: 'aws4fetch' },\n  { name: '@modelcontextprotocol/sdk' },\n  { name: '@a2a-js/sdk' },\n  { name: '@strands-agents/sdk' },\n  { name: '@aws-sdk/client-s3' },\n] as const satisfies readonly { name: ITsDepVersion }[];\n\n/** Python dependencies a caller must declare to emit agent-connection clients. */\nexport const AGENT_CONNECTION_PY_DEPENDENCIES = [\n  { name: 'aws-lambda-powertools' },\n  { name: 'strands-agents' },\n] as const satisfies readonly { name: IPyDepVersion }[];\n\ntype AgentConnectionPyDependency =\n  (typeof AGENT_CONNECTION_PY_DEPENDENCIES)[number]['name'];\n\n/** Prefix a GritQL pattern with `language python` */\nconst py = (pattern: string) => `language python\\n${pattern}`;\n\nconst AGENT_CONNECTION_DIR = 'agent-connection';\nconst PACKAGES_DIR = 'packages';\nconst COMMON_DIR = 'common';\n\nexport const AGENT_CONNECTION_PROJECT_DIR = joinPathFragments(\n  PACKAGES_DIR,\n  COMMON_DIR,\n  AGENT_CONNECTION_DIR,\n);\n\nconst PY_AGENT_CONNECTION_NAME = 'agent_connection';\n\n/**\n * Get the directory of the shared Python agent-connection project.\n */\nexport function getPythonAgentConnectionProjectDir(tree: Tree): string {\n  const { dir } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return dir;\n}\n\n/**\n * Get the Python module name of the shared agent-connection project.\n */\nexport function getPythonAgentConnectionModuleName(tree: Tree): string {\n  const { normalizedModuleName } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return normalizedModuleName;\n}\n\n/**\n * Get the shared agent-connection project as `{ name, root }`, suitable for\n * passing to {@link addWorkspaceDependencyToPyProject} (which derives the\n * dependency's PEP 503 distribution name from the project itself, so callers\n * never construct the name).\n */\nexport function getPythonAgentConnectionProject(tree: Tree): {\n  name: string;\n  root: string;\n} {\n  const { fullyQualifiedName, dir } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return { name: fullyQualifiedName, root: dir };\n}\n\n/**\n * The connection protocols an agent framework can connect over. Each maps to a\n * framework-agnostic Layer-0/1 template directory plus a per-framework Layer-2\n * client directory (see `FRAMEWORKS`).\n */\nexport type ConnectionProtocol = 'mcp' | 'gateway' | 'a2a';\n\n/**\n * The agent frameworks we can generate connection clients for. Adding a new\n * framework is an additive change: append an entry to `FRAMEWORKS` with its\n * Layer-2 template directories and dependencies — the framework-agnostic\n * Layer-0/1 (`core-auth`, `core-shared`, the per-protocol transports/configs)\n * is reused unchanged.\n */\nexport type AgentFramework = 'strands' | 'langchain';\n\n/**\n * Resolve an agent component's framework, defaulting to `strands`. Connection\n * generators dispatch on the returned framework to pick the matching templates\n * and agent.py/agent.ts transforms.\n */\nexport function resolveAgentFramework(\n  framework: string | undefined,\n): AgentFramework {\n  return framework === 'langchain' ? 'langchain' : 'strands';\n}\n\n/**\n * Framework-agnostic Layer-1 templates, keyed by protocol. These resolve the\n * endpoint and build the signed transport/client-config; they contain no\n * framework dependency.\n */\nconst TS_PROTOCOL_TEMPLATES: Record<ConnectionProtocol, string> = {\n  mcp: 'core-mcp',\n  gateway: 'core-gateway',\n  a2a: 'core-a2a',\n};\nconst PY_PROTOCOL_TEMPLATES: Record<ConnectionProtocol, string> = {\n  mcp: 'py-core-mcp',\n  gateway: 'py-core-gateway',\n  a2a: 'py-core-a2a',\n};\n\n/**\n * A re-export the framework base emits into the agent-connection module's\n * `__init__.py` (the agent server entry point imports these by name).\n */\ninterface BaseReExport {\n  fromModule: string;\n  importName: string;\n}\n\n/**\n * A framework's Layer-2 templates for one language. `base` (optional) holds the\n * helpers every connection of that framework needs (error logging, per-session\n * agent cache); `baseReExports` lists what those helpers expose at the module\n * root. `protocols` maps each *supported* protocol to the thin client that wraps\n * the matching Layer-1 transport/config in the framework's client type.\n *\n * A framework whose Layer-2 needs no base helpers (e.g. LangChain, whose AG-UI\n * foundation reuses only the framework-agnostic session context) omits `base`\n * and leaves `baseReExports` empty.\n *\n * A protocol absent from `protocols` is not supported by that framework in that\n * language — callers must check before emitting. `deps` are the extra package\n * dependencies the base helpers require (per-connection client deps are added\n * by the connection generators, not here).\n */\ninterface FrameworkLanguageTemplates<Dep extends string> {\n  base?: string;\n  baseReExports: BaseReExport[];\n  protocols: Partial<Record<ConnectionProtocol, string>>;\n  deps: Dep[];\n}\n\n/**\n * Per-framework Layer-2 templates. Support is asymmetric by design: a framework\n * may target only one language (`ts`/`py` is optional) and only a subset of\n * protocols. Adding a framework — or extending an existing one to a new\n * language/protocol — is an additive change to this registry.\n */\ninterface FrameworkTemplates {\n  ts?: FrameworkLanguageTemplates<string>;\n  py?: FrameworkLanguageTemplates<AgentConnectionPyDependency>;\n}\n\nconst FRAMEWORKS: Record<AgentFramework, FrameworkTemplates> = {\n  strands: {\n    ts: {\n      base: 'core-strands/base',\n      baseReExports: [\n        {\n          fromModule: './core/with-session-id-strands.js',\n          importName: '*',\n        },\n        {\n          fromModule: './core/model-errors-strands.js',\n          importName: '*',\n        },\n        {\n          fromModule: './core/tool-errors-strands.js',\n          importName: '*',\n        },\n      ],\n      protocols: {\n        mcp: 'core-strands/mcp',\n        gateway: 'core-strands/gateway',\n        a2a: 'core-strands/a2a',\n      },\n      deps: [],\n    },\n    py: {\n      base: 'py-core-strands/base',\n      baseReExports: [\n        {\n          fromModule: '.core.with_session_id_strands',\n          importName: 'with_session_id',\n        },\n        {\n          fromModule: '.core.model_errors_strands',\n          importName: 'log_model_errors',\n        },\n        {\n          fromModule: '.core.tool_errors_strands',\n          importName: 'log_tool_errors',\n        },\n      ],\n      protocols: {\n        mcp: 'py-core-strands/mcp',\n        gateway: 'py-core-strands/gateway',\n        a2a: 'py-core-strands/a2a',\n      },\n      deps: ['strands-agents'],\n    },\n  },\n  langchain: {\n    // LangChain is supported for Python agents only (the TypeScript LangChain\n    // agent foundation has no in-process AG-UI <-> LangGraph adapter, so it is\n    // not scaffolded — see ts#agent). Its Layer-2 clients stay usable after\n    // agent construction, so there is no base helper layer (no model-error\n    // logger / per-session agent cache) and no strands-agents dependency — its\n    // AG-UI foundation reuses only the framework-agnostic session context, and\n    // its A2A client drives the a2a SDK directly rather than wrapping Strands'\n    // A2AAgent. The per-connection adapter dependency (langchain-mcp-adapters /\n    // a2a-sdk) is added by the connection generators.\n    py: {\n      baseReExports: [],\n      protocols: {\n        mcp: 'py-core-langchain/mcp',\n        gateway: 'py-core-langchain/gateway',\n        a2a: 'py-core-langchain/a2a',\n      },\n      deps: [],\n    },\n  },\n};\n\n/** Resolve a framework's templates for a language + protocol, or throw. */\nfunction frameworkLanguage<L extends 'ts' | 'py'>(\n  framework: AgentFramework,\n  language: L,\n  protocol: ConnectionProtocol,\n): NonNullable<FrameworkTemplates[L]> & { protocol: string } {\n  const lang = FRAMEWORKS[framework][language];\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support ${language === 'ts' ? 'TypeScript' : 'Python'} agents.`,\n    );\n  }\n  const protocolDir = lang.protocols[protocol];\n  if (!protocolDir) {\n    throw new Error(\n      `The '${framework}' framework does not support ${protocol} connections for ${language === 'ts' ? 'TypeScript' : 'Python'} agents.`,\n    );\n  }\n  return { ...lang, protocol: protocolDir } as NonNullable<\n    FrameworkTemplates[L]\n  > & { protocol: string };\n}\n\n/** Protocols whose Layer-1 needs the shared MCP transport (`core-shared`). */\nconst MCP_TRANSPORT_PROTOCOLS: ConnectionProtocol[] = ['mcp', 'gateway'];\n\nconst tsCoreDir = () =>\n  joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'core');\n\n/**\n * Runtime dependencies each TypeScript core template directory imports. Emitting\n * a template also declares its dependencies in the agent-connection project's\n * package.json so the `noUndeclaredDependencies` lint rule passes.\n */\nconst TS_TEMPLATE_DEPS: Record<\n  string,\n  (typeof AGENT_CONNECTION_DEPENDENCIES)[number]['name'][]\n> = {\n  'core-runtime-config': ['@aws-lambda-powertools/parameters'],\n  'core-auth': ['@aws-sdk/credential-providers', 'aws4fetch'],\n  'core-shared': ['@aws-sdk/credential-providers', '@modelcontextprotocol/sdk'],\n  'core-mcp': ['@aws-sdk/credential-providers', '@modelcontextprotocol/sdk'],\n  'core-gateway': [\n    '@aws-sdk/credential-providers',\n    '@modelcontextprotocol/sdk',\n  ],\n  'core-a2a': ['@aws-sdk/credential-providers', '@a2a-js/sdk'],\n  'core-strands/base': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/mcp': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/gateway': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/a2a': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n};\n\nconst emitTs = (\n  tree: Tree,\n  templateDir: string,\n  declaration: DependencyDeclaration,\n) => {\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', templateDir),\n    tsCoreDir(),\n    { ...esmVars(tree) },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n  const deps = TS_TEMPLATE_DEPS[templateDir];\n  if (deps?.length) {\n    addDependenciesToPackageJson(\n      tree,\n      withVersions(\n        forDependencies<typeof AGENT_CONNECTION_DEPENDENCIES>(declaration),\n        deps,\n      ),\n      {},\n      joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'package.json'),\n    );\n  }\n};\n\n/**\n * Ensure the shared TypeScript agent-connection project exists and has the\n * framework-agnostic core helpers (runtime-config loader, session context).\n * Per-connection generators emit their own protocol + framework client\n * templates via `addTypeScriptCoreClient`.\n */\nexport async function ensureTypeScriptAgentConnectionProject<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n): Promise<void> {\n  const projectJsonPath = joinPathFragments(\n    AGENT_CONNECTION_PROJECT_DIR,\n    'project.json',\n  );\n  if (!tree.exists(projectJsonPath)) {\n    await tsProjectGenerator(tree, {\n      name: AGENT_CONNECTION_DIR,\n      directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n    });\n  }\n\n  // Framework-agnostic runtime-config + session-context helpers.\n  emitTs(tree, 'core-runtime-config', declaration);\n\n  // Re-export session-context helpers so agent server entry points can set the\n  // current session on each inbound request without pulling in internals.\n  await addStarExport(\n    tree,\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'),\n    './core/session-context.js',\n  );\n\n  // Re-export the runtime-config loader so agent server entry points can read\n  // their own connected resources (e.g. session storage) without pulling in\n  // internals.\n  await addStarExport(\n    tree,\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'),\n    './core/runtime-config.js',\n  );\n}\n\n/**\n * Emit a framework's base Layer-2 helpers (model-error logging + per-session\n * agent cache) into the agent-connection project and re-export them. The agent\n * server entry point imports these regardless of whether any connection client\n * is wired in, so the agent generator calls this directly; connection\n * generators call it transitively via `addTypeScriptCoreClient`.\n */\nexport async function addTypeScriptFrameworkBase<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const lang = FRAMEWORKS[framework].ts;\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support TypeScript agents.`,\n    );\n  }\n  if (lang.base) {\n    emitTs(tree, lang.base, declaration);\n  }\n\n  const indexPath = joinPathFragments(\n    AGENT_CONNECTION_PROJECT_DIR,\n    'src',\n    'index.ts',\n  );\n  for (const reExport of lang.baseReExports) {\n    await addStarExport(tree, indexPath, reExport.fromModule);\n  }\n}\n\n/**\n * Emit the TypeScript client templates for a connection protocol and agent\n * framework into the agent-connection project's `src/core/` directory. Safe to\n * call multiple times — `KeepExisting` preserves customised files.\n *\n * Layers emitted:\n *  - Layer 0 `core-auth` (signed fetch + endpoint resolution) — always\n *  - Layer 1 `core-shared` MCP transport — for mcp/gateway protocols\n *  - Layer 1 the protocol's transport/client-config — always\n *  - Layer 2 the framework's base helpers + protocol client — per framework\n */\nexport async function addTypeScriptCoreClient<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  protocol: ConnectionProtocol,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const fw = frameworkLanguage(framework, 'ts', protocol);\n\n  emitTs(tree, 'core-auth', declaration);\n  if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {\n    emitTs(tree, 'core-shared', declaration);\n  }\n  emitTs(tree, TS_PROTOCOL_TEMPLATES[protocol], declaration);\n\n  // Framework Layer 2: base helpers (re-exported for the agent server) + the\n  // thin protocol client.\n  await addTypeScriptFrameworkBase(\n    tree,\n    forDependencies<typeof AGENT_CONNECTION_DEPENDENCIES>(declaration),\n    framework,\n  );\n  emitTs(tree, fw.protocol, declaration);\n}\n\n/**\n * Ensure the shared Python agent-connection project exists.\n * Only creates the project shell — per-connection generators are responsible\n * for emitting their own core client templates.\n */\nexport async function ensurePythonAgentConnectionProject<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n): Promise<void> {\n  const projectDir = getPythonAgentConnectionProjectDir(tree);\n  const moduleName = getPythonAgentConnectionModuleName(tree);\n  const projectJsonPath = joinPathFragments(projectDir, 'project.json');\n\n  if (!tree.exists(projectJsonPath)) {\n    // Create the Python project using the standard py#project generator\n    await pyProjectGenerator(tree, {\n      name: PY_AGENT_CONNECTION_NAME,\n      directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n      type: 'library',\n    });\n  }\n\n  const moduleDir = joinPathFragments(projectDir, moduleName);\n\n  // Ensure core/__init__.py exists\n  const coreDir = joinPathFragments(moduleDir, 'core');\n  if (!tree.exists(joinPathFragments(coreDir, '__init__.py'))) {\n    tree.write(joinPathFragments(coreDir, '__init__.py'), '');\n  }\n\n  // Ensure app/__init__.py exists\n  const appInitPath = joinPathFragments(moduleDir, 'app', '__init__.py');\n  if (!tree.exists(appInitPath)) {\n    tree.write(appInitPath, '');\n  }\n\n  // Framework-agnostic runtime-config + session-context helpers.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'py-core-runtime-config'),\n    coreDir,\n    {},\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Re-export the session id context so agent server entry points can set the\n  // current session on each inbound request without importing internals.\n  const moduleInitPath = joinPathFragments(moduleDir, '__init__.py');\n  await addPythonReExport(\n    tree,\n    moduleInitPath,\n    '.core.session_context',\n    'get_current_session_id',\n  );\n  await addPythonReExport(\n    tree,\n    moduleInitPath,\n    '.core.session_context',\n    'session_id_context',\n  );\n\n  // The runtime-config loader reads AppConfig via aws-lambda-powertools.\n  addDependenciesToPyProjectToml(\n    tree,\n    projectDir,\n    forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n    ['aws-lambda-powertools'],\n  );\n}\n\nconst pyCoreDir = (tree: Tree) =>\n  joinPathFragments(\n    getPythonAgentConnectionProjectDir(tree),\n    getPythonAgentConnectionModuleName(tree),\n    'core',\n  );\n\nconst emitPy = (tree: Tree, templateDir: string) =>\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', templateDir),\n    pyCoreDir(tree),\n    {},\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n/**\n * Ensure the shared Python agent-connection project has\n * `s3_checkpoint_saver_langchain.py` — a vendored `S3CheckpointSaver`\n * (from `langgraph-checkpoint-s3`, MIT licensed) that LangChain agents with\n * `session: 's3'` import from directly (`.core.s3_checkpoint_saver_langchain`),\n * mirroring how they import `.core.runtime_config`. Vendored rather than\n * installed as a dependency, and shared rather than per-agent, since it has\n * no agent-specific templating.\n */\nexport function ensureLangchainS3CheckpointSaver(tree: Tree): void {\n  emitPy(tree, 'py-core-langchain/s3');\n}\n\n/**\n * Emit a framework's base Layer-2 helpers (model-error logging + per-session\n * agent cache) into the Python agent-connection project and re-export them.\n * The agent server entry point imports these regardless of whether a connection\n * client is wired in, so the agent generator calls this directly; connection\n * generators call it transitively via `addPythonCoreClient`.\n */\nexport async function addPythonFrameworkBase<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const lang = FRAMEWORKS[framework].py;\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support Python agents.`,\n    );\n  }\n  if (lang.base) {\n    emitPy(tree, lang.base);\n  }\n\n  const moduleInitPath = joinPathFragments(\n    getPythonAgentConnectionProjectDir(tree),\n    getPythonAgentConnectionModuleName(tree),\n    '__init__.py',\n  );\n  for (const reExport of lang.baseReExports) {\n    await addPythonReExport(\n      tree,\n      moduleInitPath,\n      reExport.fromModule,\n      reExport.importName,\n    );\n  }\n\n  if (lang.deps.length > 0) {\n    addDependenciesToPyProjectToml(\n      tree,\n      getPythonAgentConnectionProjectDir(tree),\n      forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n      lang.deps,\n    );\n  }\n}\n\n/**\n * Emit the Python client templates for a connection protocol and agent\n * framework into the agent-connection project's core directory.\n *\n * Layers emitted:\n *  - Layer 0 `py-core-auth` (SigV4 httpx.Auth, session auth, endpoints) — always\n *  - Layer 1 `py-core-shared` MCP transport — for mcp/gateway protocols\n *  - Layer 1 the protocol's transport/client-config — always\n *  - Layer 2 the framework's base helpers + protocol client — per framework\n */\nexport async function addPythonCoreClient<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  protocol: ConnectionProtocol,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const fw = frameworkLanguage(framework, 'py', protocol);\n\n  emitPy(tree, 'py-core-auth');\n  if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {\n    emitPy(tree, 'py-core-shared');\n  }\n  emitPy(tree, PY_PROTOCOL_TEMPLATES[protocol]);\n\n  // Framework Layer 2: base helpers + the thin protocol client.\n  await addPythonFrameworkBase(\n    tree,\n    forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n    framework,\n  );\n  emitPy(tree, fw.protocol);\n}\n\n/**\n * Patch a TypeScript agent.ts to create a connection client and register it\n * in the Agent's tools. Used by the MCP and gateway connection generators —\n * the client class must expose a static async `create()` returning a value\n * accepted by `Agent.tools` (e.g. an `McpClient`).\n */\nexport async function addTypeScriptClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  const clientCreationStmt = `const ${clientVarName} = await ${clientClassName}.create();`;\n\n  // Transform the arrow function that contains `new Agent`:\n  // - Expression body: wrap in block with client creation and return\n  // - Block body: prepend client creation statement\n  await applyGritQL(\n    tree,\n    agentFilePath,\n    `or { \\`async ($p) => new Agent($args)\\` => raw\\`async ($p) => {\n  ${clientCreationStmt}\n  return new Agent($args);\n}\\` where { $program <: not contains \\`${clientClassName}.create\\` }, \\`async ($p) => { $body }\\` => raw\\`async ($p) => {\n  ${clientCreationStmt}\n  $body\n}\\` where { $body <: contains \\`new Agent($_)\\`, $program <: not contains \\`${clientClassName}.create\\` } }`,\n  );\n\n  // Prepend the client to the tools array\n  await applyGritQL(\n    tree,\n    agentFilePath,\n    `\\`tools: [$items]\\` => \\`tools: [${clientVarName}, $items]\\` where { $items <: within \\`new Agent($_)\\`, $items <: not contains \\`${clientVarName}\\` }`,\n  );\n}\n\n/**\n * Patch a Python agent.py to create a context-managed connection client,\n * enter it in the `with` block around `yield Agent(...)`, and spread its\n * `list_tools_sync()` into the Agent's tools. Used by the MCP and gateway\n * connection generators — the client class must expose a static `create()`\n * returning a context manager with `list_tools_sync()` (e.g. an `MCPClient`).\n */\nasync function addPythonClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  await addPythonClientTools(tree, agentFilePath, clientVarName);\n  await addPythonClientToGetAgent(\n    tree,\n    agentFilePath,\n    clientClassName,\n    clientVarName,\n  );\n}\n\n/**\n * Append `*<clientVarName>.list_tools_sync()` to the Agent's tools list.\n */\nconst addPythonClientTools = async (\n  tree: Tree,\n  filePath: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(\n      tree,\n      filePath,\n      py(`\\`${clientVarName}.list_tools_sync()\\``),\n    )\n  ) {\n    return;\n  }\n\n  await appendToArrayViaGritQL(\n    tree,\n    filePath,\n    'tools=',\n    `*${clientVarName}.list_tools_sync()`,\n    { skipIfContains: clientVarName, language: 'py' },\n  );\n};\n\n/**\n * Create the client in get_agent and enter it in the `with` block.\n *\n * First connection: rewrites `def get_agent` to wrap the body in a with\n * block. Subsequent connections: adds to the existing with items and\n * prepends the creation line.\n */\nconst addPythonClientToGetAgent = async (\n  tree: Tree,\n  filePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(tree, filePath, py(`\\`${clientClassName}.create()\\``))\n  ) {\n    return;\n  }\n\n  // Try the \"add to existing with block\" pattern first.\n  // If it succeeds, there was already a with block from a previous connection.\n  const addedToWith = await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`with ($items,): $body\\` where {\n  $items <: not contains \\`${clientVarName}\\`,\n  $items += \\`, ${clientVarName}\\`\n}`),\n  );\n\n  if (addedToWith) {\n    // Subsequent connection — prepend the creation line to the function body\n    // (a single anchor, so the line is inserted exactly once).\n    await applyGritQL(\n      tree,\n      filePath,\n      py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`yield Agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    $body\\``),\n    );\n    return;\n  }\n\n  // First connection — wrap the existing `def get_agent` body in a single\n  // `with (<var>,):` block.\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`yield Agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    with (\n        ${clientVarName},\n    ):\n        $body\\``),\n  );\n};\n\n/**\n * Patch a LangChain agent.py to load connection tools and spread them into the\n * `create_agent(...)` tools list. Used by the MCP and gateway connection\n * generators when the source agent uses the `langchain` framework — the client\n * class must expose a static `create()` returning a `list[BaseTool]`. The tools\n * come from langchain-mcp-adapters' `MultiServerMCPClient`, which keeps the\n * connection config on each tool and opens a fresh MCP session per call, so the\n * tools stay usable after `get_agent` returns — no `with` block is needed.\n * Mirrors {@link addPythonClientToAgent} for the Strands shape.\n */\nasync function addPythonLangchainClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  await addPythonLangchainClientTools(tree, agentFilePath, clientVarName);\n  await addPythonLangchainClientToGetAgent(\n    tree,\n    agentFilePath,\n    clientClassName,\n    clientVarName,\n  );\n}\n\n/**\n * Spread `*<clientVarName>` into the `create_agent(...)` tools list.\n *\n * Scoped via `$old <: within \\`create_agent($_)\\`` so only the agent's own\n * tools= keyword argument is touched (not an unrelated function with a\n * `tools=` parameter).\n */\nconst addPythonLangchainClientTools = async (\n  tree: Tree,\n  filePath: string,\n  clientVarName: string,\n): Promise<void> => {\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`tools=$old\\` where {\n  $old <: within \\`create_agent($_)\\`,\n  $old <: not contains \\`*${clientVarName}\\`,\n  if ($old <: \\`[]\\`) {\n    $old => \\`[*${clientVarName}]\\`\n  } else {\n    $old <: \\`[$items]\\` where { $items += \\`, *${clientVarName}\\` }\n  }\n}`),\n  );\n};\n\n/**\n * Prepend `<clientVarName> = <clientClassName>.create()` to the get_agent body\n * (which loads the connection's tools). No `with` block — the LangChain client\n * hands langchain-mcp-adapters a connection config, so each tool opens its own\n * MCP session per call and the tools are safe to use after get_agent returns.\n * Idempotent via the `not contains <clientClassName>.create` guard.\n */\nconst addPythonLangchainClientToGetAgent = async (\n  tree: Tree,\n  filePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(tree, filePath, py(`\\`${clientClassName}.create()\\``))\n  ) {\n    return;\n  }\n\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`create_agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    $body\\``),\n  );\n};\n\n/**\n * Per-framework naming + template layout for a Python per-connection client.\n * Every py#agent connection generator (mcp, gateway, a2a) names its client\n * class `<Name>Client<suffix>`, its module `<name>_client_<suffix>`, and reads\n * the per-connection app-client template from a per-framework sub-path of its\n * own `files/` dir — all of which vary only by framework, so they live here as\n * one source of truth.\n *\n * Keyed by {@link AgentFramework} rather than a boolean so a third framework is\n * an additive entry here — never another `if (isLangchain)` branch in each\n * generator.\n */\nexport interface PyClientNaming {\n  /** Class-name suffix on the per-connection app client (`<Name>Client<suffix>`). */\n  clientClassSuffix: string;\n  /** Module/file-name suffix on the per-connection app client (`<name>_client_<suffix>`). */\n  clientModuleSuffix: string;\n  /**\n   * Sub-path, under a connection generator's `files/` dir, of the per-connection\n   * app client template for this framework. Every connection generator lays its\n   * templates out the same way, so this resolves against any of them.\n   */\n  appTemplateSubdir: string;\n}\n\nexport const PY_CLIENT_NAMING: Record<AgentFramework, PyClientNaming> = {\n  strands: {\n    clientClassSuffix: 'Strands',\n    clientModuleSuffix: 'strands',\n    appTemplateSubdir: joinPathFragments('agent-connection', 'app'),\n  },\n  langchain: {\n    clientClassSuffix: 'LangChain',\n    clientModuleSuffix: 'langchain',\n    appTemplateSubdir: joinPathFragments(\n      'langchain',\n      'agent-connection',\n      'app',\n    ),\n  },\n};\n\n/**\n * How an MCP-family connection (an MCP server or an AgentCore Gateway, both of\n * which expose tools over MCP) is wired into a Python agent of a given\n * framework. The mcp-connection and gateway-connection generators share this:\n * they differ only in the metadata of the thing being connected, not in how\n * the framework's client is shaped or spliced into agent.py. A2A connections\n * wire tools differently, so they reuse only {@link PY_CLIENT_NAMING}.\n */\nexport interface PyMcpFamilyConnection extends PyClientNaming {\n  /** Extra Python deps this framework's MCP-family client needs (beyond the shared transport). */\n  deps: IPyDepVersion[];\n  /**\n   * Splice the per-connection client into the agent's `get_agent` in agent.py.\n   * Strands enters a context-managed `MCPClient` and spreads `list_tools_sync()`;\n   * LangChain loads `BaseTool`s and spreads them into `create_agent(...)`.\n   */\n  wireClientIntoAgent: (\n    tree: Tree,\n    agentFilePath: string,\n    clientClassName: string,\n    clientVarName: string,\n  ) => Promise<void>;\n}\n\nexport const PY_MCP_FAMILY_CONNECTIONS: Record<\n  AgentFramework,\n  PyMcpFamilyConnection\n> = {\n  strands: {\n    ...PY_CLIENT_NAMING.strands,\n    deps: [],\n    wireClientIntoAgent: addPythonClientToAgent,\n  },\n  langchain: {\n    ...PY_CLIENT_NAMING.langchain,\n    // langchain-mcp-adapters backs the LangChain client; it must not pull Strands in.\n    deps: ['langchain-mcp-adapters'],\n    wireClientIntoAgent: addPythonLangchainClientToAgent,\n  },\n};\n\n/**\n * Add a re-export to the Python agent-connection module's __init__.py.\n * Equivalent to addStarExport for TS.\n * Uses `__all__` to mark re-exports as public (satisfies ruff F401).\n * Uses GritQL for AST-aware transforms where possible.\n */\nexport async function addPythonReExport(\n  tree: Tree,\n  initFilePath: string,\n  fromModule: string,\n  importName: string,\n): Promise<void> {\n  // Check if already exported\n  if (await matchGritQL(tree, initFilePath, `\\`${importName}\\``)) {\n    return;\n  }\n\n  const importLine = `from ${fromModule} import ${importName}`;\n  const allEntry = `\"${importName}\"`;\n\n  // If there's already an import from the same module, merge into its name list\n  // (ruff I001 rejects two `from X import ...` lines for the same module).\n  const mergedImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(`\\`from ${fromModule} import $names\\` where {\n  $names <: not contains \\`${importName}\\`,\n  $names += \\`, ${importName}\\`\n}`),\n  );\n\n  if (mergedImport) {\n    await applyGritQL(\n      tree,\n      initFilePath,\n      py(`\\`__all__ = [$items]\\` where { $items += \\`, ${allEntry}\\` }`),\n    );\n    return;\n  }\n\n  // Try to append import after existing import using +=\n  const appendedImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(\n      `\\`from $mod import $name\\` as $stmt where {\n  $program <: not contains \\`${importName}\\`,\n  $stmt += \\`\\n${importLine}\\`\n}`,\n    ),\n  );\n\n  if (appendedImport) {\n    // Also append to existing __all__\n    await applyGritQL(\n      tree,\n      initFilePath,\n      py(`\\`__all__ = [$items]\\` where { $items += \\`, ${allEntry}\\` }`),\n    );\n    return;\n  }\n\n  // No existing imports — first re-export. Try to anchor after docstring.\n  const anchoredImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(\n      `\\`\"\"\"Automatically generated by Nx.\"\"\"\\` as $doc => \\`$doc\\n${importLine}\\n\\n__all__ = [${allEntry}]\\``,\n    ),\n  );\n\n  if (!anchoredImport) {\n    // Completely empty file or no docstring — write directly\n    tree.write(initFilePath, `${importLine}\\n\\n__all__ = [${allEntry}]\\n`);\n  }\n}\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","pyProjectGenerator","getPyProjectDetails","tsProjectGenerator","addStarExport","appendToArrayViaGritQL","applyGritQL","matchGritQL","forDependencies","addDependenciesToPackageJson","esmVars","addDependenciesToPyProjectToml","withVersions","AGENT_CONNECTION_DEPENDENCIES","name","AGENT_CONNECTION_PY_DEPENDENCIES","py","pattern","AGENT_CONNECTION_DIR","PACKAGES_DIR","COMMON_DIR","AGENT_CONNECTION_PROJECT_DIR","PY_AGENT_CONNECTION_NAME","getPythonAgentConnectionProjectDir","tree","dir","directory","getPythonAgentConnectionModuleName","normalizedModuleName","getPythonAgentConnectionProject","fullyQualifiedName","root","resolveAgentFramework","framework","TS_PROTOCOL_TEMPLATES","mcp","gateway","a2a","PY_PROTOCOL_TEMPLATES","FRAMEWORKS","strands","ts","base","baseReExports","fromModule","importName","protocols","deps","langchain","frameworkLanguage","language","protocol","lang","Error","protocolDir","MCP_TRANSPORT_PROTOCOLS","tsCoreDir","TS_TEMPLATE_DEPS","emitTs","templateDir","declaration","dirname","overwriteStrategy","KeepExisting","length","ensureTypeScriptAgentConnectionProject","projectJsonPath","exists","addTypeScriptFrameworkBase","indexPath","reExport","addTypeScriptCoreClient","fw","includes","ensurePythonAgentConnectionProject","projectDir","moduleName","type","moduleDir","coreDir","write","appInitPath","moduleInitPath","addPythonReExport","pyCoreDir","emitPy","ensureLangchainS3CheckpointSaver","addPythonFrameworkBase","addPythonCoreClient","addTypeScriptClientToAgent","agentFilePath","clientClassName","clientVarName","clientCreationStmt","addPythonClientToAgent","addPythonClientTools","addPythonClientToGetAgent","filePath","skipIfContains","addedToWith","addPythonLangchainClientToAgent","addPythonLangchainClientTools","addPythonLangchainClientToGetAgent","PY_CLIENT_NAMING","clientClassSuffix","clientModuleSuffix","appTemplateSubdir","PY_MCP_FAMILY_CONNECTIONS","wireClientIntoAgent","initFilePath","importLine","allEntry","mergedImport","appendedImport","anchoredImport"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/utils/agent-connection/agent-connection.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n} from '@nx/devkit';\nimport pyProjectGenerator, {\n  getPyProjectDetails,\n} from '../../py/project/generator.js';\nimport tsProjectGenerator from '../../ts/lib/generator.js';\nimport {\n  addStarExport,\n  appendToArrayViaGritQL,\n  applyGritQL,\n  matchGritQL,\n} from '../ast.js';\nimport {\n  type DependencyDeclaration,\n  forDependencies,\n  type MustDeclare,\n  type MustDeclarePy,\n} from '../declared-dependencies.js';\nimport { addDependenciesToPackageJson } from '../dependencies.js';\nimport { esmVars } from '../module-format.js';\nimport { addDependenciesToPyProjectToml } from '../py.js';\nimport {\n  type IPyDepVersion,\n  type ITsDepVersion,\n  withVersions,\n} from '../versions.js';\n\n/** TypeScript dependencies a caller must declare to emit agent-connection clients. */\nexport const AGENT_CONNECTION_DEPENDENCIES = [\n  { name: '@aws-lambda-powertools/parameters' },\n  { name: '@aws-sdk/credential-providers' },\n  { name: 'aws4fetch' },\n  { name: '@modelcontextprotocol/sdk' },\n  { name: '@a2a-js/sdk' },\n  { name: '@strands-agents/sdk' },\n  { name: '@aws-sdk/client-s3' },\n] as const satisfies readonly { name: ITsDepVersion }[];\n\n/** Python dependencies a caller must declare to emit agent-connection clients. */\nexport const AGENT_CONNECTION_PY_DEPENDENCIES = [\n  { name: 'aws-lambda-powertools' },\n  { name: 'strands-agents' },\n] as const satisfies readonly { name: IPyDepVersion }[];\n\ntype AgentConnectionPyDependency =\n  (typeof AGENT_CONNECTION_PY_DEPENDENCIES)[number]['name'];\n\n/** Prefix a GritQL pattern with `language python` */\nconst py = (pattern: string) => `language python\\n${pattern}`;\n\nconst AGENT_CONNECTION_DIR = 'agent-connection';\nconst PACKAGES_DIR = 'packages';\nconst COMMON_DIR = 'common';\n\nexport const AGENT_CONNECTION_PROJECT_DIR = joinPathFragments(\n  PACKAGES_DIR,\n  COMMON_DIR,\n  AGENT_CONNECTION_DIR,\n);\n\nconst PY_AGENT_CONNECTION_NAME = 'agent_connection';\n\n/**\n * Get the directory of the shared Python agent-connection project.\n */\nexport function getPythonAgentConnectionProjectDir(tree: Tree): string {\n  const { dir } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return dir;\n}\n\n/**\n * Get the Python module name of the shared agent-connection project.\n */\nexport function getPythonAgentConnectionModuleName(tree: Tree): string {\n  const { normalizedModuleName } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return normalizedModuleName;\n}\n\n/**\n * Get the shared agent-connection project as `{ name, root }`, suitable for\n * passing to {@link addWorkspaceDependencyToPyProject} (which derives the\n * dependency's PEP 503 distribution name from the project itself, so callers\n * never construct the name).\n */\nexport function getPythonAgentConnectionProject(tree: Tree): {\n  name: string;\n  root: string;\n} {\n  const { fullyQualifiedName, dir } = getPyProjectDetails(tree, {\n    name: PY_AGENT_CONNECTION_NAME,\n    directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n  });\n  return { name: fullyQualifiedName, root: dir };\n}\n\n/**\n * The connection protocols an agent framework can connect over. Each maps to a\n * framework-agnostic Layer-0/1 template directory plus a per-framework Layer-2\n * client directory (see `FRAMEWORKS`).\n */\nexport type ConnectionProtocol = 'mcp' | 'gateway' | 'a2a';\n\n/**\n * The agent frameworks we can generate connection clients for. Adding a new\n * framework is an additive change: append an entry to `FRAMEWORKS` with its\n * Layer-2 template directories and dependencies — the framework-agnostic\n * Layer-0/1 (`core-auth`, `core-shared`, the per-protocol transports/configs)\n * is reused unchanged.\n */\nexport type AgentFramework = 'strands' | 'langchain';\n\n/**\n * Resolve an agent component's framework, defaulting to `strands`. Connection\n * generators dispatch on the returned framework to pick the matching templates\n * and agent.py/agent.ts transforms.\n */\nexport function resolveAgentFramework(\n  framework: string | undefined,\n): AgentFramework {\n  return framework === 'langchain' ? 'langchain' : 'strands';\n}\n\n/**\n * Framework-agnostic Layer-1 templates, keyed by protocol. These resolve the\n * endpoint and build the signed transport/client-config; they contain no\n * framework dependency.\n */\nconst TS_PROTOCOL_TEMPLATES: Record<ConnectionProtocol, string> = {\n  mcp: 'core-mcp',\n  gateway: 'core-gateway',\n  a2a: 'core-a2a',\n};\nconst PY_PROTOCOL_TEMPLATES: Record<ConnectionProtocol, string> = {\n  mcp: 'py-core-mcp',\n  gateway: 'py-core-gateway',\n  a2a: 'py-core-a2a',\n};\n\n/**\n * A re-export the framework base emits into the agent-connection module's\n * `__init__.py` (the agent server entry point imports these by name).\n */\ninterface BaseReExport {\n  fromModule: string;\n  importName: string;\n}\n\n/**\n * A framework's Layer-2 templates for one language. `base` (optional) holds the\n * helpers every connection of that framework needs (error logging, per-session\n * agent cache); `baseReExports` lists what those helpers expose at the module\n * root. `protocols` maps each *supported* protocol to the thin client that wraps\n * the matching Layer-1 transport/config in the framework's client type.\n *\n * A framework whose Layer-2 needs no base helpers (e.g. LangChain, whose AG-UI\n * foundation reuses only the framework-agnostic session context) omits `base`\n * and leaves `baseReExports` empty.\n *\n * A protocol absent from `protocols` is not supported by that framework in that\n * language — callers must check before emitting. `deps` are the extra package\n * dependencies the base helpers require (per-connection client deps are added\n * by the connection generators, not here).\n */\ninterface FrameworkLanguageTemplates<Dep extends string> {\n  base?: string;\n  baseReExports: BaseReExport[];\n  protocols: Partial<Record<ConnectionProtocol, string>>;\n  deps: Dep[];\n}\n\n/**\n * Per-framework Layer-2 templates. Support is asymmetric by design: a framework\n * may target only one language (`ts`/`py` is optional) and only a subset of\n * protocols. Adding a framework — or extending an existing one to a new\n * language/protocol — is an additive change to this registry.\n */\ninterface FrameworkTemplates {\n  ts?: FrameworkLanguageTemplates<string>;\n  py?: FrameworkLanguageTemplates<AgentConnectionPyDependency>;\n}\n\nconst FRAMEWORKS: Record<AgentFramework, FrameworkTemplates> = {\n  strands: {\n    ts: {\n      base: 'core-strands/base',\n      baseReExports: [\n        {\n          fromModule: './core/with-session-id-strands.js',\n          importName: '*',\n        },\n        {\n          fromModule: './core/model-errors-strands.js',\n          importName: '*',\n        },\n        {\n          fromModule: './core/tool-errors-strands.js',\n          importName: '*',\n        },\n      ],\n      protocols: {\n        mcp: 'core-strands/mcp',\n        gateway: 'core-strands/gateway',\n        a2a: 'core-strands/a2a',\n      },\n      deps: [],\n    },\n    py: {\n      base: 'py-core-strands/base',\n      baseReExports: [\n        {\n          fromModule: '.core.with_session_id_strands',\n          importName: 'with_session_id',\n        },\n        {\n          fromModule: '.core.model_errors_strands',\n          importName: 'log_model_errors',\n        },\n        {\n          fromModule: '.core.tool_errors_strands',\n          importName: 'log_tool_errors',\n        },\n      ],\n      protocols: {\n        mcp: 'py-core-strands/mcp',\n        gateway: 'py-core-strands/gateway',\n        a2a: 'py-core-strands/a2a',\n      },\n      deps: ['strands-agents'],\n    },\n  },\n  langchain: {\n    // LangChain is supported for Python agents only (the TypeScript LangChain\n    // agent foundation has no in-process AG-UI <-> LangGraph adapter, so it is\n    // not scaffolded — see ts#agent). Its Layer-2 clients stay usable after\n    // agent construction, so there is no base helper layer (no model-error\n    // logger / per-session agent cache) and no strands-agents dependency — its\n    // AG-UI foundation reuses only the framework-agnostic session context, and\n    // its A2A client drives the a2a SDK directly rather than wrapping Strands'\n    // A2AAgent. The per-connection adapter dependency (langchain-mcp-adapters /\n    // a2a-sdk) is added by the connection generators.\n    py: {\n      baseReExports: [],\n      protocols: {\n        mcp: 'py-core-langchain/mcp',\n        gateway: 'py-core-langchain/gateway',\n        a2a: 'py-core-langchain/a2a',\n      },\n      deps: [],\n    },\n  },\n};\n\n/** Resolve a framework's templates for a language + protocol, or throw. */\nfunction frameworkLanguage<L extends 'ts' | 'py'>(\n  framework: AgentFramework,\n  language: L,\n  protocol: ConnectionProtocol,\n): NonNullable<FrameworkTemplates[L]> & { protocol: string } {\n  const lang = FRAMEWORKS[framework][language];\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support ${language === 'ts' ? 'TypeScript' : 'Python'} agents.`,\n    );\n  }\n  const protocolDir = lang.protocols[protocol];\n  if (!protocolDir) {\n    throw new Error(\n      `The '${framework}' framework does not support ${protocol} connections for ${language === 'ts' ? 'TypeScript' : 'Python'} agents.`,\n    );\n  }\n  return { ...lang, protocol: protocolDir } as NonNullable<\n    FrameworkTemplates[L]\n  > & { protocol: string };\n}\n\n/** Protocols whose Layer-1 needs the shared MCP transport (`core-shared`). */\nconst MCP_TRANSPORT_PROTOCOLS: ConnectionProtocol[] = ['mcp', 'gateway'];\n\nconst tsCoreDir = () =>\n  joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'core');\n\n/**\n * Runtime dependencies each TypeScript core template directory imports. Emitting\n * a template also declares its dependencies in the agent-connection project's\n * package.json so the `noUndeclaredDependencies` lint rule passes.\n */\nconst TS_TEMPLATE_DEPS: Record<\n  string,\n  (typeof AGENT_CONNECTION_DEPENDENCIES)[number]['name'][]\n> = {\n  'core-runtime-config': ['@aws-lambda-powertools/parameters'],\n  'core-auth': ['@aws-sdk/credential-providers', 'aws4fetch'],\n  'core-shared': ['@aws-sdk/credential-providers', '@modelcontextprotocol/sdk'],\n  'core-mcp': ['@aws-sdk/credential-providers', '@modelcontextprotocol/sdk'],\n  'core-gateway': [\n    '@aws-sdk/credential-providers',\n    '@modelcontextprotocol/sdk',\n  ],\n  'core-a2a': ['@aws-sdk/credential-providers', '@a2a-js/sdk'],\n  'core-strands/base': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/mcp': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/gateway': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n  'core-strands/a2a': ['@strands-agents/sdk', '@aws-sdk/client-s3'],\n};\n\nconst emitTs = (\n  tree: Tree,\n  templateDir: string,\n  declaration: DependencyDeclaration,\n) => {\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', templateDir),\n    tsCoreDir(),\n    { ...esmVars(tree) },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n  const deps = TS_TEMPLATE_DEPS[templateDir];\n  if (deps?.length) {\n    addDependenciesToPackageJson(\n      tree,\n      withVersions(\n        forDependencies<typeof AGENT_CONNECTION_DEPENDENCIES>(declaration),\n        deps,\n      ),\n      {},\n      joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'package.json'),\n    );\n  }\n};\n\n/**\n * Ensure the shared TypeScript agent-connection project exists and has the\n * framework-agnostic core helpers (runtime-config loader, session context).\n * Per-connection generators emit their own protocol + framework client\n * templates via `addTypeScriptCoreClient`.\n */\nexport async function ensureTypeScriptAgentConnectionProject<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n): Promise<void> {\n  const projectJsonPath = joinPathFragments(\n    AGENT_CONNECTION_PROJECT_DIR,\n    'project.json',\n  );\n  if (!tree.exists(projectJsonPath)) {\n    await tsProjectGenerator(tree, {\n      name: AGENT_CONNECTION_DIR,\n      directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n    });\n  }\n\n  // Framework-agnostic runtime-config + session-context helpers.\n  emitTs(tree, 'core-runtime-config', declaration);\n\n  // Re-export session-context helpers so agent server entry points can set the\n  // current session on each inbound request without pulling in internals.\n  await addStarExport(\n    tree,\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'),\n    './core/session-context.js',\n  );\n\n  // Re-export the runtime-config loader so agent server entry points can read\n  // their own connected resources (e.g. session storage) without pulling in\n  // internals.\n  await addStarExport(\n    tree,\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'),\n    './core/runtime-config.js',\n  );\n}\n\n/**\n * Emit a framework's base Layer-2 helpers (model-error logging + per-session\n * agent cache) into the agent-connection project and re-export them. The agent\n * server entry point imports these regardless of whether any connection client\n * is wired in, so the agent generator calls this directly; connection\n * generators call it transitively via `addTypeScriptCoreClient`.\n */\nexport async function addTypeScriptFrameworkBase<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const lang = FRAMEWORKS[framework].ts;\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support TypeScript agents.`,\n    );\n  }\n  if (lang.base) {\n    emitTs(tree, lang.base, declaration);\n  }\n\n  const indexPath = joinPathFragments(\n    AGENT_CONNECTION_PROJECT_DIR,\n    'src',\n    'index.ts',\n  );\n  for (const reExport of lang.baseReExports) {\n    await addStarExport(tree, indexPath, reExport.fromModule);\n  }\n}\n\n/**\n * Emit the TypeScript client templates for a connection protocol and agent\n * framework into the agent-connection project's `src/core/` directory. Safe to\n * call multiple times — `KeepExisting` preserves customised files.\n *\n * Layers emitted:\n *  - Layer 0 `core-auth` (signed fetch + endpoint resolution) — always\n *  - Layer 1 `core-shared` MCP transport — for mcp/gateway protocols\n *  - Layer 1 the protocol's transport/client-config — always\n *  - Layer 2 the framework's base helpers + protocol client — per framework\n */\nexport async function addTypeScriptCoreClient<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  protocol: ConnectionProtocol,\n  declaration: D & MustDeclare<typeof AGENT_CONNECTION_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const fw = frameworkLanguage(framework, 'ts', protocol);\n\n  emitTs(tree, 'core-auth', declaration);\n  if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {\n    emitTs(tree, 'core-shared', declaration);\n  }\n  emitTs(tree, TS_PROTOCOL_TEMPLATES[protocol], declaration);\n\n  // Framework Layer 2: base helpers (re-exported for the agent server) + the\n  // thin protocol client.\n  await addTypeScriptFrameworkBase(\n    tree,\n    forDependencies<typeof AGENT_CONNECTION_DEPENDENCIES>(declaration),\n    framework,\n  );\n  emitTs(tree, fw.protocol, declaration);\n}\n\n/**\n * Ensure the shared Python agent-connection project exists.\n * Only creates the project shell — per-connection generators are responsible\n * for emitting their own core client templates.\n */\nexport async function ensurePythonAgentConnectionProject<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n): Promise<void> {\n  const projectDir = getPythonAgentConnectionProjectDir(tree);\n  const moduleName = getPythonAgentConnectionModuleName(tree);\n  const projectJsonPath = joinPathFragments(projectDir, 'project.json');\n\n  if (!tree.exists(projectJsonPath)) {\n    // Create the Python project using the standard py#project generator\n    await pyProjectGenerator(tree, {\n      name: PY_AGENT_CONNECTION_NAME,\n      directory: joinPathFragments(PACKAGES_DIR, COMMON_DIR),\n      type: 'library',\n    });\n  }\n\n  const moduleDir = joinPathFragments(projectDir, moduleName);\n\n  // Ensure core/__init__.py exists\n  const coreDir = joinPathFragments(moduleDir, 'core');\n  if (!tree.exists(joinPathFragments(coreDir, '__init__.py'))) {\n    tree.write(joinPathFragments(coreDir, '__init__.py'), '');\n  }\n\n  // Ensure app/__init__.py exists\n  const appInitPath = joinPathFragments(moduleDir, 'app', '__init__.py');\n  if (!tree.exists(appInitPath)) {\n    tree.write(appInitPath, '');\n  }\n\n  // Framework-agnostic runtime-config + session-context helpers.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'py-core-runtime-config'),\n    coreDir,\n    {},\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Re-export the session id context so agent server entry points can set the\n  // current session on each inbound request without importing internals.\n  const moduleInitPath = joinPathFragments(moduleDir, '__init__.py');\n  await addPythonReExport(\n    tree,\n    moduleInitPath,\n    '.core.session_context',\n    'get_current_session_id',\n  );\n  await addPythonReExport(\n    tree,\n    moduleInitPath,\n    '.core.session_context',\n    'session_id_context',\n  );\n\n  // The runtime-config loader reads AppConfig via aws-lambda-powertools.\n  addDependenciesToPyProjectToml(\n    tree,\n    projectDir,\n    forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n    ['aws-lambda-powertools'],\n  );\n}\n\nconst pyCoreDir = (tree: Tree) =>\n  joinPathFragments(\n    getPythonAgentConnectionProjectDir(tree),\n    getPythonAgentConnectionModuleName(tree),\n    'core',\n  );\n\nconst emitPy = (tree: Tree, templateDir: string) =>\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', templateDir),\n    pyCoreDir(tree),\n    {},\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n/**\n * Ensure the shared Python agent-connection project has\n * `s3_checkpoint_saver_langchain.py` — a vendored `S3CheckpointSaver`\n * (from `langgraph-checkpoint-s3`, MIT licensed) that LangChain agents with\n * `session: 's3'` import from directly (`.core.s3_checkpoint_saver_langchain`),\n * mirroring how they import `.core.runtime_config`. Vendored rather than\n * installed as a dependency, and shared rather than per-agent, since it has\n * no agent-specific templating.\n */\nexport function ensureLangchainS3CheckpointSaver(tree: Tree): void {\n  emitPy(tree, 'py-core-langchain/s3');\n}\n\n/**\n * Emit a framework's base Layer-2 helpers (model-error logging + per-session\n * agent cache) into the Python agent-connection project and re-export them.\n * The agent server entry point imports these regardless of whether a connection\n * client is wired in, so the agent generator calls this directly; connection\n * generators call it transitively via `addPythonCoreClient`.\n */\nexport async function addPythonFrameworkBase<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const lang = FRAMEWORKS[framework].py;\n  if (!lang) {\n    throw new Error(\n      `The '${framework}' framework does not support Python agents.`,\n    );\n  }\n  if (lang.base) {\n    emitPy(tree, lang.base);\n  }\n\n  const moduleInitPath = joinPathFragments(\n    getPythonAgentConnectionProjectDir(tree),\n    getPythonAgentConnectionModuleName(tree),\n    '__init__.py',\n  );\n  for (const reExport of lang.baseReExports) {\n    await addPythonReExport(\n      tree,\n      moduleInitPath,\n      reExport.fromModule,\n      reExport.importName,\n    );\n  }\n\n  if (lang.deps.length > 0) {\n    addDependenciesToPyProjectToml(\n      tree,\n      getPythonAgentConnectionProjectDir(tree),\n      forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n      lang.deps,\n    );\n  }\n}\n\n/**\n * Emit the Python client templates for a connection protocol and agent\n * framework into the agent-connection project's core directory.\n *\n * Layers emitted:\n *  - Layer 0 `py-core-auth` (SigV4 httpx.Auth, session auth, endpoints) — always\n *  - Layer 1 `py-core-shared` MCP transport — for mcp/gateway protocols\n *  - Layer 1 the protocol's transport/client-config — always\n *  - Layer 2 the framework's base helpers + protocol client — per framework\n */\nexport async function addPythonCoreClient<\n  const D extends DependencyDeclaration,\n>(\n  tree: Tree,\n  protocol: ConnectionProtocol,\n  declaration: D & MustDeclarePy<typeof AGENT_CONNECTION_PY_DEPENDENCIES, D>,\n  framework: AgentFramework = 'strands',\n): Promise<void> {\n  const fw = frameworkLanguage(framework, 'py', protocol);\n\n  emitPy(tree, 'py-core-auth');\n  if (MCP_TRANSPORT_PROTOCOLS.includes(protocol)) {\n    emitPy(tree, 'py-core-shared');\n  }\n  emitPy(tree, PY_PROTOCOL_TEMPLATES[protocol]);\n\n  // Framework Layer 2: base helpers + the thin protocol client.\n  await addPythonFrameworkBase(\n    tree,\n    forDependencies<[], typeof AGENT_CONNECTION_PY_DEPENDENCIES>(declaration),\n    framework,\n  );\n  emitPy(tree, fw.protocol);\n}\n\n/**\n * Patch a TypeScript agent.ts to create a connection client and register it\n * in the Agent's tools. Used by the MCP and gateway connection generators —\n * the client class must expose a static async `create()` returning a value\n * accepted by `Agent.tools` (e.g. an `McpClient`).\n */\nexport async function addTypeScriptClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  const clientCreationStmt = `const ${clientVarName} = await ${clientClassName}.create();`;\n\n  // Transform the arrow function that contains `new Agent`:\n  // - Expression body: wrap in block with client creation and return\n  // - Block body: prepend client creation statement\n  await applyGritQL(\n    tree,\n    agentFilePath,\n    `or { \\`async ($p) => new Agent($args)\\` => raw\\`async ($p) => {\n  ${clientCreationStmt}\n  return new Agent($args);\n}\\` where { $program <: not contains \\`${clientClassName}.create\\` }, \\`async ($p) => { $body }\\` => raw\\`async ($p) => {\n  ${clientCreationStmt}\n  $body\n}\\` where { $body <: contains \\`new Agent($_)\\`, $program <: not contains \\`${clientClassName}.create\\` } }`,\n  );\n\n  // Prepend the client to the tools array\n  await applyGritQL(\n    tree,\n    agentFilePath,\n    `\\`tools: [$items]\\` => \\`tools: [${clientVarName}, $items]\\` where { $items <: within \\`new Agent($_)\\`, $items <: not contains \\`${clientVarName}\\` }`,\n  );\n}\n\n/**\n * Patch a Python agent.py to create a context-managed connection client,\n * enter it in the `with` block around `yield Agent(...)`, and spread its\n * `list_tools_sync()` into the Agent's tools. Used by the MCP and gateway\n * connection generators — the client class must expose a static `create()`\n * returning a context manager with `list_tools_sync()` (e.g. an `MCPClient`).\n */\nasync function addPythonClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  await addPythonClientTools(tree, agentFilePath, clientVarName);\n  await addPythonClientToGetAgent(\n    tree,\n    agentFilePath,\n    clientClassName,\n    clientVarName,\n  );\n}\n\n/**\n * Append `*<clientVarName>.list_tools_sync()` to the Agent's tools list.\n */\nconst addPythonClientTools = async (\n  tree: Tree,\n  filePath: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(\n      tree,\n      filePath,\n      py(`\\`${clientVarName}.list_tools_sync()\\``),\n    )\n  ) {\n    return;\n  }\n\n  await appendToArrayViaGritQL(\n    tree,\n    filePath,\n    'tools=',\n    `*${clientVarName}.list_tools_sync()`,\n    { skipIfContains: clientVarName, language: 'py' },\n  );\n};\n\n/**\n * Create the client in get_agent and enter it in the `with` block.\n *\n * First connection: rewrites `def get_agent` to wrap the body in a with\n * block. Subsequent connections: adds to the existing with items and\n * prepends the creation line.\n */\nconst addPythonClientToGetAgent = async (\n  tree: Tree,\n  filePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(tree, filePath, py(`\\`${clientClassName}.create()\\``))\n  ) {\n    return;\n  }\n\n  // Try the \"add to existing with block\" pattern first.\n  // If it succeeds, there was already a with block from a previous connection.\n  const addedToWith = await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`with ($items,): $body\\` where {\n  $items <: not contains \\`${clientVarName}\\`,\n  $items += \\`, ${clientVarName}\\`\n}`),\n  );\n\n  if (addedToWith) {\n    // Subsequent connection — prepend the creation line to the function body\n    // (a single anchor, so the line is inserted exactly once).\n    await applyGritQL(\n      tree,\n      filePath,\n      py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`yield Agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    $body\\``),\n    );\n    return;\n  }\n\n  // First connection — wrap the existing `def get_agent` body in a single\n  // `with (<var>,):` block.\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`yield Agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    with (\n        ${clientVarName},\n    ):\n        $body\\``),\n  );\n};\n\n/**\n * Patch a LangChain agent.py to load connection tools and spread them into the\n * `create_agent(...)` tools list. Used by the MCP and gateway connection\n * generators when the source agent uses the `langchain` framework — the client\n * class must expose a static `create()` returning a `list[BaseTool]`. The tools\n * come from langchain-mcp-adapters' `MultiServerMCPClient`, which keeps the\n * connection config on each tool and opens a fresh MCP session per call, so the\n * tools stay usable after `get_agent` returns — no `with` block is needed.\n * Mirrors {@link addPythonClientToAgent} for the Strands shape.\n */\nasync function addPythonLangchainClientToAgent(\n  tree: Tree,\n  agentFilePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> {\n  await addPythonLangchainClientTools(tree, agentFilePath, clientVarName);\n  await addPythonLangchainClientToGetAgent(\n    tree,\n    agentFilePath,\n    clientClassName,\n    clientVarName,\n  );\n}\n\n/**\n * Spread `*<clientVarName>` into the `create_agent(...)` tools list.\n *\n * Scoped via `$old <: within \\`create_agent($_)\\`` so only the agent's own\n * tools= keyword argument is touched (not an unrelated function with a\n * `tools=` parameter).\n */\nconst addPythonLangchainClientTools = async (\n  tree: Tree,\n  filePath: string,\n  clientVarName: string,\n): Promise<void> => {\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`tools=$old\\` where {\n  $old <: within \\`create_agent($_)\\`,\n  $old <: not contains \\`*${clientVarName}\\`,\n  if ($old <: \\`[]\\`) {\n    $old => \\`[*${clientVarName}]\\`\n  } else {\n    $old <: \\`[$items]\\` where { $items += \\`, *${clientVarName}\\` }\n  }\n}`),\n  );\n};\n\n/**\n * Prepend `<clientVarName> = <clientClassName>.create()` to the get_agent body\n * (which loads the connection's tools). No `with` block — the LangChain client\n * hands langchain-mcp-adapters a connection config, so each tool opens its own\n * MCP session per call and the tools are safe to use after get_agent returns.\n * Idempotent via the `not contains <clientClassName>.create` guard.\n */\nconst addPythonLangchainClientToGetAgent = async (\n  tree: Tree,\n  filePath: string,\n  clientClassName: string,\n  clientVarName: string,\n): Promise<void> => {\n  if (\n    await matchGritQL(tree, filePath, py(`\\`${clientClassName}.create()\\``))\n  ) {\n    return;\n  }\n\n  await applyGritQL(\n    tree,\n    filePath,\n    py(`\\`def get_agent($params):\n    $body\\` where {\n  $body <: contains \\`create_agent($_)\\`,\n  $body <: not contains \\`${clientClassName}.create\\`\n} => \\`def get_agent($params):\n    ${clientVarName} = ${clientClassName}.create()\n    $body\\``),\n  );\n};\n\n/**\n * Per-framework naming + template layout for a Python per-connection client.\n * Every py#agent connection generator (mcp, gateway, a2a) names its client\n * class `<Name>Client<suffix>`, its module `<name>_client_<suffix>`, and reads\n * the per-connection app-client template from a per-framework sub-path of its\n * own `files/` dir — all of which vary only by framework, so they live here as\n * one source of truth.\n *\n * Keyed by {@link AgentFramework} rather than a boolean so a third framework is\n * an additive entry here — never another `if (isLangchain)` branch in each\n * generator.\n */\nexport interface PyClientNaming {\n  /** Class-name suffix on the per-connection app client (`<Name>Client<suffix>`). */\n  clientClassSuffix: string;\n  /** Module/file-name suffix on the per-connection app client (`<name>_client_<suffix>`). */\n  clientModuleSuffix: string;\n  /**\n   * Sub-path, under a connection generator's `files/` dir, of the per-connection\n   * app client template for this framework. Every connection generator lays its\n   * templates out the same way, so this resolves against any of them.\n   */\n  appTemplateSubdir: string;\n}\n\nexport const PY_CLIENT_NAMING: Record<AgentFramework, PyClientNaming> = {\n  strands: {\n    clientClassSuffix: 'Strands',\n    clientModuleSuffix: 'strands',\n    appTemplateSubdir: joinPathFragments('agent-connection', 'app'),\n  },\n  langchain: {\n    clientClassSuffix: 'LangChain',\n    clientModuleSuffix: 'langchain',\n    appTemplateSubdir: joinPathFragments(\n      'langchain',\n      'agent-connection',\n      'app',\n    ),\n  },\n};\n\n/**\n * How an MCP-family connection (an MCP server or an AgentCore Gateway, both of\n * which expose tools over MCP) is wired into a Python agent of a given\n * framework. The mcp-connection and gateway-connection generators share this:\n * they differ only in the metadata of the thing being connected, not in how\n * the framework's client is shaped or spliced into agent.py. A2A connections\n * wire tools differently, so they reuse only {@link PY_CLIENT_NAMING}.\n */\nexport interface PyMcpFamilyConnection extends PyClientNaming {\n  /** Extra Python deps this framework's MCP-family client needs (beyond the shared transport). */\n  deps: IPyDepVersion[];\n  /**\n   * Splice the per-connection client into the agent's `get_agent` in agent.py.\n   * Strands enters a context-managed `MCPClient` and spreads `list_tools_sync()`;\n   * LangChain loads `BaseTool`s and spreads them into `create_agent(...)`.\n   */\n  wireClientIntoAgent: (\n    tree: Tree,\n    agentFilePath: string,\n    clientClassName: string,\n    clientVarName: string,\n  ) => Promise<void>;\n}\n\nexport const PY_MCP_FAMILY_CONNECTIONS: Record<\n  AgentFramework,\n  PyMcpFamilyConnection\n> = {\n  strands: {\n    ...PY_CLIENT_NAMING.strands,\n    deps: [],\n    wireClientIntoAgent: addPythonClientToAgent,\n  },\n  langchain: {\n    ...PY_CLIENT_NAMING.langchain,\n    // langchain-mcp-adapters backs the LangChain client; it must not pull Strands in.\n    deps: ['langchain-mcp-adapters'],\n    wireClientIntoAgent: addPythonLangchainClientToAgent,\n  },\n};\n\n/**\n * Add a re-export to the Python agent-connection module's __init__.py.\n * Equivalent to addStarExport for TS, including creating the file when it does\n * not yet exist in the tree.\n * Uses `__all__` to mark re-exports as public (satisfies ruff F401).\n * Uses GritQL for AST-aware transforms where possible.\n */\nexport async function addPythonReExport(\n  tree: Tree,\n  initFilePath: string,\n  fromModule: string,\n  importName: string,\n): Promise<void> {\n  // Check if already exported\n  if (await matchGritQL(tree, initFilePath, `\\`${importName}\\``)) {\n    return;\n  }\n\n  const importLine = `from ${fromModule} import ${importName}`;\n  const allEntry = `\"${importName}\"`;\n\n  if (!tree.exists(initFilePath)) {\n    tree.write(initFilePath, `${importLine}\\n\\n__all__ = [${allEntry}]\\n`);\n    return;\n  }\n\n  // If there's already an import from the same module, merge into its name list\n  // (ruff I001 rejects two `from X import ...` lines for the same module).\n  const mergedImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(`\\`from ${fromModule} import $names\\` where {\n  $names <: not contains \\`${importName}\\`,\n  $names += \\`, ${importName}\\`\n}`),\n  );\n\n  if (mergedImport) {\n    await applyGritQL(\n      tree,\n      initFilePath,\n      py(`\\`__all__ = [$items]\\` where { $items += \\`, ${allEntry}\\` }`),\n    );\n    return;\n  }\n\n  // Try to append import after existing import using +=\n  const appendedImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(\n      `\\`from $mod import $name\\` as $stmt where {\n  $program <: not contains \\`${importName}\\`,\n  $stmt += \\`\\n${importLine}\\`\n}`,\n    ),\n  );\n\n  if (appendedImport) {\n    // Also append to existing __all__\n    await applyGritQL(\n      tree,\n      initFilePath,\n      py(`\\`__all__ = [$items]\\` where { $items += \\`, ${allEntry}\\` }`),\n    );\n    return;\n  }\n\n  // No existing imports — first re-export. Try to anchor after docstring.\n  const anchoredImport = await applyGritQL(\n    tree,\n    initFilePath,\n    py(\n      `\\`\"\"\"Automatically generated by Nx.\"\"\"\\` as $doc => \\`$doc\\n${importLine}\\n\\n__all__ = [${allEntry}]\\``,\n    ),\n  );\n\n  if (!anchoredImport) {\n    // Completely empty file or no docstring — write directly\n    tree.write(initFilePath, `${importLine}\\n\\n__all__ = [${allEntry}]\\n`);\n  }\n}\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","pyProjectGenerator","getPyProjectDetails","tsProjectGenerator","addStarExport","appendToArrayViaGritQL","applyGritQL","matchGritQL","forDependencies","addDependenciesToPackageJson","esmVars","addDependenciesToPyProjectToml","withVersions","AGENT_CONNECTION_DEPENDENCIES","name","AGENT_CONNECTION_PY_DEPENDENCIES","py","pattern","AGENT_CONNECTION_DIR","PACKAGES_DIR","COMMON_DIR","AGENT_CONNECTION_PROJECT_DIR","PY_AGENT_CONNECTION_NAME","getPythonAgentConnectionProjectDir","tree","dir","directory","getPythonAgentConnectionModuleName","normalizedModuleName","getPythonAgentConnectionProject","fullyQualifiedName","root","resolveAgentFramework","framework","TS_PROTOCOL_TEMPLATES","mcp","gateway","a2a","PY_PROTOCOL_TEMPLATES","FRAMEWORKS","strands","ts","base","baseReExports","fromModule","importName","protocols","deps","langchain","frameworkLanguage","language","protocol","lang","Error","protocolDir","MCP_TRANSPORT_PROTOCOLS","tsCoreDir","TS_TEMPLATE_DEPS","emitTs","templateDir","declaration","dirname","overwriteStrategy","KeepExisting","length","ensureTypeScriptAgentConnectionProject","projectJsonPath","exists","addTypeScriptFrameworkBase","indexPath","reExport","addTypeScriptCoreClient","fw","includes","ensurePythonAgentConnectionProject","projectDir","moduleName","type","moduleDir","coreDir","write","appInitPath","moduleInitPath","addPythonReExport","pyCoreDir","emitPy","ensureLangchainS3CheckpointSaver","addPythonFrameworkBase","addPythonCoreClient","addTypeScriptClientToAgent","agentFilePath","clientClassName","clientVarName","clientCreationStmt","addPythonClientToAgent","addPythonClientTools","addPythonClientToGetAgent","filePath","skipIfContains","addedToWith","addPythonLangchainClientToAgent","addPythonLangchainClientTools","addPythonLangchainClientToGetAgent","PY_CLIENT_NAMING","clientClassSuffix","clientModuleSuffix","appTemplateSubdir","PY_MCP_FAMILY_CONNECTIONS","wireClientIntoAgent","initFilePath","importLine","allEntry","mergedImport","appendedImport","anchoredImport"],"mappings":"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"}

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

@@ -7,9 +7,13 @@ import * as url from 'node:url';
 import { GatewayAuthorizer } from 'aws-cdk-lib/aws-bedrockagentcore';
 import { IUserPool, IUserPoolClient } from 'aws-cdk-lib/aws-cognito';
 <%_ } _%>
+<%_ /* Alias the core imports only when this gateway's name would shadow them. */ _%>
+<%_ const collides = ['AgentCoreGateway', 'AgentCoreGatewayProps'].includes(nameClassName); _%>
+<%_ const coreGateway = collides ? 'CoreAgentCoreGateway' : 'AgentCoreGateway'; _%>
+<%_ const coreGatewayProps = collides ? 'CoreAgentCoreGatewayProps' : 'AgentCoreGatewayProps'; _%>
 import {
-  AgentCoreGateway,
-  AgentCoreGatewayProps,
+  AgentCoreGateway<% if (collides) { %> as <%= coreGateway %><% } %>,
+  AgentCoreGatewayProps<% if (collides) { %> as <%= coreGatewayProps %><% } %>,
 } from '../../../core/agentcore-gateway/agentcore-gateway<% if (esm) { %>.js<% } %>';
 import { RuntimeConfig } from '../../../core/runtime-config<% if (esm) { %>.js<% } %>';
 <%_ if (cedarPolicy) { _%>
@@ -18,7 +22,7 @@ import { findWorkspaceRoot } from '../../../core/workspace<% if (esm) { %>.js<%
 
 <%_ if (auth === 'cognito') { _%>
 export type <%- nameClassName %>Props = Omit<
-  AgentCoreGatewayProps,
+  <%= coreGatewayProps %>,
   <%_ if (cedarPolicy) { _%>'cedarPolicyPath' | <%_ } _%>'authorizer' | 'protocol'
 > & {
   /**
@@ -31,9 +35,9 @@ export type <%- nameClassName %>Props = Omit<
   };
 };
 <%_ } else if (cedarPolicy) { _%>
-export type <%- nameClassName %>Props = Omit<AgentCoreGatewayProps, 'cedarPolicyPath' | 'protocol'>;
+export type <%- nameClassName %>Props = Omit<<%= coreGatewayProps %>, 'cedarPolicyPath' | 'protocol'>;
 <%_ } else { _%>
-export type <%- nameClassName %>Props = Omit<AgentCoreGatewayProps, 'protocol'>;
+export type <%- nameClassName %>Props = Omit<<%= coreGatewayProps %>, 'protocol'>;
 <%_ } _%>
 
 /**
@@ -44,7 +48,7 @@ export type <%- nameClassName %>Props = Omit<AgentCoreGatewayProps, 'protocol'>;
  * at synth time and attached to a PolicyEngine running in ENFORCE mode.
 <%_ } _%>
  */
-export class <%- nameClassName %> extends AgentCoreGateway {
+export class <%- nameClassName %> extends <%= coreGateway %> {
   /** Default Gateway target name when added to another Gateway. */
   public readonly gatewayName = '<%- nameKebabCase %>';
 
@@ -81,7 +85,7 @@ export class <%- nameClassName %> extends AgentCoreGateway {
     const rc = RuntimeConfig.ensure(this);
     rc.set('agentcore', 'gateways', {
       ...rc.get('agentcore').gateways,
-      <%- nameClassName %>: this.gateway.gatewayUrl,
+      <%- nameClassName %>: this.gatewayUrl,
     });
   }
 }

package/src/utils/agent-core-constructs/files/cdk/core/agentcore-gateway/agentcore-gateway.ts.template

@@ -279,6 +279,18 @@ export class AgentCoreGateway extends Construct implements iam.IGrantable {
     return webAcl;
   }
 
+  /**
+   * The gateway's URL endpoint. The Gateway L2 types its own `gatewayUrl` as
+   * optional and only populates it when created from its own props, so fall
+   * back to the CloudFormation attribute.
+   */
+  public get gatewayUrl(): string {
+    return (
+      this.gateway.gatewayUrl ??
+      (this.gateway.node.defaultChild as agentcore.CfnGateway).attrGatewayUrl
+    );
+  }
+
   /**
    * The principal to grant permissions to.
    */
@@ -395,6 +407,7 @@ export class AgentCoreGateway extends Construct implements iam.IGrantable {
     gateway: Construct & {
       readonly gateway: agentcore.Gateway;
       readonly gatewayName: string;
+      readonly gatewayUrl: string;
     },
     props?: {
       gatewayTargetName?: string;
@@ -402,12 +415,7 @@ export class AgentCoreGateway extends Construct implements iam.IGrantable {
   ): agentcore.CfnGatewayTarget {
     const target = this.addGatewayTarget({
       gatewayTargetName: props?.gatewayTargetName ?? gateway.gatewayName,
-      // The Gateway L2 only populates gatewayUrl when created from its own
-      // props; fall back to the CloudFormation attribute otherwise.
-      gatewayUrl:
-        gateway.gateway.gatewayUrl ??
-        (gateway.gateway.node.defaultChild as agentcore.CfnGateway)
-          .attrGatewayUrl,
+      gatewayUrl: gateway.gatewayUrl,
       gatewayArn: gateway.gateway.gatewayArn,
     });
     // AgentCore fetches the target gateway's tools during target creation,

package/src/utils/agent-core-packaging.js

@@ -4,7 +4,7 @@
  */ import { joinPathFragments } from "@nx/devkit";
 import { forDependencies } from "./declared-dependencies.js";
 import { FS_DEPENDENCIES, FsCommands } from "./fs.js";
-import { addArtifactDependencyToTargets } from "./nx.js";
+import { addArtifactDependencyToTargets, normalizeTargetKeyOrder } from "./nx.js";
 import { agentCoreRuntime, TS_VERSIONS } from "./versions.js";
 /**
  * How an AgentCore Runtime's artifact is packaged and hosted.
@@ -93,7 +93,7 @@ import { agentCoreRuntime, TS_VERSIONS } from "./versions.js";
             parallel: false
         }
     };
-    project.targets[targetName] = {
+    project.targets[targetName] = normalizeTargetKeyOrder({
         cache: true,
         inputs: [
             'default'
@@ -115,7 +115,7 @@ import { agentCoreRuntime, TS_VERSIONS } from "./versions.js";
             bundleTargetName,
             ADOT_VENDOR_TARGET_NAME
         ]
-    };
+    });
     addArtifactDependencyToTargets(project, targetName);
 };
 /**
@@ -137,7 +137,7 @@ import { agentCoreRuntime, TS_VERSIONS } from "./versions.js";
     const { project, targetName, bundleTargetName, bundleOutputDir, packageOutputDir, sourceRoot, moduleName, entryPointPath, entryPointFileName } = options;
     const fs = new FsCommands(tree, forDependencies(declaration));
     project.targets ??= {};
-    project.targets[targetName] = {
+    project.targets[targetName] = normalizeTargetKeyOrder({
         cache: true,
         inputs: [
             'production',
@@ -160,7 +160,7 @@ import { agentCoreRuntime, TS_VERSIONS } from "./versions.js";
         dependsOn: [
             bundleTargetName
         ]
-    };
+    });
     addArtifactDependencyToTargets(project, targetName);
 };