brightspace-mcp-server 1.0.0

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

@@ -0,0 +1,100 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { DEFAULT_CACHE_TTLS } from "../api/index.js";
+import { GetMyGradesSchema, } from "./schemas.js";
+import { toolResponse, sanitizeError } from "./tool-helpers.js";
+import { log } from "../utils/logger.js";
+import { applyCourseFilter } from "../utils/course-filter.js";
+/**
+ * Register get_my_grades tool
+ */
+export function registerGetMyGrades(server, apiClient, config) {
+    server.registerTool("get_my_grades", {
+        title: "Get My Grades",
+        description: "Fetch your grade breakdown for a specific course or all enrolled courses. Shows grade items with points, percentages, and comments. Use this when the user asks about grades, scores, marks, GPA, academic performance, or how they're doing in a class.",
+        inputSchema: GetMyGradesSchema,
+    }, async (args) => {
+        try {
+            log("DEBUG", "get_my_grades tool called", { args });
+            // Parse and validate input
+            const { courseId } = GetMyGradesSchema.parse(args);
+            // Single course case
+            if (courseId) {
+                const path = apiClient.le(courseId, "/grades/values/myGradeValues/");
+                const gradeValues = await apiClient.get(path, {
+                    ttl: DEFAULT_CACHE_TTLS.grades,
+                });
+                // Map to clean objects
+                const grades = gradeValues.map((gv) => ({
+                    name: gv.GradeObjectName,
+                    displayGrade: gv.DisplayedGrade,
+                    pointsNumerator: gv.PointsNumerator,
+                    pointsDenominator: gv.PointsDenominator,
+                    weightedNumerator: gv.WeightedNumerator,
+                    weightedDenominator: gv.WeightedDenominator,
+                    comments: gv.Comments?.Text || null,
+                    lastModified: gv.LastModified,
+                }));
+                log("INFO", `get_my_grades: Retrieved ${grades.length} grade items for course ${courseId}`);
+                return toolResponse({ courseId, grades });
+            }
+            // All courses case
+            // First, fetch enrolled courses
+            const enrollmentPath = apiClient.lp("/enrollments/myenrollments/?orgUnitTypeId=3&isActive=true");
+            const enrollmentResponse = await apiClient.get(enrollmentPath, { ttl: DEFAULT_CACHE_TTLS.enrollments });
+            // Apply course filter
+            const filteredEnrollments = applyCourseFilter(enrollmentResponse.Items.map(item => ({
+                id: item.OrgUnit.Id,
+                name: item.OrgUnit.Name,
+                code: item.OrgUnit.Code,
+                isActive: item.Access.IsActive,
+                ...item,
+            })), config.courseFilter);
+            // Fetch grades for each course (handle 403s gracefully)
+            const gradePromises = filteredEnrollments.map(async (item) => {
+                try {
+                    const path = apiClient.le(item.OrgUnit.Id, "/grades/values/myGradeValues/");
+                    const gradeValues = await apiClient.get(path, {
+                        ttl: DEFAULT_CACHE_TTLS.grades,
+                    });
+                    const grades = gradeValues.map((gv) => ({
+                        name: gv.GradeObjectName,
+                        displayGrade: gv.DisplayedGrade,
+                        pointsNumerator: gv.PointsNumerator,
+                        pointsDenominator: gv.PointsDenominator,
+                        weightedNumerator: gv.WeightedNumerator,
+                        weightedDenominator: gv.WeightedDenominator,
+                        comments: gv.Comments?.Text || null,
+                        lastModified: gv.LastModified,
+                    }));
+                    return {
+                        courseId: item.OrgUnit.Id,
+                        courseName: item.OrgUnit.Name,
+                        grades,
+                    };
+                }
+                catch (error) {
+                    // 403 means no access (past course, etc) - log and skip
+                    if (error?.status === 403) {
+                        log("DEBUG", `get_my_grades: 403 Forbidden for course ${item.OrgUnit.Id} (${item.OrgUnit.Name}) - skipping`);
+                        return null;
+                    }
+                    throw error; // Re-throw other errors
+                }
+            });
+            const results = await Promise.allSettled(gradePromises);
+            const courses = results
+                .filter((r) => r.status === "fulfilled" && r.value !== null)
+                .map((r) => r.value);
+            log("INFO", `get_my_grades: Retrieved grades for ${courses.length} courses (out of ${enrollmentResponse.Items.length} enrolled)`);
+            return toolResponse({ courses });
+        }
+        catch (error) {
+            return sanitizeError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-my-grades.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-my-grades.js","sourceRoot":"","sources":["../../src/tools/get-my-grades.ts"],"names":[],"mappings":"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"}

package/build/tools/get-roster.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { D2LApiClient } from "../api/index.js";
+/**
+ * Register get_roster tool
+ */
+export declare function registerGetRoster(server: McpServer, apiClient: D2LApiClient): void;
+//# sourceMappingURL=get-roster.d.ts.map

package/build/tools/get-roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-roster.d.ts","sourceRoot":"","sources":["../../src/tools/get-roster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAsB,MAAM,iBAAiB,CAAC;AAqEnE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,YAAY,GACtB,IAAI,CA6EN"}

package/build/tools/get-roster.js

@@ -0,0 +1,108 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { DEFAULT_CACHE_TTLS } from "../api/index.js";
+import { GetRosterSchema, } from "./schemas.js";
+import { toolResponse, sanitizeError } from "./tool-helpers.js";
+import { log } from "../utils/logger.js";
+// Purdue-specific role IDs. These are institution-specific values.
+// If using at another institution, you may need to adjust these.
+// Discover by fetching classlist for a known course and inspecting RoleId values.
+const INSTRUCTOR_ROLE_ID = 109;
+const TA_ROLE_ID = 135;
+/**
+ * Fetch a page of classlist users with optional filters
+ */
+async function fetchClasslistPage(apiClient, courseId, options) {
+    const params = new URLSearchParams();
+    if (options?.roleId !== undefined) {
+        params.append("roleId", options.roleId.toString());
+    }
+    if (options?.searchTerm) {
+        params.append("searchTerm", options.searchTerm);
+    }
+    const queryString = params.toString();
+    const path = apiClient.le(courseId, `/classlist/paged/${queryString ? "?" + queryString : ""}`);
+    const response = await apiClient.get(path, {
+        ttl: DEFAULT_CACHE_TTLS.roster,
+    });
+    if (response.Next) {
+        log("WARN", "get_roster: Pagination detected but not implemented. Some users may be missing.", { courseId, next: response.Next });
+    }
+    return response.Objects;
+}
+/**
+ * Register get_roster tool
+ */
+export function registerGetRoster(server, apiClient) {
+    server.registerTool("get_roster", {
+        title: "Get Course Roster",
+        description: "Fetch the roster for a course including instructors, TAs, and optionally students with their names, emails, and roles. Use this when the user asks about classmates, instructor contact info, TA emails, professor names, or who's in a class. By default returns only instructors and TAs for privacy. Use includeStudents to get full class list.",
+        inputSchema: GetRosterSchema,
+    }, async (args) => {
+        try {
+            log("DEBUG", "get_roster tool called", { args });
+            // Parse and validate input
+            const { courseId, includeStudents, searchTerm } = GetRosterSchema.parse(args);
+            let allUsers = [];
+            if (!includeStudents) {
+                // Fetch instructors and TAs in parallel
+                const [instructorResult, taResult] = await Promise.allSettled([
+                    fetchClasslistPage(apiClient, courseId, {
+                        roleId: INSTRUCTOR_ROLE_ID,
+                        searchTerm,
+                    }),
+                    fetchClasslistPage(apiClient, courseId, {
+                        roleId: TA_ROLE_ID,
+                        searchTerm,
+                    }),
+                ]);
+                // Merge results
+                if (instructorResult.status === "fulfilled") {
+                    allUsers.push(...instructorResult.value);
+                }
+                else {
+                    log("WARN", "get_roster: Failed to fetch instructors", {
+                        error: instructorResult.reason,
+                    });
+                }
+                if (taResult.status === "fulfilled") {
+                    allUsers.push(...taResult.value);
+                }
+                else {
+                    log("WARN", "get_roster: Failed to fetch TAs", {
+                        error: taResult.reason,
+                    });
+                }
+            }
+            else {
+                // Fetch all users
+                allUsers = await fetchClasslistPage(apiClient, courseId, {
+                    searchTerm,
+                });
+                // Cap at 100 users to prevent MCP response size issues
+                if (allUsers.length > 100) {
+                    log("WARN", "get_roster: Result set exceeds 100 users, truncating", {
+                        total: allUsers.length,
+                        returned: 100,
+                    });
+                    allUsers = allUsers.slice(0, 100);
+                }
+            }
+            // Map to clean output
+            const roster = allUsers.map((user) => ({
+                name: user.DisplayName,
+                email: user.Email || null,
+                role: user.ClasslistRoleDisplayName,
+            }));
+            log("INFO", `get_roster: Retrieved ${roster.length} users for course ${courseId}`);
+            return toolResponse(roster);
+        }
+        catch (error) {
+            return sanitizeError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-roster.js.map

package/build/tools/get-roster.js.map

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

package/build/tools/get-syllabus.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { D2LApiClient } from "../api/index.js";
+/**
+ * Register get_syllabus tool
+ */
+export declare function registerGetSyllabus(server: McpServer, apiClient: D2LApiClient): void;
+//# sourceMappingURL=get-syllabus.d.ts.map

package/build/tools/get-syllabus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-syllabus.d.ts","sourceRoot":"","sources":["../../src/tools/get-syllabus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAC;AAgB7E;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,YAAY,GACtB,IAAI,CA8KN"}

package/build/tools/get-syllabus.js

@@ -0,0 +1,162 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { ApiError, DEFAULT_CACHE_TTLS } from "../api/index.js";
+import { GetSyllabusSchema } from "./schemas.js";
+import { toolResponse, sanitizeError, errorResponse } from "./tool-helpers.js";
+import { convertHtmlToMarkdown } from "../utils/html-converter.js";
+import { secureDownload } from "../utils/download-helpers.js";
+import { MAX_FILE_SIZE } from "../utils/file-validator.js";
+import { extractPdfText } from "../utils/pdf-extractor.js";
+import { log } from "../utils/logger.js";
+import path from "node:path";
+import fs from "node:fs/promises";
+/**
+ * Register get_syllabus tool
+ */
+export function registerGetSyllabus(server, apiClient) {
+    server.registerTool("get_syllabus", {
+        title: "Get Course Syllabus",
+        description: "Fetch the syllabus/overview text and optional attachment for a course. Returns the course overview description as markdown. If downloadPath is provided, also downloads the syllabus attachment (e.g. PDF). IMPORTANT: You MUST ask the user where they want to save the file before calling this tool with a downloadPath.",
+        inputSchema: GetSyllabusSchema,
+    }, async (args) => {
+        try {
+            log("DEBUG", "get_syllabus tool called", { args });
+            const { courseId, downloadPath } = GetSyllabusSchema.parse(args);
+            // Validate downloadPath if provided
+            if (downloadPath !== undefined) {
+                if (!path.isAbsolute(downloadPath)) {
+                    return errorResponse("Download path must be an absolute path (e.g., /Users/username/Downloads on Mac or C:\\Users\\username\\Downloads on Windows)");
+                }
+                try {
+                    const stats = await fs.stat(downloadPath);
+                    if (!stats.isDirectory()) {
+                        return errorResponse(`Download path is not a directory: ${downloadPath}`);
+                    }
+                }
+                catch (error) {
+                    if (error?.code === "ENOENT") {
+                        return errorResponse(`Download directory does not exist: ${downloadPath}`);
+                    }
+                    throw error;
+                }
+            }
+            // Fetch overview text
+            let overview = null;
+            try {
+                overview = await apiClient.get(apiClient.le(courseId, "/overview"), { ttl: DEFAULT_CACHE_TTLS.courseContent });
+            }
+            catch (error) {
+                if (error instanceof ApiError && error.status === 404) {
+                    return toolResponse({
+                        courseId,
+                        description: null,
+                        hasAttachment: false,
+                        message: "No syllabus/overview found for this course.",
+                    });
+                }
+                throw error;
+            }
+            // Convert description HTML to markdown
+            const description = overview?.Description?.Html
+                ? convertHtmlToMarkdown(overview.Description.Html)
+                : null;
+            // Always attempt to fetch the attachment so we can extract PDF text
+            let attachmentBuffer = null;
+            let attachmentFilename = "syllabus";
+            let hasAttachment = false;
+            try {
+                const response = await apiClient.getRaw(apiClient.le(courseId, "/overview/attachment"));
+                if (response.ok) {
+                    hasAttachment = true;
+                    // Check Content-Length before downloading body
+                    const contentLength = parseInt(response.headers.get("Content-Length") ?? "0", 10);
+                    if (contentLength > MAX_FILE_SIZE) {
+                        return errorResponse(`Attachment too large (${Math.round(contentLength / 1024 / 1024)}MB). Maximum allowed: ${MAX_FILE_SIZE / 1024 / 1024}MB`);
+                    }
+                    // Get filename from Content-Disposition header
+                    const disposition = response.headers.get("Content-Disposition") ?? "";
+                    const match = disposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+                    if (match?.[1]) {
+                        attachmentFilename = match[1].replace(/['"]/g, "");
+                    }
+                    // Download body as buffer
+                    attachmentBuffer = Buffer.from(await response.arrayBuffer());
+                    if (attachmentBuffer.length > MAX_FILE_SIZE) {
+                        return errorResponse(`Attachment too large (${Math.round(attachmentBuffer.length / 1024 / 1024)}MB). Maximum allowed: ${MAX_FILE_SIZE / 1024 / 1024}MB`);
+                    }
+                }
+            }
+            catch (error) {
+                if (error instanceof ApiError && error.status === 404) {
+                    hasAttachment = false;
+                }
+                else {
+                    log("DEBUG", "Could not fetch syllabus attachment", error);
+                }
+            }
+            // Extract text from PDF attachment if available
+            let syllabusText = null;
+            let totalPages;
+            if (attachmentBuffer && attachmentFilename.toLowerCase().endsWith(".pdf")) {
+                const extracted = await extractPdfText(attachmentBuffer);
+                if (extracted) {
+                    syllabusText = extracted.text;
+                    totalPages = extracted.totalPages;
+                }
+            }
+            // Save to disk if downloadPath provided
+            let download;
+            if (downloadPath && attachmentBuffer) {
+                try {
+                    const result = await secureDownload({
+                        targetDir: downloadPath,
+                        filename: attachmentFilename,
+                        data: attachmentBuffer,
+                    });
+                    log("INFO", `Syllabus attachment downloaded: ${result.path} (${result.size} bytes)`);
+                    download = {
+                        success: true,
+                        filePath: result.path,
+                        fileSize: result.size,
+                        mimeType: result.mime,
+                    };
+                }
+                catch (error) {
+                    log("ERROR", "Failed to save syllabus attachment", error);
+                    download = {
+                        success: false,
+                        error: "Failed to save attachment to disk.",
+                    };
+                }
+            }
+            else if (downloadPath && !attachmentBuffer) {
+                download = {
+                    success: false,
+                    error: "No attachment found for this course's syllabus.",
+                };
+            }
+            log("INFO", `get_syllabus: Retrieved overview for course ${courseId}`);
+            // Build response
+            const result = { courseId, description };
+            if (syllabusText) {
+                result.syllabusText = syllabusText;
+                if (totalPages)
+                    result.totalPages = totalPages;
+            }
+            else {
+                result.hasAttachment = hasAttachment;
+            }
+            if (download) {
+                result.download = download;
+            }
+            return toolResponse(result);
+        }
+        catch (error) {
+            return sanitizeError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-syllabus.js.map

package/build/tools/get-syllabus.js.map

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

package/build/tools/get-upcoming-due-dates.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { D2LApiClient } from "../api/index.js";
+import type { AppConfig } from "../types/index.js";
+/**
+ * Register get_upcoming_due_dates tool
+ */
+export declare function registerGetUpcomingDueDates(server: McpServer, apiClient: D2LApiClient, config: AppConfig): void;
+//# sourceMappingURL=get-upcoming-due-dates.d.ts.map

package/build/tools/get-upcoming-due-dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-upcoming-due-dates.d.ts","sourceRoot":"","sources":["../../src/tools/get-upcoming-due-dates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAsB,MAAM,iBAAiB,CAAC;AAOnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AA2BnD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,YAAY,EACvB,MAAM,EAAE,SAAS,GAChB,IAAI,CAuFN"}

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

@@ -0,0 +1,74 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+import { DEFAULT_CACHE_TTLS } from "../api/index.js";
+import { GetUpcomingDueDatesSchema, } from "./schemas.js";
+import { toolResponse, sanitizeError } from "./tool-helpers.js";
+import { log } from "../utils/logger.js";
+import { applyCourseFilter } from "../utils/course-filter.js";
+/**
+ * Register get_upcoming_due_dates tool
+ */
+export function registerGetUpcomingDueDates(server, apiClient, config) {
+    server.registerTool("get_upcoming_due_dates", {
+        title: "Get Upcoming Due Dates",
+        description: "Fetch upcoming due dates across all your courses. Shows assignments, quizzes, and other items due within the specified time window. Use this when the user asks about deadlines, what's due, upcoming work, or what they need to do this week.",
+        inputSchema: GetUpcomingDueDatesSchema,
+    }, async (args) => {
+        try {
+            log("DEBUG", "get_upcoming_due_dates tool called", { args });
+            // Parse and validate input
+            const { daysAhead, courseId } = GetUpcomingDueDatesSchema.parse(args);
+            // Build time window
+            const now = new Date();
+            const endDate = new Date(now.getTime() + daysAhead * 24 * 60 * 60 * 1000);
+            const startDateTime = now.toISOString();
+            const endDateTime = endDate.toISOString();
+            // D2L calendar API requires orgUnitIdsCSV — fetch enrolled course IDs if not provided
+            let orgUnitIds;
+            if (courseId) {
+                orgUnitIds = String(courseId);
+            }
+            else {
+                const enrollments = await apiClient.get(apiClient.lp(`/enrollments/myenrollments/?orgUnitTypeId=3&isActive=true`), { ttl: DEFAULT_CACHE_TTLS.enrollments });
+                // Apply course filter
+                const filteredEnrollments = applyCourseFilter(enrollments.Items.map(item => ({
+                    id: item.OrgUnit.Id,
+                    name: item.OrgUnit.Name,
+                    code: item.OrgUnit.Code,
+                    isActive: item.Access.IsActive,
+                })), config.courseFilter);
+                orgUnitIds = filteredEnrollments.map((e) => e.id).join(",");
+            }
+            log("DEBUG", `get_upcoming_due_dates: querying orgUnitIds=${orgUnitIds}, window=${startDateTime} to ${endDateTime}`);
+            // Build path
+            const path = apiClient.leGlobal(`/calendar/events/myEvents/?startDateTime=${encodeURIComponent(startDateTime)}&endDateTime=${encodeURIComponent(endDateTime)}&orgUnitIdsCSV=${orgUnitIds}`);
+            // Fetch events — D2L returns ObjectListPage wrapper with "Objects" array (NOT "Items")
+            const response = await apiClient.get(path, {
+                ttl: DEFAULT_CACHE_TTLS.assignments,
+            });
+            const events = response.Objects ?? [];
+            log("DEBUG", `get_upcoming_due_dates: raw response keys=${Object.keys(response).join(",")}, event count=${events.length}`);
+            // Map to clean objects and sort by end date (soonest due first)
+            const mappedEvents = events
+                .map((event) => ({
+                id: event.CalendarEventId,
+                title: event.Title,
+                courseName: event.OrgUnitName,
+                courseId: event.OrgUnitId,
+                startDate: event.StartDateTime,
+                endDate: event.EndDateTime,
+                isAllDay: event.IsAllDayEvent,
+            }))
+                .sort((a, b) => new Date(a.endDate).getTime() - new Date(b.endDate).getTime());
+            log("INFO", `get_upcoming_due_dates: Retrieved ${mappedEvents.length} events`);
+            return toolResponse(mappedEvents);
+        }
+        catch (error) {
+            return sanitizeError(error);
+        }
+    });
+}
+//# sourceMappingURL=get-upcoming-due-dates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-upcoming-due-dates.js","sourceRoot":"","sources":["../../src/tools/get-upcoming-due-dates.ts"],"names":[],"mappings":"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"}

package/build/tools/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+export { registerGetMyCourses } from "./get-my-courses.js";
+export { registerGetUpcomingDueDates } from "./get-upcoming-due-dates.js";
+export { registerGetMyGrades } from "./get-my-grades.js";
+export { registerGetAnnouncements } from "./get-announcements.js";
+export { registerGetAssignments } from "./get-assignments.js";
+export { registerGetCourseContent } from "./get-course-content.js";
+export { registerDownloadFile } from "./download-file.js";
+export { registerGetClasslistEmails } from "./get-classlist-emails.js";
+export { registerGetRoster } from "./get-roster.js";
+export { registerGetSyllabus } from "./get-syllabus.js";
+export { registerGetDiscussions } from "./get-discussions.js";
+export { toolResponse, errorResponse, sanitizeError } from "./tool-helpers.js";
+export * from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

package/build/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/E,cAAc,cAAc,CAAC"}

package/build/tools/index.js

@@ -0,0 +1,21 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2025 Rohan Muppa. All rights reserved.
+ * Licensed under AGPL-3.0 — see LICENSE file for details.
+ */
+// Tool registration functions - barrel export
+export { registerGetMyCourses } from "./get-my-courses.js";
+export { registerGetUpcomingDueDates } from "./get-upcoming-due-dates.js";
+export { registerGetMyGrades } from "./get-my-grades.js";
+export { registerGetAnnouncements } from "./get-announcements.js";
+export { registerGetAssignments } from "./get-assignments.js";
+export { registerGetCourseContent } from "./get-course-content.js";
+export { registerDownloadFile } from "./download-file.js";
+export { registerGetClasslistEmails } from "./get-classlist-emails.js";
+export { registerGetRoster } from "./get-roster.js";
+export { registerGetSyllabus } from "./get-syllabus.js";
+export { registerGetDiscussions } from "./get-discussions.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/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8CAA8C;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/E,cAAc,cAAc,CAAC"}