chattolib/.beans/chattolib-l483--cross-check-chattolib-against-chatto-v034-source-s.md

---

chattolib-l483

title: Cross-check chattolib against chatto v0.3.4 source SDL status: completed type: task priority: high created_at: 2026-06-19T13:08:27Z

updated_at: 2026-06-19T13:16:46Z

I built 0.1.0b3 from live introspection of chat.chatto.run. The server reports version 0.3.4. The canonical SDL lives in cli/internal/graph/*.graphqls in github.com/chattocorp/chatto. Verify the lib matches source-of-truth, not just what introspection happened to expose, and fix any gaps (deprecations, defaults, file-upload helpers, mutation arg ordering, missing operations).

Tasks

• Concatenate the .graphqls files and diff against chattolib queries/types
• Check for deprecated fields the lib still uses
• Check for new operations missing from the lib that introspection didn't reveal
• Verify input default values and required/optional flags
• Decide whether a follow-up version bump is warranted (yes: 0.1.0b3 → 0.1.0b4)

Summary of Changes

Real bugs in 0.1.0b3 found and fixed by comparing against cli/internal/graph/*.graphqls

Mutation selection sets:

• updateMessage returns Boolean! — I was selecting { id } which would fail at runtime
• archiveRoom/unarchiveRoom return Room! — I selected nothing (required sub-selection)
• setServerNotificationLevel/setRoomNotificationLevel return ViewerNotificationPreference!
• reorderRoomGroups returns [RoomGroup!]!, moveRoomToGroup returns Room!, reorderRoomsInGroup returns RoomGroup!
• updateServerConfig returns ServerProfile! (I had nested .profile which doesn't exist on ServerProfile)

Type fixes in Server query:

• enabledAuthProviders (list of strings) → authProviders { id type label } (list of AuthProvider!)

Pagination cursors:

• Room.events(before/after) takes String (opaque cursors), not Time

Subscription union field conflicts:

• Aliased threadRootEventId on MessagePostedEvent (messageThreadRootEventId) and UserTypingEvent (typingThreadRootEventId) because both are nullable, conflicting with non-null occurrences in ThreadCreatedEvent and ThreadFollowChangedEvent
• Aliased messageEventId on Asset* events (assetMessageEventId) for the same reason
• Aliased reason on MessageRetractedEvent (retractionReason) vs non-null reason on SessionTerminatedEvent
• Aliased roomId on Asset* and NotificationLevelChanged events (assetRoomId, notifRoomId) — nullable variants
• Added missing CallStartedEvent { roomId callId } and CallEndedEvent { roomId callId }

Client surface:

• post_message: added mention_confirmation_token kwarg
• update_message: added also_send_to_channel kwarg, now returns bool
• archive_room/unarchive_room return Room dataclass
• update_server_config returns ServerProfile

Version bumped to 0.1.0b4.