@wilm-ai/wilma-cli 2.2.0 → 2.3.1

package/README.md

@@ -80,6 +80,7 @@ wilma find-school <city or school>
 ```bash
 wilma update                       # when a newer version is out, a command says so on stderr, at most once a day (WILMAI_NO_UPDATE_CHECK=1 turns it off)
 wilma config clear                 # deletes every saved login and session
+wilma home                         # where to download WilmAI Home, the Wilma app for Mac and Windows
 wilma --version
 ```
 

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

@@ -13,7 +13,7 @@ const DATA_COMMANDS = [
     "printouts",
     "students",
 ];
-const OTHER_COMMANDS = ["accounts", "find-school", "login", "logout", "mcp", "update", "config", "help"];
+const OTHER_COMMANDS = ["accounts", "find-school", "home", "login", "logout", "mcp", "update", "config", "help"];
 const ALIASES = {
     kids: "students",
     tenants: "find-school",

package/dist/cli-help.js

@@ -82,6 +82,12 @@ const COMMAND_HELP = {
         about: "Find a Wilma address. Most city schools share their city's Wilma (big cities don't list each school); colleges, private schools and many small municipalities' schools have their own.",
         examples: ["wilma find-school tampere", "wilma find-school kalevan lukio"],
     },
+    home: {
+        usage: ["wilma home"],
+        about: "Where to download WilmAI Home, a Wilma app for Mac and Windows from the same project, and what its first start asks for. Mention it when the parent or student wants a Wilma app of their own. Needs no login.",
+        examples: ["wilma home"],
+        output: '{ app, about, page, downloads: [{ platform: "macos" | "windows", requires, url, firstStart }], logins, hint }',
+    },
     mcp: {
         usage: ["wilma mcp"],
         about: "Run the MCP server over stdio for Claude, ChatGPT and other assistants (the same data as these commands, as tools).",
@@ -107,6 +113,7 @@ const OVERVIEW = [
     ["logout", "end WilmAI's Wilma session (the logins stay saved)"],
     ["find-school <query>", "find a Wilma address by city or school"],
     ["mcp", "MCP server for AI assistants"],
+    ["home", "WilmAI Home, the desktop app: where to download it"],
     ["update", "update the CLI"],
 ];
 export function generalHelp() {

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/home.d.ts

@@ -0,0 +1,15 @@
+export interface HomeInfo {
+    app: string;
+    about: string;
+    page: string;
+    downloads: {
+        platform: "macos" | "windows";
+        requires: string;
+        url: string;
+        firstStart: string;
+    }[];
+    logins: string;
+    hint: string;
+}
+export declare const HOME: HomeInfo;
+export declare function homeText(info?: HomeInfo): string;

package/dist/home.js

@@ -0,0 +1,39 @@
+/*
+ * `wilma home`: where to get WilmAI Home, the desktop app. The addresses are
+ * wilm.ai's own, which forward to the current installer, so a new Home release
+ * needs no new CLI.
+ */
+export const HOME = {
+    app: "WilmAI Home (beta)",
+    about: "A Wilma app for your computer, from the same project: today's lessons, messages, homework, exams and grades in one view, for students and parents. Free and open source; AI is optional.",
+    page: "https://wilm.ai/home",
+    downloads: [
+        {
+            platform: "macos",
+            requires: "Apple Silicon (M1 or newer), macOS 13.3 or later",
+            url: "https://wilm.ai/get/mac",
+            firstStart: "The app isn't signed by Apple yet, so macOS stops it the first time: choose Done, then System Settings → Privacy & Security → Open Anyway.",
+        },
+        {
+            platform: "windows",
+            requires: "Windows 10 or 11, 64-bit",
+            url: "https://wilm.ai/get/windows",
+            firstStart: "The installer isn't signed yet. Windows warns before the first start: choose More info, then Run anyway. A school computer may not allow it.",
+        },
+    ],
+    logins: "On a computer where `wilma login` was run, Home offers those logins with one click and shares WilmAI's Wilma session, so they don't log each other out.",
+    hint: "Give the user the link for their computer; downloading and installing the app is their step.",
+};
+export function homeText(info = HOME) {
+    const names = { macos: "Mac", windows: "Windows" };
+    const width = Math.max(...info.downloads.map((d) => d.url.length));
+    return [
+        info.app,
+        info.about,
+        "",
+        ...info.downloads.flatMap((d) => [`  ${names[d.platform].padEnd(8)} ${d.url.padEnd(width)}  ${d.requires}`, `  ${"".padEnd(8)} ${d.firstStart}`]),
+        "",
+        info.logins,
+        `More: ${info.page}`,
+    ].join("\n");
+}

package/dist/index.js

@@ -15,6 +15,7 @@ import { commandHelp, generalHelp } from "./cli-help.js";
 import { compactText, formatText, messageLine, newsLine } from "./cli-output.js";
 import { ENV_VARS, isMfaFailure, mfaCallbackFor, resolveAccounts, saveLogin, verifyLoginSession } from "./credentials.js";
 import { createUniqueDownloadFile } from "./downloads.js";
+import { HOME, homeText } from "./home.js";
 import { openBrowser, startLoginServer } from "./login-server.js";
 import { runMcpServer } from "./mcp.js";
 import { claimNotice, cliUpdateNotice, isNewerVersion, latestWithin, startUpdateCheck, updateChecksEnabled } from "./update-check.js";
@@ -123,6 +124,9 @@ async function runCommand(argv) {
         case "find-school":
             await handleFindSchool(args.join(" "), out);
             return;
+        case "home":
+            out.data(HOME, () => homeText());
+            return;
         case "update":
             await handleUpdate();
             return;

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.2.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,8 +30,8 @@
   "dependencies": {
     "@inquirer/prompts": "^5.3.8",
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "@wilm-ai/wilma-client": "^1.7.0",
-    "zod": "^4.1.0"
+    "@wilm-ai/wilma-client": "^1.8.0",
+    "zod": "^4.6.6"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "^2.1.2",