@aws/nx-plugin 1.0.0-rc.5 → 1.0.0-rc.50

package/src/agentcore-gateway/mcp-connection/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/mcp-connection/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { GeneratorCallback, Tree } from '@nx/devkit';\nimport { formatFilesInSubtree } from '../../utils/format';\nimport { installDependencies } from '../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../utils/metrics';\nimport { kebabCase } from '../../utils/names';\nimport {\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../utils/nx';\nimport { attachUpstreamToLocalGateway } from '../attach-upstream';\nimport { readAgentCoreGatewayMetadata } from '../generator';\nimport type { AgentcoreGatewayMcpConnectionGeneratorSchema } from './schema';\n\nexport const AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\n/**\n * Connect an AgentCore Gateway to an MCP server.\n *\n * Chains the gateway's dev target to the MCP server's dev\n * target, and registers the server in the gateway's local local-dev.ts so\n * the local gateway aggregates its tools. Users must still call\n * `gateway.addMcpServer(...)` in their application stack to create the\n * actual CDK/Terraform resource.\n */\nexport const agentcoreGatewayMcpConnectionGenerator = async (\n  tree: Tree,\n  options: AgentcoreGatewayMcpConnectionGeneratorSchema,\n): Promise<GeneratorCallback> => {\n  const sourceProject = readProjectConfigurationUnqualified(\n    tree,\n    options.sourceProject,\n  );\n  const targetProject = readProjectConfigurationUnqualified(\n    tree,\n    options.targetProject,\n  );\n\n  const gateway = readAgentCoreGatewayMetadata(sourceProject);\n  const mcpComponent = options.targetComponent;\n\n  if (!mcpComponent) {\n    throw new Error(\n      `Target project '${options.targetProject}' has no MCP server component metadata. Did you run the 'ts#mcp-server' or 'py#mcp-server' generator?`,\n    );\n  }\n\n  if (gateway.protocol !== 'mcp') {\n    throw new Error(\n      `Gateway '${gateway.name}' has protocol='${gateway.protocol}'. MCP server targets can only be attached to MCP-protocol gateways.`,\n    );\n  }\n  if (mcpComponent.auth && mcpComponent.auth !== 'iam') {\n    throw new Error(\n      `MCP server '${mcpComponent.name}' uses auth='${mcpComponent.auth}'. Gateway->MCP connections currently require the MCP server to use IAM authentication.`,\n    );\n  }\n\n  // The target name must match what the deployed Gateway uses\n  // (`mcpServerName` on the MCP construct, derived from the project's class\n  // name) so `<target>___<tool>` resolves identically locally and deployed.\n  // Component-level `name` would clash whenever two MCP server projects\n  // both default to `mcp-server`.\n  const mcpTargetName = kebabCase(mcpComponent.rc as string);\n  const mcpComponentName = mcpComponent.name ?? 'mcp-server';\n\n  await attachUpstreamToLocalGateway(tree, sourceProject, 'dev', {\n    targetName: mcpTargetName,\n    port: (mcpComponent.port as number | undefined) ?? 8000,\n    upstreamProjectName: targetProject.name,\n    upstreamDevTargetName: `${mcpComponentName}-dev`,\n  });\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default agentcoreGatewayMcpConnectionGenerator;\n"],"names":["formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","kebabCase","getGeneratorInfo","readProjectConfigurationUnqualified","attachUpstreamToLocalGateway","readAgentCoreGatewayMetadata","AGENTCORE_GATEWAY_MCP_CONNECTION_GENERATOR_INFO","filename","agentcoreGatewayMcpConnectionGenerator","tree","options","sourceProject","targetProject","gateway","mcpComponent","targetComponent","Error","protocol","name","auth","mcpTargetName","rc","mcpComponentName","targetName","port","upstreamProjectName","upstreamDevTargetName","preferInstallDependencies","languages"],"mappings":"AAAA;;;CAGC,GAED,SAASA,oBAAoB,QAAQ,wBAAqB;AAC1D,SAASC,mBAAmB,QAAQ,yBAAsB;AAC1D,SAASC,+BAA+B,QAAQ,yBAAsB;AACtE,SAASC,SAAS,QAAQ,uBAAoB;AAC9C,SACEC,gBAAgB,EAEhBC,mCAAmC,QAC9B,oBAAiB;AACxB,SAASC,4BAA4B,QAAQ,wBAAqB;AAClE,SAASC,4BAA4B,QAAQ,kBAAe;AAG5D,OAAO,MAAMC,kDACXJ,iBAAiB,YAAYK,QAAQ,EAAE;AAEzC;;;;;;;;CAQC,GACD,OAAO,MAAMC,yCAAyC,OACpDC,MACAC;IAEA,MAAMC,gBAAgBR,oCACpBM,MACAC,QAAQC,aAAa;IAEvB,MAAMC,gBAAgBT,oCACpBM,MACAC,QAAQE,aAAa;IAGvB,MAAMC,UAAUR,6BAA6BM;IAC7C,MAAMG,eAAeJ,QAAQK,eAAe;IAE5C,IAAI,CAACD,cAAc;QACjB,MAAM,IAAIE,MACR,CAAC,gBAAgB,EAAEN,QAAQE,aAAa,CAAC,qGAAqG,CAAC;IAEnJ;IAEA,IAAIC,QAAQI,QAAQ,KAAK,OAAO;QAC9B,MAAM,IAAID,MACR,CAAC,SAAS,EAAEH,QAAQK,IAAI,CAAC,gBAAgB,EAAEL,QAAQI,QAAQ,CAAC,oEAAoE,CAAC;IAErI;IACA,IAAIH,aAAaK,IAAI,IAAIL,aAAaK,IAAI,KAAK,OAAO;QACpD,MAAM,IAAIH,MACR,CAAC,YAAY,EAAEF,aAAaI,IAAI,CAAC,aAAa,EAAEJ,aAAaK,IAAI,CAAC,uFAAuF,CAAC;IAE9J;IAEA,4DAA4D;IAC5D,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,gCAAgC;IAChC,MAAMC,gBAAgBnB,UAAUa,aAAaO,EAAE;IAC/C,MAAMC,mBAAmBR,aAAaI,IAAI,IAAI;IAE9C,MAAMd,6BAA6BK,MAAME,eAAe,OAAO;QAC7DY,YAAYH;QACZI,MAAM,AAACV,aAAaU,IAAI,IAA2B;QACnDC,qBAAqBb,cAAcM,IAAI;QACvCQ,uBAAuB,GAAGJ,iBAAiB,IAAI,CAAC;IAClD;IAEA,MAAMtB,gCAAgCS,MAAM;QAC1CH;KACD;IAED,MAAMR,qBAAqBW;IAE3B,OAAO,IACLV,oBAAoBU,MAAMC,QAAQiB,yBAAyB,EAAE;YAC3DC,WAAW;gBAAC;aAAa;QAC3B;AACJ,EAAE;AAEF,eAAepB,uCAAuC"}

package/src/agentcore-gateway/mcp-connection/schema.d.js

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

package/src/agentcore-gateway/mcp-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../packages/nx-plugin/src/agentcore-gateway/mcp-connection/schema.d.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport type { ComponentMetadata } from '../../utils/nx';\n\nexport interface AgentcoreGatewayMcpConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAMC"}

package/src/agentcore-gateway/mcp-connection/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ComponentMetadata } from '../../utils/nx';
+
+export interface AgentcoreGatewayMcpConnectionGeneratorSchema {
+  sourceProject: string;
+  targetProject: string;
+  sourceComponent?: ComponentMetadata;
+  targetComponent?: ComponentMetadata;
+  preferInstallDependencies?: boolean;
+}

package/src/agentcore-gateway/mcp-connection/schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "agentcore-gateway#mcp-connection",
+  "title": "agentcore-gateway#mcp-connection",
+  "description": "Connect an AgentCore Gateway to an MCP server",
+  "type": "object",
+  "properties": {
+    "sourceProject": {
+      "type": "string",
+      "description": "The gateway project"
+    },
+    "targetProject": {
+      "type": "string",
+      "description": "The MCP server project"
+    },
+    "sourceComponent": {
+      "type": "string",
+      "description": "The gateway component in the source project"
+    },
+    "targetComponent": {
+      "type": "string",
+      "description": "The MCP server component in the target project"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
+    }
+  },
+  "required": ["sourceProject", "targetProject"]
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../packages/nx-plugin/src/agentcore-gateway/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\nexport interface AgentcoreGatewayGeneratorSchema {\n  name: string;\n  directory?: string;\n  subDirectory?: string;\n  protocol?: 'mcp';\n  auth?: 'iam' | 'cognito';\n  cedarPolicy?: boolean;\n  infra?: 'agentcore' | 'none';\n  iac: IacOption;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD,WAUC"}

package/src/agentcore-gateway/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';
+
+export interface AgentcoreGatewayGeneratorSchema {
+  name: string;
+  directory?: string;
+  subDirectory?: string;
+  protocol?: 'mcp';
+  auth?: 'iam' | 'cognito';
+  cedarPolicy?: boolean;
+  infra?: 'agentcore' | 'none';
+  iac: IacOption;
+  preferInstallDependencies?: boolean;
+}

package/src/agentcore-gateway/schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "agentcore-gateway",
+  "title": "agentcore-gateway",
+  "description": "Generate an AgentCore Gateway project",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of your AgentCore Gateway project",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What would you like to call your AgentCore Gateway?",
+      "x-priority": "important"
+    },
+    "directory": {
+      "type": "string",
+      "description": "Parent directory where the gateway project is placed.",
+      "default": "packages"
+    },
+    "subDirectory": {
+      "type": "string",
+      "description": "The sub directory the project is placed in. By default this is the project name."
+    },
+    "protocol": {
+      "type": "string",
+      "description": "The inbound protocol exposed by your gateway. Only mcp is supported today; additional protocols may be added in future.",
+      "enum": ["mcp"],
+      "default": "mcp",
+      "x-priority": "important"
+    },
+    "auth": {
+      "type": "string",
+      "description": "The method used to authenticate inbound requests to your gateway. Only applicable when infra is set (ignored when infra is none).",
+      "enum": ["iam", "cognito"],
+      "default": "iam",
+      "x-prompt": "How would you like to authenticate inbound requests to your gateway?",
+      "x-priority": "important"
+    },
+    "cedarPolicy": {
+      "type": "boolean",
+      "description": "Whether to include a Cedar policy engine enforcing fine-grained authorization on the gateway.",
+      "default": true,
+      "x-priority": "important"
+    },
+    "infra": {
+      "type": "string",
+      "description": "The type of infrastructure to host your gateway. Select none for no hosting.",
+      "x-prompt": "How would you like to host your gateway?",
+      "enum": ["agentcore", "none"],
+      "default": "agentcore",
+      "x-priority": "important"
+    },
+    "iac": {
+      "type": "string",
+      "description": "The preferred IaC provider. By default this is inherited from your initial selection.",
+      "enum": ["inherit", "cdk", "terraform"],
+      "x-priority": "important",
+      "default": "inherit",
+      "x-prompt": "Which provider would you like to manage your infrastructure? (default: inherit)"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
+    }
+  },
+  "required": ["name"]
+}

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

@@ -2,9 +2,9 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
-import { ComponentMetadata } from '../utils/nx';
-export interface AgentServeLocalOptions {
+import { type Tree } from '@nx/devkit';
+import { type ComponentMetadata } from '../utils/nx';
+export interface AgentLocalDevOptions {
     agentNameClassName: string;
     port: number;
     targetComponent?: ComponentMetadata;
@@ -18,16 +18,16 @@ export interface AgentServeLocalOptions {
      */
     localUrl: string;
     /**
-     * Additional targets to add as serve-local dependencies.
+     * Additional targets to add as dev dependencies.
      */
     additionalDependencyTargets?: string[];
 }
 /**
- * Adds a Strands Agent's component serve-local target as a dependency of the
- * source project's serve-local target, and updates the RuntimeConfig provider
+ * 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 addAgentTargetToServeLocal: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: AgentServeLocalOptions) => Promise<void>;
+export declare const addAgentTargetToLocalDev: (tree: Tree, sourceProjectName: string, targetProjectName: string, options: AgentLocalDevOptions) => Promise<void>;

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

@@ -0,0 +1,42 @@
+/**
+ * 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);
+    // Add an override to runtime-config for the dev target to use the local url
+    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}\` }`);
+    }
+};
+
+//# 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  // 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"}

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

@@ -2,7 +2,7 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Tree } from '@nx/devkit';
+import { type Tree } from '@nx/devkit';
 /**
  * Register the agent's runtime ARN in the 'connection' namespace so it is
  * published to the website's runtime-config.json. Patches the generated CDK

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,uCAAqD;AACrD,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/generator.d.ts

@@ -2,20 +2,12 @@
  * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
-import { ProjectConfiguration, Tree } from '@nx/devkit';
-import { ConnectionGeneratorSchema } from './schema';
-import { ComponentMetadata } from '../utils/nx';
-/**
- * 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 ProjectConfiguration, type Tree } from '@nx/devkit';
+import { type ComponentMetadata } from '../utils/nx';
+import type { ConnectionGeneratorSchema } from './schema';
+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,11 +33,12 @@ export interface ResolvedConnectionOptions {
     targetProject: string;
     sourceComponent?: ComponentMetadata;
     targetComponent?: ComponentMetadata;
+    preferInstallDependencies?: boolean;
 }
 /**
  * Generator for a connection between two projects
  */
-export declare const connectionGenerator: (tree: Tree, options: ConnectionGeneratorSchema) => Promise<void | (() => void)>;
+export declare const connectionGenerator: (tree: Tree, options: ConnectionGeneratorSchema) => Promise<void | import("@nx/devkit").GeneratorCallback>;
 /**
  * Find a component in project metadata matching the given reference.
  * Checks by name first, then by path, then by generator.