brightspace-mcp-server 3.2.0 → 3.4.0

package/README.md

@@ -117,6 +117,7 @@ npx -y brightspace-mcp-server@latest auth
 | Roster | "Who are the TAs for ECE 264?" · "Get me my instructor's email" |
 | Discussions | "What are people saying in the final project thread?" · "Summarize the latest discussion posts" |
 | Video transcripts | "What did the professor say about pinch-off in Tuesday's lecture recording?" · "Summarize last week's BoilerCast video" — works for Kaltura and YouTube embeds; other platforms report that they aren't supported yet |
+| Troubleshooting | "Which version of the Brightspace server am I running?" · "Where is my Brightspace config file?" — `get_server_info` reports the version, Node runtime, platform, config and session paths, school URL, and whether a credential is stored, without contacting Brightspace or revealing secrets |
 | Planning | "Build me a study schedule based on my upcoming due dates" · "Which class needs the most attention right now?" — pulls from assignments, quizzes, and graded discussion topics (any topic with a due date) |
 
 

package/build/api/cache.js

@@ -52,4 +52,3 @@ export class TTLCache {
         return this.cache.size;
     }
 }
-//# sourceMappingURL=cache.js.map

package/build/api/client.js

@@ -476,4 +476,3 @@ export class D2LApiClient {
         return this.cache.size;
     }
 }
-//# sourceMappingURL=client.js.map

package/build/api/errors.js

@@ -51,4 +51,3 @@ export class TokenRefreshError extends NetworkError {
         this.name = "TokenRefreshError";
     }
 }
-//# sourceMappingURL=errors.js.map

package/build/api/index.js

@@ -14,4 +14,3 @@ export { TokenBucket } from "./rate-limiter.js";
 // Errors
 export { ApiError, RateLimitError, NetworkError } from "./errors.js";
 export { DEFAULT_CACHE_TTLS } from "./types.js";
-//# sourceMappingURL=index.js.map

package/build/api/paginate.js

@@ -91,4 +91,3 @@ function nextPath(firstPath, next) {
     }
     return withBookmark(firstPath, next);
 }
-//# sourceMappingURL=paginate.js.map

package/build/api/rate-limiter.js

@@ -54,4 +54,3 @@ export class TokenBucket {
         return this.tokens;
     }
 }
-//# sourceMappingURL=rate-limiter.js.map

package/build/api/retry.js

@@ -47,4 +47,3 @@ export function retryAfterMsFrom(error) {
     }
     return undefined;
 }
-//# sourceMappingURL=retry.js.map

package/build/api/types.js

@@ -13,4 +13,3 @@ export const DEFAULT_CACHE_TTLS = {
     roster: 3_600_000, // 1 hour
     profile: 3_600_000, // 1 hour
 };
-//# sourceMappingURL=types.js.map

package/build/api/version-discovery.js

@@ -53,4 +53,3 @@ export async function discoverVersions(baseUrl, timeoutMs = 15000) {
         throw new NetworkError(`Failed to discover API versions: ${message}`, error instanceof Error ? error : undefined);
     }
 }
-//# sourceMappingURL=version-discovery.js.map

package/build/auth/auth-cooldown.js

@@ -57,4 +57,3 @@ export class AuthCooldown {
         await fs.rename(temporary, this.file);
     }
 }
-//# sourceMappingURL=auth-cooldown.js.map

package/build/auth/auth-lock.js

@@ -159,4 +159,3 @@ async function acquireLease(lockPath, depth) {
     }
     throw new AuthenticationInProgressError();
 }
-//# sourceMappingURL=auth-lock.js.map

package/build/auth/auth-runner.js

@@ -256,4 +256,3 @@ export class AuthRunner {
         });
     }
 }
-//# sourceMappingURL=auth-runner.js.map

package/build/auth/browser-auth.js

@@ -694,4 +694,3 @@ export class BrowserAuth {
         }
     }
 }
-//# sourceMappingURL=browser-auth.js.map

package/build/auth/browser-state-store.js

@@ -98,4 +98,3 @@ export class BrowserStateStore {
         }
     }
 }
-//# sourceMappingURL=browser-state-store.js.map

package/build/auth/credential-store.js

@@ -240,4 +240,3 @@ export async function getSessionEncryptionKey(sessionDir, backend = nativeCreden
         await release?.();
     }
 }
-//# sourceMappingURL=credential-store.js.map

package/build/auth/duo-mfa.js

@@ -68,4 +68,3 @@ export class DuoMfaHandler {
         log("INFO", "Duo passcode submitted");
     }
 }
-//# sourceMappingURL=duo-mfa.js.map

package/build/auth/encrypted-store.js

@@ -58,4 +58,3 @@ export async function trashFile(file, options) {
     const { default: trash } = await import("trash");
     await trash(file);
 }
-//# sourceMappingURL=encrypted-store.js.map

package/build/auth/index.js

@@ -10,4 +10,3 @@ export { createSSOFlow } from "./sso-flow.js";
 export { TokenManager } from "./token-manager.js";
 export { SessionStore } from "./session-store.js";
 export { AuthRunner } from "./auth-runner.js";
-//# sourceMappingURL=index.js.map

package/build/auth/legacy-profile.js

@@ -38,4 +38,3 @@ export async function retireLegacyProfile(sessionDir) {
         }
     }
 }
-//# sourceMappingURL=legacy-profile.js.map

package/build/auth/legacy-state.js

@@ -104,4 +104,3 @@ export async function migrateLegacyState(sessionRoot) {
         await release();
     }
 }
-//# sourceMappingURL=legacy-state.js.map

package/build/auth/purdue-sso.js

@@ -296,4 +296,3 @@ export class PurdueSSOFlow {
         return number && /^\d{1,3}$/.test(number) ? number : null;
     }
 }
-//# sourceMappingURL=purdue-sso.js.map

package/build/auth/session-store.js

@@ -195,4 +195,3 @@ export class SessionStore {
         }
     }
 }
-//# sourceMappingURL=session-store.js.map

package/build/auth/sso-flow.js

@@ -51,4 +51,3 @@ export function createSSOFlow(config, requestMfaCode) {
     }
     return new PurdueSSOFlow(credentials);
 }
-//# sourceMappingURL=sso-flow.js.map

package/build/auth/suny-sso.js

@@ -136,4 +136,3 @@ export class SunySSOFlow {
             options.find((option) => option.label.toLowerCase().startsWith(wanted)));
     }
 }
-//# sourceMappingURL=suny-sso.js.map

package/build/auth/token-manager.js

@@ -195,4 +195,3 @@ export class TokenManager {
         return token === null;
     }
 }
-//# sourceMappingURL=token-manager.js.map

package/build/auth/token-mint.js

@@ -90,4 +90,3 @@ export async function mintAccessToken({ baseUrl, cookieHeader, csrfToken, fetchI
     }
     return { ok: true, accessToken };
 }
-//# sourceMappingURL=token-mint.js.map

package/build/auth/western-sso.js

@@ -46,4 +46,3 @@ export class WesternSSOFlow {
         await button.click();
     }
 }
-//# sourceMappingURL=western-sso.js.map

package/build/auth-cli.js

@@ -101,4 +101,3 @@ async function main() {
     }
 }
 await main();
-//# sourceMappingURL=auth-cli.js.map

package/build/index.js

@@ -16,7 +16,7 @@ import { startUpdateChecks } from "./utils/update-checker.js";
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { dirname, resolve } from "node:path";
-import { registerGetMyCourses, registerGetUpcomingDueDates, registerGetMyGrades, registerGetAnnouncements, registerGetAssignments, registerGetAssignmentFiles, registerGetCourseContent, registerDownloadFile, registerGetClasslistEmails, registerGetRoster, registerGetSyllabus, registerGetDiscussions, registerGetVideoTranscript, } from "./tools/index.js";
+import { registerGetMyCourses, registerGetUpcomingDueDates, registerGetMyGrades, registerGetAnnouncements, registerGetAssignments, registerGetAssignmentFiles, registerGetCourseContent, registerDownloadFile, registerGetClasslistEmails, registerGetRoster, registerGetSyllabus, registerGetDiscussions, registerGetVideoTranscript, registerGetServerInfo, } from "./tools/index.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const PKG_VERSION = (() => {
@@ -113,11 +113,12 @@ else {
             registerGetSyllabus(server, apiClient);
             registerGetDiscussions(server, apiClient);
             registerGetVideoTranscript(server, apiClient);
-            log("DEBUG", "MCP tools registered (13 tools)");
+            registerGetServerInfo(server, config, PKG_VERSION);
+            log("DEBUG", "MCP tools registered (14 tools)");
             // Connect stdio transport
             const transport = new StdioServerTransport();
             await server.connect(transport);
-            log("INFO", "Brightspace MCP Server by Rohan Muppa — running on stdio (13 tools registered)");
+            log("INFO", "Brightspace MCP Server by Rohan Muppa — running on stdio (14 tools registered)");
             log("INFO", "Setup: see README.md for MCP client configuration (Claude Desktop, ChatGPT Desktop, Cursor, etc.)");
         }
         catch (error) {
@@ -136,4 +137,3 @@ else {
     });
     main();
 }
-//# sourceMappingURL=index.js.map

package/build/setup.js

@@ -471,4 +471,3 @@ main().catch((err) => {
     console.error("Setup failed:", err instanceof Error ? err.message : String(err));
     process.exit(1);
 });
-//# sourceMappingURL=setup.js.map

package/build/tools/download-file.js

@@ -184,4 +184,3 @@ async function downloadSubmissionFile(apiClient, courseId, folderId, fileId, dow
         message: `File downloaded successfully to ${result.path}`,
     });
 }
-//# sourceMappingURL=download-file.js.map

package/build/tools/get-announcements.js

@@ -60,8 +60,6 @@ export function mapNewsItem(item) {
         title: item.Title,
         body: item.Body?.Text ?? "",
         createdBy: item.CreatedBy?.DisplayName ?? "Unknown",
-        createdDate: item.CreatedDate,
-        startDate: item.StartDate,
         date: effectiveDate(item),
         isPinned: item.IsPinned,
         lastModified: item.LastModifiedDate ?? null,
@@ -166,4 +164,3 @@ export function registerGetAnnouncements(server, apiClient, config) {
         }
     });
 }
-//# sourceMappingURL=get-announcements.js.map

package/build/tools/get-assignment-files.js

@@ -167,4 +167,3 @@ export function registerGetAssignmentFiles(server, apiClient, baseUrl) {
         }
     });
 }
-//# sourceMappingURL=get-assignment-files.js.map

package/build/tools/get-assignments.js

@@ -147,8 +147,8 @@ export async function fetchCourseAssignments(apiClient, courseId, baseUrl) {
                 name: folder.Name,
                 url: baseUrl ? assignmentUrl(baseUrl, courseId, folder.Id) : null,
                 instructions: folder.CustomInstructions?.Html
-                    ? convertHtmlToMarkdown(folder.CustomInstructions.Html)
-                    : { markdown: "", html: "" },
+                    ? convertHtmlToMarkdown(folder.CustomInstructions.Html).markdown
+                    : "",
                 dueDate: folder.DueDate,
                 points: folder.Assessment?.ScoreDenominator ?? null,
                 isGroup: folder.GroupTypeId !== null,
@@ -178,7 +178,7 @@ export async function fetchCourseAssignments(apiClient, courseId, baseUrl) {
                     ? {
                         score: feedback.Score,
                         feedback: feedback.Feedback?.Html
-                            ? convertHtmlToMarkdown(feedback.Feedback.Html)
+                            ? convertHtmlToMarkdown(feedback.Feedback.Html).markdown
                             : null,
                     }
                     : null,
@@ -268,8 +268,8 @@ export async function fetchCourseAssignments(apiClient, courseId, baseUrl) {
             name: quiz.Name,
             url: baseUrl ? quizUrl(baseUrl, courseId, quiz.QuizId) : null,
             instructions: descriptionHtml
-                ? convertHtmlToMarkdown(descriptionHtml)
-                : { markdown: "", html: "" },
+                ? convertHtmlToMarkdown(descriptionHtml).markdown
+                : "",
             dueDate: quiz.DueDate,
             startDate: quiz.StartDate,
             endDate: quiz.EndDate,
@@ -404,4 +404,3 @@ export function registerGetAssignments(server, apiClient, config) {
         }
     });
 }
-//# sourceMappingURL=get-assignments.js.map

package/build/tools/get-classlist-emails.js

@@ -43,4 +43,3 @@ export function registerGetClasslistEmails(server, apiClient) {
         }
     });
 }
-//# sourceMappingURL=get-classlist-emails.js.map

package/build/tools/get-course-content.js

@@ -69,9 +69,9 @@ async function buildContentTree(apiClient, courseId, modules, progressMap, typeF
                     id: item.Id,
                     title: item.Title,
                     description: item.Description?.Text ?? null,
-                    dueDate: item.ModuleDueDate ?? null,
-                    isHidden: item.IsHidden,
-                    isLocked: item.IsLocked,
+                    ...(item.ModuleDueDate ? { dueDate: item.ModuleDueDate } : {}),
+                    ...(item.IsHidden ? { isHidden: item.IsHidden } : {}),
+                    ...(item.IsLocked ? { isLocked: item.IsLocked } : {}),
                     lastModified: item.LastModifiedDate ?? null,
                     children: processedChildren,
                 });
@@ -90,12 +90,12 @@ async function buildContentTree(apiClient, courseId, modules, progressMap, typeF
                 topicType,
                 id: item.Id,
                 title: item.Title,
-                isHidden: item.IsHidden,
-                isLocked: item.IsLocked,
-                dueDate: item.DueDate ?? null,
+                ...(item.IsHidden ? { isHidden: item.IsHidden } : {}),
+                ...(item.IsLocked ? { isLocked: item.IsLocked } : {}),
+                ...(item.DueDate ? { dueDate: item.DueDate } : {}),
                 lastModified: item.LastModifiedDate ?? null,
                 isCompleted: topicProgress?.IsRead ?? false,
-                completedDate: topicProgress?.DateCompleted ?? null,
+                ...(topicProgress?.DateCompleted ? { completedDate: topicProgress.DateCompleted } : {}),
             };
             // Add type-specific content
             if (item.TopicType === 1) {
@@ -109,7 +109,7 @@ async function buildContentTree(apiClient, courseId, modules, progressMap, typeF
             }
             // HTML content — include body converted to markdown
             if (item.Description?.Html) {
-                topic.content = convertHtmlToMarkdown(item.Description.Html);
+                topic.content = convertHtmlToMarkdown(item.Description.Html).markdown;
             }
             tree.push(topic);
         }
@@ -237,4 +237,3 @@ export function registerGetCourseContent(server, apiClient) {
         }
     });
 }
-//# sourceMappingURL=get-course-content.js.map

package/build/tools/get-discussions.js

@@ -209,4 +209,3 @@ function formatPosts(posts) {
     }))
         .sort((a, b) => new Date(a.datePosted).getTime() - new Date(b.datePosted).getTime());
 }
-//# sourceMappingURL=get-discussions.js.map

package/build/tools/get-my-courses.js

@@ -52,4 +52,3 @@ export function registerGetMyCourses(server, apiClient, config) {
         }
     });
 }
-//# sourceMappingURL=get-my-courses.js.map

package/build/tools/get-my-grades.js

@@ -98,4 +98,3 @@ export function registerGetMyGrades(server, apiClient, config) {
         }
     });
 }
-//# sourceMappingURL=get-my-grades.js.map

package/build/tools/get-roster.js

@@ -114,4 +114,3 @@ export function registerGetRoster(server, apiClient) {
         }
     });
 }
-//# sourceMappingURL=get-roster.js.map

package/build/tools/get-server-info.js

@@ -0,0 +1,32 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under MIT — see LICENSE file for details.
+ */
+import { getConfigStorePath } from "../utils/config-store.js";
+import { GetServerInfoSchema } from "./schemas.js";
+import { toolResponse } from "./tool-helpers.js";
+/**
+ * Register get_server_info tool.
+ *
+ * Answers from the startup config alone: no network call, so it can never
+ * trigger a sign-in. hasStoredCredential reflects the keychain lookup made at
+ * startup, which is the credential this process actually holds. Nothing
+ * secret — password, username, token, cookie — is ever included.
+ */
+export function registerGetServerInfo(server, config, version) {
+    server.registerTool("get_server_info", {
+        title: "Get Server Info",
+        description: "Report which version of the Brightspace MCP server is running, the Node.js runtime, platform, config file path, session state directory, configured school URL, and whether a credential is stored. Use this for troubleshooting or when the user asks which version they have. Never contacts Brightspace and never returns secrets.",
+        inputSchema: GetServerInfoSchema,
+    }, async () => toolResponse({
+        version,
+        node: process.version,
+        platform: process.platform,
+        arch: process.arch,
+        configPath: getConfigStorePath(),
+        sessionStatePath: config.sessionDir,
+        schoolUrl: config.baseUrl,
+        hasStoredCredential: config.password !== undefined,
+    }));
+}

package/build/tools/get-syllabus.js

@@ -61,7 +61,7 @@ export function registerGetSyllabus(server, apiClient) {
             }
             // Convert description HTML to markdown
             const description = overview?.Description?.Html
-                ? convertHtmlToMarkdown(overview.Description.Html)
+                ? convertHtmlToMarkdown(overview.Description.Html).markdown
                 : null;
             // Always attempt to fetch the attachment so we can extract PDF text
             let attachmentBuffer = null;
@@ -159,4 +159,3 @@ export function registerGetSyllabus(server, apiClient) {
         }
     });
 }
-//# sourceMappingURL=get-syllabus.js.map

package/build/tools/get-upcoming-due-dates.js

@@ -194,4 +194,3 @@ export function registerGetUpcomingDueDates(server, apiClient, config) {
         }
     });
 }
-//# sourceMappingURL=get-upcoming-due-dates.js.map

package/build/tools/get-video-transcript.js

@@ -165,4 +165,3 @@ export function registerGetVideoTranscript(server, apiClient, fetchImpl = fetch)
         }
     });
 }
-//# sourceMappingURL=get-video-transcript.js.map

package/build/tools/index.js

@@ -17,7 +17,7 @@ export { registerGetRoster } from "./get-roster.js";
 export { registerGetSyllabus } from "./get-syllabus.js";
 export { registerGetDiscussions } from "./get-discussions.js";
 export { registerGetVideoTranscript } from "./get-video-transcript.js";
+export { registerGetServerInfo } from "./get-server-info.js";
 // Re-export shared helpers and schemas for convenience
 export { toolResponse, errorResponse, sanitizeError } from "./tool-helpers.js";
 export * from "./schemas.js";
-//# sourceMappingURL=index.js.map

package/build/tools/schemas.js

@@ -113,4 +113,4 @@ export const GetRosterSchema = z.object({
     limit: z.coerce.number().int().positive().max(1000).default(100)
         .describe("Maximum users to return. Default 100. The response reports the true total and whether it was truncated."),
 });
-//# sourceMappingURL=schemas.js.map
+export const GetServerInfoSchema = z.object({});

package/build/tools/tool-helpers.js

@@ -24,7 +24,7 @@ export function toolResponse(data) {
     const content = [
         {
             type: "text",
-            text: JSON.stringify(data, null, 2),
+            text: JSON.stringify(data),
         },
     ];
     const notice = getUpdateNotice();
@@ -166,4 +166,3 @@ export function sanitizeError(error) {
     // Default fallback
     return errorResponse("An unexpected error occurred. Please try again.");
 }
-//# sourceMappingURL=tool-helpers.js.map

package/build/types/index.js

@@ -4,4 +4,3 @@
  * Licensed under MIT — see LICENSE file for details.
  */
 export {};
-//# sourceMappingURL=index.js.map

package/build/update.js

@@ -127,4 +127,3 @@ function main() {
     console.log("");
 }
 main();
-//# sourceMappingURL=update.js.map

package/build/utils/atomic-write.js

@@ -81,4 +81,3 @@ export function writeFileAtomicSync(target, data, options = {}) {
         throw error;
     }
 }
-//# sourceMappingURL=atomic-write.js.map

package/build/utils/browser-install.js

@@ -30,4 +30,3 @@ export function isMissingBrowserError(error) {
         return false;
     return /Executable doesn't exist|playwright install|Failed to launch.*because executable doesn't exist/i.test(message);
 }
-//# sourceMappingURL=browser-install.js.map

package/build/utils/commands.js

@@ -23,4 +23,3 @@ export const SETUP_COMMAND = `npx -y ${PACKAGE_NAME}@latest setup`;
 export const GLOBAL_INSTALL_COMMAND = `npm install -g ${PACKAGE_NAME}@latest`;
 /** Drop cached npx copies so the next `@latest` genuinely refetches. */
 export const CLEAR_NPX_CACHE_COMMAND = "npx clear-npx-cache";
-//# sourceMappingURL=commands.js.map

package/build/utils/config-store.js

@@ -29,4 +29,3 @@ export function saveConfigStore(config) {
 export function getConfigStorePath() {
     return CONFIG_FILE;
 }
-//# sourceMappingURL=config-store.js.map

package/build/utils/config.js

@@ -85,4 +85,3 @@ function expandTilde(filePath) {
     }
     return filePath;
 }
-//# sourceMappingURL=config.js.map

package/build/utils/course-filter.js

@@ -41,4 +41,3 @@ export function applyCourseFilter(courses, config) {
     }
     return filtered;
 }
-//# sourceMappingURL=course-filter.js.map

package/build/utils/deep-links.js

@@ -32,4 +32,3 @@ export function gradebookUrl(baseUrl, courseId) {
 export function discussionUrl(baseUrl, courseId, topicId) {
     return `${trimBaseUrl(baseUrl)}/d2l/lms/discussions/threadlist.d2l?ou=${courseId}&tId=${topicId}`;
 }
-//# sourceMappingURL=deep-links.js.map

package/build/utils/download-errors.js

@@ -42,4 +42,3 @@ export class DownloadError extends Error {
 export function isSafeDetail(value) {
     return value.length <= 64 && /^[a-z0-9][a-z0-9.+-]*\/[a-z0-9][a-z0-9.+-]*$/.test(value);
 }
-//# sourceMappingURL=download-errors.js.map

package/build/utils/download-helpers.js

@@ -91,4 +91,3 @@ export async function secureDownload(options) {
         mime,
     };
 }
-//# sourceMappingURL=download-helpers.js.map

package/build/utils/errors.js

@@ -33,4 +33,3 @@ export class SessionStoreError extends AuthError {
         this.name = "SessionStoreError";
     }
 }
-//# sourceMappingURL=errors.js.map

package/build/utils/file-validator.js

@@ -4,7 +4,6 @@
  * Licensed under MIT — see LICENSE file for details.
  */
 import path from "node:path";
-import { fileTypeFromBuffer } from "file-type";
 import sanitizeFilename from "sanitize-filename";
 import { DownloadError } from "./download-errors.js";
 /**
@@ -20,6 +19,15 @@ import { DownloadError } from "./download-errors.js";
  * extension instead, which admits the formats the allowlist already intended
  * and still refuses everything else.
  */
+// file-type v21 is ESM-only and costs ~50ms; defer the import to first use
+// since validateFileType is already async.
+let fileTypeFromBufferPromise;
+function getFileTypeFromBuffer() {
+    if (!fileTypeFromBufferPromise) {
+        fileTypeFromBufferPromise = import("file-type").then((m) => m.fileTypeFromBuffer);
+    }
+    return fileTypeFromBufferPromise;
+}
 const CFB_MIME = "application/x-cfb";
 const CFB_EXTENSION_MIMES = {
     ".doc": "application/msword",
@@ -113,6 +121,7 @@ export function validateDownloadPath(baseDir, filename) {
  */
 export async function validateFileType(buffer, allowedTypes = ALLOWED_MIME_TYPES, filename) {
     // Try magic byte detection first
+    const fileTypeFromBuffer = await getFileTypeFromBuffer();
     const detected = await fileTypeFromBuffer(buffer);
     if (detected) {
         if (detected.mime === CFB_MIME) {
@@ -181,4 +190,3 @@ export function validateBaseUrl(url, expectedBaseUrl) {
         throw new Error(`URL must start with ${expectedBaseUrl}, got: ${url.substring(0, 50)}...`);
     }
 }
-//# sourceMappingURL=file-validator.js.map

package/build/utils/html-converter.js

@@ -3,15 +3,21 @@
  * Copyright (c) 2026 Rohan Muppa. All rights reserved.
  * Licensed under MIT — see LICENSE file for details.
  */
-import TurndownService from "turndown";
-/**
- * Singleton TurndownService instance configured for converting D2L HTML to markdown.
- * Uses ATX-style headings (###) and fenced code blocks (```).
- */
-const turndownService = new TurndownService({
-    headingStyle: "atx",
-    codeBlockStyle: "fenced",
-});
+import { createRequire } from "node:module";
+// turndown is CJS and costs ~50ms to import; defer it to first use via
+// createRequire so callers keep a synchronous API instead of turning async.
+const require = createRequire(import.meta.url);
+let turndownService;
+function getTurndownService() {
+    if (!turndownService) {
+        const TurndownService = require("turndown");
+        turndownService = new TurndownService({
+            headingStyle: "atx",
+            codeBlockStyle: "fenced",
+        });
+    }
+    return turndownService;
+}
 /**
  * Convert D2L HTML content to clean markdown.
  * Returns both markdown (for LLM readability) and raw HTML (for fallback).
@@ -25,7 +31,7 @@ export function convertHtmlToMarkdown(html) {
         return { markdown: "", html: "" };
     }
     try {
-        const markdown = turndownService.turndown(html);
+        const markdown = getTurndownService().turndown(html);
         return { markdown, html };
     }
     catch (error) {
@@ -33,4 +39,3 @@ export function convertHtmlToMarkdown(html) {
         return { markdown: html, html };
     }
 }
-//# sourceMappingURL=html-converter.js.map

package/build/utils/install-sites.js

@@ -194,4 +194,3 @@ export function formatSkewNotice(sites, runningVersion, home = homedir()) {
         `An out-of-date auth CLI fails during sign-in. Run \`${GLOBAL_INSTALL_COMMAND}\`, or use \`${AUTH_COMMAND}\`.`,
     ].join("\n");
 }
-//# sourceMappingURL=install-sites.js.map

package/build/utils/logger.js

@@ -83,4 +83,3 @@ export function enableStdoutGuard() {
         console.error("[WARN] console.log intercepted (would corrupt stdio):", ...args);
     };
 }
-//# sourceMappingURL=logger.js.map

package/build/utils/mcp-client-cli.js

@@ -39,4 +39,3 @@ export function configureCliMcpClient(client, runCommand = defaultRunCommand) {
         ? "configured"
         : "failed";
 }
-//# sourceMappingURL=mcp-client-cli.js.map