@wilm-ai/wilma-cli 2.3.0 → 2.3.1

package/dist/agent-data.d.ts

@@ -479,6 +479,7 @@ export declare class WilmaAccess {
         students: ({
             student: StudentRef;
         } & {
+            unavailable?: string[] | undefined;
             news: NewsItem[];
         })[];
         problems: {
@@ -489,6 +490,7 @@ export declare class WilmaAccess {
         students: ({
             student: StudentRef;
         } & {
+            unavailable?: string[] | undefined;
             news: NewsItem[];
         })[];
         problems?: undefined;

package/dist/agent-data.js

@@ -187,9 +187,10 @@ function selectNews(news, opts = {}) {
     return [...dated, ...pinnedUndated, ...older];
 }
 /**
- * What a daily summary needs, fetched at once. The front page, bulletins and
- * inbox are required; meeting invitations, lesson notes and exam times are
- * extras — if Wilma can't give one, the summary says so in `unavailable`.
+ * What a daily summary needs, fetched at once. The front page and inbox are
+ * required; bulletins (some Wilmas don't show them to a guardian), meeting
+ * invitations, lesson notes and exam times aren't — if Wilma can't give one,
+ * the summary says so in `unavailable`.
  */
 async function fetchSummaryInputs(client, opts) {
     const unavailable = [];
@@ -202,14 +203,16 @@ async function fetchSummaryInputs(client, opts) {
     const [overview, calendar, news, inbox, appointments, lessonNotes] = await Promise.all([
         client.overview.get(),
         client.exams.calendarOrEmpty(),
-        client.news.list(),
+        client.news.listIfShown(),
         client.messages.list("inbox"),
         optional("appointments", client.messages.list("appointments"), []),
         optional("lessonNotes", client.attendance.list({ from: opts.notesFrom, to: todayString() }), []),
     ]);
+    if (news === null)
+        unavailable.push("news");
     return {
         overview: { ...overview, upcomingExams: addExamTimes(overview.upcomingExams, calendar) },
-        news,
+        news: news ?? [],
         messages: [...inbox, ...appointments],
         lessonNotes,
         unavailable,
@@ -591,9 +594,11 @@ export class WilmaAccess {
         return { student, message: item };
     }
     async news(opts = {}) {
-        return this.perStudent(opts.student, async (client) => ({
-            news: selectNews(await client.news.list(), { limit: opts.limit, includeOlder: opts.includeOlder }),
-        }));
+        return this.perStudent(opts.student, async (client) => {
+            const list = await client.news.listIfShown();
+            // A Wilma that doesn't show this account its bulletins: none, and it says so (not the same as "no bulletins").
+            return { news: selectNews(list ?? [], { limit: opts.limit, includeOlder: opts.includeOlder }), ...(list === null ? { unavailable: ["news"] } : {}) };
+        });
     }
     async newsItem(opts) {
         const { student, item } = await this.firstStudentWith(opts.student, (client) => client.news.get(opts.id));

package/dist/cli-output.js

@@ -38,7 +38,7 @@ function perStudent(result, key, render) {
     const several = result.students.length > 1;
     const lines = [];
     for (const entry of result.students) {
-        lines.push(...heading(entry.student, several), ...render(entry[key], entry.student));
+        lines.push(...heading(entry.student, several), ...render(entry[key], entry.student, entry));
     }
     for (const problem of result.problems ?? [])
         lines.push("", `Couldn't read ${problem.wilma}: ${problem.message}`);
@@ -168,9 +168,10 @@ export function formatText(command, action, result) {
                         : []),
                 ].join("\n");
             }
-            return perStudent(result, "news", (items) => {
-                const lines = items.length ? items.map((n) => `  ${newsLine(n)}`) : ["  No bulletins."];
-                return lines;
+            return perStudent(result, "news", (items, _student, entry) => {
+                if (entry.unavailable?.includes("news"))
+                    return ["  This Wilma doesn't show bulletins to this account."];
+                return items.length ? items.map((n) => `  ${newsLine(n)}`) : ["  No bulletins."];
             });
         }
         case "printouts":

package/dist/mcp-tools.js

@@ -74,7 +74,7 @@ function attachmentResult(fetched, savedPath) {
 export function registerWilmaTools(server, ctx) {
     server.registerTool("wilma_summary", {
         title: "School summary",
-        description: "Daily briefing per child: today's and the next school day's lessons, upcoming exams (with start times when given), recent homework, lesson notes since the previous school day (teachers' feedback and absences), recent bulletins, and recent and unread messages (ids, unread, replyCount). The best starting point for any question about school.",
+        description: "Daily briefing per child: today's and the next school day's lessons, upcoming exams (with start times when given), recent homework, lesson notes since the previous school day (teachers' feedback and absences), recent bulletins, and recent and unread messages (ids, unread, replyCount). What Wilma didn't give is listed in unavailable (\"news\": this Wilma doesn't show this account its bulletins). The best starting point for any question about school.",
         inputSchema: {
             student: studentArg,
             days: z.number().int().min(1).max(60).optional().describe("How many days back to include news and messages (default 7)."),
@@ -191,7 +191,7 @@ export function registerWilmaTools(server, ctx) {
     }, async ({ id, student }) => ctx.withAccess(async (a) => json(await a.message({ id, student }))));
     server.registerTool("wilma_list_news", {
         title: "List school news",
-        description: "School bulletins (tiedotteet): the newest dated ones, then pinned ones (pinned: true, e.g. the school-year bulletin), and with include_older also older bulletins (archived: true). Use wilma_read_news for the full text and attachments.",
+        description: "School bulletins (tiedotteet): the newest dated ones, then pinned ones (pinned: true, e.g. the school-year bulletin), and with include_older also older bulletins (archived: true). Use wilma_read_news for the full text and attachments. unavailable: [\"news\"] means this Wilma doesn't show this account its bulletins, which isn't the same as having none.",
         inputSchema: {
             student: studentArg,
             limit: z.number().int().min(1).max(100).optional().describe("How many dated bulletins (default 20). Pinned ones are always included."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "description": "Read your children's Wilma (Finnish school system) from the terminal or an AI assistant: schedule, homework, exams, messages and news.",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,7 @@
   "dependencies": {
     "@inquirer/prompts": "^5.3.8",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@wilm-ai/wilma-client": "^1.7.1",
+    "@wilm-ai/wilma-client": "^1.8.0",
     "zod": "^4.6.6"
   },
   "devDependencies": {