rhombus-node-mcp 0.1.55 → 0.1.57

package/dist/util.js

@@ -2,8 +2,8 @@ import { z } from "zod";
 import fs from "fs";
 import path from "path";
 import { DateTime } from "luxon";
-import { filterIncludedFields, applyFilterBy } from "./filtering-utils.js";
-export { INCLUDE_FIELDS_ARG, FILTER_BY_ARG, filterIncludedFields, applyFilterBy, zodToDotNotationPaths, createFilteringProxy } from "./filtering-utils.js";
+import { filterIncludedFields, applyFilterBy, applyGroupBy } from "./filtering-utils.js";
+export { INCLUDE_FIELDS_ARG, FILTER_BY_ARG, GROUP_BY_ARG, filterIncludedFields, applyFilterBy, applyGroupBy, zodToDotNotationPaths, createFilteringProxy } from "./filtering-utils.js";
 export function generateRandomString(length) {
     const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
     let result = "";
@@ -61,10 +61,20 @@ export function getFilePathsInDirectory(dirPath) {
 // Tool content helpers
 // ---------------------------------------------------------------------------
 /**
- * Returns an object in the form expected by `server.tool`
+ * Returns an object in the form expected by `server.tool`, for the text-only
+ * results tools use to report a bad/missing argument.
+ *
+ * `isError` is REQUIRED here, not cosmetic. Every tool that calls this also
+ * registers an `outputSchema`, and the SDK's post-handler validation throws
+ * "MCP error -32602: ... no structured content was provided" for any result
+ * that lacks `structuredContent` — unless `isError` is set, which short-circuits
+ * that check (see validateToolOutput in @modelcontextprotocol/sdk server/mcp.js).
+ * Without it the -32602 REPLACES this text, so the model sees a protocol crash
+ * instead of "doorControllerUuid is required" and cannot correct its call.
  */
 export function createToolTextContent(content) {
     return {
+        isError: true,
         content: [
             {
                 type: "text",
@@ -90,6 +100,9 @@ export function createToolStructuredContent(content, opts) {
     if (opts?.filterBy?.length) {
         result = applyFilterBy(result, opts.filterBy) ?? result;
     }
+    if (opts?.groupBy) {
+        result = applyGroupBy(result, opts.groupBy) ?? result;
+    }
     if (opts?.includeFields?.length) {
         result = filterIncludedFields(result, opts.includeFields) ?? result;
     }
@@ -168,6 +181,52 @@ export function formatTimestamp(timestampMs, timeZone) {
         locale: "en-US",
     });
 }
+// ---------------------------------------------------------------------------
+// Weekly minute intervals
+// ---------------------------------------------------------------------------
+const MINUTES_PER_DAY = 24 * 60;
+const MINUTES_PER_WEEK = 7 * MINUTES_PER_DAY;
+/**
+ * Rhombus weekly schedules store their windows as "minute of week" integers.
+ * Minute 0 is **Monday 00:00** — the order of `RhombusDayOfWeekEnum` in the
+ * api2 spec, which matches `java.time.DayOfWeek`.
+ */
+const WEEKDAY_NAMES = [
+    "Monday",
+    "Tuesday",
+    "Wednesday",
+    "Thursday",
+    "Friday",
+    "Saturday",
+    "Sunday",
+];
+/** "27000" -> "Wednesday 18:00". */
+export function formatMinuteOfWeek(minuteOfWeek) {
+    // Negative or past-end values are normalised rather than rejected: the caller
+    // is rendering whatever api2 stored, and a wrapped window is legitimate.
+    const normalized = ((Math.trunc(minuteOfWeek) % MINUTES_PER_WEEK) + MINUTES_PER_WEEK) %
+        MINUTES_PER_WEEK;
+    const day = WEEKDAY_NAMES[Math.floor(normalized / MINUTES_PER_DAY)];
+    const minuteOfDay = normalized % MINUTES_PER_DAY;
+    const hours = String(Math.floor(minuteOfDay / 60)).padStart(2, "0");
+    const minutes = String(minuteOfDay % 60).padStart(2, "0");
+    return `${day} ${hours}:${minutes}`;
+}
+/**
+ * Human-readable form of one weekly window, e.g. "Monday 09:00 – Monday 17:00".
+ *
+ * Tools should emit this ALONGSIDE the raw `minuteOfWeekStart`/`Stop` integers,
+ * never instead of them: a bare 27000 is unreadable to the model, but if the
+ * Monday-is-day-0 convention above is ever wrong the formatted string would let
+ * it state the wrong day with full confidence. Keeping both makes that
+ * checkable.
+ */
+export function describeWeeklyInterval(minuteOfWeekStart, minuteOfWeekStop) {
+    if (typeof minuteOfWeekStart !== "number" || typeof minuteOfWeekStop !== "number") {
+        return undefined;
+    }
+    return `${formatMinuteOfWeek(minuteOfWeekStart)} – ${formatMinuteOfWeek(minuteOfWeekStop)}`;
+}
 /**
  * Formats a timestamp in milliseconds to an ISO 8601 string with timezone offset.
  * Format: "2025-04-21T10:57:00.000-07:00"

package/dist/utils/entity-name-match.js

@@ -0,0 +1,11 @@
+/** Match human names despite capitalization, spacing, or punctuation differences. */
+export function matchesEntityName(name, query) {
+    const lowerName = name.toLowerCase();
+    const lowerQuery = query.toLowerCase();
+    if (lowerName.includes(lowerQuery))
+        return true;
+    const compact = (value) => value.normalize("NFKC").replace(/[^\p{L}\p{N}]/gu, "");
+    const compactQuery = compact(lowerQuery);
+    // Do not turn punctuation-only or tiny queries into broad matches.
+    return compactQuery.length >= 3 && compact(lowerName).includes(compactQuery);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhombus-node-mcp",
-  "version": "0.1.55",
+  "version": "0.1.57",
   "description": "MCP server for Rhombus API",
   "keywords": [
     "ai",
@@ -35,6 +35,7 @@
     "test:watch": "vitest",
     "watch": "npm run clean && tsc --watch",
     "generate-schemas": "npx tsx scripts/generate-zod-schemas.ts",
+    "generate-openapi-types": "npx tsx scripts/generate-openapi-types.ts",
     "scrape-sitemaps": "npx tsx scripts/scrape-sitemaps.ts",
     "scrape-content": "npx tsx scripts/scrape-content.ts",
     "scrape-progress": "npx tsx scripts/scrape-content.ts --progress",
@@ -70,6 +71,7 @@
     "@types/express": "^5.0.3",
     "@types/luxon": "^3.6.2",
     "@types/node": "^22.14.0",
+    "openapi-typescript": "^7.13.0",
     "openapi-typescript-codegen": "^0.29.0",
     "openapi-zod-client": "^1.17.0",
     "prettier": "3.5.3",