@aws/nx-plugin 1.0.0-rc.48 → 1.0.0-rc.49

package/src/ts/nx-migration/files/migration.ts.template

@@ -0,0 +1,55 @@
+import { type MigrationReturnObject, type Tree } from '@nx/devkit';
+import { formatFilesInSubtree } from '<%- formatImportPath %>';
+
+/**
+ * <%= description %>
+<%_ if (isHybrid) { _%>
+ *
+ * Hybrid migration: this codemod does the mechanical part, then the paired
+ * prompt (prompt.md) hands off to the user's agent for the rest.
+ *
+ * How to write a migration:
+ * - https://nx.dev/docs/kb/migration-generators
+ * - `nextSteps` and `agentContext`: https://nx.dev/docs/reference/devkit/MigrationReturnObject
+ *
+ * Guardrails:
+ * - Pattern-match before writing: skip files that have diverged from the shape
+ *   your generators produce, and report them via `agentContext` so the prompt
+ *   can pick them up, rather than clobbering the user's changes.
+ * - Idempotent: re-running must be a no-op.
+ * - Format what you write: finish with `formatFilesInSubtree` so the files your
+ *   migration wrote are formatted correctly.
+ */
+<%_ } else { _%>
+ *
+ * How to write a migration:
+ * - https://nx.dev/docs/kb/migration-generators
+ * - What `nextSteps` means: https://nx.dev/docs/reference/devkit/MigrationReturnObject
+ *
+ * Guardrails:
+ * - Pattern-match before writing: skip files that have diverged from the shape
+ *   your generators produce and report them via `nextSteps`, or consider a
+ *   hybrid migration, rather than clobbering the user's changes.
+ * - Idempotent: re-running must be a no-op.
+ * - Format what you write: finish with `formatFilesInSubtree` so the files your
+ *   migration wrote are formatted correctly.
+ */
+<%_ } _%>
+export default async function migration(
+  tree: Tree,
+): Promise<MigrationReturnObject> {
+  const nextSteps: string[] = [];
+<% if (isHybrid) { %>  const agentContext: string[] = [];
+<% } %>
+  // TODO: read the workspace's files and update the ones matching the shape
+  // your generators produce, noting any you skip in `nextSteps`.
+<% if (isHybrid) { %>
+  // `agentContext` reaches the paired prompt under `--agentic` and is dropped
+  // otherwise.
+  // TODO: describe what changed in `agentContext`, e.g.:
+  // agentContext.push('Renamed the `foo` target to `bar` in every project.json.');
+<% } %>
+  await formatFilesInSubtree(tree);
+
+  return { nextSteps<% if (isHybrid) { %>, agentContext<% } %> };
+}

package/src/ts/nx-migration/files/prompt.md.template

@@ -0,0 +1,46 @@
+<%_ if (isHybrid) { _%>
+<!-- Authoring guide (delete before shipping): this file is the `prompt` for the
+agentic half of a hybrid migration. The codemod half (migration.ts) has already
+run its mechanical changes and passes a summary via `agentContext`. The prompt is
+applied by the user's AI coding agent, and shown verbatim to users who run
+`nx migrate` without one, so write self-contained, human-actionable steps.
+See https://nx.dev/docs/kb/migration-generators -->
+<%_ } else { _%>
+<!-- Authoring guide (delete before shipping): this file is the `prompt` for an
+agentic migration. It is applied by the user's AI coding agent, and shown
+verbatim to users who run `nx migrate` without one, so write self-contained,
+human-actionable steps.
+See https://nx.dev/docs/kb/migration-generators -->
+<%_ } _%>
+
+# <%= description %>
+
+## Overview
+
+<%_ if (isHybrid) { _%>
+<!-- TODO: describe the breaking change and what remains to be done in
+user-owned code after the codemod has run. -->
+<%_ } else { _%>
+<!-- TODO: describe the breaking change and what the workspace needs to end up
+looking like. -->
+<%_ } _%>
+
+## Steps
+
+<%_ if (isHybrid) { _%>
+1. <!-- TODO: identify the user-owned call sites the codemod could not update
+   (e.g. "handlers that call the renamed API"). -->
+<%_ } else { _%>
+1. <!-- TODO: identify the files/patterns affected (e.g. "search for `oldApi(`
+   across the workspace"). -->
+<%_ } _%>
+2. <!-- TODO: describe the transformation with before/after examples. -->
+3. <!-- TODO: how to verify: run `nx run-many --target build --all` (and any
+   relevant tests) and confirm they pass. -->
+
+## Guard rails
+
+- Only change what these instructions describe. Do not reformat unrelated code.
+- Do not weaken or delete tests to make them pass.
+- If a file has been customised in a way these instructions don't cover, leave
+  it and note it for the user rather than guessing.

package/src/ts/nx-migration/generator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 NxGeneratorInfo } from '../../utils/nx';
+import type { TsNxMigrationGeneratorSchema } from './schema';
+export declare const NX_MIGRATION_GENERATOR_INFO: NxGeneratorInfo;
+/**
+ * Scaffolds a migration in an Nx Plugin project and registers it in the
+ * plugin's `migrations.json` (creating the manifest and wiring the
+ * `nx-migrations` field into the plugin's `package.json` if absent), so
+ * `nx migrate` applies it when users upgrade the plugin.
+ *
+ * Supports all three migration kinds:
+ * - `deterministic`: a codemod (`implementation`).
+ * - `agentic`: a `prompt` markdown file applied by the user's agent.
+ * - `hybrid`: both — the codemod does the mechanical part and returns
+ *   `agentContext`, then the prompt hands off to the agent for the rest.
+ *
+ * No `version` is written — the plugin author stamps versions at release time.
+ */
+export declare const tsNxMigrationGenerator: (tree: Tree, options: TsNxMigrationGeneratorSchema) => Promise<GeneratorCallback | void>;
+export default tsNxMigrationGenerator;

package/src/ts/nx-migration/generator.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { generateFiles, joinPathFragments, OverwriteStrategy, readJson, writeJson } from "@nx/devkit";
+import PackageJson from "../../../package.json" with {
+    type: 'json'
+};
+import { formatFilesInSubtree } from "../../utils/format.js";
+import { installDependencies } from "../../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../../utils/metrics.js";
+import { LATEST_MIGRATIONS_DIR, migrationKey } from "../../utils/migration-versions.js";
+import { kebabCase } from "../../utils/names.js";
+import { getGeneratorInfo, isNxPluginForAwsWorkspace } from "../../utils/nx.js";
+import { sortObjectKeys } from "../../utils/object.js";
+import { addNxPluginDependencies, configureNxPluginPackageJson, readNxPluginProject } from "../nx-plugin/utils.js";
+export const NX_MIGRATION_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+/**
+ * Scaffolds a migration in an Nx Plugin project and registers it in the
+ * plugin's `migrations.json` (creating the manifest and wiring the
+ * `nx-migrations` field into the plugin's `package.json` if absent), so
+ * `nx migrate` applies it when users upgrade the plugin.
+ *
+ * Supports all three migration kinds:
+ * - `deterministic`: a codemod (`implementation`).
+ * - `agentic`: a `prompt` markdown file applied by the user's agent.
+ * - `hybrid`: both — the codemod does the mechanical part and returns
+ *   `agentContext`, then the prompt hands off to the agent for the rest.
+ *
+ * No `version` is written — the plugin author stamps versions at release time.
+ */ export const tsNxMigrationGenerator = async (tree, options)=>{
+    const name = kebabCase(options.name);
+    // Shown by `nx migrate` when the migration runs, so it needs to say something
+    const description = options.description ?? 'TODO: Add short description of the migration';
+    const kind = options.kind ?? 'deterministic';
+    const hasImplementation = kind === 'deterministic' || kind === 'hybrid';
+    const hasPrompt = kind === 'agentic' || kind === 'hybrid';
+    const isHybrid = kind === 'hybrid';
+    const plugin = readNxPluginProject(tree, options.project);
+    const sourceRoot = plugin.sourceRoot ?? joinPathFragments(plugin.root, 'src');
+    const srcDir = sourceRoot.split('/').filter(Boolean).pop();
+    // Migrations are grouped by the release that ships them. A new one lands in
+    // `latest` — the release that picks it up moves it into its version folder.
+    const migrationPath = `${srcDir}/migrations/${LATEST_MIGRATIONS_DIR}/${name}`;
+    const migrationDir = joinPathFragments(sourceRoot, 'migrations', LATEST_MIGRATIONS_DIR, name);
+    const key = migrationKey(LATEST_MIGRATIONS_DIR, name);
+    const isNxPluginForAws = isNxPluginForAwsWorkspace(tree);
+    // Point the plugin at its migrations manifest so `nx migrate` finds them
+    const pluginPackageJsonPath = configureNxPluginPackageJson(tree, plugin, 'nx-migrations', {
+        migrations: './migrations.json'
+    });
+    // Migrations sit three levels below the source root, so in this repo the
+    // shared utils are relative. Elsewhere they come from the SDK.
+    const formatImportPath = isNxPluginForAws ? '../../../utils/format' : `${PackageJson.name}/sdk/utils/format`;
+    const testImportPath = isNxPluginForAws ? '../../../utils/test' : `${PackageJson.name}/sdk/utils/test`;
+    // One template set covers all kinds — scaffold it, then prune what this kind
+    // doesn't use.
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files'), migrationDir, {
+        name,
+        description,
+        isHybrid,
+        formatImportPath,
+        testImportPath
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    if (!hasImplementation) {
+        tree.delete(joinPathFragments(migrationDir, 'migration.ts'));
+        tree.delete(joinPathFragments(migrationDir, 'migration.spec.ts'));
+    }
+    if (!hasPrompt) {
+        tree.delete(joinPathFragments(migrationDir, 'prompt.md'));
+    }
+    // Register the migration under its folder-prefixed key. The fields present
+    // discriminate the kind for nx, and paths are relative to migrations.json.
+    // No version is written, but an already-stamped one is preserved.
+    const migrationsJsonPath = joinPathFragments(plugin.root, 'migrations.json');
+    const migrationsJson = tree.exists(migrationsJsonPath) ? readJson(tree, migrationsJsonPath) : {
+        $schema: 'http://json-schema.org/schema',
+        name: readJson(tree, pluginPackageJsonPath).name ?? plugin.name,
+        generators: {}
+    };
+    writeJson(tree, migrationsJsonPath, {
+        ...migrationsJson,
+        generators: sortObjectKeys({
+            ...migrationsJson.generators,
+            [key]: {
+                ...migrationsJson.generators?.[key]?.version ? {
+                    version: migrationsJson.generators[key].version
+                } : {},
+                description,
+                ...hasImplementation ? {
+                    implementation: `./${migrationPath}/migration`
+                } : {},
+                ...hasPrompt ? {
+                    prompt: `./${migrationPath}/prompt.md`
+                } : {}
+            }
+        })
+    });
+    // Codemods import @nx/devkit and the @aws/nx-plugin SDK, both of which must
+    // resolve for nx to run them
+    if (hasImplementation) {
+        addNxPluginDependencies(tree, pluginPackageJsonPath);
+    }
+    await addGeneratorMetricsIfApplicable(tree, [
+        NX_MIGRATION_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    if (hasImplementation && !isNxPluginForAws) {
+        return ()=>installDependencies(tree, options.preferInstallDependencies, {
+                languages: [
+                    'typescript'
+                ],
+                ensureResolvable: [
+                    '@nx/devkit'
+                ]
+            });
+    }
+};
+export default tsNxMigrationGenerator;
+
+//# sourceMappingURL=generator.js.map

package/src/ts/nx-migration/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-migration/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  readJson,\n  type Tree,\n  writeJson,\n} from '@nx/devkit';\nimport PackageJson from '../../../package.json' with { type: 'json' };\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport {\n  LATEST_MIGRATIONS_DIR,\n  migrationKey,\n} from '../../utils/migration-versions';\nimport { kebabCase } from '../../utils/names';\nimport {\n  getGeneratorInfo,\n  isNxPluginForAwsWorkspace,\n  type NxGeneratorInfo,\n} from '../../utils/nx';\nimport { sortObjectKeys } from '../../utils/object';\nimport {\n  addNxPluginDependencies,\n  configureNxPluginPackageJson,\n  readNxPluginProject,\n} from '../nx-plugin/utils';\nimport type { TsNxMigrationGeneratorSchema } from './schema';\n\nexport const NX_MIGRATION_GENERATOR_INFO: NxGeneratorInfo = getGeneratorInfo(\n  import.meta.filename,\n);\n\n/**\n * Scaffolds a migration in an Nx Plugin project and registers it in the\n * plugin's `migrations.json` (creating the manifest and wiring the\n * `nx-migrations` field into the plugin's `package.json` if absent), so\n * `nx migrate` applies it when users upgrade the plugin.\n *\n * Supports all three migration kinds:\n * - `deterministic`: a codemod (`implementation`).\n * - `agentic`: a `prompt` markdown file applied by the user's agent.\n * - `hybrid`: both — the codemod does the mechanical part and returns\n *   `agentContext`, then the prompt hands off to the agent for the rest.\n *\n * No `version` is written — the plugin author stamps versions at release time.\n */\nexport const tsNxMigrationGenerator = async (\n  tree: Tree,\n  options: TsNxMigrationGeneratorSchema,\n): Promise<GeneratorCallback | void> => {\n  const name = kebabCase(options.name);\n  // Shown by `nx migrate` when the migration runs, so it needs to say something\n  const description =\n    options.description ?? 'TODO: Add short description of the migration';\n  const kind = options.kind ?? 'deterministic';\n\n  const hasImplementation = kind === 'deterministic' || kind === 'hybrid';\n  const hasPrompt = kind === 'agentic' || kind === 'hybrid';\n  const isHybrid = kind === 'hybrid';\n\n  const plugin = readNxPluginProject(tree, options.project);\n\n  const sourceRoot = plugin.sourceRoot ?? joinPathFragments(plugin.root, 'src');\n  const srcDir = sourceRoot.split('/').filter(Boolean).pop();\n  // Migrations are grouped by the release that ships them. A new one lands in\n  // `latest` — the release that picks it up moves it into its version folder.\n  const migrationPath = `${srcDir}/migrations/${LATEST_MIGRATIONS_DIR}/${name}`;\n  const migrationDir = joinPathFragments(\n    sourceRoot,\n    'migrations',\n    LATEST_MIGRATIONS_DIR,\n    name,\n  );\n  const key = migrationKey(LATEST_MIGRATIONS_DIR, name);\n\n  const isNxPluginForAws = isNxPluginForAwsWorkspace(tree);\n\n  // Point the plugin at its migrations manifest so `nx migrate` finds them\n  const pluginPackageJsonPath = configureNxPluginPackageJson(\n    tree,\n    plugin,\n    'nx-migrations',\n    { migrations: './migrations.json' },\n  );\n\n  // Migrations sit three levels below the source root, so in this repo the\n  // shared utils are relative. Elsewhere they come from the SDK.\n  const formatImportPath = isNxPluginForAws\n    ? '../../../utils/format'\n    : `${PackageJson.name}/sdk/utils/format`;\n  const testImportPath = isNxPluginForAws\n    ? '../../../utils/test'\n    : `${PackageJson.name}/sdk/utils/test`;\n\n  // One template set covers all kinds — scaffold it, then prune what this kind\n  // doesn't use.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files'),\n    migrationDir,\n    { name, description, isHybrid, formatImportPath, testImportPath },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n  if (!hasImplementation) {\n    tree.delete(joinPathFragments(migrationDir, 'migration.ts'));\n    tree.delete(joinPathFragments(migrationDir, 'migration.spec.ts'));\n  }\n  if (!hasPrompt) {\n    tree.delete(joinPathFragments(migrationDir, 'prompt.md'));\n  }\n\n  // Register the migration under its folder-prefixed key. The fields present\n  // discriminate the kind for nx, and paths are relative to migrations.json.\n  // No version is written, but an already-stamped one is preserved.\n  const migrationsJsonPath = joinPathFragments(plugin.root, 'migrations.json');\n  const migrationsJson = tree.exists(migrationsJsonPath)\n    ? readJson(tree, migrationsJsonPath)\n    : {\n        $schema: 'http://json-schema.org/schema',\n        name: readJson(tree, pluginPackageJsonPath).name ?? plugin.name,\n        generators: {},\n      };\n  writeJson(tree, migrationsJsonPath, {\n    ...migrationsJson,\n    generators: sortObjectKeys({\n      ...migrationsJson.generators,\n      [key]: {\n        ...(migrationsJson.generators?.[key]?.version\n          ? { version: migrationsJson.generators[key].version }\n          : {}),\n        description,\n        ...(hasImplementation\n          ? { implementation: `./${migrationPath}/migration` }\n          : {}),\n        ...(hasPrompt ? { prompt: `./${migrationPath}/prompt.md` } : {}),\n      },\n    }),\n  });\n\n  // Codemods import @nx/devkit and the @aws/nx-plugin SDK, both of which must\n  // resolve for nx to run them\n  if (hasImplementation) {\n    addNxPluginDependencies(tree, pluginPackageJsonPath);\n  }\n\n  await addGeneratorMetricsIfApplicable(tree, [NX_MIGRATION_GENERATOR_INFO]);\n\n  await formatFilesInSubtree(tree);\n\n  if (hasImplementation && !isNxPluginForAws) {\n    return () =>\n      installDependencies(tree, options.preferInstallDependencies, {\n        languages: ['typescript'],\n        ensureResolvable: ['@nx/devkit'],\n      });\n  }\n};\n\nexport default tsNxMigrationGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","readJson","writeJson","PackageJson","type","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","LATEST_MIGRATIONS_DIR","migrationKey","kebabCase","getGeneratorInfo","isNxPluginForAwsWorkspace","sortObjectKeys","addNxPluginDependencies","configureNxPluginPackageJson","readNxPluginProject","NX_MIGRATION_GENERATOR_INFO","filename","tsNxMigrationGenerator","tree","options","name","description","kind","hasImplementation","hasPrompt","isHybrid","plugin","project","sourceRoot","root","srcDir","split","filter","Boolean","pop","migrationPath","migrationDir","key","isNxPluginForAws","pluginPackageJsonPath","migrations","formatImportPath","testImportPath","dirname","overwriteStrategy","KeepExisting","delete","migrationsJsonPath","migrationsJson","exists","$schema","generators","version","implementation","prompt","preferInstallDependencies","languages","ensureResolvable"],"mappings":"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"}

package/src/ts/nx-migration/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/ts/nx-migration/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-migration/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nexport type NxMigrationKind = 'deterministic' | 'agentic' | 'hybrid';\n\nexport interface TsNxMigrationGeneratorSchema {\n  project: string;\n  name: string;\n  description?: string;\n  kind?: NxMigrationKind;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAMC"}

package/src/ts/nx-migration/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type NxMigrationKind = 'deterministic' | 'agentic' | 'hybrid';
+
+export interface TsNxMigrationGeneratorSchema {
+  project: string;
+  name: string;
+  description?: string;
+  kind?: NxMigrationKind;
+  preferInstallDependencies?: boolean;
+}

package/src/ts/nx-migration/schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "TsNxMigration",
+  "title": "Create an Nx Migration",
+  "description": "Scaffold a migration for an Nx Plugin, applied by nx migrate when users upgrade",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The Nx Plugin project to add the migration to. We recommend using the ts#nx-plugin generator to create this.",
+      "x-priority": "important",
+      "x-prompt": "Choose the Nx Plugin project to add the migration to",
+      "x-dropdown": "projects",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      }
+    },
+    "name": {
+      "type": "string",
+      "description": "Migration name, in kebab-case (e.g. rename-foo-target)",
+      "x-priority": "important",
+      "x-prompt": "What is the name of the migration? (kebab-case, e.g. rename-foo-target)"
+    },
+    "description": {
+      "type": "string",
+      "description": "A description of what the migration does, shown by nx migrate",
+      "x-priority": "important",
+      "x-prompt": "Describe what the migration does"
+    },
+    "kind": {
+      "type": "string",
+      "description": "The kind of migration: deterministic (a codemod), agentic (an AI-applied prompt for user-owned code), or hybrid (a codemod that does the mechanical part then hands off to an agent)",
+      "enum": ["deterministic", "agentic", "hybrid"],
+      "default": "deterministic",
+      "x-priority": "important",
+      "x-prompt": {
+        "message": "What kind of migration is this?",
+        "type": "list",
+        "items": [
+          {
+            "value": "deterministic",
+            "label": "Deterministic — a codemod with an exact before/after (runs unattended, incl. CI)"
+          },
+          {
+            "value": "agentic",
+            "label": "Agentic — an AI-applied prompt for changes to user-owned code"
+          },
+          {
+            "value": "hybrid",
+            "label": "Hybrid — a codemod for the mechanical part that hands off to an agent for the rest"
+          }
+        ]
+      }
+    },
+    "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", "name"]
+}

package/src/ts/nx-plugin/utils.d.ts

@@ -2,8 +2,28 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { type Tree } from '@nx/devkit';
+import { type ProjectConfiguration, type Tree } from '@nx/devkit';
+import type { PackageJson } from 'nx/src/utils/package-json';
+/**
+ * Read the configuration of a project which can host Nx Plugin generators or
+ * migrations, ie a TypeScript project.
+ */
+export declare const readNxPluginProject: (tree: Tree, projectName: string) => ProjectConfiguration;
+/** `package.json` field pointing Nx at one of a plugin's manifests. */
+type NxPluginManifestField = 'generators' | 'nx-migrations';
+/**
+ * Create the plugin project's package.json if absent and point it at the given
+ * manifest, returning its path.
+ */
+export declare const configureNxPluginPackageJson: <TField extends NxPluginManifestField>(tree: Tree, project: ProjectConfiguration, manifestField: TField, manifestValue: PackageJson[TField]) => string;
+/**
+ * Declare the dependencies the plugin's `.ts` files import on both the
+ * workspace and the plugin, since both must resolve for Nx to load them. A
+ * no-op inside the plugin's own monorepo, where they are already present.
+ */
+export declare const addNxPluginDependencies: (tree: Tree, pluginPackageJsonPath: string) => void;
 /**
  * Configures a TypeScript project as an Nx Plugin
  */
 export declare const configureTsProjectAsNxPlugin: (tree: Tree, projectName: string) => void;
+export {};

package/src/ts/nx-plugin/utils.js

@@ -7,22 +7,20 @@ import { isEsmWorkspace } from "../../utils/module-format.js";
 import { nxPluginSelfDependency, readProjectConfigurationUnqualified } from "../../utils/nx.js";
 import { withVersions } from "../../utils/versions.js";
 /**
- * Configures a TypeScript project as an Nx Plugin
- */ export const configureTsProjectAsNxPlugin = (tree, projectName)=>{
+ * Read the configuration of a project which can host Nx Plugin generators or
+ * migrations, ie a TypeScript project.
+ */ export const readNxPluginProject = (tree, projectName)=>{
     const project = readProjectConfigurationUnqualified(tree, projectName);
     const tsConfigPath = joinPathFragments(project.root, 'tsconfig.json');
     if (!tree.exists(tsConfigPath)) {
         throw new Error(`Selected plugin project ${projectName} is not a TypeScript project`);
     }
-    // Create an empty generators.json if one dosn't exist
-    const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');
-    if (!tree.exists(generatorsJsonPath)) {
-        writeJson(tree, generatorsJsonPath, {
-            generators: {}
-        });
-    }
-    // Create a package.json if one doesn't exist, and configure "type", "main"
-    // and "generators"
+    return project;
+};
+/**
+ * Create the plugin project's package.json if absent and point it at the given
+ * manifest, returning its path.
+ */ export const configureNxPluginPackageJson = (tree, project, manifestField, manifestValue)=>{
     const pluginPackageJsonPath = joinPathFragments(project.root, 'package.json');
     if (!tree.exists(pluginPackageJsonPath)) {
         writeJson(tree, pluginPackageJsonPath, {
@@ -31,31 +29,47 @@ import { withVersions } from "../../utils/versions.js";
     }
     const esm = isEsmWorkspace(tree);
     updateJson(tree, pluginPackageJsonPath, (pkg)=>{
-        // Match the plugin's module system to the workspace. Nx loads `.ts`
-        // generators via Node's native type stripping, as ESM (workspace root is
+        // Match the plugin's module system to the workspace. Nx loads `.ts` files
+        // via Node's native type stripping, as ESM (workspace root is
         // `type: module`) or CommonJS accordingly.
         pkg.type ??= esm ? 'module' : 'commonjs';
         pkg.main ??= esm ? './src/index.js' : './src/index';
-        pkg.generators ??= './generators.json';
+        pkg[manifestField] ??= manifestValue;
         return pkg;
     });
+    return pluginPackageJsonPath;
+};
+/**
+ * Declare the dependencies the plugin's `.ts` files import on both the
+ * workspace and the plugin, since both must resolve for Nx to load them. A
+ * no-op inside the plugin's own monorepo, where they are already present.
+ */ export const addNxPluginDependencies = (tree, pluginPackageJsonPath)=>{
     const selfDependency = nxPluginSelfDependency(tree);
-    // Empty inside the plugin's own monorepo, where the plugin is the source
-    // rather than a dependency.
-    if (Object.keys(selfDependency).length > 0) {
-        // Add the required dependencies to the root package.json, and project's package.json
-        const deps = {
-            ...withVersions([
-                '@nx/devkit'
-            ]),
-            ...selfDependency
-        };
-        // Generated workspaces are `"type": "module"`, so Nx loads the plugin's
-        // `.ts` generators as ESM via Node's native type stripping — no swc/ts-node
-        // transpiler is required.
-        addDependenciesToPackageJson(tree, {}, deps);
-        addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);
+    if (Object.keys(selfDependency).length === 0) {
+        return;
+    }
+    const deps = {
+        ...withVersions([
+            '@nx/devkit'
+        ]),
+        ...selfDependency
+    };
+    addDependenciesToPackageJson(tree, {}, deps);
+    addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);
+};
+/**
+ * Configures a TypeScript project as an Nx Plugin
+ */ export const configureTsProjectAsNxPlugin = (tree, projectName)=>{
+    const project = readNxPluginProject(tree, projectName);
+    // Create an empty generators.json if one dosn't exist
+    const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');
+    if (!tree.exists(generatorsJsonPath)) {
+        writeJson(tree, generatorsJsonPath, {
+            generators: {}
+        });
     }
+    const pluginPackageJsonPath = configureNxPluginPackageJson(tree, project, 'generators', './generators.json');
+    addNxPluginDependencies(tree, pluginPackageJsonPath);
 };
 
 //# sourceMappingURL=utils.js.map

package/src/ts/nx-plugin/utils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-plugin/utils.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  updateJson,\n  writeJson,\n} from '@nx/devkit';\nimport { addDependenciesToPackageJson } from '../../utils/dependencies';\nimport { isEsmWorkspace } from '../../utils/module-format';\nimport {\n  nxPluginSelfDependency,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx';\nimport { withVersions } from '../../utils/versions';\n\n/**\n * Configures a TypeScript project as an Nx Plugin\n */\nexport const configureTsProjectAsNxPlugin = (\n  tree: Tree,\n  projectName: string,\n) => {\n  const project = readProjectConfigurationUnqualified(tree, projectName);\n\n  const tsConfigPath = joinPathFragments(project.root, 'tsconfig.json');\n  if (!tree.exists(tsConfigPath)) {\n    throw new Error(\n      `Selected plugin project ${projectName} is not a TypeScript project`,\n    );\n  }\n\n  // Create an empty generators.json if one dosn't exist\n  const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');\n  if (!tree.exists(generatorsJsonPath)) {\n    writeJson(tree, generatorsJsonPath, {\n      generators: {},\n    });\n  }\n\n  // Create a package.json if one doesn't exist, and configure \"type\", \"main\"\n  // and \"generators\"\n  const pluginPackageJsonPath = joinPathFragments(project.root, 'package.json');\n  if (!tree.exists(pluginPackageJsonPath)) {\n    writeJson(tree, pluginPackageJsonPath, {\n      name: project.name,\n    });\n  }\n  const esm = isEsmWorkspace(tree);\n  updateJson(tree, pluginPackageJsonPath, (pkg) => {\n    // Match the plugin's module system to the workspace. Nx loads `.ts`\n    // generators via Node's native type stripping, as ESM (workspace root is\n    // `type: module`) or CommonJS accordingly.\n    pkg.type ??= esm ? 'module' : 'commonjs';\n    pkg.main ??= esm ? './src/index.js' : './src/index';\n    pkg.generators ??= './generators.json';\n    return pkg;\n  });\n\n  const selfDependency = nxPluginSelfDependency(tree);\n\n  // Empty inside the plugin's own monorepo, where the plugin is the source\n  // rather than a dependency.\n  if (Object.keys(selfDependency).length > 0) {\n    // Add the required dependencies to the root package.json, and project's package.json\n    const deps = {\n      ...withVersions(['@nx/devkit']),\n      ...selfDependency,\n    };\n    // Generated workspaces are `\"type\": \"module\"`, so Nx loads the plugin's\n    // `.ts` generators as ESM via Node's native type stripping — no swc/ts-node\n    // transpiler is required.\n    addDependenciesToPackageJson(tree, {}, deps);\n    addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);\n  }\n};\n"],"names":["joinPathFragments","updateJson","writeJson","addDependenciesToPackageJson","isEsmWorkspace","nxPluginSelfDependency","readProjectConfigurationUnqualified","withVersions","configureTsProjectAsNxPlugin","tree","projectName","project","tsConfigPath","root","exists","Error","generatorsJsonPath","generators","pluginPackageJsonPath","name","esm","pkg","type","main","selfDependency","Object","keys","length","deps"],"mappings":"AAAA;;;CAGC,GACD,SACEA,iBAAiB,EAEjBC,UAAU,EACVC,SAAS,QACJ,aAAa;AACpB,SAASC,4BAA4B,QAAQ,8BAA2B;AACxE,SAASC,cAAc,QAAQ,+BAA4B;AAC3D,SACEC,sBAAsB,EACtBC,mCAAmC,QAC9B,oBAAiB;AACxB,SAASC,YAAY,QAAQ,0BAAuB;AAEpD;;CAEC,GACD,OAAO,MAAMC,+BAA+B,CAC1CC,MACAC;IAEA,MAAMC,UAAUL,oCAAoCG,MAAMC;IAE1D,MAAME,eAAeZ,kBAAkBW,QAAQE,IAAI,EAAE;IACrD,IAAI,CAACJ,KAAKK,MAAM,CAACF,eAAe;QAC9B,MAAM,IAAIG,MACR,CAAC,wBAAwB,EAAEL,YAAY,4BAA4B,CAAC;IAExE;IAEA,sDAAsD;IACtD,MAAMM,qBAAqBhB,kBAAkBW,QAAQE,IAAI,EAAE;IAC3D,IAAI,CAACJ,KAAKK,MAAM,CAACE,qBAAqB;QACpCd,UAAUO,MAAMO,oBAAoB;YAClCC,YAAY,CAAC;QACf;IACF;IAEA,2EAA2E;IAC3E,mBAAmB;IACnB,MAAMC,wBAAwBlB,kBAAkBW,QAAQE,IAAI,EAAE;IAC9D,IAAI,CAACJ,KAAKK,MAAM,CAACI,wBAAwB;QACvChB,UAAUO,MAAMS,uBAAuB;YACrCC,MAAMR,QAAQQ,IAAI;QACpB;IACF;IACA,MAAMC,MAAMhB,eAAeK;IAC3BR,WAAWQ,MAAMS,uBAAuB,CAACG;QACvC,oEAAoE;QACpE,yEAAyE;QACzE,2CAA2C;QAC3CA,IAAIC,IAAI,KAAKF,MAAM,WAAW;QAC9BC,IAAIE,IAAI,KAAKH,MAAM,mBAAmB;QACtCC,IAAIJ,UAAU,KAAK;QACnB,OAAOI;IACT;IAEA,MAAMG,iBAAiBnB,uBAAuBI;IAE9C,yEAAyE;IACzE,4BAA4B;IAC5B,IAAIgB,OAAOC,IAAI,CAACF,gBAAgBG,MAAM,GAAG,GAAG;QAC1C,qFAAqF;QACrF,MAAMC,OAAO;YACX,GAAGrB,aAAa;gBAAC;aAAa,CAAC;YAC/B,GAAGiB,cAAc;QACnB;QACA,wEAAwE;QACxE,4EAA4E;QAC5E,0BAA0B;QAC1BrB,6BAA6BM,MAAM,CAAC,GAAGmB;QACvCzB,6BAA6BM,MAAMmB,MAAM,CAAC,GAAGV;IAC/C;AACF,EAAE"}
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/ts/nx-plugin/utils.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 ProjectConfiguration,\n  type Tree,\n  updateJson,\n  writeJson,\n} from '@nx/devkit';\nimport type { PackageJson } from 'nx/src/utils/package-json';\nimport { addDependenciesToPackageJson } from '../../utils/dependencies';\nimport { isEsmWorkspace } from '../../utils/module-format';\nimport {\n  nxPluginSelfDependency,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx';\nimport { withVersions } from '../../utils/versions';\n\n/**\n * Read the configuration of a project which can host Nx Plugin generators or\n * migrations, ie a TypeScript project.\n */\nexport const readNxPluginProject = (\n  tree: Tree,\n  projectName: string,\n): ProjectConfiguration => {\n  const project = readProjectConfigurationUnqualified(tree, projectName);\n\n  const tsConfigPath = joinPathFragments(project.root, 'tsconfig.json');\n  if (!tree.exists(tsConfigPath)) {\n    throw new Error(\n      `Selected plugin project ${projectName} is not a TypeScript project`,\n    );\n  }\n\n  return project;\n};\n\n/** `package.json` field pointing Nx at one of a plugin's manifests. */\ntype NxPluginManifestField = 'generators' | 'nx-migrations';\n\n/**\n * Create the plugin project's package.json if absent and point it at the given\n * manifest, returning its path.\n */\nexport const configureNxPluginPackageJson = <\n  TField extends NxPluginManifestField,\n>(\n  tree: Tree,\n  project: ProjectConfiguration,\n  manifestField: TField,\n  manifestValue: PackageJson[TField],\n): string => {\n  const pluginPackageJsonPath = joinPathFragments(project.root, 'package.json');\n  if (!tree.exists(pluginPackageJsonPath)) {\n    writeJson(tree, pluginPackageJsonPath, {\n      name: project.name,\n    });\n  }\n  const esm = isEsmWorkspace(tree);\n  updateJson(tree, pluginPackageJsonPath, (pkg) => {\n    // Match the plugin's module system to the workspace. Nx loads `.ts` files\n    // via Node's native type stripping, as ESM (workspace root is\n    // `type: module`) or CommonJS accordingly.\n    pkg.type ??= esm ? 'module' : 'commonjs';\n    pkg.main ??= esm ? './src/index.js' : './src/index';\n    pkg[manifestField] ??= manifestValue;\n    return pkg;\n  });\n  return pluginPackageJsonPath;\n};\n\n/**\n * Declare the dependencies the plugin's `.ts` files import on both the\n * workspace and the plugin, since both must resolve for Nx to load them. A\n * no-op inside the plugin's own monorepo, where they are already present.\n */\nexport const addNxPluginDependencies = (\n  tree: Tree,\n  pluginPackageJsonPath: string,\n): void => {\n  const selfDependency = nxPluginSelfDependency(tree);\n  if (Object.keys(selfDependency).length === 0) {\n    return;\n  }\n  const deps = {\n    ...withVersions(['@nx/devkit']),\n    ...selfDependency,\n  };\n  addDependenciesToPackageJson(tree, {}, deps);\n  addDependenciesToPackageJson(tree, deps, {}, pluginPackageJsonPath);\n};\n\n/**\n * Configures a TypeScript project as an Nx Plugin\n */\nexport const configureTsProjectAsNxPlugin = (\n  tree: Tree,\n  projectName: string,\n) => {\n  const project = readNxPluginProject(tree, projectName);\n\n  // Create an empty generators.json if one dosn't exist\n  const generatorsJsonPath = joinPathFragments(project.root, 'generators.json');\n  if (!tree.exists(generatorsJsonPath)) {\n    writeJson(tree, generatorsJsonPath, {\n      generators: {},\n    });\n  }\n\n  const pluginPackageJsonPath = configureNxPluginPackageJson(\n    tree,\n    project,\n    'generators',\n    './generators.json',\n  );\n\n  addNxPluginDependencies(tree, pluginPackageJsonPath);\n};\n"],"names":["joinPathFragments","updateJson","writeJson","addDependenciesToPackageJson","isEsmWorkspace","nxPluginSelfDependency","readProjectConfigurationUnqualified","withVersions","readNxPluginProject","tree","projectName","project","tsConfigPath","root","exists","Error","configureNxPluginPackageJson","manifestField","manifestValue","pluginPackageJsonPath","name","esm","pkg","type","main","addNxPluginDependencies","selfDependency","Object","keys","length","deps","configureTsProjectAsNxPlugin","generatorsJsonPath","generators"],"mappings":"AAAA;;;CAGC,GACD,SACEA,iBAAiB,EAGjBC,UAAU,EACVC,SAAS,QACJ,aAAa;AAEpB,SAASC,4BAA4B,QAAQ,8BAA2B;AACxE,SAASC,cAAc,QAAQ,+BAA4B;AAC3D,SACEC,sBAAsB,EACtBC,mCAAmC,QAC9B,oBAAiB;AACxB,SAASC,YAAY,QAAQ,0BAAuB;AAEpD;;;CAGC,GACD,OAAO,MAAMC,sBAAsB,CACjCC,MACAC;IAEA,MAAMC,UAAUL,oCAAoCG,MAAMC;IAE1D,MAAME,eAAeZ,kBAAkBW,QAAQE,IAAI,EAAE;IACrD,IAAI,CAACJ,KAAKK,MAAM,CAACF,eAAe;QAC9B,MAAM,IAAIG,MACR,CAAC,wBAAwB,EAAEL,YAAY,4BAA4B,CAAC;IAExE;IAEA,OAAOC;AACT,EAAE;AAKF;;;CAGC,GACD,OAAO,MAAMK,+BAA+B,CAG1CP,MACAE,SACAM,eACAC;IAEA,MAAMC,wBAAwBnB,kBAAkBW,QAAQE,IAAI,EAAE;IAC9D,IAAI,CAACJ,KAAKK,MAAM,CAACK,wBAAwB;QACvCjB,UAAUO,MAAMU,uBAAuB;YACrCC,MAAMT,QAAQS,IAAI;QACpB;IACF;IACA,MAAMC,MAAMjB,eAAeK;IAC3BR,WAAWQ,MAAMU,uBAAuB,CAACG;QACvC,0EAA0E;QAC1E,8DAA8D;QAC9D,2CAA2C;QAC3CA,IAAIC,IAAI,KAAKF,MAAM,WAAW;QAC9BC,IAAIE,IAAI,KAAKH,MAAM,mBAAmB;QACtCC,GAAG,CAACL,cAAc,KAAKC;QACvB,OAAOI;IACT;IACA,OAAOH;AACT,EAAE;AAEF;;;;CAIC,GACD,OAAO,MAAMM,0BAA0B,CACrChB,MACAU;IAEA,MAAMO,iBAAiBrB,uBAAuBI;IAC9C,IAAIkB,OAAOC,IAAI,CAACF,gBAAgBG,MAAM,KAAK,GAAG;QAC5C;IACF;IACA,MAAMC,OAAO;QACX,GAAGvB,aAAa;YAAC;SAAa,CAAC;QAC/B,GAAGmB,cAAc;IACnB;IACAvB,6BAA6BM,MAAM,CAAC,GAAGqB;IACvC3B,6BAA6BM,MAAMqB,MAAM,CAAC,GAAGX;AAC/C,EAAE;AAEF;;CAEC,GACD,OAAO,MAAMY,+BAA+B,CAC1CtB,MACAC;IAEA,MAAMC,UAAUH,oBAAoBC,MAAMC;IAE1C,sDAAsD;IACtD,MAAMsB,qBAAqBhC,kBAAkBW,QAAQE,IAAI,EAAE;IAC3D,IAAI,CAACJ,KAAKK,MAAM,CAACkB,qBAAqB;QACpC9B,UAAUO,MAAMuB,oBAAoB;YAClCC,YAAY,CAAC;QACf;IACF;IAEA,MAAMd,wBAAwBH,6BAC5BP,MACAE,SACA,cACA;IAGFc,wBAAwBhB,MAAMU;AAChC,EAAE"}

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

@@ -81,6 +81,10 @@ const FRAMEWORKS = {
                 {
                     fromModule: './core/model-errors-strands.js',
                     importName: '*'
+                },
+                {
+                    fromModule: './core/tool-errors-strands.js',
+                    importName: '*'
                 }
             ],
             protocols: {