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

package/src/agentcore-harness/generator.js

@@ -0,0 +1,158 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { addProjectConfiguration, generateFiles, joinPathFragments, OverwriteStrategy, updateProjectConfiguration } from "@nx/devkit";
+import { addTsDependencies } from "../utils/add-dependencies.js";
+import { addAgentCoreHarnessInfra } from "../utils/agent-core-constructs/agent-core-constructs.js";
+import { declareDependencies, ownedElsewhere } from "../utils/declared-dependencies.js";
+import { formatFilesInSubtree } from "../utils/format.js";
+import { resolveIac } from "../utils/iac.js";
+import { installDependencies } from "../utils/install.js";
+import { addGeneratorMetricsIfApplicable } from "../utils/metrics.js";
+import { kebabCase, toClassName } from "../utils/names.js";
+import { getNpmScopePrefix } from "../utils/npm-scope.js";
+import { addGeneratorMetadata, getGeneratorInfo, projectExists, readProjectConfigurationUnqualified } from "../utils/nx.js";
+import { SHARED_CONSTRUCTS_DEPENDENCIES, sharedConstructsGenerator } from "../utils/shared-constructs.js";
+// scripts/chat.ts needs all of these whatever the infrastructure choice, so no
+// entry is conditional. The harness project holds no manifest of its own, so
+// every entry is declared against the workspace root.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: '@aws-sdk/client-bedrock-agentcore',
+            root: true
+        },
+        {
+            name: '@aws-sdk/client-appconfigdata',
+            root: true
+        },
+        {
+            name: '@aws-lambda-powertools/parameters',
+            root: true
+        },
+        {
+            name: 'agent-chat-cli',
+            root: true
+        },
+        // tsx runs the chat script via the `chat` target; both are shared tooling.
+        {
+            name: '@types/node',
+            dev: true,
+            root: true
+        },
+        {
+            name: 'tsx',
+            dev: true,
+            root: true
+        },
+        ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES)
+    ]
+});
+export const AGENTCORE_HARNESS_GENERATOR_INFO = getGeneratorInfo(import.meta.filename);
+export const agentcoreHarnessGenerator = async (tree, options)=>{
+    const nameKebabCase = kebabCase(options.name);
+    const nameClassName = toClassName(nameKebabCase);
+    const parentDir = options.directory ?? 'packages';
+    const subDir = options.subDirectory ?? nameKebabCase;
+    const projectRoot = joinPathFragments(parentDir, subDir);
+    const fullyQualifiedProjectName = `${getNpmScopePrefix(tree)}${nameKebabCase}`;
+    const infra = options.infra ?? 'agentcore';
+    // AgentCore harness names must start with an ASCII letter and stay within 40
+    // characters once the "_<8 hex>" suffix is appended, so cap the prefix at 31.
+    // toClassName prefixes `_` (not a letter) for digit-leading names.
+    const harnessNamePrefix = (/^[A-Za-z]/.test(nameClassName) ? nameClassName : `H${nameClassName}`).slice(0, 31);
+    // Reuse an existing project configuration; create it otherwise.
+    let project;
+    if (projectExists(tree, fullyQualifiedProjectName)) {
+        project = readProjectConfigurationUnqualified(tree, fullyQualifiedProjectName);
+    } else {
+        addProjectConfiguration(tree, fullyQualifiedProjectName, {
+            name: fullyQualifiedProjectName,
+            root: projectRoot,
+            projectType: 'application',
+            sourceRoot: projectRoot,
+            tags: [],
+            targets: {},
+            metadata: {
+                generator: AGENTCORE_HARNESS_GENERATOR_INFO.id
+            }
+        });
+        project = readProjectConfigurationUnqualified(tree, fullyQualifiedProjectName);
+    }
+    // `chat` runs the vended chat script against the deployed Harness. Re-run:
+    // keep an existing target so user edits survive.
+    project.targets ??= {};
+    project.targets['chat'] ??= {
+        executor: 'nx:run-commands',
+        options: {
+            commands: [
+                'tsx ./scripts/chat.ts'
+            ],
+            cwd: '{projectRoot}'
+        }
+    };
+    updateProjectConfiguration(tree, project.name, project);
+    generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', 'project'), projectRoot, {
+        nameClassName,
+        nameKebabCase,
+        fullyQualifiedName: fullyQualifiedProjectName
+    }, {
+        overwriteStrategy: OverwriteStrategy.KeepExisting
+    });
+    // Resolved before the metadata write because the recorded value is what the
+    // declaration's predicates read; undefined when no infrastructure is written,
+    // in which case neither provider's packages were added.
+    const iac = infra === 'agentcore' ? await resolveIac(tree, options.iac) : undefined;
+    // Record only what cannot drift once the user owns the generated
+    // infrastructure: the project identity, its runtime config key, its auth mode
+    // and which provider's infrastructure was written.
+    const metadata = {
+        name: nameKebabCase,
+        rc: nameClassName,
+        auth: 'iam',
+        ...iac ? {
+            iac
+        } : {}
+    };
+    addGeneratorMetadata(tree, fullyQualifiedProjectName, AGENTCORE_HARNESS_GENERATOR_INFO, metadata);
+    // scripts/chat.ts dependencies; tsx runs it via the `chat` target.
+    addTsDependencies(tree, DEPENDENCIES, {
+        metadata
+    });
+    // Harness infrastructure is written only for `infra: agentcore`. A later
+    // `infra: agentcore` rerun adds it without replacing project files.
+    if (iac) {
+        await sharedConstructsGenerator(tree, {
+            iac
+        }, DEPENDENCIES);
+        await addAgentCoreHarnessInfra(tree, {
+            harnessNameClassName: nameClassName,
+            harnessNameKebabCase: nameKebabCase,
+            projectRoot,
+            harnessNamePrefix,
+            iac
+        });
+    }
+    await addGeneratorMetricsIfApplicable(tree, [
+        AGENTCORE_HARNESS_GENERATOR_INFO
+    ]);
+    await formatFilesInSubtree(tree);
+    return ()=>installDependencies(tree, options.preferInstallDependencies, {
+            languages: [
+                'typescript'
+            ]
+        });
+};
+/**
+ * Read a Harness Project's metadata, validating it was generated by the
+ * agentcore-harness generator before returning typed data.
+ */ export const readAgentCoreHarnessMetadata = (project)=>{
+    const metadata = project.metadata;
+    if (metadata?.generator !== AGENTCORE_HARNESS_GENERATOR_INFO.id) {
+        throw new Error(`Project '${project.name}' was not generated by the '${AGENTCORE_HARNESS_GENERATOR_INFO.id}' generator.`);
+    }
+    return metadata;
+};
+export default agentcoreHarnessGenerator;
+
+//# sourceMappingURL=generator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-harness/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  addProjectConfiguration,\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { addTsDependencies } from '../utils/add-dependencies';\nimport { addAgentCoreHarnessInfra } from '../utils/agent-core-constructs/agent-core-constructs';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../utils/format';\nimport { resolveIac } from '../utils/iac';\nimport { installDependencies } from '../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../utils/metrics';\nimport { kebabCase, toClassName } from '../utils/names';\nimport { getNpmScopePrefix } from '../utils/npm-scope';\nimport {\n  addGeneratorMetadata,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  projectExists,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\nimport {\n  SHARED_CONSTRUCTS_DEPENDENCIES,\n  sharedConstructsGenerator,\n} from '../utils/shared-constructs';\nimport type { IacMetadata } from '../utils/shared-constructs-constants';\nimport type { AgentcoreHarnessGeneratorSchema } from './schema';\n\n// scripts/chat.ts needs all of these whatever the infrastructure choice, so no\n// entry is conditional. The harness project holds no manifest of its own, so\n// every entry is declared against the workspace root.\nexport const DEPENDENCIES = declareDependencies<AgentCoreHarnessMetadata>()({\n  ts: [\n    { name: '@aws-sdk/client-bedrock-agentcore', root: true },\n    { name: '@aws-sdk/client-appconfigdata', root: true },\n    { name: '@aws-lambda-powertools/parameters', root: true },\n    { name: 'agent-chat-cli', root: true },\n    // tsx runs the chat script via the `chat` target; both are shared tooling.\n    { name: '@types/node', dev: true, root: true },\n    { name: 'tsx', dev: true, root: true },\n    ...ownedElsewhere(SHARED_CONSTRUCTS_DEPENDENCIES),\n  ],\n});\n\nexport const AGENTCORE_HARNESS_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport const agentcoreHarnessGenerator = async (\n  tree: Tree,\n  options: AgentcoreHarnessGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const nameKebabCase = kebabCase(options.name);\n  const nameClassName = toClassName(nameKebabCase);\n  const parentDir = options.directory ?? 'packages';\n  const subDir = options.subDirectory ?? nameKebabCase;\n  const projectRoot = joinPathFragments(parentDir, subDir);\n  const fullyQualifiedProjectName = `${getNpmScopePrefix(tree)}${nameKebabCase}`;\n  const infra = options.infra ?? 'agentcore';\n\n  // AgentCore harness names must start with an ASCII letter and stay within 40\n  // characters once the \"_<8 hex>\" suffix is appended, so cap the prefix at 31.\n  // toClassName prefixes `_` (not a letter) for digit-leading names.\n  const harnessNamePrefix = (\n    /^[A-Za-z]/.test(nameClassName) ? nameClassName : `H${nameClassName}`\n  ).slice(0, 31);\n\n  // Reuse an existing project configuration; create it otherwise.\n  let project: ProjectConfiguration;\n  if (projectExists(tree, fullyQualifiedProjectName)) {\n    project = readProjectConfigurationUnqualified(\n      tree,\n      fullyQualifiedProjectName,\n    );\n  } else {\n    addProjectConfiguration(tree, fullyQualifiedProjectName, {\n      name: fullyQualifiedProjectName,\n      root: projectRoot,\n      projectType: 'application',\n      sourceRoot: projectRoot,\n      tags: [],\n      targets: {},\n      metadata: {\n        generator: AGENTCORE_HARNESS_GENERATOR_INFO.id,\n      } as any,\n    });\n    project = readProjectConfigurationUnqualified(\n      tree,\n      fullyQualifiedProjectName,\n    );\n  }\n\n  // `chat` runs the vended chat script against the deployed Harness. Re-run:\n  // keep an existing target so user edits survive.\n  project.targets ??= {};\n  project.targets['chat'] ??= {\n    executor: 'nx:run-commands',\n    options: {\n      commands: ['tsx ./scripts/chat.ts'],\n      cwd: '{projectRoot}',\n    },\n  };\n  updateProjectConfiguration(tree, project.name, project);\n\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'project'),\n    projectRoot,\n    {\n      nameClassName,\n      nameKebabCase,\n      fullyQualifiedName: fullyQualifiedProjectName,\n    },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Resolved before the metadata write because the recorded value is what the\n  // declaration's predicates read; undefined when no infrastructure is written,\n  // in which case neither provider's packages were added.\n  const iac =\n    infra === 'agentcore' ? await resolveIac(tree, options.iac) : undefined;\n\n  // Record only what cannot drift once the user owns the generated\n  // infrastructure: the project identity, its runtime config key, its auth mode\n  // and which provider's infrastructure was written.\n  const metadata: Omit<AgentCoreHarnessMetadata, 'generator'> = {\n    name: nameKebabCase,\n    rc: nameClassName,\n    auth: 'iam',\n    ...(iac ? { iac } : {}),\n  };\n\n  addGeneratorMetadata(\n    tree,\n    fullyQualifiedProjectName,\n    AGENTCORE_HARNESS_GENERATOR_INFO,\n    metadata,\n  );\n\n  // scripts/chat.ts dependencies; tsx runs it via the `chat` target.\n  addTsDependencies(tree, DEPENDENCIES, { metadata });\n\n  // Harness infrastructure is written only for `infra: agentcore`. A later\n  // `infra: agentcore` rerun adds it without replacing project files.\n  if (iac) {\n    await sharedConstructsGenerator(tree, { iac }, DEPENDENCIES);\n    await addAgentCoreHarnessInfra(tree, {\n      harnessNameClassName: nameClassName,\n      harnessNameKebabCase: nameKebabCase,\n      projectRoot,\n      harnessNamePrefix,\n      iac,\n    });\n  }\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    AGENTCORE_HARNESS_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\n/**\n * Harness details stored in the Harness Project's metadata. `iac` records which\n * provider's infrastructure was written, so the version sync can tell which\n * shared constructs packages this project owns.\n */\nexport interface AgentCoreHarnessMetadata extends IacMetadata {\n  generator: string;\n  name: string;\n  rc: string;\n  auth: 'iam';\n}\n\n/**\n * Read a Harness Project's metadata, validating it was generated by the\n * agentcore-harness generator before returning typed data.\n */\nexport const readAgentCoreHarnessMetadata = (\n  project: ProjectConfiguration,\n): AgentCoreHarnessMetadata => {\n  const metadata = project.metadata as any;\n  if (metadata?.generator !== AGENTCORE_HARNESS_GENERATOR_INFO.id) {\n    throw new Error(\n      `Project '${project.name}' was not generated by the '${AGENTCORE_HARNESS_GENERATOR_INFO.id}' generator.`,\n    );\n  }\n  return metadata as AgentCoreHarnessMetadata;\n};\n\nexport default agentcoreHarnessGenerator;\n"],"names":["addProjectConfiguration","generateFiles","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","addTsDependencies","addAgentCoreHarnessInfra","declareDependencies","ownedElsewhere","formatFilesInSubtree","resolveIac","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","toClassName","getNpmScopePrefix","addGeneratorMetadata","getGeneratorInfo","projectExists","readProjectConfigurationUnqualified","SHARED_CONSTRUCTS_DEPENDENCIES","sharedConstructsGenerator","DEPENDENCIES","ts","name","root","dev","AGENTCORE_HARNESS_GENERATOR_INFO","filename","agentcoreHarnessGenerator","tree","options","nameKebabCase","nameClassName","parentDir","directory","subDir","subDirectory","projectRoot","fullyQualifiedProjectName","infra","harnessNamePrefix","test","slice","project","projectType","sourceRoot","tags","targets","metadata","generator","id","executor","commands","cwd","dirname","fullyQualifiedName","overwriteStrategy","KeepExisting","iac","undefined","rc","auth","harnessNameClassName","harnessNameKebabCase","preferInstallDependencies","languages","readAgentCoreHarnessMetadata","Error"],"mappings":"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"}

package/src/agentcore-harness/schema.d.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ /**
+ * Options for the agentcore-harness generator, mirroring schema.json.
+ */ export { };
+
+//# sourceMappingURL=schema.d.js.map

package/src/agentcore-harness/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-harness/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { IacOption } from '../utils/iac';\n\n/**\n * Options for the agentcore-harness generator, mirroring schema.json.\n */\nexport interface AgentcoreHarnessGeneratorSchema {\n  name: string;\n  directory?: string;\n  subDirectory?: string;\n  infra?: 'agentcore' | 'none';\n  iac?: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD;;CAEC,GACD,WAOC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { IacOption } from '../utils/iac';
+
+/**
+ * Options for the agentcore-harness generator, mirroring schema.json.
+ */
+export interface AgentcoreHarnessGeneratorSchema {
+  name: string;
+  directory?: string;
+  subDirectory?: string;
+  infra?: 'agentcore' | 'none';
+  iac?: IacOption;
+  preferInstallDependencies?: boolean;
+}

package/src/agentcore-harness/schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "agentcore-harness",
+  "title": "agentcore-harness",
+  "description": "Generate an Amazon Bedrock AgentCore Harness project",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of your AgentCore Harness project. Must contain at least one non-whitespace character which can be normalized into a kebab-case project name (eg. my-harness).",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What would you like to call your AgentCore Harness?",
+      "x-priority": "important",
+      "pattern": "\\S"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Parent directory where the harness project is placed. Defaults to packages. Must be a relative path which does not contain parent directory (..) segments.",
+      "x-priority": "important",
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$))(?=.*\\S).+$"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. Defaults to the kebab-case harness name. Must be a relative path which does not contain parent directory (..) segments.",
+      "x-priority": "important",
+      "pattern": "^(?![A-Za-z]:)(?![\\\\/])(?!.*(?:^|[\\\\/])\\.\\.(?:[\\\\/]|$))(?=.*\\S).+$"
+    },
+    "infra": {
+      "type": "string",
+      "description": "The type of infrastructure to generate for hosting your harness. Defaults to agentcore. Select none for no hosting.",
+      "x-prompt": "How would you like to host your harness?",
+      "x-priority": "important",
+      "enum": ["agentcore", "none"],
+      "default": "agentcore"
+    },
+    "iac": {
+      "type": "string",
+      "description": "The preferred IaC provider for generated harness infrastructure. Defaults to inherit, which uses the provider configured for your workspace.",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: inherit)",
+      "x-priority": "important",
+      "enum": ["inherit", "cdk", "terraform"],
+      "default": "inherit"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Defaults to true. 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."
+    }
+  },
+  "required": ["name"]
+}

package/src/connection/agent-local-dev.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Tree } from '@nx/devkit';
+import { type ComponentMetadata } from '../utils/nx';
+export interface AgentLocalDevOptions {
+    agentNameClassName: string;
+    port: number;
+    targetComponent?: ComponentMetadata;
+    /**
+     * The runtime config namespace to set the local URL on.
+     * E.g. 'apis' results in `runtimeConfig.apis.X = url`
+     */
+    runtimeConfigNamespace: string;
+    /**
+     * The local URL to set in the runtime config override.
+     */
+    localUrl: string;
+    /**
+     * Additional targets to add as dev dependencies.
+     */
+    additionalDependencyTargets?: string[];
+}
+/**
+ * Adds a Strands Agent's component dev target as a dependency of the
+ * source project's dev target, and updates the RuntimeConfig provider
+ * to point to the agent's local URL.
+ *
+ * This is the shared implementation used by both Python and TypeScript Strands
+ * Agent react-connection generators.
+ */
+export declare const addAgentTargetToLocalDev: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: AgentLocalDevOptions) => Promise<void>;
+export interface GatewayLocalDevOptions {
+    gatewayClassName: string;
+    /** Local port the gateway project's dev target listens on. */
+    port: number;
+    /**
+     * Additional targets to add as dev dependencies.
+     */
+    additionalDependencyTargets?: string[];
+}
+/**
+ * Adds an AgentCore Gateway project's dev target as a dependency of the
+ * source project's dev target (transitively starting the gateway's attached
+ * agents), and updates the RuntimeConfig provider to point the gateway's
+ * runtime config entry at the local gateway.
+ */
+export declare const addGatewayTargetToLocalDev: (tree: Tree, sourceProjectName: string, gatewayProjectName: string, options: GatewayLocalDevOptions) => Promise<void>;

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

@@ -0,0 +1,84 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { joinPathFragments, updateProjectConfiguration } from "@nx/devkit";
+import { applyGritQL } from "../utils/ast.js";
+import { addDependencyToTargetIfNotPresent, readProjectConfigurationUnqualified } from "../utils/nx.js";
+/**
+ * Adds a Strands Agent's component dev target as a dependency of the
+ * source project's dev target, and updates the RuntimeConfig provider
+ * to point to the agent's local URL.
+ *
+ * This is the shared implementation used by both Python and TypeScript Strands
+ * Agent react-connection generators.
+ */ export const addAgentTargetToLocalDev = async (tree, sourceProjectName, targetProjectName, options)=>{
+    const sourceProject = readProjectConfigurationUnqualified(tree, sourceProjectName);
+    const targetProject = readProjectConfigurationUnqualified(tree, targetProjectName);
+    // Determine the dev target name for the agent component
+    const agentDevTargetName = options.targetComponent?.name ? `${options.targetComponent.name}-dev` : 'agent-dev';
+    // Target project must have the agent dev target which is continuous
+    if (!(targetProject.targets?.[agentDevTargetName]?.continuous && sourceProject.targets?.['dev'])) {
+        return;
+    }
+    // Add a dependency on the agent dev target (so that the agent's
+    // own dev dependencies, such as MCP servers, are also started)
+    addDependencyToTargetIfNotPresent(sourceProject, 'dev', {
+        projects: [
+            targetProject.name
+        ],
+        target: agentDevTargetName
+    });
+    for (const additional of options.additionalDependencyTargets ?? []){
+        addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);
+    }
+    updateProjectConfiguration(tree, sourceProject.name, sourceProject);
+    await addLocalDevRuntimeConfigOverride(tree, sourceProject, {
+        statement: `runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName} = '${options.localUrl}';`,
+        marker: `runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName}`
+    });
+};
+/**
+ * Adds an AgentCore Gateway project's dev target as a dependency of the
+ * source project's dev target (transitively starting the gateway's attached
+ * agents), and updates the RuntimeConfig provider to point the gateway's
+ * runtime config entry at the local gateway.
+ */ export const addGatewayTargetToLocalDev = async (tree, sourceProjectName, gatewayProjectName, options)=>{
+    const sourceProject = readProjectConfigurationUnqualified(tree, sourceProjectName);
+    const gatewayProject = readProjectConfigurationUnqualified(tree, gatewayProjectName);
+    // A gateway is its own standalone project, so it exposes plain dev
+    if (!(gatewayProject.targets?.['dev']?.continuous && sourceProject.targets?.['dev'])) {
+        return;
+    }
+    addDependencyToTargetIfNotPresent(sourceProject, 'dev', {
+        projects: [
+            gatewayProject.name
+        ],
+        target: 'dev'
+    });
+    for (const additional of options.additionalDependencyTargets ?? []){
+        addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);
+    }
+    updateProjectConfiguration(tree, sourceProject.name, sourceProject);
+    // Spread rather than member assignment: the provider's fetch-failure
+    // fallback config carries no `gateways` key, so assigning into it would
+    // throw and leave the site stuck on the loading spinner. The marker is
+    // this gateway's own local URL (its port is unique per gateway and stable
+    // across re-runs), not the shared `gateways` key, so a website connected to
+    // several gateways gets one override statement per gateway.
+    await addLocalDevRuntimeConfigOverride(tree, sourceProject, {
+        statement: `runtimeConfig.gateways = { ...runtimeConfig.gateways, ${options.gatewayClassName}: 'http://localhost:${options.port}' };`,
+        marker: `'http://localhost:${options.port}'`
+    });
+};
+/**
+ * Add an override statement to the source project's RuntimeConfig provider so
+ * the dev target uses local urls. `marker` guards idempotency: the statement
+ * is only inserted when the overrides don't already contain it. Idempotent.
+ */ const addLocalDevRuntimeConfigOverride = async (tree, sourceProject, options)=>{
+    const runtimeConfigProvider = joinPathFragments(sourceProject.root, 'src', 'components', 'RuntimeConfig', 'index.tsx');
+    if (tree.exists(runtimeConfigProvider)) {
+        await applyGritQL(tree, runtimeConfigProvider, `\`if ($cond) { $stmts }\` => raw\`if ($cond) {\n    $stmts\n    ${options.statement}\n  }\` where { $cond <: contains \`'local-dev'\`, $stmts <: within \`const applyOverrides = $_\`, $stmts <: not contains \`${options.marker}\` }`);
+    }
+};
+
+//# sourceMappingURL=agent-local-dev.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/agent-local-dev.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { applyGritQL } from '../utils/ast';\nimport {\n  addDependencyToTargetIfNotPresent,\n  type ComponentMetadata,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\n\nexport interface AgentLocalDevOptions {\n  agentNameClassName: string;\n  port: number;\n  targetComponent?: ComponentMetadata;\n  /**\n   * The runtime config namespace to set the local URL on.\n   * E.g. 'apis' results in `runtimeConfig.apis.X = url`\n   */\n  runtimeConfigNamespace: string;\n  /**\n   * The local URL to set in the runtime config override.\n   */\n  localUrl: string;\n  /**\n   * Additional targets to add as dev dependencies.\n   */\n  additionalDependencyTargets?: string[];\n}\n\n/**\n * Adds a Strands Agent's component dev target as a dependency of the\n * source project's dev target, and updates the RuntimeConfig provider\n * to point to the agent's local URL.\n *\n * This is the shared implementation used by both Python and TypeScript Strands\n * Agent react-connection generators.\n */\nexport const addAgentTargetToLocalDev = async (\n  tree: Tree,\n  sourceProjectName: string,\n  targetProjectName: string,\n  options: AgentLocalDevOptions,\n) => {\n  const sourceProject = readProjectConfigurationUnqualified(\n    tree,\n    sourceProjectName,\n  );\n  const targetProject = readProjectConfigurationUnqualified(\n    tree,\n    targetProjectName,\n  );\n\n  // Determine the dev target name for the agent component\n  const agentDevTargetName = options.targetComponent?.name\n    ? `${options.targetComponent.name}-dev`\n    : 'agent-dev';\n\n  // Target project must have the agent dev target which is continuous\n  if (\n    !(\n      targetProject.targets?.[agentDevTargetName]?.continuous &&\n      sourceProject.targets?.['dev']\n    )\n  ) {\n    return;\n  }\n\n  // Add a dependency on the agent dev target (so that the agent's\n  // own dev dependencies, such as MCP servers, are also started)\n  addDependencyToTargetIfNotPresent(sourceProject, 'dev', {\n    projects: [targetProject.name],\n    target: agentDevTargetName,\n  });\n  for (const additional of options.additionalDependencyTargets ?? []) {\n    addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);\n  }\n  updateProjectConfiguration(tree, sourceProject.name, sourceProject);\n\n  await addLocalDevRuntimeConfigOverride(tree, sourceProject, {\n    statement: `runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName} = '${options.localUrl}';`,\n    marker: `runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName}`,\n  });\n};\n\nexport interface GatewayLocalDevOptions {\n  gatewayClassName: string;\n  /** Local port the gateway project's dev target listens on. */\n  port: number;\n  /**\n   * Additional targets to add as dev dependencies.\n   */\n  additionalDependencyTargets?: string[];\n}\n\n/**\n * Adds an AgentCore Gateway project's dev target as a dependency of the\n * source project's dev target (transitively starting the gateway's attached\n * agents), and updates the RuntimeConfig provider to point the gateway's\n * runtime config entry at the local gateway.\n */\nexport const addGatewayTargetToLocalDev = async (\n  tree: Tree,\n  sourceProjectName: string,\n  gatewayProjectName: string,\n  options: GatewayLocalDevOptions,\n) => {\n  const sourceProject = readProjectConfigurationUnqualified(\n    tree,\n    sourceProjectName,\n  );\n  const gatewayProject = readProjectConfigurationUnqualified(\n    tree,\n    gatewayProjectName,\n  );\n\n  // A gateway is its own standalone project, so it exposes plain dev\n  if (\n    !(\n      gatewayProject.targets?.['dev']?.continuous &&\n      sourceProject.targets?.['dev']\n    )\n  ) {\n    return;\n  }\n\n  addDependencyToTargetIfNotPresent(sourceProject, 'dev', {\n    projects: [gatewayProject.name],\n    target: 'dev',\n  });\n  for (const additional of options.additionalDependencyTargets ?? []) {\n    addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);\n  }\n  updateProjectConfiguration(tree, sourceProject.name, sourceProject);\n\n  // Spread rather than member assignment: the provider's fetch-failure\n  // fallback config carries no `gateways` key, so assigning into it would\n  // throw and leave the site stuck on the loading spinner. The marker is\n  // this gateway's own local URL (its port is unique per gateway and stable\n  // across re-runs), not the shared `gateways` key, so a website connected to\n  // several gateways gets one override statement per gateway.\n  await addLocalDevRuntimeConfigOverride(tree, sourceProject, {\n    statement: `runtimeConfig.gateways = { ...runtimeConfig.gateways, ${options.gatewayClassName}: 'http://localhost:${options.port}' };`,\n    marker: `'http://localhost:${options.port}'`,\n  });\n};\n\n/**\n * Add an override statement to the source project's RuntimeConfig provider so\n * the dev target uses local urls. `marker` guards idempotency: the statement\n * is only inserted when the overrides don't already contain it. Idempotent.\n */\nconst addLocalDevRuntimeConfigOverride = async (\n  tree: Tree,\n  sourceProject: { root: string },\n  options: { statement: string; marker: string },\n) => {\n  const runtimeConfigProvider = joinPathFragments(\n    sourceProject.root,\n    'src',\n    'components',\n    'RuntimeConfig',\n    'index.tsx',\n  );\n  if (tree.exists(runtimeConfigProvider)) {\n    await applyGritQL(\n      tree,\n      runtimeConfigProvider,\n      `\\`if ($cond) { $stmts }\\` => raw\\`if ($cond) {\\n    $stmts\\n    ${options.statement}\\n  }\\` where { $cond <: contains \\`'local-dev'\\`, $stmts <: within \\`const applyOverrides = $_\\`, $stmts <: not contains \\`${options.marker}\\` }`,\n    );\n  }\n};\n"],"names":["joinPathFragments","updateProjectConfiguration","applyGritQL","addDependencyToTargetIfNotPresent","readProjectConfigurationUnqualified","addAgentTargetToLocalDev","tree","sourceProjectName","targetProjectName","options","sourceProject","targetProject","agentDevTargetName","targetComponent","name","targets","continuous","projects","target","additional","additionalDependencyTargets","addLocalDevRuntimeConfigOverride","statement","runtimeConfigNamespace","agentNameClassName","localUrl","marker","addGatewayTargetToLocalDev","gatewayProjectName","gatewayProject","gatewayClassName","port","runtimeConfigProvider","root","exists"],"mappings":"AAAA;;;CAGC,GACD,SACEA,iBAAiB,EAEjBC,0BAA0B,QACrB,aAAa;AACpB,SAASC,WAAW,QAAQ,kBAAe;AAC3C,SACEC,iCAAiC,EAEjCC,mCAAmC,QAC9B,iBAAc;AAqBrB;;;;;;;CAOC,GACD,OAAO,MAAMC,2BAA2B,OACtCC,MACAC,mBACAC,mBACAC;IAEA,MAAMC,gBAAgBN,oCACpBE,MACAC;IAEF,MAAMI,gBAAgBP,oCACpBE,MACAE;IAGF,wDAAwD;IACxD,MAAMI,qBAAqBH,QAAQI,eAAe,EAAEC,OAChD,GAAGL,QAAQI,eAAe,CAACC,IAAI,CAAC,IAAI,CAAC,GACrC;IAEJ,oEAAoE;IACpE,IACE,CACEH,CAAAA,cAAcI,OAAO,EAAE,CAACH,mBAAmB,EAAEI,cAC7CN,cAAcK,OAAO,EAAE,CAAC,MAAM,AAAD,GAE/B;QACA;IACF;IAEA,gEAAgE;IAChE,+DAA+D;IAC/DZ,kCAAkCO,eAAe,OAAO;QACtDO,UAAU;YAACN,cAAcG,IAAI;SAAC;QAC9BI,QAAQN;IACV;IACA,KAAK,MAAMO,cAAcV,QAAQW,2BAA2B,IAAI,EAAE,CAAE;QAClEjB,kCAAkCO,eAAe,OAAOS;IAC1D;IACAlB,2BAA2BK,MAAMI,cAAcI,IAAI,EAAEJ;IAErD,MAAMW,iCAAiCf,MAAMI,eAAe;QAC1DY,WAAW,CAAC,cAAc,EAAEb,QAAQc,sBAAsB,CAAC,CAAC,EAAEd,QAAQe,kBAAkB,CAAC,IAAI,EAAEf,QAAQgB,QAAQ,CAAC,EAAE,CAAC;QACnHC,QAAQ,CAAC,cAAc,EAAEjB,QAAQc,sBAAsB,CAAC,CAAC,EAAEd,QAAQe,kBAAkB,EAAE;IACzF;AACF,EAAE;AAYF;;;;;CAKC,GACD,OAAO,MAAMG,6BAA6B,OACxCrB,MACAC,mBACAqB,oBACAnB;IAEA,MAAMC,gBAAgBN,oCACpBE,MACAC;IAEF,MAAMsB,iBAAiBzB,oCACrBE,MACAsB;IAGF,mEAAmE;IACnE,IACE,CACEC,CAAAA,eAAed,OAAO,EAAE,CAAC,MAAM,EAAEC,cACjCN,cAAcK,OAAO,EAAE,CAAC,MAAM,AAAD,GAE/B;QACA;IACF;IAEAZ,kCAAkCO,eAAe,OAAO;QACtDO,UAAU;YAACY,eAAef,IAAI;SAAC;QAC/BI,QAAQ;IACV;IACA,KAAK,MAAMC,cAAcV,QAAQW,2BAA2B,IAAI,EAAE,CAAE;QAClEjB,kCAAkCO,eAAe,OAAOS;IAC1D;IACAlB,2BAA2BK,MAAMI,cAAcI,IAAI,EAAEJ;IAErD,qEAAqE;IACrE,wEAAwE;IACxE,uEAAuE;IACvE,0EAA0E;IAC1E,4EAA4E;IAC5E,4DAA4D;IAC5D,MAAMW,iCAAiCf,MAAMI,eAAe;QAC1DY,WAAW,CAAC,sDAAsD,EAAEb,QAAQqB,gBAAgB,CAAC,oBAAoB,EAAErB,QAAQsB,IAAI,CAAC,IAAI,CAAC;QACrIL,QAAQ,CAAC,kBAAkB,EAAEjB,QAAQsB,IAAI,CAAC,CAAC,CAAC;IAC9C;AACF,EAAE;AAEF;;;;CAIC,GACD,MAAMV,mCAAmC,OACvCf,MACAI,eACAD;IAEA,MAAMuB,wBAAwBhC,kBAC5BU,cAAcuB,IAAI,EAClB,OACA,cACA,iBACA;IAEF,IAAI3B,KAAK4B,MAAM,CAACF,wBAAwB;QACtC,MAAM9B,YACJI,MACA0B,uBACA,CAAC,gEAAgE,EAAEvB,QAAQa,SAAS,CAAC,4HAA4H,EAAEb,QAAQiB,MAAM,CAAC,IAAI,CAAC;IAE3O;AACF"}

package/src/connection/agent-runtime-config.js

@@ -1,13 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addAgentRuntimeToConnectionNamespace = 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 ast_1 = require("../utils/ast");
-const shared_constructs_constants_1 = require("../utils/shared-constructs-constants");
+ */ import { joinPathFragments } from "@nx/devkit";
+import { applyGritQL, matchGritQL } from "../utils/ast.js";
+import { PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, SHARED_TERRAFORM_DIR } from "../utils/shared-constructs-constants.js";
 const CONNECTION_TF_MODULE_NAME = 'add_agent_runtime_to_connection_runtime_config';
 /**
  * Register the agent's runtime ARN in the 'connection' namespace so it is
@@ -16,20 +12,19 @@ const CONNECTION_TF_MODULE_NAME = 'add_agent_runtime_to_connection_runtime_confi
  *
  * Note: the 'connection' namespace is stage-scoped — every StaticWebsite in
  * the stage will see this ARN, not just the one the user connected.
- */
-const addAgentRuntimeToConnectionNamespace = async (tree, options) => {
-    const cdkConstructPath = (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_CONSTRUCTS_DIR, 'src', 'app', 'agents', options.agentNameKebabCase, `${options.agentNameKebabCase}.ts`);
+ */ export const addAgentRuntimeToConnectionNamespace = async (tree, options)=>{
+    const cdkConstructPath = joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'agents', options.agentNameKebabCase, `${options.agentNameKebabCase}.ts`);
     if (tree.exists(cdkConstructPath)) {
-        await (0, ast_1.applyGritQL)(tree, cdkConstructPath, `\`rc.set('agentcore', 'agentRuntimes', $args);\` => raw\`rc.set('agentcore', 'agentRuntimes', $args);
+        await applyGritQL(tree, cdkConstructPath, `\`rc.set('agentcore', 'agentRuntimes', $args);\` => raw\`rc.set('agentcore', 'agentRuntimes', $args);
 
     rc.set('connection', 'agentRuntimes', {
       ...rc.get('connection').agentRuntimes,
       ${options.agentNameClassName}: this.agentCoreRuntime.agentRuntimeArn,
     });\` where { $program <: not contains \`rc.set('connection', 'agentRuntimes', $_)\` }`);
     }
-    const terraformConstructPath = (0, devkit_1.joinPathFragments)(shared_constructs_constants_1.PACKAGES_DIR, shared_constructs_constants_1.SHARED_TERRAFORM_DIR, 'src', 'app', 'agents', options.agentNameKebabCase, `${options.agentNameKebabCase}.tf`);
+    const terraformConstructPath = joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'app', 'agents', options.agentNameKebabCase, `${options.agentNameKebabCase}.tf`);
     if (tree.exists(terraformConstructPath)) {
-        const alreadyPatched = await (0, ast_1.matchGritQL)(tree, terraformConstructPath, `language hcl\n\`module "${CONNECTION_TF_MODULE_NAME}" { $_ }\``);
+        const alreadyPatched = await matchGritQL(tree, terraformConstructPath, `language hcl\n\`module "${CONNECTION_TF_MODULE_NAME}" { $_ }\``);
         if (!alreadyPatched) {
             const source = tree.read(terraformConstructPath, 'utf-8');
             tree.write(terraformConstructPath, `${source.trimEnd()}
@@ -48,5 +43,5 @@ module "${CONNECTION_TF_MODULE_NAME}" {
         }
     }
 };
-exports.addAgentRuntimeToConnectionNamespace = addAgentRuntimeToConnectionNamespace;
+
 //# sourceMappingURL=agent-runtime-config.js.map

package/src/connection/agent-runtime-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runtime-config.js","sourceRoot":"","sources":["../../../../../packages/nx-plugin/src/connection/agent-runtime-config.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,uCAA0D;AAC1D,sCAAwD;AACxD,sFAI8C;AAE9C,MAAM,yBAAyB,GAC7B,gDAAgD,CAAC;AAEnD;;;;;;;GAOG;AACI,MAAM,oCAAoC,GAAG,KAAK,EACvD,IAAU,EACV,OAKC,EACD,EAAE;IACF,MAAM,gBAAgB,GAAG,IAAA,0BAAiB,EACxC,0CAAY,EACZ,mDAAqB,EACrB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,CAAC,kBAAkB,EAC1B,GAAG,OAAO,CAAC,kBAAkB,KAAK,CACnC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAClC,MAAM,IAAA,iBAAW,EACf,IAAI,EACJ,gBAAgB,EAChB;;;;QAIE,OAAO,CAAC,kBAAkB;2FACyD,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,sBAAsB,GAAG,IAAA,0BAAiB,EAC9C,0CAAY,EACZ,kDAAoB,EACpB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,CAAC,kBAAkB,EAC1B,GAAG,OAAO,CAAC,kBAAkB,KAAK,CACnC,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACxC,MAAM,cAAc,GAAG,MAAM,IAAA,iBAAW,EACtC,IAAI,EACJ,sBAAsB,EACtB,2BAA2B,yBAAyB,YAAY,CACjE,CAAC;QACF,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAE,CAAC;YAC3D,IAAI,CAAC,KAAK,CACR,sBAAsB,EACtB,GAAG,MAAM,CAAC,OAAO,EAAE;;;UAGjB,yBAAyB;;;;;mBAKhB,OAAO,CAAC,kBAAkB;;;;CAI5C,CACM,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAlEW,QAAA,oCAAoC,wCAkE/C"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/agent-runtime-config.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { joinPathFragments, type Tree } from '@nx/devkit';\nimport { applyGritQL, matchGritQL } from '../utils/ast';\nimport {\n  PACKAGES_DIR,\n  SHARED_CONSTRUCTS_DIR,\n  SHARED_TERRAFORM_DIR,\n} from '../utils/shared-constructs-constants';\n\nconst CONNECTION_TF_MODULE_NAME =\n  'add_agent_runtime_to_connection_runtime_config';\n\n/**\n * Register the agent's runtime ARN in the 'connection' namespace so it is\n * published to the website's runtime-config.json. Patches the generated CDK\n * and Terraform constructs in-place; idempotent.\n *\n * Note: the 'connection' namespace is stage-scoped — every StaticWebsite in\n * the stage will see this ARN, not just the one the user connected.\n */\nexport const addAgentRuntimeToConnectionNamespace = async (\n  tree: Tree,\n  options: {\n    /** The kebab-case directory name that holds the construct, e.g. 'story-agent'. */\n    agentNameKebabCase: string;\n    /** The class name of the agent, e.g. 'StoryAgent'. */\n    agentNameClassName: string;\n  },\n) => {\n  const cdkConstructPath = joinPathFragments(\n    PACKAGES_DIR,\n    SHARED_CONSTRUCTS_DIR,\n    'src',\n    'app',\n    'agents',\n    options.agentNameKebabCase,\n    `${options.agentNameKebabCase}.ts`,\n  );\n  if (tree.exists(cdkConstructPath)) {\n    await applyGritQL(\n      tree,\n      cdkConstructPath,\n      `\\`rc.set('agentcore', 'agentRuntimes', $args);\\` => raw\\`rc.set('agentcore', 'agentRuntimes', $args);\n\n    rc.set('connection', 'agentRuntimes', {\n      ...rc.get('connection').agentRuntimes,\n      ${options.agentNameClassName}: this.agentCoreRuntime.agentRuntimeArn,\n    });\\` where { $program <: not contains \\`rc.set('connection', 'agentRuntimes', $_)\\` }`,\n    );\n  }\n\n  const terraformConstructPath = joinPathFragments(\n    PACKAGES_DIR,\n    SHARED_TERRAFORM_DIR,\n    'src',\n    'app',\n    'agents',\n    options.agentNameKebabCase,\n    `${options.agentNameKebabCase}.tf`,\n  );\n  if (tree.exists(terraformConstructPath)) {\n    const alreadyPatched = await matchGritQL(\n      tree,\n      terraformConstructPath,\n      `language hcl\\n\\`module \"${CONNECTION_TF_MODULE_NAME}\" { $_ }\\``,\n    );\n    if (!alreadyPatched) {\n      const source = tree.read(terraformConstructPath, 'utf-8')!;\n      tree.write(\n        terraformConstructPath,\n        `${source.trimEnd()}\n\n# Also expose the agent runtime ARN to the frontend via the 'connection' namespace\nmodule \"${CONNECTION_TF_MODULE_NAME}\" {\n  source = \"../../../core/runtime-config/entry\"\n\n  namespace = \"connection\"\n  key       = \"agentRuntimes\"\n  value     = { \"${options.agentNameClassName}\" = module.agent_core_runtime.agent_core_runtime_arn }\n\n  depends_on = [module.agent_core_runtime]\n}\n`,\n      );\n    }\n  }\n};\n"],"names":["joinPathFragments","applyGritQL","matchGritQL","PACKAGES_DIR","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_DIR","CONNECTION_TF_MODULE_NAME","addAgentRuntimeToConnectionNamespace","tree","options","cdkConstructPath","agentNameKebabCase","exists","agentNameClassName","terraformConstructPath","alreadyPatched","source","read","write","trimEnd"],"mappings":"AAAA;;;CAGC,GACD,SAASA,iBAAiB,QAAmB,aAAa;AAC1D,SAASC,WAAW,EAAEC,WAAW,QAAQ,kBAAe;AACxD,SACEC,YAAY,EACZC,qBAAqB,EACrBC,oBAAoB,QACf,0CAAuC;AAE9C,MAAMC,4BACJ;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,uCAAuC,OAClDC,MACAC;IAOA,MAAMC,mBAAmBV,kBACvBG,cACAC,uBACA,OACA,OACA,UACAK,QAAQE,kBAAkB,EAC1B,GAAGF,QAAQE,kBAAkB,CAAC,GAAG,CAAC;IAEpC,IAAIH,KAAKI,MAAM,CAACF,mBAAmB;QACjC,MAAMT,YACJO,MACAE,kBACA,CAAC;;;;MAID,EAAED,QAAQI,kBAAkB,CAAC;0FACuD,CAAC;IAEzF;IAEA,MAAMC,yBAAyBd,kBAC7BG,cACAE,sBACA,OACA,OACA,UACAI,QAAQE,kBAAkB,EAC1B,GAAGF,QAAQE,kBAAkB,CAAC,GAAG,CAAC;IAEpC,IAAIH,KAAKI,MAAM,CAACE,yBAAyB;QACvC,MAAMC,iBAAiB,MAAMb,YAC3BM,MACAM,wBACA,CAAC,wBAAwB,EAAER,0BAA0B,UAAU,CAAC;QAElE,IAAI,CAACS,gBAAgB;YACnB,MAAMC,SAASR,KAAKS,IAAI,CAACH,wBAAwB;YACjDN,KAAKU,KAAK,CACRJ,wBACA,GAAGE,OAAOG,OAAO,GAAG;;;QAGpB,EAAEb,0BAA0B;;;;;iBAKnB,EAAEG,QAAQI,kBAAkB,CAAC;;;;AAI9C,CAAC;QAEG;IACF;AACF,EAAE"}

package/src/connection/gateway-runtime-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Tree } from '@nx/devkit';
+/**
+ * Register the gateway's URL in the 'connection' namespace so it is published
+ * to the website's runtime-config.json. Patches the generated CDK and
+ * Terraform constructs in-place; idempotent.
+ *
+ * Note: the 'connection' namespace is stage-scoped — every StaticWebsite in
+ * the stage will see this URL, not just the one the user connected.
+ */
+export declare const addGatewayUrlToConnectionNamespace: (tree: Tree, options: {
+    /** The kebab-case directory name that holds the construct, e.g. 'my-gateway'. */
+    gatewayNameKebabCase: string;
+    /** The class name of the gateway, e.g. 'MyGateway'. */
+    gatewayNameClassName: string;
+}) => Promise<void>;

package/src/connection/gateway-runtime-config.js

@@ -0,0 +1,47 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */ import { joinPathFragments } from "@nx/devkit";
+import { applyGritQL, matchGritQL } from "../utils/ast.js";
+import { PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, SHARED_TERRAFORM_DIR } from "../utils/shared-constructs-constants.js";
+const CONNECTION_TF_MODULE_NAME = 'add_gateway_url_to_connection_runtime_config';
+/**
+ * Register the gateway's URL in the 'connection' namespace so it is published
+ * to the website's runtime-config.json. Patches the generated CDK and
+ * Terraform constructs in-place; idempotent.
+ *
+ * Note: the 'connection' namespace is stage-scoped — every StaticWebsite in
+ * the stage will see this URL, not just the one the user connected.
+ */ export const addGatewayUrlToConnectionNamespace = async (tree, options)=>{
+    const cdkConstructPath = joinPathFragments(PACKAGES_DIR, SHARED_CONSTRUCTS_DIR, 'src', 'app', 'gateways', options.gatewayNameKebabCase, `${options.gatewayNameKebabCase}.ts`);
+    if (tree.exists(cdkConstructPath)) {
+        await applyGritQL(tree, cdkConstructPath, `\`rc.set('agentcore', 'gateways', $args);\` => raw\`rc.set('agentcore', 'gateways', $args);
+
+    rc.set('connection', 'gateways', {
+      ...rc.get('connection').gateways,
+      ${options.gatewayNameClassName}: this.gateway.gatewayUrl,
+    });\` where { $program <: not contains \`rc.set('connection', 'gateways', $_)\` }`);
+    }
+    const terraformConstructPath = joinPathFragments(PACKAGES_DIR, SHARED_TERRAFORM_DIR, 'src', 'app', 'gateways', options.gatewayNameKebabCase, `${options.gatewayNameKebabCase}.tf`);
+    if (tree.exists(terraformConstructPath)) {
+        const alreadyPatched = await matchGritQL(tree, terraformConstructPath, `language hcl\n\`module "${CONNECTION_TF_MODULE_NAME}" { $_ }\``);
+        if (!alreadyPatched) {
+            const source = tree.read(terraformConstructPath, 'utf-8');
+            tree.write(terraformConstructPath, `${source.trimEnd()}
+
+# Also expose the gateway URL to the frontend via the 'connection' namespace
+module "${CONNECTION_TF_MODULE_NAME}" {
+  source = "../../../core/runtime-config/entry"
+
+  namespace = "connection"
+  key       = "gateways"
+  value     = { "${options.gatewayNameClassName}" = aws_bedrockagentcore_gateway.this.gateway_url }
+
+  depends_on = [aws_bedrockagentcore_gateway.this]
+}
+`);
+        }
+    }
+};
+
+//# sourceMappingURL=gateway-runtime-config.js.map

package/src/connection/gateway-runtime-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/gateway-runtime-config.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport { joinPathFragments, type Tree } from '@nx/devkit';\nimport { applyGritQL, matchGritQL } from '../utils/ast';\nimport {\n  PACKAGES_DIR,\n  SHARED_CONSTRUCTS_DIR,\n  SHARED_TERRAFORM_DIR,\n} from '../utils/shared-constructs-constants';\n\nconst CONNECTION_TF_MODULE_NAME =\n  'add_gateway_url_to_connection_runtime_config';\n\n/**\n * Register the gateway's URL in the 'connection' namespace so it is published\n * to the website's runtime-config.json. Patches the generated CDK and\n * Terraform constructs in-place; idempotent.\n *\n * Note: the 'connection' namespace is stage-scoped — every StaticWebsite in\n * the stage will see this URL, not just the one the user connected.\n */\nexport const addGatewayUrlToConnectionNamespace = async (\n  tree: Tree,\n  options: {\n    /** The kebab-case directory name that holds the construct, e.g. 'my-gateway'. */\n    gatewayNameKebabCase: string;\n    /** The class name of the gateway, e.g. 'MyGateway'. */\n    gatewayNameClassName: string;\n  },\n) => {\n  const cdkConstructPath = joinPathFragments(\n    PACKAGES_DIR,\n    SHARED_CONSTRUCTS_DIR,\n    'src',\n    'app',\n    'gateways',\n    options.gatewayNameKebabCase,\n    `${options.gatewayNameKebabCase}.ts`,\n  );\n  if (tree.exists(cdkConstructPath)) {\n    await applyGritQL(\n      tree,\n      cdkConstructPath,\n      `\\`rc.set('agentcore', 'gateways', $args);\\` => raw\\`rc.set('agentcore', 'gateways', $args);\n\n    rc.set('connection', 'gateways', {\n      ...rc.get('connection').gateways,\n      ${options.gatewayNameClassName}: this.gateway.gatewayUrl,\n    });\\` where { $program <: not contains \\`rc.set('connection', 'gateways', $_)\\` }`,\n    );\n  }\n\n  const terraformConstructPath = joinPathFragments(\n    PACKAGES_DIR,\n    SHARED_TERRAFORM_DIR,\n    'src',\n    'app',\n    'gateways',\n    options.gatewayNameKebabCase,\n    `${options.gatewayNameKebabCase}.tf`,\n  );\n  if (tree.exists(terraformConstructPath)) {\n    const alreadyPatched = await matchGritQL(\n      tree,\n      terraformConstructPath,\n      `language hcl\\n\\`module \"${CONNECTION_TF_MODULE_NAME}\" { $_ }\\``,\n    );\n    if (!alreadyPatched) {\n      const source = tree.read(terraformConstructPath, 'utf-8')!;\n      tree.write(\n        terraformConstructPath,\n        `${source.trimEnd()}\n\n# Also expose the gateway URL to the frontend via the 'connection' namespace\nmodule \"${CONNECTION_TF_MODULE_NAME}\" {\n  source = \"../../../core/runtime-config/entry\"\n\n  namespace = \"connection\"\n  key       = \"gateways\"\n  value     = { \"${options.gatewayNameClassName}\" = aws_bedrockagentcore_gateway.this.gateway_url }\n\n  depends_on = [aws_bedrockagentcore_gateway.this]\n}\n`,\n      );\n    }\n  }\n};\n"],"names":["joinPathFragments","applyGritQL","matchGritQL","PACKAGES_DIR","SHARED_CONSTRUCTS_DIR","SHARED_TERRAFORM_DIR","CONNECTION_TF_MODULE_NAME","addGatewayUrlToConnectionNamespace","tree","options","cdkConstructPath","gatewayNameKebabCase","exists","gatewayNameClassName","terraformConstructPath","alreadyPatched","source","read","write","trimEnd"],"mappings":"AAAA;;;CAGC,GACD,SAASA,iBAAiB,QAAmB,aAAa;AAC1D,SAASC,WAAW,EAAEC,WAAW,QAAQ,kBAAe;AACxD,SACEC,YAAY,EACZC,qBAAqB,EACrBC,oBAAoB,QACf,0CAAuC;AAE9C,MAAMC,4BACJ;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,qCAAqC,OAChDC,MACAC;IAOA,MAAMC,mBAAmBV,kBACvBG,cACAC,uBACA,OACA,OACA,YACAK,QAAQE,oBAAoB,EAC5B,GAAGF,QAAQE,oBAAoB,CAAC,GAAG,CAAC;IAEtC,IAAIH,KAAKI,MAAM,CAACF,mBAAmB;QACjC,MAAMT,YACJO,MACAE,kBACA,CAAC;;;;MAID,EAAED,QAAQI,oBAAoB,CAAC;qFACgD,CAAC;IAEpF;IAEA,MAAMC,yBAAyBd,kBAC7BG,cACAE,sBACA,OACA,OACA,YACAI,QAAQE,oBAAoB,EAC5B,GAAGF,QAAQE,oBAAoB,CAAC,GAAG,CAAC;IAEtC,IAAIH,KAAKI,MAAM,CAACE,yBAAyB;QACvC,MAAMC,iBAAiB,MAAMb,YAC3BM,MACAM,wBACA,CAAC,wBAAwB,EAAER,0BAA0B,UAAU,CAAC;QAElE,IAAI,CAACS,gBAAgB;YACnB,MAAMC,SAASR,KAAKS,IAAI,CAACH,wBAAwB;YACjDN,KAAKU,KAAK,CACRJ,wBACA,GAAGE,OAAOG,OAAO,GAAG;;;QAGpB,EAAEb,0BAA0B;;;;;iBAKnB,EAAEG,QAAQI,oBAAoB,CAAC;;;;AAIhD,CAAC;QAEG;IACF;AACF,EAAE"}

package/src/connection/generator.d.ts

@@ -5,17 +5,9 @@
 import { type ProjectConfiguration, type Tree } from '@nx/devkit';
 import { type ComponentMetadata } from '../utils/nx';
 import type { ConnectionGeneratorSchema } from './schema';
-/**
- * List of supported source and target project types for connections.
- * These can be project-level types (determined by introspection) or
- * component generator ids (from component metadata).
- */
-declare const SUPPORTED_PROJECT_TYPES: readonly ["ts#trpc-api", "py#fast-api", "react", "smithy", "ts#rdb", "ts#dynamodb"];
+import { type Connection, type SUPPORTED_PROJECT_TYPES } from './supported-connections';
+export type { Connection };
 type ProjectType = (typeof SUPPORTED_PROJECT_TYPES)[number];
-export type Connection = {
-    source: string;
-    target: string;
-};
 /**
  * Sentinel value for sourceComponent/targetComponent that means
  * "use the project-level connection, not a component".
@@ -41,6 +33,7 @@ export interface ResolvedConnectionOptions {
     targetProject: string;
     sourceComponent?: ComponentMetadata;
     targetComponent?: ComponentMetadata;
+    preferInstallDependencies?: boolean;
 }
 /**
  * Generator for a connection between two projects