@datalayer/core 0.0.16 → 0.0.18

package/lib/examples/notebooks/NotebookExample1.ipynb.json

@@ -21,7 +21,7 @@
             "execution_count": 1,
             "metadata": {
                 "datalayer": {
-                    "_about": "AI Platform for Data Analysis"
+                    "_about": "AI Agents for Data Analysis"
                 }
             },
             "outputs": [

package/lib/hooks/useAIJupyterChat.d.ts

@@ -0,0 +1,36 @@
+export interface IUseAIJupyterChatOptions {
+    apiUrl?: string;
+    initialMessages?: unknown[];
+}
+/**
+ * Hook to manage chat state with JupyterLab backend.
+ * Adapts Vercel AI SDK's useChat for Datalayer AI context.
+ */
+export declare function useAIJupyterChat(_options?: IUseAIJupyterChatOptions): {
+    messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[];
+    sendMessage: (message?: (Omit<import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>, "id" | "role"> & {
+        id?: string | undefined;
+        role?: "user" | "system" | "assistant" | undefined;
+    } & {
+        text?: never;
+        files?: never;
+        messageId?: string;
+    }) | {
+        text: string;
+        files?: FileList | import("ai").FileUIPart[];
+        metadata?: unknown;
+        parts?: never;
+        messageId?: string;
+    } | {
+        files: FileList | import("ai").FileUIPart[];
+        metadata?: unknown;
+        parts?: never;
+        messageId?: string;
+    } | undefined, options?: import("ai").ChatRequestOptions) => Promise<void>;
+    status: import("ai").ChatStatus;
+    setMessages: (messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[] | ((messages: import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[]) => import("ai").UIMessage<unknown, import("ai").UIDataTypes, import("ai").UITools>[])) => void;
+    regenerate: ({ messageId, ...options }?: {
+        messageId?: string;
+    } & import("ai").ChatRequestOptions) => Promise<void>;
+    clearChat: () => void;
+};

package/lib/hooks/useAIJupyterChat.js

@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/*
+ * Copyright (c) 2024-2025 Datalayer, Inc.
+ *
+ * BSD 3-Clause License
+ */
+import { useCallback, useMemo } from 'react';
+import { useChat } from '@ai-sdk/react';
+import { DefaultChatTransport } from 'ai';
+import { ServerConnection } from '@jupyterlab/services';
+import { URLExt } from '@jupyterlab/coreutils';
+/**
+ * Hook to manage chat state with JupyterLab backend.
+ * Adapts Vercel AI SDK's useChat for Datalayer AI context.
+ */
+export function useAIJupyterChat(_options = {}) {
+    // Build the full API URL for the chat endpoint
+    const settings = ServerConnection.makeSettings();
+    const chatEndpoint = URLExt.join(settings.baseUrl, 'datalayer', 'chat');
+    const { messages, sendMessage, status, setMessages, regenerate } = useChat({
+        id: 'ai-jupyter-chat',
+        transport: new DefaultChatTransport({
+            api: chatEndpoint,
+            credentials: settings.token ? 'include' : 'omit',
+            headers: {
+                Authorization: `token ${settings.token || ''}`,
+                'X-XSRFToken': settings.token || '',
+            },
+            fetch: async (input, init) => {
+                return fetch(input, {
+                    ...init,
+                    mode: 'cors',
+                    credentials: settings.token ? 'include' : 'omit',
+                });
+            },
+        }),
+    });
+    // Clear chat history
+    const clearChat = useCallback(() => {
+        setMessages([]);
+    }, [setMessages]);
+    return useMemo(() => ({
+        messages,
+        sendMessage,
+        status,
+        setMessages,
+        regenerate,
+        clearChat,
+    }), [messages, sendMessage, status, setMessages, regenerate, clearChat]);
+}

package/lib/hooks/useBackdrop.d.ts

@@ -1,3 +1,4 @@
+import { ReactNode } from 'react';
 import PropTypes from 'prop-types';
 type BackdropContextType = {
     closeBackdrop: () => void;
@@ -10,19 +11,18 @@ export declare function useBackdrop(): BackdropContextType;
  */
 export declare const BackdropContextProvider: import("react").Provider<BackdropContextType>;
 type IBackdropProviderProps = {
-    children?: JSX.Element | JSX.Element[];
+    children?: ReactNode;
     zIndex?: number;
     disableDarken?: boolean;
     backdropSurface?: any;
 };
-export declare function BackdropProvider(props: IBackdropProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function BackdropProvider({ children, zIndex, disableDarken, backdropSurface, }: IBackdropProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace BackdropProvider {
     var propTypes: {
-        children: PropTypes.Requireable<PropTypes.ReactElementLike>;
+        children: PropTypes.Requireable<NonNullable<PropTypes.ReactNodeLike>>;
         zIndex: PropTypes.Requireable<number>;
         disableDarken: PropTypes.Requireable<boolean>;
         backdropSurface: PropTypes.Requireable<(...args: any[]) => any>;
     };
-    var defaultProps: IBackdropProviderProps;
 }
 export {};

package/lib/hooks/useBackdrop.js

@@ -48,8 +48,7 @@ const App = () => (
 )
 export default App
 */
-export function BackdropProvider(props) {
-    const { children, zIndex, disableDarken, backdropSurface } = props;
+export function BackdropProvider({ children = null, zIndex = 9999, disableDarken = false, backdropSurface = null, }) {
     const defaultBackdropSurface = {
         position: 'fixed',
         top: 0,
@@ -82,7 +81,10 @@ export function BackdropProvider(props) {
                 (backdropSurface ? (backdropSurface(backdrop.render(closeBackdrop))) : (_jsx("div", { style: defaultBackdropSurface, children: backdrop.render(closeBackdrop) })))] }));
 }
 BackdropProvider.propTypes = {
-    children: PropTypes.element,
+    children: PropTypes.oneOfType([
+        PropTypes.node,
+        PropTypes.arrayOf(PropTypes.node),
+    ]),
     // zIndex of the backdrop surface. Unused if backdropSurface is overridden.
     zIndex: PropTypes.number,
     // If true, backdrop background is transparent.
@@ -92,9 +94,3 @@ BackdropProvider.propTypes = {
     // See /example/src/ExampleApp.jsx for proper use.
     backdropSurface: PropTypes.func,
 };
-BackdropProvider.defaultProps = {
-    children: undefined,
-    disableBackdrop: false,
-    zIndex: 9999,
-    backdropSurface: null,
-};

package/lib/hooks/useCache.d.ts

@@ -173,6 +173,7 @@ export declare const queryKeys: {
     };
     readonly contacts: {
         readonly all: () => readonly ["contacts"];
+        readonly lists: () => readonly ["contacts", "list"];
         readonly details: () => readonly ["contacts", "detail"];
         readonly detail: (id: string) => readonly ["contacts", "detail", string];
         readonly byHandle: (handle: string) => readonly ["contacts", "handle", string];
@@ -683,7 +684,9 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
     useRefreshInvite: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useRefreshInvites: (options?: UseMutationOptions<unknown, Error, string>) => import("@tanstack/react-query").UseMutationResult<unknown, Error, string, unknown>;
     useClearCachedInvites: (options?: UseMutationOptions<void, Error, void>) => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
-    useContact: (contactId: string) => import("@tanstack/react-query").UseQueryResult<IContact | undefined, Error>;
+    useContact: (contactId: string, options?: {
+        enabled?: boolean;
+    }) => 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>;
@@ -893,6 +896,7 @@ export declare const useCache: ({ loginRoute }?: CacheProps) => {
         };
         readonly contacts: {
             readonly all: () => readonly ["contacts"];
+            readonly lists: () => readonly ["contacts", "list"];
             readonly details: () => readonly ["contacts", "detail"];
             readonly detail: (id: string) => readonly ["contacts", "detail", string];
             readonly byHandle: (handle: string) => readonly ["contacts", "handle", string];