@datalayer/core 1.1.60 → 1.2.10

package/lib/hooks/useCache.d.ts

@@ -32,8 +32,8 @@
  * }
  * ```
  */
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
-import { IAnyOrganization, IContact, IDatasource, IIAMToken, IOrganization, ISchool, ISecret, IStudent, ITeam, IUser, IUserOnboarding, IUserSettings } from '../models';
+import { QueryClient, UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { IAnyOrganization, IContact, IIAMToken, IOrganization, ISchool, ISecret, IStudent, ITeam, IUser, IUserOnboarding, IUserSettings } from '../models';
 type IAnySpace = any;
 export type CacheProps = {
     loginRoute?: string;
@@ -44,12 +44,172 @@ export type ISearchOpts = {
     max: number;
     public: boolean;
 };
+/**
+ * Forget everything a session was told, without orphaning what is on screen.
+ *
+ * `queryClient.clear()` is the obvious way to end a session and the wrong
+ * one. It destroys the query objects themselves, and an observer whose query
+ * is destroyed while its fetch is in flight is never answered and never asks
+ * again: it sits at `isLoading` for as long as the page stays open.
+ *
+ * Signing out is exactly that race. Ending the session swaps the whole tree
+ * for the anonymous one, which mounts the home page and starts fetching the
+ * featured ribbon; the logout response then lands on top of that fetch. The
+ * ribbon stayed a row of empty placeholders until the reader reloaded.
+ *
+ * So: drop what nobody is looking at, and reset what is on screen. A reset
+ * forgets the answer the person who has left was given and asks the question
+ * again as whoever is here now, which is what signing out means for a page
+ * that is still open.
+ */
+export declare const forgetSession: (client: QueryClient) => void;
 /**
  * Centralized query key factories for all entities
  * Following TanStack Query best practices for key structure
  * @see https://tanstack.com/query/latest/docs/framework/react/guides/query-keys
  */
 export declare const queryKeys: {
+    readonly contents: {
+        readonly all: () => readonly ["contents"];
+        readonly sources: () => readonly ["contents", "sources"];
+        readonly capabilities: () => readonly ["contents", "capabilities"];
+        readonly sourceList: (filters?: {
+            kind?: string;
+            cursor?: string;
+            limit?: number;
+        }) => readonly ["contents", "sources", "list", {
+            kind?: string;
+            cursor?: string;
+            limit?: number;
+        }];
+        readonly source: (sourceUid: string) => readonly ["contents", "sources", "detail", string];
+        readonly sourceSharing: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "sharing"];
+        readonly datasetRevisions: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "revisions"];
+        readonly datasetRevision: (sourceUid: string, revisionUid: string) => readonly ["contents", "sources", "detail", string, "revisions", string];
+        readonly datasetPublications: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "publications"];
+        readonly publishedDatasets: () => readonly ["contents", "publications", "datasets"];
+        readonly cloudObjects: (sourceUid: string, prefix?: string, cursor?: string) => readonly ["contents", "sources", "detail", string, "cloud", "objects", string, string];
+        readonly credentialDiagnostics: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "diagnostics"];
+        readonly homeFolder: () => readonly ["contents", "sources", "user-folder"];
+        readonly homeFolderQuota: () => readonly ["contents", "sources", "user-folder", "quota"];
+        readonly homeFolderObjects: (filters?: {
+            prefix?: string;
+            cursor?: string;
+            limit?: number;
+            order?: "path" | "updated";
+        }) => readonly ["contents", "sources", "user-folder", "objects", "list", {
+            prefix?: string;
+            cursor?: string;
+            limit?: number;
+            order?: "path" | "updated";
+        }];
+        readonly homeFolderObject: (path: string) => readonly ["contents", "sources", "user-folder", "objects", "stat", string];
+        readonly homeFolderObjectVersions: (objectUid: string, cursor?: string) => readonly ["contents", "sources", "user-folder", "objects", string, "versions", string];
+        readonly operations: () => readonly ["contents", "operations"];
+        readonly operation: (operationUid: string) => readonly ["contents", "operations", string];
+        readonly transfers: () => readonly ["contents", "transfers"];
+        readonly transferList: (filters?: {
+            active?: boolean;
+            cursor?: string;
+            limit?: number;
+        }) => readonly ["contents", "transfers", "list", {
+            active?: boolean;
+            cursor?: string;
+            limit?: number;
+        }];
+        readonly transfer: (transferUid: string) => readonly ["contents", "transfers", string];
+        readonly syncSessions: () => readonly ["contents", "sync"];
+        readonly syncSessionList: (filters?: {
+            active?: boolean;
+            cursor?: string;
+            limit?: number;
+        }) => readonly ["contents", "sync", "list", {
+            active?: boolean;
+            cursor?: string;
+            limit?: number;
+        }];
+        readonly syncSession: (sessionUid: string) => readonly ["contents", "sync", string];
+        readonly syncConflicts: (sessionUid: string) => readonly ["contents", "sync", string, "conflicts"];
+        readonly attachments: () => readonly ["contents", "attachments"];
+        readonly attachmentList: (filters?: {
+            sandboxUid?: string;
+            sourceUid?: string;
+            active?: boolean;
+        }) => readonly ["contents", "attachments", "list", {
+            sandboxUid?: string;
+            sourceUid?: string;
+            active?: boolean;
+        }];
+        readonly attachmentManifest: (sandboxUid: string) => readonly ["contents", "attachments", "manifest", string];
+        readonly bridgeSession: (attachmentUid: string) => readonly ["contents", "attachments", "bridge", string];
+        readonly bridges: () => readonly ["contents", "bridges"];
+        readonly bridgeList: (filters?: {
+            active?: boolean;
+        }) => readonly ["contents", "bridges", "list", {
+            active?: boolean;
+        }];
+        readonly bridge: (bridgeUid: string) => readonly ["contents", "bridges", string];
+        readonly runtimeMounts: (runtimeName: string) => readonly ["contents", "runtime-mounts", string];
+        readonly mcpTools: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "mcp", "tools"];
+        readonly mcpSessions: () => readonly ["contents", "mcp-sessions"];
+        readonly mcpSessionList: (filters?: {
+            sourceUid?: string;
+            active?: boolean;
+        }) => readonly ["contents", "mcp-sessions", "list", {
+            sourceUid?: string;
+            active?: boolean;
+        }];
+        readonly mcpSession: (sessionUid: string) => readonly ["contents", "mcp-sessions", string];
+        readonly mcpCalls: (sessionUid: string) => readonly ["contents", "mcp-sessions", string, "calls"];
+        readonly mcpCall: (sessionUid: string, callUid: string) => readonly ["contents", "mcp-sessions", string, "calls", string];
+        readonly mcpApprovals: () => readonly ["contents", "mcp-approvals"];
+        readonly mcpApprovalList: (filters?: {
+            status?: string;
+            sourceUid?: string;
+        }) => readonly ["contents", "mcp-approvals", "list", {
+            status?: string;
+            sourceUid?: string;
+        }];
+        readonly datasourceSchema: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "datasource", "schema"];
+        readonly datasourceCapabilities: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "datasource", "capabilities"];
+        readonly datasourceQueries: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "queries"];
+        readonly queries: () => readonly ["contents", "queries"];
+        readonly query: (queryUid: string) => readonly ["contents", "queries", string];
+        readonly dataserverStatus: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "dataserver", "status"];
+    };
+    readonly mcp: {
+        readonly all: () => readonly ["mcp"];
+        readonly tasks: () => readonly ["mcp", "tasks"];
+        readonly taskList: (filters?: object) => readonly ["mcp", "tasks", "list", object];
+        readonly task: (taskUid: string) => readonly ["mcp", "tasks", string];
+        readonly notebookTasks: (notebookUid: string, filters?: object) => readonly ["mcp", "tasks", "notebook", string, object];
+        readonly bindings: () => readonly ["mcp", "bindings"];
+        readonly bindingList: (filters?: object) => readonly ["mcp", "bindings", "list", object];
+        readonly activity: (filters?: object) => readonly ["mcp", "activity", object];
+        readonly audit: () => readonly ["mcp", "audit"];
+        readonly auditList: (filters?: object) => readonly ["mcp", "audit", "list", object];
+        readonly policy: (filters?: object) => readonly ["mcp", "policy", object];
+        readonly connectedAgents: () => readonly ["mcp", "connected-agents"];
+        readonly serviceAgents: (orgUid: string) => readonly ["mcp", "service-agents", string];
+        readonly policyLayer: (scope: string, subjectUid: string) => readonly ["mcp", "policy-layer", string, string];
+        readonly alertRules: (orgUid: string) => readonly ["mcp", "alert-rules", string];
+        readonly identityProviders: (orgUid: string) => readonly ["mcp", "identity-providers", string];
+        readonly scimTokens: (orgUid: string) => readonly ["mcp", "scim-tokens", string];
+        readonly admittedClients: (scope: string, subjectUid: string) => readonly ["mcp", "admitted-clients", string, string];
+        readonly forwarding: (orgUid: string) => readonly ["mcp", "audit-forwarding", string];
+        readonly auditSettings: (orgUid: string) => readonly ["mcp", "audit-settings", string];
+        readonly organizationTeams: (orgUid: string) => readonly ["mcp", "organization-teams", string];
+        readonly trace: (taskUid: string) => readonly ["mcp", "tasks", string, "trace"];
+        readonly traceById: (traceId: string) => readonly ["mcp", "traces", string];
+        readonly logs: (taskUid: string) => readonly ["mcp", "tasks", string, "logs"];
+        readonly metrics: (filters?: object) => readonly ["mcp", "metrics", object];
+        readonly operations: () => readonly ["mcp", "operations"];
+        readonly workers: () => readonly ["mcp", "operations", "workers"];
+        readonly workflows: () => readonly ["mcp", "operations", "workflows"];
+        readonly gatewayVersion: () => readonly ["mcp", "version"];
+        readonly orgOverview: (orgUid: string, filters?: object) => readonly ["mcp", "organizations", string, "overview", object];
+        readonly orgUsage: (orgUid: string, filters?: object) => readonly ["mcp", "organizations", string, "usage", object];
+    };
     readonly auth: {
         readonly me: () => readonly ["auth", "me"];
         readonly whoami: () => readonly ["auth", "whoami"];
@@ -115,18 +275,19 @@ export declare const queryKeys: {
         readonly bySpace: (spaceId: string) => readonly ["documents", "space", string];
         readonly model: (documentId: string) => readonly ["documents", "detail", string, "model"];
     };
+    readonly decks: {
+        readonly all: () => readonly ["decks"];
+        readonly details: () => readonly ["decks", "detail"];
+        readonly detail: (id: string) => readonly ["decks", "detail", string];
+        readonly bySpace: (spaceId: string) => readonly ["decks", "space", string];
+        readonly model: (deckId: string) => readonly ["decks", "detail", string, "model"];
+    };
     readonly cells: {
         readonly all: () => readonly ["cells"];
         readonly details: () => readonly ["cells", "detail"];
         readonly detail: (id: string) => readonly ["cells", "detail", string];
         readonly bySpace: (spaceId: string) => readonly ["cells", "space", string];
     };
-    readonly datasets: {
-        readonly all: () => readonly ["datasets"];
-        readonly details: () => readonly ["datasets", "detail"];
-        readonly detail: (id: string) => readonly ["datasets", "detail", string];
-        readonly bySpace: (spaceId: string) => readonly ["datasets", "space", string];
-    };
     readonly lessons: {
         readonly all: () => readonly ["lessons"];
         readonly details: () => readonly ["lessons", "detail"];
@@ -153,16 +314,6 @@ export declare const queryKeys: {
         readonly detail: (id: string) => readonly ["environments", "detail", string];
         readonly bySpace: (spaceId: string) => readonly ["environments", "space", string];
     };
-    readonly pages: {
-        readonly all: () => readonly ["pages"];
-        readonly details: () => readonly ["pages", "detail"];
-        readonly detail: (id: string) => readonly ["pages", "detail", string];
-    };
-    readonly datasources: {
-        readonly all: () => readonly ["datasources"];
-        readonly details: () => readonly ["datasources", "detail"];
-        readonly detail: (id: string) => readonly ["datasources", "detail", string];
-    };
     readonly secrets: {
         readonly all: () => readonly ["secrets"];
         readonly details: () => readonly ["secrets", "detail"];
@@ -211,8 +362,14 @@ export declare const queryKeys: {
     readonly items: {
         readonly all: () => readonly ["items"];
         readonly public: () => readonly ["items", "public"];
+        readonly publicItem: (uid: string) => readonly ["items", "public", string];
         readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
         readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
+        readonly featured: () => readonly ["items", "featured"];
+        readonly orbits: () => readonly ["items", "orbits"];
+        readonly orbiters: (uid: string) => readonly ["items", "orbiters", string];
+        readonly derivations: (uid: string) => readonly ["items", "derivations", string];
+        readonly byOwner: (handle: string) => readonly ["items", "owner", string];
     };
     readonly layout: {
         readonly byAccount: (accountHandle: string, spaceHandle?: string) => readonly ["layout", string, string] | readonly ["layout", string];
@@ -265,13 +422,14 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         password: string;
     }, unknown>;
     useLogout: () => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
-    useMe: (token?: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IUser | null | undefined>, Error>;
+    useMe: (token?: string) => import("@tanstack/react-query").UseQueryResult<IUser | null | undefined, Error>;
     useUpdateMe: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         email: string;
         firstName: string;
         lastName: string;
         avatarIcon?: string;
         banner?: string;
+        showOrbits?: boolean;
     }, unknown>;
     useWhoami: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useChangePassword: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -358,11 +516,11 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         body: object;
         token: string;
     }, unknown>;
-    useUser: (userId: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IUser | undefined>, Error>;
+    useUser: (userId: string) => import("@tanstack/react-query").UseQueryResult<IUser | undefined, Error>;
     useUserByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useUserPublicProfileByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useSearchUsers: (namingPattern: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IUser[]>, Error>;
-    useUsersByUids: (userIds: string[]) => import("@tanstack/react-query").UseQueryResult<NoInfer<IUser[]>, Error>;
+    useSearchUsers: (namingPattern: string) => import("@tanstack/react-query").UseQueryResult<IUser[], Error>;
+    useUsersByUids: (userIds: string[]) => import("@tanstack/react-query").UseQueryResult<IUser[], Error>;
     useUpdateUserOnboarding: () => import("@tanstack/react-query").UseMutationResult<any, Error, IUserOnboarding, unknown>;
     useUpdateUserSettings: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         userId: string;
@@ -413,11 +571,11 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, unknown>;
     useUsages: (scopeOrOptions?: {
         accountUid?: string;
-    } | Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
-    useUsagesForUser: (userId: string, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
-    usePlatformUsages: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
-    useOrganization: (organizationId: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IOrganization>, Error>;
-    useOrganizationByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IOrganization | null>, Error>;
+    } | Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
+    useUsagesForUser: (userId: string, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
+    usePlatformUsages: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
+    useOrganization: (organizationId: string) => import("@tanstack/react-query").UseQueryResult<IOrganization, Error>;
+    useOrganizationByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<IOrganization | null, Error>;
     useOrganizationPublicProfileByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useUserOrganizations: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateOrganization: () => import("@tanstack/react-query").UseMutationResult<any, Error, Partial<IOrganization>, unknown>;
@@ -444,8 +602,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useRefreshUserOrganizations: () => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
     useUserOrganizationById: (organizationId: string) => any;
     useClearCachedOrganizations: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-    useTeam: (teamId: string, organizationId: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<ITeam>, Error>;
-    useTeamByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<ITeam | null>, Error>;
+    useTeam: (teamId: string, organizationId: string) => import("@tanstack/react-query").UseQueryResult<ITeam, Error>;
+    useTeamByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<ITeam | null, Error>;
     useTeamsByOrganization: (organizationId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateTeam: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         team: Partial<ITeam>;
@@ -476,7 +634,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, unknown>;
     useRefreshTeams: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useClearCachedTeams: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-    useSchools: () => import("@tanstack/react-query").UseQueryResult<NoInfer<ISchool[]>, Error>;
+    useSchools: () => import("@tanstack/react-query").UseQueryResult<ISchool[], Error>;
     useRefreshSchools: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useSpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useOrganizationSpace: (organizationId: string, spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
@@ -540,7 +698,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         name: string;
         description: string;
     }, unknown>;
-    usePublicCourses: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useInstructorCourses: (userId?: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCourseEnrollments: () => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useEnrollStudentToCourse: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -564,7 +721,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         itemIds: string[];
     }, unknown>;
     useRefreshCourse: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
-    useRefreshPublicCourses: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshInstructorCourses: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshCoursesEnrollments: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
     useRefreshStudent: (options?: UseMutationOptions<unknown, Error, {
@@ -595,6 +751,25 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useCloneNotebook: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useRefreshNotebook: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useRefreshSpaceNotebooks: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
+    useDeck: (deckId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    useDecksBySpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    useCreateDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        spaceId: string;
+        name: string;
+        description?: string;
+        deckType?: string;
+        file?: File;
+    }, unknown>;
+    useUpdateDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        id: string;
+        name: string;
+        description: string;
+    }, unknown>;
+    useUpdateDeckModel: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        deckId: string;
+        spec: unknown;
+    }, unknown>;
+    useCloneDeck: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useDocument: (documentId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useDocumentsBySpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateDocument: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -630,40 +805,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useCloneCell: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useRefreshCell: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useRefreshSpaceCells: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
-    useDataset: (datasetId: string, scope?: {
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useDatasetsBySpace: (spaceId: string, scope?: {
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useUpdateDataset: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        id: string;
-        name: string;
-        description: string;
-        spaceId?: string;
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }, unknown>;
-    useRefreshDataset: (options?: UseMutationOptions<unknown, Error, string | {
-        datasetId: string;
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string | {
-        datasetId: string;
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }, unknown>;
-    useRefreshSpaceDatasets: (options?: UseMutationOptions<unknown, Error, string | {
-        spaceId: string;
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string | {
-        spaceId: string;
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }, unknown>;
     useEnvironment: (environmentId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useEnvironmentsBySpace: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useRefreshEnvironment: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
@@ -722,48 +863,113 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, unknown>;
     useRefreshSpaceAssignments: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useDeleteItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useSpaceItems: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<any[]>, Error>;
-    useSpaceDefaultItems: (spaceId: string | undefined) => import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    useSpaceItems: (spaceId: string) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+    useSpaceDefaultItems: (spaceId: string | undefined) => import("@tanstack/react-query").UseQueryResult<{
         defaultNotebookUid: string | null;
         defaultDocumentUid: string | null;
-    }>, Error>;
+    }, Error>;
     useMakeItemPublic: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useMakeItemPrivate: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useSearchPublicItems: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+    useSearchPublicItems: () => import("@tanstack/react-query").UseMutationResult<{
+        items: any;
+        total: number;
+        offset: number;
+    }, Error, {
         q?: string;
         types?: string[];
         max?: number;
-    }, unknown>;
-    usePublicItems: (options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
+        offset?: number;
+        /** `relevance`, `recent` or `orbits`. */
+        sort?: string;
+        featured?: boolean;
+        /** Only this account's artifacts: what a public profile page lists. */
+        owner?: string;
+    }, unknown>;
+    useLibraryArtifacts: (max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
     usePublications: (options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
-    useRefreshPublicItems: (options?: UseMutationOptions<unknown, Error, void>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, void, unknown>;
+    useFeaturedItems: (max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAllFeaturedItems: (options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    usePublicItem: (itemId?: string, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAccountPublications: (handle?: string, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useMyOrbits: (offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useAccountOrbits: (handle?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useItemOrbiters: (itemId?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useItemDerivations: (itemId?: string, offset?: number, max?: number, options?: UseQueryOptions<any, Error>) => import("@tanstack/react-query").DefinedUseQueryResult<unknown, Error>;
+    useOrbitItem: () => import("@tanstack/react-query").UseMutationResult<{
+        itemId: string;
+        orbits: number;
+        orbited: boolean;
+    }, Error, string, {
+        itemId: string;
+    }>;
+    useUnorbitItem: () => import("@tanstack/react-query").UseMutationResult<{
+        itemId: string;
+        orbits: number;
+        orbited: boolean;
+    }, Error, string, {
+        itemId: string;
+    }>;
+    useFeatureItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        rank?: number;
+    }, unknown>;
+    useUnfeatureItem: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useSetFeaturedRank: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        rank: number;
+    }, unknown>;
+    useSetItemImage: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        kind: "capture" | "box" | "icon";
+        ref?: string;
+        data?: string;
+    }, unknown>;
+    useResetItemImage: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useCountItemReuse: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        kind: "clone" | "instantiate";
+    }, unknown>;
+    useSyncArtifactCatalogue: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        artifacts: Array<Record<string, any>>;
+        artifactType?: string;
+    }, unknown>;
+    usePublishArtifact: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        image?: {
+            kind: "capture" | "box" | "icon";
+            ref?: string;
+            data?: string;
+        };
+        /**
+         * The publisher's own words for their work, which is what somebody
+         * else will search for.
+         *
+         * Sent with the visibility rather than in a write of their own: the
+         * service writes them onto the artifact in the same operation that
+         * makes it public, so publishing still costs what it cost. Omitted
+         * entirely, they are left as they were — which is what withdrawing
+         * wants, and what an older caller gets.
+         */
+        tags?: string[];
+        /**
+         * What the artifact says about itself, in the publisher's words.
+         *
+         * Sent with the visibility for the same reason the tags are: the
+         * service writes it onto the artifact in the operation that makes it
+         * public. Omitted entirely, it is left as it was.
+         */
+        description?: string;
+    }, unknown>;
+    useUnpublishArtifact: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useUpdateArtifactDetails: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        name?: string;
+        description?: string;
+        tags?: string[];
+    }, unknown>;
     useRefreshSpaceItems: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useClearCachedPublicItems: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
     useClearCachedItems: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-    usePage: (pageId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    usePages: (scope?: {
-        selectedPrincipalUid?: string;
-        selectedPrincipalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useCreatePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, Omit<any, "id">, unknown>;
-    useUpdatePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, Pick<any, "name" | "id" | "tags" | "description">, unknown>;
-    useDeletePage: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useDatasource: (datasourceId: string, options?: {
-        principalUid?: string;
-        principalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<NoInfer<IDatasource | null | undefined>, Error>;
-    useDatasources: (options?: {
-        principalUid?: string;
-        principalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseQueryResult<any, Error>;
-    useCreateDatasource: (options?: {
-        principalUid?: string;
-        principalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseMutationResult<any, Error, Omit<IDatasource, "id">, unknown>;
-    useUpdateDatasource: (options?: {
-        principalUid?: string;
-        principalKind?: "personal" | "organization" | "team";
-    }) => import("@tanstack/react-query").UseMutationResult<any, Error, IDatasource, unknown>;
     useSecret: (secretId: string, options?: {
         principalUid?: string;
         principalKind?: "personal" | "organization" | "team";
@@ -771,7 +977,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         refetchOnMount?: boolean | "always";
         staleTime?: number;
         gcTime?: number;
-    }) => import("@tanstack/react-query").UseQueryResult<NoInfer<ISecret | null | undefined>, Error>;
+    }) => import("@tanstack/react-query").UseQueryResult<ISecret | null | undefined, Error>;
     useSecrets: (options?: {
         principalUid?: string;
         principalKind?: "personal" | "organization" | "team";
@@ -788,12 +994,12 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         principalUid?: string;
         principalKind?: "personal" | "organization" | "team";
     }) => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useToken: (tokenId: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IIAMToken | null | undefined>, Error>;
-    useTokens: () => import("@tanstack/react-query").UseQueryResult<NoInfer<(IIAMToken | undefined)[]>, Error>;
+    useToken: (tokenId: string) => import("@tanstack/react-query").UseQueryResult<IIAMToken | null | undefined, Error>;
+    useTokens: () => import("@tanstack/react-query").UseQueryResult<(IIAMToken | undefined)[], Error>;
     useCreateToken: () => import("@tanstack/react-query").UseMutationResult<any, Error, Omit<IIAMToken, "value" | "id">, unknown>;
     useUpdateToken: () => import("@tanstack/react-query").UseMutationResult<any, Error, IIAMToken, unknown>;
     useDeleteToken: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useInvite: (token: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<import("..").IInvite | undefined>, Error>;
+    useInvite: (token: string) => import("@tanstack/react-query").UseQueryResult<import("..").IInvite | undefined, Error>;
     useInvitesByUser: (accountId: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     usePutInvite: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useRequestInvite: (options?: UseMutationOptions<unknown, Error, {
@@ -825,8 +1031,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useClearCachedInvites: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
     useContact: (contactId: string, options?: {
         enabled?: boolean;
-    }) => import("@tanstack/react-query").UseQueryResult<NoInfer<IContact | undefined>, Error>;
-    useContactByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<IContact | null | undefined>, Error>;
+    }) => import("@tanstack/react-query").UseQueryResult<IContact | undefined, Error>;
+    useContactByHandle: (handle: string) => import("@tanstack/react-query").UseQueryResult<IContact | null | undefined, Error>;
     useSearchContacts: (query: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateContact: () => import("@tanstack/react-query").UseMutationResult<any, Error, IContact, unknown>;
     useUpdateContact: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
@@ -864,15 +1070,16 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         contactId: string;
     }, unknown>;
     useRefreshContact: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
-    useInbounds: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
+    useInbounds: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
     useInbound: (id: string, options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useInboundByHandle: (handle: string, options?: UseQueryOptions<unknown, Error>) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useRefreshInbound: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useOutbound: (outboundId: string, options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
-    useOutbounds: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
+    useOutbounds: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
     useDraftBulkEmailsOutbounds: () => import("@tanstack/react-query").UseMutationResult<any, Error, unknown, unknown>;
     useTryBulkEmailsOutbounds: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useLaunchBulkEmailsOutbounds: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useMarkOutboundLaunched: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useSendOutboundEmailToUser: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         userId: string;
         recipient: string;
@@ -910,9 +1117,9 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, options?: Omit<UseQueryOptions<any>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useSubscriptionPlans: (scope?: {
         accountUid?: string;
-    }, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
-    useEligibleSubscriptionAccounts: (options?: Omit<UseQueryOptions<any[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<any[]>, Error>;
-    useSubscriptionAccountsDetails: (accountUids: string[], options?: Omit<UseQueryOptions<any[]>, "queryKey" | "queryFn" | "enabled">) => import("@tanstack/react-query").UseQueryResult<NoInfer<any[]>, Error>;
+    }, options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
+    useEligibleSubscriptionAccounts: (options?: Omit<UseQueryOptions<any[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
+    useSubscriptionAccountsDetails: (accountUids: string[], options?: Omit<UseQueryOptions<any[]>, "queryKey" | "queryFn" | "enabled">) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
     useCancelSubscription: (scope?: {
         accountUid?: string;
     }) => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
@@ -922,7 +1129,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useUserSubscription: (userId: string | undefined, options?: Omit<UseQueryOptions<any>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useResetUserSubscription: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useBurnCredit: () => import("@tanstack/react-query").UseMutationResult<any, Error, number, unknown>;
-    useTopUpPrices: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<NoInfer<unknown[]>, Error>;
+    useTopUpPrices: (options?: Omit<UseQueryOptions<unknown[]>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown[], Error>;
     useRequestPlatformSupport: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         subject: string;
         message: string;
@@ -939,21 +1146,162 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useUserSurveys: (userId: string, options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useGrowthKPI: (options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
     useGrowthContactsKPI: (options?: Omit<UseQueryOptions<unknown>, "queryKey" | "queryFn">) => import("@tanstack/react-query").UseQueryResult<unknown, Error>;
-    useRayClusters: () => import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    useRayClusters: () => import("@tanstack/react-query").UseQueryResult<{
         clusters: any[];
         namespaces: string[];
-    }>, Error>;
+    }, Error>;
     useRayCluster: (namespace?: string, clusterName?: string) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useCreateRayCluster: () => import("@tanstack/react-query").UseMutationResult<any, Error, Record<string, unknown>, unknown>;
     useDeleteRayCluster: (namespace?: string) => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useRayJobs: (namespace?: string, clusterName?: string) => import("@tanstack/react-query").UseQueryResult<NoInfer<any[]>, Error>;
+    useRayJobs: (namespace?: string, clusterName?: string) => import("@tanstack/react-query").UseQueryResult<any[], Error>;
     useSubmitRayJob: (clusterName: string) => import("@tanstack/react-query").UseMutationResult<any, Error, Record<string, unknown>, unknown>;
     useDeleteRayJob: (namespace?: string) => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useRayJobLogs: (jobName: string, namespace?: string, tailLines?: number, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<NoInfer<{
+    useRayJobLogs: (jobName: string, namespace?: string, tailLines?: number, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<{
         logs: string;
         status: string;
-    }>, Error>;
+    }, Error>;
     queryKeys: {
+        readonly contents: {
+            readonly all: () => readonly ["contents"];
+            readonly sources: () => readonly ["contents", "sources"];
+            readonly capabilities: () => readonly ["contents", "capabilities"];
+            readonly sourceList: (filters?: {
+                kind?: string;
+                cursor?: string;
+                limit?: number;
+            }) => readonly ["contents", "sources", "list", {
+                kind?: string;
+                cursor?: string;
+                limit?: number;
+            }];
+            readonly source: (sourceUid: string) => readonly ["contents", "sources", "detail", string];
+            readonly sourceSharing: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "sharing"];
+            readonly datasetRevisions: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "revisions"];
+            readonly datasetRevision: (sourceUid: string, revisionUid: string) => readonly ["contents", "sources", "detail", string, "revisions", string];
+            readonly datasetPublications: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "publications"];
+            readonly publishedDatasets: () => readonly ["contents", "publications", "datasets"];
+            readonly cloudObjects: (sourceUid: string, prefix?: string, cursor?: string) => readonly ["contents", "sources", "detail", string, "cloud", "objects", string, string];
+            readonly credentialDiagnostics: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "diagnostics"];
+            readonly homeFolder: () => readonly ["contents", "sources", "user-folder"];
+            readonly homeFolderQuota: () => readonly ["contents", "sources", "user-folder", "quota"];
+            readonly homeFolderObjects: (filters?: {
+                prefix?: string;
+                cursor?: string;
+                limit?: number;
+                order?: "path" | "updated";
+            }) => readonly ["contents", "sources", "user-folder", "objects", "list", {
+                prefix?: string;
+                cursor?: string;
+                limit?: number;
+                order?: "path" | "updated";
+            }];
+            readonly homeFolderObject: (path: string) => readonly ["contents", "sources", "user-folder", "objects", "stat", string];
+            readonly homeFolderObjectVersions: (objectUid: string, cursor?: string) => readonly ["contents", "sources", "user-folder", "objects", string, "versions", string];
+            readonly operations: () => readonly ["contents", "operations"];
+            readonly operation: (operationUid: string) => readonly ["contents", "operations", string];
+            readonly transfers: () => readonly ["contents", "transfers"];
+            readonly transferList: (filters?: {
+                active?: boolean;
+                cursor?: string;
+                limit?: number;
+            }) => readonly ["contents", "transfers", "list", {
+                active?: boolean;
+                cursor?: string;
+                limit?: number;
+            }];
+            readonly transfer: (transferUid: string) => readonly ["contents", "transfers", string];
+            readonly syncSessions: () => readonly ["contents", "sync"];
+            readonly syncSessionList: (filters?: {
+                active?: boolean;
+                cursor?: string;
+                limit?: number;
+            }) => readonly ["contents", "sync", "list", {
+                active?: boolean;
+                cursor?: string;
+                limit?: number;
+            }];
+            readonly syncSession: (sessionUid: string) => readonly ["contents", "sync", string];
+            readonly syncConflicts: (sessionUid: string) => readonly ["contents", "sync", string, "conflicts"];
+            readonly attachments: () => readonly ["contents", "attachments"];
+            readonly attachmentList: (filters?: {
+                sandboxUid?: string;
+                sourceUid?: string;
+                active?: boolean;
+            }) => readonly ["contents", "attachments", "list", {
+                sandboxUid?: string;
+                sourceUid?: string;
+                active?: boolean;
+            }];
+            readonly attachmentManifest: (sandboxUid: string) => readonly ["contents", "attachments", "manifest", string];
+            readonly bridgeSession: (attachmentUid: string) => readonly ["contents", "attachments", "bridge", string];
+            readonly bridges: () => readonly ["contents", "bridges"];
+            readonly bridgeList: (filters?: {
+                active?: boolean;
+            }) => readonly ["contents", "bridges", "list", {
+                active?: boolean;
+            }];
+            readonly bridge: (bridgeUid: string) => readonly ["contents", "bridges", string];
+            readonly runtimeMounts: (runtimeName: string) => readonly ["contents", "runtime-mounts", string];
+            readonly mcpTools: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "mcp", "tools"];
+            readonly mcpSessions: () => readonly ["contents", "mcp-sessions"];
+            readonly mcpSessionList: (filters?: {
+                sourceUid?: string;
+                active?: boolean;
+            }) => readonly ["contents", "mcp-sessions", "list", {
+                sourceUid?: string;
+                active?: boolean;
+            }];
+            readonly mcpSession: (sessionUid: string) => readonly ["contents", "mcp-sessions", string];
+            readonly mcpCalls: (sessionUid: string) => readonly ["contents", "mcp-sessions", string, "calls"];
+            readonly mcpCall: (sessionUid: string, callUid: string) => readonly ["contents", "mcp-sessions", string, "calls", string];
+            readonly mcpApprovals: () => readonly ["contents", "mcp-approvals"];
+            readonly mcpApprovalList: (filters?: {
+                status?: string;
+                sourceUid?: string;
+            }) => readonly ["contents", "mcp-approvals", "list", {
+                status?: string;
+                sourceUid?: string;
+            }];
+            readonly datasourceSchema: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "datasource", "schema"];
+            readonly datasourceCapabilities: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "datasource", "capabilities"];
+            readonly datasourceQueries: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "queries"];
+            readonly queries: () => readonly ["contents", "queries"];
+            readonly query: (queryUid: string) => readonly ["contents", "queries", string];
+            readonly dataserverStatus: (sourceUid: string) => readonly ["contents", "sources", "detail", string, "dataserver", "status"];
+        };
+        readonly mcp: {
+            readonly all: () => readonly ["mcp"];
+            readonly tasks: () => readonly ["mcp", "tasks"];
+            readonly taskList: (filters?: object) => readonly ["mcp", "tasks", "list", object];
+            readonly task: (taskUid: string) => readonly ["mcp", "tasks", string];
+            readonly notebookTasks: (notebookUid: string, filters?: object) => readonly ["mcp", "tasks", "notebook", string, object];
+            readonly bindings: () => readonly ["mcp", "bindings"];
+            readonly bindingList: (filters?: object) => readonly ["mcp", "bindings", "list", object];
+            readonly activity: (filters?: object) => readonly ["mcp", "activity", object];
+            readonly audit: () => readonly ["mcp", "audit"];
+            readonly auditList: (filters?: object) => readonly ["mcp", "audit", "list", object];
+            readonly policy: (filters?: object) => readonly ["mcp", "policy", object];
+            readonly connectedAgents: () => readonly ["mcp", "connected-agents"];
+            readonly serviceAgents: (orgUid: string) => readonly ["mcp", "service-agents", string];
+            readonly policyLayer: (scope: string, subjectUid: string) => readonly ["mcp", "policy-layer", string, string];
+            readonly alertRules: (orgUid: string) => readonly ["mcp", "alert-rules", string];
+            readonly identityProviders: (orgUid: string) => readonly ["mcp", "identity-providers", string];
+            readonly scimTokens: (orgUid: string) => readonly ["mcp", "scim-tokens", string];
+            readonly admittedClients: (scope: string, subjectUid: string) => readonly ["mcp", "admitted-clients", string, string];
+            readonly forwarding: (orgUid: string) => readonly ["mcp", "audit-forwarding", string];
+            readonly auditSettings: (orgUid: string) => readonly ["mcp", "audit-settings", string];
+            readonly organizationTeams: (orgUid: string) => readonly ["mcp", "organization-teams", string];
+            readonly trace: (taskUid: string) => readonly ["mcp", "tasks", string, "trace"];
+            readonly traceById: (traceId: string) => readonly ["mcp", "traces", string];
+            readonly logs: (taskUid: string) => readonly ["mcp", "tasks", string, "logs"];
+            readonly metrics: (filters?: object) => readonly ["mcp", "metrics", object];
+            readonly operations: () => readonly ["mcp", "operations"];
+            readonly workers: () => readonly ["mcp", "operations", "workers"];
+            readonly workflows: () => readonly ["mcp", "operations", "workflows"];
+            readonly gatewayVersion: () => readonly ["mcp", "version"];
+            readonly orgOverview: (orgUid: string, filters?: object) => readonly ["mcp", "organizations", string, "overview", object];
+            readonly orgUsage: (orgUid: string, filters?: object) => readonly ["mcp", "organizations", string, "usage", object];
+        };
         readonly auth: {
             readonly me: () => readonly ["auth", "me"];
             readonly whoami: () => readonly ["auth", "whoami"];
@@ -1019,18 +1367,19 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly bySpace: (spaceId: string) => readonly ["documents", "space", string];
             readonly model: (documentId: string) => readonly ["documents", "detail", string, "model"];
         };
+        readonly decks: {
+            readonly all: () => readonly ["decks"];
+            readonly details: () => readonly ["decks", "detail"];
+            readonly detail: (id: string) => readonly ["decks", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["decks", "space", string];
+            readonly model: (deckId: string) => readonly ["decks", "detail", string, "model"];
+        };
         readonly cells: {
             readonly all: () => readonly ["cells"];
             readonly details: () => readonly ["cells", "detail"];
             readonly detail: (id: string) => readonly ["cells", "detail", string];
             readonly bySpace: (spaceId: string) => readonly ["cells", "space", string];
         };
-        readonly datasets: {
-            readonly all: () => readonly ["datasets"];
-            readonly details: () => readonly ["datasets", "detail"];
-            readonly detail: (id: string) => readonly ["datasets", "detail", string];
-            readonly bySpace: (spaceId: string) => readonly ["datasets", "space", string];
-        };
         readonly lessons: {
             readonly all: () => readonly ["lessons"];
             readonly details: () => readonly ["lessons", "detail"];
@@ -1057,16 +1406,6 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             readonly detail: (id: string) => readonly ["environments", "detail", string];
             readonly bySpace: (spaceId: string) => readonly ["environments", "space", string];
         };
-        readonly pages: {
-            readonly all: () => readonly ["pages"];
-            readonly details: () => readonly ["pages", "detail"];
-            readonly detail: (id: string) => readonly ["pages", "detail", string];
-        };
-        readonly datasources: {
-            readonly all: () => readonly ["datasources"];
-            readonly details: () => readonly ["datasources", "detail"];
-            readonly detail: (id: string) => readonly ["datasources", "detail", string];
-        };
         readonly secrets: {
             readonly all: () => readonly ["secrets"];
             readonly details: () => readonly ["secrets", "detail"];
@@ -1115,8 +1454,14 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         readonly items: {
             readonly all: () => readonly ["items"];
             readonly public: () => readonly ["items", "public"];
+            readonly publicItem: (uid: string) => readonly ["items", "public", string];
             readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
             readonly search: (opts: ISearchOpts) => readonly ["items", "search", ISearchOpts];
+            readonly featured: () => readonly ["items", "featured"];
+            readonly orbits: () => readonly ["items", "orbits"];
+            readonly orbiters: (uid: string) => readonly ["items", "orbiters", string];
+            readonly derivations: (uid: string) => readonly ["items", "derivations", string];
+            readonly byOwner: (handle: string) => readonly ["items", "owner", string];
         };
         readonly layout: {
             readonly byAccount: (accountHandle: string, spaceHandle?: string) => readonly ["layout", string, string] | readonly ["layout", string];
@@ -1157,5 +1502,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     documentUploadLoading: boolean;
     documentUploadProgress: number;
     resetDocumentUpload: () => void;
+    deckUploadLoading: boolean;
+    deckUploadProgress: number;
+    resetDeckUpload: () => void;
 };
 export default useCache;