ask-marcel-office-cli 0.1.0 → 0.5.5

package/dist/commands.json

@@ -0,0 +1,1436 @@
+{
+  "package": "ask-marcel-office-cli",
+  "version": "0.5.5",
+  "generatedAt": "2026-05-01T04:20:27.291Z",
+  "commands": [
+    {
+      "name": "download-drive-item-version-content",
+      "summary": "Download the binary content of a specific *non-current* historical version of a OneDrive / SharePoint file. Graph refuses to serve the current version through this endpoint with \"You cannot get the content of the current version\" — for the current version use `download-onedrive-file-content` instead. Same envelope as that command (302 → downloadUrl, or base64 bytes).",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/versions/{version-id}/content",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitemversion-get-content",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Use `ask-marcel list-drives` for the personal OneDrive, or `ask-marcel list-sharepoint-site-drives --site-id <id>` for a SharePoint document library."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the file. Returned by `list-folder-files` or `search-onedrive-files`."
+        },
+        {
+          "name": "version-id",
+          "key": "versionId",
+          "required": true,
+          "description": "driveItemVersion ID. Returned by `ask-marcel list-drive-item-versions`. Use the `id` field of an entry under `value[]`. Pick a non-current version — the first entry (e.g. `12.0`) is the live file and Graph rejects this endpoint for it; use `value[1]` or older."
+        }
+      ],
+      "example": "ask-marcel download-drive-item-version-content --drive-id 'b!1234' --item-id '01ABC' --version-id '4.0'",
+      "responseShape": "`{ \"@microsoft.graph.downloadUrl\": \"...\" }` for the typical 302 case, or `{ contentType, size, base64 }` when Graph streams bytes directly"
+    },
+    {
+      "name": "download-onedrive-file-content",
+      "summary": "Download the binary content of a file stored in OneDrive / SharePoint. Graph normally returns a 302 redirect to a pre-signed CDN URL, surfaced as `@microsoft.graph.downloadUrl`; if it returns bytes directly they are base64-encoded for safe JSON output.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/content",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-get-content",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the file to download. Returned by `ask-marcel list-folder-files` or `search-onedrive-files`."
+        }
+      ],
+      "example": "ask-marcel download-onedrive-file-content --drive-id 'b!1234' --item-id '01ABC'",
+      "responseShape": "`{ \"@microsoft.graph.downloadUrl\": \"...\" }` for the typical 302 case, or `{ contentType, size, base64 }` when Graph streams bytes directly"
+    },
+    {
+      "name": "get-calendar-event",
+      "summary": "Fetch a single calendar event by ID from the signed-in user’s default calendar.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/events/{event-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/event-get",
+      "options": [
+        {
+          "name": "event-id",
+          "key": "eventId",
+          "required": true,
+          "description": "Microsoft Graph event ID. Returned by `ask-marcel list-calendar-events` in the `id` field of each event."
+        }
+      ],
+      "example": "ask-marcel get-calendar-event --event-id 'AAMkAGI2THVS...'",
+      "responseShape": "single Microsoft Graph `event` resource"
+    },
+    {
+      "name": "get-calendar-view",
+      "summary": "List the signed-in user’s default-calendar events with recurrence expanded into individual occurrences in a date range. Both ISO date-time params are required by Graph.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendarView?startDateTime={start-date-time}&endDateTime={end-date-time}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-calendarview",
+      "options": [
+        {
+          "name": "start-date-time",
+          "key": "startDateTime",
+          "required": true,
+          "description": "ISO 8601 lower bound (UTC). Example: `2026-04-01T00:00:00Z`. Required by Graph; the request fails without it."
+        },
+        {
+          "name": "end-date-time",
+          "key": "endDateTime",
+          "required": true,
+          "description": "ISO 8601 upper bound (UTC). Example: `2026-05-01T00:00:00Z`. Required by Graph; the request fails without it."
+        }
+      ],
+      "example": "ask-marcel get-calendar-view --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
+      "responseShape": "collection of Microsoft Graph `event` resources (single occurrences) under `value[]`"
+    },
+    {
+      "name": "get-current-user",
+      "summary": "Return the signed-in user’s Microsoft Graph profile (id, displayName, mail, jobTitle, etc.).",
+      "category": "user",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-get",
+      "options": [],
+      "example": "ask-marcel get-current-user",
+      "responseShape": "single Microsoft Graph `user` resource"
+    },
+    {
+      "name": "get-drive-delta",
+      "summary": "Get the incremental change set (added / modified / deleted items) under a OneDrive / SharePoint folder. Use the `@odata.deltaLink` from a previous response to resume.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/delta()",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-delta",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the folder whose subtree to track. Use the root folder ID from `get-drive-root-item` to track the entire drive."
+        }
+      ],
+      "example": "ask-marcel get-drive-delta --drive-id 'b!1234' --item-id '01ROOT'",
+      "responseShape": "collection of changed Microsoft Graph `driveItem` resources under `value[]` plus an `@odata.deltaLink` token"
+    },
+    {
+      "name": "get-drive-item",
+      "summary": "Get the metadata (driveItem resource) of a single file or folder in OneDrive / SharePoint.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-get",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID. Returned by `list-folder-files`, `search-onedrive-files`, or `get-drive-root-item`."
+        }
+      ],
+      "example": "ask-marcel get-drive-item --drive-id 'b!1234' --item-id '01ABC'",
+      "responseShape": "single Microsoft Graph `driveItem` resource"
+    },
+    {
+      "name": "get-drive-root-item",
+      "summary": "Get the root folder (driveItem) of a OneDrive / SharePoint drive.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/root",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-get",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives` in the `id` field."
+        }
+      ],
+      "example": "ask-marcel get-drive-root-item --drive-id 'b!1234'",
+      "responseShape": "single Microsoft Graph `driveItem` resource (the root folder)"
+    },
+    {
+      "name": "get-excel-range",
+      "summary": "Get the cell values, formulas, and formats of a specific Excel range (e.g. `A1:C10`).",
+      "category": "excel",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/workbook/worksheets/{worksheet-id}/range(address='{address}')",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/worksheet-range",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID containing the workbook. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the .xlsx file."
+        },
+        {
+          "name": "worksheet-id",
+          "key": "worksheetId",
+          "required": true,
+          "description": "Worksheet ID or worksheet name. Returned by `ask-marcel list-excel-worksheets`."
+        },
+        {
+          "name": "address",
+          "key": "address",
+          "required": true,
+          "description": "A1-style range address, e.g. `A1:C10` or a single cell like `B7`."
+        }
+      ],
+      "example": "ask-marcel get-excel-range --drive-id 'b!1234' --item-id '01XLSX' --worksheet-id 'Sheet1' --address 'A1:C10'",
+      "responseShape": "single Microsoft Graph `workbookRange` resource (values, formulas, format)"
+    },
+    {
+      "name": "get-excel-table",
+      "summary": "Get the metadata (style, header row, total row) of a single named Excel table.",
+      "category": "excel",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/workbooktable-get",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID containing the workbook. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the .xlsx file."
+        },
+        {
+          "name": "table-id",
+          "key": "tableId",
+          "required": true,
+          "description": "Workbook table ID or table name. Returned by `ask-marcel list-excel-tables`."
+        }
+      ],
+      "example": "ask-marcel get-excel-table --drive-id 'b!1234' --item-id '01XLSX' --table-id 'Table1'",
+      "responseShape": "single Microsoft Graph `workbookTable` resource"
+    },
+    {
+      "name": "get-mail-attachment",
+      "summary": "Get a single attachment on an Outlook message (metadata, plus the base64 `contentBytes` for file attachments).",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/messages/{message-id}/attachments/{attachment-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/attachment-get",
+      "options": [
+        {
+          "name": "message-id",
+          "key": "messageId",
+          "required": true,
+          "description": "Outlook message ID. Returned by `ask-marcel list-mail-messages`."
+        },
+        {
+          "name": "attachment-id",
+          "key": "attachmentId",
+          "required": true,
+          "description": "Attachment ID. Returned by `ask-marcel list-mail-attachments`."
+        }
+      ],
+      "example": "ask-marcel get-mail-attachment --message-id 'AAMkAGI2...' --attachment-id 'AAMkABC...'",
+      "responseShape": "single Microsoft Graph `attachment` resource"
+    },
+    {
+      "name": "get-mail-message",
+      "summary": "Get a single Outlook message by ID, including subject, sender, body, and flags.",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/messages/{message-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/message-get",
+      "options": [
+        {
+          "name": "message-id",
+          "key": "messageId",
+          "required": true,
+          "description": "Outlook message ID. Returned by `ask-marcel list-mail-messages` or `list-mail-folder-messages`."
+        }
+      ],
+      "example": "ask-marcel get-mail-message --message-id 'AAMkAGI2...'",
+      "responseShape": "single Microsoft Graph `message` resource"
+    },
+    {
+      "name": "get-mailbox-settings",
+      "summary": "Get the signed-in user’s Outlook mailbox settings (timezone, working hours, automatic replies).",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/mailboxSettings",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-get-mailboxsettings",
+      "options": [],
+      "example": "ask-marcel get-mailbox-settings",
+      "responseShape": "single Microsoft Graph `mailboxSettings` resource"
+    },
+    {
+      "name": "get-my-profile-photo",
+      "summary": "Download the signed-in user’s profile photo (largest available size). Returned as a base64 envelope so the binary survives JSON output.",
+      "category": "user",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/photo/$value",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/profilephoto-get",
+      "options": [],
+      "example": "ask-marcel get-my-profile-photo",
+      "responseShape": "`{ contentType: \"image/jpeg\", size: <bytes>, base64: \"<encoded>\" }` (or `{ \"@microsoft.graph.downloadUrl\": \"...\" }` when Graph returns a 302 redirect to a CDN URL)"
+    },
+    {
+      "name": "get-onenote-page-content",
+      "summary": "Get the HTML body of a single OneNote page. Returned in a JSON envelope so the HTML survives transport.",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/pages/{onenote-page-id}/content",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/page-get",
+      "options": [
+        {
+          "name": "onenote-page-id",
+          "key": "onenotePageId",
+          "required": true,
+          "description": "OneNote page ID. Returned by `ask-marcel list-onenote-section-pages`."
+        }
+      ],
+      "example": "ask-marcel get-onenote-page-content --onenote-page-id '1-abc...'",
+      "responseShape": "`{ contentType: \"text/html\", size: <chars>, text: \"<html>...\" }` — the rendered OneNote page body wrapped in a JSON envelope"
+    },
+    {
+      "name": "get-planner-bucket",
+      "summary": "Get the metadata of a single Microsoft Planner bucket (column / lane).",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/buckets/{planner-bucket-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannerbucket-get",
+      "options": [
+        {
+          "name": "planner-bucket-id",
+          "key": "plannerBucketId",
+          "required": true,
+          "description": "Planner bucket ID. Returned by `ask-marcel list-plan-buckets`."
+        }
+      ],
+      "example": "ask-marcel get-planner-bucket --planner-bucket-id 'sFNeQRFu_kqhxpwwAhmA15gAGfoT'",
+      "responseShape": "single Microsoft Graph `plannerBucket` resource"
+    },
+    {
+      "name": "get-planner-plan",
+      "summary": "Get the metadata of a single Microsoft Planner plan (title, owner group, container).",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/plans/{planner-plan-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannerplan-get",
+      "options": [
+        {
+          "name": "planner-plan-id",
+          "key": "plannerPlanId",
+          "required": true,
+          "description": "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel list-planner-tasks`."
+        }
+      ],
+      "example": "ask-marcel get-planner-plan --planner-plan-id 'xqQg5FS2LkCp935s-FIFm5gAB6'",
+      "responseShape": "single Microsoft Graph `plannerPlan` resource"
+    },
+    {
+      "name": "get-planner-task",
+      "summary": "Get the metadata of a single Microsoft Planner task (title, assignees, dates, completion).",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/tasks/{planner-task-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannertask-get",
+      "options": [
+        {
+          "name": "planner-task-id",
+          "key": "plannerTaskId",
+          "required": true,
+          "description": "Planner task ID. Returned by `ask-marcel list-planner-tasks` or `list-plan-tasks`."
+        }
+      ],
+      "example": "ask-marcel get-planner-task --planner-task-id '01tx7Ic7-USXEwt0lvR1cmgAH8gK'",
+      "responseShape": "single Microsoft Graph `plannerTask` resource"
+    },
+    {
+      "name": "get-planner-task-details",
+      "summary": "Get the rich details (description, checklist, references) of a Microsoft Planner task.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/tasks/{planner-task-id}/details",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannertaskdetails-get",
+      "options": [
+        {
+          "name": "planner-task-id",
+          "key": "plannerTaskId",
+          "required": true,
+          "description": "Planner task ID. Returned by `ask-marcel list-planner-tasks` or `list-plan-tasks`."
+        }
+      ],
+      "example": "ask-marcel get-planner-task-details --planner-task-id '01tx7Ic7-USXEwt0lvR1cmgAH8gK'",
+      "responseShape": "single Microsoft Graph `plannerTaskDetails` resource"
+    },
+    {
+      "name": "get-sharepoint-site",
+      "summary": "Get the metadata of a single SharePoint site by its site ID.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/site-get",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Either the composite ID (`hostname,site-collection-id,site-id`) returned by `ask-marcel search-sharepoint-sites`, or the literal `root` to refer to the tenant root site."
+        }
+      ],
+      "example": "ask-marcel get-sharepoint-site --site-id 'contoso.sharepoint.com,1234,5678'",
+      "responseShape": "single Microsoft Graph `site` resource"
+    },
+    {
+      "name": "get-sharepoint-site-by-path",
+      "summary": "Resolve a SharePoint site by its hostname + server-relative path. Use this when you have a SharePoint URL (e.g. `https://contoso.sharepoint.com/sites/Marketing`) but no site ID.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{hostname}:{path}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/site-get",
+      "options": [
+        {
+          "name": "hostname",
+          "key": "hostname",
+          "required": true,
+          "description": "SharePoint host, e.g. `contoso.sharepoint.com` (or `contoso-my.sharepoint.com` for personal sites). Take the host portion of your SharePoint URL."
+        },
+        {
+          "name": "path",
+          "key": "path",
+          "required": true,
+          "description": "Server-relative path starting with `/`, e.g. `/sites/Marketing` or `/teams/Marketing/Subsite`. Take the URL pathname after the hostname."
+        }
+      ],
+      "example": "ask-marcel get-sharepoint-site-by-path --hostname 'contoso.sharepoint.com' --path '/sites/Marketing'",
+      "responseShape": "single Microsoft Graph `site` resource"
+    },
+    {
+      "name": "get-sharepoint-site-drive-by-id",
+      "summary": "Get the metadata of a single document library (drive) on a SharePoint site by drive ID.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/drives/{drive-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/drive-get",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        },
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Drive (document library) ID on the site. Returned by `ask-marcel list-sharepoint-site-drives`."
+        }
+      ],
+      "example": "ask-marcel get-sharepoint-site-drive-by-id --site-id 'contoso.sharepoint.com,1234,5678' --drive-id 'b!abcd'",
+      "responseShape": "single Microsoft Graph `drive` resource"
+    },
+    {
+      "name": "get-sharepoint-site-list",
+      "summary": "Get the metadata (display name, template, columns) of a single SharePoint list.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/lists/{list-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/list-get",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        },
+        {
+          "name": "list-id",
+          "key": "listId",
+          "required": true,
+          "description": "SharePoint list ID or display name. Returned by `ask-marcel list-sharepoint-site-lists`."
+        }
+      ],
+      "example": "ask-marcel get-sharepoint-site-list --site-id 'contoso.sharepoint.com,1234,5678' --list-id 'Documents'",
+      "responseShape": "single Microsoft Graph `list` resource"
+    },
+    {
+      "name": "get-sharepoint-site-list-item",
+      "summary": "Get a single row (listItem) of a SharePoint list by ID.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/lists/{list-id}/items/{list-item-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/listitem-get",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        },
+        {
+          "name": "list-id",
+          "key": "listId",
+          "required": true,
+          "description": "SharePoint list ID or display name. Returned by `ask-marcel list-sharepoint-site-lists`."
+        },
+        {
+          "name": "list-item-id",
+          "key": "listItemId",
+          "required": true,
+          "description": "listItem ID (typically a small integer). Returned by `ask-marcel list-sharepoint-site-list-items`."
+        }
+      ],
+      "example": "ask-marcel get-sharepoint-site-list-item --site-id 'contoso.sharepoint.com,1234,5678' --list-id 'Tasks' --list-item-id '7'",
+      "responseShape": "single Microsoft Graph `listItem` resource"
+    },
+    {
+      "name": "get-specific-calendar-event",
+      "summary": "Fetch a single calendar event by ID from a specific (non-default) calendar.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendars/{calendar-id}/events/{event-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/event-get",
+      "options": [
+        {
+          "name": "calendar-id",
+          "key": "calendarId",
+          "required": true,
+          "description": "Calendar ID. Returned by `ask-marcel list-calendars`."
+        },
+        {
+          "name": "event-id",
+          "key": "eventId",
+          "required": true,
+          "description": "Event ID. Returned by `ask-marcel list-specific-calendar-events`."
+        }
+      ],
+      "example": "ask-marcel get-specific-calendar-event --calendar-id 'AAMkAGI2THVS...' --event-id 'AAMkABC...'",
+      "responseShape": "single Microsoft Graph `event` resource"
+    },
+    {
+      "name": "get-specific-calendar-view",
+      "summary": "List the events in a specific (non-default) calendar with recurrence expanded into individual occurrences in a date range. Both ISO date-time params are required by Graph.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendars/{calendar-id}/calendarView?startDateTime={start-date-time}&endDateTime={end-date-time}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/calendar-list-calendarview",
+      "options": [
+        {
+          "name": "calendar-id",
+          "key": "calendarId",
+          "required": true,
+          "description": "Calendar ID. Returned by `ask-marcel list-calendars`."
+        },
+        {
+          "name": "start-date-time",
+          "key": "startDateTime",
+          "required": true,
+          "description": "ISO 8601 lower bound (UTC). Example: `2026-04-01T00:00:00Z`. Required by Graph; the request fails without it."
+        },
+        {
+          "name": "end-date-time",
+          "key": "endDateTime",
+          "required": true,
+          "description": "ISO 8601 upper bound (UTC). Example: `2026-05-01T00:00:00Z`. Required by Graph; the request fails without it."
+        }
+      ],
+      "example": "ask-marcel get-specific-calendar-view --calendar-id 'AAMkAGI2THVS...' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
+      "responseShape": "collection of Microsoft Graph `event` resources (single occurrences) under `value[]`"
+    },
+    {
+      "name": "get-team",
+      "summary": "Get the metadata of a single Microsoft Team (display name, settings, member-settings, owner group).",
+      "category": "teams",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/teams/{team-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/team-get",
+      "options": [
+        {
+          "name": "team-id",
+          "key": "teamId",
+          "required": true,
+          "description": "Microsoft Teams team ID. Returned by `ask-marcel list-joined-teams`."
+        }
+      ],
+      "example": "ask-marcel get-team --team-id 'abc-1234-...'",
+      "responseShape": "single Microsoft Graph `team` resource"
+    },
+    {
+      "name": "get-team-channel",
+      "summary": "Get the metadata of a single channel inside a Microsoft Team.",
+      "category": "teams",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/teams/{team-id}/channels/{channel-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/channel-get",
+      "options": [
+        {
+          "name": "team-id",
+          "key": "teamId",
+          "required": true,
+          "description": "Microsoft Teams team ID. Returned by `ask-marcel list-joined-teams`."
+        },
+        {
+          "name": "channel-id",
+          "key": "channelId",
+          "required": true,
+          "description": "Channel ID. Returned by `ask-marcel list-team-channels`."
+        }
+      ],
+      "example": "ask-marcel get-team-channel --team-id 'abc-1234-...' --channel-id '19:def@thread.tacv2'",
+      "responseShape": "single Microsoft Graph `channel` resource"
+    },
+    {
+      "name": "get-todo-task",
+      "summary": "Get a single Microsoft To Do task by its ID and its parent list ID.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/todo/lists/{todo-task-list-id}/tasks/{todo-task-id}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/todotask-get",
+      "options": [
+        {
+          "name": "todo-task-list-id",
+          "key": "todoTaskListId",
+          "required": true,
+          "description": "To Do task list ID. Returned by `ask-marcel list-todo-task-lists`."
+        },
+        {
+          "name": "todo-task-id",
+          "key": "todoTaskId",
+          "required": true,
+          "description": "To Do task ID. Returned by `ask-marcel list-todo-tasks`."
+        }
+      ],
+      "example": "ask-marcel get-todo-task --todo-task-list-id 'AAMkAGI...' --todo-task-id 'AAMkABC...'",
+      "responseShape": "single Microsoft Graph `todoTask` resource"
+    },
+    {
+      "name": "list-all-onenote-sections",
+      "summary": "List every OneNote section the signed-in user can see, across all notebooks.",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/sections",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/onenote-list-sections",
+      "options": [],
+      "example": "ask-marcel list-all-onenote-sections",
+      "responseShape": "collection of Microsoft Graph `onenoteSection` resources under `value[]`"
+    },
+    {
+      "name": "list-calendar-event-instances",
+      "summary": "List the individual occurrences of a recurring calendar event over a date range. Both ISO date-time params are required by Graph.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendars/{calendar-id}/events/{event-id}/instances?startDateTime={start-date-time}&endDateTime={end-date-time}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/event-list-instances",
+      "options": [
+        {
+          "name": "calendar-id",
+          "key": "calendarId",
+          "required": true,
+          "description": "Calendar ID. Returned by `ask-marcel list-calendars`."
+        },
+        {
+          "name": "event-id",
+          "key": "eventId",
+          "required": true,
+          "description": "Recurring event ID. Returned by `ask-marcel list-specific-calendar-events`."
+        },
+        {
+          "name": "start-date-time",
+          "key": "startDateTime",
+          "required": true,
+          "description": "ISO 8601 lower bound (UTC). Example: `2026-04-01T00:00:00Z`. Required by Graph; the request fails without it."
+        },
+        {
+          "name": "end-date-time",
+          "key": "endDateTime",
+          "required": true,
+          "description": "ISO 8601 upper bound (UTC). Example: `2026-05-01T00:00:00Z`. Required by Graph; the request fails without it."
+        }
+      ],
+      "example": "ask-marcel list-calendar-event-instances --calendar-id 'AAMkAGI2THVS...' --event-id 'AAMkABC...' --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
+      "responseShape": "collection of Microsoft Graph `event` resources (single occurrences) under `value[]`"
+    },
+    {
+      "name": "list-calendar-events",
+      "summary": "List the events in the signed-in user’s default calendar (does not expand recurrences).",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/events",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-events",
+      "options": [],
+      "example": "ask-marcel list-calendar-events",
+      "responseShape": "collection of Microsoft Graph `event` resources under `value[]`"
+    },
+    {
+      "name": "list-calendar-events-delta",
+      "summary": "Get the incremental change set (added / modified / deleted events) for the signed-in user’s default calendar. Use the `@odata.deltaLink` from a previous response to resume.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/events/delta()",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/event-delta",
+      "options": [],
+      "example": "ask-marcel list-calendar-events-delta",
+      "responseShape": "collection of changed Microsoft Graph `event` resources under `value[]` plus an `@odata.deltaLink` token"
+    },
+    {
+      "name": "list-calendar-view-delta",
+      "summary": "Get the first page of the incremental change set of expanded calendar-view occurrences over a date range. Subsequent pages: feed the returned `@odata.nextLink` to `next-page`; resume later via the `@odata.deltaLink`.",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendarView/delta()?startDateTime={start-date-time}&endDateTime={end-date-time}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/event-delta",
+      "options": [
+        {
+          "name": "start-date-time",
+          "key": "startDateTime",
+          "required": true,
+          "description": "ISO 8601 lower bound (UTC). Required on the first call only — the deltaLink token encodes it for resumes."
+        },
+        {
+          "name": "end-date-time",
+          "key": "endDateTime",
+          "required": true,
+          "description": "ISO 8601 upper bound (UTC). Required on the first call only — the deltaLink token encodes it for resumes."
+        }
+      ],
+      "example": "ask-marcel list-calendar-view-delta --start-date-time '2026-04-01T00:00:00Z' --end-date-time '2026-05-01T00:00:00Z'",
+      "responseShape": "collection of changed Microsoft Graph `event` occurrences under `value[]` plus an `@odata.deltaLink` token"
+    },
+    {
+      "name": "list-calendars",
+      "summary": "List the calendars in the signed-in user’s mailbox (default + secondary calendars + shared calendars).",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendars",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-calendars",
+      "options": [],
+      "example": "ask-marcel list-calendars",
+      "responseShape": "collection of Microsoft Graph `calendar` resources under `value[]`"
+    },
+    {
+      "name": "list-chat-members",
+      "summary": "List the members of a single Microsoft Teams chat.",
+      "category": "chats",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/chats/{chat-id}/members",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/chat-list-members",
+      "options": [
+        {
+          "name": "chat-id",
+          "key": "chatId",
+          "required": true,
+          "description": "Microsoft Teams chat ID, e.g. `19:abc...@thread.v2`. This CLI does not list chats (the Teams web client token has no `Chat.Read*` scope), so the chat ID has to come from outside. Easiest source from inside this CLI: pick any Teams meeting from `list-calendar-events` and URL-decode the `19%3ameeting_...%40thread.v2` segment of its `onlineMeeting.joinUrl`. Other sources: the Teams desktop / web client (Open in browser → URL contains the chat thread ID), Microsoft Graph Explorer, or Power Automate."
+        }
+      ],
+      "example": "ask-marcel list-chat-members --chat-id '19:abc...@thread.v2'",
+      "responseShape": "collection of Microsoft Graph `conversationMember` resources under `value[]`"
+    },
+    {
+      "name": "list-drive-item-permissions",
+      "summary": "List the sharing permissions on a OneDrive / SharePoint file or folder.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/permissions",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-list-permissions",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the file or folder. Returned by `list-folder-files`, `search-onedrive-files`, or `get-drive-item`."
+        }
+      ],
+      "example": "ask-marcel list-drive-item-permissions --drive-id 'b!1234' --item-id '01ABC'",
+      "responseShape": "collection of Microsoft Graph `permission` resources under `value[]`"
+    },
+    {
+      "name": "list-drive-item-versions",
+      "summary": "List the historical versions of a OneDrive / SharePoint file (each save creates a new version).",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/versions",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-list-versions",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Use `ask-marcel list-drives` for the personal OneDrive, or `ask-marcel list-sharepoint-site-drives --site-id <id>` for a SharePoint document library."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the file. Returned by `list-folder-files` or `search-onedrive-files`."
+        }
+      ],
+      "example": "ask-marcel list-drive-item-versions --drive-id 'b!1234' --item-id '01ABC'",
+      "responseShape": "collection of Microsoft Graph `driveItemVersion` resources under `value[]`"
+    },
+    {
+      "name": "list-drives",
+      "summary": "List all OneDrive / SharePoint drives the signed-in user has access to.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/drives",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/drive-list",
+      "options": [],
+      "example": "ask-marcel list-drives",
+      "responseShape": "collection of Microsoft Graph `drive` resources under `value[]`"
+    },
+    {
+      "name": "list-excel-table-rows",
+      "summary": "List the data rows of a named Excel table (excluding the header row).",
+      "category": "excel",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/workbook/tables/{table-id}/rows",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/workbooktable-list-rows",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID containing the workbook. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the .xlsx file."
+        },
+        {
+          "name": "table-id",
+          "key": "tableId",
+          "required": true,
+          "description": "Workbook table ID or table name. Returned by `ask-marcel list-excel-tables`."
+        }
+      ],
+      "example": "ask-marcel list-excel-table-rows --drive-id 'b!1234' --item-id '01XLSX' --table-id 'Table1'",
+      "responseShape": "collection of Microsoft Graph `workbookTableRow` resources (each `values` is a 2D array) under `value[]`"
+    },
+    {
+      "name": "list-excel-tables",
+      "summary": "List the named tables across every worksheet in an Excel workbook.",
+      "category": "excel",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/workbook/tables",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/workbook-list-tables",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID containing the workbook. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the .xlsx file. Returned by `list-folder-files` or `search-onedrive-files`."
+        }
+      ],
+      "example": "ask-marcel list-excel-tables --drive-id 'b!1234' --item-id '01XLSX'",
+      "responseShape": "collection of Microsoft Graph `workbookTable` resources under `value[]`"
+    },
+    {
+      "name": "list-excel-worksheets",
+      "summary": "List the worksheets (tabs) inside an Excel workbook stored in OneDrive / SharePoint.",
+      "category": "excel",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/workbook/worksheets",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/workbook-list-worksheets",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID containing the workbook. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the .xlsx file. Returned by `list-folder-files` or `search-onedrive-files`."
+        }
+      ],
+      "example": "ask-marcel list-excel-worksheets --drive-id 'b!1234' --item-id '01XLSX'",
+      "responseShape": "collection of Microsoft Graph `worksheet` resources under `value[]`"
+    },
+    {
+      "name": "list-folder-files",
+      "summary": "List the children (files and subfolders) of a folder in OneDrive / SharePoint.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/items/{item-id}/children",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-list-children",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "item-id",
+          "key": "itemId",
+          "required": true,
+          "description": "driveItem ID of the folder. Use the root folder ID from `ask-marcel get-drive-root-item` to list the top of a drive."
+        }
+      ],
+      "example": "ask-marcel list-folder-files --drive-id 'b!1234' --item-id '01ROOT'",
+      "responseShape": "collection of Microsoft Graph `driveItem` resources under `value[]`"
+    },
+    {
+      "name": "list-incomplete-planner-tasks",
+      "summary": "List every incomplete Microsoft Planner task assigned to or owned by the signed-in user, across every plan.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/planner/tasks?$filter=percentComplete ne 100",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/planneruser-list-tasks",
+      "options": [],
+      "example": "ask-marcel list-incomplete-planner-tasks",
+      "responseShape": "collection of Microsoft Graph `plannerTask` resources under `value[]` where `percentComplete < 100`"
+    },
+    {
+      "name": "list-incomplete-todo-tasks",
+      "summary": "List every incomplete Microsoft To Do task in a given list (status not equal to `completed`).",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/todo/lists/{todo-task-list-id}/tasks?$filter=status ne 'completed'",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/todotasklist-list-tasks",
+      "options": [
+        {
+          "name": "todo-task-list-id",
+          "key": "todoTaskListId",
+          "required": true,
+          "description": "todoTaskList ID. Returned by `ask-marcel list-todo-task-lists`. Well-known names also work, e.g. `tasks` for the default list. There is no Graph endpoint that returns incomplete tasks across every list — call this once per list."
+        }
+      ],
+      "example": "ask-marcel list-incomplete-todo-tasks --todo-task-list-id 'tasks'",
+      "responseShape": "collection of Microsoft Graph `todoTask` resources under `value[]` where `status != \"completed\"`"
+    },
+    {
+      "name": "list-joined-teams",
+      "summary": "List the Microsoft Teams the signed-in user is a member of.",
+      "category": "teams",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/joinedTeams",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-joinedteams",
+      "options": [],
+      "example": "ask-marcel list-joined-teams",
+      "responseShape": "collection of Microsoft Graph `team` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-attachments",
+      "summary": "List the attachments (file, item, reference) on a single Outlook message.",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/messages/{message-id}/attachments",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/message-list-attachments",
+      "options": [
+        {
+          "name": "message-id",
+          "key": "messageId",
+          "required": true,
+          "description": "Outlook message ID. Returned by `ask-marcel list-mail-messages` or `list-mail-folder-messages`."
+        }
+      ],
+      "example": "ask-marcel list-mail-attachments --message-id 'AAMkAGI2...'",
+      "responseShape": "collection of Microsoft Graph `attachment` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-child-folders",
+      "summary": "List the subfolders of a single Outlook mail folder (e.g. subfolders of Inbox).",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/mailFolders/{mail-folder-id}/childFolders",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/mailfolder-list-childfolders",
+      "options": [
+        {
+          "name": "mail-folder-id",
+          "key": "mailFolderId",
+          "required": true,
+          "description": "mailFolder ID. Returned by `ask-marcel list-mail-folders`. Well-known names also work, e.g. `inbox`, `sentitems`, `drafts`."
+        }
+      ],
+      "example": "ask-marcel list-mail-child-folders --mail-folder-id 'inbox'",
+      "responseShape": "collection of Microsoft Graph `mailFolder` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-folder-messages",
+      "summary": "List the messages inside a specific Outlook mail folder (Inbox, custom folder, etc.).",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/mailFolders/{mail-folder-id}/messages",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/mailfolder-list-messages",
+      "options": [
+        {
+          "name": "mail-folder-id",
+          "key": "mailFolderId",
+          "required": true,
+          "description": "mailFolder ID. Returned by `ask-marcel list-mail-folders`. Well-known names also work, e.g. `inbox`, `sentitems`, `drafts`."
+        }
+      ],
+      "example": "ask-marcel list-mail-folder-messages --mail-folder-id 'inbox'",
+      "responseShape": "collection of Microsoft Graph `message` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-folders",
+      "summary": "List the top-level mail folders in the signed-in user’s Outlook mailbox (Inbox, Sent Items, etc.).",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/mailFolders",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-mailfolders",
+      "options": [],
+      "example": "ask-marcel list-mail-folders",
+      "responseShape": "collection of Microsoft Graph `mailFolder` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-messages",
+      "summary": "List the most recent messages from across the signed-in user’s entire Outlook mailbox (every folder including Sent, Archive, Junk; default sort `receivedDateTime` desc). Use `list-mail-folder-messages` to scope to a single folder such as Inbox.",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/messages",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-messages",
+      "options": [],
+      "example": "ask-marcel list-mail-messages",
+      "responseShape": "collection of Microsoft Graph `message` resources under `value[]`"
+    },
+    {
+      "name": "list-mail-rules",
+      "summary": "List the inbox / folder rules attached to a single Outlook mail folder.",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/mailFolders/{mail-folder-id}/messageRules",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/mailfolder-list-messagerules",
+      "options": [
+        {
+          "name": "mail-folder-id",
+          "key": "mailFolderId",
+          "required": true,
+          "description": "mailFolder ID. Returned by `ask-marcel list-mail-folders`. Well-known names also work, e.g. `inbox`."
+        }
+      ],
+      "example": "ask-marcel list-mail-rules --mail-folder-id 'inbox'",
+      "responseShape": "collection of Microsoft Graph `messageRule` resources under `value[]`"
+    },
+    {
+      "name": "list-onenote-notebook-sections",
+      "summary": "List the top-level sections of a single OneNote notebook (flat — does NOT recurse into section groups; use `list-all-onenote-sections` to flatten every notebook the user has access to).",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/notebooks/{notebook-id}/sections",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/notebook-list-sections",
+      "options": [
+        {
+          "name": "notebook-id",
+          "key": "notebookId",
+          "required": true,
+          "description": "OneNote notebook ID. Returned by `ask-marcel list-onenote-notebooks`."
+        }
+      ],
+      "example": "ask-marcel list-onenote-notebook-sections --notebook-id '1-12abc...'",
+      "responseShape": "collection of Microsoft Graph `onenoteSection` resources under `value[]`"
+    },
+    {
+      "name": "list-onenote-notebooks",
+      "summary": "List the OneNote notebooks the signed-in user owns or has access to (sorted by `createdDateTime` desc by Graph; soft-deleted notebooks excluded).",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/notebooks",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/onenote-list-notebooks",
+      "options": [],
+      "example": "ask-marcel list-onenote-notebooks",
+      "responseShape": "collection of Microsoft Graph `notebook` resources under `value[]`"
+    },
+    {
+      "name": "list-onenote-section-pages",
+      "summary": "List the pages inside a single OneNote section.",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/sections/{onenote-section-id}/pages",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/section-list-pages",
+      "options": [
+        {
+          "name": "onenote-section-id",
+          "key": "onenoteSectionId",
+          "required": true,
+          "description": "OneNote section ID. Returned by `ask-marcel list-onenote-notebook-sections` or `list-all-onenote-sections`."
+        }
+      ],
+      "example": "ask-marcel list-onenote-section-pages --onenote-section-id '1-abc...'",
+      "responseShape": "collection of Microsoft Graph `onenotePage` resources under `value[]`"
+    },
+    {
+      "name": "list-plan-buckets",
+      "summary": "List the buckets (columns / lanes) of a Microsoft Planner plan.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/plans/{planner-plan-id}/buckets",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannerplan-list-buckets",
+      "options": [
+        {
+          "name": "planner-plan-id",
+          "key": "plannerPlanId",
+          "required": true,
+          "description": "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel list-planner-tasks`."
+        }
+      ],
+      "example": "ask-marcel list-plan-buckets --planner-plan-id 'xqQg5FS2LkCp935s-FIFm5gAB6'",
+      "responseShape": "collection of Microsoft Graph `plannerBucket` resources under `value[]`"
+    },
+    {
+      "name": "list-plan-tasks",
+      "summary": "List every task within a Microsoft Planner plan, regardless of completion status (Graph orders by `orderHint`). Use `list-incomplete-planner-tasks` for the across-plans incomplete view.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/planner/plans/{planner-plan-id}/tasks",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/plannerplan-list-tasks",
+      "options": [
+        {
+          "name": "planner-plan-id",
+          "key": "plannerPlanId",
+          "required": true,
+          "description": "Planner plan ID. Returned in the `planId` field of any task from `ask-marcel list-planner-tasks`."
+        }
+      ],
+      "example": "ask-marcel list-plan-tasks --planner-plan-id 'xqQg5FS2LkCp935s-FIFm5gAB6'",
+      "responseShape": "collection of Microsoft Graph `plannerTask` resources under `value[]`"
+    },
+    {
+      "name": "list-planner-plans",
+      "summary": "List every Microsoft Planner plan the signed-in user has access to (across every group). Use this to discover plan IDs without needing an existing task as the entry point.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/planner/plans",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/planneruser-list-plans",
+      "options": [],
+      "example": "ask-marcel list-planner-plans",
+      "responseShape": "collection of Microsoft Graph `plannerPlan` resources under `value[]`"
+    },
+    {
+      "name": "list-planner-tasks",
+      "summary": "List every Microsoft Planner task assigned to or owned by the signed-in user, across all plans.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/planner/tasks",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/planneruser-list-tasks",
+      "options": [],
+      "example": "ask-marcel list-planner-tasks",
+      "responseShape": "collection of Microsoft Graph `plannerTask` resources under `value[]`"
+    },
+    {
+      "name": "list-sharepoint-site-drives",
+      "summary": "List the document libraries (drives) attached to a SharePoint site.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/drives",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/drive-list",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        }
+      ],
+      "example": "ask-marcel list-sharepoint-site-drives --site-id 'contoso.sharepoint.com,1234,5678'",
+      "responseShape": "collection of Microsoft Graph `drive` resources under `value[]`"
+    },
+    {
+      "name": "list-sharepoint-site-list-items",
+      "summary": "List the rows (listItem resources) of a single SharePoint list.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/lists/{list-id}/items",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/listitem-list",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        },
+        {
+          "name": "list-id",
+          "key": "listId",
+          "required": true,
+          "description": "SharePoint list ID or display name. Returned by `ask-marcel list-sharepoint-site-lists`."
+        }
+      ],
+      "example": "ask-marcel list-sharepoint-site-list-items --site-id 'contoso.sharepoint.com,1234,5678' --list-id 'Tasks'",
+      "responseShape": "collection of Microsoft Graph `listItem` resources under `value[]`"
+    },
+    {
+      "name": "list-sharepoint-site-lists",
+      "summary": "List all SharePoint lists (custom + built-in document libraries) on a site.",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites/{site-id}/lists",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/list-list",
+      "options": [
+        {
+          "name": "site-id",
+          "key": "siteId",
+          "required": true,
+          "description": "SharePoint site ID. Returned by `ask-marcel search-sharepoint-sites`."
+        }
+      ],
+      "example": "ask-marcel list-sharepoint-site-lists --site-id 'contoso.sharepoint.com,1234,5678'",
+      "responseShape": "collection of Microsoft Graph `list` resources under `value[]`"
+    },
+    {
+      "name": "list-specific-calendar-events",
+      "summary": "List the events in a specific (non-default) calendar (does not expand recurrences).",
+      "category": "calendar",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/calendars/{calendar-id}/events",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/calendar-list-events",
+      "options": [
+        {
+          "name": "calendar-id",
+          "key": "calendarId",
+          "required": true,
+          "description": "Calendar ID. Returned by `ask-marcel list-calendars`."
+        }
+      ],
+      "example": "ask-marcel list-specific-calendar-events --calendar-id 'AAMkAGI2THVS...'",
+      "responseShape": "collection of Microsoft Graph `event` resources under `value[]`"
+    },
+    {
+      "name": "list-team-channels",
+      "summary": "List the channels (standard, private, shared) inside a single Microsoft Team.",
+      "category": "teams",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/teams/{team-id}/channels",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/channel-list",
+      "options": [
+        {
+          "name": "team-id",
+          "key": "teamId",
+          "required": true,
+          "description": "Microsoft Teams team ID. Returned by `ask-marcel list-joined-teams`."
+        }
+      ],
+      "example": "ask-marcel list-team-channels --team-id 'abc-1234-...'",
+      "responseShape": "collection of Microsoft Graph `channel` resources under `value[]`"
+    },
+    {
+      "name": "list-todo-linked-resources",
+      "summary": "List the linked resources (URLs, emails, files) attached to a Microsoft To Do task.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/todo/lists/{todo-task-list-id}/tasks/{todo-task-id}/linkedResources",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/todotask-list-linkedresources",
+      "options": [
+        {
+          "name": "todo-task-list-id",
+          "key": "todoTaskListId",
+          "required": true,
+          "description": "To Do task list ID. Returned by `ask-marcel list-todo-task-lists`."
+        },
+        {
+          "name": "todo-task-id",
+          "key": "todoTaskId",
+          "required": true,
+          "description": "To Do task ID. Returned by `ask-marcel list-todo-tasks`."
+        }
+      ],
+      "example": "ask-marcel list-todo-linked-resources --todo-task-list-id 'AAMkAGI...' --todo-task-id 'AAMkABC...'",
+      "responseShape": "collection of Microsoft Graph `linkedResource` resources under `value[]`"
+    },
+    {
+      "name": "list-todo-task-lists",
+      "summary": "List the signed-in user’s Microsoft To Do task lists (e.g. `Tasks`, `Flagged Emails`, custom lists).",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/todo/lists",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/todo-list-lists",
+      "options": [],
+      "example": "ask-marcel list-todo-task-lists",
+      "responseShape": "collection of Microsoft Graph `todoTaskList` resources under `value[]`"
+    },
+    {
+      "name": "list-todo-tasks",
+      "summary": "List every task in a single Microsoft To Do task list, regardless of completion status. Use `list-incomplete-todo-tasks` if you only want the open ones.",
+      "category": "tasks",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/todo/lists/{todo-task-list-id}/tasks",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/todotasklist-list-tasks",
+      "options": [
+        {
+          "name": "todo-task-list-id",
+          "key": "todoTaskListId",
+          "required": true,
+          "description": "To Do task list ID. Returned by `ask-marcel list-todo-task-lists`."
+        }
+      ],
+      "example": "ask-marcel list-todo-tasks --todo-task-list-id 'AAMkAGI...'",
+      "responseShape": "collection of Microsoft Graph `todoTask` resources under `value[]`"
+    },
+    {
+      "name": "next-page",
+      "summary": "Fetch the next page of a paginated Graph response. Pass the `@odata.nextLink` value returned by any list / search / delta command to walk pagination yourself.",
+      "category": "meta",
+      "graphMethod": "GET",
+      "graphPathTemplate": "{url}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/paging",
+      "options": [
+        {
+          "name": "url",
+          "key": "url",
+          "required": true,
+          "description": "Full Graph v1.0 URL — copy the `@odata.nextLink` field from the previous response. Example: `https://graph.microsoft.com/v1.0/me/messages?$skiptoken=AKDsfg...`. Loop: keep calling until the response no longer contains `@odata.nextLink`. Also handles `@odata.deltaLink` if you want to resume a delta query."
+        }
+      ],
+      "example": "ask-marcel next-page --url 'https://graph.microsoft.com/v1.0/me/messages?$skip=10'",
+      "responseShape": "same shape as the originating endpoint (typically `{ value: [...], \"@odata.nextLink\": \"...\" }`)"
+    },
+    {
+      "name": "search-mail-messages",
+      "summary": "Search the signed-in user’s entire Outlook mailbox using KQL or free text. Results are ranked by Graph relevance.",
+      "category": "mail",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/messages?$search=\"{query}\"",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/user-list-messages",
+      "options": [
+        {
+          "name": "query",
+          "key": "query",
+          "required": true,
+          "description": "KQL or free-text query. Searches subject, body, sender, and recipients. Examples: `Q3 budget`, `from:alice@contoso.com`, `subject:invoice received>=2026-01-01`."
+        }
+      ],
+      "example": "ask-marcel search-mail-messages --query 'from:alice subject:Q3'",
+      "responseShape": "collection of Microsoft Graph `message` resources under `value[]`, ranked by relevance"
+    },
+    {
+      "name": "search-my-documents",
+      "summary": "Search the signed-in user’s default OneDrive for documents matching a free-text query (filename, content, metadata).",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/drive/search(q='{query}')",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-search",
+      "options": [
+        {
+          "name": "query",
+          "key": "query",
+          "required": true,
+          "description": "Free-text search query. Matches filename, content, and metadata across the user’s personal OneDrive. Use `search-onedrive-files --drive-id <id>` instead to target a specific shared SharePoint or OneDrive drive by ID."
+        }
+      ],
+      "example": "ask-marcel search-my-documents --query 'q1 budget'",
+      "responseShape": "collection of Microsoft Graph `driveItem` resources under `value[]`"
+    },
+    {
+      "name": "search-onedrive-files",
+      "summary": "Search a single OneDrive / SharePoint drive for files and folders matching a free-text query.",
+      "category": "drive",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/drives/{drive-id}/search(q='{query}')",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/driveitem-search",
+      "options": [
+        {
+          "name": "drive-id",
+          "key": "driveId",
+          "required": true,
+          "description": "Microsoft Graph drive ID to search inside. Returned by `ask-marcel list-drives`."
+        },
+        {
+          "name": "query",
+          "key": "query",
+          "required": true,
+          "description": "Free-text search query. Matches filename, content, and metadata."
+        }
+      ],
+      "example": "ask-marcel search-onedrive-files --drive-id 'b!1234' --query 'q1 budget'",
+      "responseShape": "collection of Microsoft Graph `driveItem` resources under `value[]`"
+    },
+    {
+      "name": "search-onenote-pages",
+      "summary": "Find OneNote pages whose title contains a substring (case-sensitive — page content is NOT searched). Microsoft removed full-text OneNote `?search=` from v1.0 Graph; only $filter against `title` remains, which is what this command runs.",
+      "category": "notes",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/me/onenote/pages?$filter=contains(title,'{title-substring}')",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/onenote-list-pages",
+      "options": [
+        {
+          "name": "title-substring",
+          "key": "titleSubstring",
+          "required": true,
+          "description": "Substring to look for inside OneNote page titles (case-sensitive, exact substring). This is title-only — full-text body search is not available on OneNote pages in v1.0 Graph. Use `list-onenote-section-pages` if you already know the section."
+        }
+      ],
+      "example": "ask-marcel search-onenote-pages --title-substring 'meeting notes'",
+      "responseShape": "collection of Microsoft Graph `onenotePage` resources under `value[]` whose title contains the substring"
+    },
+    {
+      "name": "search-sharepoint-sites",
+      "summary": "List the SharePoint sites the signed-in user has access to (returns the followed sites by default).",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/site-search",
+      "options": [],
+      "example": "ask-marcel search-sharepoint-sites",
+      "responseShape": "collection of Microsoft Graph `site` resources under `value[]`"
+    },
+    {
+      "name": "search-sharepoint-sites-by-name",
+      "summary": "Search the tenant for SharePoint sites whose display name or description matches a free-text query (returns up to 25).",
+      "category": "sharepoint",
+      "graphMethod": "GET",
+      "graphPathTemplate": "/sites?search={query}",
+      "graphDocsUrl": "https://learn.microsoft.com/en-us/graph/api/site-search",
+      "options": [
+        {
+          "name": "query",
+          "key": "query",
+          "required": true,
+          "description": "Free-text query. Matches site display name and description across the tenant. Use `search-sharepoint-sites` (no query) to instead list the sites the signed-in user follows."
+        }
+      ],
+      "example": "ask-marcel search-sharepoint-sites-by-name --query 'marketing'",
+      "responseShape": "collection of Microsoft Graph `site` resources under `value[]` (up to 25)"
+    }
+  ]
+}