@aws/nx-plugin 1.0.0-rc.22 → 1.0.0-rc.24

package/src/py/agent/gateway-connection/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/nx-plugin/src/py/agent/gateway-connection/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/py/agent/gateway-connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  type GeneratorCallback,\n  generateFiles,\n  installPackagesTask,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { readAgentCoreGatewayMetadata } from '../../../agentcore-gateway/generator';\nimport {\n  addPythonCoreClient,\n  addPythonReExport,\n  ensurePythonAgentConnectionProject,\n  getPythonAgentConnectionModuleName,\n  getPythonAgentConnectionProject,\n  getPythonAgentConnectionProjectDir,\n  PY_MCP_FAMILY_CONNECTIONS,\n  resolveAgentFramework,\n} from '../../../utils/agent-connection/agent-connection';\nimport { addPythonDestructuredImport } from '../../../utils/ast';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { snakeCase } from '../../../utils/names';\nimport {\n  addDependencyToTargetIfNotPresent,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport {\n  addDependenciesToPyProjectToml,\n  addWorkspaceDependencyToPyProject,\n} from '../../../utils/py';\nimport type { PyAgentGatewayConnectionGeneratorSchema } from './schema';\n\nexport const PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport const pyAgentGatewayConnectionGenerator = async (\n  tree: Tree,\n  options: PyAgentGatewayConnectionGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const sourceProject = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const targetProject = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  const agentComponent = options.sourceComponent;\n  if (!agentComponent) {\n    throw new Error(\n      'sourceComponent must be provided for py#agent -> agentcore-gateway connections',\n    );\n  }\n  const gateway = readAgentCoreGatewayMetadata(targetProject);\n\n  if (gateway.protocol !== 'mcp') {\n    throw new Error(\n      `Gateway '${gateway.name}' has protocol='${gateway.protocol}'. Only MCP-protocol gateways are supported.`,\n    );\n  }\n  if (gateway.auth !== 'iam') {\n    throw new Error(\n      `Gateway '${gateway.name}' uses auth='${gateway.auth}'. Only IAM-authenticated gateways are supported in v1.`,\n    );\n  }\n  if (agentComponent.auth && agentComponent.auth !== 'iam') {\n    throw new Error(\n      `Agent '${agentComponent.name}' uses auth='${agentComponent.auth}'. Only IAM-authenticated agents can connect to IAM gateways.`,\n    );\n  }\n\n  const gatewayClassName = gateway.rc;\n  const gatewaySnakeCase = snakeCase(gatewayClassName);\n  // A gateway is its own standalone project, so it exposes plain serve / dev.\n  const gatewayServeTargetName = 'serve';\n  const gatewayDevTargetName = 'dev';\n\n  // The source agent's framework selects the client shape, dependencies and the\n  // agent.py transform — see PY_MCP_FAMILY_CONNECTIONS (keyed by framework, not a\n  // boolean, so a third framework is an additive entry there). A Gateway exposes\n  // its tools over MCP, so it reuses the same wiring as an MCP server connection.\n  const framework = resolveAgentFramework(agentComponent.framework);\n  const connection = PY_MCP_FAMILY_CONNECTIONS[framework];\n\n  await ensurePythonAgentConnectionProject(tree);\n  await addPythonCoreClient(tree, 'gateway', framework);\n\n  const agentConnectionProjectDir = getPythonAgentConnectionProjectDir(tree);\n  const agentConnectionModuleName = getPythonAgentConnectionModuleName(tree);\n\n  // Shared MCP transport + signed httpx auth deps, plus whatever extra deps the\n  // framework's MCP client needs (e.g. langchain-mcp-adapters for LangChain).\n  addDependenciesToPyProjectToml(tree, agentConnectionProjectDir, [\n    'boto3',\n    'httpx',\n    'mcp',\n    ...connection.deps,\n  ]);\n\n  const appDir = joinPathFragments(\n    agentConnectionProjectDir,\n    agentConnectionModuleName,\n    'app',\n  );\n  // Local mode points at the gateway project's local gateway port.\n  generateFiles(\n    tree,\n    joinPathFragments(\n      import.meta.dirname,\n      'files',\n      connection.appTemplateSubdir,\n    ),\n    appDir,\n    {\n      gatewaySnakeCase,\n      gatewayClassName,\n      agentConnectionModuleName,\n      gatewayPort: gateway.port,\n    },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  const appInitPath = joinPathFragments(appDir, '__init__.py');\n  if (!tree.exists(appInitPath)) {\n    tree.write(appInitPath, '');\n  }\n\n  const moduleInitPath = joinPathFragments(\n    agentConnectionProjectDir,\n    agentConnectionModuleName,\n    '__init__.py',\n  );\n  await addPythonReExport(\n    tree,\n    moduleInitPath,\n    `.app.${gatewaySnakeCase}_client_${connection.clientModuleSuffix}`,\n    `${gatewayClassName}Client${connection.clientClassSuffix}`,\n  );\n\n  const agentSourceDir = joinPathFragments(\n    sourceProject.root,\n    agentComponent.path ?? 'src',\n  );\n  const agentFilePath = joinPathFragments(agentSourceDir, 'agent.py');\n\n  if (tree.exists(agentFilePath)) {\n    const clientClassName = `${gatewayClassName}Client${connection.clientClassSuffix}`;\n    const clientVarName = gatewaySnakeCase;\n\n    await addPythonDestructuredImport(\n      tree,\n      agentFilePath,\n      [clientClassName],\n      agentConnectionModuleName,\n    );\n    await connection.wireClientIntoAgent(\n      tree,\n      agentFilePath,\n      clientClassName,\n      clientVarName,\n    );\n  }\n\n  addWorkspaceDependencyToPyProject(\n    tree,\n    sourceProject,\n    getPythonAgentConnectionProject(tree),\n  );\n\n  const agentName = agentComponent.name ?? 'agent';\n  const serveTargetName = `${agentName}-serve`;\n  const devTargetName = `${agentName}-dev`;\n  let projectConfigChanged = false;\n  if (sourceProject.targets?.[serveTargetName]) {\n    addDependencyToTargetIfNotPresent(sourceProject, serveTargetName, {\n      projects: [targetProject.name],\n      target: gatewayServeTargetName,\n    });\n    projectConfigChanged = true;\n  }\n  if (sourceProject.targets?.[devTargetName]) {\n    addDependencyToTargetIfNotPresent(sourceProject, devTargetName, {\n      projects: [targetProject.name],\n      target: gatewayDevTargetName,\n    });\n    projectConfigChanged = true;\n  }\n  if (projectConfigChanged) {\n    updateProjectConfiguration(tree, sourceProject.name, sourceProject);\n  }\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () => {\n    installPackagesTask(tree);\n  };\n};\n\nexport default pyAgentGatewayConnectionGenerator;\n"],"names":["generateFiles","installPackagesTask","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","readAgentCoreGatewayMetadata","addPythonCoreClient","addPythonReExport","ensurePythonAgentConnectionProject","getPythonAgentConnectionModuleName","getPythonAgentConnectionProject","getPythonAgentConnectionProjectDir","PY_MCP_FAMILY_CONNECTIONS","resolveAgentFramework","addPythonDestructuredImport","formatFilesInSubtree","addGeneratorMetricsIfApplicable","snakeCase","addDependencyToTargetIfNotPresent","getGeneratorInfo","readProjectConfigurationUnqualified","addDependenciesToPyProjectToml","addWorkspaceDependencyToPyProject","PY_AGENT_GATEWAY_CONNECTION_GENERATOR_INFO","filename","pyAgentGatewayConnectionGenerator","tree","options","sourceProject","targetProject","agentComponent","sourceComponent","Error","gateway","protocol","name","auth","gatewayClassName","rc","gatewaySnakeCase","gatewayServeTargetName","gatewayDevTargetName","framework","connection","agentConnectionProjectDir","agentConnectionModuleName","deps","appDir","dirname","appTemplateSubdir","gatewayPort","port","overwriteStrategy","KeepExisting","appInitPath","exists","write","moduleInitPath","clientModuleSuffix","clientClassSuffix","agentSourceDir","root","path","agentFilePath","clientClassName","clientVarName","wireClientIntoAgent","agentName","serveTargetName","devTargetName","projectConfigChanged","targets","projects","target"],"mappings":"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"}

package/src/py/agent/gateway-connection/schema.d.js

@@ -0,0 +1,6 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/py/agent/gateway-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/py/agent/gateway-connection/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { ComponentMetadata } from '../../../utils/nx';\n\nexport interface PyAgentGatewayConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAKC"}

package/src/py/agent/generator.js

@@ -1,37 +1,33 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pyAgentGenerator = exports.PY_AGENT_GENERATOR_INFO = void 0;
 /**
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
- */
-const devkit_1 = require("@nx/devkit");
-const config_1 = require("../../license/config");
-const known_exceptions_1 = require("../../license/known-exceptions");
-const agent_chat_1 = require("../../utils/agent-chat/agent-chat");
-const agent_connection_1 = require("../../utils/agent-connection/agent-connection");
-const agent_core_constructs_1 = require("../../utils/agent-core-constructs/agent-core-constructs");
-const bundle_1 = require("../../utils/bundle/bundle");
-const containers_1 = require("../../utils/containers");
-const format_1 = require("../../utils/format");
-const fs_1 = require("../../utils/fs");
-const git_1 = require("../../utils/git");
-const iac_1 = require("../../utils/iac");
-const metrics_1 = require("../../utils/metrics");
-const names_1 = require("../../utils/names");
-const npm_scope_1 = require("../../utils/npm-scope");
-const nx_1 = require("../../utils/nx");
-const nxlv_python_1 = require("../../utils/nxlv-python");
-const object_1 = require("../../utils/object");
-const paths_1 = require("../../utils/paths");
-const port_1 = require("../../utils/port");
-const py_1 = require("../../utils/py");
-const shared_constructs_1 = require("../../utils/shared-constructs");
-const versions_1 = require("../../utils/versions");
-exports.PY_AGENT_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const pyAgentGenerator = async (tree, options) => {
-    const project = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.project);
-    const pyProjectPath = (0, devkit_1.joinPathFragments)(project.root, 'pyproject.toml');
+ */ import { addDependenciesToPackageJson, generateFiles, installPackagesTask, joinPathFragments, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import { ensureLicenseExceptions } from "../../license/config.js";
+import { AG_UI_LANGGRAPH_EXCEPTIONS } from "../../license/known-exceptions.js";
+import { addAgentChatScripts } from "../../utils/agent-chat/agent-chat.js";
+import { addPythonFrameworkBase, ensurePythonAgentConnectionProject, getPythonAgentConnectionModuleName, getPythonAgentConnectionProject } from "../../utils/agent-connection/agent-connection.js";
+import { addAgentInfra } from "../../utils/agent-core-constructs/agent-core-constructs.js";
+import { addPythonBundleTarget } from "../../utils/bundle/bundle.js";
+import { resolveContainers } from "../../utils/containers.js";
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { FsCommands } from "../../utils/fs.js";
+import { updateGitIgnore } from "../../utils/git.js";
+import { resolveIac } from "../../utils/iac.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { kebabCase, toClassName, toSnakeCase } from "../../utils/names.js";
+import { getNpmScope } from "../../utils/npm-scope.js";
+import { addComponentDevTarget, addComponentGeneratorMetadata, addDependencyToTargetIfNotPresent, getGeneratorInfo, normalizeTargetKeyOrder, readProjectConfigurationUnqualified } from "../../utils/nx.js";
+import { Logger, UVProvider } from "../../utils/nxlv-python.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { toProjectRelativePath } from "../../utils/paths.js";
+import { assignPort } from "../../utils/port.js";
+import { addDependenciesToDependencyGroupInPyProjectToml, addDependenciesToPyProjectToml, addWorkspaceDependencyToPyProject } from "../../utils/py.js";
+import { sharedConstructsGenerator } from "../../utils/shared-constructs.js";
+import { withVersions } from "../../utils/versions.js";
+export const PY_AGENT_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const pyAgentGenerator = async (tree, options)=>{
+    const project = readProjectConfigurationUnqualified(tree, options.project);
+    const pyProjectPath = joinPathFragments(project.root, 'pyproject.toml');
     // Check if the project has a pyproject.toml file
     if (!pyProjectPath) {
         throw new Error(`Unsupported project ${options.project}. Expected a Python project (with a pyproject.toml)`);
@@ -42,11 +38,11 @@ const pyAgentGenerator = async (tree, options) => {
     // Module name is the last part of the source root,
     const sourceParts = project.sourceRoot.split('/');
     const moduleName = sourceParts[sourceParts.length - 1];
-    const name = (0, names_1.kebabCase)(options.name || `${(0, names_1.kebabCase)(project.name.split('.').pop())}-agent`);
+    const name = kebabCase(options.name || `${kebabCase(project.name.split('.').pop())}-agent`);
     const agentTargetPrefix = options.name ? name : 'agent';
-    const agentNameSnakeCase = (0, names_1.toSnakeCase)(options.name || 'agent');
-    const agentNameClassName = (0, names_1.toClassName)(name);
-    const targetSourceDir = (0, devkit_1.joinPathFragments)(project.sourceRoot, agentNameSnakeCase);
+    const agentNameSnakeCase = toSnakeCase(options.name || 'agent');
+    const agentNameClassName = toClassName(name);
+    const targetSourceDir = joinPathFragments(project.sourceRoot, agentNameSnakeCase);
     const infra = options.infra ?? 'agentcore';
     const protocol = options.protocol ?? 'http';
     const framework = options.framework ?? 'strands';
@@ -58,32 +54,35 @@ const pyAgentGenerator = async (tree, options) => {
     // point can import `session_id_context` and propagate the AgentCore
     // session ID to any downstream MCP / A2A clients a later connection
     // generator wires into this agent.
-    await (0, agent_connection_1.ensurePythonAgentConnectionProject)(tree);
+    await ensurePythonAgentConnectionProject(tree);
     // The agent server imports the framework base helpers (session cache + model
     // error logging) regardless of whether a connection client is wired in. The
     // langchain framework has no base layer (its AG-UI foundation reuses only the
     // framework-agnostic session context), so this is a no-op for langchain.
-    await (0, agent_connection_1.addPythonFrameworkBase)(tree, framework);
-    const agentConnectionModuleName = (0, agent_connection_1.getPythonAgentConnectionModuleName)(tree);
-    const agentConnectionPackageName = (0, agent_connection_1.getPythonAgentConnectionPackageName)(tree);
-    (0, py_1.addWorkspaceDependencyToPyProject)(tree, project.root, agentConnectionPackageName);
+    await addPythonFrameworkBase(tree, framework);
+    const agentConnectionModuleName = getPythonAgentConnectionModuleName(tree);
+    addWorkspaceDependencyToPyProject(tree, project, getPythonAgentConnectionProject(tree));
     const templateContext = {
         name,
         agentNameSnakeCase,
         agentNameClassName,
         moduleName,
         agentConnectionModuleName,
-        framework,
+        framework
     };
     // Generate common files shared by both protocols. The agent module (agent.py)
     // is framework-specific (Strands yields a contextmanaged Agent; LangChain
     // returns a compiled create_agent graph), so it comes from a per-framework
     // dir. The package __init__.py is framework-agnostic (it stays in `common`).
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', framework === 'langchain' ? 'common-langchain' : 'common'), targetSourceDir, templateContext, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', framework === 'langchain' ? 'common-langchain' : 'common'), targetSourceDir, templateContext, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
     if (framework === 'langchain') {
         // common-langchain only carries agent.py; the empty package __init__.py is
         // framework-agnostic, so emit it from the shared `common` dir.
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'common'), targetSourceDir, templateContext, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'common'), targetSourceDir, templateContext, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
     }
     // Generate protocol-specific files. Each protocol's server entry point is
     // framework-specific (Strands yields a contextmanaged Agent; LangChain drives
@@ -91,70 +90,76 @@ const pyAgentGenerator = async (tree, options) => {
     // `<protocol>-langchain` for LangChain, or `<protocol>` for Strands.
     const protocolLower = protocol.toLowerCase();
     const protocolTemplateDir = framework === 'langchain' ? `${protocolLower}-langchain` : protocolLower;
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', protocolTemplateDir), targetSourceDir, templateContext, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', protocolTemplateDir), targetSourceDir, templateContext, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
     // The HTTP server's init.py (the FastAPI app + JsonStreamingResponse) is
     // framework-agnostic and the LangChain http main.py reuses it, so emit it
     // from the shared `http` dir. Emitted after the langchain main.py above so
     // KeepExisting preserves that main.py and only adds init.py (the shared dir's
     // own Strands main.py is skipped).
     if (protocolLower === 'http' && framework === 'langchain') {
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'http'), targetSourceDir, templateContext, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'http'), targetSourceDir, templateContext, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
     }
-    (0, py_1.addDependenciesToPyProjectToml)(tree, project.root, [
+    addDependenciesToPyProjectToml(tree, project.root, [
         'aws-lambda-powertools',
         'aws-opentelemetry-distro',
         'bedrock-agentcore',
         'boto3',
         'fastapi',
         'mcp',
-        ...(framework === 'langchain'
-            ? // langchain pulls no Strands dependencies — the langchain model binding
-                // (langchain, langchain-aws, langgraph) plus the per-protocol server
-                // adapter: ag-ui-langgraph for AG-UI, a2a-sdk for A2A, nothing extra for
-                // HTTP (FastAPI is added above for every agent).
-                [
-                    'langchain',
-                    'langchain-aws',
-                    'langgraph',
-                    ...(protocol === 'ag-ui'
-                        ? ['ag-ui-protocol', 'ag-ui-langgraph']
-                        : protocol === 'a2a'
-                            ? ['a2a-sdk']
-                            : []),
-                ]
-            : protocol === 'a2a'
-                ? ['strands-agents[a2a]', 'strands-agents-tools']
-                : protocol === 'ag-ui'
-                    ? [
-                        'strands-agents',
-                        'strands-agents-tools',
-                        'ag-ui-protocol',
-                        'ag-ui-strands',
-                    ]
-                    : ['strands-agents', 'strands-agents-tools']),
-        'uvicorn',
+        ...framework === 'langchain' ? // (langchain, langchain-aws, langgraph) plus the per-protocol server
+        // adapter: ag-ui-langgraph for AG-UI, a2a-sdk for A2A, nothing extra for
+        // HTTP (FastAPI is added above for every agent).
+        [
+            'langchain',
+            'langchain-aws',
+            'langgraph',
+            ...protocol === 'ag-ui' ? [
+                'ag-ui-protocol',
+                'ag-ui-langgraph'
+            ] : protocol === 'a2a' ? [
+                'a2a-sdk'
+            ] : []
+        ] : protocol === 'a2a' ? [
+            'strands-agents[a2a]',
+            'strands-agents-tools'
+        ] : protocol === 'ag-ui' ? [
+            'strands-agents',
+            'strands-agents-tools',
+            'ag-ui-protocol',
+            'ag-ui-strands'
+        ] : [
+            'strands-agents',
+            'strands-agents-tools'
+        ],
+        'uvicorn'
     ]);
-    (0, py_1.addDependenciesToDependencyGroupInPyProjectToml)(tree, project.root, 'dev', [
-        'fastapi[standard]',
+    addDependenciesToDependencyGroupInPyProjectToml(tree, project.root, 'dev', [
+        'fastapi[standard]'
     ]);
     if (infra === 'agentcore') {
-        const containers = await (0, containers_1.resolveContainers)(tree, 'inherit');
-        const dockerImageTag = `${(0, npm_scope_1.getNpmScope)(tree)}-${name}:latest`;
+        const containers = await resolveContainers(tree, 'inherit');
+        const dockerImageTag = `${getNpmScope(tree)}-${name}:latest`;
         // Add bundle target
-        const { bundleTargetName, bundleOutputDir } = (0, bundle_1.addPythonBundleTarget)(project, {
-            pythonPlatform: 'aarch64-manylinux_2_28',
+        const { bundleTargetName, bundleOutputDir } = addPythonBundleTarget(project, {
+            pythonPlatform: 'aarch64-manylinux_2_28'
         });
         // Add the Dockerfile
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'deploy'), targetSourceDir, {
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'deploy'), targetSourceDir, {
             agentNameSnakeCase,
             moduleName,
             bundleOutputDir,
-            protocol,
-        }, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
-        const dockerOutputDir = (0, devkit_1.joinPathFragments)('dist', project.root, 'docker', name);
+            protocol
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
+        const dockerOutputDir = joinPathFragments('dist', project.root, 'docker', name);
         const dockerTargetName = `${agentTargetPrefix}-docker`;
         // Add a docker target that prepares the docker context and builds the image
-        const fs = new fs_1.FsCommands(tree);
+        const fs = new FsCommands(tree);
         project.targets[dockerTargetName] = {
             cache: true,
             executor: 'nx:run-commands',
@@ -164,21 +169,25 @@ const pyAgentGenerator = async (tree, options) => {
                     fs.mkdir(dockerOutputDir),
                     fs.cp(bundleOutputDir, dockerOutputDir),
                     fs.cp(`${targetSourceDir}/Dockerfile`, `${dockerOutputDir}/Dockerfile`),
-                    `${containers} build --platform linux/arm64 -t ${dockerImageTag} ${dockerOutputDir}`,
+                    `${containers} build --platform linux/arm64 -t ${dockerImageTag} ${dockerOutputDir}`
                 ],
-                parallel: false,
+                parallel: false
             },
-            dependsOn: [bundleTargetName],
+            dependsOn: [
+                bundleTargetName
+            ]
         };
-        (0, nx_1.addDependencyToTargetIfNotPresent)(project, 'docker', dockerTargetName);
-        (0, nx_1.addDependencyToTargetIfNotPresent)(project, 'build', 'docker');
+        addDependencyToTargetIfNotPresent(project, 'docker', dockerTargetName);
+        addDependencyToTargetIfNotPresent(project, 'build', 'docker');
         // Add shared constructs
-        const iac = await (0, iac_1.resolveIac)(tree, options.iac);
-        await (0, shared_constructs_1.sharedConstructsGenerator)(tree, { iac });
+        const iac = await resolveIac(tree, options.iac);
+        await sharedConstructsGenerator(tree, {
+            iac
+        });
         // Add the construct to deploy the agent.
         // AG-UI uses HTTP as the AgentCore protocol type (AG-UI is HTTP-based with SSE over POST).
         const infraProtocol = protocol === 'ag-ui' ? 'http' : protocol;
-        await (0, agent_core_constructs_1.addAgentInfra)(tree, {
+        await addAgentInfra(tree, {
             agentNameKebabCase: name,
             agentNameClassName,
             dockerImageTag,
@@ -187,14 +196,17 @@ const pyAgentGenerator = async (tree, options) => {
             projectName: project.name,
             auth,
             serverProtocol: infraProtocol,
-            containers,
+            containers
         });
     }
     // A2A servers use port 9000 as per the Strands A2A SDK default and AgentCore A2A contract.
     // HTTP and AG-UI agents use port 8081+ to avoid conflict with VS Code server on 8080.
     const localDevPortStart = protocol === 'a2a' ? 9000 : 8081;
-    const localDevPort = (0, port_1.assignPort)(tree, project, localDevPortStart, {
-        component: { info: exports.PY_AGENT_GENERATOR_INFO, name: agentTargetPrefix },
+    const localDevPort = assignPort(tree, project, localDevPortStart, {
+        component: {
+            info: PY_AGENT_GENERATOR_INFO,
+            name: agentTargetPrefix
+        }
     });
     // All protocols use fastapi dev for hot reload:
     // - HTTP: FastAPI app directly defined in init.py
@@ -207,146 +219,167 @@ const pyAgentGenerator = async (tree, options) => {
     // we can run `agent-chat-cli` directly as a binary.
     const openApiTargetName = `${agentTargetPrefix}-openapi`;
     const clientGenTargetName = `${agentTargetPrefix}-generate-client`;
-    const scriptsDir = (0, devkit_1.joinPathFragments)(project.root, 'scripts', agentTargetPrefix);
+    const scriptsDir = joinPathFragments(project.root, 'scripts', agentTargetPrefix);
     if (protocol === 'http') {
         // Emit the OpenAPI spec generator script (shared with react-connection)
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'react-connection', 'files', 'agent'), project.root, {
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'react-connection', 'files', 'agent'), project.root, {
             moduleName,
-            agentNameSnakeCase,
-        }, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+            agentNameSnakeCase
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
         // Ignore the generated client directory
-        (0, git_1.updateGitIgnore)(tree, project.root, (patterns) => [
-            ...patterns,
-            `scripts/${agentTargetPrefix}/generated/`,
-        ]);
+        updateGitIgnore(tree, project.root, (patterns)=>[
+                ...patterns,
+                `scripts/${agentTargetPrefix}/generated/`
+            ]);
     }
     // Every protocol gets a standalone `chat.ts`. It connects to the local
-    // `serve-local` server by default, or to the deployed agent (with the
+    // `dev` server by default, or to the deployed agent (with the
     // appropriate auth) when `RUNTIME_CONFIG_APP_ID` is set.
-    (0, agent_chat_1.addAgentChatScripts)(tree, {
+    addAgentChatScripts(tree, {
         scriptsDir,
         protocol,
         language: 'py',
         agentNameClassName,
-        auth,
+        auth
     });
     // TypeScript deps for the chat CLI, which runs standalone via tsx for every
     // protocol and resolves the deployed agent from AppConfig. `agent-chat-cli`
     // transitively bundles the protocol clients (@a2a-js/sdk, @ag-ui/client).
-    (0, devkit_1.addDependenciesToPackageJson)(tree, {}, (0, versions_1.withVersions)([
+    addDependenciesToPackageJson(tree, {}, withVersions([
         'agent-chat-cli',
         'tsx',
         '@types/node',
         '@aws-lambda-powertools/parameters',
         '@aws-sdk/client-appconfigdata',
-        ...(auth === 'iam'
-            ? ['aws4fetch', '@aws-sdk/credential-providers']
-            : []),
-        ...(protocol === 'a2a' ? ['@a2a-js/sdk'] : []),
+        ...auth === 'iam' ? [
+            'aws4fetch',
+            '@aws-sdk/credential-providers'
+        ] : [],
+        ...protocol === 'a2a' ? [
+            '@a2a-js/sdk'
+        ] : []
     ]));
-    const chatUrl = protocol === 'ag-ui'
-        ? `http://localhost:${localDevPort}/invocations`
-        : `http://localhost:${localDevPort}`;
+    const chatUrl = protocol === 'ag-ui' ? `http://localhost:${localDevPort}/invocations` : `http://localhost:${localDevPort}`;
     const chatCommand = `tsx ./scripts/${agentTargetPrefix}/chat.ts`;
-    const httpOnlyTargets = protocol === 'http'
-        ? {
-            [openApiTargetName]: {
-                cache: true,
-                executor: 'nx:run-commands',
-                outputs: [
-                    `{workspaceRoot}/dist/{projectRoot}/openapi/${agentNameSnakeCase}`,
+    const httpOnlyTargets = protocol === 'http' ? {
+        [openApiTargetName]: {
+            cache: true,
+            executor: 'nx:run-commands',
+            outputs: [
+                `{workspaceRoot}/dist/{projectRoot}/openapi/${agentNameSnakeCase}`
+            ],
+            options: {
+                commands: [
+                    `uv run python {projectRoot}/scripts/${agentNameSnakeCase}_openapi.py "dist/{projectRoot}/openapi/${agentNameSnakeCase}/openapi.json"`
+                ]
+            }
+        },
+        [clientGenTargetName]: {
+            cache: true,
+            executor: 'nx:run-commands',
+            dependsOn: [
+                openApiTargetName
+            ],
+            inputs: [
+                {
+                    dependentTasksOutputFiles: '**/*.json'
+                }
+            ],
+            outputs: [
+                `{projectRoot}/scripts/${agentTargetPrefix}/generated`
+            ],
+            options: {
+                commands: [
+                    `nx g @aws/nx-plugin:open-api#ts-client --openApiSpecPath="dist/${project.root}/openapi/${agentNameSnakeCase}/openapi.json" --outputPath="${project.root}/scripts/${agentTargetPrefix}/generated" --no-interactive`
+                ]
+            }
+        }
+    } : {};
+    const agentTargets = {
+        ...project.targets,
+        ...httpOnlyTargets,
+        [`${agentTargetPrefix}-serve`]: {
+            executor: 'nx:run-commands',
+            continuous: true,
+            options: {
+                commands: [
+                    serveCommand
                 ],
-                options: {
-                    commands: [
-                        `uv run python {projectRoot}/scripts/${agentNameSnakeCase}_openapi.py "dist/{projectRoot}/openapi/${agentNameSnakeCase}/openapi.json"`,
-                    ],
-                },
-            },
-            [clientGenTargetName]: {
-                cache: true,
-                executor: 'nx:run-commands',
-                inputs: [
-                    {
-                        dependentTasksOutputFiles: '**/*.json',
-                    },
+                cwd: '{projectRoot}',
+                env: {
+                    PORT: `${localDevPort}`
+                }
+            }
+        },
+        [`${agentTargetPrefix}-dev`]: {
+            executor: 'nx:run-commands',
+            continuous: true,
+            options: {
+                commands: [
+                    serveCommand
+                ],
+                cwd: '{projectRoot}',
+                env: {
+                    PORT: `${localDevPort}`,
+                    LOCAL_DEV: 'true'
+                }
+            }
+        },
+        // HTTP chat imports the generated client, so ensure it's built first.
+        // No dev dependency — chat runs standalone against a local or
+        // deployed agent. normalizeTargetKeyOrder keeps the conditional dependsOn
+        // in Nx 23's serialization order so re-runs stay byte-identical.
+        [`${agentTargetPrefix}-chat`]: normalizeTargetKeyOrder({
+            executor: 'nx:run-commands',
+            options: {
+                commands: [
+                    chatCommand
                 ],
-                outputs: [`{projectRoot}/scripts/${agentTargetPrefix}/generated`],
-                options: {
-                    commands: [
-                        `nx g @aws/nx-plugin:open-api#ts-client --openApiSpecPath="dist/${project.root}/openapi/${agentNameSnakeCase}/openapi.json" --outputPath="${project.root}/scripts/${agentTargetPrefix}/generated" --no-interactive`,
-                    ],
-                },
-                dependsOn: [openApiTargetName],
+                cwd: '{projectRoot}',
+                env: {
+                    URL: chatUrl
+                }
             },
-        }
-        : {};
-    (0, devkit_1.updateProjectConfiguration)(tree, project.name, {
+            ...protocol === 'http' ? {
+                dependsOn: [
+                    clientGenTargetName
+                ]
+            } : {}
+        })
+    };
+    // Aggregate `<agent>-dev` under the project-level `dev` target.
+    addComponentDevTarget(agentTargets, `${agentTargetPrefix}-dev`);
+    updateProjectConfiguration(tree, project.name, {
         ...project,
-        targets: (0, object_1.sortObjectKeys)({
-            ...project.targets,
-            ...httpOnlyTargets,
-            [`${agentTargetPrefix}-serve`]: {
-                executor: 'nx:run-commands',
-                options: {
-                    commands: [serveCommand],
-                    cwd: '{projectRoot}',
-                    env: {
-                        PORT: `${localDevPort}`,
-                    },
-                },
-                continuous: true,
-            },
-            [`${agentTargetPrefix}-serve-local`]: {
-                executor: 'nx:run-commands',
-                options: {
-                    commands: [serveCommand],
-                    cwd: '{projectRoot}',
-                    env: {
-                        PORT: `${localDevPort}`,
-                        SERVE_LOCAL: 'true',
-                    },
-                },
-                continuous: true,
-            },
-            [`${agentTargetPrefix}-chat`]: {
-                executor: 'nx:run-commands',
-                options: {
-                    commands: [chatCommand],
-                    cwd: '{projectRoot}',
-                    env: {
-                        URL: chatUrl,
-                    },
-                },
-                // HTTP chat imports the generated client, so ensure it's built first.
-                // No serve-local dependency — chat runs standalone against a local or
-                // deployed agent.
-                ...(protocol === 'http' ? { dependsOn: [clientGenTargetName] } : {}),
-            },
-        }),
+        targets: sortObjectKeys(agentTargets)
     });
-    (0, nx_1.addComponentGeneratorMetadata)(tree, project.name, exports.PY_AGENT_GENERATOR_INFO, (0, paths_1.toProjectRelativePath)(project, targetSourceDir), agentTargetPrefix, {
+    addComponentGeneratorMetadata(tree, project.name, PY_AGENT_GENERATOR_INFO, toProjectRelativePath(project, targetSourceDir), agentTargetPrefix, {
         port: localDevPort,
         rc: agentNameClassName,
         auth,
         protocol,
         // The mcp / gateway connection generators dispatch on this field to pick
         // the Strands vs LangChain Layer-2 client + agent.py transform.
-        framework,
+        framework
     });
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [exports.PY_AGENT_GENERATOR_INFO]);
+    await addGeneratorMetricsIfApplicable(tree, [
+        PY_AGENT_GENERATOR_INFO
+    ]);
     // langchain-core (pulled by every langchain agent regardless of protocol)
     // brings jsonpatch/jsonpointer, whose wheels ship without resolvable SPDX
     // license metadata, so register those exceptions so the workspace license
     // check still passes.
     if (framework === 'langchain') {
-        await (0, config_1.ensureLicenseExceptions)(tree, known_exceptions_1.AG_UI_LANGGRAPH_EXCEPTIONS);
+        await ensureLicenseExceptions(tree, AG_UI_LANGGRAPH_EXCEPTIONS);
     }
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return async () => {
-        (0, devkit_1.installPackagesTask)(tree);
-        await new nxlv_python_1.UVProvider(tree.root, new nxlv_python_1.Logger(), tree).install();
+    await formatFilesInSubtree(tree);
+    return async ()=>{
+        installPackagesTask(tree);
+        await new UVProvider(tree.root, new Logger(), tree).install();
     };
 };
-exports.pyAgentGenerator = pyAgentGenerator;
-exports.default = exports.pyAgentGenerator;
+export default pyAgentGenerator;
+
 //# sourceMappingURL=generator.js.map