Repository navigation
parro-api-client 0.6.0
·
17 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
See what is new, and mark what you have read: overview now shows only unread announcements and
new calendar items, and mark-read marks an item as read. This changes the client's promise:
it used to be read-only; now it reads, and the one change it can make in Parro is marking items as
read, only when you ask. The school sees what you mark (read counts, read receipts), and so does
the Parro app.
Added
mark-read announcement|calendar|chat IDmarks one item as read. It looks the item up first,
so a wrong id is an error, not a write, and leaves items that are already read alone.
mark-read group IDshows how many unread announcements a group has; with--yesit marks them
all.--mark-readonannouncement IDandchat-messages ID: show it, then mark it.- The MCP tool
parro_mark_read(one item at a time), only when you set
PARRO_ALLOW_MARK_READ=1. It is marked as not read-only, so MCP clients ask before calling it. - Chat filters:
chatrooms --unread --archived only|include --type group --schoolyear 2025, and
chat-messages ID --since 2026-10-01. The MCP tools take the same options. chat-members ID(MCPparro_chat_members): who is in a chat, parents with their children
and teachers, and who is admin;--formeradds members who left.- The spec describes 10 more operations: chat details, members, scheduled and single messages,
school years, an identity, an announcement attachment, and the three calls that mark items read
(in their own section, Read state, which says what the school sees).
Changed
overviewlists only what you have not read: unread announcements and new calendar items.
overview --all(MCPall: true) shows the latest announcements and everything coming up, as
before.chatroomsleaves archived chats out, as the API does by default;--archived includeadds them.- The README, the help text,
SECURITY.mdand the User-Agent describe the new promise. Making the
client write anything else, or mark something without being asked, is a security problem.
Fixed
syncmissed archived chats: the API leaves them out unless asked. It now archives them too.