@aws/nx-plugin-mcp 1.0.0-rc.43 → 1.0.0-rc.45

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/bin/aws-nx-mcp.js +86 -79
  2. package/docs/get_started/tutorials/dungeon-game/1.mdx +4 -4
  3. package/docs/get_started/tutorials/dungeon-game/3.mdx +1 -1
  4. package/docs/guides/agentcore-gateway.mdx +94 -7
  5. package/docs/guides/connection/py-agent-a2a.mdx +1 -1
  6. package/docs/guides/connection/py-agent-gateway.mdx +3 -1
  7. package/docs/guides/connection/react-agui.mdx +9 -9
  8. package/docs/guides/connection/react-py-agent.mdx +2 -2
  9. package/docs/guides/connection/ts-agent-a2a.mdx +1 -1
  10. package/docs/guides/connection/ts-agent-gateway.mdx +3 -1
  11. package/docs/guides/docker-bundling.mdx +10 -13
  12. package/docs/guides/fastapi.mdx +2 -2
  13. package/docs/guides/py-dynamodb.mdx +3 -3
  14. package/docs/guides/py-rdb.mdx +3 -1
  15. package/docs/guides/python-lambda-function.mdx +1 -1
  16. package/docs/guides/react-website-auth.mdx +1 -1
  17. package/docs/guides/react-website.mdx +3 -3
  18. package/docs/guides/security.mdx +1 -1
  19. package/docs/guides/trpc.mdx +2 -2
  20. package/docs/guides/ts-dcr-proxy.mdx +569 -0
  21. package/docs/guides/ts-dynamodb.mdx +3 -3
  22. package/docs/guides/ts-lambda-function.mdx +1 -1
  23. package/docs/guides/ts-rdb.mdx +4 -0
  24. package/docs/guides/ts-smithy-api.mdx +3 -3
  25. package/docs/guides/typescript-infrastructure.mdx +6 -6
  26. package/docs/snippets/lambda-function/deploying-your-function.mdx +1 -1
  27. package/docs/snippets/rdb/deploying.mdx +1 -1
  28. package/docs/snippets/runtime-config-app-id-note.mdx +8 -0
  29. package/docs/snippets/shared-constructs.mdx +1 -1
  30. package/docs/snippets/trivy-image-scan.mdx +13 -3
  31. package/generators.json +6 -0
  32. package/package.json +1 -1
  33. package/src/agentcore-gateway/schema.json +3 -2
  34. package/src/ts/dcr-proxy/schema.json +44 -0
package/bin/aws-nx-mcp.js CHANGED
@@ -124,7 +124,6 @@ function cached(getter) {
124
124
  Object.defineProperty(this, "value", { value });
125
125
  return value;
126
126
  }
127
- throw new Error("cached value already set");
128
127
  } };
129
128
  }
130
129
  function nullish(input) {
@@ -4583,7 +4582,7 @@ function preprocess$1(fn, schema) {
4583
4582
  });
4584
4583
  }
4585
4584
  //#endregion
4586
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
4585
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/types.js
4587
4586
  const LATEST_PROTOCOL_VERSION = "2025-11-25";
4588
4587
  const SUPPORTED_PROTOCOL_VERSIONS = [
4589
4588
  LATEST_PROTOCOL_VERSION,
@@ -6484,7 +6483,7 @@ var UrlElicitationRequiredError = class extends McpError {
6484
6483
  }
6485
6484
  };
6486
6485
  //#endregion
6487
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
6486
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/stdio.js
6488
6487
  /**
6489
6488
  * Buffers a continuous stdio stream into discrete JSON-RPC messages.
6490
6489
  */
@@ -6511,7 +6510,7 @@ function serializeMessage(message) {
6511
6510
  return JSON.stringify(message) + "\n";
6512
6511
  }
6513
6512
  //#endregion
6514
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
6513
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
6515
6514
  /**
6516
6515
  * Server transport for stdio: this communicates with an MCP client by reading from the current process' stdin and writing to stdout.
6517
6516
  *
@@ -10152,7 +10151,7 @@ function object(shape, params) {
10152
10151
  return new ZodMiniObject(def);
10153
10152
  }
10154
10153
  //#endregion
10155
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
10154
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-compat.js
10156
10155
  function isZ4Schema(s) {
10157
10156
  return !!s._zod;
10158
10157
  }
@@ -10267,7 +10266,7 @@ function getLiteralValue(schema) {
10267
10266
  if (directValue !== void 0) return directValue;
10268
10267
  }
10269
10268
  //#endregion
10270
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
10269
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/interfaces.js
10271
10270
  /**
10272
10271
  * Experimental task interfaces for MCP SDK.
10273
10272
  * WARNING: These APIs are experimental and may change without notice.
@@ -11372,7 +11371,7 @@ const zodToJsonSchema = (schema, options) => {
11372
11371
  return combined;
11373
11372
  };
11374
11373
  //#endregion
11375
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
11374
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/zod-json-schema-compat.js
11376
11375
  function mapMiniTarget(t) {
11377
11376
  if (!t) return "draft-7";
11378
11377
  if (t === "jsonSchema7" || t === "draft-7") return "draft-7";
@@ -18318,7 +18317,7 @@ var require_dist = /* @__PURE__ */ __commonJSMin(((exports, module) => {
18318
18317
  exports.default = formatsPlugin;
18319
18318
  }));
18320
18319
  //#endregion
18321
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
18320
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/validation/ajv-provider.js
18322
18321
  var import_ajv = /* @__PURE__ */ __toESM(require_ajv(), 1);
18323
18322
  var import_dist = /* @__PURE__ */ __toESM(require_dist(), 1);
18324
18323
  function createDefaultAjvInstance() {
@@ -18394,7 +18393,7 @@ var AjvJsonSchemaValidator = class {
18394
18393
  }
18395
18394
  };
18396
18395
  //#endregion
18397
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
18396
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/server.js
18398
18397
  /**
18399
18398
  * Experimental server task features for MCP SDK.
18400
18399
  * WARNING: These APIs are experimental and may change without notice.
@@ -18614,7 +18613,7 @@ var ExperimentalServerTasks = class {
18614
18613
  }
18615
18614
  };
18616
18615
  //#endregion
18617
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
18616
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/helpers.js
18618
18617
  /**
18619
18618
  * Experimental task capability assertion helpers.
18620
18619
  * WARNING: These APIs are experimental and may change without notice.
@@ -18665,7 +18664,7 @@ function assertClientRequestTaskCapability(requests, method, entityName) {
18665
18664
  }
18666
18665
  }
18667
18666
  //#endregion
18668
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
18667
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/index.js
18669
18668
  /**
18670
18669
  * An MCP server on top of a pluggable transport.
18671
18670
  *
@@ -19006,7 +19005,7 @@ var Server = class extends Protocol {
19006
19005
  }
19007
19006
  };
19008
19007
  //#endregion
19009
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
19008
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/completable.js
19010
19009
  const COMPLETABLE_SYMBOL = Symbol.for("mcp.completable");
19011
19010
  /**
19012
19011
  * Checks if a schema is completable (has completion metadata).
@@ -19025,7 +19024,7 @@ var McpZodTypeKind;
19025
19024
  McpZodTypeKind["Completable"] = "McpCompletable";
19026
19025
  })(McpZodTypeKind || (McpZodTypeKind = {}));
19027
19026
  //#endregion
19028
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
19027
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/shared/toolNameValidation.js
19029
19028
  /**
19030
19029
  * Tool name validation utilities according to SEP: Specify Format for Tool Names
19031
19030
  *
@@ -19096,7 +19095,7 @@ function validateAndWarnToolName(name) {
19096
19095
  return result.isValid;
19097
19096
  }
19098
19097
  //#endregion
19099
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
19098
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/experimental/tasks/mcp-server.js
19100
19099
  /**
19101
19100
  * Experimental McpServer task features for MCP SDK.
19102
19101
  * WARNING: These APIs are experimental and may change without notice.
@@ -19127,7 +19126,7 @@ var ExperimentalMcpServerTasks = class {
19127
19126
  }
19128
19127
  };
19129
19128
  //#endregion
19130
- //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
19129
+ //#region ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_supports-color@7.2.0_zod@4.4.3/node_modules/@modelcontextprotocol/sdk/dist/esm/server/mcp.js
19131
19130
  /**
19132
19131
  * High-level MCP server that provides a simpler API for working with resources, tools, and prompts.
19133
19132
  * For advanced usage (like sending notifications or setting custom request handlers), use the underlying
@@ -19963,6 +19962,12 @@ var generators$1 = {
19963
19962
  "description": "Generate a TypeScript lambda function",
19964
19963
  "metric": "g21"
19965
19964
  },
19965
+ "ts#dcr-proxy": {
19966
+ "factory": "./src/ts/dcr-proxy/generator",
19967
+ "schema": "./src/ts/dcr-proxy/schema.json",
19968
+ "description": "Generate an OAuth Dynamic Client Registration (DCR) proxy construct for Cognito-authenticated MCP servers",
19969
+ "metric": "g56"
19970
+ },
19966
19971
  "ts#mcp-server": {
19967
19972
  "factory": "./src/ts/mcp-server/generator",
19968
19973
  "schema": "./src/ts/mcp-server/schema.json",
@@ -21297,14 +21302,15 @@ const kebabCase = (str) => {
21297
21302
  const NX_VERSION = {
21298
21303
  "@a2a-js/sdk": "0.3.14",
21299
21304
  "@aws/aws-distro-opentelemetry-node-autoinstrumentation": "0.12.0",
21300
- "@aws-sdk/client-dynamodb": "3.1085.0",
21301
- "@aws-sdk/client-bedrock-runtime": "3.1085.0",
21302
- "@aws-sdk/client-s3": "3.1085.0",
21303
- "@aws-sdk/client-sts": "3.1085.0",
21304
- "@aws-sdk/credential-providers": "3.1085.0",
21305
- "@aws-sdk/credential-provider-cognito-identity": "3.972.56",
21306
- "@aws-sdk/client-secrets-manager": "3.1085.0",
21307
- "@aws-sdk/rds-signer": "3.1085.0",
21305
+ "@opentelemetry/propagator-jaeger": "2.9.0",
21306
+ "@aws-sdk/client-dynamodb": "3.1090.0",
21307
+ "@aws-sdk/client-bedrock-runtime": "3.1090.0",
21308
+ "@aws-sdk/client-s3": "3.1090.0",
21309
+ "@aws-sdk/client-sts": "3.1090.0",
21310
+ "@aws-sdk/credential-providers": "3.1090.0",
21311
+ "@aws-sdk/credential-provider-cognito-identity": "3.972.58",
21312
+ "@aws-sdk/client-secrets-manager": "3.1090.0",
21313
+ "@aws-sdk/rds-signer": "3.1090.0",
21308
21314
  "@aws-smithy/server-apigateway": "1.0.0-alpha.10",
21309
21315
  "@aws-smithy/server-node": "1.0.0-alpha.10",
21310
21316
  "@aws-lambda-powertools/logger": "2.34.0",
@@ -21312,33 +21318,34 @@ const NX_VERSION = {
21312
21318
  "@aws-lambda-powertools/parameters": "2.34.0",
21313
21319
  "@aws-lambda-powertools/tracer": "2.34.0",
21314
21320
  "@aws-lambda-powertools/parser": "2.34.0",
21315
- "@aws-sdk/client-appconfigdata": "3.1085.0",
21321
+ "@aws-sdk/client-appconfigdata": "3.1090.0",
21316
21322
  "@middy/core": "7.7.0",
21317
- "@nxlv/python": "22.2.1",
21323
+ "@nxlv/python": "22.2.2",
21318
21324
  "@nx-extend/terraform": "10.3.0",
21319
21325
  "@nx/devkit": "23.1.0",
21320
21326
  "@nx/react": "23.1.0",
21321
21327
  "create-nx-workspace": "23.1.0",
21322
- "@swc-node/register": "1.11.1",
21328
+ "@swc-node/register": "1.12.1",
21323
21329
  "@swc/core": "1.15.43",
21324
21330
  "@modelcontextprotocol/sdk": "1.29.0",
21325
21331
  "@modelcontextprotocol/inspector": "0.22.0",
21332
+ "@ag-ui/a2ui-toolkit": "0.0.4",
21326
21333
  "@ag-ui/aws-strands": "0.2.3",
21327
21334
  "@ag-ui/client": "0.0.57",
21328
21335
  "@ag-ui/core": "0.0.57",
21329
21336
  "@ag-ui/encoder": "0.0.57",
21330
21337
  "agent-chat-cli": "0.3.0",
21331
- "@copilotkit/react-core": "1.62.3",
21338
+ "@copilotkit/react-core": "1.63.1",
21332
21339
  rxjs: "7.8.2",
21333
- "@strands-agents/sdk": "1.9.0",
21334
- "@tanstack/react-router": "1.170.17",
21335
- "@tanstack/router-plugin": "1.168.19",
21336
- "@tanstack/router-generator": "1.167.18",
21340
+ "@strands-agents/sdk": "1.10.0",
21341
+ "@tanstack/react-router": "1.170.18",
21342
+ "@tanstack/router-plugin": "1.168.22",
21343
+ "@tanstack/router-generator": "1.167.21",
21337
21344
  "@tanstack/virtual-file-routes": "1.162.0",
21338
21345
  "@tanstack/router-utils": "1.162.2",
21339
- "@cloudscape-design/board-components": "3.0.201",
21340
- "@cloudscape-design/chat-components": "1.0.149",
21341
- "@cloudscape-design/components": "3.0.1325",
21346
+ "@cloudscape-design/board-components": "3.0.205",
21347
+ "@cloudscape-design/chat-components": "1.0.151",
21348
+ "@cloudscape-design/components": "3.0.1330",
21342
21349
  "@cloudscape-design/global-styles": "1.0.62",
21343
21350
  "@tanstack/react-query": "5.101.2",
21344
21351
  "@tanstack/react-query-devtools": "5.101.2",
@@ -21351,20 +21358,20 @@ const NX_VERSION = {
21351
21358
  "@types/pg": "8.20.0",
21352
21359
  "@types/ws": "8.18.1",
21353
21360
  "@types/express": "5.0.6",
21354
- "@smithy/config-resolver": "4.6.8",
21355
- "@smithy/node-config-provider": "4.5.8",
21356
- "@smithy/node-http-handler": "4.9.5",
21361
+ "@smithy/config-resolver": "4.6.10",
21362
+ "@smithy/node-config-provider": "4.5.10",
21363
+ "@smithy/node-http-handler": "4.9.7",
21357
21364
  "@smithy/types": "4.16.1",
21358
21365
  "@vitest/coverage-v8": "4.1.10",
21359
21366
  "@vitest/ui": "4.1.10",
21360
21367
  "@astrojs/react": "6.0.1",
21361
21368
  "@astrojs/starlight": "0.41.3",
21362
- astro: "7.0.7",
21369
+ astro: "7.1.1",
21363
21370
  aws4fetch: "1.0.20",
21364
- "aws-cdk": "2.1130.0",
21371
+ "aws-cdk": "2.1132.0",
21365
21372
  "aws-cdk-lib": "2.261.0",
21366
21373
  "aws-xray-sdk-core": "3.12.0",
21367
- constructs: "10.6.0",
21374
+ constructs: "10.7.0",
21368
21375
  cors: "2.8.6",
21369
21376
  chalk: "5.6.2",
21370
21377
  "class-variance-authority": "0.7.1",
@@ -21374,7 +21381,7 @@ const NX_VERSION = {
21374
21381
  esbuild: "0.28.1",
21375
21382
  "event-source-polyfill": "1.0.31",
21376
21383
  "@types/event-source-polyfill": "1.0.5",
21377
- "@biomejs/biome": "2.5.3",
21384
+ "@biomejs/biome": "2.5.4",
21378
21385
  "@prisma/adapter-mariadb": "7.8.0",
21379
21386
  "@prisma/adapter-pg": "7.8.0",
21380
21387
  "@prisma/client": "7.8.0",
@@ -21397,23 +21404,23 @@ const NX_VERSION = {
21397
21404
  react: "19.2.7",
21398
21405
  "react-dom": "19.2.7",
21399
21406
  rimraf: "6.1.3",
21400
- rolldown: "1.1.5",
21407
+ rolldown: "1.2.0",
21401
21408
  "simple-git": "3.36.0",
21402
21409
  "source-map-support": "0.5.21",
21403
21410
  "starlight-blog": "0.28.0",
21404
- tailwindcss: "4.3.2",
21405
- "@tailwindcss/vite": "4.3.2",
21406
- tsx: "4.23.0",
21407
- "lucide-react": "1.24.0",
21411
+ tailwindcss: "4.3.3",
21412
+ "@tailwindcss/vite": "4.3.3",
21413
+ tsx: "4.23.1",
21414
+ "lucide-react": "1.25.0",
21408
21415
  "radix-ui": "1.6.2",
21409
- shadcn: "4.13.0",
21416
+ shadcn: "4.13.1",
21410
21417
  "tw-animate-css": "1.4.0",
21411
21418
  "tailwind-merge": "3.6.0",
21412
- vite: "8.1.4",
21419
+ vite: "8.1.5",
21413
21420
  typescript: "6.0.3",
21414
21421
  vitest: "4.1.10",
21415
21422
  zod: "4.4.3",
21416
- ws: "8.21.0"
21423
+ ws: "8.21.1"
21417
21424
  }["@nx/devkit"];
21418
21425
  const PACKAGE_MANAGER_COMMANDS = {
21419
21426
  npm: {
@@ -21457,7 +21464,7 @@ const buildInstallCommand = (pm, pkg, dev) => {
21457
21464
  case "pnpm": return `pnpm add ${dev ? "-D" : "-"}w ${pkg}`;
21458
21465
  case "yarn": return `yarn add ${dev ? "-D " : ""}${pkg}`;
21459
21466
  case "npm": return `npm install --legacy-peer-deps ${dev ? "-D " : ""}${pkg}`;
21460
- case "bun": return `bun install ${dev ? "-D " : ""}${pkg}`;
21467
+ case "bun": return `bun add ${dev ? "-D " : ""}${pkg}`;
21461
21468
  default: return `${pm} install ${dev ? "-D " : ""}${pkg}`;
21462
21469
  }
21463
21470
  };
@@ -28563,7 +28570,7 @@ var init_micromark_factory_space = __esmMin((() => {
28563
28570
  init_micromark_util_character();
28564
28571
  }));
28565
28572
  //#endregion
28566
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/content.js
28573
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/initialize/content.js
28567
28574
  /**
28568
28575
  * @this {TokenizeContext}
28569
28576
  * Context.
@@ -28625,7 +28632,7 @@ var init_content$1 = __esmMin((() => {
28625
28632
  content$1 = { tokenize: initializeContent };
28626
28633
  }));
28627
28634
  //#endregion
28628
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/document.js
28635
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/initialize/document.js
28629
28636
  /**
28630
28637
  * @this {TokenizeContext}
28631
28638
  * Self.
@@ -34313,7 +34320,7 @@ var init_micromark_core_commonmark = __esmMin((() => {
34313
34320
  init_thematic_break$1();
34314
34321
  }));
34315
34322
  //#endregion
34316
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/flow.js
34323
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/initialize/flow.js
34317
34324
  /**
34318
34325
  * @this {TokenizeContext}
34319
34326
  * Self.
@@ -34356,7 +34363,7 @@ var init_flow = __esmMin((() => {
34356
34363
  flow$1 = { tokenize: initializeFlow };
34357
34364
  }));
34358
34365
  //#endregion
34359
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/initialize/text.js
34366
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/initialize/text.js
34360
34367
  /**
34361
34368
  * @param {'string' | 'text'} field
34362
34369
  * Field.
@@ -34526,7 +34533,7 @@ var init_text$1 = __esmMin((() => {
34526
34533
  text$2 = initializeFactory("text");
34527
34534
  }));
34528
34535
  //#endregion
34529
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/constructs.js
34536
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/constructs.js
34530
34537
  var constructs_exports = /* @__PURE__ */ __exportAll({
34531
34538
  attentionMarkers: () => attentionMarkers,
34532
34539
  contentInitial: () => contentInitial,
@@ -34597,7 +34604,7 @@ var init_constructs = __esmMin((() => {
34597
34604
  disable = { null: [] };
34598
34605
  }));
34599
34606
  //#endregion
34600
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/create-tokenizer.js
34607
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/create-tokenizer.js
34601
34608
  /**
34602
34609
  * Create a tokenizer.
34603
34610
  * Tokenizers deal with one type of data (e.g., containers, flow, text).
@@ -35034,7 +35041,7 @@ var init_create_tokenizer = __esmMin((() => {
35034
35041
  init_micromark_util_resolve_all();
35035
35042
  }));
35036
35043
  //#endregion
35037
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/parse.js
35044
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/parse.js
35038
35045
  /**
35039
35046
  * @param {ParseOptions | null | undefined} [options]
35040
35047
  * Configuration (optional).
@@ -35078,7 +35085,7 @@ var init_parse = __esmMin((() => {
35078
35085
  init_create_tokenizer();
35079
35086
  }));
35080
35087
  //#endregion
35081
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/postprocess.js
35088
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/postprocess.js
35082
35089
  /**
35083
35090
  * @param {Array<Event>} events
35084
35091
  * Events.
@@ -35093,7 +35100,7 @@ var init_postprocess = __esmMin((() => {
35093
35100
  init_micromark_util_subtokenize();
35094
35101
  }));
35095
35102
  //#endregion
35096
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/lib/preprocess.js
35103
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/lib/preprocess.js
35097
35104
  /**
35098
35105
  * @returns {Preprocessor}
35099
35106
  * Preprocess a value.
@@ -35182,7 +35189,7 @@ var init_preprocess = __esmMin((() => {
35182
35189
  search = /[\0\t\n\r]/g;
35183
35190
  }));
35184
35191
  //#endregion
35185
- //#region ../../node_modules/.pnpm/micromark@4.0.2/node_modules/micromark/index.js
35192
+ //#region ../../node_modules/.pnpm/micromark@4.0.2_supports-color@10.2.2/node_modules/micromark/index.js
35186
35193
  var init_micromark = __esmMin((() => {
35187
35194
  init_decode_named_character_reference();
35188
35195
  init_micromark_util_combine_extensions();
@@ -35234,7 +35241,7 @@ var init_micromark_util_decode_string = __esmMin((() => {
35234
35241
  characterEscapeOrReference = /\\([!-/:-@[-`{-~])|&(#(?:\d{1,7}|x[\da-f]{1,6})|[\da-z]{1,31});/gi;
35235
35242
  }));
35236
35243
  //#endregion
35237
- //#region ../../node_modules/.pnpm/mdast-util-from-markdown@2.0.2/node_modules/mdast-util-from-markdown/lib/index.js
35244
+ //#region ../../node_modules/.pnpm/mdast-util-from-markdown@2.0.2_supports-color@10.2.2/node_modules/mdast-util-from-markdown/lib/index.js
35238
35245
  /**
35239
35246
  * Turn markdown into a syntax tree.
35240
35247
  *
@@ -36170,12 +36177,12 @@ var init_lib$20 = __esmMin((() => {
36170
36177
  own$4 = {}.hasOwnProperty;
36171
36178
  }));
36172
36179
  //#endregion
36173
- //#region ../../node_modules/.pnpm/mdast-util-from-markdown@2.0.2/node_modules/mdast-util-from-markdown/index.js
36180
+ //#region ../../node_modules/.pnpm/mdast-util-from-markdown@2.0.2_supports-color@10.2.2/node_modules/mdast-util-from-markdown/index.js
36174
36181
  var init_mdast_util_from_markdown = __esmMin((() => {
36175
36182
  init_lib$20();
36176
36183
  }));
36177
36184
  //#endregion
36178
- //#region ../../node_modules/.pnpm/remark-parse@11.0.0/node_modules/remark-parse/lib/index.js
36185
+ //#region ../../node_modules/.pnpm/remark-parse@11.0.0_supports-color@10.2.2/node_modules/remark-parse/lib/index.js
36179
36186
  /**
36180
36187
  * Aadd support for parsing from markdown.
36181
36188
  *
@@ -36204,13 +36211,13 @@ var init_lib$19 = __esmMin((() => {
36204
36211
  init_mdast_util_from_markdown();
36205
36212
  }));
36206
36213
  //#endregion
36207
- //#region ../../node_modules/.pnpm/remark-parse@11.0.0/node_modules/remark-parse/index.js
36214
+ //#region ../../node_modules/.pnpm/remark-parse@11.0.0_supports-color@10.2.2/node_modules/remark-parse/index.js
36208
36215
  var remark_parse_exports = /* @__PURE__ */ __exportAll({ default: () => remarkParse });
36209
36216
  var init_remark_parse = __esmMin((() => {
36210
36217
  init_lib$19();
36211
36218
  }));
36212
36219
  //#endregion
36213
- //#region ../../node_modules/.pnpm/mdast-util-mdx-expression@2.0.1/node_modules/mdast-util-mdx-expression/lib/index.js
36220
+ //#region ../../node_modules/.pnpm/mdast-util-mdx-expression@2.0.1_supports-color@10.2.2/node_modules/mdast-util-mdx-expression/lib/index.js
36214
36221
  /**
36215
36222
  * Create an extension for `mdast-util-from-markdown` to enable MDX expressions
36216
36223
  * in markdown.
@@ -36321,7 +36328,7 @@ var init_lib$18 = __esmMin((() => {
36321
36328
  init_default();
36322
36329
  }));
36323
36330
  //#endregion
36324
- //#region ../../node_modules/.pnpm/mdast-util-mdx-expression@2.0.1/node_modules/mdast-util-mdx-expression/index.js
36331
+ //#region ../../node_modules/.pnpm/mdast-util-mdx-expression@2.0.1_supports-color@10.2.2/node_modules/mdast-util-mdx-expression/index.js
36325
36332
  var init_mdast_util_mdx_expression = __esmMin((() => {
36326
36333
  init_lib$18();
36327
36334
  }));
@@ -36892,7 +36899,7 @@ var init_stringify_entities = __esmMin((() => {
36892
36899
  init_lib$16();
36893
36900
  }));
36894
36901
  //#endregion
36895
- //#region ../../node_modules/.pnpm/mdast-util-mdx-jsx@3.2.0/node_modules/mdast-util-mdx-jsx/lib/index.js
36902
+ //#region ../../node_modules/.pnpm/mdast-util-mdx-jsx@3.2.0_supports-color@10.2.2/node_modules/mdast-util-mdx-jsx/lib/index.js
36896
36903
  /**
36897
36904
  * Create an extension for `mdast-util-from-markdown` to enable MDX JSX.
36898
36905
  *
@@ -37415,12 +37422,12 @@ var init_lib$15 = __esmMin((() => {
37415
37422
  indent = " ";
37416
37423
  }));
37417
37424
  //#endregion
37418
- //#region ../../node_modules/.pnpm/mdast-util-mdx-jsx@3.2.0/node_modules/mdast-util-mdx-jsx/index.js
37425
+ //#region ../../node_modules/.pnpm/mdast-util-mdx-jsx@3.2.0_supports-color@10.2.2/node_modules/mdast-util-mdx-jsx/index.js
37419
37426
  var init_mdast_util_mdx_jsx = __esmMin((() => {
37420
37427
  init_lib$15();
37421
37428
  }));
37422
37429
  //#endregion
37423
- //#region ../../node_modules/.pnpm/mdast-util-mdxjs-esm@2.0.1/node_modules/mdast-util-mdxjs-esm/lib/index.js
37430
+ //#region ../../node_modules/.pnpm/mdast-util-mdxjs-esm@2.0.1_supports-color@10.2.2/node_modules/mdast-util-mdxjs-esm/lib/index.js
37424
37431
  /**
37425
37432
  * Create an extension for `mdast-util-from-markdown` to enable MDX.js ESM in
37426
37433
  * markdown.
@@ -37493,12 +37500,12 @@ var init_lib$14 = __esmMin((() => {
37493
37500
  init_default();
37494
37501
  }));
37495
37502
  //#endregion
37496
- //#region ../../node_modules/.pnpm/mdast-util-mdxjs-esm@2.0.1/node_modules/mdast-util-mdxjs-esm/index.js
37503
+ //#region ../../node_modules/.pnpm/mdast-util-mdxjs-esm@2.0.1_supports-color@10.2.2/node_modules/mdast-util-mdxjs-esm/index.js
37497
37504
  var init_mdast_util_mdxjs_esm = __esmMin((() => {
37498
37505
  init_lib$14();
37499
37506
  }));
37500
37507
  //#endregion
37501
- //#region ../../node_modules/.pnpm/mdast-util-mdx@3.0.0/node_modules/mdast-util-mdx/lib/index.js
37508
+ //#region ../../node_modules/.pnpm/mdast-util-mdx@3.0.0_supports-color@10.2.2/node_modules/mdast-util-mdx/lib/index.js
37502
37509
  /**
37503
37510
  * Create an extension for `mdast-util-from-markdown` to enable MDX (ESM, JSX,
37504
37511
  * expressions).
@@ -37540,7 +37547,7 @@ var init_lib$13 = __esmMin((() => {
37540
37547
  init_mdast_util_mdxjs_esm();
37541
37548
  }));
37542
37549
  //#endregion
37543
- //#region ../../node_modules/.pnpm/mdast-util-mdx@3.0.0/node_modules/mdast-util-mdx/index.js
37550
+ //#region ../../node_modules/.pnpm/mdast-util-mdx@3.0.0_supports-color@10.2.2/node_modules/mdast-util-mdx/index.js
37544
37551
  var init_mdast_util_mdx = __esmMin((() => {
37545
37552
  init_lib$13();
37546
37553
  }));
@@ -50420,7 +50427,7 @@ var init_micromark_extension_mdxjs = __esmMin((() => {
50420
50427
  init_micromark_util_combine_extensions();
50421
50428
  }));
50422
50429
  //#endregion
50423
- //#region ../../node_modules/.pnpm/remark-mdx@3.1.1/node_modules/remark-mdx/lib/index.js
50430
+ //#region ../../node_modules/.pnpm/remark-mdx@3.1.1_supports-color@10.2.2/node_modules/remark-mdx/lib/index.js
50424
50431
  /**
50425
50432
  * Add support for MDX (JSX: `<Video id={123} />`, export/imports: `export {x}
50426
50433
  * from 'y'`; and expressions: `{1 + 1}`).
@@ -50450,7 +50457,7 @@ var init_lib$8 = __esmMin((() => {
50450
50457
  emptyOptions$1 = {};
50451
50458
  }));
50452
50459
  //#endregion
50453
- //#region ../../node_modules/.pnpm/remark-mdx@3.1.1/node_modules/remark-mdx/index.js
50460
+ //#region ../../node_modules/.pnpm/remark-mdx@3.1.1_supports-color@10.2.2/node_modules/remark-mdx/index.js
50454
50461
  var remark_mdx_exports = /* @__PURE__ */ __exportAll({ default: () => remarkMdx });
50455
50462
  var init_remark_mdx = __esmMin((() => {
50456
50463
  init_lib$8();
@@ -53405,7 +53412,7 @@ function escapeStringRegexp(string) {
53405
53412
  }
53406
53413
  var init_escape_string_regexp = __esmMin((() => {}));
53407
53414
  //#endregion
53408
- //#region ../../node_modules/.pnpm/mdast-util-frontmatter@2.0.1/node_modules/mdast-util-frontmatter/lib/index.js
53415
+ //#region ../../node_modules/.pnpm/mdast-util-frontmatter@2.0.1_supports-color@10.2.2/node_modules/mdast-util-frontmatter/lib/index.js
53409
53416
  /**
53410
53417
  * Create an extension for `mdast-util-from-markdown`.
53411
53418
  *
@@ -53556,12 +53563,12 @@ var init_lib$1 = __esmMin((() => {
53556
53563
  init_escape_string_regexp();
53557
53564
  }));
53558
53565
  //#endregion
53559
- //#region ../../node_modules/.pnpm/mdast-util-frontmatter@2.0.1/node_modules/mdast-util-frontmatter/index.js
53566
+ //#region ../../node_modules/.pnpm/mdast-util-frontmatter@2.0.1_supports-color@10.2.2/node_modules/mdast-util-frontmatter/index.js
53560
53567
  var init_mdast_util_frontmatter = __esmMin((() => {
53561
53568
  init_lib$1();
53562
53569
  }));
53563
53570
  //#endregion
53564
- //#region ../../node_modules/.pnpm/remark-frontmatter@5.0.0/node_modules/remark-frontmatter/lib/index.js
53571
+ //#region ../../node_modules/.pnpm/remark-frontmatter@5.0.0_supports-color@10.2.2/node_modules/remark-frontmatter/lib/index.js
53565
53572
  /**
53566
53573
  * Add support for frontmatter.
53567
53574
  *
@@ -53592,7 +53599,7 @@ var init_lib = __esmMin((() => {
53592
53599
  emptyOptions = "yaml";
53593
53600
  }));
53594
53601
  //#endregion
53595
- //#region ../../node_modules/.pnpm/remark-frontmatter@5.0.0/node_modules/remark-frontmatter/index.js
53602
+ //#region ../../node_modules/.pnpm/remark-frontmatter@5.0.0_supports-color@10.2.2/node_modules/remark-frontmatter/index.js
53596
53603
  var remark_frontmatter_exports = /* @__PURE__ */ __exportAll({ default: () => remarkFrontmatter });
53597
53604
  var init_remark_frontmatter = __esmMin((() => {
53598
53605
  init_lib();
@@ -54448,7 +54455,7 @@ ${PACKAGE_MANAGERS.map((pm) => buildNxCommand("<options>", pm)).join(" - \n")}
54448
54455
  - pnpm add -w -D <package>
54449
54456
  - yarn add -D <package>
54450
54457
  - npm install --legacy-peer-deps -D <package>
54451
- - bun install -D <package>
54458
+ - bun add -D <package>
54452
54459
  - (Omit -D for production dependencies)
54453
54460
  - When specifying project names as arguments to generators, prefer the _fully qualified_ project name, for example \`@workspace-name/project-name\`. Check the \`project.json\` file for the specific package to find its fully qualified name
54454
54461
  - When no generator exists for a specific framework required, use the base \`ts#project\` and \`py#project\` generators and build on top.
@@ -400,7 +400,7 @@ To add a Strands agent to the project with the `py#agent` generator:
400
400
  <RunGenerator generator="py#agent" requiredParameters={{project:"story", auth:"cognito", protocol:"ag-ui"}} noInteractive />
401
401
 
402
402
  :::note[AG-UI protocol]
403
- We choose `--protocol=AG-UI` so the agent speaks the [Agent-User Interaction protocol](https://docs.copilotkit.ai/aws-strands/protocol) — this lets our React website talk to it directly via [CopilotKit](https://docs.copilotkit.ai/), with streaming, tool calls, and conversation history handled by the protocol instead of a hand-rolled HTTP client.
403
+ We choose `--protocol=ag-ui` so the agent speaks the [Agent-User Interaction protocol](https://docs.copilotkit.ai/aws-strands/protocol) — this lets our React website talk to it directly via [CopilotKit](https://docs.copilotkit.ai/), with streaming, tool calls, and conversation history handled by the protocol instead of a hand-rolled HTTP client.
404
404
  :::
405
405
 
406
406
  You will see some new files appear in your file tree.
@@ -494,7 +494,7 @@ app = create_strands_app(agui_agent, path="/invocations")
494
494
  app.add_middleware(_SessionIdMiddleware)
495
495
  ```
496
496
 
497
- This is the entrypoint for the agent. Because we selected `--protocol=AG-UI`, the generator wraps our Strands `Agent` with `StrandsAgent` from [`ag_ui_strands`](https://docs.copilotkit.ai/aws-strands/integration) and mounts it on a FastAPI app that speaks the [AG-UI protocol](https://docs.copilotkit.ai/aws-strands/protocol) — this is what CopilotKit will talk to from the React website. The `_SessionIdMiddleware` binds the inbound AgentCore runtime session ID onto a `ContextVar` so any downstream MCP/A2A client we wire up later (e.g. the Inventory MCP server in <Link path="get_started/tutorials/dungeon-game/2">Module 2</Link>) automatically forwards it on its outbound calls. In <Link path="get_started/tutorials/dungeon-game/3">Module 3</Link> we'll also add a `session_manager_provider` so each thread id gets its own `S3SessionManager` and conversation history persists across turns.
497
+ This is the entrypoint for the agent. Because we selected `--protocol=ag-ui`, the generator wraps our Strands `Agent` with `StrandsAgent` from [`ag_ui_strands`](https://docs.copilotkit.ai/aws-strands/integration) and mounts it on a FastAPI app that speaks the [AG-UI protocol](https://docs.copilotkit.ai/aws-strands/protocol) — this is what CopilotKit will talk to from the React website. The `_SessionIdMiddleware` binds the inbound AgentCore runtime session ID onto a `ContextVar` so any downstream MCP/A2A client we wire up later (e.g. the Inventory MCP server in <Link path="get_started/tutorials/dungeon-game/2">Module 2</Link>) automatically forwards it on its outbound calls. In <Link path="get_started/tutorials/dungeon-game/3">Module 3</Link> we'll also add a `session_manager_provider` so each thread id gets its own `S3SessionManager` and conversation history persists across turns.
498
498
 
499
499
  ```ts
500
500
  // common/constructs/src/app/agents/story-agent.ts
@@ -715,7 +715,7 @@ The `ts#website` generates these files. Let us examine some of the key files hig
715
715
  - vite.config.mts
716
716
  - ...
717
717
  - common/
718
- - shadcn/ shared shadcn/ui library (theme tokens, `Button`, `Card`, `Input`, `Sidebar`, …) imported by every `uxProvider=Shadcn` website
718
+ - shadcn/ shared shadcn/ui library (theme tokens, `Button`, `Card`, `Input`, `Sidebar`, …) imported by every `ux=shadcn` website
719
719
  - src/components/ui/*
720
720
  - src/styles/globals.css Tailwind + shadcn design tokens
721
721
  - ...
@@ -1033,7 +1033,7 @@ The `connection` generator generates/updates these files:
1033
1033
  </FileTree>
1034
1034
 
1035
1035
  The generator:
1036
- - Detects the React website's `uxProvider` (Shadcn here) and vends matching chat components.
1036
+ - Detects the React website's `ux` (Shadcn here) and vends matching chat components.
1037
1037
  - Registers every connected agent on a single `CopilotKitProvider` — re-running for another agent just adds another hook.
1038
1038
  - Reads the agent's runtime ARN from Runtime Configuration, builds the AgentCore invocation URL, and attaches the Cognito bearer token plus the AgentCore session id header.
1039
1039
 
@@ -23,7 +23,7 @@ import gameConversationPng from '@assets/game-conversation.png'
23
23
 
24
24
  ## Task 1: Implement the Story Agent
25
25
 
26
- The Story Agent is a [Strands](https://strandsagents.com/) agent generated with `--protocol=AG-UI` in <Link path="get_started/tutorials/dungeon-game/1">Module 1</Link>, so the UI can stream from it over the [Agent-User Interaction protocol](https://docs.copilotkit.ai/aws-strands/protocol) via CopilotKit. It uses the Inventory MCP Server to manage the player's items, and Strands' built-in [`S3SessionManager`](https://strandsagents.com/latest/documentation/docs/user-guide/concepts/agents/sessions/) to persist conversation history into the sessions bucket we provisioned in Module 2.
26
+ The Story Agent is a [Strands](https://strandsagents.com/) agent generated with `--protocol=ag-ui` in <Link path="get_started/tutorials/dungeon-game/1">Module 1</Link>, so the UI can stream from it over the [Agent-User Interaction protocol](https://docs.copilotkit.ai/aws-strands/protocol) via CopilotKit. It uses the Inventory MCP Server to manage the player's items, and Strands' built-in [`S3SessionManager`](https://strandsagents.com/latest/documentation/docs/user-guide/concepts/agents/sessions/) to persist conversation history into the sessions bucket we provisioned in Module 2.
27
27
 
28
28
  ### Agent implementation
29
29