brightspace-mcp-server 5.0.13 → 5.1.4

package/build/utils/error-kind.js

@@ -0,0 +1,47 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under MIT — see LICENSE file for details.
+ *
+ * A diagnostic category for a failed tool call, chosen from a closed set this
+ * package controls. Derived from the error's type and status only, never from
+ * its message, so the dev activity log can say why a call failed without
+ * recording paths, URLs, arguments, or content.
+ */
+import { ZodError } from "zod";
+import { ApiError, NetworkError } from "../api/errors.js";
+import { AuthProcessError } from "../auth/auth-runner.js";
+import { DownloadError } from "./download-errors.js";
+export const ERROR_KINDS = ["invalidInput", "destination", "notFound", "permission", "auth", "rateLimited", "http",
+    "transport", "providerBlocked", "unsupportedFormat", "rejectedFile", "unknown"];
+const API_STATUS_KINDS = {
+    401: "auth", 403: "permission", 404: "notFound", 429: "rateLimited",
+};
+export function errorKind(error) {
+    if (error instanceof ZodError)
+        return "invalidInput";
+    if (error instanceof AuthProcessError)
+        return "auth";
+    if (error instanceof ApiError)
+        return API_STATUS_KINDS[error.status] ?? "http";
+    if (error instanceof NetworkError)
+        return "transport";
+    if (error instanceof DownloadError) {
+        return error.kind === "unsupportedType" || error.kind === "undetectableType" ? "unsupportedFormat" : "rejectedFile";
+    }
+    return "unknown";
+}
+const resultKinds = new WeakMap();
+/** Remembers which error a returned tool result describes. */
+export function withErrorKind(result, error) {
+    return tagErrorKind(result, errorKind(error));
+}
+/** Records the category of an error result a tool built itself. */
+export function tagErrorKind(result, kind) {
+    resultKinds.set(result, kind);
+    return result;
+}
+/** The category of a returned error result; "unknown" when no error was attached. */
+export function resultErrorKind(result) {
+    return (typeof result === "object" && result !== null && resultKinds.get(result)) || "unknown";
+}

package/build/utils/startup-phase.js

@@ -0,0 +1,37 @@
+/**
+ * Purdue Brightspace MCP Server
+ * Copyright (c) 2026 Rohan Muppa. All rights reserved.
+ * Licensed under MIT — see LICENSE file for details.
+ */
+import { log } from "./logger.js";
+/** How long a phase may run before one "still waiting" warning is logged. */
+const SLOW_PHASE_MS = 10_000;
+/**
+ * Run one startup step with timestamped stderr lines around it: one before
+ * the work starts, one with its duration when it ends, and a single warning
+ * if it is still running after SLOW_PHASE_MS. A client whose initialize
+ * request times out can then see which step the server was stuck in.
+ *
+ * The phase name is printed verbatim, so it must never carry a username,
+ * URL, or any other account detail.
+ */
+export async function startupPhase(name, work) {
+    log("INFO", `Startup: ${name}...`);
+    const started = Date.now();
+    const slow = setTimeout(() => {
+        log("WARN", `Startup: still ${name} after ${SLOW_PHASE_MS / 1000} s`);
+    }, SLOW_PHASE_MS);
+    slow.unref?.();
+    try {
+        const result = await work();
+        log("INFO", `Startup: ${name} done in ${Date.now() - started} ms`);
+        return result;
+    }
+    catch (error) {
+        log("WARN", `Startup: ${name} failed after ${Date.now() - started} ms`);
+        throw error;
+    }
+    finally {
+        clearTimeout(slow);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brightspace-mcp-server",
-  "version": "5.0.13",
+  "version": "5.1.4",
   "mcpName": "io.github.RohanMuppa/brightspace",
   "description": "MCP server for Brightspace (D2L). Check grades, due dates, assignments, announcements, syllabus, rosters and more via Claude, ChatGPT, Cursor, Windsurf, or any MCP client.",
   "type": "module",