@aws/nx-plugin 1.0.0-rc.23 → 1.0.0-rc.25

package/src/agentcore-gateway/generator.js

@@ -1,29 +1,26 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readAgentCoreGatewayMetadata = exports.agentcoreGatewayGenerator = exports.AGENTCORE_GATEWAY_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 agent_core_constructs_1 = require("../utils/agent-core-constructs/agent-core-constructs");
-const format_1 = require("../utils/format");
-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 port_1 = require("../utils/port");
-const shared_constructs_1 = require("../utils/shared-constructs");
-const versions_1 = require("../utils/versions");
-exports.AGENTCORE_GATEWAY_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const agentcoreGatewayGenerator = async (tree, options) => {
-    const name = (0, names_1.kebabCase)(options.name);
-    const nameClassName = (0, names_1.toClassName)(name);
+ */ import { addDependenciesToPackageJson, addProjectConfiguration, generateFiles, joinPathFragments, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import { addAgentCoreGatewayInfra } from "../utils/agent-core-constructs/agent-core-constructs.js";
+import { formatFilesInSubtree } from "../utils/format.js";
+import { resolveIac } from "../utils/iac.js";
+import { installDependencies } from "../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../utils/metrics.js";
+import { kebabCase, toClassName } from "../utils/names.js";
+import { getNpmScopePrefix } from "../utils/npm-scope.js";
+import { addGeneratorMetadata, getGeneratorInfo, projectExists, readProjectConfigurationUnqualified } from "../utils/nx.js";
+import { assignPort } from "../utils/port.js";
+import { sharedConstructsGenerator } from "../utils/shared-constructs.js";
+import { withVersions } from "../utils/versions.js";
+export const AGENTCORE_GATEWAY_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const agentcoreGatewayGenerator = async (tree, options)=>{
+    const name = kebabCase(options.name);
+    const nameClassName = toClassName(name);
     const parentDir = options.directory ?? 'packages';
     const subDir = options.subDirectory ?? name;
-    const projectRoot = (0, devkit_1.joinPathFragments)(parentDir, subDir);
-    const fullyQualifiedName = `${(0, npm_scope_1.getNpmScopePrefix)(tree)}${name}`;
+    const projectRoot = joinPathFragments(parentDir, subDir);
+    const fullyQualifiedName = `${getNpmScopePrefix(tree)}${name}`;
     // Protocol / auth are fixed to mcp / iam in v1 — the enums accept only
     // these values, but we still persist the resolved value in metadata so
     // that connection generators can read it uniformly (and future additions
@@ -32,30 +29,31 @@ const agentcoreGatewayGenerator = async (tree, options) => {
     const auth = options.auth ?? 'iam';
     const cedarPolicy = options.cedarPolicy ?? true;
     const infra = options.infra ?? 'agentcore';
-    // serve-local.ts is the local gateway: a continuous MCP aggregator chaining
-    // onto attached MCP servers' serve-local targets (added by the
-    // mcp-connection generator), so a single `nx run <agent>:<agent>-serve-local`
-    // boots the gateway and every attached MCP server together.
+    // local-dev.ts is the local gateway: a continuous MCP aggregator chaining
+    // onto attached MCP servers' dev targets (added by the mcp-connection
+    // generator), so a single `nx dev <gateway>` boots the gateway and every
+    // attached MCP server together.
     //
     // `serve` exists for parity with other generators; the deployed Gateway is
     // a managed AWS resource, so `serve`-mode agents talk to it via runtime
     // config and the local gateway sits idle.
-    const localGatewayTarget = (port) => ({
-        executor: 'nx:run-commands',
-        continuous: true,
-        options: {
-            command: 'tsx serve-local.ts',
-            cwd: '{projectRoot}',
-            env: { PORT: `${port}` },
-        },
-        dependsOn: [],
-    });
+    const localGatewayTarget = (port)=>({
+            executor: 'nx:run-commands',
+            continuous: true,
+            options: {
+                command: 'tsx local-dev.ts',
+                cwd: '{projectRoot}',
+                env: {
+                    PORT: `${port}`
+                }
+            },
+            dependsOn: []
+        });
     let project;
-    if ((0, nx_1.projectExists)(tree, fullyQualifiedName)) {
-        project = (0, nx_1.readProjectConfigurationUnqualified)(tree, fullyQualifiedName);
-    }
-    else {
-        (0, devkit_1.addProjectConfiguration)(tree, fullyQualifiedName, {
+    if (projectExists(tree, fullyQualifiedName)) {
+        project = readProjectConfigurationUnqualified(tree, fullyQualifiedName);
+    } else {
+        addProjectConfiguration(tree, fullyQualifiedName, {
             name: fullyQualifiedName,
             root: projectRoot,
             projectType: 'library',
@@ -63,67 +61,89 @@ const agentcoreGatewayGenerator = async (tree, options) => {
             tags: [],
             targets: {},
             metadata: {
-                generator: exports.AGENTCORE_GATEWAY_GENERATOR_INFO.id,
-            },
+                generator: AGENTCORE_GATEWAY_GENERATOR_INFO.id
+            }
         });
-        project = (0, nx_1.readProjectConfigurationUnqualified)(tree, fullyQualifiedName);
+        project = readProjectConfigurationUnqualified(tree, fullyQualifiedName);
     }
-    const port = (0, port_1.assignPort)(tree, project, 8100);
-    // Re-run: keep existing targets (their dependsOn may have been populated
-    // by the mcp-connection generator), just ensure both exist.
+    const port = assignPort(tree, project, 8100);
+    // A gateway is its own standalone project, so it uses plain `serve` / `dev`
+    // targets. Re-run: keep existing targets (their dependsOn may have been
+    // populated by the mcp-connection generator), just ensure both exist.
     project.targets ??= {};
-    project.targets[`${name}-serve`] ??= localGatewayTarget(port);
-    project.targets[`${name}-serve-local`] ??= localGatewayTarget(port);
-    (0, devkit_1.updateProjectConfiguration)(tree, project.name, project);
-    // Scaffold the gateway project: serve-local.ts (+ Cedar policies if requested)
-    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'project'), projectRoot, { nameClassName, nameKebabCase: name, port, attachedMcpServers: [] }, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+    project.targets['serve'] ??= localGatewayTarget(port);
+    project.targets['dev'] ??= localGatewayTarget(port);
+    updateProjectConfiguration(tree, project.name, project);
+    // Scaffold the gateway project: local-dev.ts (+ Cedar policies if requested)
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'project'), projectRoot, {
+        nameClassName,
+        nameKebabCase: name,
+        port,
+        attachedMcpServers: []
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
     if (cedarPolicy) {
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files', 'cedar'), projectRoot, { nameClassName }, { overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting });
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'cedar'), projectRoot, {
+            nameClassName
+        }, {
+            overwriteStrategy: OverwriteStrategy.KeepExisting
+        });
     }
-    (0, nx_1.addGeneratorMetadata)(tree, fullyQualifiedName, exports.AGENTCORE_GATEWAY_GENERATOR_INFO, {
+    addGeneratorMetadata(tree, fullyQualifiedName, AGENTCORE_GATEWAY_GENERATOR_INFO, {
         name,
         rc: nameClassName,
         protocol,
         auth,
-        port,
+        port
     });
-    // serve-local.ts dependencies (+ ejs for Cedar policy rendering in the
+    // local-dev.ts dependencies (+ ejs for Cedar policy rendering in the
     // shared gateway construct)
-    (0, devkit_1.addDependenciesToPackageJson)(tree, (0, versions_1.withVersions)(['@modelcontextprotocol/sdk', 'express']), (0, versions_1.withVersions)(['tsx', '@types/express', 'ejs', '@types/ejs']));
+    addDependenciesToPackageJson(tree, withVersions([
+        '@modelcontextprotocol/sdk',
+        'express'
+    ]), withVersions([
+        'tsx',
+        '@types/express',
+        'ejs',
+        '@types/ejs'
+    ]));
     // Wire up infra (CDK or Terraform); re-running with infra=agentcore adds
     // the infrastructure to a previously infra-less gateway.
     if (infra === 'agentcore') {
-        const iac = await (0, iac_1.resolveIac)(tree, options.iac);
-        await (0, shared_constructs_1.sharedConstructsGenerator)(tree, { iac });
-        await (0, agent_core_constructs_1.addAgentCoreGatewayInfra)(tree, {
+        const iac = await resolveIac(tree, options.iac);
+        await sharedConstructsGenerator(tree, {
+            iac
+        });
+        await addAgentCoreGatewayInfra(tree, {
             gatewayNameClassName: nameClassName,
             gatewayNameKebabCase: name,
             projectName: fullyQualifiedName,
             projectDirectory: projectRoot,
             cedarPolicy,
-            iac,
+            iac
         });
     }
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [
-        exports.AGENTCORE_GATEWAY_GENERATOR_INFO,
+    await addGeneratorMetricsIfApplicable(tree, [
+        AGENTCORE_GATEWAY_GENERATOR_INFO
     ]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        (0, devkit_1.installPackagesTask)(tree);
-    };
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 };
-exports.agentcoreGatewayGenerator = agentcoreGatewayGenerator;
 /**
  * Read a gateway project's metadata, validating it was generated by the
  * agentcore-gateway generator.
- */
-const readAgentCoreGatewayMetadata = (project) => {
+ */ export const readAgentCoreGatewayMetadata = (project)=>{
     const metadata = project.metadata;
-    if (metadata?.generator !== exports.AGENTCORE_GATEWAY_GENERATOR_INFO.id) {
-        throw new Error(`Project '${project.name}' was not generated by the '${exports.AGENTCORE_GATEWAY_GENERATOR_INFO.id}' generator.`);
+    if (metadata?.generator !== AGENTCORE_GATEWAY_GENERATOR_INFO.id) {
+        throw new Error(`Project '${project.name}' was not generated by the '${AGENTCORE_GATEWAY_GENERATOR_INFO.id}' generator.`);
     }
     return metadata;
 };
-exports.readAgentCoreGatewayMetadata = readAgentCoreGatewayMetadata;
-exports.default = exports.agentcoreGatewayGenerator;
+export default agentcoreGatewayGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/agentcore-gateway/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/agentcore-gateway/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-gateway/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  addDependenciesToPackageJson,\n  addProjectConfiguration,\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { addAgentCoreGatewayInfra } from '../utils/agent-core-constructs/agent-core-constructs';\nimport { formatFilesInSubtree } from '../utils/format';\nimport { resolveIac } from '../utils/iac';\nimport { installDependencies } from '../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../utils/metrics';\nimport { kebabCase, toClassName } from '../utils/names';\nimport { getNpmScopePrefix } from '../utils/npm-scope';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\nimport { assignPort } from '../utils/port';\nimport { sharedConstructsGenerator } from '../utils/shared-constructs';\nimport { withVersions } from '../utils/versions';\nimport type { AgentcoreGatewayGeneratorSchema } from './schema';\n\nexport const AGENTCORE_GATEWAY_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport const agentcoreGatewayGenerator = async (\n  tree: Tree,\n  options: AgentcoreGatewayGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const name = kebabCase(options.name);\n  const nameClassName = toClassName(name);\n  const parentDir = options.directory ?? 'packages';\n  const subDir = options.subDirectory ?? name;\n  const projectRoot = joinPathFragments(parentDir, subDir);\n  const fullyQualifiedName = `${getNpmScopePrefix(tree)}${name}`;\n\n  // Protocol / auth are fixed to mcp / iam in v1 — the enums accept only\n  // these values, but we still persist the resolved value in metadata so\n  // that connection generators can read it uniformly (and future additions\n  // are non-breaking).\n  const protocol = options.protocol ?? 'mcp';\n  const auth = options.auth ?? 'iam';\n  const cedarPolicy = options.cedarPolicy ?? true;\n  const infra = options.infra ?? 'agentcore';\n\n  // local-dev.ts is the local gateway: a continuous MCP aggregator chaining\n  // onto attached MCP servers' dev targets (added by the mcp-connection\n  // generator), so a single `nx dev <gateway>` boots the gateway and every\n  // attached MCP server together.\n  //\n  // `serve` exists for parity with other generators; the deployed Gateway is\n  // a managed AWS resource, so `serve`-mode agents talk to it via runtime\n  // config and the local gateway sits idle.\n  const localGatewayTarget = (port: number) => ({\n    executor: 'nx:run-commands' as const,\n    continuous: true,\n    options: {\n      command: 'tsx local-dev.ts',\n      cwd: '{projectRoot}',\n      env: { PORT: `${port}` },\n    },\n    dependsOn: [] as Array<string | { projects: string[]; target: string }>,\n  });\n  let project: ProjectConfiguration;\n  if (projectExists(tree, fullyQualifiedName)) {\n    project = readProjectConfigurationUnqualified(tree, fullyQualifiedName);\n  } else {\n    addProjectConfiguration(tree, fullyQualifiedName, {\n      name: fullyQualifiedName,\n      root: projectRoot,\n      projectType: 'library',\n      sourceRoot: projectRoot,\n      tags: [],\n      targets: {},\n      metadata: {\n        generator: AGENTCORE_GATEWAY_GENERATOR_INFO.id,\n      } as any,\n    });\n    project = readProjectConfigurationUnqualified(tree, fullyQualifiedName);\n  }\n  const port = assignPort(tree, project, 8100);\n  // A gateway is its own standalone project, so it uses plain `serve` / `dev`\n  // targets. Re-run: keep existing targets (their dependsOn may have been\n  // populated by the mcp-connection generator), just ensure both exist.\n  project.targets ??= {};\n  project.targets['serve'] ??= localGatewayTarget(port);\n  project.targets['dev'] ??= localGatewayTarget(port);\n  updateProjectConfiguration(tree, project.name, project);\n\n  // Scaffold the gateway project: local-dev.ts (+ Cedar policies if requested)\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'project'),\n    projectRoot,\n    { nameClassName, nameKebabCase: name, port, attachedMcpServers: [] },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n  if (cedarPolicy) {\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files', 'cedar'),\n      projectRoot,\n      { nameClassName },\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  addGeneratorMetadata(\n    tree,\n    fullyQualifiedName,\n    AGENTCORE_GATEWAY_GENERATOR_INFO,\n    {\n      name,\n      rc: nameClassName,\n      protocol,\n      auth,\n      port,\n    },\n  );\n\n  // local-dev.ts dependencies (+ ejs for Cedar policy rendering in the\n  // shared gateway construct)\n  addDependenciesToPackageJson(\n    tree,\n    withVersions(['@modelcontextprotocol/sdk', 'express']),\n    withVersions(['tsx', '@types/express', 'ejs', '@types/ejs']),\n  );\n\n  // Wire up infra (CDK or Terraform); re-running with infra=agentcore adds\n  // the infrastructure to a previously infra-less gateway.\n  if (infra === 'agentcore') {\n    const iac = await resolveIac(tree, options.iac);\n    await sharedConstructsGenerator(tree, { iac });\n\n    await addAgentCoreGatewayInfra(tree, {\n      gatewayNameClassName: nameClassName,\n      gatewayNameKebabCase: name,\n      projectName: fullyQualifiedName,\n      projectDirectory: projectRoot,\n      cedarPolicy,\n      iac,\n    });\n  }\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    AGENTCORE_GATEWAY_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\n/**\n * Gateway details stored in the gateway project's metadata.\n */\nexport interface AgentCoreGatewayMetadata {\n  name: string;\n  rc: string;\n  protocol: string;\n  auth: string;\n  port: number;\n}\n\n/**\n * Read a gateway project's metadata, validating it was generated by the\n * agentcore-gateway generator.\n */\nexport const readAgentCoreGatewayMetadata = (\n  project: ProjectConfiguration,\n): AgentCoreGatewayMetadata => {\n  const metadata = project.metadata as any;\n  if (metadata?.generator !== AGENTCORE_GATEWAY_GENERATOR_INFO.id) {\n    throw new Error(\n      `Project '${project.name}' was not generated by the '${AGENTCORE_GATEWAY_GENERATOR_INFO.id}' generator.`,\n    );\n  }\n  return metadata as AgentCoreGatewayMetadata;\n};\n\nexport default agentcoreGatewayGenerator;\n"],"names":["addDependenciesToPackageJson","addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","addAgentCoreGatewayInfra","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","readProjectConfigurationUnqualified","assignPort","sharedConstructsGenerator","withVersions","AGENTCORE_GATEWAY_GENERATOR_INFO","filename","agentcoreGatewayGenerator","tree","options","name","nameClassName","parentDir","directory","subDir","subDirectory","projectRoot","fullyQualifiedName","protocol","auth","cedarPolicy","infra","localGatewayTarget","port","executor","continuous","command","cwd","env","PORT","dependsOn","project","root","projectType","sourceRoot","tags","targets","metadata","generator","id","dirname","nameKebabCase","attachedMcpServers","overwriteStrategy","KeepExisting","rc","iac","gatewayNameClassName","gatewayNameKebabCase","projectName","projectDirectory","preferInstallDependencies","languages","readAgentCoreGatewayMetadata","Error"],"mappings":"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"}

package/src/agentcore-gateway/mcp-connection/generator.d.ts

@@ -2,15 +2,15 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type GeneratorCallback, type Tree } from '@nx/devkit';
+import type { GeneratorCallback, Tree } from '@nx/devkit';
 import { type NxGeneratorInfo } from '../../utils/nx';
 import type { AgentcoreGatewayMcpConnectionGeneratorSchema } from './schema';
 export declare const AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO: NxGeneratorInfo;
 /**
  * Connect an AgentCore Gateway to an MCP server.
  *
- * Chains the gateway's serve-local target to the MCP server's serve-local
- * target, and registers the server in the gateway's local serve-local.ts so
+ * Chains the gateway's dev target to the MCP server's dev
+ * target, and registers the server in the gateway's local local-dev.ts so
  * the local gateway aggregates its tools. Users must still call
  * `gateway.addMcpServer(...)` in their application stack to create the
  * actual CDK/Terraform resource.

package/src/agentcore-gateway/mcp-connection/generator.js

@@ -1,31 +1,26 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentcoreGatewayMcpConnectionGenerator = exports.AGENTCORE_GATEWAY_MCP_CONNECTION_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 format_1 = require("../../utils/format");
-const metrics_1 = require("../../utils/metrics");
-const names_1 = require("../../utils/names");
-const nx_1 = require("../../utils/nx");
-const attach_upstream_1 = require("../attach-upstream");
-const generator_1 = require("../generator");
-exports.AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
+ */ import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { kebabCase } from "../../utils/names.js";
+import { getGeneratorInfo, readProjectConfigurationUnqualified } from "../../utils/nx.js";
+import { attachUpstreamToLocalGateway } from "../attach-upstream.js";
+import { readAgentCoreGatewayMetadata } from "../generator.js";
+export const AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
 /**
  * Connect an AgentCore Gateway to an MCP server.
  *
- * Chains the gateway's serve-local target to the MCP server's serve-local
- * target, and registers the server in the gateway's local serve-local.ts so
+ * Chains the gateway's dev target to the MCP server's dev
+ * target, and registers the server in the gateway's local local-dev.ts so
  * the local gateway aggregates its tools. Users must still call
  * `gateway.addMcpServer(...)` in their application stack to create the
  * actual CDK/Terraform resource.
- */
-const agentcoreGatewayMcpConnectionGenerator = async (tree, options) => {
-    const sourceProject = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.sourceProject);
-    const targetProject = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.targetProject);
-    const gateway = (0, generator_1.readAgentCoreGatewayMetadata)(sourceProject);
+ */ export const agentcoreGatewayMcpConnectionGenerator = async (tree, options)=>{
+    const sourceProject = readProjectConfigurationUnqualified(tree, options.sourceProject);
+    const targetProject = readProjectConfigurationUnqualified(tree, options.targetProject);
+    const gateway = readAgentCoreGatewayMetadata(sourceProject);
     const mcpComponent = options.targetComponent;
     if (!mcpComponent) {
         throw new Error(`Target project '${options.targetProject}' has no MCP server component metadata. Did you run the 'ts#mcp-server' or 'py#mcp-server' generator?`);
@@ -36,28 +31,29 @@ const agentcoreGatewayMcpConnectionGenerator = async (tree, options) => {
     if (mcpComponent.auth && mcpComponent.auth !== 'iam') {
         throw new Error(`MCP server '${mcpComponent.name}' uses auth='${mcpComponent.auth}'. Gateway->MCP connections currently require the MCP server to use IAM authentication.`);
     }
-    const gatewayServeLocalTargetName = `${(0, names_1.kebabCase)(gateway.rc)}-serve-local`;
     // The target name must match what the deployed Gateway uses
     // (`mcpServerName` on the MCP construct, derived from the project's class
     // name) so `<target>___<tool>` resolves identically locally and deployed.
     // Component-level `name` would clash whenever two MCP server projects
     // both default to `mcp-server`.
-    const mcpTargetName = (0, names_1.kebabCase)(mcpComponent.rc);
+    const mcpTargetName = kebabCase(mcpComponent.rc);
     const mcpComponentName = mcpComponent.name ?? 'mcp-server';
-    await (0, attach_upstream_1.attachUpstreamToLocalGateway)(tree, sourceProject, gatewayServeLocalTargetName, {
+    await attachUpstreamToLocalGateway(tree, sourceProject, 'dev', {
         targetName: mcpTargetName,
         port: mcpComponent.port ?? 8000,
         upstreamProjectName: targetProject.name,
-        upstreamServeLocalTargetName: `${mcpComponentName}-serve-local`,
+        upstreamDevTargetName: `${mcpComponentName}-dev`
     });
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [
-        exports.AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO,
+    await addGeneratorMetricsIfApplicable(tree, [
+        AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO
     ]);
-    await (0, format_1.formatFilesInSubtree)(tree);
-    return () => {
-        (0, devkit_1.installPackagesTask)(tree);
-    };
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
 };
-exports.agentcoreGatewayMcpConnectionGenerator = agentcoreGatewayMcpConnectionGenerator;
-exports.default = exports.agentcoreGatewayMcpConnectionGenerator;
+export default agentcoreGatewayMcpConnectionGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/agentcore-gateway/mcp-connection/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/mcp-connection/generator.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,uCAIoB;AACpB,+CAA0D;AAC1D,iDAAsE;AACtE,6CAA8C;AAC9C,uCAIwB;AACxB,wDAAkE;AAClE,4CAA4D;AAG/C,QAAA,+CAA+C,GAC1D,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAE/B;;;;;;;;GAQG;AACI,MAAM,sCAAsC,GAAG,KAAK,EACzD,IAAU,EACV,OAAqD,EACzB,EAAE;IAC9B,MAAM,aAAa,GAAG,IAAA,wCAAmC,EACvD,IAAI,EACJ,OAAO,CAAC,aAAa,CACtB,CAAC;IACF,MAAM,aAAa,GAAG,IAAA,wCAAmC,EACvD,IAAI,EACJ,OAAO,CAAC,aAAa,CACtB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAA,wCAA4B,EAAC,aAAa,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAE7C,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,mBAAmB,OAAO,CAAC,aAAa,uGAAuG,CAChJ,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,CAAC,IAAI,mBAAmB,OAAO,CAAC,QAAQ,sEAAsE,CAClI,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,eAAe,YAAY,CAAC,IAAI,gBAAgB,YAAY,CAAC,IAAI,yFAAyF,CAC3J,CAAC;IACJ,CAAC;IAED,MAAM,2BAA2B,GAAG,GAAG,IAAA,iBAAS,EAAC,OAAO,CAAC,EAAE,CAAC,cAAc,CAAC;IAE3E,4DAA4D;IAC5D,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,gCAAgC;IAChC,MAAM,aAAa,GAAG,IAAA,iBAAS,EAAC,YAAY,CAAC,EAAY,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC;IAE3D,MAAM,IAAA,8CAA4B,EAChC,IAAI,EACJ,aAAa,EACb,2BAA2B,EAC3B;QACE,UAAU,EAAE,aAAa;QACzB,IAAI,EAAG,YAAY,CAAC,IAA2B,IAAI,IAAI;QACvD,mBAAmB,EAAE,aAAa,CAAC,IAAI;QACvC,4BAA4B,EAAE,GAAG,gBAAgB,cAAc;KAChE,CACF,CAAC;IAEF,MAAM,IAAA,yCAA+B,EAAC,IAAI,EAAE;QAC1C,uDAA+C;KAChD,CAAC,CAAC;IAEH,MAAM,IAAA,6BAAoB,EAAC,IAAI,CAAC,CAAC;IAEjC,OAAO,GAAG,EAAE;QACV,IAAA,4BAAmB,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC,CAAC;AAhEW,QAAA,sCAAsC,0CAgEjD;AAEF,kBAAe,8CAAsC,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/mcp-connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { GeneratorCallback, Tree } from '@nx/devkit';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport { kebabCase } from '../../utils/names';\nimport {\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx';\nimport { attachUpstreamToLocalGateway } from '../attach-upstream';\nimport { readAgentCoreGatewayMetadata } from '../generator';\nimport type { AgentcoreGatewayMcpConnectionGeneratorSchema } from './schema';\n\nexport const AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\n/**\n * Connect an AgentCore Gateway to an MCP server.\n *\n * Chains the gateway's dev target to the MCP server's dev\n * target, and registers the server in the gateway's local local-dev.ts so\n * the local gateway aggregates its tools. Users must still call\n * `gateway.addMcpServer(...)` in their application stack to create the\n * actual CDK/Terraform resource.\n */\nexport const agentcoreGatewayMcpConnectionGenerator = async (\n  tree: Tree,\n  options: AgentcoreGatewayMcpConnectionGeneratorSchema,\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 gateway = readAgentCoreGatewayMetadata(sourceProject);\n  const mcpComponent = options.targetComponent;\n\n  if (!mcpComponent) {\n    throw new Error(\n      `Target project '${options.targetProject}' has no MCP server component metadata. Did you run the 'ts#mcp-server' or 'py#mcp-server' generator?`,\n    );\n  }\n\n  if (gateway.protocol !== 'mcp') {\n    throw new Error(\n      `Gateway '${gateway.name}' has protocol='${gateway.protocol}'. MCP server targets can only be attached to MCP-protocol gateways.`,\n    );\n  }\n  if (mcpComponent.auth && mcpComponent.auth !== 'iam') {\n    throw new Error(\n      `MCP server '${mcpComponent.name}' uses auth='${mcpComponent.auth}'. Gateway->MCP connections currently require the MCP server to use IAM authentication.`,\n    );\n  }\n\n  // The target name must match what the deployed Gateway uses\n  // (`mcpServerName` on the MCP construct, derived from the project's class\n  // name) so `<target>___<tool>` resolves identically locally and deployed.\n  // Component-level `name` would clash whenever two MCP server projects\n  // both default to `mcp-server`.\n  const mcpTargetName = kebabCase(mcpComponent.rc as string);\n  const mcpComponentName = mcpComponent.name ?? 'mcp-server';\n\n  await attachUpstreamToLocalGateway(tree, sourceProject, 'dev', {\n    targetName: mcpTargetName,\n    port: (mcpComponent.port as number | undefined) ?? 8000,\n    upstreamProjectName: targetProject.name,\n    upstreamDevTargetName: `${mcpComponentName}-dev`,\n  });\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default agentcoreGatewayMcpConnectionGenerator;\n"],"names":["formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","getGeneratorInfo","readProjectConfigurationUnqualified","attachUpstreamToLocalGateway","readAgentCoreGatewayMetadata","AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO","filename","agentcoreGatewayMcpConnectionGenerator","tree","options","sourceProject","targetProject","gateway","mcpComponent","targetComponent","Error","protocol","name","auth","mcpTargetName","rc","mcpComponentName","targetName","port","upstreamProjectName","upstreamDevTargetName","preferInstallDependencies","languages"],"mappings":"AAAA;;;CAGC,GAED,SAASA,oBAAoB,QAAQ,wBAAqB;AAC1D,SAASC,mBAAmB,QAAQ,yBAAsB;AAC1D,SAASC,+BAA+B,QAAQ,yBAAsB;AACtE,SAASC,SAAS,QAAQ,uBAAoB;AAC9C,SACEC,gBAAgB,EAEhBC,mCAAmC,QAC9B,oBAAiB;AACxB,SAASC,4BAA4B,QAAQ,wBAAqB;AAClE,SAASC,4BAA4B,QAAQ,kBAAe;AAG5D,OAAO,MAAMC,kDACXJ,iBAAiB,YAAYK,QAAQ,EAAE;AAEzC;;;;;;;;CAQC,GACD,OAAO,MAAMC,yCAAyC,OACpDC,MACAC;IAEA,MAAMC,gBAAgBR,oCACpBM,MACAC,QAAQC,aAAa;IAEvB,MAAMC,gBAAgBT,oCACpBM,MACAC,QAAQE,aAAa;IAGvB,MAAMC,UAAUR,6BAA6BM;IAC7C,MAAMG,eAAeJ,QAAQK,eAAe;IAE5C,IAAI,CAACD,cAAc;QACjB,MAAM,IAAIE,MACR,CAAC,gBAAgB,EAAEN,QAAQE,aAAa,CAAC,qGAAqG,CAAC;IAEnJ;IAEA,IAAIC,QAAQI,QAAQ,KAAK,OAAO;QAC9B,MAAM,IAAID,MACR,CAAC,SAAS,EAAEH,QAAQK,IAAI,CAAC,gBAAgB,EAAEL,QAAQI,QAAQ,CAAC,oEAAoE,CAAC;IAErI;IACA,IAAIH,aAAaK,IAAI,IAAIL,aAAaK,IAAI,KAAK,OAAO;QACpD,MAAM,IAAIH,MACR,CAAC,YAAY,EAAEF,aAAaI,IAAI,CAAC,aAAa,EAAEJ,aAAaK,IAAI,CAAC,uFAAuF,CAAC;IAE9J;IAEA,4DAA4D;IAC5D,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,gCAAgC;IAChC,MAAMC,gBAAgBnB,UAAUa,aAAaO,EAAE;IAC/C,MAAMC,mBAAmBR,aAAaI,IAAI,IAAI;IAE9C,MAAMd,6BAA6BK,MAAME,eAAe,OAAO;QAC7DY,YAAYH;QACZI,MAAM,AAACV,aAAaU,IAAI,IAA2B;QACnDC,qBAAqBb,cAAcM,IAAI;QACvCQ,uBAAuB,GAAGJ,iBAAiB,IAAI,CAAC;IAClD;IAEA,MAAMtB,gCAAgCS,MAAM;QAC1CH;KACD;IAED,MAAMR,qBAAqBW;IAE3B,OAAO,IACLV,oBAAoBU,MAAMC,QAAQiB,yBAAyB,EAAE;YAC3DC,WAAW;gBAAC;aAAa;QAC3B;AACJ,EAAE;AAEF,eAAepB,uCAAuC"}

package/src/agentcore-gateway/mcp-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/agentcore-gateway/mcp-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/mcp-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 AgentcoreGatewayMcpConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAMC"}

package/src/agentcore-gateway/mcp-connection/schema.d.ts

@@ -9,4 +9,5 @@ export interface AgentcoreGatewayMcpConnectionGeneratorSchema {
   targetProject: string;
   sourceComponent?: ComponentMetadata;
   targetComponent?: ComponentMetadata;
+  preferInstallDependencies?: boolean;
 }

package/src/agentcore-gateway/mcp-connection/schema.json

@@ -20,6 +20,11 @@
     "targetComponent": {
       "type": "string",
       "description": "The MCP server component in the target project"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["sourceProject", "targetProject"]

package/src/agentcore-gateway/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/agentcore-gateway/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-gateway/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 { IacOption } from '../utils/iac';\n\nexport interface AgentcoreGatewayGeneratorSchema {\n  name: string;\n  directory?: string;\n  subDirectory?: string;\n  protocol?: 'mcp';\n  auth?: 'iam';\n  cedarPolicy?: boolean;\n  infra?: 'agentcore' | 'none';\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAUC"}

package/src/agentcore-gateway/schema.d.ts

@@ -13,4 +13,5 @@ export interface AgentcoreGatewayGeneratorSchema {
   cedarPolicy?: boolean;
   infra?: 'agentcore' | 'none';
   iac: IacOption;
+  preferInstallDependencies?: boolean;
 }

package/src/agentcore-gateway/schema.json

@@ -59,6 +59,11 @@
       "x-priority": "important",
       "default": "inherit",
       "x-prompt": "Which provider would you like to manage your infrastructure? (default: inherit)"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["name"]

package/src/bin/aws-nx-mcp.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { startMcpServer } from "../mcp-server/index.js";
+void (async ()=>{
+    try {
+        await startMcpServer();
+    } catch (e) {
+        console.error(e);
+    }
+})();
+
+//# sourceMappingURL=aws-nx-mcp.js.map

package/src/bin/aws-nx-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/bin/aws-nx-mcp.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { startMcpServer } from '../mcp-server';\n\nvoid (async () => {\n  try {\n    await startMcpServer();\n  } catch (e) {\n    console.error(e);\n  }\n})();\n"],"names":["startMcpServer","e","console","error"],"mappings":";AACA;;;CAGC,GACD,SAASA,cAAc,QAAQ,yBAAgB;AAE/C,KAAK,AAAC,CAAA;IACJ,IAAI;QACF,MAAMA;IACR,EAAE,OAAOC,GAAG;QACVC,QAAQC,KAAK,CAACF;IAChB;AACF,CAAA"}

package/src/connection/{agent-serve-local.d.ts → agent-local-dev.d.ts}

@@ -4,7 +4,7 @@
  */
 import { type Tree } from '@nx/devkit';
 import { type ComponentMetadata } from '../utils/nx';
-export interface AgentServeLocalOptions {
+export interface AgentLocalDevOptions {
     agentNameClassName: string;
     port: number;
     targetComponent?: ComponentMetadata;
@@ -18,16 +18,16 @@ export interface AgentServeLocalOptions {
      */
     localUrl: string;
     /**
-     * Additional targets to add as serve-local dependencies.
+     * Additional targets to add as dev dependencies.
      */
     additionalDependencyTargets?: string[];
 }
 /**
- * Adds a Strands Agent's component serve-local target as a dependency of the
- * source project's serve-local target, and updates the RuntimeConfig provider
+ * Adds a Strands Agent's component dev target as a dependency of the
+ * source project's dev target, and updates the RuntimeConfig provider
  * to point to the agent's local URL.
  *
  * This is the shared implementation used by both Python and TypeScript Strands
  * Agent react-connection generators.
  */
-export declare const addAgentTargetToServeLocal: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: AgentServeLocalOptions) => Promise<void>;
+export declare const addAgentTargetToLocalDev: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: AgentLocalDevOptions) => Promise<void>;

package/src/connection/agent-local-dev.js

@@ -0,0 +1,42 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { joinPathFragments, updateProjectConfiguration } from "@nx/devkit";
+import { applyGritQL } from "../utils/ast.js";
+import { addDependencyToTargetIfNotPresent, readProjectConfigurationUnqualified } from "../utils/nx.js";
+/**
+ * Adds a Strands Agent's component dev target as a dependency of the
+ * source project's dev target, and updates the RuntimeConfig provider
+ * to point to the agent's local URL.
+ *
+ * This is the shared implementation used by both Python and TypeScript Strands
+ * Agent react-connection generators.
+ */ export const addAgentTargetToLocalDev = async (tree, sourceProjectName, targetProjectName, options)=>{
+    const sourceProject = readProjectConfigurationUnqualified(tree, sourceProjectName);
+    const targetProject = readProjectConfigurationUnqualified(tree, targetProjectName);
+    // Determine the dev target name for the agent component
+    const agentDevTargetName = options.targetComponent?.name ? `${options.targetComponent.name}-dev` : 'agent-dev';
+    // Target project must have the agent dev target which is continuous
+    if (!(targetProject.targets?.[agentDevTargetName]?.continuous && sourceProject.targets?.['dev'])) {
+        return;
+    }
+    // Add a dependency on the agent dev target (so that the agent's
+    // own dev dependencies, such as MCP servers, are also started)
+    addDependencyToTargetIfNotPresent(sourceProject, 'dev', {
+        projects: [
+            targetProject.name
+        ],
+        target: agentDevTargetName
+    });
+    for (const additional of options.additionalDependencyTargets ?? []){
+        addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);
+    }
+    updateProjectConfiguration(tree, sourceProject.name, sourceProject);
+    // Add an override to runtime-config for the dev target to use the local url
+    const runtimeConfigProvider = joinPathFragments(sourceProject.root, 'src', 'components', 'RuntimeConfig', 'index.tsx');
+    if (tree.exists(runtimeConfigProvider)) {
+        await applyGritQL(tree, runtimeConfigProvider, `\`if ($cond) { $stmts }\` => raw\`if ($cond) {\n    $stmts\n    runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName} = '${options.localUrl}';\n  }\` where { $cond <: contains \`'local-dev'\`, $stmts <: within \`const applyOverrides = $_\`, $stmts <: not contains \`runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName}\` }`);
+    }
+};
+
+//# sourceMappingURL=agent-local-dev.js.map

package/src/connection/agent-local-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/agent-local-dev.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applyGritQL } from '../utils/ast';\nimport {\n  addDependencyToTargetIfNotPresent,\n  type ComponentMetadata,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\n\nexport interface AgentLocalDevOptions {\n  agentNameClassName: string;\n  port: number;\n  targetComponent?: ComponentMetadata;\n  /**\n   * The runtime config namespace to set the local URL on.\n   * E.g. 'apis' results in `runtimeConfig.apis.X = url`\n   */\n  runtimeConfigNamespace: string;\n  /**\n   * The local URL to set in the runtime config override.\n   */\n  localUrl: string;\n  /**\n   * Additional targets to add as dev dependencies.\n   */\n  additionalDependencyTargets?: string[];\n}\n\n/**\n * Adds a Strands Agent's component dev target as a dependency of the\n * source project's dev target, and updates the RuntimeConfig provider\n * to point to the agent's local URL.\n *\n * This is the shared implementation used by both Python and TypeScript Strands\n * Agent react-connection generators.\n */\nexport const addAgentTargetToLocalDev = async (\n  tree: Tree,\n  sourceProjectName: string,\n  targetProjectName: string,\n  options: AgentLocalDevOptions,\n) => {\n  const sourceProject = readProjectConfigurationUnqualified(\n    tree,\n    sourceProjectName,\n  );\n  const targetProject = readProjectConfigurationUnqualified(\n    tree,\n    targetProjectName,\n  );\n\n  // Determine the dev target name for the agent component\n  const agentDevTargetName = options.targetComponent?.name\n    ? `${options.targetComponent.name}-dev`\n    : 'agent-dev';\n\n  // Target project must have the agent dev target which is continuous\n  if (\n    !(\n      targetProject.targets?.[agentDevTargetName]?.continuous &&\n      sourceProject.targets?.['dev']\n    )\n  ) {\n    return;\n  }\n\n  // Add a dependency on the agent dev target (so that the agent's\n  // own dev dependencies, such as MCP servers, are also started)\n  addDependencyToTargetIfNotPresent(sourceProject, 'dev', {\n    projects: [targetProject.name],\n    target: agentDevTargetName,\n  });\n  for (const additional of options.additionalDependencyTargets ?? []) {\n    addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);\n  }\n  updateProjectConfiguration(tree, sourceProject.name, sourceProject);\n\n  // Add an override to runtime-config for the dev target to use the local url\n  const runtimeConfigProvider = joinPathFragments(\n    sourceProject.root,\n    'src',\n    'components',\n    'RuntimeConfig',\n    'index.tsx',\n  );\n  if (tree.exists(runtimeConfigProvider)) {\n    await applyGritQL(\n      tree,\n      runtimeConfigProvider,\n      `\\`if ($cond) { $stmts }\\` => raw\\`if ($cond) {\\n    $stmts\\n    runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName} = '${options.localUrl}';\\n  }\\` where { $cond <: contains \\`'local-dev'\\`, $stmts <: within \\`const applyOverrides = $_\\`, $stmts <: not contains \\`runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName}\\` }`,\n    );\n  }\n};\n"],"names":["joinPathFragments","updateProjectConfiguration","applyGritQL","addDependencyToTargetIfNotPresent","readProjectConfigurationUnqualified","addAgentTargetToLocalDev","tree","sourceProjectName","targetProjectName","options","sourceProject","targetProject","agentDevTargetName","targetComponent","name","targets","continuous","projects","target","additional","additionalDependencyTargets","runtimeConfigProvider","root","exists","runtimeConfigNamespace","agentNameClassName","localUrl"],"mappings":"AAAA;;;CAGC,GACD,SACEA,iBAAiB,EAEjBC,0BAA0B,QACrB,aAAa;AACpB,SAASC,WAAW,QAAQ,kBAAe;AAC3C,SACEC,iCAAiC,EAEjCC,mCAAmC,QAC9B,iBAAc;AAqBrB;;;;;;;CAOC,GACD,OAAO,MAAMC,2BAA2B,OACtCC,MACAC,mBACAC,mBACAC;IAEA,MAAMC,gBAAgBN,oCACpBE,MACAC;IAEF,MAAMI,gBAAgBP,oCACpBE,MACAE;IAGF,wDAAwD;IACxD,MAAMI,qBAAqBH,QAAQI,eAAe,EAAEC,OAChD,GAAGL,QAAQI,eAAe,CAACC,IAAI,CAAC,IAAI,CAAC,GACrC;IAEJ,oEAAoE;IACpE,IACE,CACEH,CAAAA,cAAcI,OAAO,EAAE,CAACH,mBAAmB,EAAEI,cAC7CN,cAAcK,OAAO,EAAE,CAAC,MAAM,AAAD,GAE/B;QACA;IACF;IAEA,gEAAgE;IAChE,+DAA+D;IAC/DZ,kCAAkCO,eAAe,OAAO;QACtDO,UAAU;YAACN,cAAcG,IAAI;SAAC;QAC9BI,QAAQN;IACV;IACA,KAAK,MAAMO,cAAcV,QAAQW,2BAA2B,IAAI,EAAE,CAAE;QAClEjB,kCAAkCO,eAAe,OAAOS;IAC1D;IACAlB,2BAA2BK,MAAMI,cAAcI,IAAI,EAAEJ;IAErD,4EAA4E;IAC5E,MAAMW,wBAAwBrB,kBAC5BU,cAAcY,IAAI,EAClB,OACA,cACA,iBACA;IAEF,IAAIhB,KAAKiB,MAAM,CAACF,wBAAwB;QACtC,MAAMnB,YACJI,MACAe,uBACA,CAAC,8EAA8E,EAAEZ,QAAQe,sBAAsB,CAAC,CAAC,EAAEf,QAAQgB,kBAAkB,CAAC,IAAI,EAAEhB,QAAQiB,QAAQ,CAAC,4IAA4I,EAAEjB,QAAQe,sBAAsB,CAAC,CAAC,EAAEf,QAAQgB,kBAAkB,CAAC,IAAI,CAAC;IAEzX;AACF,EAAE"}