@ai4b-team/fsaos-gateway-sdk 3.36.0 → 3.37.0

package/README.md

@@ -319,3 +319,22 @@ and reconciles through the existing coalesced arrangement refresh. No polling,
 item reads or parent changes are involved. For paged collections, apply ordering
 in the backend before pagination; this hook does not discover Project folders
 or provide that paged read contract.
+
+### Personal sidebar Sections
+
+`usePersonalSections(contextId, 'channels' | 'chats' | 'projects')` reads personal
+reference groups. Use a Space ID for channels/projects or a channel ID for chats.
+The hook returns `sections`, `ready`, `change`, `destination`, and loading/error
+state. `change` supports create, rename, delete, assign, remove and reorder
+operations; it preserves canonical item locations. Supply a stable client UUID
+for `section_id` on create so a retry cannot create a duplicate Section.
+
+Capture `destination(sectionId)` before starting a new channel or chat, then call
+`assignPersonalSection(destination, savedItemId)` once the canonical item has
+been saved. Retry that filing separately from creation/sending. The captured
+Space and context isolate late results after navigation. Versioned snapshots
+prevent late responses from replacing newer organization; refresh uses existing
+coalesced item-change events and reconnects, with no polling.
+
+Requires the `personal-sections` kernel method from migration `0793523446ad`.
+Projects are protocol-ready; a consumer must supply its Project UI separately.