@dotcms/ai 1.5.5-next.2285 → 1.5.5-next.2290

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/ai",
-  "version": "1.5.5-next.2285",
+  "version": "1.5.5-next.2290",
   "description": "The dotCMS agentic runtime — run model-written or human-written code safely against a dotCMS instance, with auth and policy owned in one place.",
   "repository": {
     "type": "git",

package/spec.cjs.js

@@ -989,7 +989,7 @@ var paths = {
 			requestBody: {
 				description: "Updated container configuration data including identifier and modified properties",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -1135,7 +1135,7 @@ var paths = {
 			requestBody: {
 				description: "Container configuration data including title, code, content type structures, and display settings",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -3149,41 +3149,61 @@ var paths = {
 			}
 		}
 	},
-	"/api/v1/folder/sitename/{siteName}/uri/{uri}": {
-		get: {
+	"/api/v1/folder/byPath": {
+		post: {
 			tags: [
 				"Folders"
 			],
-			summary: "Load a folder by site name and URI",
-			description: "Retrieves a folder by its URI path within the specified site.",
-			operationId: "loadFolderByURI",
+			summary: "Find subfolders by path",
+			description: "Retrieves subfolders of a given path, filtered by the path sent. The path format supports site-specific search (//siteName/path) or global search (/path). For example: '//default/folder1/' returns subfolder1, subfolder2 under folder1 in the 'default' site. '/folder1/s' returns all subfolders starting with 's' under folder1 across all sites.",
+			operationId: "findSubFoldersByPath",
 			parameters: [
 				{
-					name: "siteName",
-					"in": "path",
-					required: true,
+					name: "offset",
+					"in": "query",
+					description: "Number of results to skip for pagination. Must be >= 0.",
 					schema: {
-						type: "string"
+						type: "integer",
+						format: "int32",
+						"default": 0
 					}
 				},
 				{
-					name: "uri",
-					"in": "path",
-					required: true,
+					name: "limit",
+					"in": "query",
+					description: "Maximum number of results to return. Default 40. Use -1 for unlimited (capped at 10000 as a safety limit).",
 					schema: {
-						pattern: ".+",
-						type: "string"
+						type: "integer",
+						format: "int32",
+						"default": 40
 					}
 				}
 			],
+			requestBody: {
+				content: {
+					"*/*": {
+						schema: {
+							type: "object",
+							properties: {
+								path: {
+									type: "string"
+								}
+							}
+						}
+					}
+				}
+			},
 			responses: {
 				"200": {
-					description: "Folder retrieved successfully",
+					description: "Subfolders retrieved successfully",
 					content: {
 						"application/json": {
 						}
 					}
 				},
+				"400": {
+					description: "Path property must be sent"
+				},
 				"401": {
 					description: "Authentication required"
 				},
@@ -3191,117 +3211,54 @@ var paths = {
 					description: "Insufficient permissions"
 				},
 				"404": {
-					description: "Folder not found"
+					description: "Site not found"
 				}
 			}
 		}
 	},
-	"/api/v1/folder/search": {
+	"/api/v1/folder/sitename/{siteName}/uri/{uri}": {
 		get: {
 			tags: [
 				"Folders"
 			],
-			summary: "Search folders",
-			description: "Returns folders within a site matching an optional name filter and/or path scope. Supports recursive depth control, standard pagination, and sorting. With no 'name' and default path '/' + recursive=true, all site folders are returned.",
-			operationId: "searchFolders",
+			summary: "Load a folder by site name and URI",
+			description: "Retrieves a folder by its URI path within the specified site.",
+			operationId: "loadFolderByURI",
 			parameters: [
 				{
-					name: "name",
-					"in": "query",
-					description: "Optional case-insensitive partial match on folder name (minimum 3 characters when provided)",
+					name: "siteName",
+					"in": "path",
+					required: true,
 					schema: {
 						type: "string"
 					}
 				},
 				{
-					name: "path",
-					"in": "query",
-					description: "Path scope for the search. Defaults to '/' (site root).",
-					schema: {
-						type: "string",
-						"default": "/"
-					}
-				},
-				{
-					name: "recursive",
-					"in": "query",
-					description: "false = direct children of 'path' only (default); true = search all descendants",
-					schema: {
-						type: "boolean",
-						"default": false
-					}
-				},
-				{
-					name: "siteId",
-					"in": "query",
-					description: "Site ID to scope the search (required)",
+					name: "uri",
+					"in": "path",
+					required: true,
 					schema: {
+						pattern: ".+",
 						type: "string"
 					}
-				},
-				{
-					name: "orderby",
-					"in": "query",
-					description: "Column to sort by.",
-					schema: {
-						type: "string",
-						"enum": [
-							"name",
-							"mod_date"
-						],
-						"default": "name"
-					}
-				},
-				{
-					name: "direction",
-					"in": "query",
-					description: "Sort direction",
-					schema: {
-						type: "string",
-						"enum": [
-							"ASC",
-							"DESC"
-						],
-						"default": "ASC"
-					}
-				},
-				{
-					name: "page",
-					"in": "query",
-					description: "Page number (1-based, default 1)",
-					schema: {
-						type: "integer",
-						format: "int32",
-						"default": 1
-					}
-				},
-				{
-					name: "per_page",
-					"in": "query",
-					description: "Number of results per page (default 40)",
-					schema: {
-						type: "integer",
-						format: "int32",
-						"default": 40
-					}
 				}
 			],
 			responses: {
 				"200": {
-					description: "Paginated list of matching folders",
+					description: "Folder retrieved successfully",
 					content: {
 						"application/json": {
 						}
 					}
 				},
-				"400": {
-					description: "'siteId' is required; 'name' must be at least 3 characters if provided"
-				},
 				"401": {
-					description: "User is not authenticated"
+					description: "Authentication required"
 				},
-				"500": {
-					description: "Internal server error"
+				"403": {
+					description: "Insufficient permissions"
+				},
+				"404": {
+					description: "Folder not found"
 				}
 			}
 		}
@@ -5261,9 +5218,8 @@ var paths = {
 				}
 			],
 			requestBody: {
-				description: "Updated site properties. 'siteName' (the hostname) is required.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							type: "object",
 							properties: {
@@ -5342,8 +5298,7 @@ var paths = {
 							}
 						}
 					}
-				},
-				required: true
+				}
 			},
 			responses: {
 				"200": {
@@ -5375,9 +5330,8 @@ var paths = {
 			description: "Creates a new site with the provided properties including hostname, aliases, tag storage, SEO settings, and optional site variables.",
 			operationId: "createSite",
 			requestBody: {
-				description: "Site properties to create. 'siteName' (the hostname) is required.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							type: "object",
 							properties: {
@@ -5456,8 +5410,7 @@ var paths = {
 							}
 						}
 					}
-				},
-				required: true
+				}
 			},
 			responses: {
 				"200": {
@@ -7686,7 +7639,7 @@ var paths = {
 			requestBody: {
 				description: "Template data to update. Must include the template identifier.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -7924,7 +7877,7 @@ var paths = {
 			requestBody: {
 				description: "Template data to create",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -13644,6 +13597,15 @@ var paths = {
 													hasOnlyBatchActionlet: {
 														type: "boolean"
 													},
+													hasSaveActionlet: {
+														type: "boolean"
+													},
+													hasDeleteActionlet: {
+														type: "boolean"
+													},
+													hasResetActionlet: {
+														type: "boolean"
+													},
 													hasPublishActionlet: {
 														type: "boolean"
 													},
@@ -13670,15 +13632,6 @@ var paths = {
 													},
 													hasMoveActionletActionlet: {
 														type: "boolean"
-													},
-													hasSaveActionlet: {
-														type: "boolean"
-													},
-													hasDeleteActionlet: {
-														type: "boolean"
-													},
-													hasResetActionlet: {
-														type: "boolean"
 													}
 												}
 											}
@@ -13918,6 +13871,15 @@ var paths = {
 															hasOnlyBatchActionlet: {
 																type: "boolean"
 															},
+															hasSaveActionlet: {
+																type: "boolean"
+															},
+															hasDeleteActionlet: {
+																type: "boolean"
+															},
+															hasResetActionlet: {
+																type: "boolean"
+															},
 															hasPublishActionlet: {
 																type: "boolean"
 															},
@@ -13944,15 +13906,6 @@ var paths = {
 															},
 															hasMoveActionletActionlet: {
 																type: "boolean"
-															},
-															hasSaveActionlet: {
-																type: "boolean"
-															},
-															hasDeleteActionlet: {
-																type: "boolean"
-															},
-															hasResetActionlet: {
-																type: "boolean"
 															}
 														}
 													},
@@ -13989,10 +13942,10 @@ var paths = {
 											type: {
 												type: "string"
 											},
-											individualPermission: {
+											bitPermission: {
 												type: "boolean"
 											},
-											bitPermission: {
+											individualPermission: {
 												type: "boolean"
 											},
 											roleId: {

package/spec.esm.js

@@ -987,7 +987,7 @@ var paths = {
 			requestBody: {
 				description: "Updated container configuration data including identifier and modified properties",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -1133,7 +1133,7 @@ var paths = {
 			requestBody: {
 				description: "Container configuration data including title, code, content type structures, and display settings",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -3147,41 +3147,61 @@ var paths = {
 			}
 		}
 	},
-	"/api/v1/folder/sitename/{siteName}/uri/{uri}": {
-		get: {
+	"/api/v1/folder/byPath": {
+		post: {
 			tags: [
 				"Folders"
 			],
-			summary: "Load a folder by site name and URI",
-			description: "Retrieves a folder by its URI path within the specified site.",
-			operationId: "loadFolderByURI",
+			summary: "Find subfolders by path",
+			description: "Retrieves subfolders of a given path, filtered by the path sent. The path format supports site-specific search (//siteName/path) or global search (/path). For example: '//default/folder1/' returns subfolder1, subfolder2 under folder1 in the 'default' site. '/folder1/s' returns all subfolders starting with 's' under folder1 across all sites.",
+			operationId: "findSubFoldersByPath",
 			parameters: [
 				{
-					name: "siteName",
-					"in": "path",
-					required: true,
+					name: "offset",
+					"in": "query",
+					description: "Number of results to skip for pagination. Must be >= 0.",
 					schema: {
-						type: "string"
+						type: "integer",
+						format: "int32",
+						"default": 0
 					}
 				},
 				{
-					name: "uri",
-					"in": "path",
-					required: true,
+					name: "limit",
+					"in": "query",
+					description: "Maximum number of results to return. Default 40. Use -1 for unlimited (capped at 10000 as a safety limit).",
 					schema: {
-						pattern: ".+",
-						type: "string"
+						type: "integer",
+						format: "int32",
+						"default": 40
 					}
 				}
 			],
+			requestBody: {
+				content: {
+					"*/*": {
+						schema: {
+							type: "object",
+							properties: {
+								path: {
+									type: "string"
+								}
+							}
+						}
+					}
+				}
+			},
 			responses: {
 				"200": {
-					description: "Folder retrieved successfully",
+					description: "Subfolders retrieved successfully",
 					content: {
 						"application/json": {
 						}
 					}
 				},
+				"400": {
+					description: "Path property must be sent"
+				},
 				"401": {
 					description: "Authentication required"
 				},
@@ -3189,117 +3209,54 @@ var paths = {
 					description: "Insufficient permissions"
 				},
 				"404": {
-					description: "Folder not found"
+					description: "Site not found"
 				}
 			}
 		}
 	},
-	"/api/v1/folder/search": {
+	"/api/v1/folder/sitename/{siteName}/uri/{uri}": {
 		get: {
 			tags: [
 				"Folders"
 			],
-			summary: "Search folders",
-			description: "Returns folders within a site matching an optional name filter and/or path scope. Supports recursive depth control, standard pagination, and sorting. With no 'name' and default path '/' + recursive=true, all site folders are returned.",
-			operationId: "searchFolders",
+			summary: "Load a folder by site name and URI",
+			description: "Retrieves a folder by its URI path within the specified site.",
+			operationId: "loadFolderByURI",
 			parameters: [
 				{
-					name: "name",
-					"in": "query",
-					description: "Optional case-insensitive partial match on folder name (minimum 3 characters when provided)",
+					name: "siteName",
+					"in": "path",
+					required: true,
 					schema: {
 						type: "string"
 					}
 				},
 				{
-					name: "path",
-					"in": "query",
-					description: "Path scope for the search. Defaults to '/' (site root).",
-					schema: {
-						type: "string",
-						"default": "/"
-					}
-				},
-				{
-					name: "recursive",
-					"in": "query",
-					description: "false = direct children of 'path' only (default); true = search all descendants",
-					schema: {
-						type: "boolean",
-						"default": false
-					}
-				},
-				{
-					name: "siteId",
-					"in": "query",
-					description: "Site ID to scope the search (required)",
+					name: "uri",
+					"in": "path",
+					required: true,
 					schema: {
+						pattern: ".+",
 						type: "string"
 					}
-				},
-				{
-					name: "orderby",
-					"in": "query",
-					description: "Column to sort by.",
-					schema: {
-						type: "string",
-						"enum": [
-							"name",
-							"mod_date"
-						],
-						"default": "name"
-					}
-				},
-				{
-					name: "direction",
-					"in": "query",
-					description: "Sort direction",
-					schema: {
-						type: "string",
-						"enum": [
-							"ASC",
-							"DESC"
-						],
-						"default": "ASC"
-					}
-				},
-				{
-					name: "page",
-					"in": "query",
-					description: "Page number (1-based, default 1)",
-					schema: {
-						type: "integer",
-						format: "int32",
-						"default": 1
-					}
-				},
-				{
-					name: "per_page",
-					"in": "query",
-					description: "Number of results per page (default 40)",
-					schema: {
-						type: "integer",
-						format: "int32",
-						"default": 40
-					}
 				}
 			],
 			responses: {
 				"200": {
-					description: "Paginated list of matching folders",
+					description: "Folder retrieved successfully",
 					content: {
 						"application/json": {
 						}
 					}
 				},
-				"400": {
-					description: "'siteId' is required; 'name' must be at least 3 characters if provided"
-				},
 				"401": {
-					description: "User is not authenticated"
+					description: "Authentication required"
 				},
-				"500": {
-					description: "Internal server error"
+				"403": {
+					description: "Insufficient permissions"
+				},
+				"404": {
+					description: "Folder not found"
 				}
 			}
 		}
@@ -5259,9 +5216,8 @@ var paths = {
 				}
 			],
 			requestBody: {
-				description: "Updated site properties. 'siteName' (the hostname) is required.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							type: "object",
 							properties: {
@@ -5340,8 +5296,7 @@ var paths = {
 							}
 						}
 					}
-				},
-				required: true
+				}
 			},
 			responses: {
 				"200": {
@@ -5373,9 +5328,8 @@ var paths = {
 			description: "Creates a new site with the provided properties including hostname, aliases, tag storage, SEO settings, and optional site variables.",
 			operationId: "createSite",
 			requestBody: {
-				description: "Site properties to create. 'siteName' (the hostname) is required.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							type: "object",
 							properties: {
@@ -5454,8 +5408,7 @@ var paths = {
 							}
 						}
 					}
-				},
-				required: true
+				}
 			},
 			responses: {
 				"200": {
@@ -7684,7 +7637,7 @@ var paths = {
 			requestBody: {
 				description: "Template data to update. Must include the template identifier.",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -7922,7 +7875,7 @@ var paths = {
 			requestBody: {
 				description: "Template data to create",
 				content: {
-					"application/json": {
+					"*/*": {
 						schema: {
 							required: [
 								"title"
@@ -13642,6 +13595,15 @@ var paths = {
 													hasOnlyBatchActionlet: {
 														type: "boolean"
 													},
+													hasSaveActionlet: {
+														type: "boolean"
+													},
+													hasDeleteActionlet: {
+														type: "boolean"
+													},
+													hasResetActionlet: {
+														type: "boolean"
+													},
 													hasPublishActionlet: {
 														type: "boolean"
 													},
@@ -13668,15 +13630,6 @@ var paths = {
 													},
 													hasMoveActionletActionlet: {
 														type: "boolean"
-													},
-													hasSaveActionlet: {
-														type: "boolean"
-													},
-													hasDeleteActionlet: {
-														type: "boolean"
-													},
-													hasResetActionlet: {
-														type: "boolean"
 													}
 												}
 											}
@@ -13916,6 +13869,15 @@ var paths = {
 															hasOnlyBatchActionlet: {
 																type: "boolean"
 															},
+															hasSaveActionlet: {
+																type: "boolean"
+															},
+															hasDeleteActionlet: {
+																type: "boolean"
+															},
+															hasResetActionlet: {
+																type: "boolean"
+															},
 															hasPublishActionlet: {
 																type: "boolean"
 															},
@@ -13942,15 +13904,6 @@ var paths = {
 															},
 															hasMoveActionletActionlet: {
 																type: "boolean"
-															},
-															hasSaveActionlet: {
-																type: "boolean"
-															},
-															hasDeleteActionlet: {
-																type: "boolean"
-															},
-															hasResetActionlet: {
-																type: "boolean"
 															}
 														}
 													},
@@ -13987,10 +13940,10 @@ var paths = {
 											type: {
 												type: "string"
 											},
-											individualPermission: {
+											bitPermission: {
 												type: "boolean"
 											},
-											bitPermission: {
+											individualPermission: {
 												type: "boolean"
 											},
 											roleId: {