@aws/nx-plugin 1.0.0-rc.7 → 1.0.0-rc.71

package/src/py/agent/react-connection/generator.js

@@ -1,81 +1,99 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pyAgentReactConnectionGenerator = exports.PY_AGENT_REACT_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 agent_runtime_config_1 = require("../../../connection/agent-runtime-config");
-const generator_1 = require("../../../ts/react-website/agui/generator");
-const react_1 = require("../../../utils/connection/open-api/react");
-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 object_1 = require("../../../utils/object");
-const serve_local_1 = require("./serve-local");
-exports.PY_AGENT_REACT_CONNECTION_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-const pyAgentReactConnectionGenerator = async (tree, options) => {
-    const frontendProjectConfig = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.sourceProject);
-    const agentProjectConfig = (0, nx_1.readProjectConfigurationUnqualified)(tree, options.targetProject);
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import { addAgentRuntimeToConnectionNamespace } from "../../../connection/agent-runtime-config.js";
+import { DEPENDENCIES as AGUI_DEPENDENCIES, addAgUiReactConnection, resolveAgUiTheme } from "../../../ts/react-website/agui/generator.js";
+import { addOpenApiReactClient, OPEN_API_REACT_DEPENDENCIES } from "../../../utils/connection/open-api/react.js";
+import { declareDependencies, onlyWhen } from "../../../utils/declared-dependencies.js";
+import { formatFilesInSubtree } from "../../../utils/format.js";
+import { installDependencies } from "../../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../../utils/metrics.js";
+import { kebabCase, toClassName, toSnakeCase } from "../../../utils/names.js";
+import { addComponentGeneratorMetadata, addDependencyToTargetIfNotPresent, getGeneratorInfo, readProjectConfigurationUnqualified } from "../../../utils/nx.js";
+import { sortObjectKeys } from "../../../utils/object.js";
+import { toProjectRelativePath } from "../../../utils/paths.js";
+import { addPyAgentTargetToLocalDev, openApiClientLocalDevDeps } from "./local-dev.js";
+/** The OpenAPI-over-HTTP path, which the AG-UI path takes none of. */ const isHttp = (m)=>m.protocol !== 'ag-ui';
+/** The AG-UI path, whose packages `addAgUiReactConnection` adds. */ const isAgUi = (m)=>!isHttp(m);
+// Each entry names the protocol path it belongs to: the HTTP path's OpenAPI
+// client packages are added by `addOpenApiReactClient`, the AG-UI path's by
+// `addAgUiReactConnection`, both on this generator's behalf. The AG-UI entries
+// keep their own theme and auth conditions, which the metadata below records.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        ...onlyWhen(OPEN_API_REACT_DEPENDENCIES, isHttp),
+        ...onlyWhen(AGUI_DEPENDENCIES.ts, isAgUi)
+    ]
+});
+export const PY_AGENT_REACT_CONNECTION_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const pyAgentReactConnectionGenerator = async (tree, options)=>{
+    const frontendProjectConfig = readProjectConfigurationUnqualified(tree, options.sourceProject);
+    const agentProjectConfig = readProjectConfigurationUnqualified(tree, options.targetProject);
     const targetComponent = options.targetComponent;
     // Extract agent metadata from the target component or project metadata
     const metadata = agentProjectConfig.metadata;
     const agentName = targetComponent?.name ?? 'agent';
-    const agentNameClassName = targetComponent?.rc ?? (0, names_1.toClassName)(agentName);
+    const agentNameClassName = targetComponent?.rc ?? toClassName(agentName);
     const agentPort = targetComponent?.port ?? metadata?.ports?.[0] ?? 8081;
-    const auth = (targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();
+    // Behind a gateway the browser authenticates with the gateway, not the agent.
+    const auth = (options.gatewayRoute?.gatewayAuth ?? targetComponent?.auth ?? metadata?.auth ?? 'iam').toLowerCase();
     const protocol = (targetComponent?.protocol ?? 'http').toLowerCase();
+    // Recorded below and read by the declaration's predicates, so the packages
+    // added here are exactly the ones the version sync will own.
+    const connectionMetadata = {
+        protocol,
+        auth,
+        theme: resolveAgUiTheme(frontendProjectConfig)
+    };
     if (protocol === 'a2a') {
-        throw new Error(`Cannot connect a React website to an A2A agent. ` +
-            `Consider generating an agent with the HTTP or AG-UI protocol instead.`);
+        throw new Error(`Cannot connect a React website to an A2A agent. ` + `Consider generating an agent with the HTTP or AG-UI protocol instead.`);
     }
-    let additionalServeLocalDeps = [];
+    let additionalLocalDevDeps = [];
     if (protocol === 'ag-ui') {
-        await (0, generator_1.addAgUiReactConnection)(tree, {
+        await addAgUiReactConnection(tree, {
             frontendProjectConfig,
             agentName,
             agentNameClassName,
             auth: auth,
+            gatewayRoute: options.gatewayRoute
         });
-    }
-    else {
+    } else {
         const moduleName = getModuleName(agentProjectConfig);
-        const agentNameSnakeCase = (0, names_1.toSnakeCase)(agentName);
+        const agentNameSnakeCase = toSnakeCase(agentName);
         const agentTargetPrefix = targetComponent?.name ? agentName : 'agent';
         // Add OpenAPI spec generation script scoped to this agent
-        (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, 'files/agent'), agentProjectConfig.root, {
+        generateFiles(tree, joinPathFragments(import.meta.dirname, 'files/agent'), agentProjectConfig.root, {
             moduleName,
-            agentNameSnakeCase,
+            agentNameSnakeCase
         }, {
-            overwriteStrategy: devkit_1.OverwriteStrategy.KeepExisting,
+            overwriteStrategy: OverwriteStrategy.KeepExisting
         });
         // Instrument the OpenAPI spec generation as a target on the agent project
         const openApiTargetName = `${agentTargetPrefix}-openapi`;
-        const openApiDist = (0, devkit_1.joinPathFragments)('dist', agentProjectConfig.root, 'openapi', agentNameSnakeCase);
-        const specPath = (0, devkit_1.joinPathFragments)(openApiDist, 'openapi.json');
-        (0, devkit_1.updateProjectConfiguration)(tree, agentProjectConfig.name, {
+        const openApiDist = joinPathFragments('dist', agentProjectConfig.root, 'openapi', agentNameSnakeCase);
+        const specPath = joinPathFragments(openApiDist, 'openapi.json');
+        updateProjectConfiguration(tree, agentProjectConfig.name, {
             ...agentProjectConfig,
-            targets: (0, object_1.sortObjectKeys)({
+            targets: sortObjectKeys({
                 ...agentProjectConfig.targets,
                 [openApiTargetName]: {
                     cache: true,
                     executor: 'nx:run-commands',
                     outputs: [
-                        `{workspaceRoot}/dist/{projectRoot}/openapi/${agentNameSnakeCase}`,
+                        `{workspaceRoot}/dist/{projectRoot}/openapi/${agentNameSnakeCase}`
                     ],
                     options: {
                         commands: [
-                            `uv run python {projectRoot}/scripts/${agentNameSnakeCase}_openapi.py "dist/{projectRoot}/openapi/${agentNameSnakeCase}/openapi.json"`,
-                        ],
-                    },
-                },
-            }),
+                            `uv run python {projectRoot}/scripts/${agentNameSnakeCase}_openapi.py "dist/{projectRoot}/openapi/${agentNameSnakeCase}/openapi.json"`
+                        ]
+                    }
+                }
+            })
         });
         // Use the shared OpenAPI react client utility for hooks, providers, and build targets.
-        // Serve-local is handled separately below using the agent-specific serve-local target.
-        await (0, react_1.addOpenApiReactClient)(tree, {
+        // The dev target is handled separately below using the agent-specific dev target.
+        await addOpenApiReactClient(tree, {
             apiName: agentNameClassName,
             frontendProjectConfig,
             backendProjectConfig: agentProjectConfig,
@@ -85,43 +103,65 @@ const pyAgentReactConnectionGenerator = async (tree, options) => {
             auth,
             port: agentPort,
             isAgentRuntime: true,
-            skipServeLocal: true,
-        });
-        additionalServeLocalDeps = (0, serve_local_1.openApiClientServeLocalDeps)(agentNameClassName);
+            gatewayRoute: options.gatewayRoute,
+            skipLocalDev: true
+        }, DEPENDENCIES);
+        additionalLocalDevDeps = openApiClientLocalDevDeps(agentNameClassName);
         // HTTP only — the AG-UI branch handles this inside addAgUiReactConnection.
         // Agent constructs publish their runtime ARN to the 'agentcore' namespace
         // by default, which isn't exposed to the website; patch them to also
-        // publish under 'connection' so the browser can read it.
-        await (0, agent_runtime_config_1.addAgentRuntimeToConnectionNamespace)(tree, {
-            agentNameKebabCase: (0, names_1.kebabCase)(agentNameClassName),
+        // publish under 'connection' so the browser can read it. When routing via
+        // a gateway, the gateway publishes its own URL instead.
+        if (!options.gatewayRoute) {
+            await addAgentRuntimeToConnectionNamespace(tree, {
+                agentNameKebabCase: kebabCase(agentNameClassName),
+                agentNameClassName
+            });
+        }
+    }
+    if (options.gatewayRoute) {
+        // The gateway react-connection wires the website's dev target to the
+        // local gateway (which proxies to the agent); only the OpenAPI client
+        // generation targets are still needed here.
+        if (additionalLocalDevDeps.length > 0) {
+            const websiteConfig = readProjectConfigurationUnqualified(tree, frontendProjectConfig.name);
+            if (websiteConfig.targets?.['dev']) {
+                for (const additional of additionalLocalDevDeps){
+                    addDependencyToTargetIfNotPresent(websiteConfig, 'dev', additional);
+                }
+                updateProjectConfiguration(tree, websiteConfig.name, websiteConfig);
+            }
+        }
+    } else {
+        await addPyAgentTargetToLocalDev(tree, frontendProjectConfig.name, agentProjectConfig.name, {
+            agentName,
             agentNameClassName,
+            port: agentPort,
+            targetComponent,
+            additionalDependencyTargets: additionalLocalDevDeps
         });
     }
-    await (0, serve_local_1.addPyAgentTargetToServeLocal)(tree, frontendProjectConfig.name, agentProjectConfig.name, {
-        agentName,
-        agentNameClassName,
-        port: agentPort,
-        targetComponent,
-        additionalDependencyTargets: additionalServeLocalDeps,
-    });
-    await (0, metrics_1.addGeneratorMetricsIfApplicable)(tree, [
-        exports.PY_AGENT_REACT_CONNECTION_GENERATOR_INFO,
+    // Recorded so the version sync knows this connection's dependencies are ours.
+    addComponentGeneratorMetadata(tree, frontendProjectConfig.name, PY_AGENT_REACT_CONNECTION_GENERATOR_INFO, toProjectRelativePath(frontendProjectConfig, protocol === 'ag-ui' ? joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks', `useAgui${agentNameClassName}`) : joinPathFragments(frontendProjectConfig.sourceRoot, 'components', `${agentNameClassName}Provider`)), agentNameClassName, connectionMetadata);
+    await addGeneratorMetricsIfApplicable(tree, [
+        PY_AGENT_REACT_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.pyAgentReactConnectionGenerator = pyAgentReactConnectionGenerator;
 /**
  * Determine the Python module name from the project configuration
- */
-const getModuleName = (projectConfig) => {
+ */ const getModuleName = (projectConfig)=>{
     if (projectConfig.sourceRoot) {
         const sourceRootParts = projectConfig.sourceRoot.split('/');
         return sourceRootParts[sourceRootParts.length - 1];
     }
     throw new Error(`Could not determine sourceRoot for project ${projectConfig.name}`);
 };
-exports.default = exports.pyAgentReactConnectionGenerator;
+export default pyAgentReactConnectionGenerator;
+
 //# sourceMappingURL=generator.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/nx-plugin/src/py/agent/react-connection/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/py/agent/react-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  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config';\nimport type { ResolvedConnectionOptions } from '../../../connection/generator';\nimport type { AgentGatewayRoute } from '../../../ts/agent/react-connection/generator';\nimport {\n  DEPENDENCIES as AGUI_DEPENDENCIES,\n  type AgUiAuth,\n  addAgUiReactConnection,\n  resolveAgUiTheme,\n} from '../../../ts/react-website/agui/generator';\nimport {\n  addOpenApiReactClient,\n  OPEN_API_REACT_DEPENDENCIES,\n} from '../../../utils/connection/open-api/react';\nimport {\n  declareDependencies,\n  onlyWhen,\n} from '../../../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { kebabCase, toClassName, toSnakeCase } from '../../../utils/names';\nimport {\n  addComponentGeneratorMetadata,\n  addDependencyToTargetIfNotPresent,\n  type ComponentMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { sortObjectKeys } from '../../../utils/object';\nimport { toProjectRelativePath } from '../../../utils/paths';\nimport {\n  addPyAgentTargetToLocalDev,\n  openApiClientLocalDevDeps,\n} from './local-dev';\n\n/** The metadata this generator records, which its predicates read. */\nexport interface PyAgentReactConnectionMetadata {\n  readonly protocol: string;\n  readonly auth: string;\n  /** The AG-UI theme module, which the website's `ux` selects. */\n  readonly theme: string;\n}\n\n/** The OpenAPI-over-HTTP path, which the AG-UI path takes none of. */\nconst isHttp = (m: PyAgentReactConnectionMetadata) => m.protocol !== 'ag-ui';\n\n/** The AG-UI path, whose packages `addAgUiReactConnection` adds. */\nconst isAgUi = (m: PyAgentReactConnectionMetadata) => !isHttp(m);\n\n// Each entry names the protocol path it belongs to: the HTTP path's OpenAPI\n// client packages are added by `addOpenApiReactClient`, the AG-UI path's by\n// `addAgUiReactConnection`, both on this generator's behalf. The AG-UI entries\n// keep their own theme and auth conditions, which the metadata below records.\nexport const DEPENDENCIES =\n  declareDependencies<PyAgentReactConnectionMetadata>()({\n    ts: [\n      ...onlyWhen(OPEN_API_REACT_DEPENDENCIES, isHttp),\n      ...onlyWhen(AGUI_DEPENDENCIES.ts, isAgUi),\n    ],\n  });\n\nexport const PY_AGENT_REACT_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport const pyAgentReactConnectionGenerator = async (\n  tree: Tree,\n  options: ResolvedConnectionOptions & { gatewayRoute?: AgentGatewayRoute },\n) => {\n  const frontendProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const agentProjectConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  const targetComponent: ComponentMetadata | undefined =\n    options.targetComponent;\n\n  // Extract agent metadata from the target component or project metadata\n  const metadata = agentProjectConfig.metadata as any;\n  const agentName = targetComponent?.name ?? 'agent';\n  const agentNameClassName = targetComponent?.rc ?? toClassName(agentName);\n  const agentPort = targetComponent?.port ?? metadata?.ports?.[0] ?? 8081;\n  // Behind a gateway the browser authenticates with the gateway, not the agent.\n  const auth = (\n    options.gatewayRoute?.gatewayAuth ??\n    targetComponent?.auth ??\n    metadata?.auth ??\n    'iam'\n  ).toLowerCase();\n  const protocol = (targetComponent?.protocol ?? 'http').toLowerCase();\n\n  // Recorded below and read by the declaration's predicates, so the packages\n  // added here are exactly the ones the version sync will own.\n  const connectionMetadata: PyAgentReactConnectionMetadata = {\n    protocol,\n    auth,\n    theme: resolveAgUiTheme(frontendProjectConfig),\n  };\n\n  if (protocol === 'a2a') {\n    throw new Error(\n      `Cannot connect a React website to an A2A agent. ` +\n        `Consider generating an agent with the HTTP or AG-UI protocol instead.`,\n    );\n  }\n\n  let additionalLocalDevDeps: string[] = [];\n\n  if (protocol === 'ag-ui') {\n    await addAgUiReactConnection(tree, {\n      frontendProjectConfig,\n      agentName,\n      agentNameClassName,\n      auth: auth as AgUiAuth,\n      gatewayRoute: options.gatewayRoute,\n    });\n  } else {\n    const moduleName = getModuleName(agentProjectConfig);\n    const agentNameSnakeCase = toSnakeCase(agentName);\n    const agentTargetPrefix = targetComponent?.name ? agentName : 'agent';\n\n    // Add OpenAPI spec generation script scoped to this agent\n    generateFiles(\n      tree,\n      joinPathFragments(import.meta.dirname, 'files/agent'),\n      agentProjectConfig.root,\n      {\n        moduleName,\n        agentNameSnakeCase,\n      },\n      {\n        overwriteStrategy: OverwriteStrategy.KeepExisting,\n      },\n    );\n\n    // Instrument the OpenAPI spec generation as a target on the agent project\n    const openApiTargetName = `${agentTargetPrefix}-openapi`;\n    const openApiDist = joinPathFragments(\n      'dist',\n      agentProjectConfig.root,\n      'openapi',\n      agentNameSnakeCase,\n    );\n    const specPath = joinPathFragments(openApiDist, 'openapi.json');\n\n    updateProjectConfiguration(tree, agentProjectConfig.name, {\n      ...agentProjectConfig,\n      targets: sortObjectKeys({\n        ...agentProjectConfig.targets,\n        [openApiTargetName]: {\n          cache: true,\n          executor: 'nx:run-commands',\n          outputs: [\n            `{workspaceRoot}/dist/{projectRoot}/openapi/${agentNameSnakeCase}`,\n          ],\n          options: {\n            commands: [\n              `uv run python {projectRoot}/scripts/${agentNameSnakeCase}_openapi.py \"dist/{projectRoot}/openapi/${agentNameSnakeCase}/openapi.json\"`,\n            ],\n          },\n        },\n      }),\n    });\n\n    // Use the shared OpenAPI react client utility for hooks, providers, and build targets.\n    // The dev target is handled separately below using the agent-specific dev target.\n    await addOpenApiReactClient(\n      tree,\n      {\n        apiName: agentNameClassName,\n        frontendProjectConfig,\n        backendProjectConfig: agentProjectConfig,\n        specBuildProject: agentProjectConfig,\n        specPath,\n        specBuildTargetName: `${agentProjectConfig.name}:${openApiTargetName}`,\n        auth,\n        port: agentPort,\n        isAgentRuntime: true,\n        gatewayRoute: options.gatewayRoute,\n        skipLocalDev: true,\n      },\n      DEPENDENCIES,\n    );\n\n    additionalLocalDevDeps = openApiClientLocalDevDeps(agentNameClassName);\n\n    // HTTP only — the AG-UI branch handles this inside addAgUiReactConnection.\n    // Agent constructs publish their runtime ARN to the 'agentcore' namespace\n    // by default, which isn't exposed to the website; patch them to also\n    // publish under 'connection' so the browser can read it. When routing via\n    // a gateway, the gateway publishes its own URL instead.\n    if (!options.gatewayRoute) {\n      await addAgentRuntimeToConnectionNamespace(tree, {\n        agentNameKebabCase: kebabCase(agentNameClassName),\n        agentNameClassName,\n      });\n    }\n  }\n\n  if (options.gatewayRoute) {\n    // The gateway react-connection wires the website's dev target to the\n    // local gateway (which proxies to the agent); only the OpenAPI client\n    // generation targets are still needed here.\n    if (additionalLocalDevDeps.length > 0) {\n      const websiteConfig = readProjectConfigurationUnqualified(\n        tree,\n        frontendProjectConfig.name,\n      );\n      if (websiteConfig.targets?.['dev']) {\n        for (const additional of additionalLocalDevDeps) {\n          addDependencyToTargetIfNotPresent(websiteConfig, 'dev', additional);\n        }\n        updateProjectConfiguration(tree, websiteConfig.name, websiteConfig);\n      }\n    }\n  } else {\n    await addPyAgentTargetToLocalDev(\n      tree,\n      frontendProjectConfig.name,\n      agentProjectConfig.name,\n      {\n        agentName,\n        agentNameClassName,\n        port: agentPort,\n        targetComponent,\n        additionalDependencyTargets: additionalLocalDevDeps,\n      },\n    );\n  }\n\n  // Recorded so the version sync knows this connection's dependencies are ours.\n  addComponentGeneratorMetadata(\n    tree,\n    frontendProjectConfig.name,\n    PY_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n    toProjectRelativePath(\n      frontendProjectConfig,\n      protocol === 'ag-ui'\n        ? joinPathFragments(\n            frontendProjectConfig.sourceRoot,\n            'hooks',\n            `useAgui${agentNameClassName}`,\n          )\n        : joinPathFragments(\n            frontendProjectConfig.sourceRoot,\n            'components',\n            `${agentNameClassName}Provider`,\n          ),\n    ),\n    agentNameClassName,\n    connectionMetadata,\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    PY_AGENT_REACT_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\n/**\n * Determine the Python module name from the project configuration\n */\nconst getModuleName = (\n  projectConfig: ReturnType<typeof readProjectConfigurationUnqualified>,\n): string => {\n  if (projectConfig.sourceRoot) {\n    const sourceRootParts = projectConfig.sourceRoot.split('/');\n    return sourceRootParts[sourceRootParts.length - 1];\n  }\n  throw new Error(\n    `Could not determine sourceRoot for project ${projectConfig.name}`,\n  );\n};\n\nexport default pyAgentReactConnectionGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","addAgentRuntimeToConnectionNamespace","DEPENDENCIES","AGUI_DEPENDENCIES","addAgUiReactConnection","resolveAgUiTheme","addOpenApiReactClient","OPEN_API_REACT_DEPENDENCIES","declareDependencies","onlyWhen","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","toSnakeCase","addComponentGeneratorMetadata","addDependencyToTargetIfNotPresent","getGeneratorInfo","readProjectConfigurationUnqualified","sortObjectKeys","toProjectRelativePath","addPyAgentTargetToLocalDev","openApiClientLocalDevDeps","isHttp","m","protocol","isAgUi","ts","PY_AGENT_REACT_CONNECTION_GENERATOR_INFO","filename","pyAgentReactConnectionGenerator","tree","options","frontendProjectConfig","sourceProject","agentProjectConfig","targetProject","targetComponent","metadata","agentName","name","agentNameClassName","rc","agentPort","port","ports","auth","gatewayRoute","gatewayAuth","toLowerCase","connectionMetadata","theme","Error","additionalLocalDevDeps","moduleName","getModuleName","agentNameSnakeCase","agentTargetPrefix","dirname","root","overwriteStrategy","KeepExisting","openApiTargetName","openApiDist","specPath","targets","cache","executor","outputs","commands","apiName","backendProjectConfig","specBuildProject","specBuildTargetName","isAgentRuntime","skipLocalDev","agentNameKebabCase","length","websiteConfig","additional","additionalDependencyTargets","sourceRoot","preferInstallDependencies","languages","projectConfig","sourceRootParts","split"],"mappings":"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"}

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

@@ -4,7 +4,7 @@
  */
 import type { Tree } from '@nx/devkit';
 import type { ComponentMetadata } from '../../../utils/nx';
-export interface PyAgentServeLocalOptions {
+export interface PyAgentLocalDevOptions {
     agentName: string;
     agentNameClassName: string;
     port: number;
@@ -12,12 +12,12 @@ export interface PyAgentServeLocalOptions {
     additionalDependencyTargets?: string[];
 }
 /**
- * Adds the given py strands agent target project to the source project's serve-local target.
+ * Adds the given py strands agent target project to the source project's dev target.
  * Updates the runtime config provider (if it exists) to point to the local HTTP URL.
  */
-export declare const addPyAgentTargetToServeLocal: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: PyAgentServeLocalOptions) => Promise<void>;
+export declare const addPyAgentTargetToLocalDev: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: PyAgentLocalDevOptions) => Promise<void>;
 /**
  * Build the OpenAPI client generation target names for an HTTP agent so
  * that local API changes regenerate the client.
  */
-export declare const openApiClientServeLocalDeps: (agentNameClassName: string) => string[];
+export declare const openApiClientLocalDevDeps: (agentNameClassName: string) => string[];

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

@@ -0,0 +1,36 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { addAgentTargetToLocalDev } from "../../../connection/agent-local-dev.js";
+import { kebabCase } from "../../../utils/names.js";
+/**
+ * Adds the given py strands agent target project to the source project's dev target.
+ * Updates the runtime config provider (if it exists) to point to the local HTTP URL.
+ */ export const addPyAgentTargetToLocalDev = async (tree, sourceProjectName, targetProjectName, options)=>{
+    // AG-UI clients POST to the runtime config URL directly, so it must point at
+    // the agent's `/invocations` endpoint. HTTP agents go through the generated
+    // OpenAPI client, which appends the `/invocations` operation path itself, so
+    // its base URL must omit it (otherwise the request hits `/invocations/invocations`).
+    const protocol = (options.targetComponent?.protocol ?? 'http').toLowerCase();
+    const localUrl = protocol === 'ag-ui' ? `http://localhost:${options.port}/invocations` : `http://localhost:${options.port}`;
+    await addAgentTargetToLocalDev(tree, sourceProjectName, targetProjectName, {
+        agentNameClassName: options.agentNameClassName,
+        port: options.port,
+        targetComponent: options.targetComponent,
+        runtimeConfigNamespace: 'agentRuntimes',
+        localUrl,
+        additionalDependencyTargets: options.additionalDependencyTargets
+    });
+};
+/**
+ * Build the OpenAPI client generation target names for an HTTP agent so
+ * that local API changes regenerate the client.
+ */ export const openApiClientLocalDevDeps = (agentNameClassName)=>{
+    const clientGenTarget = `generate:${kebabCase(agentNameClassName)}-client`;
+    return [
+        clientGenTarget,
+        `watch-${clientGenTarget}`
+    ];
+};
+
+//# sourceMappingURL=local-dev.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/py/agent/react-connection/local-dev.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { addAgentTargetToLocalDev } from '../../../connection/agent-local-dev';\nimport { kebabCase } from '../../../utils/names';\nimport type { ComponentMetadata } from '../../../utils/nx';\n\nexport interface PyAgentLocalDevOptions {\n  agentName: string;\n  agentNameClassName: string;\n  port: number;\n  targetComponent?: ComponentMetadata;\n  additionalDependencyTargets?: string[];\n}\n\n/**\n * Adds the given py strands agent target project to the source project's dev target.\n * Updates the runtime config provider (if it exists) to point to the local HTTP URL.\n */\nexport const addPyAgentTargetToLocalDev = async (\n  tree: Tree,\n  sourceProjectName: string,\n  targetProjectName: string,\n  options: PyAgentLocalDevOptions,\n) => {\n  // AG-UI clients POST to the runtime config URL directly, so it must point at\n  // the agent's `/invocations` endpoint. HTTP agents go through the generated\n  // OpenAPI client, which appends the `/invocations` operation path itself, so\n  // its base URL must omit it (otherwise the request hits `/invocations/invocations`).\n  const protocol = (options.targetComponent?.protocol ?? 'http').toLowerCase();\n  const localUrl =\n    protocol === 'ag-ui'\n      ? `http://localhost:${options.port}/invocations`\n      : `http://localhost:${options.port}`;\n\n  await addAgentTargetToLocalDev(tree, sourceProjectName, targetProjectName, {\n    agentNameClassName: options.agentNameClassName,\n    port: options.port,\n    targetComponent: options.targetComponent,\n    runtimeConfigNamespace: 'agentRuntimes',\n    localUrl,\n    additionalDependencyTargets: options.additionalDependencyTargets,\n  });\n};\n\n/**\n * Build the OpenAPI client generation target names for an HTTP agent so\n * that local API changes regenerate the client.\n */\nexport const openApiClientLocalDevDeps = (\n  agentNameClassName: string,\n): string[] => {\n  const clientGenTarget = `generate:${kebabCase(agentNameClassName)}-client`;\n  return [clientGenTarget, `watch-${clientGenTarget}`];\n};\n"],"names":["addAgentTargetToLocalDev","kebabCase","addPyAgentTargetToLocalDev","tree","sourceProjectName","targetProjectName","options","protocol","targetComponent","toLowerCase","localUrl","port","agentNameClassName","runtimeConfigNamespace","additionalDependencyTargets","openApiClientLocalDevDeps","clientGenTarget"],"mappings":"AAAA;;;CAGC,GAED,SAASA,wBAAwB,QAAQ,yCAAsC;AAC/E,SAASC,SAAS,QAAQ,0BAAuB;AAWjD;;;CAGC,GACD,OAAO,MAAMC,6BAA6B,OACxCC,MACAC,mBACAC,mBACAC;IAEA,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,qFAAqF;IACrF,MAAMC,WAAW,AAACD,CAAAA,QAAQE,eAAe,EAAED,YAAY,MAAK,EAAGE,WAAW;IAC1E,MAAMC,WACJH,aAAa,UACT,CAAC,iBAAiB,EAAED,QAAQK,IAAI,CAAC,YAAY,CAAC,GAC9C,CAAC,iBAAiB,EAAEL,QAAQK,IAAI,EAAE;IAExC,MAAMX,yBAAyBG,MAAMC,mBAAmBC,mBAAmB;QACzEO,oBAAoBN,QAAQM,kBAAkB;QAC9CD,MAAML,QAAQK,IAAI;QAClBH,iBAAiBF,QAAQE,eAAe;QACxCK,wBAAwB;QACxBH;QACAI,6BAA6BR,QAAQQ,2BAA2B;IAClE;AACF,EAAE;AAEF;;;CAGC,GACD,OAAO,MAAMC,4BAA4B,CACvCH;IAEA,MAAMI,kBAAkB,CAAC,SAAS,EAAEf,UAAUW,oBAAoB,OAAO,CAAC;IAC1E,OAAO;QAACI;QAAiB,CAAC,MAAM,EAAEA,iBAAiB;KAAC;AACtD,EAAE"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/py/agent/react-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 { ComponentMetadata } from '../../../utils/nx';\n\n/**\n * TypeScript types for options defined in schema.json\n */\nexport interface PyAgentReactConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD;;CAEC,GACD,WAMC"}

package/src/py/agent/react-connection/schema.d.ts

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

package/src/py/agent/react-connection/schema.json

@@ -20,6 +20,11 @@
     "targetComponent": {
       "type": "string",
       "description": "The agent component name"
+    },
+    "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/py/agent/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/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/py/agent/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { IacOption } from '../../utils/iac';\n\nexport type PyAgentFramework = 'strands' | 'langchain';\nexport type PyAgentInfra = 'agentcore' | 'none';\nexport type AgentProtocol = 'http' | 'a2a' | 'ag-ui';\n\nexport type PyAgentAuth = 'iam' | 'cognito';\n\nexport type PyAgentSession = 'in-memory';\n\nexport interface PyAgentGeneratorSchema {\n  project: string;\n  framework?: PyAgentFramework;\n  name?: string;\n  infra?: PyAgentInfra;\n  auth?: PyAgentAuth;\n  protocol?: AgentProtocol;\n  session?: PyAgentSession;\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAYD,WAUC"}

package/src/py/agent/schema.d.ts

@@ -5,12 +5,14 @@
 
 import { IacOption } from '../../utils/iac';
 
-export type PyAgentFramework = 'strands';
+export type PyAgentFramework = 'strands' | 'langchain';
 export type PyAgentInfra = 'agentcore' | 'none';
 export type AgentProtocol = 'http' | 'a2a' | 'ag-ui';
 
 export type PyAgentAuth = 'iam' | 'cognito';
 
+export type PyAgentSession = 'in-memory';
+
 export interface PyAgentGeneratorSchema {
   project: string;
   framework?: PyAgentFramework;
@@ -18,5 +20,7 @@ export interface PyAgentGeneratorSchema {
   infra?: PyAgentInfra;
   auth?: PyAgentAuth;
   protocol?: AgentProtocol;
+  session?: PyAgentSession;
   iac: IacOption;
+  preferInstallDependencies?: boolean;
 }

package/src/py/agent/schema.json

@@ -2,6 +2,7 @@
   "$schema": "https://json-schema.org/schema",
   "$id": "py#agent",
   "title": "py#agent",
+  "x-label": "Agent",
   "description": "Add an AI Agent to a Python project",
   "type": "object",
   "properties": {
@@ -19,7 +20,7 @@
       "type": "string",
       "description": "The agent SDK to use.",
       "x-prompt": "Which agent SDK would you like to use?",
-      "enum": ["strands"],
+      "enum": ["strands", "langchain"],
       "default": "strands",
       "x-priority": "important"
     },
@@ -59,6 +60,19 @@
       "enum": ["agentcore", "none"],
       "default": "agentcore",
       "x-priority": "important"
+    },
+    "session": {
+      "type": "string",
+      "description": "The storage used to persist session for your Agent. Only 'in-memory' is currently supported for Python agents.",
+      "x-prompt": "How would you like to persist session for your Agent?",
+      "enum": ["in-memory"],
+      "default": "in-memory",
+      "x-priority": "important"
+    },
+    "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": ["project"]

package/src/py/api/generator.js

@@ -1,15 +1,14 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PY_API_GENERATOR_INFO = void 0;
-exports.pyApiGenerator = pyApiGenerator;
-const nx_1 = require("../../utils/nx");
-const generator_1 = require("../fast-api/generator");
-exports.PY_API_GENERATOR_INFO = (0, nx_1.getGeneratorInfo)(__filename);
-async function pyApiGenerator(tree, options) {
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { getGeneratorInfo } from "../../utils/nx.js";
+import { pyFastApiProjectGenerator } from "../fast-api/generator.js";
+export const PY_API_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export async function pyApiGenerator(tree, options) {
     const framework = options.framework ?? 'fastapi';
-    switch (framework) {
+    switch(framework){
         case 'fastapi':
-            return (0, generator_1.pyFastApiProjectGenerator)(tree, {
+            return pyFastApiProjectGenerator(tree, {
                 name: options.name,
                 infra: options.infra,
                 integrationPattern: options.integrationPattern,
@@ -18,8 +17,10 @@ async function pyApiGenerator(tree, options) {
                 subDirectory: options.subDirectory,
                 moduleName: options.moduleName,
                 iac: options.iac,
+                preferInstallDependencies: options.preferInstallDependencies
             });
     }
 }
-exports.default = pyApiGenerator;
+export default pyApiGenerator;
+
 //# sourceMappingURL=generator.js.map

package/src/py/api/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../packages/nx-plugin/src/py/api/generator.ts"],"names":[],"mappings":";;;AAYA,wCAmBC;AA1BD,uCAAwE;AACxE,qDAAkE;AAGrD,QAAA,qBAAqB,GAChC,IAAA,qBAAgB,EAAC,UAAU,CAAC,CAAC;AAExB,KAAK,UAAU,cAAc,CAClC,IAAU,EACV,OAA6B;IAE7B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC;IAEjD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,IAAA,qCAAyB,EAAC,IAAI,EAAE;gBACrC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,kBAAe,cAAc,CAAC"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/py/api/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { Tree } from '@nx/devkit';\nimport { getGeneratorInfo, type NxGeneratorInfo } from '../../utils/nx';\nimport { pyFastApiProjectGenerator } from '../fast-api/generator';\nimport type { PyApiGeneratorSchema } from './schema';\n\nexport const PY_API_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\nexport async function pyApiGenerator(\n  tree: Tree,\n  options: PyApiGeneratorSchema,\n) {\n  const framework = options.framework ?? 'fastapi';\n\n  switch (framework) {\n    case 'fastapi':\n      return pyFastApiProjectGenerator(tree, {\n        name: options.name,\n        infra: options.infra,\n        integrationPattern: options.integrationPattern,\n        auth: options.auth,\n        directory: options.directory,\n        subDirectory: options.subDirectory,\n        moduleName: options.moduleName,\n        iac: options.iac,\n        preferInstallDependencies: options.preferInstallDependencies,\n      });\n  }\n}\n\nexport default pyApiGenerator;\n"],"names":["getGeneratorInfo","pyFastApiProjectGenerator","PY_API_GENERATOR_INFO","filename","pyApiGenerator","tree","options","framework","name","infra","integrationPattern","auth","directory","subDirectory","moduleName","iac","preferInstallDependencies"],"mappings":"AAAA;;;CAGC,GAED,SAASA,gBAAgB,QAA8B,oBAAiB;AACxE,SAASC,yBAAyB,QAAQ,2BAAwB;AAGlE,OAAO,MAAMC,wBAAyCF,iBACpD,YAAYG,QAAQ,EACpB;AAEF,OAAO,eAAeC,eACpBC,IAAU,EACVC,OAA6B;IAE7B,MAAMC,YAAYD,QAAQC,SAAS,IAAI;IAEvC,OAAQA;QACN,KAAK;YACH,OAAON,0BAA0BI,MAAM;gBACrCG,MAAMF,QAAQE,IAAI;gBAClBC,OAAOH,QAAQG,KAAK;gBACpBC,oBAAoBJ,QAAQI,kBAAkB;gBAC9CC,MAAML,QAAQK,IAAI;gBAClBC,WAAWN,QAAQM,SAAS;gBAC5BC,cAAcP,QAAQO,YAAY;gBAClCC,YAAYR,QAAQQ,UAAU;gBAC9BC,KAAKT,QAAQS,GAAG;gBAChBC,2BAA2BV,QAAQU,yBAAyB;YAC9D;IACJ;AACF;AAEA,eAAeZ,eAAe"}

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/py/api/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { IacOption } from '../../utils/iac';\n\nexport interface PyApiGeneratorSchema {\n  readonly name: string;\n  readonly framework?: 'fastapi';\n  readonly infra: 'rest-lambda' | 'http-lambda' | 'none';\n  readonly integrationPattern?: 'isolated' | 'shared';\n  readonly auth: 'iam' | 'cognito' | 'custom';\n  readonly directory?: string;\n  readonly subDirectory?: string;\n  readonly moduleName?: string;\n  readonly iac: IacOption;\n  readonly preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAWC"}

package/src/py/api/schema.d.ts

@@ -14,4 +14,5 @@ export interface PyApiGeneratorSchema {
   readonly subDirectory?: string;
   readonly moduleName?: string;
   readonly iac: IacOption;
+  readonly preferInstallDependencies?: boolean;
 }

package/src/py/api/schema.json

@@ -94,6 +94,11 @@
       "enum": ["rest-lambda", "http-lambda", "none"],
       "x-prompt": "What infrastructure would you like to deploy your API with?",
       "x-priority": "important"
+    },
+    "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"]