@aws/nx-plugin 1.0.0-rc.53 → 1.0.0-rc.55

package/src/ts/react-website/agui/generator.d.ts

@@ -3,7 +3,87 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { type ProjectConfiguration, type Tree } from '@nx/devkit';
+/**
+ * The values this helper's predicates read. Its callers record them, so the
+ * theme and auth branches taken here can be confirmed at upgrade time.
+ */
+export interface AgUiMetadata {
+    readonly theme: string;
+    readonly auth: string;
+}
+export declare const DEPENDENCIES: import("../../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "@copilotkit/react-core";
+}, {
+    readonly name: "@ag-ui/client";
+}, {
+    readonly name: "@cloudscape-design/chat-components";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "lucide-react";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "oidc-client-ts";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "aws4fetch";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "@aws-sdk/credential-provider-cognito-identity";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "react-oidc-context";
+    readonly when: (m: AgUiMetadata) => boolean;
+}, {
+    readonly name: "@smithy/types";
+    readonly when: (m: AgUiMetadata) => boolean;
+    readonly dev: true;
+}, {
+    readonly name: "react";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "react-dom";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "class-variance-authority";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "clsx";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "tailwind-merge";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "lucide-react";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "tw-animate-css";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "radix-ui";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vite";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vitest";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@vitest/coverage-v8";
+} & {
+    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", AgUiMetadata>[]>;
 export type AgUiAuth = 'iam' | 'cognito' | 'none';
+export type AgUiTheme = 'cloudscape' | 'shadcn' | 'default';
 export interface AgUiReactConnectionOptions {
     /** The React website project to connect FROM */
     frontendProjectConfig: ProjectConfiguration;
@@ -27,3 +107,9 @@ export interface AgUiReactConnectionOptions {
  * website's `metadata.ux` (cloudscape / shadcn / default).
  */
 export declare const addAgUiReactConnection: (tree: Tree, options: AgUiReactConnectionOptions) => Promise<void>;
+/**
+ * The theme module this helper vends, from the website's `metadata.ux`. Callers
+ * record the resolved value, so the theme predicates read what the code branches
+ * on.
+ */
+export declare const resolveAgUiTheme: (frontendProjectConfig: ProjectConfiguration) => AgUiTheme;

package/src/ts/react-website/agui/generator.js

@@ -3,14 +3,58 @@
  * SPDX-License-Identifier: Apache-2.0
  */ import { generateFiles, joinPathFragments, OverwriteStrategy } from "@nx/devkit";
 import { addAgentRuntimeToConnectionNamespace } from "../../../connection/agent-runtime-config.js";
+import { addTsDependencies } from "../../../utils/add-dependencies.js";
 import { addDestructuredImport, addSingleImport, applyGritQL } from "../../../utils/ast.js";
-import { addDependenciesToPackageJson } from "../../../utils/dependencies.js";
+import { declareDependencies, ownedElsewhere } from "../../../utils/declared-dependencies.js";
 import { kebabCase } from "../../../utils/names.js";
 import { getNpmScopePrefix } from "../../../utils/npm-scope.js";
 import { registerPnpmBuiltDependencies } from "../../../utils/pnpm-workspace.js";
-import { sharedShadcnGenerator } from "../../../utils/shared-shadcn.js";
-import { withVersions } from "../../../utils/versions.js";
+import { SHADCN_DEPENDENCIES, sharedShadcnGenerator } from "../../../utils/shared-shadcn.js";
 import { runtimeConfigGenerator } from "../runtime-config/generator.js";
+// Each entry names the theme or auth branch it belongs to, so the same
+// declaration drives both adding and the version sync.
+export const DEPENDENCIES = declareDependencies()({
+    ts: [
+        {
+            name: '@copilotkit/react-core'
+        },
+        {
+            name: '@ag-ui/client'
+        },
+        {
+            name: '@cloudscape-design/chat-components',
+            when: (m)=>m.theme === 'cloudscape'
+        },
+        {
+            name: 'lucide-react',
+            when: (m)=>m.theme === 'shadcn'
+        },
+        {
+            name: 'oidc-client-ts',
+            when: (m)=>m.auth === 'iam'
+        },
+        {
+            name: 'aws4fetch',
+            when: (m)=>m.auth === 'iam'
+        },
+        {
+            name: '@aws-sdk/credential-provider-cognito-identity',
+            when: (m)=>m.auth === 'iam'
+        },
+        {
+            name: 'react-oidc-context',
+            when: (m)=>m.auth === 'iam' || m.auth === 'cognito'
+        },
+        {
+            name: '@smithy/types',
+            when: (m)=>m.auth === 'iam',
+            dev: true
+        },
+        // `sharedShadcnGenerator` adds these to the shared shadcn project it
+        // creates, not to the website.
+        ...ownedElsewhere(SHADCN_DEPENDENCIES)
+    ]
+});
 /**
  * Wires a React website up to an AG-UI agent using CopilotKit and
  * @ag-ui/client's HttpAgent. Agent-server-language agnostic.
@@ -25,6 +69,12 @@ import { runtimeConfigGenerator } from "../runtime-config/generator.js";
  */ export const addAgUiReactConnection = async (tree, options)=>{
     const { frontendProjectConfig, agentName, agentNameClassName, auth } = options;
     const theme = resolveAgUiTheme(frontendProjectConfig);
+    // The values the declaration's predicates read. Callers record the same pair,
+    // so what is added here is exactly what the version sync owns.
+    const metadata = {
+        theme,
+        auth
+    };
     const scopeAlias = getNpmScopePrefix(tree);
     // Generates `src/components/AguiProvider.tsx` (if absent) and
     // `src/hooks/useAgui<AgentName>.tsx`. Existing files are kept so re-running
@@ -38,7 +88,7 @@ import { runtimeConfigGenerator } from "../runtime-config/generator.js";
     });
     // Shadcn theme imports from the shared shadcn library, so it must exist.
     if (theme === 'shadcn') {
-        await sharedShadcnGenerator(tree);
+        await sharedShadcnGenerator(tree, DEPENDENCIES);
     }
     generateFiles(tree, joinPathFragments(import.meta.dirname, 'files', theme), frontendProjectConfig.root, {
         scopeAlias
@@ -67,29 +117,10 @@ import { runtimeConfigGenerator } from "../runtime-config/generator.js";
     registerPnpmBuiltDependencies(tree, {
         '@scarf/scarf': false
     });
-    addDependenciesToPackageJson(tree, withVersions([
-        '@copilotkit/react-core',
-        '@ag-ui/client',
-        ...theme === 'cloudscape' ? [
-            '@cloudscape-design/chat-components'
-        ] : [],
-        ...theme === 'shadcn' ? [
-            'lucide-react'
-        ] : [],
-        ...auth === 'iam' ? [
-            'oidc-client-ts',
-            'aws4fetch',
-            '@aws-sdk/credential-provider-cognito-identity',
-            'react-oidc-context'
-        ] : [],
-        ...auth === 'cognito' ? [
-            'react-oidc-context'
-        ] : []
-    ]), withVersions([
-        ...auth === 'iam' ? [
-            '@smithy/types'
-        ] : []
-    ]), joinPathFragments(frontendProjectConfig.root, 'package.json'));
+    addTsDependencies(tree, DEPENDENCIES, {
+        metadata,
+        projectRoot: frontendProjectConfig.root
+    });
     // Agents only publish their runtime ARN to the 'agentcore' namespace by
     // default, which isn't exposed to the website. Patch the agent's CDK/TF
     // construct to also publish under 'connection' so the browser can read it
@@ -99,7 +130,11 @@ import { runtimeConfigGenerator } from "../runtime-config/generator.js";
         agentNameClassName
     });
 };
-const resolveAgUiTheme = (frontendProjectConfig)=>{
+/**
+ * The theme module this helper vends, from the website's `metadata.ux`. Callers
+ * record the resolved value, so the theme predicates read what the code branches
+ * on.
+ */ export const resolveAgUiTheme = (frontendProjectConfig)=>{
     const ux = frontendProjectConfig.metadata?.ux?.toLowerCase();
     switch(ux){
         case 'cloudscape':

package/src/ts/react-website/agui/generator.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/agui/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast';\nimport { addDependenciesToPackageJson } from '../../../utils/dependencies';\nimport { kebabCase } from '../../../utils/names';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope';\nimport { registerPnpmBuiltDependencies } from '../../../utils/pnpm-workspace';\nimport { sharedShadcnGenerator } from '../../../utils/shared-shadcn';\nimport { withVersions } from '../../../utils/versions';\nimport { runtimeConfigGenerator } from '../runtime-config/generator';\n\nexport type AgUiAuth = 'iam' | 'cognito' | 'none';\n\ntype AgUiTheme = 'cloudscape' | 'shadcn' | 'default';\n\nexport interface AgUiReactConnectionOptions {\n  /** The React website project to connect FROM */\n  frontendProjectConfig: ProjectConfiguration;\n  /** The AG-UI agent's exposed name (used as CopilotKit's agent key) */\n  agentName: string;\n  /** PascalCase class name used for component names and runtime config keys */\n  agentNameClassName: string;\n  /** Auth scheme used by the agent */\n  auth: AgUiAuth;\n}\n\n/**\n * Wires a React website up to an AG-UI agent using CopilotKit and\n * @ag-ui/client's HttpAgent. Agent-server-language agnostic.\n *\n * On first invocation creates a shared `AguiProvider` component (with an empty\n * `selfManagedAgents` registry) and wraps `<App />` in it. Each invocation\n * AST-patches `AguiProvider` to register one more agent hook — running the\n * generator multiple times is idempotent and additive.\n *\n * Also vends a `src/components/copilot` theme module picked from the\n * website's `metadata.ux` (cloudscape / shadcn / default).\n */\nexport const addAgUiReactConnection = async (\n  tree: Tree,\n  options: AgUiReactConnectionOptions,\n) => {\n  const { frontendProjectConfig, agentName, agentNameClassName, auth } =\n    options;\n\n  const theme = resolveAgUiTheme(frontendProjectConfig);\n  const scopeAlias = getNpmScopePrefix(tree);\n\n  // Generates `src/components/AguiProvider.tsx` (if absent) and\n  // `src/hooks/useAgui<AgentName>.tsx`. Existing files are kept so re-running\n  // the generator is idempotent.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'common'),\n    frontendProjectConfig.root,\n    { agentName, agentNameClassName, auth },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Shadcn theme imports from the shared shadcn library, so it must exist.\n  if (theme === 'shadcn') {\n    await sharedShadcnGenerator(tree);\n  }\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', theme),\n    frontendProjectConfig.root,\n    { scopeAlias },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n  });\n\n  // AST-patch AguiProvider to register this agent's hook\n  await registerAgentHookInProvider(\n    tree,\n    frontendProjectConfig,\n    agentNameClassName,\n  );\n\n  // Wrap <App /> in <AguiProvider> in main.tsx (idempotent)\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'AguiProvider',\n    './components/AguiProvider',\n  );\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<AguiProvider><App /></AguiProvider>\\` where { $program <: not contains \\`<AguiProvider>$_</AguiProvider>\\` }`,\n  );\n\n  // @copilotkit/react-core transitively pulls in @scarf/scarf (telemetry),\n  // which has a postinstall script. Under pnpm 11's default\n  // `strictDepBuilds=true` that script is treated as an unreviewed build and\n  // fails the install. Register it as an explicitly-rejected build so pnpm\n  // knows we've seen it and will skip it instead of erroring.\n  registerPnpmBuiltDependencies(tree, { '@scarf/scarf': false });\n\n  addDependenciesToPackageJson(\n    tree,\n    withVersions([\n      '@copilotkit/react-core',\n      '@ag-ui/client',\n      ...((theme === 'cloudscape'\n        ? ['@cloudscape-design/chat-components']\n        : []) as any),\n      ...((theme === 'shadcn' ? ['lucide-react'] : []) as any),\n      ...((auth === 'iam'\n        ? [\n            'oidc-client-ts',\n            'aws4fetch',\n            '@aws-sdk/credential-provider-cognito-identity',\n            'react-oidc-context',\n          ]\n        : []) as any),\n      ...((auth === 'cognito' ? ['react-oidc-context'] : []) as any),\n    ]),\n    withVersions([...((auth === 'iam' ? ['@smithy/types'] : []) as any)]),\n    joinPathFragments(frontendProjectConfig.root, 'package.json'),\n  );\n\n  // Agents only publish their runtime ARN to the 'agentcore' namespace by\n  // default, which isn't exposed to the website. Patch the agent's CDK/TF\n  // construct to also publish under 'connection' so the browser can read it\n  // from runtime-config.json.\n  await addAgentRuntimeToConnectionNamespace(tree, {\n    agentNameKebabCase: kebabCase(agentNameClassName),\n    agentNameClassName,\n  });\n};\n\nconst resolveAgUiTheme = (\n  frontendProjectConfig: ProjectConfiguration,\n): AgUiTheme => {\n  const ux = (\n    (frontendProjectConfig.metadata as any)?.ux as string | undefined\n  )?.toLowerCase();\n  switch (ux) {\n    case 'cloudscape':\n      return 'cloudscape';\n    case 'shadcn':\n      return 'shadcn';\n    default:\n      return 'default';\n  }\n};\n\n/**\n * Register this agent's hook in the shared `AguiProvider` using GritQL AST\n * patches. The provider starts out with an empty `selfManagedAgents` registry\n * (from the template); each call appends:\n *   - `import { useAgui<Name> } from '../hooks/useAgui<Name>';`\n *   - `const <varName> = useAgui<Name>();` before the `useMemo` call\n *   - `...<varName>` into the memoised object literal\n *   - `<varName>` into the `useMemo` deps array\n *\n * All steps are guarded so re-running produces byte-identical output.\n */\nconst registerAgentHookInProvider = async (\n  tree: Tree,\n  frontendProjectConfig: ProjectConfiguration,\n  agentNameClassName: string,\n) => {\n  const providerPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'components',\n    'AguiProvider.tsx',\n  );\n  const hookName = `useAgui${agentNameClassName}`;\n  // useAguiStoryAgent -> storyAgentAgents\n  const varName = `${agentNameClassName.charAt(0).toLowerCase()}${agentNameClassName.slice(1)}Agents`;\n\n  // 1. Add the hook import\n  await addDestructuredImport(\n    tree,\n    providerPath,\n    [hookName],\n    `../hooks/${hookName}`,\n  );\n\n  // 2. Insert `const <varName> = <hookName>();` before the useMemo declaration\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`const selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` => ` +\n      `\\`const ${varName} = ${hookName}();\\nconst selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` ` +\n      `where { $program <: not contains \\`const ${varName} = ${hookName}()\\` }`,\n  );\n\n  // 3. Spread `...<varName>` into the memoised object and add `<varName>` to\n  //    the deps array. Branches on `{}`/`[]` vs populated so both the\n  //    first-agent and nth-agent cases produce clean output.\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`useMemo<Record<string, AbstractAgent>>(() => ($obj), $deps)\\` where {` +\n      ` $obj <: not contains \\`...${varName}\\`,` +\n      ` if ($obj <: \\`{}\\`) { $obj => \\`{ ...${varName} }\\` }` +\n      ` else { $obj <: \\`{$items}\\` where { $items += \\`, ...${varName}\\` } },` +\n      ` if ($deps <: \\`[]\\`) { $deps => \\`[${varName}]\\` }` +\n      ` else { $deps <: \\`[$dd]\\` where { $dd += \\`, ${varName}\\` } }` +\n      ` }`,\n  );\n};\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","addAgentRuntimeToConnectionNamespace","addDestructuredImport","addSingleImport","applyGritQL","addDependenciesToPackageJson","kebabCase","getNpmScopePrefix","registerPnpmBuiltDependencies","sharedShadcnGenerator","withVersions","runtimeConfigGenerator","addAgUiReactConnection","tree","options","frontendProjectConfig","agentName","agentNameClassName","auth","theme","resolveAgUiTheme","scopeAlias","dirname","root","overwriteStrategy","KeepExisting","sourceRoot","project","name","registerAgentHookInProvider","mainTsxPath","agentNameKebabCase","ux","metadata","toLowerCase","providerPath","hookName","varName","charAt","slice"],"mappings":"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"}
+{"version":3,"sources":["../../../../../../../packages/nx-plugin/src/ts/react-website/agui/generator.ts"],"sourcesContent":["/**\n * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n * SPDX-License-Identifier: Apache-2.0\n */\nimport {\n  generateFiles,\n  joinPathFragments,\n  OverwriteStrategy,\n  type ProjectConfiguration,\n  type Tree,\n} from '@nx/devkit';\nimport { addAgentRuntimeToConnectionNamespace } from '../../../connection/agent-runtime-config';\nimport { addTsDependencies } from '../../../utils/add-dependencies';\nimport {\n  addDestructuredImport,\n  addSingleImport,\n  applyGritQL,\n} from '../../../utils/ast';\nimport {\n  declareDependencies,\n  ownedElsewhere,\n} from '../../../utils/declared-dependencies';\nimport { kebabCase } from '../../../utils/names';\nimport { getNpmScopePrefix } from '../../../utils/npm-scope';\nimport { registerPnpmBuiltDependencies } from '../../../utils/pnpm-workspace';\nimport {\n  SHADCN_DEPENDENCIES,\n  sharedShadcnGenerator,\n} from '../../../utils/shared-shadcn';\nimport { runtimeConfigGenerator } from '../runtime-config/generator';\n\n/**\n * The values this helper's predicates read. Its callers record them, so the\n * theme and auth branches taken here can be confirmed at upgrade time.\n */\nexport interface AgUiMetadata {\n  readonly theme: string;\n  readonly auth: string;\n}\n\n// Each entry names the theme or auth branch it belongs to, so the same\n// declaration drives both adding and the version sync.\nexport const DEPENDENCIES = declareDependencies<AgUiMetadata>()({\n  ts: [\n    { name: '@copilotkit/react-core' },\n    { name: '@ag-ui/client' },\n    {\n      name: '@cloudscape-design/chat-components',\n      when: (m) => m.theme === 'cloudscape',\n    },\n    { name: 'lucide-react', when: (m) => m.theme === 'shadcn' },\n    { name: 'oidc-client-ts', when: (m) => m.auth === 'iam' },\n    { name: 'aws4fetch', when: (m) => m.auth === 'iam' },\n    {\n      name: '@aws-sdk/credential-provider-cognito-identity',\n      when: (m) => m.auth === 'iam',\n    },\n    {\n      name: 'react-oidc-context',\n      when: (m) => m.auth === 'iam' || m.auth === 'cognito',\n    },\n    { name: '@smithy/types', when: (m) => m.auth === 'iam', dev: true },\n    // `sharedShadcnGenerator` adds these to the shared shadcn project it\n    // creates, not to the website.\n    ...ownedElsewhere(SHADCN_DEPENDENCIES),\n  ],\n});\n\nexport type AgUiAuth = 'iam' | 'cognito' | 'none';\n\nexport type AgUiTheme = 'cloudscape' | 'shadcn' | 'default';\n\nexport interface AgUiReactConnectionOptions {\n  /** The React website project to connect FROM */\n  frontendProjectConfig: ProjectConfiguration;\n  /** The AG-UI agent's exposed name (used as CopilotKit's agent key) */\n  agentName: string;\n  /** PascalCase class name used for component names and runtime config keys */\n  agentNameClassName: string;\n  /** Auth scheme used by the agent */\n  auth: AgUiAuth;\n}\n\n/**\n * Wires a React website up to an AG-UI agent using CopilotKit and\n * @ag-ui/client's HttpAgent. Agent-server-language agnostic.\n *\n * On first invocation creates a shared `AguiProvider` component (with an empty\n * `selfManagedAgents` registry) and wraps `<App />` in it. Each invocation\n * AST-patches `AguiProvider` to register one more agent hook — running the\n * generator multiple times is idempotent and additive.\n *\n * Also vends a `src/components/copilot` theme module picked from the\n * website's `metadata.ux` (cloudscape / shadcn / default).\n */\nexport const addAgUiReactConnection = async (\n  tree: Tree,\n  options: AgUiReactConnectionOptions,\n) => {\n  const { frontendProjectConfig, agentName, agentNameClassName, auth } =\n    options;\n\n  const theme = resolveAgUiTheme(frontendProjectConfig);\n  // The values the declaration's predicates read. Callers record the same pair,\n  // so what is added here is exactly what the version sync owns.\n  const metadata: AgUiMetadata = { theme, auth };\n  const scopeAlias = getNpmScopePrefix(tree);\n\n  // Generates `src/components/AguiProvider.tsx` (if absent) and\n  // `src/hooks/useAgui<AgentName>.tsx`. Existing files are kept so re-running\n  // the generator is idempotent.\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', 'common'),\n    frontendProjectConfig.root,\n    { agentName, agentNameClassName, auth },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  // Shadcn theme imports from the shared shadcn library, so it must exist.\n  if (theme === 'shadcn') {\n    await sharedShadcnGenerator(tree, DEPENDENCIES);\n  }\n  generateFiles(\n    tree,\n    joinPathFragments(import.meta.dirname, 'files', theme),\n    frontendProjectConfig.root,\n    { scopeAlias },\n    { overwriteStrategy: OverwriteStrategy.KeepExisting },\n  );\n\n  if (auth === 'iam') {\n    generateFiles(\n      tree,\n      joinPathFragments(\n        import.meta.dirname,\n        '../../../utils/files/website/hooks/sigv4',\n      ),\n      joinPathFragments(frontendProjectConfig.sourceRoot, 'hooks'),\n      {},\n      { overwriteStrategy: OverwriteStrategy.KeepExisting },\n    );\n  }\n\n  await runtimeConfigGenerator(tree, {\n    project: frontendProjectConfig.name,\n  });\n\n  // AST-patch AguiProvider to register this agent's hook\n  await registerAgentHookInProvider(\n    tree,\n    frontendProjectConfig,\n    agentNameClassName,\n  );\n\n  // Wrap <App /> in <AguiProvider> in main.tsx (idempotent)\n  const mainTsxPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'main.tsx',\n  );\n  await addSingleImport(\n    tree,\n    mainTsxPath,\n    'AguiProvider',\n    './components/AguiProvider',\n  );\n  await applyGritQL(\n    tree,\n    mainTsxPath,\n    `\\`<App />\\` => \\`<AguiProvider><App /></AguiProvider>\\` where { $program <: not contains \\`<AguiProvider>$_</AguiProvider>\\` }`,\n  );\n\n  // @copilotkit/react-core transitively pulls in @scarf/scarf (telemetry),\n  // which has a postinstall script. Under pnpm 11's default\n  // `strictDepBuilds=true` that script is treated as an unreviewed build and\n  // fails the install. Register it as an explicitly-rejected build so pnpm\n  // knows we've seen it and will skip it instead of erroring.\n  registerPnpmBuiltDependencies(tree, { '@scarf/scarf': false });\n\n  addTsDependencies(tree, DEPENDENCIES, {\n    metadata,\n    projectRoot: frontendProjectConfig.root,\n  });\n\n  // Agents only publish their runtime ARN to the 'agentcore' namespace by\n  // default, which isn't exposed to the website. Patch the agent's CDK/TF\n  // construct to also publish under 'connection' so the browser can read it\n  // from runtime-config.json.\n  await addAgentRuntimeToConnectionNamespace(tree, {\n    agentNameKebabCase: kebabCase(agentNameClassName),\n    agentNameClassName,\n  });\n};\n\n/**\n * The theme module this helper vends, from the website's `metadata.ux`. Callers\n * record the resolved value, so the theme predicates read what the code branches\n * on.\n */\nexport const resolveAgUiTheme = (\n  frontendProjectConfig: ProjectConfiguration,\n): AgUiTheme => {\n  const ux = (\n    (frontendProjectConfig.metadata as any)?.ux as string | undefined\n  )?.toLowerCase();\n  switch (ux) {\n    case 'cloudscape':\n      return 'cloudscape';\n    case 'shadcn':\n      return 'shadcn';\n    default:\n      return 'default';\n  }\n};\n\n/**\n * Register this agent's hook in the shared `AguiProvider` using GritQL AST\n * patches. The provider starts out with an empty `selfManagedAgents` registry\n * (from the template); each call appends:\n *   - `import { useAgui<Name> } from '../hooks/useAgui<Name>';`\n *   - `const <varName> = useAgui<Name>();` before the `useMemo` call\n *   - `...<varName>` into the memoised object literal\n *   - `<varName>` into the `useMemo` deps array\n *\n * All steps are guarded so re-running produces byte-identical output.\n */\nconst registerAgentHookInProvider = async (\n  tree: Tree,\n  frontendProjectConfig: ProjectConfiguration,\n  agentNameClassName: string,\n) => {\n  const providerPath = joinPathFragments(\n    frontendProjectConfig.sourceRoot,\n    'components',\n    'AguiProvider.tsx',\n  );\n  const hookName = `useAgui${agentNameClassName}`;\n  // useAguiStoryAgent -> storyAgentAgents\n  const varName = `${agentNameClassName.charAt(0).toLowerCase()}${agentNameClassName.slice(1)}Agents`;\n\n  // 1. Add the hook import\n  await addDestructuredImport(\n    tree,\n    providerPath,\n    [hookName],\n    `../hooks/${hookName}`,\n  );\n\n  // 2. Insert `const <varName> = <hookName>();` before the useMemo declaration\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`const selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` => ` +\n      `\\`const ${varName} = ${hookName}();\\nconst selfManagedAgents = useMemo<Record<string, AbstractAgent>>($body, $deps);\\` ` +\n      `where { $program <: not contains \\`const ${varName} = ${hookName}()\\` }`,\n  );\n\n  // 3. Spread `...<varName>` into the memoised object and add `<varName>` to\n  //    the deps array. Branches on `{}`/`[]` vs populated so both the\n  //    first-agent and nth-agent cases produce clean output.\n  await applyGritQL(\n    tree,\n    providerPath,\n    `\\`useMemo<Record<string, AbstractAgent>>(() => ($obj), $deps)\\` where {` +\n      ` $obj <: not contains \\`...${varName}\\`,` +\n      ` if ($obj <: \\`{}\\`) { $obj => \\`{ ...${varName} }\\` }` +\n      ` else { $obj <: \\`{$items}\\` where { $items += \\`, ...${varName}\\` } },` +\n      ` if ($deps <: \\`[]\\`) { $deps => \\`[${varName}]\\` }` +\n      ` else { $deps <: \\`[$dd]\\` where { $dd += \\`, ${varName}\\` } }` +\n      ` }`,\n  );\n};\n"],"names":["generateFiles","joinPathFragments","OverwriteStrategy","addAgentRuntimeToConnectionNamespace","addTsDependencies","addDestructuredImport","addSingleImport","applyGritQL","declareDependencies","ownedElsewhere","kebabCase","getNpmScopePrefix","registerPnpmBuiltDependencies","SHADCN_DEPENDENCIES","sharedShadcnGenerator","runtimeConfigGenerator","DEPENDENCIES","ts","name","when","m","theme","auth","dev","addAgUiReactConnection","tree","options","frontendProjectConfig","agentName","agentNameClassName","resolveAgUiTheme","metadata","scopeAlias","dirname","root","overwriteStrategy","KeepExisting","sourceRoot","project","registerAgentHookInProvider","mainTsxPath","projectRoot","agentNameKebabCase","ux","toLowerCase","providerPath","hookName","varName","charAt","slice"],"mappings":"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"}

package/src/ts/react-website/app/__snapshots__/generator.spec.ts.snap

@@ -1940,6 +1940,10 @@ export class StaticWebsite extends Construct {
         resourceArn: bucket.bucketArn,
       },
     );
+    const bucketPolicy = (bucket as Bucket).policy;
+    if (bucketPolicy) {
+      source.node.addDependency(bucketPolicy);
+    }
     const destination: CfnDeliveryDestination = new CfnDeliveryDestination(
       this,
       \`\${id}AccessLogsDestination\`,
@@ -2291,7 +2295,10 @@ exports[`react-website generator > Tanstack router integration > should generate
     "generator": "ts#react-website",
     "ux": "cloudscape",
     "framework": "react",
-    "infra": "cloudfront-s3"
+    "infra": "cloudfront-s3",
+    "tailwind": true,
+    "tanstackRouter": false,
+    "iac": "cdk"
   },
   "targets": {
     "build": {
@@ -3750,6 +3757,10 @@ export class StaticWebsite extends Construct {
         resourceArn: bucket.bucketArn,
       },
     );
+    const bucketPolicy = (bucket as Bucket).policy;
+    if (bucketPolicy) {
+      source.node.addDependency(bucketPolicy);
+    }
     const destination: CfnDeliveryDestination = new CfnDeliveryDestination(
       this,
       \`\${id}AccessLogsDestination\`,
@@ -4107,7 +4118,10 @@ exports[`react-website generator > Tanstack router integration > should generate
     "generator": "ts#react-website",
     "ux": "cloudscape",
     "framework": "react",
-    "infra": "cloudfront-s3"
+    "infra": "cloudfront-s3",
+    "tailwind": true,
+    "tanstackRouter": true,
+    "iac": "cdk"
   },
   "targets": {
     "build": {
@@ -5420,6 +5434,10 @@ export class StaticWebsite extends Construct {
         resourceArn: bucket.bucketArn,
       },
     );
+    const bucketPolicy = (bucket as Bucket).policy;
+    if (bucketPolicy) {
+      source.node.addDependency(bucketPolicy);
+    }
     const destination: CfnDeliveryDestination = new CfnDeliveryDestination(
       this,
       \`\${id}AccessLogsDestination\`,

package/src/ts/react-website/app/generator.d.ts

@@ -4,7 +4,142 @@
  */
 import { type Tree } from '@nx/devkit';
 import { type NxGeneratorInfo } from '../../../utils/nx';
-import type { TsReactWebsiteGeneratorSchema } from './schema';
+import { type IacMetadata } from '../../../utils/shared-constructs-constants';
+import type { TsReactWebsiteGeneratorSchema, WebsiteInfraOption } from './schema';
+/** The metadata this generator records, which its predicates read. */
+export interface TsReactWebsiteMetadata extends IacMetadata {
+    readonly ux: UxOption;
+    readonly framework: string;
+    readonly infra: WebsiteInfraOption;
+    readonly tailwind: boolean;
+    readonly tanstackRouter: boolean;
+}
+export declare const DEPENDENCIES: import("../../../utils/declared-dependencies").DependencyDeclaration<readonly [{
+    readonly name: "react";
+}, {
+    readonly name: "react-dom";
+}, {
+    readonly name: "@nx/react";
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@vitest/ui";
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@cloudscape-design/components";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "@cloudscape-design/board-components";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "@cloudscape-design/global-styles";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "lucide-react";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "tailwindcss";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "@tailwindcss/vite";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@tanstack/react-router";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+}, {
+    readonly name: "@tanstack/router-plugin";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@tanstack/router-generator";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@tanstack/virtual-file-routes";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "@tanstack/router-utils";
+    readonly when: (m: TsReactWebsiteMetadata) => boolean;
+    readonly dev: true;
+    readonly root: true;
+}, {
+    readonly name: "react";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "react-dom";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "class-variance-authority";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "clsx";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "tailwind-merge";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "lucide-react";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "tw-animate-css";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "radix-ui";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vite";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vitest";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@vitest/coverage-v8";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vite";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "vitest";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@vitest/coverage-v8";
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "constructs";
+    readonly when: (m: IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "aws-cdk-lib";
+    readonly when: (m: IacMetadata) => boolean;
+} & {
+    versionOnly: true;
+}, {
+    readonly name: "@types/node";
+} & {
+    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", TsReactWebsiteMetadata>[]>;
 export declare const SUPPORTED_UX_PROVIDERS: readonly ["none", "cloudscape", "shadcn"];
 export type UxOption = (typeof SUPPORTED_UX_PROVIDERS)[number];
 export type Ux = UxOption;