@dotcms/ai 26.8.12-1 → 26.8.13-1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/ai",
-  "version": "26.08.12-01",
+  "version": "26.08.13-01",
   "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

@@ -238,7 +238,7 @@ var paths = {
 				"Categories"
 			],
 			summary: "Delete categories by inodes",
-			description: "Deletes one or more categories and all their children. Accepts a JSON array of category inodes.",
+			description: "Deletes one or more categories and all their descendants at every depth. EDIT permission is validated on each selected category and every descendant before anything is deleted; a category that fails validation is skipped whole. Accepts a JSON array of category inodes. Inodes that could not be deleted are reported in the `fails` list of the result with the failure reason (category does not exist, insufficient permissions, or a permission-protected descendant). `successCount` counts the requested inodes that were deleted, while `deletedCount` counts every category actually removed, descendants included.",
 			operationId: "deleteCategories",
 			requestBody: {
 				description: "JSON payload containing a list of the inodes of categories to delete.",
@@ -1747,11 +1747,11 @@ var paths = {
 					description: "Sort direction: choose between ascending or descending.",
 					schema: {
 						type: "string",
+						"default": "ASC",
 						"enum": [
 							"ASC",
 							"DESC"
-						],
-						"default": "ASC"
+						]
 					}
 				},
 				{
@@ -1875,7 +1875,9 @@ var paths = {
 													"ARCHIVE",
 													"UNARCHIVE",
 													"DELETE",
-													"DESTROY"
+													"DESTROY",
+													"LOCK",
+													"UNLOCK"
 												]
 											},
 											_2: {
@@ -2081,7 +2083,9 @@ var paths = {
 													"ARCHIVE",
 													"UNARCHIVE",
 													"DELETE",
-													"DESTROY"
+													"DESTROY",
+													"LOCK",
+													"UNLOCK"
 												]
 											},
 											_2: {
@@ -3254,11 +3258,11 @@ var paths = {
 					description: "Column to sort by.",
 					schema: {
 						type: "string",
+						"default": "name",
 						"enum": [
 							"name",
 							"mod_date"
-						],
-						"default": "name"
+						]
 					}
 				},
 				{
@@ -3267,11 +3271,11 @@ var paths = {
 					description: "Sort direction",
 					schema: {
 						type: "string",
+						"default": "ASC",
 						"enum": [
 							"ASC",
 							"DESC"
-						],
-						"default": "ASC"
+						]
 					}
 				},
 				{
@@ -11007,11 +11011,11 @@ var paths = {
 					description: "*Optional.* Case-insensitive parameter indicating how results are to be displayed.\n\nIn listing mode, all associated actions are returned; in editing mode (the default), it returns only the actions accessible to the contentlet's current workflow step.",
 					schema: {
 						type: "string",
+						"default": "EDITING",
 						"enum": [
 							"EDITING",
 							"LISTING"
-						],
-						"default": "EDITING"
+						]
 					}
 				}
 			],
@@ -11734,7 +11738,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -11860,7 +11866,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -11992,7 +12000,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -12098,7 +12108,7 @@ var paths = {
 				"Workflow"
 			],
 			summary: "Modify specific fields on multiple contentlets",
-			description: "Assigns values to the specified fields across multiple [contentlets](https://www.dotcms.com/docs/latest/content#Contentlets) simultaneously.\n\nCan use a [Lucene query](https://www.dotcms.com/docs/latest/content-search-syntax#Lucene) in its body to select all resulting content items.\n\nReturns a list of resultant contentlet maps, each with an additional  `AUTO_ASSIGN_WORKFLOW` property, which can be referenced by delegate services that handle automatically assigning workflow schemes to content with none.",
+			description: "Assigns values to the specified fields across multiple [contentlets](https://www.dotcms.com/docs/latest/content#Contentlets) simultaneously.\n\nCan use a [Lucene query](https://www.dotcms.com/docs/latest/content-search-syntax#Lucene) in its body to select all resulting content items.\n\nReturns a list of resultant contentlet maps, each with an additional  `AUTO_ASSIGN_WORKFLOW` property, which can be referenced by delegate services that handle automatically assigning workflow schemes to content with none.\n\n**`LOCK` and `UNLOCK` are not supported by this endpoint** and are rejected with a `400`. Locking is per-user state on the contentlet's version info rather than a content change, so there is nothing for a merge to apply — accepting the call would lock the contentlet and silently discard the submitted field values. Use `POST` or `PUT /v1/workflow/actions/default/fire/{systemAction}` for those two.",
 			operationId: "patchFireMergeSystemAction",
 			parameters: [
 				{
@@ -13685,6 +13695,15 @@ var paths = {
 													hasOnlyBatchActionlet: {
 														type: "boolean"
 													},
+													hasSaveActionlet: {
+														type: "boolean"
+													},
+													hasDeleteActionlet: {
+														type: "boolean"
+													},
+													hasResetActionlet: {
+														type: "boolean"
+													},
 													hasPublishActionlet: {
 														type: "boolean"
 													},
@@ -13711,15 +13730,6 @@ var paths = {
 													},
 													hasMoveActionletActionlet: {
 														type: "boolean"
-													},
-													hasSaveActionlet: {
-														type: "boolean"
-													},
-													hasDeleteActionlet: {
-														type: "boolean"
-													},
-													hasResetActionlet: {
-														type: "boolean"
 													}
 												}
 											}
@@ -13835,7 +13845,9 @@ var paths = {
 															"ARCHIVE",
 															"UNARCHIVE",
 															"DELETE",
-															"DESTROY"
+															"DESTROY",
+															"LOCK",
+															"UNLOCK"
 														]
 													},
 													workflowAction: {
@@ -13959,6 +13971,15 @@ var paths = {
 															hasOnlyBatchActionlet: {
 																type: "boolean"
 															},
+															hasSaveActionlet: {
+																type: "boolean"
+															},
+															hasDeleteActionlet: {
+																type: "boolean"
+															},
+															hasResetActionlet: {
+																type: "boolean"
+															},
 															hasPublishActionlet: {
 																type: "boolean"
 															},
@@ -13985,15 +14006,6 @@ var paths = {
 															},
 															hasMoveActionletActionlet: {
 																type: "boolean"
-															},
-															hasSaveActionlet: {
-																type: "boolean"
-															},
-															hasDeleteActionlet: {
-																type: "boolean"
-															},
-															hasResetActionlet: {
-																type: "boolean"
 															}
 														}
 													},
@@ -14446,7 +14458,9 @@ var paths = {
 										"ARCHIVE",
 										"UNARCHIVE",
 										"DELETE",
-										"DESTROY"
+										"DESTROY",
+										"LOCK",
+										"UNLOCK"
 									]
 								}
 							}
@@ -14518,11 +14532,11 @@ var paths = {
 					description: "Asset version to retrieve. Accepted values: working (default), live.",
 					schema: {
 						type: "string",
+						"default": "working",
 						"enum": [
 							"working",
 							"live"
-						],
-						"default": "working"
+						]
 					},
 					example: "working"
 				}
@@ -14600,11 +14614,11 @@ var paths = {
 					description: "Asset version to retrieve. Accepted values: working (default), live.",
 					schema: {
 						type: "string",
+						"default": "working",
 						"enum": [
 							"working",
 							"live"
-						],
-						"default": "working"
+						]
 					},
 					example: "working"
 				}
@@ -15707,11 +15721,11 @@ var paths = {
 					description: "Export format",
 					schema: {
 						type: "string",
+						"default": "csv",
 						"enum": [
 							"csv",
 							"json"
-						],
-						"default": "csv"
+						]
 					},
 					example: "csv"
 				},

package/spec.esm.js

@@ -236,7 +236,7 @@ var paths = {
 				"Categories"
 			],
 			summary: "Delete categories by inodes",
-			description: "Deletes one or more categories and all their children. Accepts a JSON array of category inodes.",
+			description: "Deletes one or more categories and all their descendants at every depth. EDIT permission is validated on each selected category and every descendant before anything is deleted; a category that fails validation is skipped whole. Accepts a JSON array of category inodes. Inodes that could not be deleted are reported in the `fails` list of the result with the failure reason (category does not exist, insufficient permissions, or a permission-protected descendant). `successCount` counts the requested inodes that were deleted, while `deletedCount` counts every category actually removed, descendants included.",
 			operationId: "deleteCategories",
 			requestBody: {
 				description: "JSON payload containing a list of the inodes of categories to delete.",
@@ -1745,11 +1745,11 @@ var paths = {
 					description: "Sort direction: choose between ascending or descending.",
 					schema: {
 						type: "string",
+						"default": "ASC",
 						"enum": [
 							"ASC",
 							"DESC"
-						],
-						"default": "ASC"
+						]
 					}
 				},
 				{
@@ -1873,7 +1873,9 @@ var paths = {
 													"ARCHIVE",
 													"UNARCHIVE",
 													"DELETE",
-													"DESTROY"
+													"DESTROY",
+													"LOCK",
+													"UNLOCK"
 												]
 											},
 											_2: {
@@ -2079,7 +2081,9 @@ var paths = {
 													"ARCHIVE",
 													"UNARCHIVE",
 													"DELETE",
-													"DESTROY"
+													"DESTROY",
+													"LOCK",
+													"UNLOCK"
 												]
 											},
 											_2: {
@@ -3252,11 +3256,11 @@ var paths = {
 					description: "Column to sort by.",
 					schema: {
 						type: "string",
+						"default": "name",
 						"enum": [
 							"name",
 							"mod_date"
-						],
-						"default": "name"
+						]
 					}
 				},
 				{
@@ -3265,11 +3269,11 @@ var paths = {
 					description: "Sort direction",
 					schema: {
 						type: "string",
+						"default": "ASC",
 						"enum": [
 							"ASC",
 							"DESC"
-						],
-						"default": "ASC"
+						]
 					}
 				},
 				{
@@ -11005,11 +11009,11 @@ var paths = {
 					description: "*Optional.* Case-insensitive parameter indicating how results are to be displayed.\n\nIn listing mode, all associated actions are returned; in editing mode (the default), it returns only the actions accessible to the contentlet's current workflow step.",
 					schema: {
 						type: "string",
+						"default": "EDITING",
 						"enum": [
 							"EDITING",
 							"LISTING"
-						],
-						"default": "EDITING"
+						]
 					}
 				}
 			],
@@ -11732,7 +11736,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -11858,7 +11864,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -11990,7 +11998,9 @@ var paths = {
 							"ARCHIVE",
 							"UNARCHIVE",
 							"DELETE",
-							"DESTROY"
+							"DESTROY",
+							"LOCK",
+							"UNLOCK"
 						]
 					}
 				}
@@ -12096,7 +12106,7 @@ var paths = {
 				"Workflow"
 			],
 			summary: "Modify specific fields on multiple contentlets",
-			description: "Assigns values to the specified fields across multiple [contentlets](https://www.dotcms.com/docs/latest/content#Contentlets) simultaneously.\n\nCan use a [Lucene query](https://www.dotcms.com/docs/latest/content-search-syntax#Lucene) in its body to select all resulting content items.\n\nReturns a list of resultant contentlet maps, each with an additional  `AUTO_ASSIGN_WORKFLOW` property, which can be referenced by delegate services that handle automatically assigning workflow schemes to content with none.",
+			description: "Assigns values to the specified fields across multiple [contentlets](https://www.dotcms.com/docs/latest/content#Contentlets) simultaneously.\n\nCan use a [Lucene query](https://www.dotcms.com/docs/latest/content-search-syntax#Lucene) in its body to select all resulting content items.\n\nReturns a list of resultant contentlet maps, each with an additional  `AUTO_ASSIGN_WORKFLOW` property, which can be referenced by delegate services that handle automatically assigning workflow schemes to content with none.\n\n**`LOCK` and `UNLOCK` are not supported by this endpoint** and are rejected with a `400`. Locking is per-user state on the contentlet's version info rather than a content change, so there is nothing for a merge to apply — accepting the call would lock the contentlet and silently discard the submitted field values. Use `POST` or `PUT /v1/workflow/actions/default/fire/{systemAction}` for those two.",
 			operationId: "patchFireMergeSystemAction",
 			parameters: [
 				{
@@ -13683,6 +13693,15 @@ var paths = {
 													hasOnlyBatchActionlet: {
 														type: "boolean"
 													},
+													hasSaveActionlet: {
+														type: "boolean"
+													},
+													hasDeleteActionlet: {
+														type: "boolean"
+													},
+													hasResetActionlet: {
+														type: "boolean"
+													},
 													hasPublishActionlet: {
 														type: "boolean"
 													},
@@ -13709,15 +13728,6 @@ var paths = {
 													},
 													hasMoveActionletActionlet: {
 														type: "boolean"
-													},
-													hasSaveActionlet: {
-														type: "boolean"
-													},
-													hasDeleteActionlet: {
-														type: "boolean"
-													},
-													hasResetActionlet: {
-														type: "boolean"
 													}
 												}
 											}
@@ -13833,7 +13843,9 @@ var paths = {
 															"ARCHIVE",
 															"UNARCHIVE",
 															"DELETE",
-															"DESTROY"
+															"DESTROY",
+															"LOCK",
+															"UNLOCK"
 														]
 													},
 													workflowAction: {
@@ -13957,6 +13969,15 @@ var paths = {
 															hasOnlyBatchActionlet: {
 																type: "boolean"
 															},
+															hasSaveActionlet: {
+																type: "boolean"
+															},
+															hasDeleteActionlet: {
+																type: "boolean"
+															},
+															hasResetActionlet: {
+																type: "boolean"
+															},
 															hasPublishActionlet: {
 																type: "boolean"
 															},
@@ -13983,15 +14004,6 @@ var paths = {
 															},
 															hasMoveActionletActionlet: {
 																type: "boolean"
-															},
-															hasSaveActionlet: {
-																type: "boolean"
-															},
-															hasDeleteActionlet: {
-																type: "boolean"
-															},
-															hasResetActionlet: {
-																type: "boolean"
 															}
 														}
 													},
@@ -14444,7 +14456,9 @@ var paths = {
 										"ARCHIVE",
 										"UNARCHIVE",
 										"DELETE",
-										"DESTROY"
+										"DESTROY",
+										"LOCK",
+										"UNLOCK"
 									]
 								}
 							}
@@ -14516,11 +14530,11 @@ var paths = {
 					description: "Asset version to retrieve. Accepted values: working (default), live.",
 					schema: {
 						type: "string",
+						"default": "working",
 						"enum": [
 							"working",
 							"live"
-						],
-						"default": "working"
+						]
 					},
 					example: "working"
 				}
@@ -14598,11 +14612,11 @@ var paths = {
 					description: "Asset version to retrieve. Accepted values: working (default), live.",
 					schema: {
 						type: "string",
+						"default": "working",
 						"enum": [
 							"working",
 							"live"
-						],
-						"default": "working"
+						]
 					},
 					example: "working"
 				}
@@ -15705,11 +15719,11 @@ var paths = {
 					description: "Export format",
 					schema: {
 						type: "string",
+						"default": "csv",
 						"enum": [
 							"csv",
 							"json"
-						],
-						"default": "csv"
+						]
 					},
 					example: "csv"
 				},