@umbraco-cms/mcp-dev 17.6.2 → 17.6.3

package/dist/{chunk-KDAEC7HU.cjs → chunk-4MRMRMFC.cjs}

@@ -15248,6 +15248,185 @@ var CreateDocumentTool = {
 };
 var create_document_default = _mcpserversdk.withStandardDecorators.call(void 0, CreateDocumentTool);
 
+// src/umbraco-api/tools/document/post/create-and-publish-document.ts
+
+
+
+
+
+
+
+
+var createAndPublishOutputSchema = _zod.z.object({
+  message: _zod.z.string(),
+  id: _zod.z.string().guid()
+});
+var createAndPublishDocumentSchema = _zod.z.object({
+  documentTypeId: _zod.z.string().uuid("Must be a valid document type type UUID"),
+  parentId: _zod.z.string().uuid("Must be a valid document UUID").optional(),
+  name: _zod.z.string(),
+  templateId: _zod.z.string().uuid("Must be a valid template UUID").optional().describe(
+    "Optional template ID to apply to the document. If omitted, the document type's default template is applied automatically. Provide a value only when you need a specific allowed template other than the default."
+  ),
+  cultures: _zod.z.array(_zod.z.string()).optional().describe("Array of culture codes. If not provided or empty array, will create single variant with null culture."),
+  culturesToPublish: _zod.z.array(_zod.z.string()).optional().describe(
+    'Culture codes to publish immediately after creation. Must contain real culture codes only - wildcards ("*") and nulls are rejected by Umbraco. If omitted, defaults to publishing every culture in the cultures array, or an empty array (which publishes the single invariant variant) when the document type does not vary by culture.'
+  ),
+  values: _zod.z.array(
+    _zod.z.object({
+      editorAlias: _zod.z.string(),
+      culture: _zod.z.string().nullable(),
+      segment: _zod.z.string().nullable(),
+      alias: _zod.z.string(),
+      value: _zod.z.any()
+    })
+  ).default([])
+});
+var CreateAndPublishDocumentTool = {
+  name: "create-and-publish-document",
+  description: `Creates a document and publishes it in a single operation, with support for multiple cultures.
+
+  Always follow these requirements when creating documents exactly, do not deviate in any way.
+
+  ## COPY-FIRST APPROACH (RECOMMENDED)
+
+  **FIRST: Try to copy an existing document**
+  1. Only use this if copy-document and search-document tools are available
+  2. Use search-document to find documents with the same document type
+  3. If similar documents exist AND copy-document tool is available:
+     - Use copy-document to duplicate the existing structure
+     - Use search-document to find the new document (copy returns empty string, not the new ID)
+     - Update and publish with update-and-publish-document as needed
+
+  **SECOND: Only create from scratch when:**
+  - No similar documents exist in Umbraco
+  - Copy-document tool doesn't exist
+  - You need to create from scratch with unique structure
+
+  Benefits: Preserves structure, inherits properties, maintains consistency with existing content.
+
+  ## Introduction
+
+  This tool creates and publishes documents with multi-culture support:
+  - If cultures parameter is provided, a variant will be created for each culture code
+  - If cultures parameter is not provided or is an empty array, will create a single variant with null culture (original behavior)
+  - IMPORTANT: If workflow approval is required, use create-document followed by initiate-workflow-action instead.
+    This tool bypasses approval workflows and publishes directly to the live site.
+
+  ## Critical Requirements
+
+  ### Document Type Analysis (When Creating from Scratch)
+  1. Use get-document-type-by-id to understand the document type structure and required properties
+  2. Ensure all required properties are included in the values array
+
+  ### Document Types and Data Types
+  1. BEFORE creating any new document type, ALWAYS search for existing ones using get-all-document-types
+  2. BEFORE creating any new data type, ALWAYS search for existing ones using get-all-data-types
+  3. ONLY create a new document type or data type if NO suitable existing ones are found
+  4. If similar types exist, inform the user and suggest using the existing types instead
+  5. Creation of new types should be a last resort when nothing suitable exists
+
+  ### Parent ID Handling
+  For document types with allowedAsRoot=true, DO NOT include the parentId parameter at all in the function call.
+  When adding a parent, first find the parent using get-document-root or get-document-children and then use the id of the parent in the parentId parameter. Alway makes sure that the id is valid.
+
+  ### Values Matching
+  - Values must match the aliases of the document type structure
+  - Block lists, Block Grids and Rich Text Blocks items and settings must match the defined blocks document type structures
+
+  ### Unique Keys
+  All generated keys must be unique and randomly generated.
+
+  ### Cultures To Publish
+  - culturesToPublish controls which of the created variants get published immediately.
+  - Umbraco only accepts real culture codes here - wildcards ("*") and nulls are rejected with an error.
+  - When the document type does not vary by culture (invariant content), pass an empty array \`[]\` to publish the single invariant variant (this is the default when omitted).
+  - When the document type varies by culture, culturesToPublish defaults to every culture supplied in the cultures array. Pass a subset to only publish some of the created variants.
+
+  ## Property Editor Values Reference
+
+  When creating documents, you need to provide property values that match the property editors defined in the document type.
+
+  IMPORTANT: Use the get-document-type-schema tool to:
+  - Get the JSON Schema describing the expected property structure for a specific document type
+  - The schema includes all property definitions and their value formats
+  - Use the schema to construct the correct values array for your document
+
+  The values parameter is an array of property value objects following this structure:
+  {
+    "editorAlias": "Umbraco.TextBox",  // The property editor type
+    "culture": null,                    // Document-specific - culture code or null
+    "segment": null,                    // Document-specific - segment or null
+    "alias": "propertyAlias",          // Property alias from document type
+    "value": "your value here"         // Value matching the schema structure
+  }
+
+  ## Default Template
+
+  The document type's default template is applied automatically. Pass an explicit \`templateId\` only when you need a specific allowed template other than the default. If the document type has no default template, the document is created without one.
+  `,
+  inputSchema: createAndPublishDocumentSchema.shape,
+  outputSchema: createAndPublishOutputSchema.shape,
+  slices: ["create"],
+  enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Create) && user.fallbackPermissions.includes(UmbracoDocumentPermissions.Publish),
+  handler: (async (model) => {
+    const client = UmbracoManagementClient3.getClient();
+    const documentId = _uuid.v4.call(void 0, );
+    let culturesToUse = [];
+    if (model.cultures === void 0 || model.cultures.length === 0) {
+      culturesToUse = [null];
+    } else {
+      culturesToUse = model.cultures;
+    }
+    const variants = culturesToUse.map((culture) => ({
+      culture,
+      name: model.name,
+      segment: null
+    }));
+    let culturesToPublish;
+    if (model.culturesToPublish && model.culturesToPublish.length > 0) {
+      culturesToPublish = model.culturesToPublish;
+    } else if (model.cultures === void 0 || model.cultures.length === 0) {
+      culturesToPublish = [];
+    } else {
+      culturesToPublish = model.cultures;
+    }
+    let template;
+    if (model.templateId) {
+      template = { id: model.templateId };
+    } else {
+      const docType = await client.getDocumentTypeById(model.documentTypeId);
+      template = _optionalChain([docType, 'access', _24 => _24.defaultTemplate, 'optionalAccess', _25 => _25.id]) ? { id: docType.defaultTemplate.id } : null;
+    }
+    const payload = {
+      id: documentId,
+      documentType: {
+        id: model.documentTypeId
+      },
+      parent: model.parentId ? {
+        id: model.parentId
+      } : void 0,
+      template,
+      culturesToPublish,
+      values: model.values,
+      variants
+    };
+    const response = await client.postDocumentCreateAndPublish(payload, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE);
+    if (response.status === 201 || response.status === 200) {
+      return _mcpserversdk.createToolResult.call(void 0, {
+        message: "Document created and published successfully",
+        id: documentId
+      });
+    } else {
+      return _mcpserversdk.createToolResultError.call(void 0, response.data || {
+        status: response.status,
+        detail: response.statusText
+      });
+    }
+  })
+};
+var create_and_publish_document_default = _mcpserversdk.withStandardDecorators.call(void 0, CreateAndPublishDocumentTool);
+
 // src/umbraco-api/tools/document/put/put-document-public-access.ts
 
 
@@ -15465,7 +15644,7 @@ var SortDocumentTool = {
 };
 var sort_document_default = _mcpserversdk.withStandardDecorators.call(void 0, SortDocumentTool);
 
-// src/umbraco-api/tools/document/put/move-document.ts
+// src/umbraco-api/tools/document/put/sort-document-children.ts
 
 
 
@@ -15473,13 +15652,68 @@ var sort_document_default = _mcpserversdk.withStandardDecorators.call(void 0, So
 
 
 var inputSchema13 = {
+  id: putDocumentByIdSortChildrenParams.shape.id,
+  data: _zod.z.object(putDocumentByIdSortChildrenBody.shape)
+};
+var SortDocumentChildrenTool = {
+  name: "sort-document-children",
+  description: `Sorts the children of the document identified by Id by a system field (Name, CreateDate or UpdateDate) in the given direction (Ascending or Descending).
+
+  This is DIFFERENT from sort-document: sort-document reorders children according to an explicit list of ids and sort orders you provide, whereas sort-document-children sorts every child of {id} automatically by the chosen field and direction - no explicit ordering is required.
+
+  When sorting by Name, an optional culture selects which variant name to sort by; the culture is not validated, so children that do not vary by it (or an unrecognised culture) fall back to the invariant name.`,
+  inputSchema: inputSchema13,
+  annotations: {},
+  slices: ["sort"],
+  enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Sort),
+  handler: (async (model) => {
+    return _mcpserversdk.executeVoidApiCall.call(void 0, 
+      (client) => client.putDocumentByIdSortChildren(model.id, model.data, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var sort_document_children_default = _mcpserversdk.withStandardDecorators.call(void 0, SortDocumentChildrenTool);
+
+// src/umbraco-api/tools/document/put/sort-document-root-children.ts
+
+
+
+
+
+var SortDocumentRootChildrenTool = {
+  name: "sort-document-root-children",
+  description: `Sorts the root-level documents by a system field (Name, CreateDate or UpdateDate) in the given direction (Ascending or Descending).
+
+  This is the root-level equivalent of sort-document-children: it sorts every document at the root of the content tree automatically by the chosen field and direction - no explicit ordering is required. This is DIFFERENT from sort-document, which reorders documents according to an explicit list of ids and sort orders you provide.
+
+  When sorting by Name, an optional culture selects which variant name to sort by; the culture is not validated, so documents that do not vary by it (or an unrecognised culture) fall back to the invariant name.`,
+  inputSchema: putDocumentRootSortChildrenBody.shape,
+  annotations: {},
+  slices: ["sort"],
+  enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Sort),
+  handler: (async (model) => {
+    return _mcpserversdk.executeVoidApiCall.call(void 0, 
+      (client) => client.putDocumentRootSortChildren(model, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var sort_document_root_children_default = _mcpserversdk.withStandardDecorators.call(void 0, SortDocumentRootChildrenTool);
+
+// src/umbraco-api/tools/document/put/move-document.ts
+
+
+
+
+
+
+var inputSchema14 = {
   id: _zod.z.string().uuid(),
   data: _zod.z.object(putDocumentByIdMoveBody.shape)
 };
 var MoveDocumentTool = {
   name: "move-document",
   description: "Move a document to a new location",
-  inputSchema: inputSchema13,
+  inputSchema: inputSchema14,
   annotations: {},
   slices: ["move"],
   enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Move),
@@ -15498,7 +15732,7 @@ var move_document_default = _mcpserversdk.withStandardDecorators.call(void 0, Mo
 
 
 
-var inputSchema14 = {
+var inputSchema15 = {
   id: _zod.z.string().uuid(),
   data: _zod.z.object(putDocumentByIdPublishBody.shape)
 };
@@ -15508,7 +15742,7 @@ var PublishDocumentTool = {
   This function bypasses approval workflows and publishes directly to the live site.
   When the culture is not provided, the default culture is null.
   When the schedule is not provided, the default schedule is null.`,
-  inputSchema: inputSchema14,
+  inputSchema: inputSchema15,
   annotations: {},
   slices: ["publish"],
   enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Publish),
@@ -15596,7 +15830,7 @@ var move_to_recycle_bin_default = _mcpserversdk.withStandardDecorators.call(void
 
 
 
-var inputSchema15 = {
+var inputSchema16 = {
   id: putDocumentByIdParams.shape.id,
   data: _zod.z.object(putDocumentByIdBody.shape),
   confirmClearValues: _zod.z.boolean().optional().describe(
@@ -15623,21 +15857,21 @@ var UpdateDocumentTool = {
     Always include the full, unmodified "values" array from the document you just read unless you
     intend to clear every property. If the document currently has values, an empty "values" array is
     rejected unless "confirmClearValues" is set to true.`,
-  inputSchema: inputSchema15,
+  inputSchema: inputSchema16,
   annotations: {
     idempotentHint: true
   },
   slices: ["update"],
   enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Update),
   handler: (async (model) => {
-    const incomingValues = _optionalChain([model, 'access', _24 => _24.data, 'optionalAccess', _25 => _25.values]);
+    const incomingValues = _optionalChain([model, 'access', _26 => _26.data, 'optionalAccess', _27 => _27.values]);
     if (Array.isArray(incomingValues) && incomingValues.length === 0 && !model.confirmClearValues) {
       const client = UmbracoManagementClient3.getClient();
       let currentDocument;
       try {
         currentDocument = await client.getDocumentById(model.id);
       } catch (error) {
-        const status = _optionalChain([error, 'optionalAccess', _26 => _26.response, 'optionalAccess', _27 => _27.status]);
+        const status = _optionalChain([error, 'optionalAccess', _28 => _28.response, 'optionalAccess', _29 => _29.status]);
         if (status !== 404) {
           throw error;
         }
@@ -15656,6 +15890,48 @@ var UpdateDocumentTool = {
 };
 var update_document_default = _mcpserversdk.withStandardDecorators.call(void 0, UpdateDocumentTool);
 
+// src/umbraco-api/tools/document/put/update-and-publish-document.ts
+
+
+
+
+
+
+var inputSchema17 = {
+  id: putDocumentByIdUpdateAndPublishParams.shape.id,
+  data: _zod.z.object(putDocumentByIdUpdateAndPublishBody.shape)
+};
+var UpdateAndPublishDocumentTool = {
+  name: "update-and-publish-document",
+  description: `Updates a document by Id and publishes it in a single operation.
+
+  IMPORTANT: If workflow approval is required, use update-document followed by initiate-workflow-action instead.
+  This function bypasses approval workflows and publishes directly to the live site.
+
+  ### Cultures To Publish
+  - culturesToPublish controls which of the document's variants get published.
+  - Umbraco only accepts real culture codes here - wildcards ("*") and nulls are rejected with an error.
+  - When the document does not vary by culture (invariant content), pass an empty array \`[]\` to publish the single invariant variant.
+  - When the document varies by culture, provide the culture codes of the variants you want published.
+
+  If you must use this tool:
+  - Always read the current document value first
+  - Only update the required values
+  - Don't miss any properties from the original document`,
+  inputSchema: inputSchema17,
+  annotations: {
+    idempotentHint: true
+  },
+  slices: ["update"],
+  enabled: (user) => user.fallbackPermissions.includes(UmbracoDocumentPermissions.Publish),
+  handler: (async (model) => {
+    return _mcpserversdk.executeVoidApiCall.call(void 0, 
+      (client) => client.putDocumentByIdUpdateAndPublish(model.id, model.data, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var update_and_publish_document_default = _mcpserversdk.withStandardDecorators.call(void 0, UpdateAndPublishDocumentTool);
+
 // src/umbraco-api/tools/document/put/update-document-properties.ts
 
 
@@ -16025,7 +16301,7 @@ var UpdateDocumentPropertiesTool = {
         const docTypeProps = await getDocumentTypeProperties();
         const propsToValidate = allPropertiesToValidate.map((p) => {
           const def = docTypeProps.find((d) => d.alias === p.alias);
-          return { alias: p.alias, value: p.value, dataTypeId: _nullishCoalesce(_optionalChain([def, 'optionalAccess', _28 => _28.dataTypeId]), () => ( "")) };
+          return { alias: p.alias, value: p.value, dataTypeId: _nullishCoalesce(_optionalChain([def, 'optionalAccess', _30 => _30.dataTypeId]), () => ( "")) };
         }).filter((p) => p.dataTypeId);
         if (propsToValidate.length > 0) {
           const valueValidation = await validatePropertiesBeforeSave(propsToValidate);
@@ -16425,7 +16701,7 @@ var UpdateBlockPropertyTool = {
       if (!isUmbracoAtLeast(17, 4) && elementTypeProperties.length > 0) {
         const propsToValidate = update.properties.map((p) => {
           const def = elementTypeProperties.find((d) => d.alias === p.alias);
-          return { alias: p.alias, value: p.value, dataTypeId: _nullishCoalesce(_optionalChain([def, 'optionalAccess', _29 => _29.dataTypeId]), () => ( "")) };
+          return { alias: p.alias, value: p.value, dataTypeId: _nullishCoalesce(_optionalChain([def, 'optionalAccess', _31 => _31.dataTypeId]), () => ( "")) };
         }).filter((p) => p.dataTypeId);
         if (propsToValidate.length > 0) {
           const valueValidation = await validatePropertiesBeforeSave(propsToValidate);
@@ -16739,6 +17015,9 @@ var DocumentCollection = {
       tools.push(get_document_type_schema_default);
       tools.push(copy_document_default);
       tools.push(create_document_default);
+      if (isUmbracoAtLeast(17, 6)) {
+        tools.push(create_and_publish_document_default);
+      }
       tools.push(post_document_public_access_default);
       tools.push(delete_document_default);
       tools.push(delete_document_public_access_default);
@@ -16753,8 +17032,15 @@ var DocumentCollection = {
       tools.push(publish_document_default);
       tools.push(publish_document_with_descendants_default);
       tools.push(sort_document_default);
+      if (isUmbracoAtLeast(17, 6)) {
+        tools.push(sort_document_children_default);
+        tools.push(sort_document_root_children_default);
+      }
       tools.push(unpublish_document_default);
       tools.push(update_document_default);
+      if (isUmbracoAtLeast(17, 6)) {
+        tools.push(update_and_publish_document_default);
+      }
       tools.push(update_document_properties_default);
       tools.push(update_document_name_default);
       tools.push(update_block_property_default);
@@ -17086,7 +17372,7 @@ var CopyDocumentTypeTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const location = _optionalChain([response, 'access', _30 => _30.headers, 'optionalAccess', _31 => _31.location]) || "";
+      const location = _optionalChain([response, 'access', _32 => _32.headers, 'optionalAccess', _33 => _33.location]) || "";
       const newId = location.split("/").pop() || "";
       const output = { id: newId };
       return _mcpserversdk.createToolResult.call(void 0, output);
@@ -18817,14 +19103,14 @@ var create_language_default = _mcpserversdk.withStandardDecorators.call(void 0,
 
 
 
-var inputSchema16 = {
+var inputSchema18 = {
   isoCode: putLanguageByIsoCodeParams.shape.isoCode,
   data: _zod.z.object(putLanguageByIsoCodeBody.shape)
 };
 var UpdateLanguageTool = {
   name: "update-language",
   description: "Updates an existing language by ISO code",
-  inputSchema: inputSchema16,
+  inputSchema: inputSchema18,
   annotations: {
     idempotentHint: true
   },
@@ -19292,7 +19578,7 @@ function getExtensionFromMimeType(mimeType) {
   return extension ? `.${extension}` : void 0;
 }
 function validateMediaTypeForSvg(filePath, fileUrl, fileName, mediaTypeName) {
-  const isSvg = _optionalChain([filePath, 'optionalAccess', _32 => _32.toLowerCase, 'call', _33 => _33(), 'access', _34 => _34.endsWith, 'call', _35 => _35(".svg")]) || _optionalChain([fileUrl, 'optionalAccess', _36 => _36.toLowerCase, 'call', _37 => _37(), 'access', _38 => _38.endsWith, 'call', _39 => _39(".svg")]) || fileName.toLowerCase().endsWith(".svg");
+  const isSvg = _optionalChain([filePath, 'optionalAccess', _34 => _34.toLowerCase, 'call', _35 => _35(), 'access', _36 => _36.endsWith, 'call', _37 => _37(".svg")]) || _optionalChain([fileUrl, 'optionalAccess', _38 => _38.toLowerCase, 'call', _39 => _39(), 'access', _40 => _40.endsWith, 'call', _41 => _41(".svg")]) || fileName.toLowerCase().endsWith(".svg");
   if (isSvg && mediaTypeName === _mcpserversdk.MEDIA_TYPE_IMAGE) {
     console.warn(`SVG detected - using ${_mcpserversdk.MEDIA_TYPE_VECTOR_GRAPHICS} media type instead of ${_mcpserversdk.MEDIA_TYPE_IMAGE}`);
     return _mcpserversdk.MEDIA_TYPE_VECTOR_GRAPHICS;
@@ -19446,8 +19732,8 @@ async function uploadMediaFile(client, params) {
     });
   } catch (error) {
     const err = error;
-    const errorData = _optionalChain([err, 'access', _40 => _40.response, 'optionalAccess', _41 => _41.data]) ? typeof err.response.data === "string" ? err.response.data : JSON.stringify(err.response.data) : err.message;
-    throw new Error(`Failed to upload temporary file: ${_optionalChain([err, 'access', _42 => _42.response, 'optionalAccess', _43 => _43.status]) || "Unknown error"} - ${errorData}`);
+    const errorData = _optionalChain([err, 'access', _42 => _42.response, 'optionalAccess', _43 => _43.data]) ? typeof err.response.data === "string" ? err.response.data : JSON.stringify(err.response.data) : err.message;
+    throw new Error(`Failed to upload temporary file: ${_optionalChain([err, 'access', _44 => _44.response, 'optionalAccess', _45 => _45.status]) || "Unknown error"} - ${errorData}`);
   }
   const valueStructure = buildValueStructure(validatedMediaTypeName, params.temporaryFileId);
   let response;
@@ -19467,12 +19753,12 @@ async function uploadMediaFile(client, params) {
     }, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE);
   } catch (error) {
     const err = error;
-    throw new Error(`Failed to create media item: ${_optionalChain([err, 'access', _44 => _44.response, 'optionalAccess', _45 => _45.status]) || "Unknown error"} - ${JSON.stringify(_optionalChain([err, 'access', _46 => _46.response, 'optionalAccess', _47 => _47.data])) || err.message}`);
+    throw new Error(`Failed to create media item: ${_optionalChain([err, 'access', _46 => _46.response, 'optionalAccess', _47 => _47.status]) || "Unknown error"} - ${JSON.stringify(_optionalChain([err, 'access', _48 => _48.response, 'optionalAccess', _49 => _49.data])) || err.message}`);
   }
   if (response.status < 200 || response.status >= 300) {
     throw new Error(`Request failed with status code ${response.status}`);
   }
-  const locationHeader = _optionalChain([response, 'access', _48 => _48.headers, 'optionalAccess', _49 => _49.location]) || _optionalChain([response, 'access', _50 => _50.headers, 'optionalAccess', _51 => _51.Location]);
+  const locationHeader = _optionalChain([response, 'access', _50 => _50.headers, 'optionalAccess', _51 => _51.location]) || _optionalChain([response, 'access', _52 => _52.headers, 'optionalAccess', _53 => _53.Location]);
   if (!locationHeader) {
     throw new Error("No Location header in response - cannot determine created media ID");
   }
@@ -19515,10 +19801,10 @@ async function resolveAuth() {
     );
   }
   const entry = await _mcphosted.getStoredUmbracoToken.call(void 0, authContext.env.OAUTH_KV, authContext.tokenKey);
-  if (!_optionalChain([entry, 'optionalAccess', _52 => _52.tokens, 'optionalAccess', _53 => _53.access_token])) {
+  if (!_optionalChain([entry, 'optionalAccess', _54 => _54.tokens, 'optionalAccess', _55 => _55.access_token])) {
     throw new Error("No Umbraco access token in KV. Reconnect the MCP connector.");
   }
-  const baseUrl = _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(_optionalChain([entry, 'access', _54 => _54.site, 'optionalAccess', _55 => _55.serverUrl]), () => ( _optionalChain([entry, 'access', _56 => _56.site, 'optionalAccess', _57 => _57.baseUrl]))), () => ( authContext.env.UMBRACO_SERVER_URL)), () => ( authContext.env.UMBRACO_BASE_URL));
+  const baseUrl = _nullishCoalesce(_nullishCoalesce(_nullishCoalesce(_optionalChain([entry, 'access', _56 => _56.site, 'optionalAccess', _57 => _57.serverUrl]), () => ( _optionalChain([entry, 'access', _58 => _58.site, 'optionalAccess', _59 => _59.baseUrl]))), () => ( authContext.env.UMBRACO_SERVER_URL)), () => ( authContext.env.UMBRACO_BASE_URL));
   if (!baseUrl) {
     throw new Error("No Umbraco base URL resolvable from site or env.");
   }
@@ -19526,7 +19812,7 @@ async function resolveAuth() {
 }
 function ensureExtension(name, contentType, urlPath) {
   if (name.includes(".")) return name;
-  const fromUrl = _optionalChain([urlPath, 'access', _58 => _58.match, 'call', _59 => _59(/\.([a-z0-9]{1,8})$/i), 'optionalAccess', _60 => _60[0]]);
+  const fromUrl = _optionalChain([urlPath, 'access', _60 => _60.match, 'call', _61 => _61(/\.([a-z0-9]{1,8})$/i), 'optionalAccess', _62 => _62[0]]);
   if (fromUrl) return `${name}${fromUrl}`;
   if (contentType) {
     const subtype = contentType.split(";")[0].split("/")[1];
@@ -19635,8 +19921,8 @@ Content-Type: ${sourceContentType}\r
     if (response.status < 200 || response.status >= 300) {
       throw new Error(`postMedia failed with status ${response.status}`);
     }
-    const locationHeader = _nullishCoalesce(_optionalChain([response, 'access', _61 => _61.headers, 'optionalAccess', _62 => _62.location]), () => ( _optionalChain([response, 'access', _63 => _63.headers, 'optionalAccess', _64 => _64.Location])));
-    const idMatch = _optionalChain([locationHeader, 'optionalAccess', _65 => _65.match, 'call', _66 => _66(/\/([a-f0-9-]{36})$/i)]);
+    const locationHeader = _nullishCoalesce(_optionalChain([response, 'access', _63 => _63.headers, 'optionalAccess', _64 => _64.location]), () => ( _optionalChain([response, 'access', _65 => _65.headers, 'optionalAccess', _66 => _66.Location])));
+    const idMatch = _optionalChain([locationHeader, 'optionalAccess', _67 => _67.match, 'call', _68 => _68(/\/([a-f0-9-]{36})$/i)]);
     if (!idMatch) {
       throw new Error(
         `Could not extract media id from Location header: ${_nullishCoalesce(locationHeader, () => ( "(missing)"))}`
@@ -19741,7 +20027,7 @@ ${filePathSection}
       let effectiveSourceType;
       let effectiveFileUrl = model.fileUrl;
       if (model.sourceType === "file") {
-        if (!_optionalChain([model, 'access', _67 => _67.file, 'optionalAccess', _68 => _68.download_url])) {
+        if (!_optionalChain([model, 'access', _69 => _69.file, 'optionalAccess', _70 => _70.download_url])) {
           return _mcpserversdk.createToolResultError.call(void 0, {
             detail: "Error creating media: sourceType is 'file' but no file object was provided. ChatGPT's connector should inject this automatically when a file is attached \u2014 if it didn't, the user has nothing attached or your client doesn't support openai/fileParams."
           });
@@ -19890,7 +20176,7 @@ ${filePathSection}
             let effectiveSourceType;
             let effectiveFileUrl = file.fileUrl;
             if (model.sourceType === "file") {
-              if (!_optionalChain([file, 'access', _69 => _69.file, 'optionalAccess', _70 => _70.download_url])) {
+              if (!_optionalChain([file, 'access', _71 => _71.file, 'optionalAccess', _72 => _72.download_url])) {
                 return {
                   success: false,
                   name: file.name,
@@ -19989,7 +20275,7 @@ var CreateMediaFolderTool = {
       if (response.status < 200 || response.status >= 300) {
         throw new Error(`Request failed with status code ${response.status}`);
       }
-      const locationHeader = _optionalChain([response, 'access', _71 => _71.headers, 'optionalAccess', _72 => _72.location]) || _optionalChain([response, 'access', _73 => _73.headers, 'optionalAccess', _74 => _74.Location]);
+      const locationHeader = _optionalChain([response, 'access', _73 => _73.headers, 'optionalAccess', _74 => _74.location]) || _optionalChain([response, 'access', _75 => _75.headers, 'optionalAccess', _76 => _76.Location]);
       if (!locationHeader) {
         throw new Error("No Location header in response - cannot determine created folder ID");
       }
@@ -20063,7 +20349,7 @@ var get_media_by_id_default = _mcpserversdk.withStandardDecorators.call(void 0,
 
 
 
-var inputSchema17 = {
+var inputSchema19 = {
   id: putMediaByIdParams.shape.id,
   data: _zod.z.object(putMediaByIdBody.shape)
 };
@@ -20073,7 +20359,7 @@ var UpdateMediaTool = {
   Always read the current media value first and only update the required values.
   Don't miss any properties from the original media that you are updating.
   This cannot be used for moving media to a new folder. Use the move endpoint to do that.`,
-  inputSchema: inputSchema17,
+  inputSchema: inputSchema19,
   annotations: {
     idempotentHint: true
   },
@@ -20159,14 +20445,14 @@ var validate_media_default = _mcpserversdk.withStandardDecorators.call(void 0, V
 
 
 
-var inputSchema18 = {
+var inputSchema20 = {
   id: putMediaByIdValidateParams.shape.id,
   data: _zod.z.object(putMediaByIdValidateBody.shape)
 };
 var ValidateMediaUpdateTool = {
   name: "validate-media-update",
   description: "Validates media data before updating an existing media item by Id",
-  inputSchema: inputSchema18,
+  inputSchema: inputSchema20,
   annotations: { readOnlyHint: true },
   slices: ["validate"],
   handler: (async (model) => {
@@ -20199,6 +20485,55 @@ var SortMediaTool = {
 };
 var sort_media_default = _mcpserversdk.withStandardDecorators.call(void 0, SortMediaTool);
 
+// src/umbraco-api/tools/media/put/sort-media-children.ts
+
+
+
+
+
+
+var inputSchema21 = {
+  id: putMediaByIdSortChildrenParams.shape.id,
+  data: _zod.z.object(putMediaByIdSortChildrenBody.shape)
+};
+var SortMediaChildrenTool = {
+  name: "sort-media-children",
+  description: `Sorts the children of the media item identified by Id by a system field (Name, CreateDate or UpdateDate) in the given direction (Ascending or Descending).
+
+  This is DIFFERENT from sort-media: sort-media reorders children according to an explicit list of ids and sort orders you provide, whereas sort-media-children sorts every child of {id} automatically by the chosen field and direction - no explicit ordering is required.`,
+  inputSchema: inputSchema21,
+  annotations: {},
+  slices: ["sort"],
+  handler: (async (model) => {
+    return _mcpserversdk.executeVoidApiCall.call(void 0, 
+      (client) => client.putMediaByIdSortChildren(model.id, model.data, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var sort_media_children_default = _mcpserversdk.withStandardDecorators.call(void 0, SortMediaChildrenTool);
+
+// src/umbraco-api/tools/media/put/sort-media-root-children.ts
+
+
+
+
+
+var SortMediaRootChildrenTool = {
+  name: "sort-media-root-children",
+  description: `Sorts the root-level media items by a system field (Name, CreateDate or UpdateDate) in the given direction (Ascending or Descending).
+
+  This is the root-level equivalent of sort-media-children: it sorts every media item at the root of the media library automatically by the chosen field and direction - no explicit ordering is required. This is DIFFERENT from sort-media, which reorders media items according to an explicit list of ids and sort orders you provide.`,
+  inputSchema: putMediaRootSortChildrenBody.shape,
+  annotations: {},
+  slices: ["sort"],
+  handler: (async (model) => {
+    return _mcpserversdk.executeVoidApiCall.call(void 0, 
+      (client) => client.putMediaRootSortChildren(model, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var sort_media_root_children_default = _mcpserversdk.withStandardDecorators.call(void 0, SortMediaRootChildrenTool);
+
 // src/umbraco-api/tools/media/get/get-media-by-id-array.ts
 
 
@@ -20231,14 +20566,14 @@ var get_media_by_id_array_default = _mcpserversdk.withStandardDecorators.call(vo
 
 
 
-var inputSchema19 = {
+var inputSchema22 = {
   id: putMediaByIdMoveParams.shape.id,
   data: _zod.z.object(putMediaByIdMoveBody.shape)
 };
 var MoveMediaTool = {
   name: "move-media",
   description: "Move a media item to a new location",
-  inputSchema: inputSchema19,
+  inputSchema: inputSchema22,
   annotations: {
     idempotentHint: true
   },
@@ -20374,14 +20709,14 @@ var get_root_default6 = _mcpserversdk.withStandardDecorators.call(void 0, GetMed
 
 
 
-var inputSchema20 = {
+var inputSchema23 = {
   id: getMediaByIdAuditLogParams.shape.id,
   ...getMediaByIdAuditLogQueryParams.shape
 };
 var GetMediaAuditLogTool = {
   name: "get-media-audit-log",
   description: "Fetches the audit log for a media item by Id.",
-  inputSchema: inputSchema20,
+  inputSchema: inputSchema23,
   outputSchema: getMediaByIdAuditLogResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["audit"],
@@ -20596,7 +20931,7 @@ var get_media_are_referenced_default = _mcpserversdk.withStandardDecorators.call
 
 
 
-var inputSchema21 = _zod.z.object({
+var inputSchema24 = _zod.z.object({
   ...getMediaByIdReferencedByParams.shape,
   ...getMediaByIdReferencedByQueryParams.shape
 }).shape;
@@ -20604,7 +20939,7 @@ var GetMediaByIdReferencedByTool = {
   name: "get-media-by-id-referenced-by",
   description: `Get items that reference a specific media item
   Use this to find all content, documents, or other items that are currently referencing a specific media item.`,
-  inputSchema: inputSchema21,
+  inputSchema: inputSchema24,
   outputSchema: getMediaByIdReferencedByResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["references"],
@@ -20623,7 +20958,7 @@ var get_media_by_id_referenced_by_default = _mcpserversdk.withStandardDecorators
 
 
 
-var inputSchema22 = _zod.z.object({
+var inputSchema25 = _zod.z.object({
   ...getMediaByIdReferencedDescendantsParams.shape,
   ...getMediaByIdReferencedDescendantsQueryParams.shape
 }).shape;
@@ -20636,7 +20971,7 @@ var GetMediaByIdReferencedDescendantsTool = {
   \u2022 Impact analysis: Before deleting a media folder, see what content would be affected
   \u2022 Dependency tracking: Find all content using media from a specific folder hierarchy
   \u2022 Content auditing: Identify which descendant media items are actually being used`,
-  inputSchema: inputSchema22,
+  inputSchema: inputSchema25,
   outputSchema: getMediaByIdReferencedDescendantsResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["references"],
@@ -20775,6 +21110,10 @@ var MediaCollection = {
       tools.push(validate_media_default);
       tools.push(validate_media_default2);
       tools.push(sort_media_default);
+      if (isUmbracoAtLeast(17, 6)) {
+        tools.push(sort_media_children_default);
+        tools.push(sort_media_root_children_default);
+      }
       tools.push(get_media_by_id_array_default);
       tools.push(move_media_default);
       tools.push(get_media_audit_log_default);
@@ -20850,7 +21189,7 @@ var get_media_type_by_id_default = _mcpserversdk.withStandardDecorators.call(voi
 
 
 
-var inputSchema23 = _zod.z.object({
+var inputSchema26 = _zod.z.object({
   ids: _zod.z.array(_zod.z.string())
 });
 var outputSchema35 = _zod.z.object({
@@ -20859,7 +21198,7 @@ var outputSchema35 = _zod.z.object({
 var GetMediaTypeByIdsTool = {
   name: "get-media-type-by-ids",
   description: "Gets media types by ids",
-  inputSchema: inputSchema23.shape,
+  inputSchema: inputSchema26.shape,
   outputSchema: outputSchema35.shape,
   annotations: { readOnlyHint: true },
   slices: ["list"],
@@ -20972,13 +21311,13 @@ var get_media_type_allowed_at_root_default = _mcpserversdk.withStandardDecorator
 
 
 
-var inputSchema24 = getMediaTypeByIdAllowedChildrenParams.merge(
+var inputSchema27 = getMediaTypeByIdAllowedChildrenParams.merge(
   getMediaTypeByIdAllowedChildrenQueryParams
 );
 var GetMediaTypeAllowedChildrenTool = {
   name: "get-media-type-allowed-children",
   description: "Gets the media types that are allowed as children of a media type",
-  inputSchema: inputSchema24.shape,
+  inputSchema: inputSchema27.shape,
   outputSchema: getMediaTypeByIdAllowedChildrenResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["configuration"],
@@ -21226,7 +21565,7 @@ var CreateMediaTypeFolderTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _75 => _75.headers, 'optionalAccess', _76 => _76["location"]]) || _optionalChain([response, 'access', _77 => _77.headers, 'optionalAccess', _78 => _78["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _77 => _77.headers, 'optionalAccess', _78 => _78["location"]]) || _optionalChain([response, 'access', _79 => _79.headers, 'optionalAccess', _80 => _80["Location"]]);
       let createdId = model.id || "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -21278,14 +21617,14 @@ var delete_folder_default4 = _mcpserversdk.withStandardDecorators.call(void 0, D
 
 
 
-var inputSchema25 = _zod.z.object({
+var inputSchema28 = _zod.z.object({
   id: putMediaTypeFolderByIdParams.shape.id,
   data: _zod.z.object(putMediaTypeFolderByIdBody.shape)
 });
 var UpdateMediaTypeFolderTool = {
   name: "update-media-type-folder",
   description: "Updates a media type folder by Id",
-  inputSchema: inputSchema25.shape,
+  inputSchema: inputSchema28.shape,
   annotations: { idempotentHint: true },
   slices: ["update", "folders"],
   handler: (async (model) => {
@@ -21360,7 +21699,7 @@ var CreateMediaTypeTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _79 => _79.headers, 'optionalAccess', _80 => _80["location"]]) || _optionalChain([response, 'access', _81 => _81.headers, 'optionalAccess', _82 => _82["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _81 => _81.headers, 'optionalAccess', _82 => _82["location"]]) || _optionalChain([response, 'access', _83 => _83.headers, 'optionalAccess', _84 => _84["Location"]]);
       let createdId = model.id || "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -21390,7 +21729,7 @@ var create_media_type_default = _mcpserversdk.withStandardDecorators.call(void 0
 
 
 
-var inputSchema26 = _zod.z.object({
+var inputSchema29 = _zod.z.object({
   id: _zod.z.string().uuid(),
   data: _zod.z.object(postMediaTypeByIdCopyBody.shape)
 });
@@ -21401,7 +21740,7 @@ var copyMediaTypeOutputSchema = _zod.z.object({
 var CopyMediaTypeTool = {
   name: "copy-media-type",
   description: "Copy a media type to a new location",
-  inputSchema: inputSchema26.shape,
+  inputSchema: inputSchema29.shape,
   outputSchema: copyMediaTypeOutputSchema.shape,
   slices: ["copy"],
   handler: (async (model) => {
@@ -21411,7 +21750,7 @@ var CopyMediaTypeTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _83 => _83.headers, 'optionalAccess', _84 => _84["location"]]) || _optionalChain([response, 'access', _85 => _85.headers, 'optionalAccess', _86 => _86["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _85 => _85.headers, 'optionalAccess', _86 => _86["location"]]) || _optionalChain([response, 'access', _87 => _87.headers, 'optionalAccess', _88 => _88["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -21466,14 +21805,14 @@ var get_media_type_available_compositions_default = _mcpserversdk.withStandardDe
 
 
 
-var inputSchema27 = _zod.z.object({
+var inputSchema30 = _zod.z.object({
   id: putMediaTypeByIdParams.shape.id,
   data: _zod.z.object(putMediaTypeByIdBody.shape)
 });
 var UpdateMediaTypeTool = {
   name: "update-media-type",
   description: "Updates a media type by Id",
-  inputSchema: inputSchema27.shape,
+  inputSchema: inputSchema30.shape,
   annotations: { idempotentHint: true },
   slices: ["update"],
   handler: (async (model) => {
@@ -21491,14 +21830,14 @@ var update_media_type_default = _mcpserversdk.withStandardDecorators.call(void 0
 
 
 
-var inputSchema28 = _zod.z.object({
+var inputSchema31 = _zod.z.object({
   id: _zod.z.string().uuid(),
   data: _zod.z.object(putMediaTypeByIdMoveBody.shape)
 });
 var MoveMediaTypeTool = {
   name: "move-media-type",
   description: "Move a media type to a new location",
-  inputSchema: inputSchema28.shape,
+  inputSchema: inputSchema31.shape,
   annotations: { idempotentHint: true },
   slices: ["move"],
   handler: (async (model) => {
@@ -21621,7 +21960,7 @@ var CreateMemberTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _87 => _87.headers, 'optionalAccess', _88 => _88["location"]]) || _optionalChain([response, 'access', _89 => _89.headers, 'optionalAccess', _90 => _90["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _89 => _89.headers, 'optionalAccess', _90 => _90["location"]]) || _optionalChain([response, 'access', _91 => _91.headers, 'optionalAccess', _92 => _92["Location"]]);
       let createdId = model.id || "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -21694,14 +22033,14 @@ var delete_member_default = _mcpserversdk.withStandardDecorators.call(void 0, De
 
 
 
-var inputSchema29 = _zod.z.object({
+var inputSchema32 = _zod.z.object({
   id: putMemberByIdParams.shape.id,
   data: _zod.z.object(putMemberByIdBody.shape)
 });
 var UpdateMemberTool = {
   name: "update-member",
   description: "Updates a member by Id",
-  inputSchema: inputSchema29.shape,
+  inputSchema: inputSchema32.shape,
   annotations: { idempotentHint: true },
   slices: ["update"],
   handler: (async (model) => {
@@ -21719,7 +22058,7 @@ var update_member_default = _mcpserversdk.withStandardDecorators.call(void 0, Up
 
 
 
-var inputSchema30 = _zod.z.object({
+var inputSchema33 = _zod.z.object({
   id: putMemberByIdValidateParams.shape.id,
   data: _zod.z.object(putMemberByIdValidateBody.shape)
 });
@@ -21727,7 +22066,7 @@ var ValidateMemberUpdateTool = {
   name: "validate-member-update",
   description: `Validates member data before updating using the Umbraco API.
   Use this endpoint to validate member data structure, properties, and business rules before attempting to update an existing member.`,
-  inputSchema: inputSchema30.shape,
+  inputSchema: inputSchema33.shape,
   annotations: { readOnlyHint: true },
   slices: ["validate"],
   handler: (async (model) => {
@@ -21787,12 +22126,12 @@ var get_member_are_referenced_default = _mcpserversdk.withStandardDecorators.cal
 
 
 
-var inputSchema31 = getMemberByIdReferencedByParams.merge(getMemberByIdReferencedByQueryParams);
+var inputSchema34 = getMemberByIdReferencedByParams.merge(getMemberByIdReferencedByQueryParams);
 var GetMemberByIdReferencedByTool = {
   name: "get-member-by-id-referenced-by",
   description: `Get items that reference a specific member
   Use this to find all content, documents, or other items that are currently referencing a specific member account.`,
-  inputSchema: inputSchema31.shape,
+  inputSchema: inputSchema34.shape,
   outputSchema: getMemberByIdReferencedByResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["references"],
@@ -21810,12 +22149,12 @@ var get_member_by_id_referenced_by_default = _mcpserversdk.withStandardDecorator
 
 
 
-var inputSchema32 = getMemberByIdReferencedDescendantsParams.merge(getMemberByIdReferencedDescendantsQueryParams);
+var inputSchema35 = getMemberByIdReferencedDescendantsParams.merge(getMemberByIdReferencedDescendantsQueryParams);
 var GetMemberByIdReferencedDescendantsTool = {
   name: "get-member-by-id-referenced-descendants",
   description: `Get descendant references for a member
   Use this to find all descendant references that are being referenced for a specific member account.`,
-  inputSchema: inputSchema32.shape,
+  inputSchema: inputSchema35.shape,
   outputSchema: getMemberByIdReferencedDescendantsResponse.shape,
   annotations: { readOnlyHint: true },
   slices: ["references"],
@@ -22081,14 +22420,14 @@ var create_member_group_default = _mcpserversdk.withStandardDecorators.call(void
 
 
 
-var inputSchema33 = {
+var inputSchema36 = {
   id: putMemberGroupByIdParams.shape.id,
   data: _zod.z.object(putMemberGroupByIdBody.shape)
 };
 var UpdateMemberGroupTool = {
   name: "update-member-group",
   description: "Updates a member group by Id",
-  inputSchema: inputSchema33,
+  inputSchema: inputSchema36,
   annotations: {
     idempotentHint: true
   },
@@ -22172,7 +22511,7 @@ var CreateMemberTypeTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _91 => _91.headers, 'optionalAccess', _92 => _92["location"]]) || _optionalChain([response, 'access', _93 => _93.headers, 'optionalAccess', _94 => _94["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _93 => _93.headers, 'optionalAccess', _94 => _94["location"]]) || _optionalChain([response, 'access', _95 => _95.headers, 'optionalAccess', _96 => _96["Location"]]);
       let createdId = model.id || "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -22297,14 +22636,14 @@ var delete_member_type_default = _mcpserversdk.withStandardDecorators.call(void
 
 
 
-var inputSchema34 = _zod.z.object({
+var inputSchema37 = _zod.z.object({
   id: putMemberTypeByIdParams.shape.id,
   data: _zod.z.object(putMemberTypeByIdBody.shape)
 });
 var UpdateMemberTypeTool = {
   name: "update-member-type",
   description: "Updates a member type by id",
-  inputSchema: inputSchema34.shape,
+  inputSchema: inputSchema37.shape,
   annotations: { idempotentHint: true },
   slices: ["update"],
   handler: (async (model) => {
@@ -22322,7 +22661,7 @@ var update_member_type_default = _mcpserversdk.withStandardDecorators.call(void
 
 
 
-var inputSchema35 = _zod.z.object({
+var inputSchema38 = _zod.z.object({
   id: _zod.z.string().uuid()
 });
 var copyMemberTypeOutputSchema = _zod.z.object({
@@ -22332,7 +22671,7 @@ var copyMemberTypeOutputSchema = _zod.z.object({
 var CopyMemberTypeTool = {
   name: "copy-member-type",
   description: "Copy a member type to a new location",
-  inputSchema: inputSchema35.shape,
+  inputSchema: inputSchema38.shape,
   outputSchema: copyMemberTypeOutputSchema.shape,
   slices: ["copy"],
   handler: (async (model) => {
@@ -22342,7 +22681,7 @@ var CopyMemberTypeTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _95 => _95.headers, 'optionalAccess', _96 => _96["location"]]) || _optionalChain([response, 'access', _97 => _97.headers, 'optionalAccess', _98 => _98["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _97 => _97.headers, 'optionalAccess', _98 => _98["location"]]) || _optionalChain([response, 'access', _99 => _99.headers, 'optionalAccess', _100 => _100["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/([0-9a-f-]{36})$/i);
@@ -22702,7 +23041,7 @@ var CreatePartialViewTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _99 => _99.headers, 'optionalAccess', _100 => _100["location"]]) || _optionalChain([response, 'access', _101 => _101.headers, 'optionalAccess', _102 => _102["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _101 => _101.headers, 'optionalAccess', _102 => _102["location"]]) || _optionalChain([response, 'access', _103 => _103.headers, 'optionalAccess', _104 => _104["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/partial-view\/(.+)$/);
@@ -22749,7 +23088,7 @@ var CreatePartialViewFolderTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _103 => _103.headers, 'optionalAccess', _104 => _104["location"]]) || _optionalChain([response, 'access', _105 => _105.headers, 'optionalAccess', _106 => _106["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _105 => _105.headers, 'optionalAccess', _106 => _106["location"]]) || _optionalChain([response, 'access', _107 => _107.headers, 'optionalAccess', _108 => _108["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/partial-view\/folder\/(.+)$/);
@@ -23576,7 +23915,7 @@ var CreateScriptTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _107 => _107.headers, 'optionalAccess', _108 => _108["location"]]) || _optionalChain([response, 'access', _109 => _109.headers, 'optionalAccess', _110 => _110["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _109 => _109.headers, 'optionalAccess', _110 => _110["location"]]) || _optionalChain([response, 'access', _111 => _111.headers, 'optionalAccess', _112 => _112["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/script\/(.+)$/);
@@ -23623,7 +23962,7 @@ var CreateScriptFolderTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _111 => _111.headers, 'optionalAccess', _112 => _112["location"]]) || _optionalChain([response, 'access', _113 => _113.headers, 'optionalAccess', _114 => _114["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _113 => _113.headers, 'optionalAccess', _114 => _114["location"]]) || _optionalChain([response, 'access', _115 => _115.headers, 'optionalAccess', _116 => _116["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/script\/folder\/(.+)$/);
@@ -24220,7 +24559,7 @@ var CreateStylesheetTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _115 => _115.headers, 'optionalAccess', _116 => _116["location"]]) || _optionalChain([response, 'access', _117 => _117.headers, 'optionalAccess', _118 => _118["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _117 => _117.headers, 'optionalAccess', _118 => _118["location"]]) || _optionalChain([response, 'access', _119 => _119.headers, 'optionalAccess', _120 => _120["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/stylesheet\/(.+)$/);
@@ -24267,7 +24606,7 @@ var CreateStylesheetFolderTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _119 => _119.headers, 'optionalAccess', _120 => _120["location"]]) || _optionalChain([response, 'access', _121 => _121.headers, 'optionalAccess', _122 => _122["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _121 => _121.headers, 'optionalAccess', _122 => _122["location"]]) || _optionalChain([response, 'access', _123 => _123.headers, 'optionalAccess', _124 => _124["Location"]]);
       let createdPath = "";
       if (locationHeader) {
         const pathMatch = locationHeader.match(/stylesheet\/folder\/(.+)$/);
@@ -24631,7 +24970,7 @@ var CreateTemplateTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _123 => _123.headers, 'optionalAccess', _124 => _124["location"]]) || _optionalChain([response, 'access', _125 => _125.headers, 'optionalAccess', _126 => _126["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _125 => _125.headers, 'optionalAccess', _126 => _126["location"]]) || _optionalChain([response, 'access', _127 => _127.headers, 'optionalAccess', _128 => _128["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/template\/([a-f0-9-]+)$/i);
@@ -25421,6 +25760,27 @@ var GetUserByIdCalculateStartNodesTool = {
 };
 var get_user_by_id_calculate_start_nodes_default = _mcpserversdk.withStandardDecorators.call(void 0, GetUserByIdCalculateStartNodesTool);
 
+// src/umbraco-api/tools/user/get/get-user-batch.ts
+
+
+
+
+
+var GetUserBatchTool = {
+  name: "get-user-batch",
+  description: "Gets multiple users identified by the provided Ids in one call.",
+  inputSchema: getUserBatchQueryParams.shape,
+  outputSchema: getUserBatchResponse.shape,
+  annotations: { readOnlyHint: true },
+  slices: ["read"],
+  handler: (async (params) => {
+    return _mcpserversdk.executeGetApiCall.call(void 0, 
+      (client) => client.getUserBatch(params, _mcpserversdk.CAPTURE_RAW_HTTP_RESPONSE)
+    );
+  })
+};
+var get_user_batch_default = _mcpserversdk.withStandardDecorators.call(void 0, GetUserBatchTool);
+
 // src/umbraco-api/tools/user/post/upload-user-avatar-by-id.ts
 
 
@@ -25428,14 +25788,14 @@ var get_user_by_id_calculate_start_nodes_default = _mcpserversdk.withStandardDec
 
 
 
-var inputSchema36 = _zod.z.object({
+var inputSchema39 = _zod.z.object({
   ...postUserAvatarByIdParams.shape,
   ...postUserAvatarByIdBody.shape
 });
 var UploadUserAvatarByIdTool = {
   name: "upload-user-avatar-by-id",
   description: "Uploads an avatar for a specific user by ID (admin only or self-service)",
-  inputSchema: inputSchema36.shape,
+  inputSchema: inputSchema39.shape,
   slices: ["update"],
   handler: (async ({ id, file }) => {
     return _mcpserversdk.executeVoidApiCall.call(void 0, 
@@ -25556,6 +25916,9 @@ var UserCollection = {
       tools.push(get_item_user_default);
       tools.push(get_user_configuration_default);
       tools.push(get_user_by_id_calculate_start_nodes_default);
+      if (isUmbracoAtLeast(17, 6)) {
+        tools.push(get_user_batch_default);
+      }
       tools.push(upload_user_avatar_by_id_default);
       tools.push(delete_user_avatar_by_id_default);
     }
@@ -25587,7 +25950,7 @@ var CreateUserDataTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _127 => _127.headers, 'optionalAccess', _128 => _128["location"]]) || _optionalChain([response, 'access', _129 => _129.headers, 'optionalAccess', _130 => _130["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _129 => _129.headers, 'optionalAccess', _130 => _130["location"]]) || _optionalChain([response, 'access', _131 => _131.headers, 'optionalAccess', _132 => _132["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/user-data\/([a-f0-9-]+)$/i);
@@ -25825,7 +26188,7 @@ var CreateUserGroupTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _131 => _131.headers, 'optionalAccess', _132 => _132["location"]]) || _optionalChain([response, 'access', _133 => _133.headers, 'optionalAccess', _134 => _134["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _133 => _133.headers, 'optionalAccess', _134 => _134["location"]]) || _optionalChain([response, 'access', _135 => _135.headers, 'optionalAccess', _136 => _136["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/user-group\/([a-f0-9-]+)$/i);
@@ -26123,7 +26486,7 @@ var CreateWebhookTool = {
       validateStatus: () => true
     });
     if (response.status === 201) {
-      const locationHeader = _optionalChain([response, 'access', _135 => _135.headers, 'optionalAccess', _136 => _136["location"]]) || _optionalChain([response, 'access', _137 => _137.headers, 'optionalAccess', _138 => _138["Location"]]);
+      const locationHeader = _optionalChain([response, 'access', _137 => _137.headers, 'optionalAccess', _138 => _138["location"]]) || _optionalChain([response, 'access', _139 => _139.headers, 'optionalAccess', _140 => _140["Location"]]);
       let createdId = "";
       if (locationHeader) {
         const idMatch = locationHeader.match(/webhook\/([a-f0-9-]+)$/i);
@@ -26359,4 +26722,4 @@ var allSliceNames = [...toolSliceNames, "other"];
 
 
 exports.__commonJS = __commonJS; exports.__toESM = __toESM; exports.UmbracoManagementClient = UmbracoManagementClient3; exports.setAllowFilePathUploads = setAllowFilePathUploads; exports.setUmbracoVersion = setUmbracoVersion; exports.availableCollections = availableCollections; exports.allModes = allModes; exports.allModeNames = allModeNames; exports.allSliceNames = allSliceNames;
-//# sourceMappingURL=chunk-KDAEC7HU.cjs.map
+//# sourceMappingURL=chunk-4MRMRMFC.cjs.map