@ai4b-team/fsaos-gateway-sdk 3.34.0 → 3.34.2

package/dist/index.d.cts

@@ -349,12 +349,14 @@ declare class EnforcementDeniedError extends Error {
 type PersonalItemOrderKey = 'channel-order' | 'project-order';
 /** Order a supplied complete collection using the selected Space member's arrangement.
  * Does not discover items, provision preferences, or change an item's parent.
+ * Channels without a saved position appear first, newest creation first.
  * Unknown saved IDs retain their positions when the visible subset is reordered.
  * Paginated collection reads must apply arrangement order on the server before
  * cutting pages; this hook is not a substitute for that read contract.
  */
 declare function usePersonalItemOrder<T extends {
     id: string;
+    createdAt?: string;
 }>(key: PersonalItemOrderKey, items: readonly T[]): {
     items: T[];
     ready: boolean;
@@ -405,24 +407,6 @@ declare function trackAction(actionId: string, properties?: Record<string, unkno
 /** Start only the browser adapters declared by the exact published source. */
 declare function startTracking(options?: StartTrackingOptions): () => void;
 
-interface InitializeFsaosOptions {
-    /** Resolve the registered hostname to its governed FSAOS scope. */
-    session?: boolean;
-    /** Start first-party page/action tracking, or provide adapter options. */
-    tracking?: boolean | StartTrackingOptions;
-}
-interface FsaosRuntime {
-    session: SessionEntry | null;
-    /** Stops the browser tracking adapter started by this runtime. */
-    dispose(): void;
-}
-/**
- * Canonical one-call SDK bootstrap for RevDev pages and external React apps.
- * Configuration must be provided through window.__FSAOS_CONFIG__ before the
- * SDK module or IIFE loads, so every subsystem sees the same registered host.
- */
-declare function initializeFsaos(options?: InitializeFsaosOptions): Promise<FsaosRuntime>;
-
 /**
  * @fsaos/gateway — Session Management
  *
@@ -502,7 +486,9 @@ declare function isAnchorReady(): boolean;
  * Elect the home anchor at login. Sets the anchor to it as well.
  * Calling twice in one session is a programming error (logout re-elects).
  */
-declare function electHomeAnchor(ref: MountRef): void;
+declare function electHomeAnchor(ref: MountRef, options?: {
+    activate?: boolean;
+}): void;
 declare function getHomeAnchor(): MountRef | null;
 type MountListener = () => void;
 declare function getMounts(): MountRef[];
@@ -527,6 +513,80 @@ declare const awaitScopeReady: typeof awaitAnchorReady;
 /** @deprecated use isAnchorReady */
 declare const isScopeReady: typeof isAnchorReady;
 
+interface AccountInfo {
+    accountId: string;
+    path: string;
+    name: string;
+    role: string;
+    typeData: Record<string, unknown>;
+    joinedAt: string;
+    via?: 'direct' | 'cascade';
+    placement?: 'switcher_entry' | 'mount_only';
+    subordinateTo?: string | null;
+    cascadeAnchorId?: string | null;
+    isAccount?: boolean;
+    isSpace?: boolean;
+    isOwner?: boolean;
+    billingResponsible?: boolean;
+    grantedVia?: 'self_provisioned' | 'invitation' | 'purchase' | 'seat_assignment' | null;
+    grantedUnderAccountId?: string | null;
+    membershipPath?: string | null;
+    personalSpaceId?: string | null;
+    personalSpacePath?: string | null;
+}
+
+interface WorkspaceOptions {
+    /** The authenticated account path returned by the host's token exchange. */
+    accountPath: string;
+}
+interface WorkspaceSession {
+    home: MountRef;
+    defaultSpace: MountRef;
+    memberships: AccountInfo[];
+}
+/** Shared bootstrap for external-token hosts as well as native-auth clients.
+ * This performs one membership read and one declaration read. It does not load
+ * channels, items, trees, or an aggregate Account view. Use useMounts() afterward.
+ * A token refresh must call this with the same account, not reset the session. */
+declare function initializeWorkspace(options: WorkspaceOptions): Promise<WorkspaceSession>;
+
+interface InitializeFsaosOptions {
+    /** Resolve the registered hostname to its governed FSAOS scope. */
+    session?: boolean;
+    /** Start first-party page/action tracking, or provide adapter options. */
+    tracking?: boolean | StartTrackingOptions;
+    /** Opt in to the mounted workspace lifecycle after host authentication. */
+    workspace?: WorkspaceOptions;
+}
+interface FsaosRuntime {
+    session: SessionEntry | null;
+    workspace?: WorkspaceSession;
+    /** Stops the browser tracking adapter started by this runtime. */
+    dispose(): void;
+}
+/**
+ * Canonical one-call SDK bootstrap for RevDev pages and external React apps.
+ * Configuration must be provided through window.__FSAOS_CONFIG__ before the
+ * SDK module or IIFE loads, so every subsystem sees the same registered host.
+ */
+declare function initializeFsaos(options?: InitializeFsaosOptions): Promise<FsaosRuntime>;
+
+interface LoadMountsOptions {
+    /** Verified default working Space, used only when no declaration exists. */
+    initialAnchor?: MountRef;
+}
+/** One shared declaration read per session. Failures remain retryable and visible.
+ * Existing saved exclusions are retained; restoration never mounts newly joined
+ * Spaces. A fresh default is saved once before it is published. */
+declare function loadMounts(memberSpacePath: string, resolveRef: (id: string) => MountRef | null, options?: LoadMountsOptions): Promise<MountRef[]>;
+declare function mount$1(ref: MountRef): Promise<void>;
+declare function unmount(id: string): Promise<void>;
+/** Open a membership; retain the other mounts and save last_anchor. */
+declare function selectMount(ref: MountRef): Promise<void>;
+/** One explicit batch action (e.g. Account mount-all), never a render effect.
+ * Consumers must separately implement a backend-supported aggregate read filter. */
+declare function replaceMounts(refs: MountRef[], anchor: MountRef): Promise<void>;
+
 /**
  * @fsaos/gateway — Gateway Call (RPC Dispatcher)
  *
@@ -1396,35 +1456,13 @@ declare const auth: {
  * Reads window.__FSAOS_COMPONENT__, wraps in QueryClientProvider,
  * and renders via React 18+ createRoot.
  */
-declare function mount$1(): void;
+declare function mount(): void;
 /**
  * Set up the require() shim and window globals.
  * Called by the build script's footer after the IIFE assigns window.__FSAOS_GATEWAY__.
  */
 declare function setupRequireShim(): void;
 
-/**
- * @fsaos/gateway — Mount Persistence (the session fstab)
- *
- * The mount set is a DECLARATION, not device state: one settings item per
- * member space — <member>/space/settings item named 'mounts' —
- * type_data = { mounts: [item IDs], last_anchor: id }. IDs, not paths
- * (rename-stable). The kernel reads the same declaration when deriving the
- * confinement set (kernel_caller_confinement), so what the UI shows and what
- * the kernel serves agree by construction.
- *
- * Mountability (v1) = membership only:
- *   - accounts: active member items within the HOME anchor's subtree
- *   - spaces:   active space member items, grouped by granted_under_account_id
- * The declaration can only NARROW what membership grants — the kernel
- * intersects; a stale or hostile declaration cannot widen visibility.
- */
-
-/** Mount: add to the working set and persist the declaration. */
-declare function mount(ref: MountRef): Promise<void>;
-/** Unmount: remove from the working set (anchor falls back to home) and persist. */
-declare function unmount(id: string): Promise<void>;
-
 /**
  * Returns whether scope has been established. Useful for gating UI that
  * depends on scope-aware data.
@@ -1907,26 +1945,7 @@ interface ScopeResult {
 }
 /** Returns the current scope session via initSession(). */
 declare function useScope(): ScopeResult;
-interface AccountInfo {
-    accountId: string;
-    path: string;
-    name: string;
-    role: string;
-    typeData: Record<string, unknown>;
-    joinedAt: string;
-    via?: 'direct' | 'cascade';
-    placement?: 'switcher_entry' | 'mount_only';
-    subordinateTo?: string | null;
-    cascadeAnchorId?: string | null;
-    isAccount?: boolean;
-    isSpace?: boolean;
-    isOwner?: boolean;
-    billingResponsible?: boolean;
-    grantedVia?: 'self_provisioned' | 'invitation' | 'purchase' | 'seat_assignment' | null;
-    grantedUnderAccountId?: string | null;
-    personalSpaceId?: string | null;
-    personalSpacePath?: string | null;
-}
+
 interface AccountsState {
     /** Election candidates — accounts the user can log into (top-level forest first). */
     accounts: AccountInfo[];
@@ -1937,9 +1956,9 @@ interface AccountsState {
     /** @deprecated read useMounts() — kept until compass migrates this sprint. */
     mountedScope: string | null;
     /** Elect the HOME anchor (login) or move the anchor (in-session step-into). */
-    switchAccount: (accountPath: string) => void;
+    switchAccount: (accountPath: string) => Promise<void>;
     /** Mount a membership into the working set (persists the declaration). */
-    mountScope: (scopePath: string) => void;
+    mountScope: (scopePath: string) => Promise<void>;
     loading: boolean;
     error: Error | null;
 }
@@ -1950,8 +1969,9 @@ declare function useMounts(): {
     mounts: MountRef[];
     homeAnchor: MountRef | null;
     anchor: MountRef | null;
-    setAnchor: typeof setAnchor;
-    mount: typeof mount;
+    setAnchor: typeof selectMount;
+    replaceMounts: typeof replaceMounts;
+    mount: typeof mount$1;
     unmount: typeof unmount;
 };
 interface AuthState {
@@ -2157,6 +2177,8 @@ interface Channel {
     isPrivate: boolean;
     isDm: boolean;
     messageCount: number;
+    /** Canonical creation time, used for channels without a saved manual position. */
+    createdAt?: string;
     updatedAt: string;
     chatScopePath: string;
     contextId: string;
@@ -3184,4 +3206,4 @@ declare function usePinnedItems(): {
     reorder: (ids: string[]) => Promise<any>;
 };
 
-export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayResponse, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type WorkCorrelation, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, mount$1 as mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, resetAllSdkState, resolvePrincipalId, resubscribePath, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };
+export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayResponse, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };

package/dist/index.d.ts

@@ -349,12 +349,14 @@ declare class EnforcementDeniedError extends Error {
 type PersonalItemOrderKey = 'channel-order' | 'project-order';
 /** Order a supplied complete collection using the selected Space member's arrangement.
  * Does not discover items, provision preferences, or change an item's parent.
+ * Channels without a saved position appear first, newest creation first.
  * Unknown saved IDs retain their positions when the visible subset is reordered.
  * Paginated collection reads must apply arrangement order on the server before
  * cutting pages; this hook is not a substitute for that read contract.
  */
 declare function usePersonalItemOrder<T extends {
     id: string;
+    createdAt?: string;
 }>(key: PersonalItemOrderKey, items: readonly T[]): {
     items: T[];
     ready: boolean;
@@ -405,24 +407,6 @@ declare function trackAction(actionId: string, properties?: Record<string, unkno
 /** Start only the browser adapters declared by the exact published source. */
 declare function startTracking(options?: StartTrackingOptions): () => void;
 
-interface InitializeFsaosOptions {
-    /** Resolve the registered hostname to its governed FSAOS scope. */
-    session?: boolean;
-    /** Start first-party page/action tracking, or provide adapter options. */
-    tracking?: boolean | StartTrackingOptions;
-}
-interface FsaosRuntime {
-    session: SessionEntry | null;
-    /** Stops the browser tracking adapter started by this runtime. */
-    dispose(): void;
-}
-/**
- * Canonical one-call SDK bootstrap for RevDev pages and external React apps.
- * Configuration must be provided through window.__FSAOS_CONFIG__ before the
- * SDK module or IIFE loads, so every subsystem sees the same registered host.
- */
-declare function initializeFsaos(options?: InitializeFsaosOptions): Promise<FsaosRuntime>;
-
 /**
  * @fsaos/gateway — Session Management
  *
@@ -502,7 +486,9 @@ declare function isAnchorReady(): boolean;
  * Elect the home anchor at login. Sets the anchor to it as well.
  * Calling twice in one session is a programming error (logout re-elects).
  */
-declare function electHomeAnchor(ref: MountRef): void;
+declare function electHomeAnchor(ref: MountRef, options?: {
+    activate?: boolean;
+}): void;
 declare function getHomeAnchor(): MountRef | null;
 type MountListener = () => void;
 declare function getMounts(): MountRef[];
@@ -527,6 +513,80 @@ declare const awaitScopeReady: typeof awaitAnchorReady;
 /** @deprecated use isAnchorReady */
 declare const isScopeReady: typeof isAnchorReady;
 
+interface AccountInfo {
+    accountId: string;
+    path: string;
+    name: string;
+    role: string;
+    typeData: Record<string, unknown>;
+    joinedAt: string;
+    via?: 'direct' | 'cascade';
+    placement?: 'switcher_entry' | 'mount_only';
+    subordinateTo?: string | null;
+    cascadeAnchorId?: string | null;
+    isAccount?: boolean;
+    isSpace?: boolean;
+    isOwner?: boolean;
+    billingResponsible?: boolean;
+    grantedVia?: 'self_provisioned' | 'invitation' | 'purchase' | 'seat_assignment' | null;
+    grantedUnderAccountId?: string | null;
+    membershipPath?: string | null;
+    personalSpaceId?: string | null;
+    personalSpacePath?: string | null;
+}
+
+interface WorkspaceOptions {
+    /** The authenticated account path returned by the host's token exchange. */
+    accountPath: string;
+}
+interface WorkspaceSession {
+    home: MountRef;
+    defaultSpace: MountRef;
+    memberships: AccountInfo[];
+}
+/** Shared bootstrap for external-token hosts as well as native-auth clients.
+ * This performs one membership read and one declaration read. It does not load
+ * channels, items, trees, or an aggregate Account view. Use useMounts() afterward.
+ * A token refresh must call this with the same account, not reset the session. */
+declare function initializeWorkspace(options: WorkspaceOptions): Promise<WorkspaceSession>;
+
+interface InitializeFsaosOptions {
+    /** Resolve the registered hostname to its governed FSAOS scope. */
+    session?: boolean;
+    /** Start first-party page/action tracking, or provide adapter options. */
+    tracking?: boolean | StartTrackingOptions;
+    /** Opt in to the mounted workspace lifecycle after host authentication. */
+    workspace?: WorkspaceOptions;
+}
+interface FsaosRuntime {
+    session: SessionEntry | null;
+    workspace?: WorkspaceSession;
+    /** Stops the browser tracking adapter started by this runtime. */
+    dispose(): void;
+}
+/**
+ * Canonical one-call SDK bootstrap for RevDev pages and external React apps.
+ * Configuration must be provided through window.__FSAOS_CONFIG__ before the
+ * SDK module or IIFE loads, so every subsystem sees the same registered host.
+ */
+declare function initializeFsaos(options?: InitializeFsaosOptions): Promise<FsaosRuntime>;
+
+interface LoadMountsOptions {
+    /** Verified default working Space, used only when no declaration exists. */
+    initialAnchor?: MountRef;
+}
+/** One shared declaration read per session. Failures remain retryable and visible.
+ * Existing saved exclusions are retained; restoration never mounts newly joined
+ * Spaces. A fresh default is saved once before it is published. */
+declare function loadMounts(memberSpacePath: string, resolveRef: (id: string) => MountRef | null, options?: LoadMountsOptions): Promise<MountRef[]>;
+declare function mount$1(ref: MountRef): Promise<void>;
+declare function unmount(id: string): Promise<void>;
+/** Open a membership; retain the other mounts and save last_anchor. */
+declare function selectMount(ref: MountRef): Promise<void>;
+/** One explicit batch action (e.g. Account mount-all), never a render effect.
+ * Consumers must separately implement a backend-supported aggregate read filter. */
+declare function replaceMounts(refs: MountRef[], anchor: MountRef): Promise<void>;
+
 /**
  * @fsaos/gateway — Gateway Call (RPC Dispatcher)
  *
@@ -1396,35 +1456,13 @@ declare const auth: {
  * Reads window.__FSAOS_COMPONENT__, wraps in QueryClientProvider,
  * and renders via React 18+ createRoot.
  */
-declare function mount$1(): void;
+declare function mount(): void;
 /**
  * Set up the require() shim and window globals.
  * Called by the build script's footer after the IIFE assigns window.__FSAOS_GATEWAY__.
  */
 declare function setupRequireShim(): void;
 
-/**
- * @fsaos/gateway — Mount Persistence (the session fstab)
- *
- * The mount set is a DECLARATION, not device state: one settings item per
- * member space — <member>/space/settings item named 'mounts' —
- * type_data = { mounts: [item IDs], last_anchor: id }. IDs, not paths
- * (rename-stable). The kernel reads the same declaration when deriving the
- * confinement set (kernel_caller_confinement), so what the UI shows and what
- * the kernel serves agree by construction.
- *
- * Mountability (v1) = membership only:
- *   - accounts: active member items within the HOME anchor's subtree
- *   - spaces:   active space member items, grouped by granted_under_account_id
- * The declaration can only NARROW what membership grants — the kernel
- * intersects; a stale or hostile declaration cannot widen visibility.
- */
-
-/** Mount: add to the working set and persist the declaration. */
-declare function mount(ref: MountRef): Promise<void>;
-/** Unmount: remove from the working set (anchor falls back to home) and persist. */
-declare function unmount(id: string): Promise<void>;
-
 /**
  * Returns whether scope has been established. Useful for gating UI that
  * depends on scope-aware data.
@@ -1907,26 +1945,7 @@ interface ScopeResult {
 }
 /** Returns the current scope session via initSession(). */
 declare function useScope(): ScopeResult;
-interface AccountInfo {
-    accountId: string;
-    path: string;
-    name: string;
-    role: string;
-    typeData: Record<string, unknown>;
-    joinedAt: string;
-    via?: 'direct' | 'cascade';
-    placement?: 'switcher_entry' | 'mount_only';
-    subordinateTo?: string | null;
-    cascadeAnchorId?: string | null;
-    isAccount?: boolean;
-    isSpace?: boolean;
-    isOwner?: boolean;
-    billingResponsible?: boolean;
-    grantedVia?: 'self_provisioned' | 'invitation' | 'purchase' | 'seat_assignment' | null;
-    grantedUnderAccountId?: string | null;
-    personalSpaceId?: string | null;
-    personalSpacePath?: string | null;
-}
+
 interface AccountsState {
     /** Election candidates — accounts the user can log into (top-level forest first). */
     accounts: AccountInfo[];
@@ -1937,9 +1956,9 @@ interface AccountsState {
     /** @deprecated read useMounts() — kept until compass migrates this sprint. */
     mountedScope: string | null;
     /** Elect the HOME anchor (login) or move the anchor (in-session step-into). */
-    switchAccount: (accountPath: string) => void;
+    switchAccount: (accountPath: string) => Promise<void>;
     /** Mount a membership into the working set (persists the declaration). */
-    mountScope: (scopePath: string) => void;
+    mountScope: (scopePath: string) => Promise<void>;
     loading: boolean;
     error: Error | null;
 }
@@ -1950,8 +1969,9 @@ declare function useMounts(): {
     mounts: MountRef[];
     homeAnchor: MountRef | null;
     anchor: MountRef | null;
-    setAnchor: typeof setAnchor;
-    mount: typeof mount;
+    setAnchor: typeof selectMount;
+    replaceMounts: typeof replaceMounts;
+    mount: typeof mount$1;
     unmount: typeof unmount;
 };
 interface AuthState {
@@ -2157,6 +2177,8 @@ interface Channel {
     isPrivate: boolean;
     isDm: boolean;
     messageCount: number;
+    /** Canonical creation time, used for channels without a saved manual position. */
+    createdAt?: string;
     updatedAt: string;
     chatScopePath: string;
     contextId: string;
@@ -3184,4 +3206,4 @@ declare function usePinnedItems(): {
     reorder: (ids: string[]) => Promise<any>;
 };
 
-export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayResponse, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type WorkCorrelation, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, mount$1 as mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, resetAllSdkState, resolvePrincipalId, resubscribePath, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };
+export { type AccountInfo, type ArtifactDeltaEvent, type ArtifactDoneEvent, type ArtifactEvent, type ArtifactOpenedEvent, type ArtifactState, type ArtifactStatus, type ArtifactStreamState, type ArtifactSurfaceType, type CancelQueuedTurnOptions, type CancelQueuedTurnResponse, type CancelQueuedTurnState, type CancelTurnOptions, type CancelTurnResponse, type CancelTurnState, type Channel, type ChannelCard, type ChannelMessage, type ChannelMessagesOptions, type ChannelMessagesPage, type ChannelMessagesResponse, type ChannelsOptions, type ComponentOpener, ComponentRenderer, type ConnectionState, type CreateParams, type DeleteParams, EnforcementDeniedError, type EnforcementPayload, type FieldDescriptor, type FileRef, FormSubmissionError, type FormSubmissionReceipt, type FsaosRuntime, type GatewayParams, GatewayRequestError, type GatewayResponse, type InfiniteChannelMessagesOptions, type InfiniteItemsOptions, type InitializeFsaosOptions, type InteractionReceipt, InteractionTrackingError, type ItemVersionsOptions, type ItemVersionsResult, type ItemsDiscovery, type ItemsFilter, type ItemsFilterGroup, KernelProvider, type LinkParams, type LoadMountsOptions, type MintedAsset, type MintedAssetState, type MountRef, type MoveParams, type Notification, type NotificationsOptions, type OpenEnvelope, type OpenOptions, type PathSubscriptionState, type PersonalItemOrderKey, type PinTarget, type PinnedItem, type PrincipalData, type PublicSourceConfig, type ResolveItemsResponse, type ResolveParams, type ResolveResponse, type ResolveResultItem, type ResolvedItem, type SessionEntry, type SourceCaptureAdapter, type SourceIdentityStorage, type StartTrackingOptions, type SteerTurnOptions, type SteerTurnResponse, type SteerTurnState, type SubmitFormOptions, type TimelineEvent, type TimelineHistoryEvent, type TimelineHistoryOptions, type TrackEventOptions, type TurnQueueEntry, type TurnQueueEntryState, type TypeDefinition, type TypeHelpers, type TypeSchema, type UnreadCountsOptions, type UpdateParams, type UpdatePrincipalParams, type UploadItem, type UploadOptions, type UploadResult, type UseArtifactStreamReturn, type UseFileUploadReturn, type UseTimelineHistoryReturn, type VFSEdge, type VFSItem, type WorkCorrelation, type WorkspaceOptions, type WorkspaceSession, auth, awaitAnchorReady, awaitScopeReady, callTool, cancelQueuedTurn, cancelTurn, clearCachedToken, clearSession, createItem, disconnectSSE, disposeVfsRealtimeWs, electHomeAnchor, emitEvent, fetchChannelMessages, fetchChannelMessagesPage, fetchChannelMessagesWithCards, fetchEdgesForItem, fetchItemHistory, fetchItemVersions, fetchItems, fetchMemberFocus, fetchOpenEnvelope, fetchRecentActivity, fetchResolvedItems, fetchTimelineHistory, fetchTurnQueueEntries, fetchTypeDefinitions, fetchVfsChildren, fetchVfsChildrenPage, fetchVfsItem, fetchVfsItemById, fetchVfsTree, gatewayCall, getAccessToken, getAnchor, getAnchorRef, getAnchorVersion, getAssetUrl, getDefaultSort, getHomeAnchor, getMountVersion, getMounts, getPathSubscriptionState, getQueryClient, getRequiredFormFields, getScope, getScopeVersion, getServerClockOffsetMs, getServerClockSyncedAt, getSessionEntry, hasServerClock, initSession, initVfsRealtimeWs, initializeFsaos, initializeWorkspace, interpretSchema, invalidateAllVfs, invalidateChannelMessages, invalidateChildren, invalidateItem, invalidateOpenEnvelope, invalidatePathAndParent, invalidateSubtree, invalidateTypes, isAnchorReady, isChannelPath, isListableItemsFilter, isScopeReady, itemsFilterFromQueryFilter, listChildren, loadMounts, mount, mountRealtimeScope, normalizeItem, onConnectionStateChange, pathSubscriptionMatches, ping, pushChanges, queryClient, readItem, refreshQuery, registerCleanup, replaceMounts, resetAllSdkState, resolvePrincipalId, resubscribePath, selectMount, serverDeadlinePassed, serverMsUntil, serverNow, setAnchor, setCachedToken, setQueryClient, setScope, setupRequireShim, signal, startTracking, steerTurn, submitForm, subscribeAnchor, subscribeArtifactStream, subscribeMounts, subscribeScope, subscribeToEvents, subscribeToPath, subscribeToScope, trackAction, trackEvent, trackPageView, unmountRealtimeScope, updateItem, uploadFile, useAccounts, useAgentTimeline, useAllChannels, useArrangement, useArtifactStream, useAsset, useAuth, useChannelMessages, useChannels, useChildren, useComponent, useCreate, useDelete, useDmChannels, useEdges, useEventStream, useFileUpload, useInfiniteChannelMessages, useInfiniteChildren, useInfiniteItems, useItem, useItemById, useItemHistory, useItemVersions, useItems, useLink, useList, useMemberFocus, useMintedAsset, useMounts, useMove, useMutation, useNotifications, useOpen, usePermission, usePermissions, usePersonalItemOrder, usePinnedItems, usePrincipal, useRealtimeQuery, useRecentActivity, useResolve, useResolvedItems, useScope, useScopeReady, useSearch, useTheme, useTimelineHistory, useTool, useTree, useType, useTypeHelpers, useTypes, useUnreadCounts, useUpdate, useUpdatePrincipal, vfsKeys, waitForPathReady };