@datalayer/core 1.1.66 → 1.2.12

package/lib/config/Configuration.d.ts

@@ -76,7 +76,7 @@ export type IDatalayerCoreConfig = {
     /**
      * Jupyter MCP Server URL.
      */
-    jupyterMcpServerUrl: string;
+    datalayerMcpServerUrl: string;
     /**
      * OTEL (OpenTelemetry) API URL.
      *
@@ -170,10 +170,10 @@ export declare class DatalayerConfiguration {
  * Default configuration values for Datalayer
  */
 /**
- * Where a service lives when nothing says otherwise.
+ * Where a service lives when nothing says otherwise: the control plane.
  *
- * Each service has a URL of its own — `iamUrl`, `runtimesUrl`, … — and this is
- * what each of them falls back to.
+ * Kept under its old name for the callers that have it; the table every
+ * service is read from is `DEFAULT_PLANE_URLS` in `config/planes`.
  */
 export declare const DEFAULT_DATALAYER_SERVICE_URL = "https://prod1.datalayer.run";
 /**

package/lib/config/Configuration.js

@@ -4,6 +4,7 @@
  */
 import { Signal } from '@lumino/signaling';
 import { coreStore } from '../state/index.js';
+import { CONTROL_PLANE_URL, DEFAULT_PLANE_URLS, RUNTIMES_PLANE_URL, } from './planes.js';
 export const FORCE_ACTIVATE_RUNTIMES_PLUGINS = false;
 export class DatalayerConfiguration {
     _configuration = coreStore.getState().configuration;
@@ -26,21 +27,20 @@ export class DatalayerConfiguration {
  * Default configuration values for Datalayer
  */
 /**
- * Where a service lives when nothing says otherwise.
+ * Where a service lives when nothing says otherwise: the control plane.
  *
- * Each service has a URL of its own — `iamUrl`, `runtimesUrl`, … — and this is
- * what each of them falls back to.
+ * Kept under its old name for the callers that have it; the table every
+ * service is read from is `DEFAULT_PLANE_URLS` in `config/planes`.
  */
-export const DEFAULT_DATALAYER_SERVICE_URL = 'https://prod1.datalayer.run';
+export const DEFAULT_DATALAYER_SERVICE_URL = CONTROL_PLANE_URL;
 /**
  * Where the Contents service lives when nothing says otherwise.
  *
  * Not the generic default: Contents runs on the runtimes plane, where the NFS that backs the Home Folder and Volumes lives.
  */
-export const DEFAULT_DATALAYER_CONTENTS_URL = 'https://r1.datalayer.run';
+export const DEFAULT_DATALAYER_CONTENTS_URL = RUNTIMES_PLANE_URL;
 export const DEFAULT_DATALAYER_CONFIG = {
-    iamUrl: DEFAULT_DATALAYER_SERVICE_URL,
-    contentsUrl: DEFAULT_DATALAYER_CONTENTS_URL,
+    ...DEFAULT_PLANE_URLS,
     credits: 100,
     cpuEnvironment: 'ai-agents-env',
     gpuEnvironment: 'ai-env',

package/lib/config/index.d.ts

@@ -1,2 +1,3 @@
 export * from './Configuration';
+export * from './planes';
 export * from './integrations';

package/lib/config/index.js

@@ -3,4 +3,5 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export * from './Configuration.js';
+export * from './planes.js';
 export * from './integrations/index.js';

package/lib/config/planes.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Where each Datalayer service lives when nothing says otherwise.
+ *
+ * Two planes. The control plane (`prod1`) holds identity, the library, the
+ * spaces and the platform's own services. The runtimes plane (`r1`) holds
+ * what runs close to compute: the runtimes, the scheduler, the agents, the
+ * contents that back the Home Folder — and inference, which moved there
+ * with the agents that call it.
+ *
+ * One table, imported by everything that needs a default host: the core
+ * store's initial configuration, the configuration helpers, and any host
+ * that wants to know where to point. It used to be a literal in each of
+ * those, and the examples' Makefile besides, so a service that changed plane
+ * was corrected in some places and not others — inference was still pinned
+ * to the control plane by the examples after it moved, and every in-page
+ * agent there failed to reach it.
+ *
+ * No imports, so anything may import it without a cycle.
+ *
+ * @module config/planes
+ */
+/** The control plane. */
+export declare const CONTROL_PLANE_URL = "https://prod1.datalayer.run";
+/** The runtimes plane. */
+export declare const RUNTIMES_PLANE_URL = "https://r1.datalayer.run";
+/** The MCP gateway, on its own host. */
+export declare const MCP_SERVER_URL = "https://mcp.datalayer.run/mcp";
+/** Every service's default host, by the configuration key that names it. */
+export declare const DEFAULT_PLANE_URLS: {
+    readonly iamUrl: "https://prod1.datalayer.run";
+    readonly managerUrl: "https://prod1.datalayer.run";
+    readonly libraryUrl: "https://prod1.datalayer.run";
+    readonly spacerUrl: "https://prod1.datalayer.run";
+    readonly otelUrl: "https://prod1.datalayer.run";
+    readonly growthUrl: "https://prod1.datalayer.run";
+    readonly inboundsUrl: "https://prod1.datalayer.run";
+    readonly successUrl: "https://prod1.datalayer.run";
+    readonly supportUrl: "https://prod1.datalayer.run";
+    readonly contentsUrl: "https://r1.datalayer.run";
+    readonly runtimesUrl: "https://r1.datalayer.run";
+    readonly schedulerUrl: "https://r1.datalayer.run";
+    readonly aiAgentsUrl: "https://r1.datalayer.run";
+    readonly aiInferenceUrl: "https://r1.datalayer.run";
+    readonly datalayerMcpServerUrl: "https://mcp.datalayer.run/mcp";
+};

package/lib/config/planes.js

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2023-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Where each Datalayer service lives when nothing says otherwise.
+ *
+ * Two planes. The control plane (`prod1`) holds identity, the library, the
+ * spaces and the platform's own services. The runtimes plane (`r1`) holds
+ * what runs close to compute: the runtimes, the scheduler, the agents, the
+ * contents that back the Home Folder — and inference, which moved there
+ * with the agents that call it.
+ *
+ * One table, imported by everything that needs a default host: the core
+ * store's initial configuration, the configuration helpers, and any host
+ * that wants to know where to point. It used to be a literal in each of
+ * those, and the examples' Makefile besides, so a service that changed plane
+ * was corrected in some places and not others — inference was still pinned
+ * to the control plane by the examples after it moved, and every in-page
+ * agent there failed to reach it.
+ *
+ * No imports, so anything may import it without a cycle.
+ *
+ * @module config/planes
+ */
+/** The control plane. */
+export const CONTROL_PLANE_URL = 'https://prod1.datalayer.run';
+/** The runtimes plane. */
+export const RUNTIMES_PLANE_URL = 'https://r1.datalayer.run';
+/** The MCP gateway, on its own host. */
+export const MCP_SERVER_URL = 'https://mcp.datalayer.run/mcp';
+/** Every service's default host, by the configuration key that names it. */
+export const DEFAULT_PLANE_URLS = {
+    iamUrl: CONTROL_PLANE_URL,
+    managerUrl: CONTROL_PLANE_URL,
+    libraryUrl: CONTROL_PLANE_URL,
+    spacerUrl: CONTROL_PLANE_URL,
+    otelUrl: CONTROL_PLANE_URL,
+    growthUrl: CONTROL_PLANE_URL,
+    inboundsUrl: CONTROL_PLANE_URL,
+    successUrl: CONTROL_PLANE_URL,
+    supportUrl: CONTROL_PLANE_URL,
+    contentsUrl: RUNTIMES_PLANE_URL,
+    runtimesUrl: RUNTIMES_PLANE_URL,
+    schedulerUrl: RUNTIMES_PLANE_URL,
+    aiAgentsUrl: RUNTIMES_PLANE_URL,
+    aiInferenceUrl: RUNTIMES_PLANE_URL,
+    datalayerMcpServerUrl: MCP_SERVER_URL,
+};

package/lib/hooks/cacheConverters.d.ts

@@ -5,13 +5,6 @@
  * @returns The converted snapshot object.
  */
 export declare function asCodeSandboxSnapshot(s: any): any;
-/**
- * Convert a raw page payload into its client shape.
- *
- * @param s - The raw page payload from the API.
- * @returns The converted page object.
- */
-export declare const asPage: (s: any) => any;
 /**
  * Convert a raw space payload into its client shape.
  *

package/lib/hooks/cacheConverters.js

@@ -30,31 +30,6 @@ export function asCodeSandboxSnapshot(s) {
         formatVersion: format_version,
     };
 }
-/**
- * Convert a raw page payload into its client shape.
- *
- * @param s - The raw page payload from the API.
- * @returns The converted page object.
- */
-export const asPage = (s) => {
-    return {
-        id: s.uid,
-        type: 'page',
-        variant: s.variant_s,
-        name: s.name_t,
-        description: s.description_t,
-        theme: s.theme_s,
-        nbformat: s.nbformat_s ? JSON.parse(s.nbformat_s) : undefined,
-        screenCapture: s.screen_capture_cdn_url_s || s.screen_capture_s,
-        tags: s.tags_ss ?? [],
-        creator: s.creator ? asUser(s.creator) : undefined,
-        creatorId: s.creator_uid,
-        kernelSnapshot: s.kernel_snapshot
-            ? asCodeSandboxSnapshot(s.kernel_snapshot)
-            : undefined,
-        kernelSnapshotId: s.kernel_snapshot_uid,
-    };
-};
 /**
  * Convert a raw space payload into its client shape.
  *

package/lib/hooks/index.d.ts

@@ -31,6 +31,7 @@ export * from './useMobile';
 export * from './useUsageRefreshStore';
 export * from './usePrincipalStore';
 export * from './usePrincipalCacheStore';
+export * from './useSpaceCacheStore';
 export * from './useBillingEntityStore';
 export * from './useSelectedPrincipal';
 export * from './useSelectedBillingEntity';

package/lib/hooks/index.js

@@ -36,6 +36,7 @@ export * from './useMobile.js';
 export * from './useUsageRefreshStore.js';
 export * from './usePrincipalStore.js';
 export * from './usePrincipalCacheStore.js';
+export * from './useSpaceCacheStore.js';
 export * from './useBillingEntityStore.js';
 export * from './useSelectedPrincipal.js';
 export * from './useSelectedBillingEntity.js';

package/lib/hooks/useBackdrop.d.ts

@@ -1,5 +1,4 @@
 import { ReactNode } from 'react';
-import PropTypes from 'prop-types';
 export type BackdropContextType = {
     closeBackdrop: () => void;
     displayBackdrop: (nextBackdrop: any) => void;
@@ -19,9 +18,9 @@ export type IBackdropProviderProps = {
 export declare function BackdropProvider({ children, zIndex, disableDarken, backdropSurface, }: IBackdropProviderProps): import("react").JSX.Element;
 export declare namespace BackdropProvider {
     var propTypes: {
-        children: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
-        zIndex: PropTypes.Requireable<number>;
-        disableDarken: PropTypes.Requireable<boolean>;
-        backdropSurface: PropTypes.Requireable<(...args: any[]) => any>;
+        children: any;
+        zIndex: any;
+        disableDarken: any;
+        backdropSurface: any;
     };
 }

package/lib/hooks/useBillingEntityStore.js

@@ -5,6 +5,7 @@
 import { create } from 'zustand';
 import { createJSONStorage, persist } from 'zustand/middleware';
 import { useUsageRefreshStore } from './useUsageRefreshStore.js';
+import { registerSessionState } from '../state/sessionEnd.js';
 export const useBillingEntityStore = create()(persist(set => ({
     billingEntityKind: 'user',
     billingEntityUid: undefined,
@@ -51,3 +52,5 @@ export const useBillingEntityStore = create()(persist(set => ({
     }),
 }));
 export default useBillingEntityStore;
+// The billing entity is the signed-in person's: forgotten when the session ends.
+registerSessionState({ forget: () => useBillingEntityStore.getState().resetBillingEntity() });

package/lib/hooks/useCache.d.ts

@@ -32,7 +32,7 @@
  * }
  * ```
  */
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+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 = {
@@ -44,6 +44,25 @@ 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
@@ -174,6 +193,9 @@ export declare const queryKeys: {
         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];
@@ -253,6 +275,13 @@ 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"];
@@ -285,11 +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 secrets: {
         readonly all: () => readonly ["secrets"];
         readonly details: () => readonly ["secrets", "detail"];
@@ -338,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];
@@ -399,6 +429,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         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, {
@@ -453,38 +484,46 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, Error, Record<string, string>, unknown>;
     useGetGitHubProfile: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
     useGetGoogleProfile: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
-    useGetLinkedinProfile: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useGetLinkedinProfile: () => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
     usePostLinkedinShare: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        linkedinUserUrn: string;
         postText: string;
-        accessToken: string;
     }, unknown>;
     usePostLinkedinShareWithUpload: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        linkedinUserUrn: string;
         postText: string;
         uploadObject?: string;
-        accessToken: string;
     }, unknown>;
+    useGetBlueskyConnection: () => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
+    useConnectBluesky: () => import("@tanstack/react-query").UseMutationResult<any, Error, string | {
+        identifier: string;
+        returnOrigin?: string;
+    }, unknown>;
+    useDisconnectBluesky: () => import("@tanstack/react-query").UseMutationResult<any, Error, void, unknown>;
+    usePublishLinkedInShare: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        commentary: string;
+        idempotencyKey: string;
+        imageDataUrl?: string;
+        imageAltText?: string;
+    }, unknown>;
+    useUnpublishLinkedInShare: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useLinkedInShares: (itemId: string, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+    usePublishBlueskyShare: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        itemId: string;
+        finding: string;
+        cellId: string;
+        outputIndex: number;
+        idempotencyKey: string;
+        imageDataUrl: string;
+        imageAltText: string;
+    }, unknown>;
+    useUnpublishBlueskyShare: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useBlueskyShares: (itemId: string, enabled?: boolean) => import("@tanstack/react-query").UseQueryResult<any, Error>;
     useRegisterToWaitingList: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
         firstName: string;
         lastName: string;
         email: string;
         affiliation?: string;
     }, unknown>;
-    useProxyGET: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        url: string;
-        token: string;
-    }, unknown>;
-    useProxyPOST: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        url: string;
-        body: object;
-        token: string;
-    }, unknown>;
-    useProxyPUT: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
-        url: string;
-        body: object;
-        token: string;
-    }, unknown>;
     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>;
@@ -667,7 +706,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, {
@@ -691,7 +729,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, {
@@ -722,6 +759,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, {
@@ -822,25 +878,108 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     }, 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";
+        signupSource?: "copy" | "linkedin" | "x" | "bluesky";
+        shareRef?: string;
+    }, 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>;
     useSecret: (secretId: string, options?: {
         principalUid?: string;
         principalKind?: "personal" | "organization" | "team";
@@ -1156,6 +1295,9 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
             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];
@@ -1235,6 +1377,13 @@ 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"];
@@ -1267,11 +1416,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 secrets: {
             readonly all: () => readonly ["secrets"];
             readonly details: () => readonly ["secrets", "detail"];
@@ -1320,8 +1464,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];
@@ -1362,5 +1512,8 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     documentUploadLoading: boolean;
     documentUploadProgress: number;
     resetDocumentUpload: () => void;
+    deckUploadLoading: boolean;
+    deckUploadProgress: number;
+    resetDeckUpload: () => void;
 };
 export default useCache;