@commandable/mcp 0.10.0 → 0.12.0

package/.output/server/chunks/nitro/nitro.mjs

@@ -4431,7 +4431,7 @@ function _expandFromEnv(value) {
 const _inlineRuntimeConfig = {
   "app": {
     "baseURL": "/",
-    "buildId": "0857a55b-f766-4fe6-86be-9bd9d857861a",
+    "buildId": "886deef4-f3b5-464c-b4e2-11735eb5272e",
     "buildAssetsDir": "/_nuxt/",
     "cdnURL": ""
   },
@@ -5034,7 +5034,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": null,
+    "usageGuide": null,
     "variants": {
       "variants": {
         "personal_access_token": {
@@ -5480,7 +5480,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": '# Confluence usage guide\n\n## Recommended workflow\n\n1. Use `list_spaces` (or `search_pages`) to discover where content lives.\n2. Use `search_pages` with CQL to find the right page ID(s).\n3. Use `read_page` to get the page content as Confluence storage format (XHTML).\n4. For edits, use `update_page` with storage XHTML in `bodyStorage` (it automatically handles version increments).\n\n## Content format\n\nAll content is exchanged in **Confluence storage format (XHTML)**. This applies to both reads (`contentStorage` field in `read_page`) and writes (`bodyStorage` field in `create_page`, `update_page`, `add_comment`).\n\nCommon markup:\n\n- Headings: `<h1>Title</h1>`, `<h2>Section</h2>`\n- Paragraphs: `<p>Text</p>`\n- Lists: `<ul><li>Item</li></ul>`, `<ol><li>Item</li></ol>`\n- Inline code: `<code>const x = 1</code>`\n- Code blocks: `<pre><code>...</code></pre>`\n- Links: `<a href="https://example.com">Example</a>`\n- Tables: `<table><tr><th>A</th></tr><tr><td>1</td></tr></table>`\n- Macros: `<ac:structured-macro ac:name="info"><ac:rich-text-body><p>Note</p></ac:rich-text-body></ac:structured-macro>`\n\nUsing XHTML natively means round-tripping pages preserves all formatting, macros, and Confluence-specific markup.\n\n`read_page` accepts `outputMarkdown: true` to return content as Markdown instead of XHTML. \n\n## CQL (Confluence Query Language) quick reference\n\nCommon patterns for `search_pages.cql`:\n\n- Restrict to a space:\n  - `space = "ENG" AND type = page`\n- Title match:\n  - `title ~ "runbook" AND type = page`\n- Full-text match:\n  - `text ~ "oncall" AND type = page`\n- Label match:\n  - `label = "runbook" AND type = page`\n- Combine filters:\n  - `space = "ENG" AND type = page AND (title ~ "onboarding" OR text ~ "onboarding")`\n- Sort:\n  - `... ORDER BY lastmodified DESC`\n\nTips:\n- Prefer small `limit` (e.g. 10) and paginate with `start`.\n- Use labels as a stable way to group pages for later discovery.\n\n## Page hierarchy\n\n- Spaces contain pages.\n- Pages can be nested under a parent page (`parentId`).\n- Use `get_page_children` to traverse a documentation tree (e.g. a handbook or runbook index).\n\n',
+    "usageGuide": '# Confluence usage guide\n\n## Recommended workflow\n\n1. Use `list_spaces` (or `search_pages`) to discover where content lives.\n2. Use `search_pages` with CQL to find the right page ID(s).\n3. Use `read_page` to get the page content as Confluence storage format (XHTML).\n4. For edits, use `update_page` with storage XHTML in `bodyStorage` (it automatically handles version increments).\n\n## Content format\n\nAll content is exchanged in **Confluence storage format (XHTML)**. This applies to both reads (`contentStorage` field in `read_page`) and writes (`bodyStorage` field in `create_page`, `update_page`, `add_comment`).\n\nCommon markup:\n\n- Headings: `<h1>Title</h1>`, `<h2>Section</h2>`\n- Paragraphs: `<p>Text</p>`\n- Lists: `<ul><li>Item</li></ul>`, `<ol><li>Item</li></ol>`\n- Inline code: `<code>const x = 1</code>`\n- Code blocks: `<pre><code>...</code></pre>`\n- Links: `<a href="https://example.com">Example</a>`\n- Tables: `<table><tr><th>A</th></tr><tr><td>1</td></tr></table>`\n- Macros: `<ac:structured-macro ac:name="info"><ac:rich-text-body><p>Note</p></ac:rich-text-body></ac:structured-macro>`\n\nUsing XHTML natively means round-tripping pages preserves all formatting, macros, and Confluence-specific markup.\n\n`read_page` accepts `outputMarkdown: true` to return content as Markdown instead of XHTML. \n\n## CQL (Confluence Query Language) quick reference\n\nCommon patterns for `search_pages.cql`:\n\n- Restrict to a space:\n  - `space = "ENG" AND type = page`\n- Title match:\n  - `title ~ "runbook" AND type = page`\n- Full-text match:\n  - `text ~ "oncall" AND type = page`\n- Label match:\n  - `label = "runbook" AND type = page`\n- Combine filters:\n  - `space = "ENG" AND type = page AND (title ~ "onboarding" OR text ~ "onboarding")`\n- Sort:\n  - `... ORDER BY lastmodified DESC`\n\nTips:\n- Prefer small `limit` (e.g. 10) and paginate with `start`.\n- Use labels as a stable way to group pages for later discovery.\n\n## Page hierarchy\n\n- Spaces contain pages.\n- Pages can be nested under a parent page (`parentId`).\n- Use `get_page_children` to traverse a documentation tree (e.g. a handbook or runbook index).\n\n',
     "variants": {
       "variants": {
         "api_token": {
@@ -6381,7 +6381,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": "# GitHub coding workflow\n\n## Branch-based workflow\n\nAlways work on a feature branch, never commit directly to main:\n\n1. `create_branch` from the default branch\n2. Make changes with `edit_file`, `edit_files`, `create_file`, or `delete_file` -- each call auto-commits to the branch\n3. `create_pull_request` when done\n4. `merge_pull_request` with `merge_method: \"squash\"` to collapse all commits into one clean commit on main\n\nMultiple small commits on a feature branch are fine -- they get squash-merged into a single commit.\n\n## Choosing the right write tool\n\n- **`edit_file`** -- Surgical edits to a single existing file. Use for most code changes. Each call is a commit.\n- **`edit_files`** -- Atomic multi-file changes (create + edit + delete in one commit). Use when files must change together to stay consistent (e.g. renaming across files, adding a module + updating imports).\n- **`create_file`** -- Create a new file or completely replace an existing file's content. Use for new files or full rewrites.\n- **`delete_file`** -- Remove a file.\n\n## Search/replace rules for edit_file and edit_files\n\nThe `old_text` field must be an **exact match** of the text currently in the file:\n\n- Whitespace matters: spaces, tabs, and indentation must match exactly\n- Line breaks matter: include the exact newline characters\n- Include enough surrounding context to uniquely identify the location\n- Each edit replaces the **first occurrence** only. To replace multiple occurrences, use separate edits.\n\n**Before editing**, call `get_file_contents` to see the file's current content. This avoids failed edits from stale or incorrect assumptions about file content.\n\n## Reading before writing\n\n- Use `get_repo_tree` to discover the project structure and file paths\n- Use `get_file_contents` to read a file before editing it\n- Use `search_code` to find where something is defined or used across the repo\n",
+    "usageGuide": "# GitHub coding workflow\n\n## Branch-based workflow\n\nAlways work on a feature branch, never commit directly to main:\n\n1. `create_branch` from the default branch\n2. Make changes with `edit_file`, `edit_files`, `create_file`, or `delete_file` -- each call auto-commits to the branch\n3. `create_pull_request` when done\n4. `merge_pull_request` with `merge_method: \"squash\"` to collapse all commits into one clean commit on main\n\nMultiple small commits on a feature branch are fine -- they get squash-merged into a single commit.\n\n## Choosing the right write tool\n\n- **`edit_file`** -- Surgical edits to a single existing file. Use for most code changes. Each call is a commit.\n- **`edit_files`** -- Atomic multi-file changes (create + edit + delete in one commit). Use when files must change together to stay consistent (e.g. renaming across files, adding a module + updating imports).\n- **`create_file`** -- Create a new file or completely replace an existing file's content. Use for new files or full rewrites.\n- **`delete_file`** -- Remove a file.\n\n## Search/replace rules for edit_file and edit_files\n\nThe `old_text` field must be an **exact match** of the text currently in the file:\n\n- Whitespace matters: spaces, tabs, and indentation must match exactly\n- Line breaks matter: include the exact newline characters\n- Include enough surrounding context to uniquely identify the location\n- Each edit replaces the **first occurrence** only. To replace multiple occurrences, use separate edits.\n\n**Before editing**, call `get_file_contents` to see the file's current content. This avoids failed edits from stale or incorrect assumptions about file content.\n\n## Reading before writing\n\n- Use `get_repo_tree` to discover the project structure and file paths\n- Use `get_file_contents` to read a file before editing it\n- Use `search_code` to find where something is defined or used across the repo\n",
     "variants": {
       "variants": {
         "classic_pat": {
@@ -8436,7 +8436,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": '## Calendar IDs\n\n- Use `calendarId=\'primary\'` for the authenticated user\'s main calendar\n- Use `list_calendars` to discover other calendar IDs (work, shared, subscribed calendars)\n- Calendar IDs typically look like email addresses (e.g. `user@example.com`) or opaque strings for subscribed calendars\n\n## Date and time format\n\nAll times must be in RFC3339 format:\n- Timed events: `\'2024-01-15T10:00:00-05:00\'` (with timezone offset) or `\'2024-01-15T15:00:00Z\'` (UTC)\n- All-day events use date-only format: `\'2024-01-15\'`\n\n## Creating events\n\nFor `create_event`, required fields are `calendarId`, `summary`, `start`, and `end`:\n\n**Timed event:**\n```json\n{\n  "calendarId": "primary",\n  "summary": "Team Meeting",\n  "start": { "dateTime": "2024-01-15T10:00:00", "timeZone": "America/New_York" },\n  "end":   { "dateTime": "2024-01-15T11:00:00", "timeZone": "America/New_York" }\n}\n```\n\n**All-day event:**\n```json\n{\n  "calendarId": "primary",\n  "summary": "Company Holiday",\n  "start": { "date": "2024-01-15" },\n  "end":   { "date": "2024-01-16" }\n}\n```\n\nNote: For all-day events, `end.date` should be the day *after* the last day (exclusive end).\n\n## Listing events in chronological order\n\nTo list upcoming events in start-time order (e.g. "what\'s on my calendar this week"):\n- Set `singleEvents=true` to expand recurring events into individual instances\n- Set `orderBy=\'startTime\'` (requires `singleEvents=true`)\n- Set `timeMin` to now (current ISO timestamp) and `timeMax` to the end of the desired range\n\n## Quick add\n\n`quick_add` parses natural language:\n- `"Meeting with Bob tomorrow at 3pm for 1 hour"`\n- `"Dentist appointment on Friday at 2pm"`\n- `"Weekly standup every Monday at 9am"`\n\n## Free/busy queries\n\nUse `freebusy_query` to check availability before scheduling:\n```json\n{\n  "timeMin": "2024-01-15T00:00:00Z",\n  "timeMax": "2024-01-15T23:59:59Z",\n  "items": [{ "id": "primary" }, { "id": "colleague@example.com" }]\n}\n```\n\n## Updating events\n\n- Use `update_event` for a full replacement (all fields must be provided)\n- Use `patch_event` for partial updates (only provide the fields you want to change in `body`)\n- `patch_event` is preferred when modifying one or two fields to avoid accidentally clearing others\n',
+    "usageGuide": '## Calendar IDs\n\n- Use `calendarId=\'primary\'` for the authenticated user\'s main calendar\n- Use `list_calendars` to discover other calendar IDs (work, shared, subscribed calendars)\n- Calendar IDs typically look like email addresses (e.g. `user@example.com`) or opaque strings for subscribed calendars\n\n## Date and time format\n\nAll times must be in RFC3339 format:\n- Timed events: `\'2024-01-15T10:00:00-05:00\'` (with timezone offset) or `\'2024-01-15T15:00:00Z\'` (UTC)\n- All-day events use date-only format: `\'2024-01-15\'`\n\n## Creating events\n\nFor `create_event`, required fields are `calendarId`, `summary`, `start`, and `end`:\n\n**Timed event:**\n```json\n{\n  "calendarId": "primary",\n  "summary": "Team Meeting",\n  "start": { "dateTime": "2024-01-15T10:00:00", "timeZone": "America/New_York" },\n  "end":   { "dateTime": "2024-01-15T11:00:00", "timeZone": "America/New_York" }\n}\n```\n\n**All-day event:**\n```json\n{\n  "calendarId": "primary",\n  "summary": "Company Holiday",\n  "start": { "date": "2024-01-15" },\n  "end":   { "date": "2024-01-16" }\n}\n```\n\nNote: For all-day events, `end.date` should be the day *after* the last day (exclusive end).\n\n## Listing events in chronological order\n\nTo list upcoming events in start-time order (e.g. "what\'s on my calendar this week"):\n- Set `singleEvents=true` to expand recurring events into individual instances\n- Set `orderBy=\'startTime\'` (requires `singleEvents=true`)\n- Set `timeMin` to now (current ISO timestamp) and `timeMax` to the end of the desired range\n\n## Quick add\n\n`quick_add` parses natural language:\n- `"Meeting with Bob tomorrow at 3pm for 1 hour"`\n- `"Dentist appointment on Friday at 2pm"`\n- `"Weekly standup every Monday at 9am"`\n\n## Free/busy queries\n\nUse `freebusy_query` to check availability before scheduling:\n```json\n{\n  "timeMin": "2024-01-15T00:00:00Z",\n  "timeMax": "2024-01-15T23:59:59Z",\n  "items": [{ "id": "primary" }, { "id": "colleague@example.com" }]\n}\n```\n\n## Updating events\n\n- Use `update_event` for a full replacement (all fields must be provided)\n- Use `patch_event` for partial updates (only provide the fields you want to change in `body`)\n- `patch_event` is preferred when modifying one or two fields to avoid accidentally clearing others\n',
     "variants": {
       "variants": {
         "service_account": {
@@ -9242,7 +9242,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": "## Gmail search query syntax\n\nGmail's `q` parameter supports a powerful search language. Key operators:\n\n- `is:unread` / `is:read` \u2014 filter by read status\n- `is:starred`, `is:important` \u2014 filter by markers\n- `from:user@example.com` \u2014 sender filter\n- `to:user@example.com`, `cc:user@example.com` \u2014 recipient filters\n- `subject:keyword` \u2014 subject line search\n- `has:attachment` \u2014 messages with attachments\n- `filename:report.pdf` \u2014 specific attachment filename\n- `label:INBOX` \u2014 filter by label (use label name or ID)\n- `after:2024/01/01`, `before:2024/12/31` \u2014 date range (YYYY/MM/DD)\n- `newer_than:7d`, `older_than:1y` \u2014 relative time (d=days, m=months, y=years)\n- `in:sent`, `in:drafts`, `in:trash`, `in:spam` \u2014 folder filters\n- `larger:5M`, `smaller:1M` \u2014 size filters\n\nCombine operators with spaces (implicit AND): `from:alice is:unread has:attachment`\n\n## Recommended workflows\n\n**Reading emails:**\n1. Use `list_messages` with a `q` query to find relevant message IDs\n2. Use `read_email` on each ID to get decoded subject, from, to, date, and body text\n3. For raw access or advanced format options, use `get_message` with `format='full'`\n\n**Searching for threads:**\n1. Use `list_threads` with `q` to find conversation threads\n2. Use `get_thread` to retrieve all messages in a conversation at once\n\n**Sending email:**\n- Use `send_email` for the vast majority of cases -- it accepts plain `to`, `subject`, `body` fields\n- Use `create_draft_email` + `send_draft` when you want to create a draft for review before sending\n\n**Replying to an email:**\n1. Get the original message with `read_email` to obtain its `threadId` and `id`\n2. Call `send_email` with `replyToMessageId` = original message `id` and `threadId` = original `threadId`\n3. The reply will appear in the same conversation thread\n\n## Label IDs\n\nSystem label IDs (always uppercase): `INBOX`, `UNREAD`, `STARRED`, `IMPORTANT`, `SENT`, `DRAFT`, `SPAM`, `TRASH`, `CATEGORY_PERSONAL`, `CATEGORY_SOCIAL`, `CATEGORY_PROMOTIONS`, `CATEGORY_UPDATES`, `CATEGORY_FORUMS`\n\nUser-created labels have auto-generated IDs. Use `list_labels` to discover them.\n\n## Archiving and organizing\n\n- Archive a message: `modify_message` with `removeLabelIds=['INBOX']`\n- Mark as read: `modify_message` with `removeLabelIds=['UNREAD']`\n- Star a message: `modify_message` with `addLabelIds=['STARRED']`\n- Apply a label: `modify_message` with `addLabelIds=['<labelId>']`\n- Use `modify_thread` to apply the same operation to all messages in a thread at once\n",
+    "usageGuide": "## Gmail search query syntax\n\nGmail's `q` parameter supports a powerful search language. Key operators:\n\n- `is:unread` / `is:read` \u2014 filter by read status\n- `is:starred`, `is:important` \u2014 filter by markers\n- `from:user@example.com` \u2014 sender filter\n- `to:user@example.com`, `cc:user@example.com` \u2014 recipient filters\n- `subject:keyword` \u2014 subject line search\n- `has:attachment` \u2014 messages with attachments\n- `filename:report.pdf` \u2014 specific attachment filename\n- `label:INBOX` \u2014 filter by label (use label name or ID)\n- `after:2024/01/01`, `before:2024/12/31` \u2014 date range (YYYY/MM/DD)\n- `newer_than:7d`, `older_than:1y` \u2014 relative time (d=days, m=months, y=years)\n- `in:sent`, `in:drafts`, `in:trash`, `in:spam` \u2014 folder filters\n- `larger:5M`, `smaller:1M` \u2014 size filters\n\nCombine operators with spaces (implicit AND): `from:alice is:unread has:attachment`\n\n## Recommended workflows\n\n**Reading emails:**\n1. Use `list_messages` with a `q` query to find relevant message IDs\n2. Use `read_email` on each ID to get decoded subject, from, to, date, and body text\n3. For raw access or advanced format options, use `get_message` with `format='full'`\n\n**Searching for threads:**\n1. Use `list_threads` with `q` to find conversation threads\n2. Use `get_thread` to retrieve all messages in a conversation at once\n\n**Sending email:**\n- Use `send_email` for the vast majority of cases -- it accepts plain `to`, `subject`, `body` fields\n- Use `create_draft_email` + `send_draft` when you want to create a draft for review before sending\n\n**Replying to an email:**\n1. Get the original message with `read_email` to obtain its `threadId` and `id`\n2. Call `send_email` with `replyToMessageId` = original message `id` and `threadId` = original `threadId`\n3. The reply will appear in the same conversation thread\n\n## Label IDs\n\nSystem label IDs (always uppercase): `INBOX`, `UNREAD`, `STARRED`, `IMPORTANT`, `SENT`, `DRAFT`, `SPAM`, `TRASH`, `CATEGORY_PERSONAL`, `CATEGORY_SOCIAL`, `CATEGORY_PROMOTIONS`, `CATEGORY_UPDATES`, `CATEGORY_FORUMS`\n\nUser-created labels have auto-generated IDs. Use `list_labels` to discover them.\n\n## Archiving and organizing\n\n- Archive a message: `modify_message` with `removeLabelIds=['INBOX']`\n- Mark as read: `modify_message` with `removeLabelIds=['UNREAD']`\n- Star a message: `modify_message` with `addLabelIds=['STARRED']`\n- Apply a label: `modify_message` with `addLabelIds=['<labelId>']`\n- Use `modify_thread` to apply the same operation to all messages in a thread at once\n",
     "variants": {
       "variants": {
         "service_account": {
@@ -10627,7 +10627,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": null,
+    "usageGuide": null,
     "variants": {
       "variants": {
         "service_account": {
@@ -10827,11 +10827,17 @@ const GENERATED_INTEGRATIONS = {
             "mimeType": {
               "type": "string",
               "description": "Optional Drive MIME type from get_file_meta or search_files."
+            },
+            "previewPages": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10,
+              "description": "Number of pages to render as images and return alongside the text (PDF only). Omit or set to 0 to skip. Useful for visually checking signatures, logos, or layout."
             }
           },
           "additionalProperties": false
         },
-        "handlerCode": "async (input) => {\n  const googleNativeExports = {\n    'application/vnd.google-apps.document': 'text/markdown',\n    'application/vnd.google-apps.spreadsheet': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    'application/vnd.google-apps.presentation': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n    'application/vnd.google-apps.drawing': 'image/svg+xml',\n    'application/vnd.google-apps.script': 'application/vnd.google-apps.script+json',\n  }\n  const isTextLikeMimeType = (value) => {\n    const mimeType = String(value || '').split(';', 1)[0].trim().toLowerCase()\n    return mimeType.startsWith('text/')\n      || mimeType.includes('json')\n      || mimeType.includes('csv')\n      || mimeType === 'application/xml'\n      || mimeType === 'text/xml'\n      || mimeType.endsWith('+xml')\n      || mimeType.includes('javascript')\n      || mimeType.includes('svg')\n  }\n  const resolveMimeType = async () => {\n    if (typeof input.mimeType === 'string' && input.mimeType.trim())\n      return input.mimeType.trim()\n\n    const metaRes = await integration.fetch(`/files/${fileId}?fields=id,name,mimeType`)\n    const meta = await metaRes.json()\n    return meta?.mimeType || ''\n  }\n  const readTextContent = async (source) => {\n    const res = await integration.fetch(source)\n    const contentMimeType = res.headers?.get?.('content-type') || ''\n    const content = await res.text()\n    return { contentMimeType, content }\n  }\n\n  const fileId = encodeURIComponent(input.fileId)\n  const mimeType = await resolveMimeType()\n\n  if (!mimeType) {\n    return {\n      fileId: input.fileId,\n      mimeType: null,\n      content: null,\n      message: 'Could not determine the Drive file MIME type.',\n    }\n  }\n\n  if (mimeType === 'application/vnd.google-apps.folder') {\n    return {\n      fileId: input.fileId,\n      mimeType,\n      content: null,\n      message: 'Folders do not have readable file content.',\n    }\n  }\n\n  const isGoogleNative = mimeType.startsWith('application/vnd.google-apps.')\n  const exportMimeType = isGoogleNative\n    ? (typeof input.exportMimeType === 'string' && input.exportMimeType.trim())\n        ? input.exportMimeType.trim()\n        : googleNativeExports[mimeType] || null\n    : null\n\n  if (isGoogleNative && !exportMimeType) {\n    return {\n      fileId: input.fileId,\n      mimeType,\n      content: null,\n      message: 'This Google-native file type does not have a configured export path for read_file_content.',\n    }\n  }\n\n  const source = isGoogleNative\n    ? `/files/${fileId}/export?mimeType=${encodeURIComponent(exportMimeType)}`\n    : `/files/${fileId}?alt=media`\n\n  if (isTextLikeMimeType(exportMimeType || mimeType)) {\n    const textResult = await readTextContent(source)\n    return {\n      fileId: input.fileId,\n      mimeType,\n      contentMimeType: textResult.contentMimeType || exportMimeType || mimeType,\n      content: textResult.content,\n    }\n  }\n\n  const extracted = await utils.extractFileContent({\n    auth: true,\n    source,\n  })\n\n  return {\n    fileId: input.fileId,\n    mimeType,\n    contentMimeType: exportMimeType || mimeType,\n    ...extracted,\n  }\n}",
+        "handlerCode": "async (input) => {\n  const googleNativeExports = {\n    'application/vnd.google-apps.document': 'text/markdown',\n    'application/vnd.google-apps.spreadsheet': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n    'application/vnd.google-apps.presentation': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n    'application/vnd.google-apps.drawing': 'image/svg+xml',\n    'application/vnd.google-apps.script': 'application/vnd.google-apps.script+json',\n  }\n  const isTextLikeMimeType = (value) => {\n    const mimeType = String(value || '').split(';', 1)[0].trim().toLowerCase()\n    return mimeType.startsWith('text/')\n      || mimeType.includes('json')\n      || mimeType.includes('csv')\n      || mimeType === 'application/xml'\n      || mimeType === 'text/xml'\n      || mimeType.endsWith('+xml')\n      || mimeType.includes('javascript')\n      || mimeType.includes('svg')\n  }\n  const resolveMimeType = async () => {\n    if (typeof input.mimeType === 'string' && input.mimeType.trim())\n      return input.mimeType.trim()\n\n    const metaRes = await integration.fetch(`/files/${fileId}?fields=id,name,mimeType`)\n    const meta = await metaRes.json()\n    return meta?.mimeType || ''\n  }\n  const readTextContent = async (source) => {\n    const res = await integration.fetch(source)\n    const contentMimeType = res.headers?.get?.('content-type') || ''\n    const content = await res.text()\n    return { contentMimeType, content }\n  }\n\n  const fileId = encodeURIComponent(input.fileId)\n  const mimeType = await resolveMimeType()\n\n  if (!mimeType) {\n    return {\n      fileId: input.fileId,\n      mimeType: null,\n      content: null,\n      message: 'Could not determine the Drive file MIME type.',\n    }\n  }\n\n  if (mimeType === 'application/vnd.google-apps.folder') {\n    return {\n      fileId: input.fileId,\n      mimeType,\n      content: null,\n      message: 'Folders do not have readable file content.',\n    }\n  }\n\n  const isGoogleNative = mimeType.startsWith('application/vnd.google-apps.')\n  const exportMimeType = isGoogleNative\n    ? (typeof input.exportMimeType === 'string' && input.exportMimeType.trim())\n        ? input.exportMimeType.trim()\n        : googleNativeExports[mimeType] || null\n    : null\n\n  if (isGoogleNative && !exportMimeType) {\n    return {\n      fileId: input.fileId,\n      mimeType,\n      content: null,\n      message: 'This Google-native file type does not have a configured export path for read_file_content.',\n    }\n  }\n\n  const source = isGoogleNative\n    ? `/files/${fileId}/export?mimeType=${encodeURIComponent(exportMimeType)}`\n    : `/files/${fileId}?alt=media`\n\n  if (isTextLikeMimeType(exportMimeType || mimeType)) {\n    const textResult = await readTextContent(source)\n    return {\n      fileId: input.fileId,\n      mimeType,\n      contentMimeType: textResult.contentMimeType || exportMimeType || mimeType,\n      content: textResult.content,\n    }\n  }\n\n  const extracted = await utils.extractFileContent({\n    auth: true,\n    source,\n    previewPages: input.previewPages || 0,\n  })\n\n  return {\n    fileId: input.fileId,\n    mimeType,\n    contentMimeType: exportMimeType || mimeType,\n    ...extracted,\n  }\n}",
         "scope": "read",
         "toolset": "drive"
       },
@@ -12523,7 +12529,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": '## HubSpot guidance\n\nThis integration uses HubSpot CRM v3 object endpoints and CRM v4 association endpoints.\n\n- Prefer `search_*` tools for discovery (they support free-text `query` and structured `filters`).\n- Use `get_*` tools when you already have an object ID and want full details / associations.\n\n### Search filters\n\nAll `search_*` tools accept:\n\n- `query`: free-text search (optional)\n- `filters`: property-based filtering. Each filter is `{ propertyName, operator, value? }`.\n\nCommon operators:\n\n- `EQ`, `NEQ`\n- `LT`, `LTE`, `GT`, `GTE` (numbers or millisecond timestamps)\n- `CONTAINS_TOKEN` (tokenized contains)\n- `HAS_PROPERTY`, `NOT_HAS_PROPERTY` (value ignored)\n- `BETWEEN` (pass `value` as a string `"low,high"`; timestamps in ms recommended)\n\n### Common property names (quick reference)\n\nContacts:\n- `firstname`, `lastname`, `email`\n\nCompanies:\n- `name`, `domain`\n\nDeals:\n- `dealname`, `amount`, `pipeline`, `dealstage`, `closedate`\n\nTickets:\n- `subject`, `content`, `hs_pipeline`, `hs_pipeline_stage`\n\n### Pipelines and stages (deals/tickets)\n\nPipelines and stages are stored as IDs (not human-friendly names). Recommended workflow:\n\n1. Call `list_pipelines` with `objectType: "deals"` or `objectType: "tickets"`.\n2. Pick a pipeline ID and stage ID from the response.\n3. Use those IDs when calling `create_deal` / `update_deal` (via `pipeline` / `dealstage`) or `create_ticket` / `update_ticket` (via `hs_pipeline` / `hs_pipeline_stage`).\n\n### Associations\n\n- Use `get_associations` to list linked records (returns associated IDs).\n- Use `create_association` to link two records (default/unlabeled association).\n- Use `remove_association` to unlink records.\n\n### Engagement objects\n\nNotes:\n- Content: `hs_note_body`\n- Timestamp: `hs_timestamp` (milliseconds)\n\nTasks:\n- Subject: `hs_task_subject`\n- Body: `hs_task_body`\n- Status: `hs_task_status` (`NOT_STARTED` or `COMPLETED`)\n- Priority: `hs_task_priority` (`LOW`, `MEDIUM`, `HIGH`)\n- Due timestamp: `hs_timestamp` (milliseconds)\n\nThe `create_note` and `create_task` tools can also associate the engagement to CRM records in the same call.\n\n### Pagination\n\nHubSpot uses cursor-based pagination. When a response includes `paging.next.after`, pass that value back as `after` in your next call.\n\n',
+    "usageGuide": '## HubSpot guidance\n\nThis integration uses HubSpot CRM v3 object endpoints and CRM v4 association endpoints.\n\n- Prefer `search_*` tools for discovery (they support free-text `query` and structured `filters`).\n- Use `get_*` tools when you already have an object ID and want full details / associations.\n\n### Search filters\n\nAll `search_*` tools accept:\n\n- `query`: free-text search (optional)\n- `filters`: property-based filtering. Each filter is `{ propertyName, operator, value? }`.\n\nCommon operators:\n\n- `EQ`, `NEQ`\n- `LT`, `LTE`, `GT`, `GTE` (numbers or millisecond timestamps)\n- `CONTAINS_TOKEN` (tokenized contains)\n- `HAS_PROPERTY`, `NOT_HAS_PROPERTY` (value ignored)\n- `BETWEEN` (pass `value` as a string `"low,high"`; timestamps in ms recommended)\n\n### Common property names (quick reference)\n\nContacts:\n- `firstname`, `lastname`, `email`\n\nCompanies:\n- `name`, `domain`\n\nDeals:\n- `dealname`, `amount`, `pipeline`, `dealstage`, `closedate`\n\nTickets:\n- `subject`, `content`, `hs_pipeline`, `hs_pipeline_stage`\n\n### Pipelines and stages (deals/tickets)\n\nPipelines and stages are stored as IDs (not human-friendly names). Recommended workflow:\n\n1. Call `list_pipelines` with `objectType: "deals"` or `objectType: "tickets"`.\n2. Pick a pipeline ID and stage ID from the response.\n3. Use those IDs when calling `create_deal` / `update_deal` (via `pipeline` / `dealstage`) or `create_ticket` / `update_ticket` (via `hs_pipeline` / `hs_pipeline_stage`).\n\n### Associations\n\n- Use `get_associations` to list linked records (returns associated IDs).\n- Use `create_association` to link two records (default/unlabeled association).\n- Use `remove_association` to unlink records.\n\n### Engagement objects\n\nNotes:\n- Content: `hs_note_body`\n- Timestamp: `hs_timestamp` (milliseconds)\n\nTasks:\n- Subject: `hs_task_subject`\n- Body: `hs_task_body`\n- Status: `hs_task_status` (`NOT_STARTED` or `COMPLETED`)\n- Priority: `hs_task_priority` (`LOW`, `MEDIUM`, `HIGH`)\n- Due timestamp: `hs_timestamp` (milliseconds)\n\nThe `create_note` and `create_task` tools can also associate the engagement to CRM records in the same call.\n\n### Pagination\n\nHubSpot uses cursor-based pagination. When a response includes `paging.next.after`, pass that value back as `after` in your next call.\n\n',
     "variants": {
       "variants": {
         "private_app_token": {
@@ -14100,7 +14106,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": "# Jira usage guide\n\n## Core workflow patterns\n\n### Discover projects and issue types (before creating issues)\n\n1. Call `list_projects` to find the project key (e.g. `PROJ`).\n2. Call `get_project` with `projectIdOrKey=PROJ` to see available `issueTypes`.\n3. Use the returned issue type name with `create_issue.issueTypeName`.\n\n### Search issues (JQL)\n\nUse `search_issues` with JQL. Common examples:\n\n- My open issues:\n  - `assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`\n- Recently updated issues in a project:\n  - `project = PROJ ORDER BY updated DESC`\n- Unassigned bugs:\n  - `project = PROJ AND issuetype = Bug AND assignee is EMPTY ORDER BY created DESC`\n- Blocked issues (label-based):\n  - `project = PROJ AND labels = blocked ORDER BY priority DESC, updated DESC`\n\nPagination:\n- `search_issues` uses `nextPageToken`. If `nextPageToken` is returned and `isLast=false`, pass it back to get the next page.\n\n### Read issue content\n\n- Use `get_issue` to read a compact issue summary.\n- `get_issue` converts Jira's ADF description into `descriptionMarkdown` when possible (fallback: `descriptionText`).\n- Use `get_issue_comments` to read the comment thread (comment bodies are converted to Markdown).\n\n### Transition an issue (change status)\n\nJira workflows are project-specific, so you must discover valid transitions:\n\n1. Call `get_transitions` to see available transition names/IDs for the issue.\n2. Call `transition_issue` using either `transitionId` (preferred) or `transitionName`.\n\n### Assigning issues\n\n1. Call `search_users` to find the user's `accountId`.\n2. Assign:\n   - `assign_issue { issueIdOrKey, accountId }`\n3. Unassign:\n   - `assign_issue { issueIdOrKey, accountId: null }`\n\n## Notes on Jira rich text (ADF)\n\nJira Cloud REST API v3 uses **Atlassian Document Format (ADF)** for fields like `description` and comment bodies.\n\n- Read tools convert ADF to Markdown so you can read it directly.\n- Write tools accept **Markdown** in their `*Text` fields and convert it to ADF (`descriptionText`, `bodyText`, `commentText`).\n\n### Round-trip Markdown workflow (recommended)\n\nYou can safely do a Markdown round-trip:\n\n1. `get_issue` -> edit `descriptionMarkdown`\n2. `update_issue { descriptionText: <your edited Markdown> }`\n\nSupported Markdown features when writing:\n\n- Headings (`#`, `##`, ...)\n- Bold/italic/strikethrough (`**bold**`, `*italic*`, `~~strike~~`)\n- Inline code and fenced code blocks (```), including optional language fences\n- Lists (ordered/unordered), nested lists\n- Blockquotes (`>`)\n- Horizontal rules (`---`)\n- Tables\n- Links (`[text](url)`)\n\n## Boards & sprints\n\nIf you\u2019re using Jira Software:\n\n1. Call `list_boards` (optionally filter by `projectKeyOrId`).\n2. Call `list_sprints` for a board to find active/future sprints.\n3. Use `move_issues_to_sprint` to pull work into a sprint (sprint planning).\n\n",
+    "usageGuide": "# Jira usage guide\n\n## Core workflow patterns\n\n### Discover projects and issue types (before creating issues)\n\n1. Call `list_projects` to find the project key (e.g. `PROJ`).\n2. Call `get_project` with `projectIdOrKey=PROJ` to see available `issueTypes`.\n3. Use the returned issue type name with `create_issue.issueTypeName`.\n\n### Search issues (JQL)\n\nUse `search_issues` with JQL. Common examples:\n\n- My open issues:\n  - `assignee = currentUser() AND statusCategory != Done ORDER BY updated DESC`\n- Recently updated issues in a project:\n  - `project = PROJ ORDER BY updated DESC`\n- Unassigned bugs:\n  - `project = PROJ AND issuetype = Bug AND assignee is EMPTY ORDER BY created DESC`\n- Blocked issues (label-based):\n  - `project = PROJ AND labels = blocked ORDER BY priority DESC, updated DESC`\n\nPagination:\n- `search_issues` uses `nextPageToken`. If `nextPageToken` is returned and `isLast=false`, pass it back to get the next page.\n\n### Read issue content\n\n- Use `get_issue` to read a compact issue summary.\n- `get_issue` converts Jira's ADF description into `descriptionMarkdown` when possible (fallback: `descriptionText`).\n- Use `get_issue_comments` to read the comment thread (comment bodies are converted to Markdown).\n\n### Transition an issue (change status)\n\nJira workflows are project-specific, so you must discover valid transitions:\n\n1. Call `get_transitions` to see available transition names/IDs for the issue.\n2. Call `transition_issue` using either `transitionId` (preferred) or `transitionName`.\n\n### Assigning issues\n\n1. Call `search_users` to find the user's `accountId`.\n2. Assign:\n   - `assign_issue { issueIdOrKey, accountId }`\n3. Unassign:\n   - `assign_issue { issueIdOrKey, accountId: null }`\n\n## Notes on Jira rich text (ADF)\n\nJira Cloud REST API v3 uses **Atlassian Document Format (ADF)** for fields like `description` and comment bodies.\n\n- Read tools convert ADF to Markdown so you can read it directly.\n- Write tools accept **Markdown** in their `*Text` fields and convert it to ADF (`descriptionText`, `bodyText`, `commentText`).\n\n### Round-trip Markdown workflow (recommended)\n\nYou can safely do a Markdown round-trip:\n\n1. `get_issue` -> edit `descriptionMarkdown`\n2. `update_issue { descriptionText: <your edited Markdown> }`\n\nSupported Markdown features when writing:\n\n- Headings (`#`, `##`, ...)\n- Bold/italic/strikethrough (`**bold**`, `*italic*`, `~~strike~~`)\n- Inline code and fenced code blocks (```), including optional language fences\n- Lists (ordered/unordered), nested lists\n- Blockquotes (`>`)\n- Horizontal rules (`---`)\n- Tables\n- Links (`[text](url)`)\n\n## Boards & sprints\n\nIf you\u2019re using Jira Software:\n\n1. Call `list_boards` (optionally filter by `projectKeyOrId`).\n2. Call `list_sprints` for a board to find active/future sprints.\n3. Use `move_issues_to_sprint` to pull work into a sprint (sprint planning).\n\n",
     "variants": {
       "variants": {
         "api_token": {
@@ -15188,7 +15194,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": '## Appending paragraph blocks\n\nWhen appending a paragraph block to a Notion page, ensure the `rich_text` field is correctly defined within the `paragraph` type. Example format:\n\n```json\n{\n  "block_id": "<page_id>",\n  "children": [\n    {\n      "object": "block",\n      "type": "paragraph",\n      "paragraph": {\n        "rich_text": [\n          {\n            "type": "text",\n            "text": {\n              "content": "Your text here"\n            }\n          }\n        ]\n      }\n    }\n  ]\n}\n```\n\n',
+    "usageGuide": '## Appending paragraph blocks\n\nWhen appending a paragraph block to a Notion page, ensure the `rich_text` field is correctly defined within the `paragraph` type. Example format:\n\n```json\n{\n  "block_id": "<page_id>",\n  "children": [\n    {\n      "object": "block",\n      "type": "paragraph",\n      "paragraph": {\n        "rich_text": [\n          {\n            "type": "text",\n            "text": {\n              "content": "Your text here"\n            }\n          }\n        ]\n      }\n    }\n  ]\n}\n```\n\n',
     "variants": {
       "variants": {
         "internal_integration": {
@@ -15829,20 +15835,947 @@ const GENERATED_INTEGRATIONS = {
                 "null"
               ]
             },
-            "archived": {
-              "type": [
-                "boolean",
-                "null"
-              ]
+            "archived": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            }
+          }
+        },
+        "handlerCode": "async (input) => {\n  const body = {\n    title: input.title || undefined,\n    description: input.description || undefined,\n    properties: input.properties || undefined,\n    archived: input.archived === undefined ? undefined : input.archived,\n  }\n  const res = await integration.fetch(`/databases/${encodeURIComponent(input.database_id)}`, { method: 'PATCH', body })\n  return await res.json()\n}",
+        "scope": "write",
+        "toolset": "databases"
+      }
+    ],
+    "variantOwnerType": null
+  },
+  "sharepoint": {
+    "manifest": {
+      "name": "sharepoint",
+      "version": "0.1.0",
+      "baseUrl": "https://graph.microsoft.com/v1.0",
+      "tools": [
+        {
+          "name": "search_sites",
+          "description": "Search SharePoint sites by keyword across the tenant. Returns compact site summaries with IDs and web URLs. Use this when you know the site name or topic but not the site ID. If you already know the hostname and path, use get_site_by_path instead.",
+          "inputSchema": "schemas/search_sites.json",
+          "handler": "handlers/search_sites.js",
+          "scope": "read"
+        },
+        {
+          "name": "get_site_by_path",
+          "description": "Resolve a SharePoint site from its hostname and server-relative path, such as hostname='contoso.sharepoint.com' and relativePath='//Marketing'. Use this when you know the SharePoint URL structure and need the stable site ID for later calls.",
+          "inputSchema": "schemas/get_site_by_path.json",
+          "handler": "handlers/get_site_by_path.js",
+          "scope": "read"
+        },
+        {
+          "name": "get_site",
+          "description": "Get metadata for a SharePoint site by site ID. Returns the site name, description, web URL, and timestamps. Use search_sites or get_site_by_path first if you do not already know the site ID.",
+          "inputSchema": "schemas/get_site.json",
+          "handler": "handlers/get_site.js",
+          "scope": "read"
+        },
+        {
+          "name": "list_site_drives",
+          "description": "List document libraries (drives) for a SharePoint site. Returns compact drive summaries including IDs, names, web URLs, and drive type. Use this after resolving a site to discover the right document library before browsing folders or reading files.",
+          "inputSchema": "schemas/list_site_drives.json",
+          "handler": "handlers/list_site_drives.js",
+          "scope": "read"
+        },
+        {
+          "name": "list_drive_children",
+          "description": "List the files and folders inside a SharePoint document library folder. By default this lists the root of the drive. Provide itemId to browse a specific folder. Returns compact entries with file-or-folder flags, MIME type when available, and parent references. Use get_drive_item_meta when you need one specific item.",
+          "inputSchema": "schemas/list_drive_children.json",
+          "handler": "handlers/list_drive_children.js",
+          "scope": "read"
+        },
+        {
+          "name": "get_drive_item_meta",
+          "description": "Get metadata for a single SharePoint file or folder by drive ID and item ID. Returns a compact item summary including IDs, name, type flags, web URL, size, timestamps, and parent reference. Use read_file_content to read the actual file contents.",
+          "inputSchema": "schemas/get_drive_item.json",
+          "handler": "handlers/get_drive_item.js",
+          "scope": "read"
+        },
+        {
+          "name": "search_files",
+          "description": "Search SharePoint and OneDrive content through Microsoft Graph search and return flattened file hits. Provide a query string; Graph KQL syntax is supported. Optional siteId and driveId filters narrow the flattened results after search. Use this for broad file discovery when folder-by-folder browsing is too narrow.",
+          "inputSchema": "schemas/search_files.json",
+          "handler": "handlers/search_files.js",
+          "scope": "read"
+        },
+        {
+          "name": "read_file_content",
+          "description": "Read a SharePoint file into agent-friendly text using the shared file extraction pipeline. This is the standard way to consume document contents such as PDF, DOCX, XLSX, PPTX, and text-like files stored in SharePoint document libraries. Provide driveId and itemId. Folders are rejected; use list_drive_children to browse them.",
+          "inputSchema": "schemas/read_file_content.json",
+          "handler": "handlers/read_file_content.js",
+          "scope": "read"
+        },
+        {
+          "name": "create_folder",
+          "description": "Create a new folder in a SharePoint document library. By default the folder is created in the drive root. Provide parentItemId to create it inside an existing folder. Returns the created folder metadata including its item ID for later browsing or moves.",
+          "inputSchema": "schemas/create_folder.json",
+          "handler": "handlers/create_folder.js",
+          "scope": "write"
+        },
+        {
+          "name": "move_drive_item",
+          "description": "Move a SharePoint file or folder to a different parent folder in the same drive. Provide destinationParentId and optionally a newName to rename during the move. Use get_drive_item_meta or list_drive_children first to discover the current item and destination IDs.",
+          "inputSchema": "schemas/move_drive_item.json",
+          "handler": "handlers/move_drive_item.js",
+          "scope": "write"
+        },
+        {
+          "name": "delete_drive_item",
+          "description": "Delete a SharePoint file or folder by drive ID and item ID. This is a destructive operation. Use get_drive_item_meta or list_drive_children first to confirm you have the correct item before deleting it.",
+          "inputSchema": "schemas/delete_drive_item.json",
+          "handler": "handlers/delete_drive_item.js",
+          "scope": "write"
+        }
+      ]
+    },
+    "usageGuide": "Use this integration for SharePoint document libraries and files.\n\nRecommended workflow:\n\n1. If you know the SharePoint hostname and path, start with `get_site_by_path`.\n2. Otherwise use `search_sites` to discover the correct site.\n3. Use `list_site_drives` to find the relevant document library for that site.\n4. Use `list_drive_children` for deterministic folder browsing or `search_files` for broader file discovery.\n5. Use `get_drive_item_meta` when you need compact metadata for a specific file or folder.\n6. Use `read_file_content` to consume the actual contents of a file in agent-friendly text.\n\nNotes:\n\n- `search_files` uses Microsoft Graph search. The `query` field accepts normal keywords and Graph KQL syntax.\n- `siteId` and `driveId` filters on `search_files` are applied to the flattened search results after Graph returns them.\n- `read_file_content` is for files only. Folders do not have readable file content.\n- This v1 integration is intentionally focused on SharePoint sites, document libraries, folders, and files. It does not include classic SharePoint list/list-item tools or file upload.\n",
+    "variants": {
+      "variants": {
+        "app_credentials": {
+          "label": "Microsoft Graph App Credentials",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "tenantId": {
+                "type": "string",
+                "title": "Tenant ID",
+                "description": "Microsoft Entra tenant ID (GUID) that owns the SharePoint tenant."
+              },
+              "clientId": {
+                "type": "string",
+                "title": "Client ID",
+                "description": "Application (client) ID of the Microsoft Entra app registration."
+              },
+              "clientSecret": {
+                "type": "string",
+                "title": "Client Secret",
+                "description": "Client secret value for the Microsoft Entra app registration.",
+                "format": "password"
+              }
+            },
+            "required": [
+              "tenantId",
+              "clientId",
+              "clientSecret"
+            ],
+            "additionalProperties": false
+          },
+          "preprocess": {
+            "type": "handler",
+            "handlerCode": "async (creds, utils) => {\n  const tenantId = String(creds?.tenantId || '').trim()\n  const clientId = String(creds?.clientId || '').trim()\n  const clientSecret = String(creds?.clientSecret || '').trim()\n\n  if (!tenantId)\n    throw new Error('Missing tenantId')\n  if (!clientId)\n    throw new Error('Missing clientId')\n  if (!clientSecret)\n    throw new Error('Missing clientSecret')\n\n  const response = await utils.tokenFetch(\n    `https://login.microsoftonline.com/${encodeURIComponent(tenantId)}/oauth2/v2.0/token`,\n    {\n      method: 'POST',\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: clientId,\n        client_secret: clientSecret,\n        scope: 'https://graph.microsoft.com/.default',\n      }),\n    },\n  )\n\n  const data = await response.json()\n  if (!response.ok) {\n    const message = typeof data?.error_description === 'string'\n      ? data.error_description\n      : (typeof data?.error === 'string' ? data.error : `Token request failed with status ${response.status}`)\n    throw new Error(message)\n  }\n\n  const token = typeof data?.access_token === 'string' ? data.access_token : ''\n  if (!token)\n    throw new Error('Microsoft token response did not include access_token')\n\n  return {\n    token,\n    expiresIn: data?.expires_in,\n  }\n}",
+            "allowedOrigins": [
+              "https://login.microsoftonline.com"
+            ]
+          },
+          "injection": {
+            "headers": {
+              "Authorization": "Bearer {{token}}"
+            }
+          },
+          "healthCheck": {
+            "notViable": true
+          }
+        }
+      },
+      "default": "app_credentials"
+    },
+    "hint": "1. Create or use a Microsoft Entra app registration for Microsoft Graph at https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade\n2. Create a client secret for that app and copy the **tenant ID**, **client ID**, and **client secret value**.\n3. In Microsoft Graph **Application permissions**, grant at least `Sites.Read.All` and `Files.Read.All`.\n4. If you intend to use write actions such as folder creation, moves, and deletes, also grant `Sites.ReadWrite.All` and `Files.ReadWrite.All`.\n5. Grant admin consent for those application permissions in the tenant.\n6. Paste the tenant ID, client ID, and client secret into this integration. The integration exchanges them for short-lived Microsoft Graph access tokens automatically.",
+    "hintsByVariant": {},
+    "tools": [
+      {
+        "name": "search_sites",
+        "description": "Search SharePoint sites by keyword across the tenant. Returns compact site summaries with IDs and web URLs. Use this when you know the site name or topic but not the site ID. If you already know the hostname and path, use get_site_by_path instead.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "query"
+          ],
+          "properties": {
+            "query": {
+              "type": "string",
+              "description": "Keyword search for SharePoint sites, such as a team name or department."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const params = new URLSearchParams()\n  params.set('search', input.query)\n  const res = await integration.fetch(`/sites?${params.toString()}`)\n  const data = await res.json()\n  const sites = Array.isArray(data?.value)\n    ? data.value.map(site => ({\n        id: site.id,\n        name: site.displayName || site.name || null,\n        displayName: site.displayName || site.name || null,\n        description: site.description || '',\n        webUrl: site.webUrl || null,\n        createdDateTime: site.createdDateTime || null,\n        lastModifiedDateTime: site.lastModifiedDateTime || null,\n      }))\n    : []\n  return { query: input.query, sites }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "get_site_by_path",
+        "description": "Resolve a SharePoint site from its hostname and server-relative path, such as hostname='contoso.sharepoint.com' and relativePath='//Marketing'. Use this when you know the SharePoint URL structure and need the stable site ID for later calls.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "hostname",
+            "relativePath"
+          ],
+          "properties": {
+            "hostname": {
+              "type": "string",
+              "description": "SharePoint hostname, such as contoso.sharepoint.com."
+            },
+            "relativePath": {
+              "type": "string",
+              "description": "Server-relative site path, such as /sites/Marketing."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const hostname = String(input.hostname || '').trim()\n  const rawPath = String(input.relativePath || '').trim()\n  const normalizedPath = `/${rawPath.replace(/^\\/+/, '')}`\n  const encodedPath = normalizedPath\n    .split('/')\n    .map((segment, index) => index === 0 ? '' : encodeURIComponent(segment))\n    .join('/')\n  const res = await integration.fetch(`/sites/${hostname}:${encodedPath}`)\n  const site = await res.json()\n  return {\n    id: site.id,\n    name: site.displayName || site.name || null,\n    displayName: site.displayName || site.name || null,\n    description: site.description || '',\n    webUrl: site.webUrl || null,\n    createdDateTime: site.createdDateTime || null,\n    lastModifiedDateTime: site.lastModifiedDateTime || null,\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "get_site",
+        "description": "Get metadata for a SharePoint site by site ID. Returns the site name, description, web URL, and timestamps. Use search_sites or get_site_by_path first if you do not already know the site ID.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "siteId"
+          ],
+          "properties": {
+            "siteId": {
+              "type": "string",
+              "description": "Microsoft Graph SharePoint site ID."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const res = await integration.fetch(`/sites/${encodeURIComponent(input.siteId)}`)\n  const site = await res.json()\n  return {\n    id: site.id,\n    name: site.displayName || site.name || null,\n    displayName: site.displayName || site.name || null,\n    description: site.description || '',\n    webUrl: site.webUrl || null,\n    createdDateTime: site.createdDateTime || null,\n    lastModifiedDateTime: site.lastModifiedDateTime || null,\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "list_site_drives",
+        "description": "List document libraries (drives) for a SharePoint site. Returns compact drive summaries including IDs, names, web URLs, and drive type. Use this after resolving a site to discover the right document library before browsing folders or reading files.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "siteId"
+          ],
+          "properties": {
+            "siteId": {
+              "type": "string",
+              "description": "Microsoft Graph SharePoint site ID."
+            },
+            "top": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200,
+              "description": "Maximum number of drives to return."
+            },
+            "includeSystem": {
+              "type": "boolean",
+              "description": "Set true to include hidden/system drives."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const params = new URLSearchParams()\n  params.set('$select', input.includeSystem\n    ? 'id,name,webUrl,driveType,createdDateTime,lastModifiedDateTime,system'\n    : 'id,name,webUrl,driveType,createdDateTime,lastModifiedDateTime')\n  if (input.top)\n    params.set('$top', String(input.top))\n\n  const res = await integration.fetch(`/sites/${encodeURIComponent(input.siteId)}/drives?${params.toString()}`)\n  const data = await res.json()\n  const drives = Array.isArray(data?.value)\n    ? data.value.map(drive => ({\n        id: drive.id,\n        name: drive.name || null,\n        webUrl: drive.webUrl || null,\n        driveType: drive.driveType || null,\n        createdDateTime: drive.createdDateTime || null,\n        lastModifiedDateTime: drive.lastModifiedDateTime || null,\n        isSystem: Boolean(drive.system),\n      }))\n    : []\n\n  return {\n    siteId: input.siteId,\n    drives,\n    nextLink: data?.['@odata.nextLink'] || null,\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "list_drive_children",
+        "description": "List the files and folders inside a SharePoint document library folder. By default this lists the root of the drive. Provide itemId to browse a specific folder. Returns compact entries with file-or-folder flags, MIME type when available, and parent references. Use get_drive_item_meta when you need one specific item.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Optional folder item ID. Omit to list the drive root."
+            },
+            "top": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200,
+              "description": "Maximum number of children to return."
+            },
+            "orderBy": {
+              "type": "string",
+              "description": "Optional Microsoft Graph orderBy expression, such as name or lastModifiedDateTime desc."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const flattenItem = item => ({\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    eTag: item.eTag || null,\n    cTag: item.cTag || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  })\n\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,eTag,cTag,parentReference,file,folder,package',\n  )\n  if (input.top)\n    params.set('$top', String(input.top))\n  if (input.orderBy)\n    params.set('$orderby', input.orderBy)\n\n  const basePath = input.itemId\n    ? `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}/children`\n    : `/drives/${encodeURIComponent(input.driveId)}/root/children`\n\n  const res = await integration.fetch(`${basePath}?${params.toString()}`)\n  const data = await res.json()\n\n  return {\n    driveId: input.driveId,\n    itemId: input.itemId || null,\n    children: Array.isArray(data?.value) ? data.value.map(flattenItem) : [],\n    nextLink: data?.['@odata.nextLink'] || null,\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "get_drive_item_meta",
+        "description": "Get metadata for a single SharePoint file or folder by drive ID and item ID. Returns a compact item summary including IDs, name, type flags, web URL, size, timestamps, and parent reference. Use read_file_content to read the actual file contents.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const flattenItem = item => ({\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    eTag: item.eTag || null,\n    cTag: item.cTag || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  })\n\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,eTag,cTag,parentReference,file,folder,package',\n  )\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}?${params.toString()}`)\n  return flattenItem(await res.json())\n}",
+        "scope": "read"
+      },
+      {
+        "name": "search_files",
+        "description": "Search SharePoint and OneDrive content through Microsoft Graph search and return flattened file hits. Provide a query string; Graph KQL syntax is supported. Optional siteId and driveId filters narrow the flattened results after search. Use this for broad file discovery when folder-by-folder browsing is too narrow.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "query"
+          ],
+          "properties": {
+            "query": {
+              "type": "string",
+              "description": "Search query string. Microsoft Graph KQL syntax is supported."
+            },
+            "siteId": {
+              "type": "string",
+              "description": "Optional site ID to keep only hits from a specific SharePoint site."
+            },
+            "driveId": {
+              "type": "string",
+              "description": "Optional drive ID to keep only hits from a specific document library."
+            },
+            "from": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Offset into the Graph search results."
+            },
+            "size": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 50,
+              "description": "Maximum number of hits to request from Graph."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const extractFallbackRegion = (error) => {\n    const texts = [error?.data?.body, error?.message].filter(s => typeof s === 'string')\n    for (const text of texts) {\n      const match = text.match(/Only valid regions are ([A-Z,\\s]+)/i)\n      const region = match?.[1]?.split(',').map(r => r.trim().toUpperCase()).filter(Boolean)[0]\n      if (region)\n        return region\n    }\n    return null\n  }\n\n  const runSearch = async (region) => {\n    const res = await integration.fetch('/search/query', {\n      method: 'POST',\n      body: {\n        requests: [{\n          entityTypes: ['driveItem'],\n          query: { queryString: input.query },\n          from: typeof input.from === 'number' ? input.from : 0,\n          size: typeof input.size === 'number' ? input.size : 25,\n          region,\n        }],\n      },\n    })\n    return res.json()\n  }\n\n  const flattenHit = (hit) => {\n    const resource = hit?.resource || {}\n    const parentReference = resource.parentReference || {}\n    return {\n      id: resource.id || hit?.hitId || null,\n      name: resource.name || null,\n      webUrl: resource.webUrl || null,\n      summary: hit?.summary || '',\n      rank: hit?.rank ?? null,\n      createdDateTime: resource.createdDateTime || null,\n      lastModifiedDateTime: resource.lastModifiedDateTime || null,\n      mimeType: resource.file?.mimeType || null,\n      size: resource.size ?? null,\n      isFolder: Boolean(resource.folder || resource.package),\n      isFile: Boolean(resource.file),\n      driveId: parentReference.driveId || null,\n      siteId: parentReference.siteId || null,\n      parentReference,\n    }\n  }\n\n  let data\n  try {\n    data = await runSearch('NAM')\n  }\n  catch (error) {\n    const fallback = extractFallbackRegion(error)\n    if (!fallback)\n      throw error\n    data = await runSearch(fallback)\n  }\n\n  const container = data?.value?.[0]?.hitsContainers?.[0]\n  const allHits = Array.isArray(container?.hits) ? container.hits.map(flattenHit) : []\n  const hits = allHits.filter((hit) => {\n    if (input.siteId && hit.siteId !== input.siteId)\n      return false\n    if (input.driveId && hit.driveId !== input.driveId)\n      return false\n    return true\n  })\n\n  return {\n    query: input.query,\n    hits,\n    total: container?.total ?? hits.length,\n    moreResultsAvailable: Boolean(container?.moreResultsAvailable),\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "read_file_content",
+        "description": "Read a SharePoint file into agent-friendly text using the shared file extraction pipeline. This is the standard way to consume document contents such as PDF, DOCX, XLSX, PPTX, and text-like files stored in SharePoint document libraries. Provide driveId and itemId. Folders are rejected; use list_drive_children to browse them.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file."
+            },
+            "mimeType": {
+              "type": "string",
+              "description": "Optional MIME type from get_drive_item_meta or search_files."
+            },
+            "previewPages": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10,
+              "description": "Number of pages to render as images and return alongside the text (PDF only). Omit or set to 0 to skip. Useful for visually checking signatures, logos, or layout."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,parentReference,file,folder,package',\n  )\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}?${params.toString()}`)\n  const item = await res.json()\n  const mimeType = input.mimeType || item?.file?.mimeType || null\n\n  if (item?.folder || item?.package) {\n    return {\n      driveId: input.driveId,\n      itemId: input.itemId,\n      name: item?.name || null,\n      mimeType,\n      content: null,\n      message: 'Folders do not have readable file content.',\n    }\n  }\n\n  const extracted = await utils.extractFileContent({\n    auth: true,\n    source: `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}/content`,\n    previewPages: input.previewPages || 0,\n  })\n\n  return {\n    driveId: input.driveId,\n    itemId: input.itemId,\n    name: item?.name || null,\n    webUrl: item?.webUrl || null,\n    mimeType,\n    ...extracted,\n  }\n}",
+        "scope": "read"
+      },
+      {
+        "name": "create_folder",
+        "description": "Create a new folder in a SharePoint document library. By default the folder is created in the drive root. Provide parentItemId to create it inside an existing folder. Returns the created folder metadata including its item ID for later browsing or moves.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "name"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "name": {
+              "type": "string",
+              "description": "Folder name to create."
+            },
+            "parentItemId": {
+              "type": "string",
+              "description": "Optional parent folder item ID. Omit to create in the drive root."
+            },
+            "conflictBehavior": {
+              "type": "string",
+              "enum": [
+                "rename",
+                "replace",
+                "fail"
+              ],
+              "description": "How Graph should handle name conflicts. Defaults to rename."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const path = input.parentItemId\n    ? `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.parentItemId)}/children`\n    : `/drives/${encodeURIComponent(input.driveId)}/root/children`\n\n  const res = await integration.fetch(path, {\n    method: 'POST',\n    body: {\n      name: input.name,\n      folder: {},\n      '@microsoft.graph.conflictBehavior': input.conflictBehavior || 'rename',\n    },\n  })\n  const item = await res.json()\n  return {\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  }\n}",
+        "scope": "write"
+      },
+      {
+        "name": "move_drive_item",
+        "description": "Move a SharePoint file or folder to a different parent folder in the same drive. Provide destinationParentId and optionally a newName to rename during the move. Use get_drive_item_meta or list_drive_children first to discover the current item and destination IDs.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId",
+            "destinationParentId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder to move."
+            },
+            "destinationParentId": {
+              "type": "string",
+              "description": "Destination folder item ID."
+            },
+            "newName": {
+              "type": "string",
+              "description": "Optional new item name to apply during the move."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const body = {\n    parentReference: {\n      id: input.destinationParentId,\n    },\n  }\n  if (input.newName)\n    body.name = input.newName\n\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}`, {\n    method: 'PATCH',\n    body,\n  })\n  const item = await res.json()\n  return {\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  }\n}",
+        "scope": "write"
+      },
+      {
+        "name": "delete_drive_item",
+        "description": "Delete a SharePoint file or folder by drive ID and item ID. This is a destructive operation. Use get_drive_item_meta or list_drive_children first to confirm you have the correct item before deleting it.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder to delete."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}`, {\n    method: 'DELETE',\n  })\n  if (res.status === 204)\n    return { success: true, status: 204 }\n  try {\n    return await res.json()\n  }\n  catch {\n    return { success: res.ok, status: res.status }\n  }\n}",
+        "scope": "write"
+      }
+    ],
+    "variantOwnerType": null
+  },
+  "sharepoint-folder": {
+    "manifest": {
+      "name": "sharepoint",
+      "version": "0.1.0",
+      "baseUrl": "https://graph.microsoft.com/v1.0",
+      "variantLabel": "Single folder",
+      "variantConfig": [
+        {
+          "key": "site",
+          "label": "Site",
+          "selectionMode": "single",
+          "listHandler": "async (config) => {\n  const res = await integration.fetch('/sites?search=*&$select=id,displayName,name&$top=50')\n  const data = await res.json()\n  if (!Array.isArray(data?.value)) return []\n  return data.value\n    .map(site => ({ id: site.id, name: site.displayName || site.name || site.id }))\n    .filter(s => s.id && s.name)\n}"
+        },
+        {
+          "key": "drive",
+          "label": "Document library",
+          "selectionMode": "single",
+          "listHandler": "async (config) => {\n  if (!config.siteId) return []\n  const res = await integration.fetch(`/sites/${encodeURIComponent(config.siteId)}/drives?$select=id,name,driveType,system`)\n  const data = await res.json()\n  if (!Array.isArray(data?.value)) return []\n  return data.value\n    .filter(d => !d.system)\n    .map(d => ({ id: d.id, name: d.name || d.id }))\n    .filter(d => d.id && d.name)\n}"
+        },
+        {
+          "key": "folder",
+          "label": "Folder",
+          "selectionMode": "single",
+          "listHandler": "async (config) => {\n  if (!config.driveId) return []\n  const res = await integration.fetch(`/drives/${encodeURIComponent(config.driveId)}/root/children?$select=id,name,folder&$top=100`)\n  const data = await res.json()\n  if (!Array.isArray(data?.value)) return []\n  return data.value\n    .filter(item => item.folder)\n    .map(item => ({ id: item.id, name: item.name || item.id }))\n    .filter(item => item.id && item.name)\n}"
+        }
+      ],
+      "tools": [
+        {
+          "name": "list_folder",
+          "description": "List files and folders inside the connected SharePoint folder.",
+          "inputSchema": "../../schemas/list_drive_children.json",
+          "handler": "../../handlers/list_drive_children.js",
+          "scope": "read",
+          "injectFromConfig": {
+            "driveId": "driveId",
+            "itemId": "folderId"
+          }
+        },
+        {
+          "name": "browse_folder",
+          "description": "List files and folders inside a sub-folder by item ID. Use list_folder first to discover sub-folder IDs.",
+          "inputSchema": "../../schemas/list_drive_children.json",
+          "handler": "../../handlers/list_drive_children.js",
+          "scope": "read",
+          "injectFromConfig": {
+            "driveId": "driveId"
+          }
+        },
+        {
+          "name": "get_drive_item_meta",
+          "description": "Get metadata for a file or folder by item ID.",
+          "inputSchema": "../../schemas/get_drive_item.json",
+          "handler": "../../handlers/get_drive_item.js",
+          "scope": "read",
+          "injectFromConfig": {
+            "driveId": "driveId"
+          }
+        },
+        {
+          "name": "search_files",
+          "description": "Search files within the connected document library. KQL syntax is supported.",
+          "inputSchema": "../../schemas/search_files.json",
+          "handler": "../../handlers/search_files.js",
+          "scope": "read",
+          "injectFromConfig": {
+            "siteId": "siteId",
+            "driveId": "driveId"
+          }
+        },
+        {
+          "name": "read_file_content",
+          "description": "Read a file's contents. Provide the file item ID. Use list_folder or search_files to discover file IDs.",
+          "inputSchema": "../../schemas/read_file_content.json",
+          "handler": "../../handlers/read_file_content.js",
+          "scope": "read",
+          "injectFromConfig": {
+            "driveId": "driveId"
+          }
+        },
+        {
+          "name": "create_folder",
+          "description": "Create a new sub-folder inside the connected folder. Omit parentItemId to create directly inside the connected folder.",
+          "inputSchema": "../../schemas/create_folder.json",
+          "handler": "../../handlers/create_folder.js",
+          "scope": "write",
+          "injectFromConfig": {
+            "driveId": "driveId",
+            "parentItemId": "folderId"
+          }
+        },
+        {
+          "name": "move_drive_item",
+          "description": "Move a file or folder to a different parent folder within the document library.",
+          "inputSchema": "../../schemas/move_drive_item.json",
+          "handler": "../../handlers/move_drive_item.js",
+          "scope": "write",
+          "injectFromConfig": {
+            "driveId": "driveId"
+          }
+        },
+        {
+          "name": "delete_drive_item",
+          "description": "Delete a file or folder by item ID.",
+          "inputSchema": "../../schemas/delete_drive_item.json",
+          "handler": "../../handlers/delete_drive_item.js",
+          "scope": "write",
+          "injectFromConfig": {
+            "driveId": "driveId"
+          }
+        }
+      ]
+    },
+    "usageGuide": "Use this integration for SharePoint document libraries and files.\n\nRecommended workflow:\n\n1. If you know the SharePoint hostname and path, start with `get_site_by_path`.\n2. Otherwise use `search_sites` to discover the correct site.\n3. Use `list_site_drives` to find the relevant document library for that site.\n4. Use `list_drive_children` for deterministic folder browsing or `search_files` for broader file discovery.\n5. Use `get_drive_item_meta` when you need compact metadata for a specific file or folder.\n6. Use `read_file_content` to consume the actual contents of a file in agent-friendly text.\n\nNotes:\n\n- `search_files` uses Microsoft Graph search. The `query` field accepts normal keywords and Graph KQL syntax.\n- `siteId` and `driveId` filters on `search_files` are applied to the flattened search results after Graph returns them.\n- `read_file_content` is for files only. Folders do not have readable file content.\n- This v1 integration is intentionally focused on SharePoint sites, document libraries, folders, and files. It does not include classic SharePoint list/list-item tools or file upload.\n",
+    "variants": {
+      "variants": {
+        "app_credentials": {
+          "label": "Microsoft Graph App Credentials",
+          "schema": {
+            "type": "object",
+            "properties": {
+              "tenantId": {
+                "type": "string",
+                "title": "Tenant ID",
+                "description": "Microsoft Entra tenant ID (GUID) that owns the SharePoint tenant."
+              },
+              "clientId": {
+                "type": "string",
+                "title": "Client ID",
+                "description": "Application (client) ID of the Microsoft Entra app registration."
+              },
+              "clientSecret": {
+                "type": "string",
+                "title": "Client Secret",
+                "description": "Client secret value for the Microsoft Entra app registration.",
+                "format": "password"
+              }
+            },
+            "required": [
+              "tenantId",
+              "clientId",
+              "clientSecret"
+            ],
+            "additionalProperties": false
+          },
+          "preprocess": {
+            "type": "handler",
+            "handlerCode": "async (creds, utils) => {\n  const tenantId = String(creds?.tenantId || '').trim()\n  const clientId = String(creds?.clientId || '').trim()\n  const clientSecret = String(creds?.clientSecret || '').trim()\n\n  if (!tenantId)\n    throw new Error('Missing tenantId')\n  if (!clientId)\n    throw new Error('Missing clientId')\n  if (!clientSecret)\n    throw new Error('Missing clientSecret')\n\n  const response = await utils.tokenFetch(\n    `https://login.microsoftonline.com/${encodeURIComponent(tenantId)}/oauth2/v2.0/token`,\n    {\n      method: 'POST',\n      body: new URLSearchParams({\n        grant_type: 'client_credentials',\n        client_id: clientId,\n        client_secret: clientSecret,\n        scope: 'https://graph.microsoft.com/.default',\n      }),\n    },\n  )\n\n  const data = await response.json()\n  if (!response.ok) {\n    const message = typeof data?.error_description === 'string'\n      ? data.error_description\n      : (typeof data?.error === 'string' ? data.error : `Token request failed with status ${response.status}`)\n    throw new Error(message)\n  }\n\n  const token = typeof data?.access_token === 'string' ? data.access_token : ''\n  if (!token)\n    throw new Error('Microsoft token response did not include access_token')\n\n  return {\n    token,\n    expiresIn: data?.expires_in,\n  }\n}",
+            "allowedOrigins": [
+              "https://login.microsoftonline.com"
+            ]
+          },
+          "injection": {
+            "headers": {
+              "Authorization": "Bearer {{token}}"
+            }
+          },
+          "healthCheck": {
+            "notViable": true
+          }
+        }
+      },
+      "default": "app_credentials"
+    },
+    "hint": "1. Create or use a Microsoft Entra app registration for Microsoft Graph at https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade\n2. Create a client secret for that app and copy the **tenant ID**, **client ID**, and **client secret value**.\n3. In Microsoft Graph **Application permissions**, grant at least `Sites.Read.All` and `Files.Read.All`.\n4. If you intend to use write actions such as folder creation, moves, and deletes, also grant `Sites.ReadWrite.All` and `Files.ReadWrite.All`.\n5. Grant admin consent for those application permissions in the tenant.\n6. Paste the tenant ID, client ID, and client secret into this integration. The integration exchanges them for short-lived Microsoft Graph access tokens automatically.",
+    "hintsByVariant": {},
+    "tools": [
+      {
+        "name": "list_folder",
+        "description": "List files and folders inside the connected SharePoint folder.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Optional folder item ID. Omit to list the drive root."
+            },
+            "top": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200,
+              "description": "Maximum number of children to return."
+            },
+            "orderBy": {
+              "type": "string",
+              "description": "Optional Microsoft Graph orderBy expression, such as name or lastModifiedDateTime desc."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const flattenItem = item => ({\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    eTag: item.eTag || null,\n    cTag: item.cTag || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  })\n\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,eTag,cTag,parentReference,file,folder,package',\n  )\n  if (input.top)\n    params.set('$top', String(input.top))\n  if (input.orderBy)\n    params.set('$orderby', input.orderBy)\n\n  const basePath = input.itemId\n    ? `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}/children`\n    : `/drives/${encodeURIComponent(input.driveId)}/root/children`\n\n  const res = await integration.fetch(`${basePath}?${params.toString()}`)\n  const data = await res.json()\n\n  return {\n    driveId: input.driveId,\n    itemId: input.itemId || null,\n    children: Array.isArray(data?.value) ? data.value.map(flattenItem) : [],\n    nextLink: data?.['@odata.nextLink'] || null,\n  }\n}",
+        "scope": "read",
+        "injectFromConfig": {
+          "driveId": "driveId",
+          "itemId": "folderId"
+        }
+      },
+      {
+        "name": "browse_folder",
+        "description": "List files and folders inside a sub-folder by item ID. Use list_folder first to discover sub-folder IDs.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Optional folder item ID. Omit to list the drive root."
+            },
+            "top": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 200,
+              "description": "Maximum number of children to return."
+            },
+            "orderBy": {
+              "type": "string",
+              "description": "Optional Microsoft Graph orderBy expression, such as name or lastModifiedDateTime desc."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const flattenItem = item => ({\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    eTag: item.eTag || null,\n    cTag: item.cTag || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  })\n\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,eTag,cTag,parentReference,file,folder,package',\n  )\n  if (input.top)\n    params.set('$top', String(input.top))\n  if (input.orderBy)\n    params.set('$orderby', input.orderBy)\n\n  const basePath = input.itemId\n    ? `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}/children`\n    : `/drives/${encodeURIComponent(input.driveId)}/root/children`\n\n  const res = await integration.fetch(`${basePath}?${params.toString()}`)\n  const data = await res.json()\n\n  return {\n    driveId: input.driveId,\n    itemId: input.itemId || null,\n    children: Array.isArray(data?.value) ? data.value.map(flattenItem) : [],\n    nextLink: data?.['@odata.nextLink'] || null,\n  }\n}",
+        "scope": "read",
+        "injectFromConfig": {
+          "driveId": "driveId"
+        }
+      },
+      {
+        "name": "get_drive_item_meta",
+        "description": "Get metadata for a file or folder by item ID.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const flattenItem = item => ({\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    eTag: item.eTag || null,\n    cTag: item.cTag || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  })\n\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,eTag,cTag,parentReference,file,folder,package',\n  )\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}?${params.toString()}`)\n  return flattenItem(await res.json())\n}",
+        "scope": "read",
+        "injectFromConfig": {
+          "driveId": "driveId"
+        }
+      },
+      {
+        "name": "search_files",
+        "description": "Search files within the connected document library. KQL syntax is supported.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "query"
+          ],
+          "properties": {
+            "query": {
+              "type": "string",
+              "description": "Search query string. Microsoft Graph KQL syntax is supported."
+            },
+            "siteId": {
+              "type": "string",
+              "description": "Optional site ID to keep only hits from a specific SharePoint site."
+            },
+            "driveId": {
+              "type": "string",
+              "description": "Optional drive ID to keep only hits from a specific document library."
+            },
+            "from": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Offset into the Graph search results."
+            },
+            "size": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 50,
+              "description": "Maximum number of hits to request from Graph."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const extractFallbackRegion = (error) => {\n    const texts = [error?.data?.body, error?.message].filter(s => typeof s === 'string')\n    for (const text of texts) {\n      const match = text.match(/Only valid regions are ([A-Z,\\s]+)/i)\n      const region = match?.[1]?.split(',').map(r => r.trim().toUpperCase()).filter(Boolean)[0]\n      if (region)\n        return region\n    }\n    return null\n  }\n\n  const runSearch = async (region) => {\n    const res = await integration.fetch('/search/query', {\n      method: 'POST',\n      body: {\n        requests: [{\n          entityTypes: ['driveItem'],\n          query: { queryString: input.query },\n          from: typeof input.from === 'number' ? input.from : 0,\n          size: typeof input.size === 'number' ? input.size : 25,\n          region,\n        }],\n      },\n    })\n    return res.json()\n  }\n\n  const flattenHit = (hit) => {\n    const resource = hit?.resource || {}\n    const parentReference = resource.parentReference || {}\n    return {\n      id: resource.id || hit?.hitId || null,\n      name: resource.name || null,\n      webUrl: resource.webUrl || null,\n      summary: hit?.summary || '',\n      rank: hit?.rank ?? null,\n      createdDateTime: resource.createdDateTime || null,\n      lastModifiedDateTime: resource.lastModifiedDateTime || null,\n      mimeType: resource.file?.mimeType || null,\n      size: resource.size ?? null,\n      isFolder: Boolean(resource.folder || resource.package),\n      isFile: Boolean(resource.file),\n      driveId: parentReference.driveId || null,\n      siteId: parentReference.siteId || null,\n      parentReference,\n    }\n  }\n\n  let data\n  try {\n    data = await runSearch('NAM')\n  }\n  catch (error) {\n    const fallback = extractFallbackRegion(error)\n    if (!fallback)\n      throw error\n    data = await runSearch(fallback)\n  }\n\n  const container = data?.value?.[0]?.hitsContainers?.[0]\n  const allHits = Array.isArray(container?.hits) ? container.hits.map(flattenHit) : []\n  const hits = allHits.filter((hit) => {\n    if (input.siteId && hit.siteId !== input.siteId)\n      return false\n    if (input.driveId && hit.driveId !== input.driveId)\n      return false\n    return true\n  })\n\n  return {\n    query: input.query,\n    hits,\n    total: container?.total ?? hits.length,\n    moreResultsAvailable: Boolean(container?.moreResultsAvailable),\n  }\n}",
+        "scope": "read",
+        "injectFromConfig": {
+          "siteId": "siteId",
+          "driveId": "driveId"
+        }
+      },
+      {
+        "name": "read_file_content",
+        "description": "Read a file's contents. Provide the file item ID. Use list_folder or search_files to discover file IDs.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file."
+            },
+            "mimeType": {
+              "type": "string",
+              "description": "Optional MIME type from get_drive_item_meta or search_files."
+            },
+            "previewPages": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10,
+              "description": "Number of pages to render as images and return alongside the text (PDF only). Omit or set to 0 to skip. Useful for visually checking signatures, logos, or layout."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const params = new URLSearchParams()\n  params.set(\n    '$select',\n    'id,name,webUrl,size,createdDateTime,lastModifiedDateTime,parentReference,file,folder,package',\n  )\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}?${params.toString()}`)\n  const item = await res.json()\n  const mimeType = input.mimeType || item?.file?.mimeType || null\n\n  if (item?.folder || item?.package) {\n    return {\n      driveId: input.driveId,\n      itemId: input.itemId,\n      name: item?.name || null,\n      mimeType,\n      content: null,\n      message: 'Folders do not have readable file content.',\n    }\n  }\n\n  const extracted = await utils.extractFileContent({\n    auth: true,\n    source: `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}/content`,\n    previewPages: input.previewPages || 0,\n  })\n\n  return {\n    driveId: input.driveId,\n    itemId: input.itemId,\n    name: item?.name || null,\n    webUrl: item?.webUrl || null,\n    mimeType,\n    ...extracted,\n  }\n}",
+        "scope": "read",
+        "injectFromConfig": {
+          "driveId": "driveId"
+        }
+      },
+      {
+        "name": "create_folder",
+        "description": "Create a new sub-folder inside the connected folder. Omit parentItemId to create directly inside the connected folder.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "name"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "name": {
+              "type": "string",
+              "description": "Folder name to create."
+            },
+            "parentItemId": {
+              "type": "string",
+              "description": "Optional parent folder item ID. Omit to create in the drive root."
+            },
+            "conflictBehavior": {
+              "type": "string",
+              "enum": [
+                "rename",
+                "replace",
+                "fail"
+              ],
+              "description": "How Graph should handle name conflicts. Defaults to rename."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const path = input.parentItemId\n    ? `/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.parentItemId)}/children`\n    : `/drives/${encodeURIComponent(input.driveId)}/root/children`\n\n  const res = await integration.fetch(path, {\n    method: 'POST',\n    body: {\n      name: input.name,\n      folder: {},\n      '@microsoft.graph.conflictBehavior': input.conflictBehavior || 'rename',\n    },\n  })\n  const item = await res.json()\n  return {\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  }\n}",
+        "scope": "write",
+        "injectFromConfig": {
+          "driveId": "driveId",
+          "parentItemId": "folderId"
+        }
+      },
+      {
+        "name": "move_drive_item",
+        "description": "Move a file or folder to a different parent folder within the document library.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId",
+            "destinationParentId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder to move."
+            },
+            "destinationParentId": {
+              "type": "string",
+              "description": "Destination folder item ID."
+            },
+            "newName": {
+              "type": "string",
+              "description": "Optional new item name to apply during the move."
+            }
+          },
+          "additionalProperties": false
+        },
+        "handlerCode": "async (input) => {\n  const body = {\n    parentReference: {\n      id: input.destinationParentId,\n    },\n  }\n  if (input.newName)\n    body.name = input.newName\n\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}`, {\n    method: 'PATCH',\n    body,\n  })\n  const item = await res.json()\n  return {\n    id: item.id,\n    name: item.name || null,\n    webUrl: item.webUrl || null,\n    size: item.size ?? null,\n    createdDateTime: item.createdDateTime || null,\n    lastModifiedDateTime: item.lastModifiedDateTime || null,\n    mimeType: item.file?.mimeType || null,\n    isFolder: Boolean(item.folder || item.package),\n    isFile: Boolean(item.file),\n    childCount: item.folder?.childCount ?? null,\n    parentReference: item.parentReference || null,\n  }\n}",
+        "scope": "write",
+        "injectFromConfig": {
+          "driveId": "driveId"
+        }
+      },
+      {
+        "name": "delete_drive_item",
+        "description": "Delete a file or folder by item ID.",
+        "inputSchema": {
+          "$schema": "http://json-schema.org/draft-07/schema#",
+          "type": "object",
+          "required": [
+            "driveId",
+            "itemId"
+          ],
+          "properties": {
+            "driveId": {
+              "type": "string",
+              "description": "Document library drive ID."
+            },
+            "itemId": {
+              "type": "string",
+              "description": "Drive item ID for the file or folder to delete."
             }
-          }
+          },
+          "additionalProperties": false
         },
-        "handlerCode": "async (input) => {\n  const body = {\n    title: input.title || undefined,\n    description: input.description || undefined,\n    properties: input.properties || undefined,\n    archived: input.archived === undefined ? undefined : input.archived,\n  }\n  const res = await integration.fetch(`/databases/${encodeURIComponent(input.database_id)}`, { method: 'PATCH', body })\n  return await res.json()\n}",
+        "handlerCode": "async (input) => {\n  const res = await integration.fetch(`/drives/${encodeURIComponent(input.driveId)}/items/${encodeURIComponent(input.itemId)}`, {\n    method: 'DELETE',\n  })\n  if (res.status === 204)\n    return { success: true, status: 204 }\n  try {\n    return await res.json()\n  }\n  catch {\n    return { success: res.ok, status: res.status }\n  }\n}",
         "scope": "write",
-        "toolset": "databases"
+        "injectFromConfig": {
+          "driveId": "driveId"
+        }
       }
     ],
-    "variantOwnerType": null
+    "variantOwnerType": "sharepoint"
   },
   "trello": {
     "manifest": {
@@ -16090,7 +17023,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": null,
+    "usageGuide": null,
     "variants": {
       "variants": {
         "api_key_token": {
@@ -17071,7 +18004,7 @@ const GENERATED_INTEGRATIONS = {
         }
       ]
     },
-    "prompt": null,
+    "usageGuide": null,
     "variants": {
       "variants": {
         "api_key_token": {
@@ -17737,6 +18670,10 @@ function cloneCredentialVariant(variant) {
       headers: ((_a = variant.injection) == null ? void 0 : _a.headers) ? { ...variant.injection.headers } : void 0,
       query: ((_b = variant.injection) == null ? void 0 : _b.query) ? { ...variant.injection.query } : void 0
     },
+    preprocess: typeof variant.preprocess === "object" && variant.preprocess !== null ? {
+      ...variant.preprocess,
+      allowedOrigins: Array.isArray(variant.preprocess.allowedOrigins) ? [...variant.preprocess.allowedOrigins] : void 0
+    } : variant.preprocess,
     healthCheck: "path" in variant.healthCheck ? { ...variant.healthCheck } : { notViable: true }
   };
 }
@@ -17785,9 +18722,9 @@ function loadIntegrationManifest(type) {
   const entry = getIntegration(type);
   return entry ? cloneManifest(entry.manifest) : null;
 }
-function loadIntegrationPrompt(type) {
+function loadIntegrationUsageGuide(type) {
   var _a, _b;
-  return (_b = (_a = getIntegration(type)) == null ? void 0 : _a.prompt) != null ? _b : null;
+  return (_b = (_a = getIntegration(type)) == null ? void 0 : _a.usageGuide) != null ? _b : null;
 }
 function loadIntegrationToolsets(type) {
   var _a;
@@ -17992,6 +18929,35 @@ function makeIntegrationToolName(type, name, nodeId) {
   return `${base}${suffix}`;
 }
 
+const hoistedArtifactsByResult = /* @__PURE__ */ new WeakMap();
+function attachHoistedArtifacts(result, artifacts) {
+  if (artifacts.length)
+    hoistedArtifactsByResult.set(result, artifacts);
+  return result;
+}
+function getHoistedArtifacts(result) {
+  var _a;
+  return (_a = hoistedArtifactsByResult.get(result)) != null ? _a : [];
+}
+function hoistExtractFileContentArtifacts(result) {
+  if (!result || typeof result !== "object" || Array.isArray(result))
+    return { cleanedResult: result, artifacts: [] };
+  const images = Array.isArray(result.pageImages) ? result.pageImages.filter((value) => typeof value === "string") : [];
+  if (!images.length)
+    return { cleanedResult: result, artifacts: [] };
+  const { pageImages: _dropped, ...rest } = result;
+  return {
+    cleanedResult: rest,
+    artifacts: images.map((data) => ({
+      type: "image",
+      mimeType: "image/jpeg",
+      data
+    }))
+  };
+}
+
+const EXECUTION_RESULT = /* @__PURE__ */ Symbol("executionResult");
+const EXECUTION_HOISTED_ARTIFACTS = /* @__PURE__ */ Symbol("executionHoistedArtifacts");
 function createSafeHandlerFromString(handlerString, getIntegration, utils) {
   const realConsole = console;
   const isolatedConsole = {
@@ -18061,7 +19027,15 @@ function createSafeHandlerFromString(handlerString, getIntegration, utils) {
   const code = `module.exports = async function(input) { return (${handlerString})(input) }`;
   const script = new vm.Script(code);
   script.runInContext(context);
-  return withLogging(context.module.exports, isolatedConsole);
+  return withLogging(async (args) => {
+    const hoistedArtifacts = [];
+    context.utils = createRuntimeUtils(utils, hoistedArtifacts);
+    const result = await context.module.exports(args);
+    return {
+      [EXECUTION_RESULT]: result,
+      [EXECUTION_HOISTED_ARTIFACTS]: hoistedArtifacts
+    };
+  }, isolatedConsole);
 }
 function withLogging(handler, vmConsole) {
   function safeSerializeForLog(value) {
@@ -18099,8 +19073,14 @@ function withLogging(handler, vmConsole) {
           logs.push(line);
         originalLog.apply(vmConsole, args2);
       };
-      const result = await handler(args);
-      return { success: true, result, logs };
+      const execution = await handler(args);
+      const { result, hoistedArtifacts } = unwrapExecutionEnvelope(execution);
+      const toolRunResult = {
+        success: true,
+        result,
+        logs
+      };
+      return hoistedArtifacts.length ? attachHoistedArtifacts(toolRunResult, hoistedArtifacts) : toolRunResult;
     } catch (err) {
       logs.push((err == null ? void 0 : err.stack) || String(err));
       const result = err && typeof err === "object" ? {
@@ -18115,6 +19095,32 @@ function withLogging(handler, vmConsole) {
     }
   };
 }
+function createRuntimeUtils(baseUtils, hoistedArtifacts) {
+  const runtimeUtils = { ...baseUtils || {} };
+  const extractFileContent = runtimeUtils.extractFileContent;
+  if (typeof extractFileContent === "function") {
+    runtimeUtils.extractFileContent = async (...args) => {
+      const extracted = await extractFileContent(...args);
+      const { cleanedResult, artifacts } = hoistExtractFileContentArtifacts(extracted);
+      hoistedArtifacts.push(...artifacts);
+      return cleanedResult;
+    };
+  }
+  return runtimeUtils;
+}
+function unwrapExecutionEnvelope(value) {
+  if (!value || typeof value !== "object" || !(EXECUTION_RESULT in value)) {
+    return {
+      result: value,
+      hoistedArtifacts: []
+    };
+  }
+  const envelope = value;
+  return {
+    result: envelope[EXECUTION_RESULT],
+    hoistedArtifacts: Array.isArray(envelope[EXECUTION_HOISTED_ARTIFACTS]) ? envelope[EXECUTION_HOISTED_ARTIFACTS] : []
+  };
+}
 
 const turndown = new TurndownService({
   headingStyle: "atx",
@@ -18609,7 +19615,10 @@ function createGetIntegration(integrations, proxy) {
 
 const EXTRACT_FILE_PY = `#!/usr/bin/env python3
 import argparse
+import base64
 import csv
+import email
+import email.policy
 import html
 import json
 import mimetypes
@@ -18619,6 +19628,18 @@ from pathlib import Path
 
 from markitdown import MarkItDown
 
+try:
+    import fitz  # PyMuPDF
+    _FITZ_AVAILABLE = True
+except ImportError:
+    _FITZ_AVAILABLE = False
+
+try:
+    import extract_msg as _extract_msg
+    _EXTRACT_MSG_AVAILABLE = True
+except ImportError:
+    _EXTRACT_MSG_AVAILABLE = False
+
 
 def collapse_whitespace(value: str) -> str:
     return re.sub(r"\\s+", " ", value or "").strip()
@@ -18663,6 +19684,12 @@ def sniff_kind(path: Path) -> str:
     suffix = path.suffix.lower()
     if suffix in DIRECT_TEXT_EXTENSIONS | MARKITDOWN_EXTENSIONS:
         return suffix.lstrip(".")
+    if suffix == ".msg":
+        return "msg"
+    if suffix == ".eml":
+        return "eml"
+    if suffix == ".zip":
+        return "zip"
 
     mime_guess, _ = mimetypes.guess_type(path.name)
     if mime_guess == "application/pdf":
@@ -18682,10 +19709,78 @@ def sniff_kind(path: Path) -> str:
                 return "xlsx"
             if "ppt/presentation.xml" in names:
                 return "pptx"
+        return "zip"
 
     return "unknown"
 
 
+def parse_pdf_date(date_str: str):
+    """Parse a PDF date string (D:YYYYMMDDHHmmSS...) to ISO-8601."""
+    if not date_str or not isinstance(date_str, str) or not date_str.startswith("D:"):
+        return None
+    try:
+        raw = date_str[2:]
+        m = re.match(r"(\\d{4})(\\d{2})(\\d{2})(\\d{2})(\\d{2})(\\d{2})", raw)
+        if not m:
+            return None
+        y, mo, d, h, mi, s = m.groups()
+        return f"{y}-{mo}-{d}T{h}:{mi}:{s}Z"
+    except Exception:
+        return None
+
+
+def get_xlsx_sheet_names(path: Path) -> list:
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            if "xl/workbook.xml" not in archive.namelist():
+                return []
+            content = archive.read("xl/workbook.xml").decode("utf-8", errors="replace")
+            return re.findall(r'<sheet\\b[^>]+\\bname="([^"]+)"', content)
+    except Exception:
+        return []
+
+
+def get_pptx_slide_count(path: Path) -> int:
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            return sum(
+                1 for name in archive.namelist()
+                if re.match(r"ppt/slides/slide\\d+\\.xml$", name)
+            )
+    except Exception:
+        return 0
+
+
+def get_office_core_props(path: Path) -> dict:
+    """Read author and lastModifiedBy from docProps/core.xml (all Office formats)."""
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            if "docProps/core.xml" not in archive.namelist():
+                return {}
+            content = archive.read("docProps/core.xml").decode("utf-8", errors="replace")
+            props = {}
+            m = re.search(r"<dc:creator[^>]*>([^<]+)</dc:creator>", content)
+            if m:
+                props["author"] = m.group(1).strip()
+            m = re.search(r"<cp:lastModifiedBy[^>]*>([^<]+)</cp:lastModifiedBy>", content)
+            if m:
+                props["lastModifiedBy"] = m.group(1).strip()
+            return props
+    except Exception:
+        return {}
+
+
+def has_tracked_changes_docx(path: Path) -> bool:
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            if "word/document.xml" not in archive.namelist():
+                return False
+            content = archive.read("word/document.xml").decode("utf-8", errors="replace")
+            return bool(re.search(r"<w:(del|ins)\\s", content))
+    except Exception:
+        return False
+
+
 def read_text(path: Path) -> dict:
     content = path.read_text(encoding="utf-8", errors="replace").strip()
     return {"kind": "text", "content": content, "metadata": {"filename": path.name}}
@@ -18749,6 +19844,278 @@ def read_csv_file(path: Path) -> dict:
     }
 
 
+def _strip_html_to_text(raw_html: str) -> str:
+    """Strip HTML to plain text, removing style/script blocks first."""
+    text = re.sub(r"<style[^>]*>[\\s\\S]*?</style>", " ", raw_html, flags=re.IGNORECASE)
+    text = re.sub(r"<script[^>]*>[\\s\\S]*?<\/script>", " ", text, flags=re.IGNORECASE)
+    text = re.sub(r"<br\\s*/?>", "\\n", text, flags=re.IGNORECASE)
+    text = re.sub(r"</(p|div|li|tr|h[1-6])>", "\\n", text, flags=re.IGNORECASE)
+    text = re.sub(r"<[^>]+>", " ", text)
+    text = html.unescape(text)
+    return re.sub(r"\\s+", " ", text).strip()
+
+
+def read_msg(path: Path) -> dict:
+    import tempfile as _tempfile
+
+    if not _EXTRACT_MSG_AVAILABLE:
+        raise RuntimeError(
+            f"extract-msg is not installed; cannot read {path.name}. "
+            "Install with: pip install extract-msg"
+        )
+
+    try:
+        msg = _extract_msg.openMsg(str(path))
+    except Exception as exc:
+        raise RuntimeError(f"MSG extraction failed for {path.name}: {exc}") from exc
+
+    try:
+        subject = (msg.subject or "").strip() or None
+        sender = (msg.sender or "").strip() or None
+        to = (msg.to or "").strip() or None
+        cc = (msg.cc or "").strip() or None
+        date = str(msg.date).strip() if msg.date else None
+        body = (msg.body or "").strip()
+
+        # Fall back to HTML body stripped to plain text when no plain-text body.
+        if not body:
+            raw_html = getattr(msg, "htmlBody", None) or b""
+            if isinstance(raw_html, bytes):
+                raw_html = raw_html.decode("utf-8", errors="replace")
+            if raw_html:
+                body = _strip_html_to_text(raw_html)
+
+        blocks = []
+        if subject:
+            blocks.append(f"# {subject}")
+        header_lines = []
+        if sender:
+            header_lines.append(f"From: {sender}")
+        if to:
+            header_lines.append(f"To: {to}")
+        if cc:
+            header_lines.append(f"Cc: {cc}")
+        if date:
+            header_lines.append(f"Date: {date}")
+        if header_lines:
+            blocks.append("\\n".join(header_lines))
+        if body:
+            blocks.append(body)
+
+        attachments = list(msg.attachments or [])
+        att_names = []
+        warnings = []
+
+        with _tempfile.TemporaryDirectory() as tmp:
+            tmp_path = Path(tmp)
+            for i, att in enumerate(attachments):
+                att_name = (
+                    getattr(att, "longFilename", None)
+                    or getattr(att, "shortFilename", None)
+                    or ""
+                ).strip() or "attachment"
+                att_names.append(att_name)
+                try:
+                    att_path = None
+
+                    # Primary: use save() \u2014 handles all attachment types including
+                    # OLE embedded objects where .data returns None.
+                    att_dir = tmp_path / f"att_{i}"
+                    att_dir.mkdir()
+                    try:
+                        att.save(customPath=str(att_dir))
+                        saved = list(att_dir.iterdir())
+                        if saved:
+                            att_path = saved[0]
+                    except Exception:
+                        pass
+
+                    # Fallback: direct .data bytes.
+                    if att_path is None:
+                        data = att.data
+                        if data is None:
+                            warnings.append(f"Attachment '{att_name}' has no data.")
+                            continue
+                        att_path = att_dir / att_name
+                        att_path.write_bytes(data)
+
+                    inner = extract(att_path)
+                    inner_content = (inner.get("content") or "").strip()
+                    if inner_content:
+                        blocks.append(f"## Attachment: {att_name}\\n\\n{inner_content}")
+                except Exception as exc:
+                    warnings.append(f"Could not extract attachment '{att_name}': {exc}")
+
+        content = join_blocks(blocks)
+        metadata: dict = {"filename": path.name, "attachmentCount": len(attachments)}
+        if subject:
+            metadata["subject"] = subject
+        if sender:
+            metadata["sender"] = sender
+        if to:
+            metadata["to"] = to
+        if cc:
+            metadata["cc"] = cc
+        if date:
+            metadata["date"] = date
+        if att_names:
+            metadata["attachmentNames"] = att_names
+
+        result: dict = {"kind": "msg", "content": content, "metadata": metadata}
+        if warnings:
+            result["warnings"] = warnings
+        return result
+
+    finally:
+        msg.close()
+
+
+def read_eml(path: Path) -> dict:
+    import tempfile as _tempfile
+
+    raw = path.read_bytes()
+    msg = email.message_from_bytes(raw, policy=email.policy.compat32)
+
+    subject = collapse_whitespace(msg.get("Subject", "") or "")
+    sender = collapse_whitespace(msg.get("From", "") or "")
+    to = collapse_whitespace(msg.get("To", "") or "")
+    cc = collapse_whitespace(msg.get("Cc", "") or "")
+    date = collapse_whitespace(msg.get("Date", "") or "")
+
+    # Walk parts: collect plain-text body and attachments.
+    body_parts = []
+    attachments = []  # list of (filename, bytes)
+
+    for part in msg.walk():
+        content_type = part.get_content_type()
+        disposition = (part.get("Content-Disposition") or "").lower()
+        filename = part.get_filename()
+
+        if filename:
+            try:
+                data = part.get_payload(decode=True)
+                if data:
+                    attachments.append((filename, data))
+            except Exception:
+                pass
+        elif content_type == "text/plain" and "attachment" not in disposition:
+            try:
+                charset = part.get_content_charset() or "utf-8"
+                payload = part.get_payload(decode=True)
+                if payload:
+                    body_parts.append(payload.decode(charset, errors="replace"))
+            except Exception:
+                pass
+
+    body = "\\n\\n".join(p.strip() for p in body_parts if p.strip())
+
+    blocks = []
+    if subject:
+        blocks.append(f"# {subject}")
+    header_lines = []
+    if sender:
+        header_lines.append(f"From: {sender}")
+    if to:
+        header_lines.append(f"To: {to}")
+    if cc:
+        header_lines.append(f"Cc: {cc}")
+    if date:
+        header_lines.append(f"Date: {date}")
+    if header_lines:
+        blocks.append("\\n".join(header_lines))
+    if body:
+        blocks.append(body)
+
+    att_names = []
+    warnings = []
+
+    with _tempfile.TemporaryDirectory() as tmp:
+        tmp_path = Path(tmp)
+        for att_name, data in attachments:
+            att_names.append(att_name)
+            try:
+                att_path = tmp_path / Path(att_name).name
+                att_path.write_bytes(data)
+                inner = extract(att_path)
+                inner_content = (inner.get("content") or "").strip()
+                if inner_content:
+                    blocks.append(f"## Attachment: {att_name}\\n\\n{inner_content}")
+            except Exception as exc:
+                warnings.append(f"Could not extract attachment '{att_name}': {exc}")
+
+    content = join_blocks(blocks)
+    metadata: dict = {"filename": path.name, "attachmentCount": len(attachments)}
+    if subject:
+        metadata["subject"] = subject
+    if sender:
+        metadata["sender"] = sender
+    if to:
+        metadata["to"] = to
+    if cc:
+        metadata["cc"] = cc
+    if date:
+        metadata["date"] = date
+    if att_names:
+        metadata["attachmentNames"] = att_names
+
+    result: dict = {"kind": "eml", "content": content, "metadata": metadata}
+    if warnings:
+        result["warnings"] = warnings
+    return result
+
+
+def read_zip(path: Path) -> dict:
+    import tempfile as _tempfile
+
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            all_names = archive.namelist()
+    except Exception as exc:
+        raise RuntimeError(f"ZIP extraction failed for {path.name}: {exc}") from exc
+
+    # Skip directories and hidden/system files.
+    file_entries = [
+        n for n in all_names
+        if not n.endswith("/") and not Path(n).name.startswith(".")
+    ]
+
+    blocks = []
+    warnings = []
+
+    try:
+        with zipfile.ZipFile(path, "r") as archive:
+            with _tempfile.TemporaryDirectory() as tmp:
+                tmp_path = Path(tmp)
+                for entry in file_entries:
+                    entry_name = Path(entry).name
+                    if not entry_name:
+                        continue
+                    try:
+                        data = archive.read(entry)
+                        entry_path = tmp_path / entry_name
+                        entry_path.write_bytes(data)
+                        inner = extract(entry_path)
+                        inner_content = (inner.get("content") or "").strip()
+                        if inner_content:
+                            blocks.append(f"## {entry}\\n\\n{inner_content}")
+                    except Exception as exc:
+                        warnings.append(f"Could not extract '{entry}': {exc}")
+    except Exception as exc:
+        raise RuntimeError(f"ZIP extraction failed for {path.name}: {exc}") from exc
+
+    content = join_blocks(blocks)
+    metadata: dict = {
+        "filename": path.name,
+        "fileCount": len(file_entries),
+        "fileNames": file_entries,
+    }
+
+    result: dict = {"kind": "zip", "content": content, "metadata": metadata}
+    if warnings:
+        result["warnings"] = warnings
+    return result
+
+
 def read_with_markitdown(path: Path, kind: str) -> dict:
     try:
         result = MarkItDown().convert(str(path))
@@ -18756,14 +20123,132 @@ def read_with_markitdown(path: Path, kind: str) -> dict:
         raise RuntimeError(f"MarkItDown extraction failed for {path.name}: {exc}") from exc
 
     content = (getattr(result, "text_content", "") or "").strip()
+    metadata: dict = {"filename": path.name, "parser": "markitdown"}
+
+    # XLSX: surface sheet names so the agent knows the workbook structure upfront.
+    if kind == "xlsx":
+        sheet_names = get_xlsx_sheet_names(path)
+        if sheet_names:
+            metadata["sheetNames"] = sheet_names
+
+    # DOCX: tracked changes flag + author metadata from core properties.
+    if kind == "docx":
+        metadata["hasTrackedChanges"] = has_tracked_changes_docx(path)
+        core = get_office_core_props(path)
+        if core.get("author"):
+            metadata["author"] = core["author"]
+        if core.get("lastModifiedBy"):
+            metadata["lastModifiedBy"] = core["lastModifiedBy"]
+
+    # PPTX: slide count.
+    if kind == "pptx":
+        count = get_pptx_slide_count(path)
+        if count:
+            metadata["slideCount"] = count
+
     return {
         "kind": kind,
         "content": content,
-        "metadata": {"filename": path.name, "parser": "markitdown"},
+        "metadata": metadata,
     }
 
 
-def extract(path: Path) -> dict:
+def read_pdf(path: Path, preview_pages: int = 0) -> dict:
+    # Text extraction via MarkItDown (higher quality than pymupdf for most PDFs).
+    try:
+        md_result = MarkItDown().convert(str(path))
+        content = (getattr(md_result, "text_content", "") or "").strip()
+    except Exception as exc:
+        raise RuntimeError(f"MarkItDown extraction failed for {path.name}: {exc}") from exc
+
+    metadata: dict = {"filename": path.name, "parser": "markitdown"}
+
+    if not _FITZ_AVAILABLE:
+        return {"kind": "pdf", "content": content, "metadata": metadata}
+
+    page_images = []
+
+    try:
+        doc = fitz.open(str(path))
+        page_count = doc.page_count
+        metadata["pageCount"] = page_count
+
+        # Document info dictionary (title, author, etc.)
+        info = doc.metadata or {}
+        for src_key, out_key in [
+            ("title", "title"),
+            ("author", "author"),
+            ("subject", "subject"),
+            ("keywords", "keywords"),
+            ("creator", "creator"),
+        ]:
+            val = (info.get(src_key) or "").strip()
+            if val:
+                metadata[out_key] = val
+
+        created = parse_pdf_date(info.get("creationDate", ""))
+        if created:
+            metadata["createdAt"] = created
+        modified = parse_pdf_date(info.get("modDate", ""))
+        if modified:
+            metadata["modifiedAt"] = modified
+
+        metadata["isEncrypted"] = bool(doc.is_encrypted)
+
+        # Single pass over all pages: signatures, annotations, form fields.
+        sig_widget_type = getattr(fitz, "PDF_WIDGET_TYPE_SIGNATURE", 7)
+        non_content_annot_types = {"Widget", "Link"}
+        has_annotations = False
+        has_form_fields = False
+        signatures = []
+
+        for i in range(page_count):
+            page = doc.load_page(i)
+
+            # Widgets: split into signatures and fillable form fields.
+            for widget in (page.widgets() or []):
+                if widget.field_type == sig_widget_type:
+                    signer = (widget.field_value or "").strip() or None
+                    signatures.append({
+                        "fieldName": (widget.field_name or "").strip() or None,
+                        "signer": signer,
+                        "isSigned": bool(signer),
+                    })
+                else:
+                    has_form_fields = True
+
+            # Annotations: exclude widget and link annotations.
+            if not has_annotations:
+                for annot in page.annots():
+                    if annot.type[1] not in non_content_annot_types:
+                        has_annotations = True
+                        break
+
+        metadata["hasAnnotations"] = has_annotations
+        metadata["hasFormFields"] = has_form_fields
+        if signatures:
+            metadata["signatures"] = signatures
+
+        # Page preview images (opt-in via previewPages > 0).
+        if preview_pages > 0:
+            n = min(preview_pages, page_count)
+            for i in range(n):
+                pixmap = doc.load_page(i).get_pixmap(dpi=96)
+                jpeg_bytes = pixmap.tobytes("jpeg")
+                page_images.append(base64.b64encode(jpeg_bytes).decode("ascii"))
+
+        doc.close()
+
+    except Exception:
+        pass  # Metadata and image enhancement is best-effort; don't fail the extraction.
+
+    result: dict = {"kind": "pdf", "content": content, "metadata": metadata}
+    if page_images:
+        result["pageImages"] = page_images
+    return result
+
+
+def extract(path: Path, preview_pages: int = 0) -> dict:
     kind = sniff_kind(path)
     if kind == "txt":
         return read_text(path)
@@ -18775,7 +20260,15 @@ def extract(path: Path) -> dict:
         return read_html(path)
     if kind == "csv":
         return read_csv_file(path)
-    if path.suffix.lower() in MARKITDOWN_EXTENSIONS or kind in {"pdf", "doc", "docx", "xls", "xlsx", "ppt", "pptx"}:
+    if kind == "pdf":
+        return read_pdf(path, preview_pages)
+    if kind == "msg":
+        return read_msg(path)
+    if kind == "eml":
+        return read_eml(path)
+    if kind == "zip":
+        return read_zip(path)
+    if path.suffix.lower() in MARKITDOWN_EXTENSIONS or kind in {"doc", "docx", "xls", "xlsx", "ppt", "pptx"}:
         return read_with_markitdown(path, kind)
 
     raw = path.read_text(encoding="utf-8", errors="replace")
@@ -18791,12 +20284,13 @@ def main() -> int:
     parser = argparse.ArgumentParser()
     parser.add_argument("--input", required=True)
     parser.add_argument("--output", required=True)
+    parser.add_argument("--preview-pages", type=int, default=0)
     args = parser.parse_args()
 
     input_path = Path(args.input)
     output_path = Path(args.output)
 
-    result = extract(input_path)
+    result = extract(input_path, preview_pages=args.preview_pages)
     output_path.write_text(json.dumps(result, ensure_ascii=False), encoding="utf-8")
     return 0
 
@@ -18804,10 +20298,10 @@ def main() -> int:
 if __name__ == "__main__":
     raise SystemExit(main())
 `;
-const EXTRACT_FILE_PY_HASH = "632e2322c14941f8c30b5f60b4c5bb1d773e0d2953fde39a7a16eaf1dbfc21c2";
+const EXTRACT_FILE_PY_HASH = "bc00c9206b20fc39f1ab718271dd49ae335f95c0b1683bf393d0b3f1376d8f33";
 
 const execFile$1 = promisify(execFile$2);
-const INSTALL_COMMAND = "pip3 install markitdown[all]";
+const INSTALL_COMMAND = "pip3 install markitdown[all] pymupdf";
 const DOCKER_HINT = "Run Commandable with Docker to use the preinstalled extraction runtime.";
 let cachedScriptPath = null;
 function ensureExtractorScript() {
@@ -18820,7 +20314,8 @@ function ensureExtractorScript() {
   return path;
 }
 const FILE_PROCESSING_DISABLED_TOOLS = {
-  "google-workspace": ["read_file_content"]
+  "google-workspace": ["read_file_content"],
+  sharepoint: ["read_file_content"]
 };
 let capabilityPromise = null;
 function pythonExecutable() {
@@ -19025,14 +20520,19 @@ function createExtractFileContent(getIntegration, defaultIntegrationId) {
       const outputPath = join(tempDir, "result.json");
       const bytes = Buffer.from(await response.arrayBuffer());
       await writeFile$1(filePath, bytes);
-      await execFile(pythonExecutable(), [extractorScriptPath(), "--input", filePath, "--output", outputPath], { cwd: tempDir, maxBuffer: 10 * 1024 * 1024 });
+      const pythonArgs = [extractorScriptPath(), "--input", filePath, "--output", outputPath];
+      const previewPages = typeof resolvedArgs.previewPages === "number" && resolvedArgs.previewPages > 0 ? Math.floor(resolvedArgs.previewPages) : 0;
+      if (previewPages > 0)
+        pythonArgs.push("--preview-pages", String(previewPages));
+      await execFile(pythonExecutable(), pythonArgs, { cwd: tempDir, maxBuffer: 50 * 1024 * 1024 });
       const raw = await readFile$1(outputPath, "utf8");
       const parsed = JSON.parse(raw);
       return {
         kind: typeof (parsed == null ? void 0 : parsed.kind) === "string" ? parsed.kind : "unknown",
         content: typeof (parsed == null ? void 0 : parsed.content) === "string" ? parsed.content : "",
         warnings: Array.isArray(parsed == null ? void 0 : parsed.warnings) ? parsed.warnings.map((item) => String(item)) : void 0,
-        metadata: (parsed == null ? void 0 : parsed.metadata) && typeof parsed.metadata === "object" ? parsed.metadata : void 0
+        metadata: (parsed == null ? void 0 : parsed.metadata) && typeof parsed.metadata === "object" ? parsed.metadata : void 0,
+        pageImages: Array.isArray(parsed == null ? void 0 : parsed.pageImages) ? parsed.pageImages.filter((v) => typeof v === "string") : void 0
       };
     } catch (error) {
       const stderr = typeof (error == null ? void 0 : error.stderr) === "string" ? error.stderr.trim() : "";
@@ -19157,6 +20657,9 @@ function buildToolsByIntegration(spaceId, integrations, proxy, opts = {}) {
   return toolsByIntegration;
 }
 
+function isHandlerPreprocess(preprocess) {
+  return typeof preprocess === "object" && preprocess !== null && preprocess.type === "handler" && typeof preprocess.handlerCode === "string";
+}
 function getBuiltInIntegrationTypeConfig(typeSlug) {
   var _a, _b, _c, _d;
   const variantsFile = loadIntegrationVariants(typeSlug);
@@ -19168,8 +20671,9 @@ function getBuiltInIntegrationTypeConfig(typeSlug) {
   const variants = {};
   for (const [key, variant] of Object.entries(variantsFile.variants)) {
     const preprocess = (_c = variant.preprocess) != null ? _c : null;
-    if (preprocess !== null && preprocess !== "google_service_account") {
-      throw new Error(`Unsupported preprocess '${preprocess}' for built-in integration '${typeSlug}/${key}'. Only 'google_service_account' is allowed.`);
+    const isSupportedHandler = isHandlerPreprocess(preprocess);
+    if (preprocess !== null && preprocess !== "google_service_account" && !isSupportedHandler) {
+      throw new Error(`Unsupported preprocess for built-in integration '${typeSlug}/${key}'.`);
     }
     variants[key] = {
       label: variant.label,
@@ -19180,7 +20684,11 @@ function getBuiltInIntegrationTypeConfig(typeSlug) {
       allowedOrigins: manifestAllowedOrigins,
       healthCheck: (_d = variant.healthCheck) != null ? _d : null,
       hintMarkdown: loadIntegrationHint(typeSlug, key),
-      preprocess
+      preprocess: isSupportedHandler ? {
+        type: "handler",
+        handlerCode: preprocess.handlerCode,
+        allowedOrigins: Array.isArray(preprocess.allowedOrigins) ? [...preprocess.allowedOrigins] : null
+      } : preprocess
     };
   }
   return {
@@ -19283,6 +20791,28 @@ function buildCredentialUrl(integrationId) {
   const port = portRaw && /^\d+$/.test(portRaw) ? Number(portRaw) : 23432;
   return `http://127.0.0.1:${port}/integrations/${encodeURIComponent(integrationId)}`;
 }
+function decodeJwtPayloadForDebug(token) {
+  try {
+    const parts = token.split(".");
+    if (parts.length < 2 || !parts[1])
+      return null;
+    let b64 = parts[1].replace(/-/g, "+").replace(/_/g, "/");
+    const pad = b64.length % 4 === 0 ? "" : "=".repeat(4 - b64.length % 4);
+    b64 = b64 + pad;
+    const json = Buffer$1.from(b64, "base64").toString("utf8");
+    const payload = JSON.parse(json);
+    return {
+      aud: payload.aud,
+      tid: payload.tid,
+      appid: payload.appid,
+      roles: payload.roles,
+      scp: payload.scp,
+      idtyp: payload.idtyp
+    };
+  } catch {
+    return null;
+  }
+}
 function isAbsoluteHttpUrl(value) {
   try {
     const url = new URL(value);
@@ -19343,71 +20873,163 @@ function resolveRelativeBaseUrl(provider, baseUrl, rawPath) {
     return "https://slides.googleapis.com/v1";
   return baseUrl;
 }
+function joinWithoutDuplicateSegments(baseUrl, rawPath) {
+  let pathOnly = rawPath || "";
+  let queryPart = "";
+  const qIndex = pathOnly.indexOf("?");
+  if (qIndex >= 0) {
+    queryPart = pathOnly.slice(qIndex + 1);
+    pathOnly = pathOnly.slice(0, qIndex);
+  }
+  try {
+    const base = new URL(baseUrl);
+    const baseSegs = base.pathname.split("/").filter(Boolean);
+    const pathSegs = (pathOnly || "/").split("/").filter(Boolean);
+    let overlap = 0;
+    const maxK = Math.min(baseSegs.length, pathSegs.length);
+    for (let k = maxK; k >= 1; k--) {
+      let ok = true;
+      for (let i = 0; i < k; i++) {
+        if (baseSegs[baseSegs.length - k + i] !== pathSegs[i]) {
+          ok = false;
+          break;
+        }
+      }
+      if (ok) {
+        overlap = k;
+        break;
+      }
+    }
+    const normalizedPath = `/${[...baseSegs, ...pathSegs.slice(overlap)].join("/")}`;
+    const baseOrigin = base.origin;
+    const urlNoQuery = `${baseOrigin}${normalizedPath}`;
+    return queryPart ? `${urlNoQuery}?${queryPart}` : urlNoQuery;
+  } catch {
+    const cleanedBase = baseUrl.replace(/\/+$/, "");
+    const cleanedPath = `/${(pathOnly || "").replace(/^\/+/, "")}`;
+    const baseParts = cleanedBase.split("/").filter(Boolean);
+    const pathParts = cleanedPath.split("/").filter(Boolean);
+    let overlap = 0;
+    const maxK = Math.min(baseParts.length, pathParts.length);
+    for (let k = maxK; k >= 1; k--) {
+      let ok = true;
+      for (let i = 0; i < k; i++) {
+        if (baseParts[baseParts.length - k + i] !== pathParts[i]) {
+          ok = false;
+          break;
+        }
+      }
+      if (ok) {
+        overlap = k;
+        break;
+      }
+    }
+    const joined = `/${[...baseParts, ...pathParts.slice(overlap)].join("/")}`;
+    return queryPart ? `${joined}?${queryPart}` : joined;
+  }
+}
+function stableStringify(value) {
+  if (value === null || typeof value !== "object")
+    return JSON.stringify(value);
+  if (Array.isArray(value))
+    return `[${value.map(stableStringify).join(",")}]`;
+  const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b)).map(([key, innerValue]) => `${JSON.stringify(key)}:${stableStringify(innerValue)}`);
+  return `{${entries.join(",")}}`;
+}
+const preprocessResultCache = /* @__PURE__ */ new Map();
+function isHandlerCredentialPreprocess(preprocess) {
+  return typeof preprocess === "object" && preprocess !== null && preprocess.type === "handler" && typeof preprocess.handlerCode === "string";
+}
+function getPreprocessCacheKey(provider, variantKey, creds) {
+  return createHash("sha256").update(`${provider}:${variantKey}:${stableStringify(creds)}`).digest("hex");
+}
+function getExpiresAtMs(result, now) {
+  var _a;
+  const rawExpiresIn = (_a = result.expiresIn) != null ? _a : result.expires_in;
+  const expiresIn = typeof rawExpiresIn === "number" ? rawExpiresIn : typeof rawExpiresIn === "string" && rawExpiresIn.trim() ? Number(rawExpiresIn) : NaN;
+  if (Number.isFinite(expiresIn) && expiresIn > 0)
+    return now + expiresIn * 1e3;
+  return now + 55 * 6e4;
+}
+function normalizeRequestInit(init = {}) {
+  const preparedInit = { ...init };
+  if (preparedInit.body !== void 0 && typeof preparedInit.body !== "string" && !(preparedInit.body instanceof URLSearchParams) && !(preparedInit.body instanceof FormData) && !(preparedInit.body instanceof Blob) && !(preparedInit.body instanceof ArrayBuffer)) {
+    preparedInit.body = JSON.stringify(preparedInit.body);
+    preparedInit.headers = {
+      "Content-Type": "application/json",
+      ...preparedInit.headers
+    };
+  } else if (preparedInit.body instanceof URLSearchParams) {
+    preparedInit.body = preparedInit.body.toString();
+    preparedInit.headers = {
+      "Content-Type": "application/x-www-form-urlencoded",
+      ...preparedInit.headers
+    };
+  }
+  return preparedInit;
+}
+async function runSandboxCredentialPreprocess(params) {
+  var _a, _b;
+  const { provider, variantKey, preprocess, creds, baseUrl, allowedOrigins } = params;
+  const cacheKey = getPreprocessCacheKey(provider, variantKey, creds);
+  const existing = preprocessResultCache.get(cacheKey);
+  const now = Date.now();
+  if (existing && existing.expiresAtMs - now > 6e4) {
+    Object.assign(creds, existing.data);
+    return;
+  }
+  const tokenFetch = async (path, init = {}) => {
+    let finalUrl;
+    if (isAbsoluteHttpUrl(path)) {
+      assertAbsoluteUrlIsAllowed(path, baseUrl, allowedOrigins);
+      finalUrl = path;
+    } else {
+      finalUrl = joinWithoutDuplicateSegments(baseUrl, path);
+    }
+    const preparedInit = normalizeRequestInit(init);
+    return await fetch(finalUrl, {
+      ...preparedInit,
+      method: preparedInit.method || "GET"
+    });
+  };
+  const wrapper = `async (input) => {
+  const __inner = ${preprocess.handlerCode};
+  return await __inner(input, utils)
+}`;
+  const safeHandler = createSafeHandlerFromString(wrapper, () => ({}), { tokenFetch });
+  const res = await safeHandler(creds);
+  if (!res.success)
+    throw new HttpError(400, `Credential preprocess failed for '${provider}': ${String(((_a = res.result) == null ? void 0 : _a.message) || res.result || "Unknown error")}`);
+  const result = res.result;
+  if (!result || typeof result !== "object" || Array.isArray(result))
+    throw new HttpError(400, `Credential preprocess for '${provider}' must return an object.`);
+  if (typeof result.token !== "string" || !result.token.trim())
+    throw new HttpError(400, `Credential preprocess for '${provider}' must return a non-empty 'token' string.`);
+  Object.assign(creds, result);
+  preprocessResultCache.set(cacheKey, {
+    data: { ...result },
+    expiresAtMs: getExpiresAtMs(result, now)
+  });
+  if (provider === "sharepoint") {
+    const t = result == null ? void 0 : result.token;
+    const tokenStr = typeof t === "string" ? t : "";
+    const claims = tokenStr ? decodeJwtPayloadForDebug(tokenStr) : null;
+    const roles = claims == null ? void 0 : claims.roles;
+    const rolesList = Array.isArray(roles) ? roles.map((r) => String(r).slice(0, 80)) : [];
+    fetch("http://127.0.0.1:7886/ingest/d4127044-8bb5-4b15-95f1-be96d51d67ea", { method: "POST", headers: { "Content-Type": "application/json", "X-Debug-Session-Id": "797117" }, body: JSON.stringify({ sessionId: "797117", location: "proxy.ts:runSandboxCredentialPreprocess", message: "sharepoint preprocess ok", data: { variantKey, tokenLen: typeof t === "string" ? t.length : 0, expiresIn: (_b = result == null ? void 0 : result.expiresIn) != null ? _b : result == null ? void 0 : result.expires_in, tokenAud: claims == null ? void 0 : claims.aud, tokenTid: claims == null ? void 0 : claims.tid, tokenAppId: claims == null ? void 0 : claims.appid, tokenIdtyp: claims == null ? void 0 : claims.idtyp, rolesCount: rolesList.length, rolesSample: rolesList.slice(0, 12), hasScp: typeof (claims == null ? void 0 : claims.scp) === "string" && String(claims.scp).length > 0, jwtDecodeOk: !!claims }, timestamp: Date.now(), hypothesisId: "H6" }) }).catch(() => {
+    });
+  }
+}
 class IntegrationProxy {
   constructor(opts = {}) {
     __publicField$4(this, "opts");
     this.opts = opts;
   }
   async call(integration, path, init = {}) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _i;
     const { type: provider } = integration;
     if (!provider || !path)
       throw new HttpError(400, "provider and path are required.");
-    const joinWithoutDuplicateSegments = (baseUrl, rawPath) => {
-      let pathOnly = rawPath || "";
-      let queryPart = "";
-      const qIndex = pathOnly.indexOf("?");
-      if (qIndex >= 0) {
-        queryPart = pathOnly.slice(qIndex + 1);
-        pathOnly = pathOnly.slice(0, qIndex);
-      }
-      try {
-        const base = new URL(baseUrl);
-        const baseSegs = base.pathname.split("/").filter(Boolean);
-        const pathSegs = (pathOnly || "/").split("/").filter(Boolean);
-        let overlap = 0;
-        const maxK = Math.min(baseSegs.length, pathSegs.length);
-        for (let k = maxK; k >= 1; k--) {
-          let ok = true;
-          for (let i = 0; i < k; i++) {
-            if (baseSegs[baseSegs.length - k + i] !== pathSegs[i]) {
-              ok = false;
-              break;
-            }
-          }
-          if (ok) {
-            overlap = k;
-            break;
-          }
-        }
-        const normalizedPath = `/${[...baseSegs, ...pathSegs.slice(overlap)].join("/")}`;
-        const baseOrigin = base.origin;
-        const urlNoQuery = `${baseOrigin}${normalizedPath}`;
-        return queryPart ? `${urlNoQuery}?${queryPart}` : urlNoQuery;
-      } catch {
-        const cleanedBase = baseUrl.replace(/\/+$/, "");
-        const cleanedPath = `/${(pathOnly || "").replace(/^\/+/, "")}`;
-        const baseParts = cleanedBase.split("/").filter(Boolean);
-        const pathParts = cleanedPath.split("/").filter(Boolean);
-        let overlap = 0;
-        const maxK = Math.min(baseParts.length, pathParts.length);
-        for (let k = maxK; k >= 1; k--) {
-          let ok = true;
-          for (let i = 0; i < k; i++) {
-            if (baseParts[baseParts.length - k + i] !== pathParts[i]) {
-              ok = false;
-              break;
-            }
-          }
-          if (ok) {
-            overlap = k;
-            break;
-          }
-        }
-        const joined = `/${[...baseParts, ...pathParts.slice(overlap)].join("/")}`;
-        return queryPart ? `${joined}?${queryPart}` : joined;
-      }
-    };
     const usesCredentials = integration.connectionMethod === "credentials";
     if (usesCredentials) {
       if (!this.opts.credentialStore)
@@ -19498,6 +21120,18 @@ class IntegrationProxy {
           throw new HttpError(400, `Missing OAuth scopes for Google integration '${provider}'.`);
         const token = await getGoogleAccessToken({ serviceAccountJson, scopes, subject });
         creds.token = token;
+      } else if (isHandlerCredentialPreprocess(typeConfig.preprocess)) {
+        await runSandboxCredentialPreprocess({
+          provider,
+          variantKey,
+          preprocess: typeConfig.preprocess,
+          creds,
+          baseUrl,
+          allowedOrigins: [
+            ...typeConfig.allowedOrigins,
+            ...(_f = typeConfig.preprocess.allowedOrigins) != null ? _f : []
+          ]
+        });
       }
       const resolvedHeaders = {};
       const resolvedQuery = new URLSearchParams();
@@ -19510,9 +21144,9 @@ class IntegrationProxy {
         const token = Buffer$1.from(`${username}:${password}`).toString("base64");
         resolvedHeaders.Authorization = `Basic ${token}`;
       } else {
-        for (const [k, v] of Object.entries(((_f = typeConfig.auth.injection) == null ? void 0 : _f.headers) || {}))
+        for (const [k, v] of Object.entries(((_g = typeConfig.auth.injection) == null ? void 0 : _g.headers) || {}))
           resolvedHeaders[k] = resolveTemplate(v);
-        for (const [k, v] of Object.entries(((_g = typeConfig.auth.injection) == null ? void 0 : _g.query) || {}))
+        for (const [k, v] of Object.entries(((_h = typeConfig.auth.injection) == null ? void 0 : _h.query) || {}))
           resolvedQuery.set(k, resolveTemplate(v));
       }
       let finalUrl;
@@ -19525,14 +21159,7 @@ class IntegrationProxy {
       const queryString = resolvedQuery.toString();
       if (queryString)
         finalUrl = finalUrl + (finalUrl.includes("?") ? "&" : "?") + queryString;
-      const preparedInit = { ...init };
-      if (preparedInit.body !== void 0 && typeof preparedInit.body !== "string") {
-        preparedInit.body = JSON.stringify(preparedInit.body);
-        preparedInit.headers = {
-          "Content-Type": "application/json",
-          ...preparedInit.headers
-        };
-      }
+      const preparedInit = normalizeRequestInit(init);
       const redact = (s) => {
         let out = s;
         for (const val of Object.values(creds)) {
@@ -19541,6 +21168,18 @@ class IntegrationProxy {
         }
         return out;
       };
+      if (provider === "sharepoint") {
+        const auth = resolvedHeaders.Authorization;
+        const bodyString = typeof preparedInit.body === "string" ? preparedInit.body : "";
+        fetch("http://127.0.0.1:7886/ingest/d4127044-8bb5-4b15-95f1-be96d51d67ea", { method: "POST", headers: { "Content-Type": "application/json", "X-Debug-Session-Id": "797117" }, body: JSON.stringify({ sessionId: "797117", location: "proxy.ts:before-fetch", message: "sharepoint outgoing", data: { method: preparedInit.method || "GET", pathPreview: String(path).slice(0, 200), finalUrlHost: (() => {
+          try {
+            return new URL(finalUrl).host;
+          } catch {
+            return "invalid-url";
+          }
+        })(), hasAuthHeader: !!auth, authPrefix: auth ? String(auth).slice(0, 8) : "", tokenFieldLen: typeof creds.token === "string" ? creds.token.length : 0, bodyPreview: bodyString.slice(0, 300), bodyHasRegion: bodyString.includes('"region"'), isSearchQuery: String(path).includes("/search/query"), isRegionLookup: String(path).includes("siteCollection/root ne null") }, timestamp: Date.now(), hypothesisId: String(path).includes("/search/query") || String(path).includes("siteCollection/root ne null") ? "H9" : "H1" }) }).catch(() => {
+        });
+      }
       const response = await fetch(finalUrl, {
         ...preparedInit,
         method: preparedInit.method || "GET",
@@ -19556,6 +21195,23 @@ class IntegrationProxy {
           bodyText = contentType.includes("json") ? JSON.stringify(await response.json()) : await response.text();
         } catch {
         }
+        if (provider === "sharepoint") {
+          const auth = resolvedHeaders.Authorization;
+          let graphErrorCode = "";
+          try {
+            const parsed = JSON.parse(bodyText);
+            graphErrorCode = String(((_i = parsed == null ? void 0 : parsed.error) == null ? void 0 : _i.code) || (parsed == null ? void 0 : parsed.error) || "");
+          } catch {
+          }
+          fetch("http://127.0.0.1:7886/ingest/d4127044-8bb5-4b15-95f1-be96d51d67ea", { method: "POST", headers: { "Content-Type": "application/json", "X-Debug-Session-Id": "797117" }, body: JSON.stringify({ sessionId: "797117", location: "proxy.ts:graph-error", message: "sharepoint graph non-ok", data: { status: response.status, pathPreview: String(path).slice(0, 160), finalUrlHost: (() => {
+            try {
+              return new URL(finalUrl).host;
+            } catch {
+              return "invalid-url";
+            }
+          })(), hasAuthHeader: !!auth, authPrefix: auth ? String(auth).slice(0, 8) : "", graphErrorCode: graphErrorCode.slice(0, 80), bodyPreview: bodyText.slice(0, 220) }, timestamp: Date.now(), hypothesisId: "H2" }) }).catch(() => {
+          });
+        }
         const hint = getErrorHint(response.status, provider, bodyText);
         const hintSuffix = hint ? ` ${hint}` : "";
         const credentialUrl = buildCredentialUrl(integration.id);
@@ -20835,7 +22491,7 @@ ${lines ? `${lines}
 ` : "No integrations configured yet.\n"}`;
       }
       try {
-        return loadIntegrationPrompt(ability.integrationtype);
+        return loadIntegrationUsageGuide(ability.integrationtype);
       } catch {
         return null;
       }
@@ -21435,6 +23091,32 @@ function formatAsText(value) {
     return String(value);
   }
 }
+function renderArtifact(artifact) {
+  if (artifact.type === "image" && artifact.data) {
+    return [{
+      type: "image",
+      data: artifact.data,
+      mimeType: artifact.mimeType
+    }];
+  }
+  if (artifact.type === "image" && artifact.url) {
+    return [{
+      type: "text",
+      text: `Image artifact URL (${artifact.mimeType}): ${artifact.url}`
+    }];
+  }
+  return [];
+}
+function buildToolSuccessContent(res) {
+  var _a;
+  const artifacts = getHoistedArtifacts(res);
+  return [
+    { type: "text", text: formatAsText(res.result) },
+    ...artifacts.flatMap(renderArtifact),
+    ...((_a = res.logs) == null ? void 0 : _a.length) ? [{ type: "text", text: `Logs:
+${res.logs.join("\n")}` }] : []
+  ];
+}
 function registerToolHandlers(server, tools, options = { mode: "static" }) {
   const metaToolDefs = getMetaToolDefinitions();
   const { mode, dynamicMode } = options;
@@ -21452,7 +23134,7 @@ function registerToolHandlers(server, tools, options = { mode: "static" }) {
     return { tools: [...metaToolDefs, ...toolDefs] };
   });
   server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
-    var _a, _b, _c, _d, _e;
+    var _a, _b, _c;
     const name = req.params.name;
     const args = (_a = req.params.arguments) != null ? _a : {};
     const sessionId = extra == null ? void 0 : extra.sessionId;
@@ -21490,11 +23172,7 @@ ${res2.logs.join("\n")}` }] : []
         };
       }
       return {
-        content: [
-          { type: "text", text: formatAsText(res2.result) },
-          ...((_c = res2.logs) == null ? void 0 : _c.length) ? [{ type: "text", text: `Logs:
-${res2.logs.join("\n")}` }] : []
-        ]
+        content: buildToolSuccessContent(res2)
       };
     }
     const staticMeta = handleStaticReadmeCall(name);
@@ -21511,17 +23189,13 @@ ${res2.logs.join("\n")}` }] : []
       return {
         content: [
           { type: "text", text: `Tool error: ${formatAsText(res.result)}` },
-          ...((_d = res.logs) == null ? void 0 : _d.length) ? [{ type: "text", text: `Logs:
+          ...((_c = res.logs) == null ? void 0 : _c.length) ? [{ type: "text", text: `Logs:
 ${res.logs.join("\n")}` }] : []
         ]
       };
     }
     return {
-      content: [
-        { type: "text", text: formatAsText(res.result) },
-        ...((_e = res.logs) == null ? void 0 : _e.length) ? [{ type: "text", text: `Logs:
-${res.logs.join("\n")}` }] : []
-      ]
+      content: buildToolSuccessContent(res)
     };
   });
 }
@@ -21941,140 +23615,140 @@ const assets = {
   "/favicon.ico": {
     "type": "image/vnd.microsoft.icon",
     "etag": "\"10be-n8egyE9tcb7sKGr/pYCaQ4uWqxI\"",
-    "mtime": "2026-04-05T18:35:56.190Z",
+    "mtime": "2026-04-12T18:58:38.513Z",
     "size": 4286,
     "path": "../public/favicon.ico"
   },
   "/_fonts/57NSSoFy1VLVs2gqly8Ls9awBnZMFyXGrefpmqvdqmc-zJfbBtpgM4cDmcXBsqZNW79_kFnlpPd62b48glgdydA.woff2": {
     "type": "font/woff2",
     "etag": "\"4b5c-TAo9mx7r3xQs52+HbHcHJ52z8Qo\"",
-    "mtime": "2026-04-05T18:35:56.183Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 19292,
     "path": "../public/_fonts/57NSSoFy1VLVs2gqly8Ls9awBnZMFyXGrefpmqvdqmc-zJfbBtpgM4cDmcXBsqZNW79_kFnlpPd62b48glgdydA.woff2"
   },
   "/_fonts/8VR2wSMN-3U4NbWAVYXlkRV6hA0jFBXP-0RtL3X7fko-x2gYI4qfmkRdxyQQUPaBZdZdgl1TeVrquF_TxHeM4lM.woff2": {
     "type": "font/woff2",
     "etag": "\"212c-FshXJibFzNhd2HEIMP8C3JR5PYg\"",
-    "mtime": "2026-04-05T18:35:56.183Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 8492,
     "path": "../public/_fonts/8VR2wSMN-3U4NbWAVYXlkRV6hA0jFBXP-0RtL3X7fko-x2gYI4qfmkRdxyQQUPaBZdZdgl1TeVrquF_TxHeM4lM.woff2"
   },
   "/_fonts/GsKUclqeNLJ96g5AU593ug6yanivOiwjW_7zESNPChw-jHA4tBeM1bjF7LATGUpfBuSTyomIFrWBTzjF7txVYfg.woff2": {
     "type": "font/woff2",
     "etag": "\"680c-mJtsV33lkTAKSmfq5k3lKHSllcU\"",
-    "mtime": "2026-04-05T18:35:56.183Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 26636,
     "path": "../public/_fonts/GsKUclqeNLJ96g5AU593ug6yanivOiwjW_7zESNPChw-jHA4tBeM1bjF7LATGUpfBuSTyomIFrWBTzjF7txVYfg.woff2"
   },
   "/_fonts/Ld1FnTo3yTIwDyGfTQ5-Fws9AWsCbKfMvgxduXr7JcY-W25bL8NF1fjpLRSOgJb7RoZPHqGQNwMTM7S9tHVoxx8.woff2": {
     "type": "font/woff2",
     "etag": "\"6ec4-8OoFFPZKF1grqmfGVjh5JDE6DOU\"",
-    "mtime": "2026-04-05T18:35:56.184Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 28356,
     "path": "../public/_fonts/Ld1FnTo3yTIwDyGfTQ5-Fws9AWsCbKfMvgxduXr7JcY-W25bL8NF1fjpLRSOgJb7RoZPHqGQNwMTM7S9tHVoxx8.woff2"
   },
   "/_fonts/NdzqRASp2bovDUhQT1IRE_EMqKJ2KYQdTCfFcBvL8yw-KhwZiS86o3fErOe5GGMExHUemmI_dBfaEFxjISZrBd0.woff2": {
     "type": "font/woff2",
     "etag": "\"1d98-cDZfMibtk4T04FTTAmlfhWDpkN0\"",
-    "mtime": "2026-04-05T18:35:56.183Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 7576,
     "path": "../public/_fonts/NdzqRASp2bovDUhQT1IRE_EMqKJ2KYQdTCfFcBvL8yw-KhwZiS86o3fErOe5GGMExHUemmI_dBfaEFxjISZrBd0.woff2"
   },
   "/_fonts/iTkrULNFJJkTvihIg1Vqi5IODRH_9btXCioVF5l98I8-AndUyau2HR2felA_ra8V2mutQgschhasE5FD1dXGJX8.woff2": {
     "type": "font/woff2",
     "etag": "\"47c4-5xyngHnzzhetUee74tMx9OTgqNQ\"",
-    "mtime": "2026-04-05T18:35:56.184Z",
+    "mtime": "2026-04-12T18:58:38.507Z",
     "size": 18372,
     "path": "../public/_fonts/iTkrULNFJJkTvihIg1Vqi5IODRH_9btXCioVF5l98I8-AndUyau2HR2felA_ra8V2mutQgschhasE5FD1dXGJX8.woff2"
   },
   "/_nuxt/BD6mASiY.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"ab-ScyLcA/4r5aOxEv1YY+kqXazCHI\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.509Z",
     "size": 171,
     "path": "../public/_nuxt/BD6mASiY.js"
   },
-  "/_nuxt/CjAs3eBq.js": {
-    "type": "text/javascript; charset=utf-8",
-    "etag": "\"1df7-cTFKdH9K34T9NixeUm/CLQ8lWUc\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
-    "size": 7671,
-    "path": "../public/_nuxt/CjAs3eBq.js"
-  },
   "/_nuxt/D9wFDhac.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"e99-sUFV1wmMOK2XGfzDXJyP2NA8TG4\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 3737,
     "path": "../public/_nuxt/D9wFDhac.js"
   },
+  "/_nuxt/CjAs3eBq.js": {
+    "type": "text/javascript; charset=utf-8",
+    "etag": "\"1df7-cTFKdH9K34T9NixeUm/CLQ8lWUc\"",
+    "mtime": "2026-04-12T18:58:38.510Z",
+    "size": 7671,
+    "path": "../public/_nuxt/CjAs3eBq.js"
+  },
   "/_nuxt/DSWYWRXT.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"10875-8b+YwIvP6QkcBFnHXqxd+WeZ05o\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 67701,
     "path": "../public/_nuxt/DSWYWRXT.js"
   },
   "/_nuxt/DRfk9W3W.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"194dc-Oj5Ixz12+pq4yqDtF/N+YAPzoWw\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 103644,
     "path": "../public/_nuxt/DRfk9W3W.js"
   },
   "/_nuxt/VvnbcAzZ.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"d7b-hU4O5jppM7Ou3kZAYy3iYXlgoa8\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 3451,
     "path": "../public/_nuxt/VvnbcAzZ.js"
   },
   "/_nuxt/_id_.DhlLK-mY.css": {
     "type": "text/css; charset=utf-8",
     "etag": "\"2f4-xtV37kE566jU74wpZnFHA29RoAY\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 756,
     "path": "../public/_nuxt/_id_.DhlLK-mY.css"
   },
   "/_nuxt/error-404.C7fg894-.css": {
     "type": "text/css; charset=utf-8",
     "etag": "\"97e-fiQ3o7A11L9BuXRBr0GJldkx0AU\"",
-    "mtime": "2026-04-05T18:35:56.187Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 2430,
     "path": "../public/_nuxt/error-404.C7fg894-.css"
   },
   "/_nuxt/error-500.DjUK_N2Y.css": {
     "type": "text/css; charset=utf-8",
     "etag": "\"773-Qf61bSDos4KtmZDaA06FmZyUYNo\"",
-    "mtime": "2026-04-05T18:35:56.187Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 1907,
     "path": "../public/_nuxt/error-500.DjUK_N2Y.css"
   },
   "/_nuxt/builds/latest.json": {
     "type": "application/json",
-    "etag": "\"47-GZLcjWZaQqnb3MWtaAhgJPSJq0w\"",
-    "mtime": "2026-04-05T18:35:56.182Z",
+    "etag": "\"47-e/86GxbuxL65vE0JCcC0T3jGAp4\"",
+    "mtime": "2026-04-12T18:58:38.505Z",
     "size": 71,
     "path": "../public/_nuxt/builds/latest.json"
   },
-  "/_nuxt/builds/meta/0857a55b-f766-4fe6-86be-9bd9d857861a.json": {
+  "/_nuxt/builds/meta/886deef4-f3b5-464c-b4e2-11735eb5272e.json": {
     "type": "application/json",
-    "etag": "\"58-/dM+mpaUFnmvLLmrgwHgZBuTtQg\"",
-    "mtime": "2026-04-05T18:35:56.180Z",
+    "etag": "\"58-BEsLMe80cnxppLc/ZshfoAR3oqs\"",
+    "mtime": "2026-04-12T18:58:38.503Z",
     "size": 88,
-    "path": "../public/_nuxt/builds/meta/0857a55b-f766-4fe6-86be-9bd9d857861a.json"
+    "path": "../public/_nuxt/builds/meta/886deef4-f3b5-464c-b4e2-11735eb5272e.json"
   },
   "/_nuxt/BUmYUDQu.js": {
     "type": "text/javascript; charset=utf-8",
     "etag": "\"66cba-d/pdEXVc78H3VlgFN3kVzKpvD1Q\"",
-    "mtime": "2026-04-05T18:35:56.186Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 421050,
     "path": "../public/_nuxt/BUmYUDQu.js"
   },
   "/_nuxt/entry.Y3mA4bzA.css": {
     "type": "text/css; charset=utf-8",
     "etag": "\"2d46b-zfrD3Ny9WW6qm4fCXAfX5eIAxPA\"",
-    "mtime": "2026-04-05T18:35:56.187Z",
+    "mtime": "2026-04-12T18:58:38.510Z",
     "size": 185451,
     "path": "../public/_nuxt/entry.Y3mA4bzA.css"
   }