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

package/src/ts/agent/mcp-connection/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../packages/nx-plugin/src/ts/agent/mcp-connection/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/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 {\n  type GeneratorCallback,\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type Tree,\n  updateProjectConfiguration,\n} from '@nx/devkit';\nimport { addTsDependencies } from '../../../utils/add-dependencies';\nimport {\n  AGENT_CONNECTION_DEPENDENCIES,\n  AGENT_CONNECTION_PROJECT_DIR,\n  addTypeScriptClientToAgent,\n  addTypeScriptCoreClient,\n  ensureTypeScriptAgentConnectionProject,\n} from '../../../utils/agent-connection/agent-connection';\nimport { addDestructuredImport, addStarExport } from '../../../utils/ast';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies';\nimport { formatFilesInSubtree } from '../../../utils/format';\nimport { installDependencies } from '../../../utils/install';\nimport { addGeneratorMetricsIfApplicable } from '../../../utils/metrics';\nimport { esmVars } from '../../../utils/module-format';\nimport { kebabCase } from '../../../utils/names';\nimport { getNpmScope } from '../../../utils/npm-scope';\nimport {\n  addComponentGeneratorMetadata,\n  addDependencyToTargetIfNotPresent,\n  getGeneratorInfo,\n  type NxGeneratorInfo,\n  readProjectConfigurationUnqualified,\n} from '../../../utils/nx';\nimport { toProjectRelativePath } from '../../../utils/paths';\nimport type { TsAgentMcpConnectionGeneratorSchema } from './schema';\n\n// The MCP core client + vended client need these whatever the connection's\n// options, so no entry is conditional.\nexport const DEPENDENCIES = declareDependencies()({\n  ts: [\n    { name: '@modelcontextprotocol/sdk' },\n    { name: '@strands-agents/sdk' },\n    { name: '@aws-lambda-powertools/parameters' },\n    { name: '@aws-sdk/client-appconfigdata' },\n    { name: 'aws4fetch' },\n    { name: '@aws-sdk/credential-providers' },\n    ...ownedElsewhere(AGENT_CONNECTION_DEPENDENCIES),\n  ],\n});\n\nexport const TS_AGENT_MCP_CONNECTION_GENERATOR_INFO: NxGeneratorInfo =\n  getGeneratorInfo(import.meta.filename);\n\nexport const tsAgentMcpConnectionGenerator = async (\n  tree: Tree,\n  options: TsAgentMcpConnectionGeneratorSchema,\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 agentComponent = options.sourceComponent;\n  const mcpComponent = options.targetComponent;\n\n  if (!agentComponent || !mcpComponent) {\n    throw new Error(\n      'Both sourceComponent and targetComponent must be provided for ts#agent -> mcp connections',\n    );\n  }\n\n  if (mcpComponent.auth && mcpComponent.auth.toLowerCase() !== 'iam') {\n    throw new Error(\n      `MCP server connection currently only supports IAM authentication, but '${mcpComponent.name}' uses '${mcpComponent.auth}' authentication.`,\n    );\n  }\n\n  const mcpComponentName = mcpComponent.name ?? 'mcp-server';\n  const mcpServerClassName = mcpComponent.rc as string;\n  const mcpServerKebabCase = kebabCase(mcpServerClassName);\n  const mcpServerPort = mcpComponent.port ?? 8000;\n\n  const npmScope = getNpmScope(tree);\n\n  // 1. Ensure the shared agent-connection project exists + has the MCP core client\n  await ensureTypeScriptAgentConnectionProject(tree, DEPENDENCIES);\n  await addTypeScriptCoreClient(tree, 'mcp', DEPENDENCIES);\n\n  // 2. Generate the per-connection <Name>Client into app/\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'agent-connection', 'app'),\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'app'),\n    {\n      mcpServerKebabCase,\n      mcpServerClassName,\n      mcpServerPort,\n      ...esmVars(tree),\n    },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Add re-export to index.ts\n  await addStarExport(\n    tree,\n    joinPathFragments(AGENT_CONNECTION_PROJECT_DIR, 'src', 'index.ts'),\n    `./app/${mcpServerKebabCase}-client-strands.js`,\n  );\n\n  // 3. AST transform agent.ts to add MCP tools\n  const agentSourceDir = joinPathFragments(\n    sourceProject.root,\n    agentComponent.path ?? 'src',\n  );\n  const agentFilePath = joinPathFragments(agentSourceDir, 'agent.ts');\n\n  if (tree.exists(agentFilePath)) {\n    const clientClassName = `${mcpServerClassName}ClientStrands`;\n    const clientVarName =\n      mcpServerClassName.charAt(0).toLowerCase() + mcpServerClassName.slice(1);\n\n    // Add import for the client\n    await addDestructuredImport(\n      tree,\n      agentFilePath,\n      [clientClassName],\n      `@${npmScope}/agent-connection`,\n    );\n\n    await addTypeScriptClientToAgent(\n      tree,\n      agentFilePath,\n      clientClassName,\n      clientVarName,\n    );\n  }\n\n  // 4. Set up dev target\n  const agentName = agentComponent.name ?? 'agent';\n  const devTargetName = `${agentName}-dev`;\n  const mcpDevTargetName = `${mcpComponentName}-dev`;\n\n  if (sourceProject.targets?.[devTargetName]) {\n    addDependencyToTargetIfNotPresent(sourceProject, devTargetName, {\n      projects: [targetProject.name],\n      target: mcpDevTargetName,\n    });\n    updateProjectConfiguration(tree, sourceProject.name, sourceProject);\n  }\n\n  // 5. Add dependencies required by the MCP core client + vended client\n  addTsDependencies(tree, DEPENDENCIES, { projectRoot: sourceProject.root });\n\n  // Recorded so the version sync knows this connection's dependencies are ours.\n  addComponentGeneratorMetadata(\n    tree,\n    sourceProject.name,\n    TS_AGENT_MCP_CONNECTION_GENERATOR_INFO,\n    toProjectRelativePath(sourceProject, agentFilePath),\n    mcpServerClassName,\n    // The source component this connection is made from, so the pair is\n    // identifiable rather than just the two projects.\n    { sourcePath: options.sourceComponent?.path },\n  );\n\n  await addGeneratorMetricsIfApplicable(tree, [\n    TS_AGENT_MCP_CONNECTION_GENERATOR_INFO,\n  ]);\n\n  await formatFilesInSubtree(tree);\n  return () =>\n    installDependencies(tree, options.preferInstallDependencies, {\n      languages: ['typescript'],\n    });\n};\n\nexport default tsAgentMcpConnectionGenerator;\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","updateProjectConfiguration","addTsDependencies","AGENT_CONNECTION_DEPENDENCIES","AGENT_CONNECTION_PROJECT_DIR","addTypeScriptClientToAgent","addTypeScriptCoreClient","ensureTypeScriptAgentConnectionProject","addDestructuredImport","addStarExport","declareDependencies","ownedElsewhere","formatFilesInSubtree","installDependencies","addGeneratorMetricsIfApplicable","esmVars","kebabCase","getNpmScope","addComponentGeneratorMetadata","addDependencyToTargetIfNotPresent","getGeneratorInfo","readProjectConfigurationUnqualified","toProjectRelativePath","DEPENDENCIES","ts","name","TS_AGENT_MCP_CONNECTION_GENERATOR_INFO","filename","tsAgentMcpConnectionGenerator","tree","options","sourceProject","targetProject","agentComponent","sourceComponent","mcpComponent","targetComponent","Error","auth","toLowerCase","mcpComponentName","mcpServerClassName","rc","mcpServerKebabCase","mcpServerPort","port","npmScope","dirname","overwriteStrategy","KeepExisting","agentSourceDir","root","path","agentFilePath","exists","clientClassName","clientVarName","charAt","slice","agentName","devTargetName","mcpDevTargetName","targets","projects","target","projectRoot","sourcePath","preferInstallDependencies","languages"],"mappings":"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"}

package/src/ts/agent/mcp-connection/schema.d.js

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

package/src/ts/agent/mcp-connection/schema.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/agent/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 { ComponentMetadata } from '../../../utils/nx';\n\n/**\n * TypeScript types for options defined in schema.json\n */\nexport interface TsAgentMcpConnectionGeneratorSchema {\n  sourceProject: string;\n  targetProject: string;\n  sourceComponent?: ComponentMetadata;\n  targetComponent?: ComponentMetadata;\n  preferInstallDependencies?: boolean;\n}\n"],"names":[],"mappings":"AAAA;;;CAGC,GAGD;;CAEC,GACD,WAMC"}

package/src/ts/agent/mcp-connection/schema.d.ts

@@ -12,4 +12,5 @@ export interface TsAgentMcpConnectionGeneratorSchema {
   targetProject: string;
   sourceComponent?: ComponentMetadata;
   targetComponent?: ComponentMetadata;
+  preferInstallDependencies?: boolean;
 }

package/src/ts/agent/mcp-connection/schema.json

@@ -20,6 +20,11 @@
     "targetComponent": {
       "type": "string",
       "description": "The MCP server component name"
+    },
+    "preferInstallDependencies": {
+      "type": "boolean",
+      "description": "Whether to prefer installing dependencies after the generator runs. Set to false to defer installing when batching multiple generators (an install still runs if needed so subsequent generators can compute the Nx project graph); install once at the end.",
+      "default": true
     }
   },
   "required": ["sourceProject", "targetProject"]

package/src/ts/agent/react-connection/__snapshots__/generator.spec.ts.snap

@@ -39,7 +39,8 @@ export const TestAgentAgentClientProvider: FC<PropsWithChildren> = ({
   const sigv4Client = useSigV4();
 
   const container = useMemo<TestAgentAgentTRPCContextValue>(() => {
-    // If the value is an ARN, convert it to a WebSocket URL
+    // A local-dev override is a plain URL; otherwise it's the agent's
+    // runtime ARN, so build a WebSocket URL from it.
     const wsUrl = agentRuntimeValue.startsWith('arn:')
       ? buildAgentCoreWsUrl(agentRuntimeValue)
       : agentRuntimeValue;
@@ -155,7 +156,8 @@ export const TestAgentAgentClientProvider: FC<PropsWithChildren> = ({
   const accessToken = auth?.user?.access_token;
 
   const container = useMemo<TestAgentAgentTRPCContextValue>(() => {
-    // If the value is an ARN, convert it to a WebSocket URL
+    // A local-dev override is a plain URL; otherwise it's the agent's
+    // runtime ARN, so build a WebSocket URL from it.
     const wsUrl = agentRuntimeValue.startsWith('arn:')
       ? buildAgentCoreWsUrl(agentRuntimeValue)
       : agentRuntimeValue;
@@ -245,7 +247,8 @@ export const TestAgentAgentClientProvider: FC<PropsWithChildren> = ({
   const sigv4Client = useSigV4();
 
   const container = useMemo<TestAgentAgentTRPCContextValue>(() => {
-    // If the value is an ARN, convert it to a WebSocket URL
+    // A local-dev override is a plain URL; otherwise it's the agent's
+    // runtime ARN, so build a WebSocket URL from it.
     const wsUrl = agentRuntimeValue.startsWith('arn:')
       ? buildAgentCoreWsUrl(agentRuntimeValue)
       : agentRuntimeValue;
@@ -320,7 +323,8 @@ export const TestAgentAgentClientProvider: FC<PropsWithChildren> = ({
   const agentRuntimeValue = runtimeConfig.agentRuntimes.TestAgent;
 
   const container = useMemo<TestAgentAgentTRPCContextValue>(() => {
-    // If the value is an ARN, convert it to a WebSocket URL
+    // A local-dev override is a plain URL; otherwise it's the agent's
+    // runtime ARN, so build a WebSocket URL from it.
     const wsUrl = agentRuntimeValue.startsWith('arn:')
       ? buildAgentCoreWsUrl(agentRuntimeValue)
       : agentRuntimeValue;

package/src/ts/agent/react-connection/files/src/components/__agentNameClassName__AgentClientProvider.tsx.template

@@ -51,7 +51,8 @@ export const <%= agentNameClassName %>AgentClientProvider: FC<PropsWithChildren>
   <%_ } _%>
 
   const container = useMemo<<%= agentNameClassName %>AgentTRPCContextValue>(() => {
-    // If the value is an ARN, convert it to a WebSocket URL
+    // A local-dev override is a plain URL; otherwise it's the agent's
+    // runtime ARN, so build a WebSocket URL from it.
     const wsUrl = agentRuntimeValue.startsWith('arn:')
       ? buildAgentCoreWsUrl(agentRuntimeValue)
       : agentRuntimeValue;

package/src/ts/agent/react-connection/generator.d.ts

@@ -5,6 +5,207 @@
 import { type Tree } from '@nx/devkit';
 import type { ResolvedConnectionOptions } from '../../../connection/generator';
 import { type NxGeneratorInfo } from '../../../utils/nx';
+/** The metadata this generator records, which its predicates read. */
+export interface TsAgentReactConnectionMetadata {
+    readonly auth: string;
+    readonly protocol: string;
+    /** The AG-UI theme module, which the website's `ux` selects. */
+    readonly theme: string;
+}
+export declare const DEPENDENCIES: import("../../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "@trpc/client";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@tanstack/react-query";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@tanstack/react-query-devtools";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@trpc/tanstack-react-query";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "oidc-client-ts";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "aws4fetch";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@aws-sdk/credential-provider-cognito-identity";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "react-oidc-context";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+}, {
+    readonly name: "@smithy/types";
+    readonly when: (m: TsAgentReactConnectionMetadata) => boolean;
+    readonly dev: true;
+}, Omit<{
+    readonly name: "@copilotkit/react-core";
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@ag-ui/client";
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@cloudscape-design/chat-components";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "lucide-react";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "oidc-client-ts";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "aws4fetch";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@aws-sdk/credential-provider-cognito-identity";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react-oidc-context";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@smithy/types";
+    readonly when: (m: import("../../react-website/agui/generator").AgUiMetadata) => boolean;
+    readonly dev: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "react-dom";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "class-variance-authority";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "clsx";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "tailwind-merge";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "lucide-react";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "tw-animate-css";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "radix-ui";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "vite";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "vitest";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, Omit<{
+    readonly name: "@vitest/coverage-v8";
+} & {
+    versionOnly: true;
+}, "when"> & {
+    when: (m: TsAgentReactConnectionMetadata) => boolean;
+} & {
+    versionOnly: true;
+}], readonly import("../../../utils/declared-dependencies").DeclaredPyDependency<"a2a-sdk" | "ag-ui-langgraph" | "ag-ui-protocol" | "ag-ui-strands" | "aws-lambda-powertools" | "aws-lambda-powertools[tracer]" | "aws-lambda-powertools[parser]" | "aws-opentelemetry-distro" | "bedrock-agentcore" | "boto3" | "checkov" | "fastapi" | "fastapi[standard]" | "httpx" | "langchain" | "langchain-aws" | "langchain-mcp-adapters" | "langgraph" | "mcp" | "pip-check-updates" | "pip-licenses" | "ruff" | "strands-agents" | "strands-agents[a2a]" | "strands-agents-tools" | "ty" | "pynamodb" | "uvicorn" | "sqlmodel" | "alembic" | "aiomysql" | "asyncpg" | "greenlet", TsAgentReactConnectionMetadata>[]>;
 export declare const TS_AGENT_REACT_CONNECTION_GENERATOR_INFO: NxGeneratorInfo;
-export declare function tsAgentReactConnectionGenerator(tree: Tree, options: ResolvedConnectionOptions): Promise<() => void>;
+/**
+ * Options for routing the website's requests to the agent through an
+ * AgentCore Gateway rather than invoking the runtime directly. The gateway
+ * react-connection generator dispatches here once per fronted agent.
+ */
+export interface AgentGatewayRoute {
+    /** The gateway's class name, keying its URL in runtime config. */
+    gatewayClassName: string;
+    /** The agent's gateway target name, forming its path on the gateway. */
+    targetName: string;
+    /** The gateway's inbound auth, which is what the browser authenticates with. */
+    gatewayAuth: string;
+}
+export declare function tsAgentReactConnectionGenerator(tree: Tree, options: ResolvedConnectionOptions & {
+    gatewayRoute?: AgentGatewayRoute;
+}): Promise<() => Promise<void>>;
 export default tsAgentReactConnectionGenerator;