wicker-study-mcp 2.14.2 → 2.14.3

package/calendar-result.mjs

@@ -0,0 +1,21 @@
+// The web calendar includes reconciliation proposals and whole-term analytics.
+// They are not evidence for a bounded calendar lookup and can bury its events.
+export function calendarToolResult(data, { from, to } = {}) {
+  if (from && to && from > to) throw new Error('from must be on or before to')
+  const inRange = (day) => (!from || day >= from) && (!to || day <= to)
+  const events = (data.events || []).filter((event) => inRange(String(event.start).slice(0, 10)))
+  // Existing notices keep the original date in their server-generated detail.
+  // Include moves both away from and into the requested day.
+  const changes = (data.changes || []).filter((change) =>
+    [change.date, ...(String(change.detail || '').match(/\b\d{4}-\d{2}-\d{2}\b/g) || [])]
+      .filter(Boolean).some(inRange))
+  return {
+    events,
+    changes,
+    range: { from: from || null, to: to || null, inclusive: true },
+    eventCount: events.length,
+    feeds: data.feeds || [],
+    canvas: data.canvas || { connected: false },
+    problems: data.problems || [],
+  }
+}

package/core-tools.mjs

@@ -1,3 +1,4 @@
+import { calendarToolResult } from './calendar-result.mjs'
 import { searchCourseSchema } from './search-course-schema.mjs'
 // Shared by stdio and Streamable HTTP. Keep schemas and behavior in one place.
 export function registerCoreTools(server, { z, run, api, defaultCanvasUrl: DEFAULT_CANVAS_URL }) {
@@ -43,8 +44,8 @@ server.tool('get_mock_session', 'One mock session with every answer and correcti
 server.tool('get_academic_plan', 'Active academic programme: courses, attempts, exam dates, events, gates, summary.', {}, run(() => api('/api/academics')))
 server.tool('get_planning_context', 'Read the student’s saved exam scenario as a compact planning model. Recorded attempts and grades are explicitly separated from private choices such as a resit, following-year deferral, expected grade, or what-if outcome. Actual academic-calendar records are grouped into dated examination windows, so one window can contain a period’s primary exams and another period’s resits. Each course includes allowed session ids and course-specific roles derived from its teaching period, calendar, transcript fallback, and verified resit rules. Returns stable session ids and a revision; call this before suggesting or changing the plan.', {}, run(() => api('/api/planning/context')))
 server.tool('list_known_programmes', 'The catalogue of known bachelor programmes.', {}, run(() => api('/api/editorial-programmes')))
-server.tool('get_calendar', 'Unified calendar in one call: exam attempts, personal events, registration windows, the institution calendar, saved timetable feeds (lectures, tutorials, labs), and — when Canvas is connected — Canvas assignment deadlines and Canvas course events. This is the tool for "when is my next lecture", "where do I need to be", and "what is due this week". Events carry `category`, `courseCode`, and for Canvas items a `canvasStatus`; `problems` names any source that could not be read, which is how you tell an empty week from a missing timetable feed.', { from: z.string().optional().describe('ISO date; omit for everything'), to: z.string().optional() },
-  run(async ({ from, to }) => { const data = await api('/api/calendar/events'); const events = data.events.filter((e) => (!from || String(e.start) >= from) && (!to || String(e.start) <= to)); return { ...data, events } }))
+server.tool('get_calendar', 'Unified calendar in one call: exam attempts, personal events, registration windows, the institution calendar, saved timetable feeds (lectures, tutorials, labs), and — when Canvas is connected — Canvas assignment deadlines and Canvas course events. This is the tool for "when is my next lecture", "where do I need to be", and "what is due this week". Events carry `category`, `courseCode`, and for Canvas items a `canvasStatus`; `problems` names any source that could not be read, which is how you tell an empty week from a missing timetable feed.', { from: z.string().date().optional().describe('Inclusive first calendar date (YYYY-MM-DD); omit for no lower bound.'), to: z.string().date().optional().describe('Inclusive last calendar date (YYYY-MM-DD). Use the same date as from for one full day.') },
+  run(async ({ from, to }) => { const data = await api('/api/calendar/events'); return calendarToolResult(data, { from, to }) }))
 server.tool('get_activity', 'Study activity series, streak, weekly totals, recent events.', { days: z.number().int().min(7).max(120).optional() }, run(({ days }) => api('/api/activity', { query: { days } })))
 server.tool('get_account_summary', 'What is stored for the account, per record family.', {}, run(() => api('/api/account/summary')))
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wicker-study-mcp",
-  "version": "2.14.2",
+  "version": "2.14.3",
   "description": "MCP server for Wicker Study: read course material and a student's academic record, study on their behalf, collect a private Canvas course snapshot, and \u2014 with an admin key \u2014 run the editorial workflow.",
   "keywords": [
     "mcp",
@@ -42,7 +42,8 @@
     "README.md",
     "core-tools.mjs",
     "tool-annotations.mjs",
-    "search-course-schema.mjs"
+    "search-course-schema.mjs",
+    "calendar-result.mjs"
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",