feat(wordpress): add category/tag CRUD tools, fix delete-status and dead-field bugs (#5360)

* feat(wordpress): add category/tag CRUD tools, fix delete-status and dead-field bugs

- Add wordpress_{get,update,delete}_category and _tag tools for full taxonomy parity
- Fix `deleted: data.deleted || true` always evaluating true across all 6 delete tools (posts/pages/media/comments/categories/tags)
- Remove dead `force` param from delete_media (endpoint always force-deletes; param had zero effect)
- Remove unwired `hideEmpty` block input
- Normalize search_content perPage/page visibility to user-or-llm for consistency

* fix(wordpress): use ?? instead of || for zero-valued numeric fields in delete_category/tag

count and parent can legitimately be 0 (empty term, top-level category); || was
dropping those values, same antipattern already fixed for `deleted` in this PR.
Flagged independently by Greptile and Cursor Bugbot.

* fix(wordpress): use ?? for zero-valued numeric fields across all delete tools

Same || antipattern already fixed for category/tag delete tools was still
present in delete_post/page/comment/media for id, author, featured_media,
menu_order, parent, post — all legitimately 0 in common cases (no featured
image, top-level page/comment). Found by a final independent validation pass.

* fix(wordpress): don't drop categoryParent=0 (root-level category) in block param mapping

Truthy check on params.categoryParent treated a resolved numeric 0 (root-level,
no parent) as unset. Flagged by Cursor Bugbot on create_category/update_category.

* fix(wordpress): don't clear category/tag description on update when field left blank

description used !== undefined (numeric-field convention) instead of a truthy
check (string-field convention used everywhere else in this codebase, e.g.
update_post/update_page excerpt), so an untouched empty description field
silently wiped existing text on every update. Flagged by Cursor Bugbot.

* fix(wordpress): fix search type/subtype mislabeling, complete I/O exposure gaps

- search_content.ts: type param was mislabeled with subtype's vocabulary
  (post/page/attachment); real WP type enum is post/term/post-format. Rewired
  the block's Content Type dropdown to map to subtype (which is what
  post/page/attachment actually filter), not type.
- Widened subBlock conditions so params already read by tools.config.params
  are actually reachable in the UI: commentPostId for list_comments,
  categories/tags for list_posts, parent for list_pages.
- Added missing subBlocks for tool params with no UI path: comment
  parent/authorName/authorEmail/authorUrl (create_comment), media description
  (upload_media), author filter (list_posts).
- Extended the ?? / !== undefined fix (already applied to categoryParent) to
  the same class of param across the block: featuredMedia, page parent,
  menuOrder, and the new commentParent/listAuthor mappings.
- Fixed featuredMedia/parent truthy-check inconsistency in create_post,
  update_post, create_page, update_page, create_category, create_comment
  body builders to match the !== undefined convention used elsewhere.

Found by an independent final validation pass across 3 parallel agents.

* fix(wordpress): keep searchType subBlock id to preserve saved-workflow compat

The type/subtype fix should only change which API param the field feeds
(subtype, not type) — renaming the subBlock id to searchSubtype broke
already-saved workflows with a search content-type filter set, since the
block would stop reading the old searchType key. Reverted the id rename,
kept the underlying subtype mapping fix. Flagged by Cursor Bugbot.

* fix(wordpress): remove invalid Attachment search subtype, fix listAuthor input type

- Search Content's "Content Type" dropdown offered Attachment, which maps to
  subtype=attachment. WP core's WP_REST_Post_Search_Handler explicitly
  excludes attachment from valid subtypes (media isn't searchable via
  /search) — selecting it guaranteed a 400 rest_invalid_param. Removed the
  option; only Post/Page (the only valid subtypes) remain.
- listAuthor was declared type: 'string' in the inputs catalog despite being
  Number()-coerced before use, inconsistent with every other ID-like field
  (postId, pageId, categoryId, commentParent, etc. are all 'number').

Found by an independent final pre-merge validation pass, requested before
merge to be certain of full API alignment.

Author: waleedlatif1

apps/sim/blocks/blocks/wordpress.ts

@@ -4163,14 +4163,18 @@ import {
   wordpressCreatePageTool,
   wordpressCreatePostTool,
   wordpressCreateTagTool,
+  wordpressDeleteCategoryTool,
   wordpressDeleteCommentTool,
   wordpressDeleteMediaTool,
   wordpressDeletePageTool,
   wordpressDeletePostTool,
+  wordpressDeleteTagTool,
+  wordpressGetCategoryTool,
   wordpressGetCurrentUserTool,
   wordpressGetMediaTool,
   wordpressGetPageTool,
   wordpressGetPostTool,
+  wordpressGetTagTool,
   wordpressGetUserTool,
   wordpressListCategoriesTool,
   wordpressListCommentsTool,
@@ -4180,9 +4184,11 @@ import {
   wordpressListTagsTool,
   wordpressListUsersTool,
   wordpressSearchContentTool,
+  wordpressUpdateCategoryTool,
   wordpressUpdateCommentTool,
   wordpressUpdatePageTool,
   wordpressUpdatePostTool,
+  wordpressUpdateTagTool,
   wordpressUploadMediaTool,
 } from '@/tools/wordpress'
 import {
@@ -7490,8 +7496,14 @@ export const tools: Record<string, ToolConfig> = {
   wordpress_delete_comment: wordpressDeleteCommentTool,
   wordpress_create_category: wordpressCreateCategoryTool,
   wordpress_list_categories: wordpressListCategoriesTool,
+  wordpress_get_category: wordpressGetCategoryTool,
+  wordpress_update_category: wordpressUpdateCategoryTool,
+  wordpress_delete_category: wordpressDeleteCategoryTool,
   wordpress_create_tag: wordpressCreateTagTool,
   wordpress_list_tags: wordpressListTagsTool,
+  wordpress_get_tag: wordpressGetTagTool,
+  wordpress_update_tag: wordpressUpdateTagTool,
+  wordpress_delete_tag: wordpressDeleteTagTool,
   wordpress_get_current_user: wordpressGetCurrentUserTool,
   wordpress_list_users: wordpressListUsersTool,
   wordpress_get_user: wordpressGetUserTool,

apps/sim/tools/registry.ts

@@ -66,7 +66,7 @@ export const createCategoryTool: ToolConfig<
       }
 
       if (params.description) body.description = params.description
-      if (params.parent) body.parent = params.parent
+      if (params.parent !== undefined) body.parent = params.parent
       if (params.slug) body.slug = params.slug
 
       return body

apps/sim/tools/wordpress/create_category.ts

@@ -78,7 +78,7 @@ export const createCommentTool: ToolConfig<
         content: params.content,
       }
 
-      if (params.parent) body.parent = params.parent
+      if (params.parent !== undefined) body.parent = params.parent
       if (params.authorName) body.author_name = params.authorName
       if (params.authorEmail) body.author_email = params.authorEmail
       if (params.authorUrl) body.author_url = params.authorUrl

apps/sim/tools/wordpress/create_comment.ts

@@ -90,9 +90,9 @@ export const createPageTool: ToolConfig<WordPressCreatePageParams, WordPressCrea
       if (params.status) body.status = params.status
       if (params.excerpt) body.excerpt = params.excerpt
       if (params.slug) body.slug = params.slug
-      if (params.parent) body.parent = params.parent
-      if (params.menuOrder) body.menu_order = params.menuOrder
-      if (params.featuredMedia) body.featured_media = params.featuredMedia
+      if (params.parent !== undefined) body.parent = params.parent
+      if (params.menuOrder !== undefined) body.menu_order = params.menuOrder
+      if (params.featuredMedia !== undefined) body.featured_media = params.featuredMedia
 
       return body
     },

apps/sim/tools/wordpress/create_page.ts

@@ -90,7 +90,7 @@ export const createPostTool: ToolConfig<WordPressCreatePostParams, WordPressCrea
       if (params.status) body.status = params.status
       if (params.excerpt) body.excerpt = params.excerpt
       if (params.slug) body.slug = params.slug
-      if (params.featuredMedia) body.featured_media = params.featuredMedia
+      if (params.featuredMedia !== undefined) body.featured_media = params.featuredMedia
 
       if (params.categories) {
         body.categories = params.categories

apps/sim/tools/wordpress/create_post.ts

@@ -0,0 +1,96 @@
+import type { ToolConfig } from '@/tools/types'
+import {
+  WORDPRESS_COM_API_BASE,
+  type WordPressDeleteCategoryParams,
+  type WordPressDeleteCategoryResponse,
+} from '@/tools/wordpress/types'
+
+export const deleteCategoryTool: ToolConfig<
+  WordPressDeleteCategoryParams,
+  WordPressDeleteCategoryResponse
+> = {
+  id: 'wordpress_delete_category',
+  name: 'WordPress Delete Category',
+  description: 'Delete a category from WordPress.com',
+  version: '1.0.0',
+
+  oauth: {
+    required: true,
+    provider: 'wordpress',
+    requiredScopes: ['global'],
+  },
+
+  params: {
+    siteId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'WordPress.com site ID or domain (e.g., 12345678 or mysite.wordpress.com)',
+    },
+    categoryId: {
+      type: 'number',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The ID of the category to delete',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      // Terms do not support trashing, so force=true is required to delete.
+      return `${WORDPRESS_COM_API_BASE}/${params.siteId}/categories/${params.categoryId}?force=true`
+    },
+    method: 'DELETE',
+    headers: (params) => ({
+      'Content-Type': 'application/json',
+      Authorization: `Bearer ${params.accessToken}`,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}))
+      throw new Error(error.message || `WordPress API error: ${response.status}`)
+    }
+
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        deleted: data.deleted ?? true,
+        category: {
+          id: data.id ?? data.previous?.id,
+          count: data.count ?? data.previous?.count,
+          description: data.description || data.previous?.description,
+          link: data.link || data.previous?.link,
+          name: data.name || data.previous?.name,
+          slug: data.slug || data.previous?.slug,
+          taxonomy: data.taxonomy || data.previous?.taxonomy,
+          parent: data.parent ?? data.previous?.parent,
+        },
+      },
+    }
+  },
+
+  outputs: {
+    deleted: {
+      type: 'boolean',
+      description: 'Whether the category was deleted',
+    },
+    category: {
+      type: 'object',
+      description: 'The deleted category',
+      properties: {
+        id: { type: 'number', description: 'Category ID' },
+        count: { type: 'number', description: 'Number of posts in this category' },
+        description: { type: 'string', description: 'Category description' },
+        link: { type: 'string', description: 'Category archive URL' },
+        name: { type: 'string', description: 'Category name' },
+        slug: { type: 'string', description: 'Category slug' },
+        taxonomy: { type: 'string', description: 'Taxonomy name' },
+        parent: { type: 'number', description: 'Parent category ID' },
+      },
+    },
+  },
+}

apps/sim/tools/wordpress/delete_category.ts

@@ -64,12 +64,12 @@ export const deleteCommentTool: ToolConfig<
     return {
       success: true,
       output: {
-        deleted: data.deleted || true,
+        deleted: data.deleted ?? true,
         comment: {
-          id: data.id || data.previous?.id,
-          post: data.post || data.previous?.post,
-          parent: data.parent || data.previous?.parent,
-          author: data.author || data.previous?.author,
+          id: data.id ?? data.previous?.id,
+          post: data.post ?? data.previous?.post,
+          parent: data.parent ?? data.previous?.parent,
+          author: data.author ?? data.previous?.author,
           author_name: data.author_name || data.previous?.author_name,
           author_email: data.author_email || data.previous?.author_email,
           author_url: data.author_url || data.previous?.author_url,

apps/sim/tools/wordpress/delete_comment.ts

@@ -31,17 +31,11 @@ export const deleteMediaTool: ToolConfig<WordPressDeleteMediaParams, WordPressDe
         visibility: 'user-or-llm',
         description: 'The ID of the media item to delete',
       },
-      force: {
-        type: 'boolean',
-        required: false,
-        visibility: 'user-only',
-        description: 'Force delete (media has no trash, so deletion is permanent)',
-      },
     },
 
     request: {
       url: (params) => {
-        // Media deletion requires force=true to actually delete
+        // Media has no trash — deletion always requires force=true to take effect
         return `${WORDPRESS_COM_API_BASE}/${params.siteId}/media/${params.mediaId}?force=true`
       },
       method: 'DELETE',
@@ -62,9 +56,9 @@ export const deleteMediaTool: ToolConfig<WordPressDeleteMediaParams, WordPressDe
       return {
         success: true,
         output: {
-          deleted: data.deleted || true,
+          deleted: data.deleted ?? true,
           media: {
-            id: data.id || data.previous?.id,
+            id: data.id ?? data.previous?.id,
             date: data.date || data.previous?.date,
             slug: data.slug || data.previous?.slug,
             type: data.type || data.previous?.type,

apps/sim/tools/wordpress/delete_media.ts

@@ -61,9 +61,9 @@ export const deletePageTool: ToolConfig<WordPressDeletePageParams, WordPressDele
     return {
       success: true,
       output: {
-        deleted: data.deleted || true,
+        deleted: data.deleted ?? true,
         page: {
-          id: data.id || data.previous?.id,
+          id: data.id ?? data.previous?.id,
           date: data.date || data.previous?.date,
           modified: data.modified || data.previous?.modified,
           slug: data.slug || data.previous?.slug,
@@ -73,10 +73,10 @@ export const deletePageTool: ToolConfig<WordPressDeletePageParams, WordPressDele
           title: data.title || data.previous?.title,
           content: data.content || data.previous?.content,
           excerpt: data.excerpt || data.previous?.excerpt,
-          author: data.author || data.previous?.author,
-          featured_media: data.featured_media || data.previous?.featured_media,
-          parent: data.parent || data.previous?.parent,
-          menu_order: data.menu_order || data.previous?.menu_order,
+          author: data.author ?? data.previous?.author,
+          featured_media: data.featured_media ?? data.previous?.featured_media,
+          parent: data.parent ?? data.previous?.parent,
+          menu_order: data.menu_order ?? data.previous?.menu_order,
         },
       },
     }