refactor(assets): rename to kebab-case, doc types, sync cdk pins

Address review feedback from @Hweinstock:
- rename AssetManager.ts -> manager.ts (only non-React .ts in the repo
  with an uppercase name; feature dirs use role-named lowercase files
  like core/project/manager.tsx).
- document AssetFile vs EmbeddedFile so the distinction between a
  resolved tree entry and a raw Bun.embeddedFiles blob is explicit.
- sync src/assets/cdk/package.json to the minor-version pins landed in
  #1777 (aws-cdk-lib ~2.261.0, @aws/agentcore-cdk 0.1.0-alpha.45, etc.).

Author: tejaskash

…/__snapshots__/AssetManager.test.ts.snap …nager/__snapshots__/manager.test.ts.snapsrc/assetManager/__snapshots__/AssetManager.test.ts.snap renamed to src/assetManager/__snapshots__/manager.test.ts.snap src/assetManager/__snapshots__/AssetManager.test.ts.snap renamed to src/assetManager/__snapshots__/manager.test.ts.snap

@@ -1,2 +1,2 @@
-export { AssetManager } from "./AssetManager";
+export { AssetManager } from "./manager";
 export { ASSET_NAMES, type AssetName, type AssetVariables } from "./types";

src/assetManager/index.ts

@@ -2,7 +2,7 @@ import { afterEach, describe, expect, test } from "bun:test";
 import { mkdtemp, mkdir, readdir, rm } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
 import { tmpdir } from "node:os";
-import { AssetManager, resolveSourceRoot } from "./AssetManager";
+import { AssetManager, resolveSourceRoot } from "./manager";
 
 const tempDirectories: string[] = [];
 

src/assetManager/AssetManager.test.ts src/assetManager/manager.test.tssrc/assetManager/AssetManager.test.ts renamed to src/assetManager/manager.test.ts

@@ -3,10 +3,23 @@ export const ASSET_NAMES = ["cdk"] as const;
 export type AssetName = (typeof ASSET_NAMES)[number];
 
 export type AssetVariables = Record<string, unknown>;
+
+/**
+ * A single asset resolved to its position within an asset tree, ready to
+ * render. `relativePath` is relative to the asset root (e.g. `bin/cdk.ts`),
+ * regardless of whether the bytes came from disk or an embedded blob.
+ */
 export interface AssetFile {
   relativePath: string;
   text(): Promise<string>;
 }
+
+/**
+ * A raw file embedded in the compiled binary, as exposed by `Bun.embeddedFiles`.
+ * `name` is the full build-time virtual path (e.g.
+ * `agentcore-assets/src/assets/cdk/bin/cdk.ts`), which the manager strips down
+ * to an `AssetFile.relativePath`.
+ */
 export interface EmbeddedFile {
   readonly name: string;
   text(): Promise<string>;

src/assetManager/AssetManager.ts src/assetManager/manager.tssrc/assetManager/AssetManager.ts renamed to src/assetManager/manager.ts

@@ -14,17 +14,17 @@
     "format:check": "prettier --check ."
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "@types/node": "^24.10.1",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.2.5",
-    "aws-cdk": "2.1126.0",
-    "prettier": "^3.4.2",
+    "@types/jest": "~29.5.14",
+    "@types/node": "~24.13.3",
+    "jest": "~29.7.0",
+    "ts-jest": "~29.4.11",
+    "aws-cdk": "~2.1126.0",
+    "prettier": "~3.9.5",
     "typescript": "~5.9.3"
   },
   "dependencies": {
-    "@aws/agentcore-cdk": "^0.1.0-alpha.19",
-    "aws-cdk-lib": "^2.248.0",
-    "constructs": "^10.0.0"
+    "@aws/agentcore-cdk": "0.1.0-alpha.45",
+    "aws-cdk-lib": "~2.261.0",
+    "constructs": "~10.7.0"
   }
 }