@bettercms-ai/mcp 0.42.0 → 0.43.0

package/dist/index.js

@@ -2273,6 +2273,11 @@ function toField(f) {
     ...f.config ? { config: f.config } : {}
   };
 }
+var STRUCTURE_NOTE = 'ORGANISATION ONLY: folders never change a URL, slug, content or publish state, and nothing is rebuilt or delivered. Folders nest at most 4 levels deep (a page or collection may sit in a level-4 folder). Icons are lucide icon names, e.g. "folder", "file-text", "rows-3", "house" (a-z, 0-9 and dashes); null clears one.';
+function structureResult(d) {
+  const message = d?.message;
+  return ok(typeof message === "string" ? message : "Updated the Content structure.", d);
+}
 function ok(summary, data) {
   return {
     content: [
@@ -2927,6 +2932,94 @@ function buildToolDefs(deps) {
         z.object({ formId: z.string().min(1), submissionId: z.string().min(1) }).shape,
         async (c, a) => ok("Deleted submission.", await data(c, "DELETE", `/management/forms/${s(a.formId)}/submissions/${s(a.submissionId)}`))
       ),
+      // ── Content structure: the Content sidebar's folders and icons (CPO-127 f) ──
+      def(
+        "get_content_structure",
+        "Get the Content sidebar structure",
+        `Read the Content sidebar's structure for the connected project: its folders, which pages and collections sit in each, and their icons. Returns { doc, version, summary }: \`doc\` is the raw document ({ schema: 1, folders: [{ id, parentId, name, icon, sort }], items: [{ kind: 'page'|'collection', id, folderId, sort, icon }] }), \`version\` is what set_content_structure needs, and \`summary\` is the resolved tree with page and collection TITLES (\`outline\` is a readable version), ids that no longer resolve (\`missing\`), and the pages and collections not in any folder yet. Call it before changing the structure. ${STRUCTURE_NOTE}`,
+        z.object({}).shape,
+        async (c) => {
+          const d = await data(c, "GET", `/management/content-structure`);
+          return ok(d?.summary?.outline ? `Content structure:
+${d.summary.outline}` : "Content structure.", d);
+        }
+      ),
+      def(
+        "set_content_structure",
+        "Replace the Content sidebar structure",
+        `Replace the whole Content sidebar document in one write. Prefer the single-action tools (create_folder, rename_folder, move_to_folder, set_icon, delete_folder) for small changes; use this to lay out a full structure at once. Send the complete \`doc\` and the \`version\` get_content_structure returned (0 when the project has none yet). Validated exactly like the dashboard: unique folder ids, every parentId/folderId must be a folder in the doc, no cycles, depth at most 4, names 1-80 chars, lucide icon names. A 412 VERSION_CONFLICT means someone changed it since you read it: call get_content_structure again and re-apply your change. Returns the new version and a diff (folders added, removed, renamed or moved; items moved; icons changed). ${STRUCTURE_NOTE}`,
+        z.object({
+          doc: z.object({
+            schema: z.literal(1),
+            folders: z.array(z.object({
+              id: z.string().min(1).describe("your own stable id, up to 64 chars"),
+              parentId: z.string().nullable().describe("parent folder id; null = top level"),
+              name: z.string(),
+              icon: z.string().nullable().describe("lucide icon name or null"),
+              sort: z.number()
+            })),
+            items: z.array(z.object({
+              kind: z.enum(["page", "collection"]),
+              id: z.string().min(1).describe("page id or collection (content model) id"),
+              folderId: z.string().nullable().describe("folder id; null = its home (Static pages for a page, the Collections list for a collection)"),
+              sort: z.number(),
+              icon: z.string().nullable()
+            }))
+          }).describe("the complete document"),
+          version: z.number().int().min(0).describe("the version get_content_structure returned")
+        }).shape,
+        async (c, a) => structureResult(await data(c, "PUT", `/management/content-structure`, { doc: a.doc, version: a.version }))
+      ),
+      def(
+        "create_folder",
+        "Create a Content sidebar folder",
+        `Create a folder in the Content sidebar, at the top level or inside \`parentId\`, placed after what is already there. Returns the new \`folderId\`. Reads, applies and writes with the version check, retrying once on a conflict. ${STRUCTURE_NOTE}`,
+        z.object({
+          name: z.string().min(1).describe("the folder's label, 1-80 chars"),
+          parentId: z.string().min(1).optional().describe("optional parent folder id (from get_content_structure); omit for the top level"),
+          icon: z.string().min(1).optional().describe("optional lucide icon name, e.g. 'folder'")
+        }).shape,
+        async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/folders`, { name: a.name, parentId: a.parentId, icon: a.icon }))
+      ),
+      def(
+        "rename_folder",
+        "Rename a Content sidebar folder",
+        `Rename a Content sidebar folder. ${STRUCTURE_NOTE}`,
+        z.object({
+          folderId: z.string().min(1).describe("folder id (from get_content_structure)"),
+          name: z.string().min(1).describe("the new label, 1-80 chars")
+        }).shape,
+        async (c, a) => structureResult(await data(c, "PATCH", `/management/content-structure/folders/${encodeURIComponent(s(a.folderId))}`, { name: a.name }))
+      ),
+      def(
+        "move_to_folder",
+        "Move into a Content sidebar folder",
+        `Move a page, a collection or a folder into a folder. folderId null moves it back to its home: Static pages for a page, the Collections list for a collection, the top level for a folder. It lands after what is already there. Moving a folder takes its contents with it and is refused if the result would nest deeper than 4 levels or put a folder inside itself. ${STRUCTURE_NOTE}`,
+        z.object({
+          kind: z.enum(["page", "collection", "folder"]),
+          id: z.string().min(1).describe("the page id, collection (content model) id, or folder id"),
+          folderId: z.string().min(1).nullable().describe("target folder id, or null to move it back to its home (Static pages, the Collections list, or the top level for a folder)")
+        }).shape,
+        async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/move`, { kind: a.kind, id: a.id, folderId: a.folderId }))
+      ),
+      def(
+        "set_icon",
+        "Set a Content sidebar icon",
+        `Set or clear the sidebar icon of a page, a collection or a folder. ${STRUCTURE_NOTE}`,
+        z.object({
+          kind: z.enum(["page", "collection", "folder"]),
+          id: z.string().min(1).describe("the page id, collection (content model) id, or folder id"),
+          icon: z.string().min(1).nullable().describe("lucide icon name, e.g. 'file-text'; null clears it")
+        }).shape,
+        async (c, a) => structureResult(await data(c, "POST", `/management/content-structure/icon`, { kind: a.kind, id: a.id, icon: a.icon }))
+      ),
+      def(
+        "delete_folder",
+        "Delete a folder (its contents move up; nothing is deleted)",
+        `Delete a folder (its contents move up; nothing is deleted). NOTHING ELSE IS DELETED: its pages, collections and sub-folders move up to the folder's parent, in the same order. ${STRUCTURE_NOTE}`,
+        z.object({ folderId: z.string().min(1).describe("folder id (from get_content_structure)") }).shape,
+        async (c, a) => structureResult(await data(c, "DELETE", `/management/content-structure/folders/${encodeURIComponent(s(a.folderId))}`))
+      ),
       def(
         "list_redirects",
         "List redirects",