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

package/dist/index.d.cts

@@ -1085,6 +1085,10 @@ interface ItemsFilter {
     type?: string;
     /** Scope path boundary. Defaults to session scope. */
     scope?: string;
+    /** Explicit mounted Space UUIDs, filtered by the kernel before pagination.
+     * [] returns no work. Omitted preserves legacy scope behavior. This is a
+     * read selection, never a write target or permission grant. */
+    spaceIds?: string[];
     /** Direct parent_id filter. */
     parent_id?: string;
     /** Name ILIKE filter (partial match). */
@@ -1131,7 +1135,7 @@ declare function isListableItemsFilter(filter: ItemsFilter | null | undefined):
  * icon, ...) are ignored. `extra` adds what the screen owns: scope, page size.
  * Returns null when the stored filter names nothing to list.
  */
-declare function itemsFilterFromQueryFilter(typeData: Record<string, unknown> | null | undefined, extra?: Pick<ItemsFilter, 'scope' | 'limit' | 'name' | 'parent_id'>): ItemsFilter | null;
+declare function itemsFilterFromQueryFilter(typeData: Record<string, unknown> | null | undefined, extra?: Pick<ItemsFilter, 'scope' | 'spaceIds' | 'limit' | 'name' | 'parent_id'>): ItemsFilter | null;
 /**
  * Fetch items with structured filters: one type, or OR-groups across types.
  * Calls kernel_query (gateway 'query' method). The kernel filters before it
@@ -1654,7 +1658,88 @@ declare function useSearch(query: string | undefined | null, itemTypes?: string[
 /** Multi-signal search (exact + trigram + keyword + semantic vector) via kernel resolve. */
 declare function useResolve(params: ResolveParams | null | undefined): _tanstack_react_query.UseQueryResult<ResolveResponse, Error>;
 /** Fetch items with structured filters: one type, or OR-groups across types. */
-declare function useItems(filter: ItemsFilter | null | undefined): _tanstack_react_query.UseQueryResult<VFSItem[], Error>;
+declare function useItems(filter: ItemsFilter | null | undefined): _tanstack_react_query.QueryObserverRefetchErrorResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverSuccessResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverLoadingErrorResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverPendingResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverPlaceholderResult<VFSItem[], Error> | {
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+} | {
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+} | {
+    data: undefined;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+};
 interface InfiniteItemsOptions {
     /** Keep this cached listing fresh through the SDK's existing realtime transport. No polling. Defaults to false. */
     realtime?: boolean;
@@ -1967,6 +2052,8 @@ declare function useAccounts(): AccountsState;
 /** The working set (mounts) as reactive state, plus mount/unmount verbs. */
 declare function useMounts(): {
     mounts: MountRef[];
+    selectedSpaces: MountRef[];
+    readSpaceIds: string[];
     homeAnchor: MountRef | null;
     anchor: MountRef | null;
     setAnchor: typeof selectMount;

package/dist/index.d.ts

@@ -1085,6 +1085,10 @@ interface ItemsFilter {
     type?: string;
     /** Scope path boundary. Defaults to session scope. */
     scope?: string;
+    /** Explicit mounted Space UUIDs, filtered by the kernel before pagination.
+     * [] returns no work. Omitted preserves legacy scope behavior. This is a
+     * read selection, never a write target or permission grant. */
+    spaceIds?: string[];
     /** Direct parent_id filter. */
     parent_id?: string;
     /** Name ILIKE filter (partial match). */
@@ -1131,7 +1135,7 @@ declare function isListableItemsFilter(filter: ItemsFilter | null | undefined):
  * icon, ...) are ignored. `extra` adds what the screen owns: scope, page size.
  * Returns null when the stored filter names nothing to list.
  */
-declare function itemsFilterFromQueryFilter(typeData: Record<string, unknown> | null | undefined, extra?: Pick<ItemsFilter, 'scope' | 'limit' | 'name' | 'parent_id'>): ItemsFilter | null;
+declare function itemsFilterFromQueryFilter(typeData: Record<string, unknown> | null | undefined, extra?: Pick<ItemsFilter, 'scope' | 'spaceIds' | 'limit' | 'name' | 'parent_id'>): ItemsFilter | null;
 /**
  * Fetch items with structured filters: one type, or OR-groups across types.
  * Calls kernel_query (gateway 'query' method). The kernel filters before it
@@ -1654,7 +1658,88 @@ declare function useSearch(query: string | undefined | null, itemTypes?: string[
 /** Multi-signal search (exact + trigram + keyword + semantic vector) via kernel resolve. */
 declare function useResolve(params: ResolveParams | null | undefined): _tanstack_react_query.UseQueryResult<ResolveResponse, Error>;
 /** Fetch items with structured filters: one type, or OR-groups across types. */
-declare function useItems(filter: ItemsFilter | null | undefined): _tanstack_react_query.UseQueryResult<VFSItem[], Error>;
+declare function useItems(filter: ItemsFilter | null | undefined): _tanstack_react_query.QueryObserverRefetchErrorResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverSuccessResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverLoadingErrorResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverPendingResult<VFSItem[], Error> | _tanstack_react_query.QueryObserverPlaceholderResult<VFSItem[], Error> | {
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+} | {
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+} | {
+    data: undefined;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_react_query.RefetchOptions) => Promise<_tanstack_react_query.QueryObserverResult<VFSItem[], Error>>;
+    fetchStatus: _tanstack_react_query.FetchStatus;
+    promise: Promise<VFSItem[]>;
+};
 interface InfiniteItemsOptions {
     /** Keep this cached listing fresh through the SDK's existing realtime transport. No polling. Defaults to false. */
     realtime?: boolean;
@@ -1967,6 +2052,8 @@ declare function useAccounts(): AccountsState;
 /** The working set (mounts) as reactive state, plus mount/unmount verbs. */
 declare function useMounts(): {
     mounts: MountRef[];
+    selectedSpaces: MountRef[];
+    readSpaceIds: string[];
     homeAnchor: MountRef | null;
     anchor: MountRef | null;
     setAnchor: typeof selectMount;