@aws/nx-plugin 1.0.0-rc.58 → 1.0.0-rc.59

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

@@ -32,10 +32,52 @@ import { addDependencyToTargetIfNotPresent, readProjectConfigurationUnqualified
         addDependencyToTargetIfNotPresent(sourceProject, 'dev', additional);
     }
     updateProjectConfiguration(tree, sourceProject.name, sourceProject);
-    // Add an override to runtime-config for the dev target to use the local url
+    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    runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName} = '${options.localUrl}';\n  }\` where { $cond <: contains \`'local-dev'\`, $stmts <: within \`const applyOverrides = $_\`, $stmts <: not contains \`runtimeConfig.${options.runtimeConfigNamespace}.${options.agentNameClassName}\` }`);
+        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}\` }`);
     }
 };
 

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

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

@@ -2,9 +2,11 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */ import { joinPathFragments } from "@nx/devkit";
+import agentcoreGatewayAgentConnectionGenerator from "../agentcore-gateway/agent-connection/generator.js";
 import agentcoreGatewayGatewayConnectionGenerator from "../agentcore-gateway/gateway-connection/generator.js";
 import { AGENTCORE_GATEWAY_GENERATOR_INFO } from "../agentcore-gateway/generator.js";
 import agentcoreGatewayMcpConnectionGenerator from "../agentcore-gateway/mcp-connection/generator.js";
+import agentcoreGatewayReactConnectionGenerator from "../agentcore-gateway/react-connection/generator.js";
 import pyAgentA2aConnectionGenerator from "../py/agent/a2a-connection/generator.js";
 import pyAgentGatewayConnectionGenerator from "../py/agent/gateway-connection/generator.js";
 import pyAgentMcpConnectionGenerator from "../py/agent/mcp-connection/generator.js";
@@ -80,6 +82,9 @@ const CONNECTION_GENERATORS = {
     'py#agent -> py#agent': (tree, options)=>pyAgentA2aConnectionGenerator(tree, options),
     'ts#agent -> agentcore-gateway': (tree, options)=>tsAgentGatewayConnectionGenerator(tree, options),
     'py#agent -> agentcore-gateway': (tree, options)=>pyAgentGatewayConnectionGenerator(tree, options),
+    'ts#react-website -> agentcore-gateway': (tree, options)=>agentcoreGatewayReactConnectionGenerator(tree, options),
+    'agentcore-gateway -> ts#agent': (tree, options)=>agentcoreGatewayAgentConnectionGenerator(tree, options),
+    'agentcore-gateway -> py#agent': (tree, options)=>agentcoreGatewayAgentConnectionGenerator(tree, options),
     'agentcore-gateway -> ts#mcp-server': (tree, options)=>agentcoreGatewayMcpConnectionGenerator(tree, options),
     'agentcore-gateway -> py#mcp-server': (tree, options)=>agentcoreGatewayMcpConnectionGenerator(tree, options),
     'agentcore-gateway -> agentcore-gateway': (tree, options)=>agentcoreGatewayGatewayConnectionGenerator(tree, options),

package/src/connection/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport agentcoreGatewayGatewayConnectionGenerator from '../agentcore-gateway/gateway-connection/generator';\nimport { AGENTCORE_GATEWAY_GENERATOR_INFO } from '../agentcore-gateway/generator';\nimport agentcoreGatewayMcpConnectionGenerator from '../agentcore-gateway/mcp-connection/generator';\nimport pyAgentA2aConnectionGenerator from '../py/agent/a2a-connection/generator';\nimport pyAgentGatewayConnectionGenerator from '../py/agent/gateway-connection/generator';\nimport pyAgentMcpConnectionGenerator from '../py/agent/mcp-connection/generator';\nimport pyAgentReactConnectionGenerator from '../py/agent/react-connection/generator';\nimport pyDynamoDBAgentConnectionGenerator from '../py/dynamodb/agent-connection/generator';\nimport pyDynamoDBFastApiConnectionGenerator from '../py/dynamodb/fast-api-connection/generator';\nimport { PY_DYNAMODB_GENERATOR_INFO } from '../py/dynamodb/generator';\nimport pyDynamoDBMcpServerConnectionGenerator from '../py/dynamodb/mcp-server-connection/generator';\nimport fastApiReactGenerator from '../py/fast-api/react/generator';\nimport pyRdbAgentConnectionGenerator from '../py/rdb/agent-connection/generator';\nimport pyRdbFastApiConnectionGenerator from '../py/rdb/fast-api-connection/generator';\nimport { PY_RDB_GENERATOR_INFO } from '../py/rdb/generator';\nimport pyRdbMcpServerConnectionGenerator from '../py/rdb/mcp-server-connection/generator';\nimport { SMITHY_PROJECT_GENERATOR_INFO } from '../smithy/project/generator';\nimport smithyReactConnectionGenerator from '../smithy/react-connection/generator';\nimport { TS_SMITHY_API_GENERATOR_INFO } from '../smithy/ts/api/generator';\nimport trpcReactGenerator from '../trpc/react/generator';\nimport tsAgentA2aConnectionGenerator from '../ts/agent/a2a-connection/generator';\nimport tsAgentGatewayConnectionGenerator from '../ts/agent/gateway-connection/generator';\nimport tsAgentMcpConnectionGenerator from '../ts/agent/mcp-connection/generator';\nimport tsAgentReactConnectionGenerator from '../ts/agent/react-connection/generator';\nimport tsDynamoDBAgentConnectionGenerator from '../ts/dynamodb/agent-connection/generator';\nimport { TS_DYNAMODB_GENERATOR_INFO } from '../ts/dynamodb/generator';\nimport tsDynamoDBMcpServerConnectionGenerator from '../ts/dynamodb/mcp-server-connection/generator';\nimport tsDynamoDBSmithyConnectionGenerator from '../ts/dynamodb/smithy-connection/generator';\nimport tsDynamoDBTrpcConnectionGenerator from '../ts/dynamodb/trpc-connection/generator';\nimport tsRdbAgentConnectionGenerator from '../ts/rdb/agent-connection/generator';\nimport { TS_RDB_GENERATOR_INFO } from '../ts/rdb/generator';\nimport tsRdbMcpServerConnectionGenerator from '../ts/rdb/mcp-server-connection/generator';\nimport tsRdbSmithyConnectionGenerator from '../ts/rdb/smithy-connection/generator';\nimport tsRdbTrpcConnectionGenerator from '../ts/rdb/trpc-connection/generator';\nimport { hasExportDeclaration } from '../utils/ast';\nimport {\n  type ComponentMetadata,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\nimport { readToml } from '../utils/toml';\nimport type { ConnectionGeneratorSchema } from './schema';\nimport {\n  type Connection,\n  type ConnectionKey,\n  SUPPORTED_CONNECTIONS,\n  type SUPPORTED_PROJECT_TYPES,\n} from './supported-connections';\n\nexport type { Connection };\n\ntype ProjectType = (typeof SUPPORTED_PROJECT_TYPES)[number];\n\n/**\n * Sentinel value for sourceComponent/targetComponent that means\n * \"use the project-level connection, not a component\".\n */\nexport const PROJECT_COMPONENT_SENTINEL = '.';\n\n/**\n * The result of resolving a connection, including the matched connection\n * and any resolved source/target component metadata.\n */\nexport interface ResolvedConnection {\n  readonly connection: Connection;\n  readonly sourceComponent?: ComponentMetadata;\n  readonly targetComponent?: ComponentMetadata;\n}\n\n/**\n * Generators for each connection type\n */\n/**\n * Options passed to connection generators, including resolved component metadata.\n */\nexport interface ResolvedConnectionOptions {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n\nconst CONNECTION_GENERATORS = {\n  'ts#trpc-api -> ts#rdb': (tree, options) =>\n    tsRdbTrpcConnectionGenerator(tree, options),\n  'ts#agent -> ts#rdb': (tree, options) =>\n    tsRdbAgentConnectionGenerator(tree, options),\n  'ts#smithy-api -> ts#rdb': (tree, options) =>\n    tsRdbSmithyConnectionGenerator(tree, options),\n  'ts#mcp-server -> ts#rdb': (tree, options) =>\n    tsRdbMcpServerConnectionGenerator(tree, options),\n  'ts#trpc-api -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBTrpcConnectionGenerator(tree, options),\n  'ts#agent -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBAgentConnectionGenerator(tree, options),\n  'ts#smithy-api -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBSmithyConnectionGenerator(tree, options),\n  'ts#mcp-server -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBMcpServerConnectionGenerator(tree, options),\n  'ts#react-website -> ts#trpc-api': (tree, options) =>\n    trpcReactGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      backendProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> py#fast-api': (tree, options) =>\n    fastApiReactGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      fastApiProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> ts#smithy-api': (tree, options) =>\n    smithyReactConnectionGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      smithyModelOrBackendProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> ts#agent': (tree, options) =>\n    tsAgentReactConnectionGenerator(tree, options),\n  'ts#react-website -> py#agent': (tree, options) =>\n    pyAgentReactConnectionGenerator(tree, options),\n  'ts#agent -> ts#mcp-server': (tree, options) =>\n    tsAgentMcpConnectionGenerator(tree, options),\n  'ts#agent -> py#mcp-server': (tree, options) =>\n    tsAgentMcpConnectionGenerator(tree, options),\n  'py#agent -> ts#mcp-server': (tree, options) =>\n    pyAgentMcpConnectionGenerator(tree, options),\n  'py#agent -> py#mcp-server': (tree, options) =>\n    pyAgentMcpConnectionGenerator(tree, options),\n  'ts#agent -> ts#agent': (tree, options) =>\n    tsAgentA2aConnectionGenerator(tree, options),\n  'ts#agent -> py#agent': (tree, options) =>\n    tsAgentA2aConnectionGenerator(tree, options),\n  'py#agent -> ts#agent': (tree, options) =>\n    pyAgentA2aConnectionGenerator(tree, options),\n  'py#agent -> py#agent': (tree, options) =>\n    pyAgentA2aConnectionGenerator(tree, options),\n  'ts#agent -> agentcore-gateway': (tree, options) =>\n    tsAgentGatewayConnectionGenerator(tree, options),\n  'py#agent -> agentcore-gateway': (tree, options) =>\n    pyAgentGatewayConnectionGenerator(tree, options),\n  'agentcore-gateway -> ts#mcp-server': (tree, options) =>\n    agentcoreGatewayMcpConnectionGenerator(tree, options),\n  'agentcore-gateway -> py#mcp-server': (tree, options) =>\n    agentcoreGatewayMcpConnectionGenerator(tree, options),\n  'agentcore-gateway -> agentcore-gateway': (tree, options) =>\n    agentcoreGatewayGatewayConnectionGenerator(tree, options),\n  'py#fast-api -> py#dynamodb': (tree, options) =>\n    pyDynamoDBFastApiConnectionGenerator(tree, options),\n  'py#agent -> py#dynamodb': (tree, options) =>\n    pyDynamoDBAgentConnectionGenerator(tree, options),\n  'py#mcp-server -> py#dynamodb': (tree, options) =>\n    pyDynamoDBMcpServerConnectionGenerator(tree, options),\n  'py#fast-api -> py#rdb': (tree, options) =>\n    pyRdbFastApiConnectionGenerator(tree, options),\n  'py#agent -> py#rdb': (tree, options) =>\n    pyRdbAgentConnectionGenerator(tree, options),\n  'py#mcp-server -> py#rdb': (tree, options) =>\n    pyRdbMcpServerConnectionGenerator(tree, options),\n} satisfies Record<\n  ConnectionKey,\n  (tree: Tree, options: ResolvedConnectionOptions) => Promise<any>\n>;\n\n/**\n * Generator for a connection between two projects\n */\nexport const connectionGenerator = async (\n  tree: Tree,\n  options: ConnectionGeneratorSchema,\n) => {\n  const resolved = await resolveConnection(tree, options);\n\n  const connectionKey =\n    `${resolved.connection.source} -> ${resolved.connection.target}` as ConnectionKey;\n\n  return await CONNECTION_GENERATORS[connectionKey](tree, {\n    sourceProject: options.sourceProject,\n    targetProject: options.targetProject,\n    sourceComponent: resolved.sourceComponent,\n    targetComponent: resolved.targetComponent,\n    preferInstallDependencies: options.preferInstallDependencies,\n  });\n};\n\n/**\n * Find a component in project metadata matching the given reference.\n * Checks by name first, then by path, then by generator.\n */\nexport const findComponentInMetadata = (\n  projectConfiguration: ProjectConfiguration,\n  componentRef: string,\n): ComponentMetadata | undefined => {\n  const components: ComponentMetadata[] =\n    (projectConfiguration.metadata as any)?.components ?? [];\n\n  return (\n    components.find((c) => c.name === componentRef) ??\n    components.find((c) => c.path === componentRef) ??\n    components.find((c) => c.generator === componentRef)\n  );\n};\n\n/**\n * Represents a candidate source or target for a connection, which may be\n * the project itself or a specific component within the project.\n */\ninterface ConnectionCandidate {\n  readonly type: string;\n  readonly component?: ComponentMetadata;\n}\n\n/**\n * A matched connection between source and target candidates.\n */\ninterface ConnectionMatch {\n  readonly connection: Connection;\n  readonly sourceComponent?: ComponentMetadata;\n  readonly targetComponent?: ComponentMetadata;\n}\n\n/**\n * Gather all connection candidates for a project configuration. This includes:\n * - The project-level type (if it's a supported type)\n * - Each component's generator id as a candidate type\n */\nconst gatherCandidates = async (\n  tree: Tree,\n  projectConfig: ProjectConfiguration,\n): Promise<ConnectionCandidate[]> => {\n  const type = await determineProjectTypeFromConfig(tree, projectConfig);\n  const components: ComponentMetadata[] =\n    (projectConfig.metadata as any)?.components ?? [];\n\n  return [\n    ...(type ? [{ type: type }] : []),\n    ...components.map((component) => ({\n      type: component.generator,\n      component,\n    })),\n  ];\n};\n\n/**\n * Validate that a specified component exists in the project metadata.\n * Skips validation for undefined refs and the project sentinel '.'.\n */\nconst validateComponent = (\n  componentRef: string | undefined,\n  projectConfig: ProjectConfiguration,\n  side: 'source' | 'target',\n) => {\n  if (!componentRef || componentRef === PROJECT_COMPONENT_SENTINEL) return;\n  const found = findComponentInMetadata(projectConfig, componentRef);\n  if (!found) {\n    const components: ComponentMetadata[] =\n      (projectConfig.metadata as any)?.components ?? [];\n    throw new Error(\n      `Component '${componentRef}' not found in ${side} project ${projectConfig.name}. ` +\n        `Available components: ${components.length > 0 ? components.map((c) => c.name ?? c.generator).join(', ') : 'none'}`,\n    );\n  }\n};\n\n/**\n * Narrow candidates based on the user's specified component reference.\n */\nconst filterConnectionCandidatesForComponentReference = (\n  componentRef: string | undefined,\n  projectConfig: ProjectConfiguration,\n  candidates: ConnectionCandidate[],\n  supportedConnections: readonly Connection[],\n  side: 'source' | 'target',\n): ConnectionCandidate[] => {\n  if (!componentRef) return candidates;\n  if (componentRef === PROJECT_COMPONENT_SENTINEL) {\n    return candidates.filter((c) => !c.component);\n  }\n  const component = findComponentInMetadata(projectConfig, componentRef);\n  if (!component) return candidates;\n  const isConnectionParticipant = supportedConnections.some(\n    (c) => c[side] === component.generator,\n  );\n  if (!isConnectionParticipant) return candidates;\n  // Filter to the specific matched component, not all components with the same generator\n  return candidates.filter((c) => c.component === component);\n};\n\n/**\n * Resolve the connection to use, considering source/target projects and components.\n */\nexport const resolveConnection = async (\n  tree: Tree,\n  options: ConnectionGeneratorSchema,\n  supportedConnections: readonly Connection[] = SUPPORTED_CONNECTIONS,\n): Promise<ResolvedConnection> => {\n  const sourceConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const targetConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  // Validate explicitly specified components exist\n  validateComponent(options.sourceComponent, sourceConfig, 'source');\n  validateComponent(options.targetComponent, targetConfig, 'target');\n\n  // Gather and narrow candidates\n  const sourceCandidates = filterConnectionCandidatesForComponentReference(\n    options.sourceComponent,\n    sourceConfig,\n    await gatherCandidates(tree, sourceConfig),\n    supportedConnections,\n    'source',\n  );\n  const targetCandidates = filterConnectionCandidatesForComponentReference(\n    options.targetComponent,\n    targetConfig,\n    await gatherCandidates(tree, targetConfig),\n    supportedConnections,\n    'target',\n  );\n\n  // Cross-product candidates and find supported connections\n  const matches: ConnectionMatch[] = [];\n  for (const source of sourceCandidates) {\n    for (const target of targetCandidates) {\n      const match = supportedConnections.find(\n        (c) => c.source === source.type && c.target === target.type,\n      );\n      if (match) {\n        matches.push({\n          connection: match,\n          sourceComponent: source.component,\n          targetComponent: target.component,\n        });\n      }\n    }\n  }\n\n  if (matches.length === 0) {\n    const sourceTypes = [...new Set(sourceCandidates.map((c) => c.type))];\n    const targetTypes = [...new Set(targetCandidates.map((c) => c.type))];\n    throw new Error(\n      `This generator does not support a connection from ${options.sourceProject}${sourceTypes.length > 0 ? ` (${sourceTypes.join(', ')})` : ''} to ${options.targetProject}${targetTypes.length > 0 ? ` (${targetTypes.join(', ')})` : ''}`,\n    );\n  }\n\n  if (matches.length > 1) {\n    const connectionDescriptions = matches\n      .map((m) => {\n        const sourceName = m.sourceComponent?.name;\n        const targetName = m.targetComponent?.name;\n        const sourceLabel = sourceName\n          ? `${sourceName} (${m.connection.source})`\n          : m.connection.source;\n        const targetLabel = targetName\n          ? `${targetName} (${m.connection.target})`\n          : m.connection.target;\n        return `${sourceLabel} -> ${targetLabel}`;\n      })\n      .join(', ');\n    throw new Error(\n      `Ambiguous connection from ${options.sourceProject} to ${options.targetProject}. ` +\n        `Multiple supported connections found: ${connectionDescriptions}. ` +\n        `Please specify sourceComponent and/or targetComponent to disambiguate.`,\n    );\n  }\n\n  return {\n    connection: matches[0].connection,\n    sourceComponent: matches[0].sourceComponent,\n    targetComponent: matches[0].targetComponent,\n  };\n};\n\n/**\n * Determine whether the given project is of a known project type\n */\nexport const determineProjectType = async (\n  tree: Tree,\n  projectName: string,\n): Promise<ProjectType | undefined> => {\n  const projectConfiguration = readProjectConfigurationUnqualified(\n    tree,\n    projectName,\n  );\n  return await determineProjectTypeFromConfig(tree, projectConfiguration);\n};\n\n/**\n * Determine whether the given project configuration is of a known project type\n */\nconst determineProjectTypeFromConfig = async (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): Promise<ProjectType | undefined> => {\n  // NB: if adding new checks, ensure these go from most to least specific\n  // eg. react website is more specific than typescript project\n\n  if (await isTrpcApi(tree, projectConfiguration)) {\n    return 'ts#trpc-api';\n  }\n\n  if (isFastApi(tree, projectConfiguration)) {\n    return 'py#fast-api';\n  }\n\n  if (isSmithyApi(tree, projectConfiguration)) {\n    return 'ts#smithy-api';\n  }\n\n  if (isReact(tree, projectConfiguration)) {\n    return 'ts#react-website';\n  }\n\n  if (isRdb(projectConfiguration)) {\n    return 'ts#rdb';\n  }\n\n  if (isTsDynamoDB(projectConfiguration)) {\n    return 'ts#dynamodb';\n  }\n\n  if (isPyDynamoDB(projectConfiguration)) {\n    return 'py#dynamodb';\n  }\n\n  if (isPyRdb(projectConfiguration)) {\n    return 'py#rdb';\n  }\n\n  if (isAgentCoreGateway(projectConfiguration)) {\n    return 'agentcore-gateway';\n  }\n\n  return undefined;\n};\n\nconst sourceRoot = (projectConfiguration: ProjectConfiguration) =>\n  projectConfiguration.sourceRoot ??\n  joinPathFragments(projectConfiguration.root, 'src');\n\nconst isTrpcApi = async (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): Promise<boolean> => {\n  // If the project.json says it's a trpc api, there's no need for introspection\n  if ((projectConfiguration.metadata as any)?.apiType === 'trpc') {\n    return true;\n  }\n\n  // Find the src/index.ts\n  const indexTs = tree.read(\n    joinPathFragments(sourceRoot(projectConfiguration), 'index.ts'),\n    'utf-8',\n  );\n  if (indexTs === null) {\n    return false;\n  }\n\n  // If the index file exports an AppRouter, it's a trpc api\n  if (await hasExportDeclaration(tree, indexTs, 'AppRouter')) {\n    return true;\n  }\n\n  // If there's a src/router.ts or src/lambdas/router.ts which exports an AppRouter, it's a trpc api\n  const trpcRouter =\n    tree.read(\n      joinPathFragments(sourceRoot(projectConfiguration), 'router.ts'),\n      'utf-8',\n    ) ??\n    tree.read(\n      joinPathFragments(\n        sourceRoot(projectConfiguration),\n        'lambdas',\n        'router.ts',\n      ),\n      'utf-8',\n    );\n\n  if (trpcRouter === null) {\n    return false;\n  }\n\n  if (await hasExportDeclaration(tree, trpcRouter, 'AppRouter')) {\n    return true;\n  }\n\n  return false;\n};\n\nconst isReact = (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // if there's a main.tsx, it's a react app\n  return tree.exists(\n    joinPathFragments(sourceRoot(projectConfiguration), 'main.tsx'),\n  );\n};\n\nconst isFastApi = (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // If the project.json says it's a fast api, there's no need for introspection\n  if ((projectConfiguration.metadata as any)?.apiType === 'fast-api') {\n    return true;\n  }\n\n  const pyProjectPath = joinPathFragments(\n    projectConfiguration.root,\n    'pyproject.toml',\n  );\n  if (tree.exists(pyProjectPath)) {\n    const pyProject = readToml(tree, pyProjectPath);\n    if (((pyProject as any)?.project?.dependencies ?? []).includes('fastapi')) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\nconst isSmithyApi = (\n  _tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // Support selecting either the smithy model or backend project\n  return [\n    SMITHY_PROJECT_GENERATOR_INFO.id,\n    TS_SMITHY_API_GENERATOR_INFO.id,\n  ].includes(((projectConfiguration.metadata as any) ?? {}).generator);\n};\n\nconst isRdb = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  TS_RDB_GENERATOR_INFO.id;\n\nconst isTsDynamoDB = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  TS_DYNAMODB_GENERATOR_INFO.id;\n\nconst isPyDynamoDB = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  PY_DYNAMODB_GENERATOR_INFO.id;\n\nconst isPyRdb = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  PY_RDB_GENERATOR_INFO.id;\n\nconst isAgentCoreGateway = (\n  projectConfiguration: ProjectConfiguration,\n): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  AGENTCORE_GATEWAY_GENERATOR_INFO.id;\n\nexport default connectionGenerator;\n"],"names":["joinPathFragments","agentcoreGatewayGatewayConnectionGenerator","AGENTCORE_GATEWAY_GENERATOR_INFO","agentcoreGatewayMcpConnectionGenerator","pyAgentA2aConnectionGenerator","pyAgentGatewayConnectionGenerator","pyAgentMcpConnectionGenerator","pyAgentReactConnectionGenerator","pyDynamoDBAgentConnectionGenerator","pyDynamoDBFastApiConnectionGenerator","PY_DYNAMODB_GENERATOR_INFO","pyDynamoDBMcpServerConnectionGenerator","fastApiReactGenerator","pyRdbAgentConnectionGenerator","pyRdbFastApiConnectionGenerator","PY_RDB_GENERATOR_INFO","pyRdbMcpServerConnectionGenerator","SMITHY_PROJECT_GENERATOR_INFO","smithyReactConnectionGenerator","TS_SMITHY_API_GENERATOR_INFO","trpcReactGenerator","tsAgentA2aConnectionGenerator","tsAgentGatewayConnectionGenerator","tsAgentMcpConnectionGenerator","tsAgentReactConnectionGenerator","tsDynamoDBAgentConnectionGenerator","TS_DYNAMODB_GENERATOR_INFO","tsDynamoDBMcpServerConnectionGenerator","tsDynamoDBSmithyConnectionGenerator","tsDynamoDBTrpcConnectionGenerator","tsRdbAgentConnectionGenerator","TS_RDB_GENERATOR_INFO","tsRdbMcpServerConnectionGenerator","tsRdbSmithyConnectionGenerator","tsRdbTrpcConnectionGenerator","hasExportDeclaration","readProjectConfigurationUnqualified","readToml","SUPPORTED_CONNECTIONS","PROJECT_COMPONENT_SENTINEL","CONNECTION_GENERATORS","tree","options","frontendProjectName","sourceProject","backendProjectName","targetProject","preferInstallDependencies","fastApiProjectName","smithyModelOrBackendProjectName","connectionGenerator","resolved","resolveConnection","connectionKey","connection","source","target","sourceComponent","targetComponent","findComponentInMetadata","projectConfiguration","componentRef","components","metadata","find","c","name","path","generator","gatherCandidates","projectConfig","type","determineProjectTypeFromConfig","map","component","validateComponent","side","found","Error","length","join","filterConnectionCandidatesForComponentReference","candidates","supportedConnections","filter","isConnectionParticipant","some","sourceConfig","targetConfig","sourceCandidates","targetCandidates","matches","match","push","sourceTypes","Set","targetTypes","connectionDescriptions","m","sourceName","targetName","sourceLabel","targetLabel","determineProjectType","projectName","isTrpcApi","isFastApi","isSmithyApi","isReact","isRdb","isTsDynamoDB","isPyDynamoDB","isPyRdb","isAgentCoreGateway","undefined","sourceRoot","root","apiType","indexTs","read","trpcRouter","exists","pyProjectPath","pyProject","project","dependencies","includes","_tree","id"],"mappings":"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"}
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  joinPathFragments,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport agentcoreGatewayAgentConnectionGenerator from '../agentcore-gateway/agent-connection/generator';\nimport agentcoreGatewayGatewayConnectionGenerator from '../agentcore-gateway/gateway-connection/generator';\nimport { AGENTCORE_GATEWAY_GENERATOR_INFO } from '../agentcore-gateway/generator';\nimport agentcoreGatewayMcpConnectionGenerator from '../agentcore-gateway/mcp-connection/generator';\nimport agentcoreGatewayReactConnectionGenerator from '../agentcore-gateway/react-connection/generator';\nimport pyAgentA2aConnectionGenerator from '../py/agent/a2a-connection/generator';\nimport pyAgentGatewayConnectionGenerator from '../py/agent/gateway-connection/generator';\nimport pyAgentMcpConnectionGenerator from '../py/agent/mcp-connection/generator';\nimport pyAgentReactConnectionGenerator from '../py/agent/react-connection/generator';\nimport pyDynamoDBAgentConnectionGenerator from '../py/dynamodb/agent-connection/generator';\nimport pyDynamoDBFastApiConnectionGenerator from '../py/dynamodb/fast-api-connection/generator';\nimport { PY_DYNAMODB_GENERATOR_INFO } from '../py/dynamodb/generator';\nimport pyDynamoDBMcpServerConnectionGenerator from '../py/dynamodb/mcp-server-connection/generator';\nimport fastApiReactGenerator from '../py/fast-api/react/generator';\nimport pyRdbAgentConnectionGenerator from '../py/rdb/agent-connection/generator';\nimport pyRdbFastApiConnectionGenerator from '../py/rdb/fast-api-connection/generator';\nimport { PY_RDB_GENERATOR_INFO } from '../py/rdb/generator';\nimport pyRdbMcpServerConnectionGenerator from '../py/rdb/mcp-server-connection/generator';\nimport { SMITHY_PROJECT_GENERATOR_INFO } from '../smithy/project/generator';\nimport smithyReactConnectionGenerator from '../smithy/react-connection/generator';\nimport { TS_SMITHY_API_GENERATOR_INFO } from '../smithy/ts/api/generator';\nimport trpcReactGenerator from '../trpc/react/generator';\nimport tsAgentA2aConnectionGenerator from '../ts/agent/a2a-connection/generator';\nimport tsAgentGatewayConnectionGenerator from '../ts/agent/gateway-connection/generator';\nimport tsAgentMcpConnectionGenerator from '../ts/agent/mcp-connection/generator';\nimport tsAgentReactConnectionGenerator from '../ts/agent/react-connection/generator';\nimport tsDynamoDBAgentConnectionGenerator from '../ts/dynamodb/agent-connection/generator';\nimport { TS_DYNAMODB_GENERATOR_INFO } from '../ts/dynamodb/generator';\nimport tsDynamoDBMcpServerConnectionGenerator from '../ts/dynamodb/mcp-server-connection/generator';\nimport tsDynamoDBSmithyConnectionGenerator from '../ts/dynamodb/smithy-connection/generator';\nimport tsDynamoDBTrpcConnectionGenerator from '../ts/dynamodb/trpc-connection/generator';\nimport tsRdbAgentConnectionGenerator from '../ts/rdb/agent-connection/generator';\nimport { TS_RDB_GENERATOR_INFO } from '../ts/rdb/generator';\nimport tsRdbMcpServerConnectionGenerator from '../ts/rdb/mcp-server-connection/generator';\nimport tsRdbSmithyConnectionGenerator from '../ts/rdb/smithy-connection/generator';\nimport tsRdbTrpcConnectionGenerator from '../ts/rdb/trpc-connection/generator';\nimport { hasExportDeclaration } from '../utils/ast';\nimport {\n  type ComponentMetadata,\n  readProjectConfigurationUnqualified,\n} from '../utils/nx';\nimport { readToml } from '../utils/toml';\nimport type { ConnectionGeneratorSchema } from './schema';\nimport {\n  type Connection,\n  type ConnectionKey,\n  SUPPORTED_CONNECTIONS,\n  type SUPPORTED_PROJECT_TYPES,\n} from './supported-connections';\n\nexport type { Connection };\n\ntype ProjectType = (typeof SUPPORTED_PROJECT_TYPES)[number];\n\n/**\n * Sentinel value for sourceComponent/targetComponent that means\n * \"use the project-level connection, not a component\".\n */\nexport const PROJECT_COMPONENT_SENTINEL = '.';\n\n/**\n * The result of resolving a connection, including the matched connection\n * and any resolved source/target component metadata.\n */\nexport interface ResolvedConnection {\n  readonly connection: Connection;\n  readonly sourceComponent?: ComponentMetadata;\n  readonly targetComponent?: ComponentMetadata;\n}\n\n/**\n * Generators for each connection type\n */\n/**\n * Options passed to connection generators, including resolved component metadata.\n */\nexport interface ResolvedConnectionOptions {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n\nconst CONNECTION_GENERATORS = {\n  'ts#trpc-api -> ts#rdb': (tree, options) =>\n    tsRdbTrpcConnectionGenerator(tree, options),\n  'ts#agent -> ts#rdb': (tree, options) =>\n    tsRdbAgentConnectionGenerator(tree, options),\n  'ts#smithy-api -> ts#rdb': (tree, options) =>\n    tsRdbSmithyConnectionGenerator(tree, options),\n  'ts#mcp-server -> ts#rdb': (tree, options) =>\n    tsRdbMcpServerConnectionGenerator(tree, options),\n  'ts#trpc-api -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBTrpcConnectionGenerator(tree, options),\n  'ts#agent -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBAgentConnectionGenerator(tree, options),\n  'ts#smithy-api -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBSmithyConnectionGenerator(tree, options),\n  'ts#mcp-server -> ts#dynamodb': (tree, options) =>\n    tsDynamoDBMcpServerConnectionGenerator(tree, options),\n  'ts#react-website -> ts#trpc-api': (tree, options) =>\n    trpcReactGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      backendProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> py#fast-api': (tree, options) =>\n    fastApiReactGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      fastApiProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> ts#smithy-api': (tree, options) =>\n    smithyReactConnectionGenerator(tree, {\n      frontendProjectName: options.sourceProject,\n      smithyModelOrBackendProjectName: options.targetProject,\n      preferInstallDependencies: options.preferInstallDependencies,\n    }),\n  'ts#react-website -> ts#agent': (tree, options) =>\n    tsAgentReactConnectionGenerator(tree, options),\n  'ts#react-website -> py#agent': (tree, options) =>\n    pyAgentReactConnectionGenerator(tree, options),\n  'ts#agent -> ts#mcp-server': (tree, options) =>\n    tsAgentMcpConnectionGenerator(tree, options),\n  'ts#agent -> py#mcp-server': (tree, options) =>\n    tsAgentMcpConnectionGenerator(tree, options),\n  'py#agent -> ts#mcp-server': (tree, options) =>\n    pyAgentMcpConnectionGenerator(tree, options),\n  'py#agent -> py#mcp-server': (tree, options) =>\n    pyAgentMcpConnectionGenerator(tree, options),\n  'ts#agent -> ts#agent': (tree, options) =>\n    tsAgentA2aConnectionGenerator(tree, options),\n  'ts#agent -> py#agent': (tree, options) =>\n    tsAgentA2aConnectionGenerator(tree, options),\n  'py#agent -> ts#agent': (tree, options) =>\n    pyAgentA2aConnectionGenerator(tree, options),\n  'py#agent -> py#agent': (tree, options) =>\n    pyAgentA2aConnectionGenerator(tree, options),\n  'ts#agent -> agentcore-gateway': (tree, options) =>\n    tsAgentGatewayConnectionGenerator(tree, options),\n  'py#agent -> agentcore-gateway': (tree, options) =>\n    pyAgentGatewayConnectionGenerator(tree, options),\n  'ts#react-website -> agentcore-gateway': (tree, options) =>\n    agentcoreGatewayReactConnectionGenerator(tree, options),\n  'agentcore-gateway -> ts#agent': (tree, options) =>\n    agentcoreGatewayAgentConnectionGenerator(tree, options),\n  'agentcore-gateway -> py#agent': (tree, options) =>\n    agentcoreGatewayAgentConnectionGenerator(tree, options),\n  'agentcore-gateway -> ts#mcp-server': (tree, options) =>\n    agentcoreGatewayMcpConnectionGenerator(tree, options),\n  'agentcore-gateway -> py#mcp-server': (tree, options) =>\n    agentcoreGatewayMcpConnectionGenerator(tree, options),\n  'agentcore-gateway -> agentcore-gateway': (tree, options) =>\n    agentcoreGatewayGatewayConnectionGenerator(tree, options),\n  'py#fast-api -> py#dynamodb': (tree, options) =>\n    pyDynamoDBFastApiConnectionGenerator(tree, options),\n  'py#agent -> py#dynamodb': (tree, options) =>\n    pyDynamoDBAgentConnectionGenerator(tree, options),\n  'py#mcp-server -> py#dynamodb': (tree, options) =>\n    pyDynamoDBMcpServerConnectionGenerator(tree, options),\n  'py#fast-api -> py#rdb': (tree, options) =>\n    pyRdbFastApiConnectionGenerator(tree, options),\n  'py#agent -> py#rdb': (tree, options) =>\n    pyRdbAgentConnectionGenerator(tree, options),\n  'py#mcp-server -> py#rdb': (tree, options) =>\n    pyRdbMcpServerConnectionGenerator(tree, options),\n} satisfies Record<\n  ConnectionKey,\n  (tree: Tree, options: ResolvedConnectionOptions) => Promise<any>\n>;\n\n/**\n * Generator for a connection between two projects\n */\nexport const connectionGenerator = async (\n  tree: Tree,\n  options: ConnectionGeneratorSchema,\n) => {\n  const resolved = await resolveConnection(tree, options);\n\n  const connectionKey =\n    `${resolved.connection.source} -> ${resolved.connection.target}` as ConnectionKey;\n\n  return await CONNECTION_GENERATORS[connectionKey](tree, {\n    sourceProject: options.sourceProject,\n    targetProject: options.targetProject,\n    sourceComponent: resolved.sourceComponent,\n    targetComponent: resolved.targetComponent,\n    preferInstallDependencies: options.preferInstallDependencies,\n  });\n};\n\n/**\n * Find a component in project metadata matching the given reference.\n * Checks by name first, then by path, then by generator.\n */\nexport const findComponentInMetadata = (\n  projectConfiguration: ProjectConfiguration,\n  componentRef: string,\n): ComponentMetadata | undefined => {\n  const components: ComponentMetadata[] =\n    (projectConfiguration.metadata as any)?.components ?? [];\n\n  return (\n    components.find((c) => c.name === componentRef) ??\n    components.find((c) => c.path === componentRef) ??\n    components.find((c) => c.generator === componentRef)\n  );\n};\n\n/**\n * Represents a candidate source or target for a connection, which may be\n * the project itself or a specific component within the project.\n */\ninterface ConnectionCandidate {\n  readonly type: string;\n  readonly component?: ComponentMetadata;\n}\n\n/**\n * A matched connection between source and target candidates.\n */\ninterface ConnectionMatch {\n  readonly connection: Connection;\n  readonly sourceComponent?: ComponentMetadata;\n  readonly targetComponent?: ComponentMetadata;\n}\n\n/**\n * Gather all connection candidates for a project configuration. This includes:\n * - The project-level type (if it's a supported type)\n * - Each component's generator id as a candidate type\n */\nconst gatherCandidates = async (\n  tree: Tree,\n  projectConfig: ProjectConfiguration,\n): Promise<ConnectionCandidate[]> => {\n  const type = await determineProjectTypeFromConfig(tree, projectConfig);\n  const components: ComponentMetadata[] =\n    (projectConfig.metadata as any)?.components ?? [];\n\n  return [\n    ...(type ? [{ type: type }] : []),\n    ...components.map((component) => ({\n      type: component.generator,\n      component,\n    })),\n  ];\n};\n\n/**\n * Validate that a specified component exists in the project metadata.\n * Skips validation for undefined refs and the project sentinel '.'.\n */\nconst validateComponent = (\n  componentRef: string | undefined,\n  projectConfig: ProjectConfiguration,\n  side: 'source' | 'target',\n) => {\n  if (!componentRef || componentRef === PROJECT_COMPONENT_SENTINEL) return;\n  const found = findComponentInMetadata(projectConfig, componentRef);\n  if (!found) {\n    const components: ComponentMetadata[] =\n      (projectConfig.metadata as any)?.components ?? [];\n    throw new Error(\n      `Component '${componentRef}' not found in ${side} project ${projectConfig.name}. ` +\n        `Available components: ${components.length > 0 ? components.map((c) => c.name ?? c.generator).join(', ') : 'none'}`,\n    );\n  }\n};\n\n/**\n * Narrow candidates based on the user's specified component reference.\n */\nconst filterConnectionCandidatesForComponentReference = (\n  componentRef: string | undefined,\n  projectConfig: ProjectConfiguration,\n  candidates: ConnectionCandidate[],\n  supportedConnections: readonly Connection[],\n  side: 'source' | 'target',\n): ConnectionCandidate[] => {\n  if (!componentRef) return candidates;\n  if (componentRef === PROJECT_COMPONENT_SENTINEL) {\n    return candidates.filter((c) => !c.component);\n  }\n  const component = findComponentInMetadata(projectConfig, componentRef);\n  if (!component) return candidates;\n  const isConnectionParticipant = supportedConnections.some(\n    (c) => c[side] === component.generator,\n  );\n  if (!isConnectionParticipant) return candidates;\n  // Filter to the specific matched component, not all components with the same generator\n  return candidates.filter((c) => c.component === component);\n};\n\n/**\n * Resolve the connection to use, considering source/target projects and components.\n */\nexport const resolveConnection = async (\n  tree: Tree,\n  options: ConnectionGeneratorSchema,\n  supportedConnections: readonly Connection[] = SUPPORTED_CONNECTIONS,\n): Promise<ResolvedConnection> => {\n  const sourceConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const targetConfig = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  // Validate explicitly specified components exist\n  validateComponent(options.sourceComponent, sourceConfig, 'source');\n  validateComponent(options.targetComponent, targetConfig, 'target');\n\n  // Gather and narrow candidates\n  const sourceCandidates = filterConnectionCandidatesForComponentReference(\n    options.sourceComponent,\n    sourceConfig,\n    await gatherCandidates(tree, sourceConfig),\n    supportedConnections,\n    'source',\n  );\n  const targetCandidates = filterConnectionCandidatesForComponentReference(\n    options.targetComponent,\n    targetConfig,\n    await gatherCandidates(tree, targetConfig),\n    supportedConnections,\n    'target',\n  );\n\n  // Cross-product candidates and find supported connections\n  const matches: ConnectionMatch[] = [];\n  for (const source of sourceCandidates) {\n    for (const target of targetCandidates) {\n      const match = supportedConnections.find(\n        (c) => c.source === source.type && c.target === target.type,\n      );\n      if (match) {\n        matches.push({\n          connection: match,\n          sourceComponent: source.component,\n          targetComponent: target.component,\n        });\n      }\n    }\n  }\n\n  if (matches.length === 0) {\n    const sourceTypes = [...new Set(sourceCandidates.map((c) => c.type))];\n    const targetTypes = [...new Set(targetCandidates.map((c) => c.type))];\n    throw new Error(\n      `This generator does not support a connection from ${options.sourceProject}${sourceTypes.length > 0 ? ` (${sourceTypes.join(', ')})` : ''} to ${options.targetProject}${targetTypes.length > 0 ? ` (${targetTypes.join(', ')})` : ''}`,\n    );\n  }\n\n  if (matches.length > 1) {\n    const connectionDescriptions = matches\n      .map((m) => {\n        const sourceName = m.sourceComponent?.name;\n        const targetName = m.targetComponent?.name;\n        const sourceLabel = sourceName\n          ? `${sourceName} (${m.connection.source})`\n          : m.connection.source;\n        const targetLabel = targetName\n          ? `${targetName} (${m.connection.target})`\n          : m.connection.target;\n        return `${sourceLabel} -> ${targetLabel}`;\n      })\n      .join(', ');\n    throw new Error(\n      `Ambiguous connection from ${options.sourceProject} to ${options.targetProject}. ` +\n        `Multiple supported connections found: ${connectionDescriptions}. ` +\n        `Please specify sourceComponent and/or targetComponent to disambiguate.`,\n    );\n  }\n\n  return {\n    connection: matches[0].connection,\n    sourceComponent: matches[0].sourceComponent,\n    targetComponent: matches[0].targetComponent,\n  };\n};\n\n/**\n * Determine whether the given project is of a known project type\n */\nexport const determineProjectType = async (\n  tree: Tree,\n  projectName: string,\n): Promise<ProjectType | undefined> => {\n  const projectConfiguration = readProjectConfigurationUnqualified(\n    tree,\n    projectName,\n  );\n  return await determineProjectTypeFromConfig(tree, projectConfiguration);\n};\n\n/**\n * Determine whether the given project configuration is of a known project type\n */\nconst determineProjectTypeFromConfig = async (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): Promise<ProjectType | undefined> => {\n  // NB: if adding new checks, ensure these go from most to least specific\n  // eg. react website is more specific than typescript project\n\n  if (await isTrpcApi(tree, projectConfiguration)) {\n    return 'ts#trpc-api';\n  }\n\n  if (isFastApi(tree, projectConfiguration)) {\n    return 'py#fast-api';\n  }\n\n  if (isSmithyApi(tree, projectConfiguration)) {\n    return 'ts#smithy-api';\n  }\n\n  if (isReact(tree, projectConfiguration)) {\n    return 'ts#react-website';\n  }\n\n  if (isRdb(projectConfiguration)) {\n    return 'ts#rdb';\n  }\n\n  if (isTsDynamoDB(projectConfiguration)) {\n    return 'ts#dynamodb';\n  }\n\n  if (isPyDynamoDB(projectConfiguration)) {\n    return 'py#dynamodb';\n  }\n\n  if (isPyRdb(projectConfiguration)) {\n    return 'py#rdb';\n  }\n\n  if (isAgentCoreGateway(projectConfiguration)) {\n    return 'agentcore-gateway';\n  }\n\n  return undefined;\n};\n\nconst sourceRoot = (projectConfiguration: ProjectConfiguration) =>\n  projectConfiguration.sourceRoot ??\n  joinPathFragments(projectConfiguration.root, 'src');\n\nconst isTrpcApi = async (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): Promise<boolean> => {\n  // If the project.json says it's a trpc api, there's no need for introspection\n  if ((projectConfiguration.metadata as any)?.apiType === 'trpc') {\n    return true;\n  }\n\n  // Find the src/index.ts\n  const indexTs = tree.read(\n    joinPathFragments(sourceRoot(projectConfiguration), 'index.ts'),\n    'utf-8',\n  );\n  if (indexTs === null) {\n    return false;\n  }\n\n  // If the index file exports an AppRouter, it's a trpc api\n  if (await hasExportDeclaration(tree, indexTs, 'AppRouter')) {\n    return true;\n  }\n\n  // If there's a src/router.ts or src/lambdas/router.ts which exports an AppRouter, it's a trpc api\n  const trpcRouter =\n    tree.read(\n      joinPathFragments(sourceRoot(projectConfiguration), 'router.ts'),\n      'utf-8',\n    ) ??\n    tree.read(\n      joinPathFragments(\n        sourceRoot(projectConfiguration),\n        'lambdas',\n        'router.ts',\n      ),\n      'utf-8',\n    );\n\n  if (trpcRouter === null) {\n    return false;\n  }\n\n  if (await hasExportDeclaration(tree, trpcRouter, 'AppRouter')) {\n    return true;\n  }\n\n  return false;\n};\n\nconst isReact = (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // if there's a main.tsx, it's a react app\n  return tree.exists(\n    joinPathFragments(sourceRoot(projectConfiguration), 'main.tsx'),\n  );\n};\n\nconst isFastApi = (\n  tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // If the project.json says it's a fast api, there's no need for introspection\n  if ((projectConfiguration.metadata as any)?.apiType === 'fast-api') {\n    return true;\n  }\n\n  const pyProjectPath = joinPathFragments(\n    projectConfiguration.root,\n    'pyproject.toml',\n  );\n  if (tree.exists(pyProjectPath)) {\n    const pyProject = readToml(tree, pyProjectPath);\n    if (((pyProject as any)?.project?.dependencies ?? []).includes('fastapi')) {\n      return true;\n    }\n  }\n\n  return false;\n};\n\nconst isSmithyApi = (\n  _tree: Tree,\n  projectConfiguration: ProjectConfiguration,\n): boolean => {\n  // Support selecting either the smithy model or backend project\n  return [\n    SMITHY_PROJECT_GENERATOR_INFO.id,\n    TS_SMITHY_API_GENERATOR_INFO.id,\n  ].includes(((projectConfiguration.metadata as any) ?? {}).generator);\n};\n\nconst isRdb = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  TS_RDB_GENERATOR_INFO.id;\n\nconst isTsDynamoDB = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  TS_DYNAMODB_GENERATOR_INFO.id;\n\nconst isPyDynamoDB = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  PY_DYNAMODB_GENERATOR_INFO.id;\n\nconst isPyRdb = (projectConfiguration: ProjectConfiguration): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  PY_RDB_GENERATOR_INFO.id;\n\nconst isAgentCoreGateway = (\n  projectConfiguration: ProjectConfiguration,\n): boolean =>\n  ((projectConfiguration.metadata as any) ?? {}).generator ===\n  AGENTCORE_GATEWAY_GENERATOR_INFO.id;\n\nexport default connectionGenerator;\n"],"names":["joinPathFragments","agentcoreGatewayAgentConnectionGenerator","agentcoreGatewayGatewayConnectionGenerator","AGENTCORE_GATEWAY_GENERATOR_INFO","agentcoreGatewayMcpConnectionGenerator","agentcoreGatewayReactConnectionGenerator","pyAgentA2aConnectionGenerator","pyAgentGatewayConnectionGenerator","pyAgentMcpConnectionGenerator","pyAgentReactConnectionGenerator","pyDynamoDBAgentConnectionGenerator","pyDynamoDBFastApiConnectionGenerator","PY_DYNAMODB_GENERATOR_INFO","pyDynamoDBMcpServerConnectionGenerator","fastApiReactGenerator","pyRdbAgentConnectionGenerator","pyRdbFastApiConnectionGenerator","PY_RDB_GENERATOR_INFO","pyRdbMcpServerConnectionGenerator","SMITHY_PROJECT_GENERATOR_INFO","smithyReactConnectionGenerator","TS_SMITHY_API_GENERATOR_INFO","trpcReactGenerator","tsAgentA2aConnectionGenerator","tsAgentGatewayConnectionGenerator","tsAgentMcpConnectionGenerator","tsAgentReactConnectionGenerator","tsDynamoDBAgentConnectionGenerator","TS_DYNAMODB_GENERATOR_INFO","tsDynamoDBMcpServerConnectionGenerator","tsDynamoDBSmithyConnectionGenerator","tsDynamoDBTrpcConnectionGenerator","tsRdbAgentConnectionGenerator","TS_RDB_GENERATOR_INFO","tsRdbMcpServerConnectionGenerator","tsRdbSmithyConnectionGenerator","tsRdbTrpcConnectionGenerator","hasExportDeclaration","readProjectConfigurationUnqualified","readToml","SUPPORTED_CONNECTIONS","PROJECT_COMPONENT_SENTINEL","CONNECTION_GENERATORS","tree","options","frontendProjectName","sourceProject","backendProjectName","targetProject","preferInstallDependencies","fastApiProjectName","smithyModelOrBackendProjectName","connectionGenerator","resolved","resolveConnection","connectionKey","connection","source","target","sourceComponent","targetComponent","findComponentInMetadata","projectConfiguration","componentRef","components","metadata","find","c","name","path","generator","gatherCandidates","projectConfig","type","determineProjectTypeFromConfig","map","component","validateComponent","side","found","Error","length","join","filterConnectionCandidatesForComponentReference","candidates","supportedConnections","filter","isConnectionParticipant","some","sourceConfig","targetConfig","sourceCandidates","targetCandidates","matches","match","push","sourceTypes","Set","targetTypes","connectionDescriptions","m","sourceName","targetName","sourceLabel","targetLabel","determineProjectType","projectName","isTrpcApi","isFastApi","isSmithyApi","isReact","isRdb","isTsDynamoDB","isPyDynamoDB","isPyRdb","isAgentCoreGateway","undefined","sourceRoot","root","apiType","indexTs","read","trpcRouter","exists","pyProjectPath","pyProject","project","dependencies","includes","_tree","id"],"mappings":"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"}

package/src/connection/scaffold-catalog.d.ts

@@ -143,15 +143,122 @@ export declare const CONNECTION_CONSTRAINTS: {
     readonly 'py#agent -> py#mcp-server': readonly ConnectionConstraint[];
     readonly 'ts#agent -> agentcore-gateway': readonly ConnectionConstraint[];
     readonly 'py#agent -> agentcore-gateway': readonly ConnectionConstraint[];
+    readonly 'ts#react-website -> agentcore-gateway': readonly [{
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly equals: "http";
+        readonly reason: "A website connects to an http-protocol gateway, which proxies requests to its agent targets.";
+    }];
+    readonly 'agentcore-gateway -> ts#agent': readonly [...ConnectionConstraint[], {
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly notEquals: "http";
+        readonly reason: "A TypeScript http agent serves tRPC over WebSocket, which AgentCore Gateway does not support. Use the ag-ui or a2a protocol.";
+    }];
+    readonly 'agentcore-gateway -> py#agent': readonly ConnectionConstraint[];
     readonly 'agentcore-gateway -> ts#mcp-server': readonly ConnectionConstraint[];
     readonly 'agentcore-gateway -> py#mcp-server': readonly ConnectionConstraint[];
     readonly 'agentcore-gateway -> agentcore-gateway': readonly [{
+        readonly side: "source";
+        readonly option: "protocol";
+        readonly equals: "mcp";
+        readonly reason: "A gateway is aggregated into another as an MCP target, so both must be mcp-protocol gateways.";
+    }, {
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly equals: "mcp";
+        readonly reason: "A gateway is aggregated into another as an MCP target, so both must be mcp-protocol gateways.";
+    }, {
         readonly side: "target";
         readonly option: "auth";
         readonly equals: "iam";
         readonly reason: "The source gateway signs its request with IAM, so the target gateway must accept IAM.";
     }];
 };
+/**
+ * A generator run automatically after an endpoint is scaffolded, adding something
+ * that endpoint should always have.
+ *
+ * A website is only useful with authentication in front of it, and `ts#website`
+ * does not add it — `ts#website#auth` is a separate follow-up generator. Declared
+ * here so the docs graph builder emits it without hardcoding the pairing.
+ */
+export interface FollowUpGenerator {
+    /** The generator id to run after the endpoint's own. */
+    readonly generator: string;
+    /** Options to pass, beyond the `--project` naming the endpoint. */
+    readonly options?: Readonly<Record<string, string>>;
+    /** What it adds, for the emitted command's comment. */
+    readonly adds: string;
+}
+/**
+ * Generators run automatically after an endpoint type is scaffolded, keyed by
+ * endpoint type.
+ */
+export declare const ENDPOINT_FOLLOW_UPS: Readonly<Record<string, readonly FollowUpGenerator[]>>;
+/**
+ * An option value a connection works best against, without requiring it.
+ *
+ * Distinct from `CONNECTION_CONSTRAINTS`: a constraint is a rule the connection
+ * generator enforces, whereas a preference is the setting most users want. A
+ * React website can call an `http` agent perfectly well, but AG-UI is the
+ * protocol built for driving a frontend, so that is what a new connection picks.
+ *
+ * A caller applies these only where the user has not chosen the option, so a
+ * preference never overrides a deliberate decision.
+ */
+export interface ConnectionPreference {
+    readonly side: 'source' | 'target';
+    readonly option: string;
+    readonly value: string;
+    /** Why this is the better default, phrased for the user. */
+    readonly reason: string;
+}
+/**
+ * Preferred option values per connection. Keyed by `ConnectionKey`, so a key that
+ * no longer names a supported connection is a compile error.
+ */
+export declare const CONNECTION_PREFERENCES: {
+    readonly 'ts#react-website -> ts#agent': readonly [{
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly value: "ag-ui";
+        readonly reason: "AG-UI is the protocol built for driving a frontend, so a website connection selects it.";
+    }];
+    readonly 'ts#react-website -> py#agent': readonly [{
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly value: "ag-ui";
+        readonly reason: "AG-UI is the protocol built for driving a frontend, so a website connection selects it.";
+    }];
+    readonly 'agentcore-gateway -> ts#agent': readonly [ConnectionPreference];
+    readonly 'agentcore-gateway -> py#agent': readonly [ConnectionPreference];
+    readonly 'agentcore-gateway -> ts#mcp-server': readonly [ConnectionPreference];
+    readonly 'agentcore-gateway -> py#mcp-server': readonly [ConnectionPreference];
+    readonly 'ts#react-website -> agentcore-gateway': readonly [{
+        readonly side: "target";
+        readonly option: "protocol";
+        readonly value: "http";
+        readonly reason: "A website reaches a gateway’s agent targets over path-based http routing, so the gateway serves the http protocol.";
+    }];
+};
+/**
+ * Connections that must be generated after another, because the generator reads
+ * state the earlier one records.
+ *
+ * The website→gateway generator publishes a route per agent already attached to
+ * the gateway, reading them from the gateway project's connection metadata. Run
+ * before the gateway→agent connections, it finds none and wires up nothing.
+ *
+ * Keyed by `ConnectionKey`, so a key that no longer names a supported connection
+ * is a compile error.
+ */
+export declare const CONNECTION_ORDERING: {
+    readonly 'ts#react-website -> agentcore-gateway': {
+        readonly after: readonly ["agentcore-gateway -> ts#agent", "agentcore-gateway -> py#agent"];
+        readonly reason: "The website connection publishes a route per agent attached to the gateway, so the gateway’s agents must be attached first.";
+    };
+};
 /**
  * Connections whose source and target must be distinct projects, because the
  * connection generator refuses to wire a project to itself.