@wilm-ai/wilma-cli 2.3.0 → 2.3.2

package/README.md

@@ -1,6 +1,6 @@
 # @wilm-ai/wilma-cli
 
-Command line interface for Wilma (Finnish school system), built for parents and AI agents.
+Command line interface for Wilma (Finnish school system), built for parents and AI agents. Students can use it with their own Wilma login too.
 
 ## Install
 Needs Node.js 20.18.1 or newer.

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-help.js

@@ -63,7 +63,7 @@ const COMMAND_HELP = {
     },
     login: {
         usage: ["wilma login [--no-browser]", "wilma login --tenant <url|city> --username <name> [--password-stdin] [--totp-secret <key>]"],
-        about: "Log in to Wilma. Opens a one-time login page in the browser where the parent picks their school's Wilma; logins are saved on this computer. Families with children on different Wilmas add each one there. Without a browser, pass --tenant and --username with the password on stdin or in WILMA_PASSWORD.",
+        about: "Log in to Wilma, with a parent's account or a student's own. Opens a one-time login page in the browser where the user picks their school's Wilma; logins are saved on this computer. Families with children on different Wilmas add each one there. Without a browser, pass --tenant and --username with the password on stdin or in WILMA_PASSWORD.",
         examples: ["wilma login"],
     },
     accounts: {

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/login-server.js

@@ -260,7 +260,7 @@ export function renderLoginPage(opts) {
             submit: "Log in",
             working: "Checking with Wilma…",
             doneTitle: "You're connected",
-            doneIntro: "Children found:",
+            doneIntro: "Found on this login:",
             addAnother: "Add another Wilma",
             addAnotherHint: "If one of your children goes to a school with a different Wilma, add that login too.",
             finish: "Done",
@@ -304,7 +304,7 @@ export function renderLoginPage(opts) {
             submit: "Kirjaudu",
             working: "Tarkistetaan Wilmasta…",
             doneTitle: "Yhteys on valmis",
-            doneIntro: "Löytyneet lapset:",
+            doneIntro: "Näillä tunnuksilla löytyi:",
             addAnother: "Lisää toinen Wilma",
             addAnotherHint: "Jos joku lapsistasi käy koulua, jolla on eri Wilma, lisää myös sen tunnukset.",
             finish: "Valmis",

package/dist/mcp-tools.d.ts

@@ -1,7 +1,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import type { FetchedAttachment, WilmaAccess } from "./agent-data.js";
-export declare const INSTRUCTIONS = "Read-only access to Finland's Wilma school system for a parent/guardian.\n- Start with wilma_summary: today's and tomorrow's lessons, upcoming exams, recent homework, news and messages for every child in one call.\n- Tools cover all children by default; pass \"student\" (name or student number) to narrow to one child.\n- Wilma content is usually in Finnish. Answer in the user's language and translate as needed. Write dates the way that language does: Finnish \"ke 7.10.\" (with the final period), English \"Wed 7 Oct\".\n- Message and news lists return ids; use wilma_read_message / wilma_read_news for full text. Bulletins can link attachments; fetch them with wilma_get_news_attachment.\n- Teachers' feedback (\"forgot books\", \"did well\") and absences are lesson notes: wilma_lesson_notes for recent days, wilma_lesson_notes_summary for counts. Course and report-card grades are in wilma_gradebook.\n- If a tool says the user isn't logged in, relay the login link or instructions to the user exactly; never ask the user to type their Wilma password into the chat.\n- Wilma allows one session per account, so each WilmAI login logs the user out of Wilma in their browser. If they want to use Wilma in the browser, call wilma_logout and then call Wilma tools only when they ask again.\n- If a result ends with an \"Update note\", answer the question first, then pass the note on in one sentence.";
+export declare const INSTRUCTIONS = "Read-only access to Finland's Wilma school system for a parent/guardian, or for a student with their own login.\n- Start with wilma_summary: today's and tomorrow's lessons, upcoming exams, recent homework, news and messages for every child in one call.\n- Tools cover all children by default (a student's own login has just that student); pass \"student\" (name or student number) to narrow to one child.\n- Wilma content is usually in Finnish. Answer in the user's language and translate as needed. Write dates the way that language does: Finnish \"ke 7.10.\" (with the final period), English \"Wed 7 Oct\".\n- Message and news lists return ids; use wilma_read_message / wilma_read_news for full text. Bulletins can link attachments; fetch them with wilma_get_news_attachment.\n- Teachers' feedback (\"forgot books\", \"did well\") and absences are lesson notes: wilma_lesson_notes for recent days, wilma_lesson_notes_summary for counts. Course and report-card grades are in wilma_gradebook.\n- If a tool says the user isn't logged in, relay the login link or instructions to the user exactly; never ask the user to type their Wilma password into the chat.\n- Wilma allows one session per account, so each WilmAI login logs the user out of Wilma in their browser. If they want to use Wilma in the browser, call wilma_logout and then call Wilma tools only when they ask again.\n- If a result ends with an \"Update note\", answer the question first, then pass the note on in one sentence.";
 export declare const READ_ONLY: {
     readonly readOnlyHint: true;
     readonly destructiveHint: false;

package/dist/mcp-tools.js

@@ -5,9 +5,9 @@ import { toAgentJson } from "./output-json.js";
  * Wilma data tools for the local stdio server (`wilma mcp`) and any other
  * host. Each host decides how a tool call gets a WilmaAccess.
  */
-export const INSTRUCTIONS = `Read-only access to Finland's Wilma school system for a parent/guardian.
+export const INSTRUCTIONS = `Read-only access to Finland's Wilma school system for a parent/guardian, or for a student with their own login.
 - Start with wilma_summary: today's and tomorrow's lessons, upcoming exams, recent homework, news and messages for every child in one call.
-- Tools cover all children by default; pass "student" (name or student number) to narrow to one child.
+- Tools cover all children by default (a student's own login has just that student); pass "student" (name or student number) to narrow to one child.
 - Wilma content is usually in Finnish. Answer in the user's language and translate as needed. Write dates the way that language does: Finnish "ke 7.10." (with the final period), English "Wed 7 Oct".
 - Message and news lists return ids; use wilma_read_message / wilma_read_news for full text. Bulletins can link attachments; fetch them with wilma_get_news_attachment.
 - Teachers' feedback ("forgot books", "did well") and absences are lesson notes: wilma_lesson_notes for recent days, wilma_lesson_notes_summary for counts. Course and report-card grades are in wilma_gradebook.
@@ -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,7 +1,8 @@
 {
   "name": "@wilm-ai/wilma-cli",
-  "version": "2.3.0",
-  "description": "Read your children's Wilma (Finnish school system) from the terminal or an AI assistant: schedule, homework, exams, messages and news.",
+  "version": "2.3.2",
+  "description": "Read your children's Wilma (Finnish school system) from the terminal or an AI assistant: schedule, homework, exams, messages and news. Students can use their own login too.",
+  "mcpName": "ai.wilm/wilma",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -21,7 +22,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "lint": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm --filter @wilm-ai/wilma-client build && pnpm run build && node test/news-resources.mjs && node test/mcp-login.mjs && node test/mfa.mjs && node test/logout.mjs && node test/shared-session.mjs && node test/audit.mjs && node test/update-notice.mjs",
+    "test": "pnpm --filter @wilm-ai/wilma-client build && pnpm run build && node test/news-resources.mjs && node test/mcp-login.mjs && node test/mfa.mjs && node test/logout.mjs && node test/shared-session.mjs && node test/audit.mjs && node test/update-notice.mjs && node test/registry.mjs",
     "start": "node dist/index.js",
     "prepack": "pnpm --filter @wilm-ai/wilma-client build && pnpm --filter @wilm-ai/wilma-cli build",
     "test:live": "tsc -p tsconfig.json && node test/live.spec.mjs",
@@ -30,7 +31,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": {