@aws/nx-plugin 1.0.0-rc.4 → 1.0.0-rc.41

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

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { ComponentMetadata } from '../../../utils/nx';
-export interface PyAgentServeLocalOptions {
+import type { Tree } from '@nx/devkit';
+import type { ComponentMetadata } from '../../../utils/nx';
+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 interface PyAgentGeneratorSchema {\n  project: string;\n  framework?: PyAgentFramework;\n  name?: string;\n  infra?: PyAgentInfra;\n  auth?: PyAgentAuth;\n  protocol?: AgentProtocol;\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAUD,WASC"}

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

@@ -5,7 +5,7 @@
 
 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';
 
@@ -19,4 +19,5 @@ export interface PyAgentGeneratorSchema {
   auth?: PyAgentAuth;
   protocol?: AgentProtocol;
   iac: IacOption;
+  preferInstallDependencies?: boolean;
 }

package/src/py/agent/schema.json

@@ -19,7 +19,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 +59,11 @@
       "enum": ["agentcore", "none"],
       "default": "agentcore",
       "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.d.ts

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { PyApiGeneratorSchema } from './schema';
-import { NxGeneratorInfo } from '../../utils/nx';
+import type { Tree } from '@nx/devkit';
+import { type NxGeneratorInfo } from '../../utils/nx';
+import type { PyApiGeneratorSchema } from './schema';
 export declare const PY_API_GENERATOR_INFO: NxGeneratorInfo;
 export declare function pyApiGenerator(tree: Tree, options: PyApiGeneratorSchema): Promise<import("@nx/devkit").GeneratorCallback>;
 export default pyApiGenerator;

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;AAzBD,uCAAmE;AACnE,qDAAkE;AAErD,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"]