mcp-sunsama 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # mcp-sunsama
 
+## 0.10.2
+
+### Patch Changes
+
+- Upgrades sunsama package to 0.8.1. Fixes create-task tool snooze date
+
+## 0.10.1
+
+### Patch Changes
+
+- 002cd07: Fix MCP Inspector compatibility for update-task-notes schema
+
+  - Replace ZodIntersection (.and()) with single z.object() using .refine() for XOR validation
+  - Ensure schema generates proper JSON Schema with "type": "object" for MCP Inspector
+  - Add clear parameter descriptions indicating mutual exclusivity
+  - Maintain same validation behavior while fixing compatibility issues
+  - Update documentation to reflect schema architecture improvements
+
 ## 0.10.0
 
 ### Minor Changes

package/CLAUDE.md

@@ -66,7 +66,8 @@ All tools use Zod schemas from `schemas.ts`:
 - Automatic TypeScript inference
 - Comprehensive parameter documentation
 - Union types for completion filters
-- XOR schema patterns for mutually exclusive parameters (e.g., `update-task-notes` requires either `html` OR `markdown`, but not both)
+- XOR schema patterns for mutually exclusive parameters using `.refine()` for MCP Inspector compatibility
+- Example: `update-task-notes` requires either `html` OR `markdown`, but not both
 
 ## Key Patterns
 

package/README.md

@@ -95,7 +95,7 @@ Add this configuration to your Claude Desktop MCP settings:
 - `get-task-by-id` - Get a specific task by its ID
 - `update-task-complete` - Mark tasks as complete
 - `update-task-planned-time` - Update the planned time (time estimate) for tasks
-- `update-task-notes` - Update task notes content (requires either `html` or `markdown` parameter)
+- `update-task-notes` - Update task notes content (requires either `html` or `markdown` parameter, mutually exclusive)
 - `update-task-snooze-date` - Reschedule tasks to different dates
 - `update-task-backlog` - Move tasks to the backlog
 - `delete-task` - Delete tasks permanently

package/bun.lock

@@ -7,7 +7,7 @@
         "@types/papaparse": "^5.3.16",
         "fastmcp": "3.3.1",
         "papaparse": "^5.5.3",
-        "sunsama-api": "0.8.0",
+        "sunsama-api": "0.8.1",
         "zod": "3.24.4",
       },
       "devDependencies": {
@@ -430,7 +430,7 @@
 
     "strtok3": ["strtok3@10.3.1", "", { "dependencies": { "@tokenizer/token": "^0.3.0" } }, "sha512-3JWEZM6mfix/GCJBBUrkA8p2Id2pBkyTkVCJKto55w080QBKZ+8R171fGrbiSp+yMO/u6F8/yUh7K4V9K+YCnw=="],
 
-    "sunsama-api": ["sunsama-api@0.8.0", "", { "dependencies": { "graphql": "^16.11.0", "graphql-tag": "^2.12.6", "marked": "^14.1.3", "tough-cookie": "^5.1.2", "tslib": "^2.8.1", "turndown": "^7.2.0", "yjs": "^13.6.27", "zod": "^3.25.64" } }, "sha512-EiUqEc2OIDsmfCHQX54Pu+xZDfJBTMjHAcwhWqHVIWTp2emMyitUuSDvABEqupoXrzITZw+XW0lxNZUQaW4lqQ=="],
+    "sunsama-api": ["sunsama-api@0.8.1", "", { "dependencies": { "graphql": "^16.11.0", "graphql-tag": "^2.12.6", "marked": "^14.1.3", "tough-cookie": "^5.1.2", "tslib": "^2.8.1", "turndown": "^7.2.0", "yjs": "^13.6.27", "zod": "^3.25.64" } }, "sha512-CcLyMwrUnpQi9GmRrNqgqb0A7f2Ba5qxaI1uJdAivcqZQRNfg+g5V9RFzh64mGrN/7M3v+Meiv+Ev6AsiSAz3A=="],
 
     "term-size": ["term-size@2.2.1", "", {}, "sha512-wK0Ri4fOGjv/XPy8SBHZChl8CM7uMc5VML7SqiQ0zG7+J5Vr+RMQDoHa2CNT6KHUnTGIXH34UDMkPzAUyapBZg=="],
 

package/dev/update-task-text-response.json

@@ -0,0 +1,11 @@
+{
+    "data": {
+        "updateTaskText": {
+            "updatedTask": null,
+            "updatedFields": null,
+            "success": true,
+            "skipped": null,
+            "__typename": "UpdateTaskPayload"
+        }
+    }
+}

package/dev/update-task-text.sh

@@ -0,0 +1,20 @@
+curl 'https://api.sunsama.com/graphql' \
+  -H 'accept: */*' \
+  -H 'accept-language: en-US,en;q=0.5' \
+  -H 'content-type: application/json' \
+  -b 'intercom-device-id-bneprukf=cb3bdbde-e6f5-452f-860a-3d9af07d287f; sunsamaSession=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI2NjM2N2MzZjMzNzEzMzAwMDEwODEyNjAiLCJzZXNzaW9uSWQiOiI2OTcxMmYyOS1jZDZiLTQzNjgtODFmYS1iNTg3ZmQ0NGVlZWYiLCJzZXNzaW9uTm9uY2UiOiIwYjAyZWJlNC0yMzNlLTRhMjYtYTQ1Ni1hNmJhMzA2YTJhZTQiLCJncm91cElkIjoiNjYzNjdjNDMzMzcxMzMwMDAxMDgxMjYyIiwiZ3JvdXBVcmxQYXRoIjoiMTcxNDg0Njc4NzkzNDI0NzQiLCJpYXQiOjE3NTA1MTEzNzgsImV4cCI6MTc1MzEwMzM3OH0.rzteDU3SQfOPiZc9I71jVIfc78ocxh3MGEBeNqzDLJM; intercom-session-bneprukf=NnRmSnl1ZmJCb0V1RGhnb1prdWx5LzJkTGxUNFFORkUvSkNZWVRSY205MlVkVG11TUtYdithSXRRWlVmTXRwai9MaXVPSXl2QkJYZTRGM2N4MCtrVjg0NUNSblRKUWxRK2lHdzBjNjdMTlk9LS1VUmc1c1NzVkpGZ1V0eElLMnlOL29nPT0=--54db2c84e7f41fb661fae4a1650446aaf046bf1e' \
+  -H 'origin: https://app.sunsama.com' \
+  -H 'priority: u=1, i' \
+  -H 'referer: https://app.sunsama.com/' \
+  -H 'sec-ch-ua: "Brave";v="137", "Chromium";v="137", "Not/A)Brand";v="24"' \
+  -H 'sec-ch-ua-mobile: ?0' \
+  -H 'sec-ch-ua-platform: "macOS"' \
+  -H 'sec-fetch-dest: empty' \
+  -H 'sec-fetch-mode: cors' \
+  -H 'sec-fetch-site: same-site' \
+  -H 'sec-gpc: 1' \
+  -H 'traceparent: 00-e604d5f85432b50fe3b7d5bf8fc2775b-2ef7c8c51cf75623-01' \
+  -H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36' \
+  -H 'x-gql-operation-name: updateTaskText' \
+  -H 'x-pusher-socket-id: 73411.8251716' \
+  --data-raw $'{"operationName":"updateTaskText","variables":{"input":{"taskId":"685693f91f41775b0458892f","text":"Try out FOSS AI browser ","recommendedStreamId":null,"limitResponsePayload":true}},"query":"mutation updateTaskText($input: UpdateTaskTextInput\u0021) {\\n  updateTaskText(input: $input) {\\n    ...UpdateTaskPayload\\n    __typename\\n  }\\n}\\n\\nfragment UpdateTaskPayload on UpdateTaskPayload {\\n  updatedTask {\\n    ...Task\\n    __typename\\n  }\\n  updatedFields {\\n    ...PartialTask\\n    __typename\\n  }\\n  success\\n  skipped\\n  __typename\\n}\\n\\nfragment Task on Task {\\n  _id\\n  groupId\\n  taskType\\n  streamIds\\n  recommendedStreamId\\n  eventInfo {\\n    eventId\\n    clone\\n    __typename\\n  }\\n  seededEventIds\\n  private\\n  assigneeId\\n  createdBy\\n  integration {\\n    ...TaskIntegration\\n    __typename\\n  }\\n  deleted\\n  text\\n  notes\\n  notesMarkdown\\n  notesChecksum\\n  editorVersion\\n  collabSnapshot\\n  completed\\n  completedBy\\n  completeDate\\n  completeOn\\n  archivedAt\\n  duration\\n  runDate {\\n    startDate\\n    endDate\\n    __typename\\n  }\\n  snooze {\\n    userId\\n    date\\n    until\\n    __typename\\n  }\\n  timeHorizon {\\n    type\\n    relativeTo\\n    __typename\\n  }\\n  dueDate\\n  comments {\\n    userId\\n    text\\n    markdown\\n    editorVersion\\n    groupId\\n    createdAt\\n    editedAt\\n    deleted\\n    file\\n    fileMetadata {\\n      url\\n      filename\\n      mimetype\\n      size\\n      width\\n      height\\n      __typename\\n    }\\n    __typename\\n  }\\n  orderings {\\n    ordinal\\n    panelDate\\n    channelId\\n    userId\\n    __typename\\n  }\\n  backlogOrderings {\\n    horizonType\\n    position\\n    streamId\\n    __typename\\n  }\\n  subtasks {\\n    _id\\n    title\\n    completedDate\\n    completedBy\\n    timeEstimate\\n    actualTime {\\n      ...TaskActualTime\\n      __typename\\n    }\\n    snooze {\\n      userId\\n      date\\n      until\\n      __typename\\n    }\\n    scheduledTime {\\n      ...TaskScheduledTime\\n      __typename\\n    }\\n    integration {\\n      ...TaskIntegration\\n      __typename\\n    }\\n    mergedTaskId\\n    recommendedTimeEstimate\\n    __typename\\n  }\\n  subtasksCollapsed\\n  sequence {\\n    date\\n    id\\n    expiresDate\\n    ruleString\\n    searchable\\n    forked\\n    final\\n    estimatedStart {\\n      hour\\n      minute\\n      __typename\\n    }\\n    master\\n    finalDate\\n    template {\\n      streamIds\\n      private\\n      text\\n      notes\\n      notesMarkdown\\n      notesChecksum\\n      editorVersion\\n      subtasks {\\n        _id\\n        title\\n        completedDate\\n        completedBy\\n        timeEstimate\\n        actualTime {\\n          ...TaskActualTime\\n          __typename\\n        }\\n        __typename\\n      }\\n      timeEstimate\\n      assigneeId\\n      __typename\\n    }\\n    __typename\\n  }\\n  followers\\n  recommendedTimeEstimate\\n  timeEstimate\\n  actualTime {\\n    ...TaskActualTime\\n    __typename\\n  }\\n  scheduledTime {\\n    ...TaskScheduledTime\\n    __typename\\n  }\\n  createdAt\\n  lastModified\\n  objectiveId\\n  ritual {\\n    id\\n    period {\\n      interval\\n      startCalendarDay\\n      endCalendarDay\\n      __typename\\n    }\\n    __typename\\n  }\\n  __typename\\n}\\n\\nfragment TaskActualTime on TaskActualTime {\\n  userId\\n  startDate\\n  endDate\\n  duration\\n  isTimerEntry\\n  __typename\\n}\\n\\nfragment TaskScheduledTime on TaskScheduledTime {\\n  eventId\\n  serviceIds {\\n    google\\n    microsoft\\n    microsoftUniqueId\\n    apple\\n    appleRecurrenceId\\n    sunsama\\n    __typename\\n  }\\n  calendarId\\n  userId\\n  startDate\\n  endDate\\n  isAllDay\\n  importedFromCalendar\\n  __typename\\n}\\n\\nfragment TaskIntegration on TaskIntegration {\\n  ... on TaskAsanaIntegration {\\n    service\\n    identifier {\\n      id\\n      url\\n      accountId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskTrelloIntegration {\\n    service\\n    identifier {\\n      id\\n      url\\n      accountId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskJiraIntegration {\\n    service\\n    identifier {\\n      id\\n      cloudId\\n      accountId\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskGithubIntegration {\\n    service\\n    identifier {\\n      id\\n      repositoryOwnerLogin\\n      repositoryName\\n      number\\n      type\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskTodoistIntegration {\\n    service\\n    identifier {\\n      id\\n      url\\n      deepUrl\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskGoogleCalendarIntegration {\\n    service\\n    identifier {\\n      sunsamaId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskOutlookCalendarIntegration {\\n    service\\n    identifier {\\n      sunsamaId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskAppleCalendarIntegration {\\n    service\\n    identifier {\\n      sunsamaId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskSunsamaCalendarIntegration {\\n    service\\n    identifier {\\n      sunsamaId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskGmailIntegration {\\n    service\\n    identifier {\\n      id\\n      messageId\\n      accountId\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskOutlookIntegration {\\n    service\\n    identifier {\\n      id\\n      internetMessageId\\n      conversationId\\n      accountId\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskSlackIntegration {\\n    service\\n    identifier {\\n      permalink\\n      notesMarkdown\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskNotionIntegration {\\n    service\\n    identifier {\\n      id\\n      workspaceId\\n      url\\n      deepUrl\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskClickUpIntegration {\\n    service\\n    identifier {\\n      id\\n      userId\\n      teamId\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskGitlabIntegration {\\n    service\\n    identifier {\\n      id\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskEmailIntegration {\\n    service\\n    identifier {\\n      id\\n      __typename\\n    }\\n    content {\\n      subject\\n      text\\n      html\\n      from {\\n        name\\n        email\\n        __typename\\n      }\\n      date\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskLinearIntegration {\\n    service\\n    identifier {\\n      id\\n      url\\n      identifier\\n      linearUserId\\n      linearOrganizationId\\n      number\\n      _version\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskMondayIntegration {\\n    service\\n    identifier {\\n      id\\n      boardId\\n      mondayAccountId\\n      url\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskWebsiteIntegration {\\n    service\\n    identifier {\\n      url\\n      private\\n      canonicalUrl\\n      description\\n      faviconUrl\\n      imageUrl\\n      siteName\\n      title\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskLoomVideoIntegration {\\n    service\\n    identifier {\\n      url\\n      videoId\\n      title\\n      description\\n      thumbnail {\\n        width\\n        height\\n        url\\n        __typename\\n      }\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskMicrosoftTeamsIntegration {\\n    service\\n    identifier {\\n      permalink\\n      notesMarkdown\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskAppleRemindersIntegration {\\n    service\\n    identifier {\\n      id\\n      listId\\n      autoImported\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskGoogleTasksIntegration {\\n    service\\n    identifier {\\n      id\\n      listId\\n      accountId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskMicrosoftToDoIntegration {\\n    service\\n    identifier {\\n      id\\n      listId\\n      accountId\\n      parentTaskId\\n      __typename\\n    }\\n    __typename\\n  }\\n  ... on TaskSunsamaTaskIntegration {\\n    service\\n    identifier {\\n      taskId\\n      groupId\\n      sunsamaUserId\\n      __typename\\n    }\\n    __typename\\n  }\\n  __typename\\n}\\n\\nfragment PartialTask on PartialTask {\\n  _id\\n  recommendedStreamId\\n  streamIds\\n  recommendedTimeEstimate\\n  subtasks {\\n    _id\\n    title\\n    completedDate\\n    completedBy\\n    timeEstimate\\n    actualTime {\\n      ...TaskActualTime\\n      __typename\\n    }\\n    snooze {\\n      userId\\n      date\\n      until\\n      __typename\\n    }\\n    scheduledTime {\\n      ...TaskScheduledTime\\n      __typename\\n    }\\n    integration {\\n      ...TaskIntegration\\n      __typename\\n    }\\n    mergedTaskId\\n    recommendedTimeEstimate\\n    __typename\\n  }\\n  __typename\\n}"}'

package/dist/main.js

@@ -16,7 +16,7 @@ if (transportConfig.transportType === "stdio") {
 }
 const server = new FastMCP({
     name: "Sunsama API Server",
-    version: "0.10.0",
+    version: "0.10.2",
     instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/dist/schemas.d.ts

@@ -145,34 +145,32 @@ export declare const updateTaskPlannedTimeSchema: z.ZodObject<{
     timeEstimateMinutes: number;
     limitResponsePayload?: boolean | undefined;
 }>;
-export declare const updateTaskNotesSchema: z.ZodIntersection<z.ZodObject<{
+export declare const updateTaskNotesSchema: z.ZodEffects<z.ZodObject<{
     taskId: z.ZodString;
+    html: z.ZodOptional<z.ZodString>;
+    markdown: z.ZodOptional<z.ZodString>;
     limitResponsePayload: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     taskId: string;
     limitResponsePayload?: boolean | undefined;
+    html?: string | undefined;
+    markdown?: string | undefined;
 }, {
     taskId: string;
     limitResponsePayload?: boolean | undefined;
-}>, z.ZodUnion<[z.ZodObject<{
-    html: z.ZodString;
-    markdown: z.ZodOptional<z.ZodNever>;
-}, "strip", z.ZodTypeAny, {
-    html: string;
-    markdown?: undefined;
-}, {
-    html: string;
-    markdown?: undefined;
-}>, z.ZodObject<{
-    markdown: z.ZodString;
-    html: z.ZodOptional<z.ZodNever>;
-}, "strip", z.ZodTypeAny, {
-    markdown: string;
-    html?: undefined;
+    html?: string | undefined;
+    markdown?: string | undefined;
+}>, {
+    taskId: string;
+    limitResponsePayload?: boolean | undefined;
+    html?: string | undefined;
+    markdown?: string | undefined;
 }, {
-    markdown: string;
-    html?: undefined;
-}>]>>;
+    taskId: string;
+    limitResponsePayload?: boolean | undefined;
+    html?: string | undefined;
+    markdown?: string | undefined;
+}>;
 /**
  * Response Type Schemas (for validation and documentation)
  */

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"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"}

package/dist/schemas.js

@@ -88,22 +88,21 @@ export const updateTaskPlannedTimeSchema = z.object({
     timeEstimateMinutes: z.number().int().min(0).describe("Time estimate in minutes (use 0 to clear the time estimate)"),
     limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size"),
 });
-// Update task notes base parameters (without content)
-const updateTaskNotesBaseSchema = z.object({
+// Update task notes parameters with XOR content validation
+export const updateTaskNotesSchema = z.object({
     taskId: z.string().min(1, "Task ID is required").describe("The ID of the task to update notes for"),
+    html: z.string().optional().describe("HTML content for the task notes (mutually exclusive with markdown)"),
+    markdown: z.string().optional().describe("Markdown content for the task notes (mutually exclusive with html)"),
     limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size (defaults to true)"),
+}).refine((data) => {
+    // Exactly one of html or markdown must be provided
+    const hasHtml = data.html !== undefined;
+    const hasMarkdown = data.markdown !== undefined;
+    return hasHtml !== hasMarkdown; // XOR: exactly one must be true
+}, {
+    message: "Exactly one of 'html' or 'markdown' must be provided",
+    path: [], // This will show the error at the root level
 });
-// Update task notes parameters with XOR content
-export const updateTaskNotesSchema = updateTaskNotesBaseSchema.and(z.union([
-    z.object({
-        html: z.string().describe("HTML content for the task notes"),
-        markdown: z.never().optional()
-    }),
-    z.object({
-        markdown: z.string().describe("Markdown content for the task notes"),
-        html: z.never().optional()
-    })
-]));
 /**
  * Response Type Schemas (for validation and documentation)
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-sunsama",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "MCP server for Sunsama API integration",
   "type": "module",
   "private": false,
@@ -26,7 +26,7 @@
     "@types/papaparse": "^5.3.16",
     "fastmcp": "3.3.1",
     "papaparse": "^5.5.3",
-    "sunsama-api": "0.8.0",
+    "sunsama-api": "0.8.1",
     "zod": "3.24.4"
   },
   "devDependencies": {

package/src/main.ts

@@ -35,7 +35,7 @@ if (transportConfig.transportType === "stdio") {
 
 const server = new FastMCP({
   name: "Sunsama API Server",
-  version: "0.10.0",
+  version: "0.10.2",
   instructions: `
 This MCP server provides access to the Sunsama API for task and project management.
 

package/src/schemas.ts

@@ -107,24 +107,23 @@ export const updateTaskPlannedTimeSchema = z.object({
   limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size"),
 });
 
-// Update task notes base parameters (without content)
-const updateTaskNotesBaseSchema = z.object({
+// Update task notes parameters with XOR content validation
+export const updateTaskNotesSchema = z.object({
   taskId: z.string().min(1, "Task ID is required").describe("The ID of the task to update notes for"),
+  html: z.string().optional().describe("HTML content for the task notes (mutually exclusive with markdown)"),
+  markdown: z.string().optional().describe("Markdown content for the task notes (mutually exclusive with html)"),
   limitResponsePayload: z.boolean().optional().describe("Whether to limit the response payload size (defaults to true)"),
-});
-
-// Update task notes parameters with XOR content
-export const updateTaskNotesSchema = updateTaskNotesBaseSchema.and(
-  z.union([
-    z.object({ 
-      html: z.string().describe("HTML content for the task notes"),
-      markdown: z.never().optional()
-    }),
-    z.object({ 
-      markdown: z.string().describe("Markdown content for the task notes"),
-      html: z.never().optional()
-    })
-  ])
+}).refine(
+  (data) => {
+    // Exactly one of html or markdown must be provided
+    const hasHtml = data.html !== undefined;
+    const hasMarkdown = data.markdown !== undefined;
+    return hasHtml !== hasMarkdown; // XOR: exactly one must be true
+  },
+  {
+    message: "Exactly one of 'html' or 'markdown' must be provided",
+    path: [], // This will show the error at the root level
+  }
 );
 
 /**