[Feature Request] Query my own unread IM messages (count + list)

[drgnchan]

Summary

lark-cli currently has no way to query the current user's unread IM messages — neither a global unread count nor a list of unread messages across chats. This is a common need for human users and AI agents that want to pick up "what's waiting for me" without opening the desktop/mobile client.

What I tried (CLI v1.0.85)

• lark-cli im +chat-list — lists chats I'm a member of, but returns no unread_count and offers no unread filter.
• lark-cli im +messages-search --is-at-me — only finds messages that @ me; cannot tell read/unread status.
• lark-cli im +chat-messages-list — lists messages per chat (via /open-apis/im/v1/messages), but has no unread filter.

None of these expose read/unread state.

Proposed capability

1. Unread count per chat: include unread_count in +chat-list output, and/or add an --only-unread filter to +chat-list.
2. List my unread messages: e.g. lark-cli im +unread-list — returns messages across chats where is_read=false, with time range, per-chat grouping, and pagination.
3. Underlying OpenAPI: the IM (im.v1) domain does not appear to expose a "list my unread messages" or "unread count" endpoint. This likely needs an OpenAPI addition (similar to the mail domain's is_unread filter) so the CLI can surface it.

Use cases

• AI agent daily routine: "summarize what's unread in my Lark chats".
• Triage: list unread messages across chats sorted by recency, without opening the client.
• Programmatic detection of new/unread messages (e.g. for custom notification/bot flows).

Consistency reference

The mail domain already supports an unread filter (lark-cli mail +triage --is-unread / --filter is_unread=true). An analogous IM capability would be consistent with the existing CLI design.