@datalayer/agent-runtimes 1.0.1 → 1.0.3

package/lib/components/sparklines/dataProcessing.js

@@ -1,35 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Get minimum value from array
- */
-export const min = (data) => {
-    return Math.min(...data);
-};
-/**
- * Get maximum value from array
- */
-export const max = (data) => {
-    return Math.max(...data);
-};
-export const dataToPoints = ({ data, limit, width = 1, height = 1, margin = 0, max: maxVal, min: minVal, }) => {
-    let processedData = [...data];
-    const len = processedData.length;
-    // Limit data if specified
-    if (limit && limit < len) {
-        processedData = processedData.slice(len - limit);
-    }
-    // Calculate min/max if not provided
-    const dataMax = maxVal ?? max(processedData);
-    const dataMin = minVal ?? min(processedData);
-    // Calculate scaling factors
-    const vfactor = (height - margin * 2) / (dataMax - dataMin || 2);
-    const hfactor = (width - margin * 2) / ((limit || len) - (len > 1 ? 1 : 0));
-    // Map data to points
-    return processedData.map((d, i) => ({
-        x: i * hfactor + margin,
-        y: (dataMax === dataMin ? 1 : dataMax - d) * vfactor + margin,
-    }));
-};

package/lib/components/sparklines/index.d.ts

@@ -1,4 +0,0 @@
-export { Sparklines } from './Sparklines';
-export { SparklinesLine } from './SparklinesLine';
-export type { SparklinesProps, SparklinesLineProps, Point } from './types';
-export { dataToPoints, min, max } from './dataProcessing';

package/lib/components/sparklines/index.js

@@ -1,7 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export { Sparklines } from './Sparklines';
-export { SparklinesLine } from './SparklinesLine';
-export { dataToPoints, min, max } from './dataProcessing';

package/lib/components/sparklines/types.d.ts

@@ -1,36 +0,0 @@
-/**
- * Point interface for sparkline coordinates
- */
-export interface Point {
-    x: number;
-    y: number;
-}
-/**
- * Sparklines component props
- */
-export interface SparklinesProps {
-    data: number[];
-    width?: number;
-    height?: number;
-    svgWidth?: number;
-    svgHeight?: number;
-    preserveAspectRatio?: string;
-    margin?: number;
-    style?: React.CSSProperties;
-    min?: number;
-    max?: number;
-    limit?: number;
-    children?: React.ReactNode;
-}
-/**
- * Sparklines Line component props
- */
-export interface SparklinesLineProps {
-    data?: number[];
-    points?: Point[];
-    width?: number;
-    height?: number;
-    margin?: number;
-    color?: string;
-    style?: React.CSSProperties;
-}

package/lib/examples/stores/examplesStore.d.ts

@@ -1,5 +0,0 @@
-import type { Agent, AgentStatus, AgentsState, Transport } from '../../types/Types';
-export type { Agent, AgentStatus, AgentsState, Transport };
-export declare const agentsStore: any;
-export declare function useAgentsStore(): AgentsState;
-export declare function useAgentsStore<T>(selector: (state: AgentsState) => T): T;

package/lib/examples/stores/notebooks/Empty.ipynb.json

@@ -1,33 +0,0 @@
-{
-    "cells": [
-        {
-            "cell_type": "code",
-            "execution_count": null,
-            "id": "309d9aeb-4a19-400b-b5fe-ed20091b357b",
-            "metadata": {},
-            "outputs": [],
-            "source": []
-        }
-    ],
-    "metadata": {
-        "kernelspec": {
-            "display_name": "Python 3 (ipykernel)",
-            "language": "python",
-            "name": "python3"
-        },
-        "language_info": {
-            "codemirror_mode": {
-                "name": "ipython",
-                "version": 3
-            },
-            "file_extension": ".py",
-            "mimetype": "text/x-python",
-            "name": "python",
-            "nbconvert_exporter": "python",
-            "pygments_lexer": "ipython3",
-            "version": "3.11.4"
-        }
-    },
-    "nbformat": 4,
-    "nbformat_minor": 5
-}

package/lib/examples/stores/notebooks/NotebookExample2.ipynb.json

@@ -1,48 +0,0 @@
-{
-    "cells": [
-        {
-            "cell_type": "code",
-            "execution_count": 1,
-            "metadata": {},
-            "outputs": [
-                {
-                    "data": {
-                        "text/plain": ["4"]
-                    },
-                    "execution_count": 1,
-                    "metadata": {},
-                    "output_type": "execute_result"
-                }
-            ],
-            "source": ["2+2"]
-        },
-        {
-            "cell_type": "code",
-            "execution_count": null,
-            "metadata": {},
-            "outputs": [],
-            "source": []
-        }
-    ],
-    "metadata": {
-        "kernelspec": {
-            "display_name": "Python (ipykernel)",
-            "language": "python",
-            "name": "python"
-        },
-        "language_info": {
-            "codemirror_mode": {
-                "name": "ipython",
-                "version": 3
-            },
-            "file_extension": ".py",
-            "mimetype": "text/x-python",
-            "name": "python",
-            "nbconvert_exporter": "python",
-            "pygments_lexer": "ipython3",
-            "version": "3.10.4"
-        }
-    },
-    "nbformat": 4,
-    "nbformat_minor": 4
-}

package/lib/examples/stores/themeStore.d.ts

@@ -1,33 +0,0 @@
-import { type ThemeVariant, type ColorMode } from '@datalayer/primer-addons';
-export type { ThemeVariant, ColorMode };
-export interface ThemeState {
-    /** Current color mode (light, dark, or auto = follow OS). */
-    colorMode: ColorMode;
-    /** Current theme variant. */
-    theme: ThemeVariant;
-    /** Cycle through light → dark → auto. */
-    toggleColorMode: () => void;
-    /** Set a specific color mode. */
-    setColorMode: (mode: ColorMode) => void;
-    /**
-     * Set the active theme variant.
-     * @param applyDefaultColorMode When true (default), also switches the
-     *   color mode to the theme's configured default.
-     */
-    setTheme: (theme: ThemeVariant, applyDefaultColorMode?: boolean) => void;
-}
-/**
- * Zustand store for theme preferences in the examples app.
- * Persisted to localStorage under 'agent-runtimes-theme' key.
- */
-export declare const useExampleThemeStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ThemeState>, "persist"> & {
-    persist: {
-        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ThemeState, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: ThemeState) => void) => () => void;
-        onFinishHydration: (fn: (state: ThemeState) => void) => () => void;
-        getOptions: () => Partial<import("zustand/middleware").PersistOptions<ThemeState, unknown>>;
-    };
-}>;

package/lib/examples/stores/themeStore.js

@@ -1,38 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { create } from 'zustand';
-import { persist, createJSONStorage } from 'zustand/middleware';
-import { themeConfigs, } from '@datalayer/primer-addons';
-/**
- * Zustand store for theme preferences in the examples app.
- * Persisted to localStorage under 'agent-runtimes-theme' key.
- */
-export const useExampleThemeStore = create()(persist(set => ({
-    colorMode: 'light',
-    theme: 'datalayer',
-    toggleColorMode: () => set(state => {
-        const cycle = {
-            light: 'dark',
-            dark: 'auto',
-            auto: 'light',
-        };
-        return { colorMode: cycle[state.colorMode] };
-    }),
-    setColorMode: (mode) => set({ colorMode: mode }),
-    setTheme: (theme, applyDefaultColorMode = true) => set(() => {
-        const next = { theme };
-        if (applyDefaultColorMode) {
-            next.colorMode = themeConfigs[theme].defaultColorMode;
-        }
-        return next;
-    }),
-}), {
-    name: 'agent-runtimes-theme',
-    storage: createJSONStorage(() => localStorage),
-    partialize: state => ({
-        colorMode: state.colorMode,
-        theme: state.theme,
-    }),
-}));

package/lib/hooks/useKeyboardShortcuts.d.ts

@@ -1,47 +0,0 @@
-/**
- * Keyboard shortcut configuration
- */
-export interface KeyboardShortcut {
-    /** Key to press (e.g., 'k', 'Escape') */
-    key: string;
-    /** Whether Ctrl (or Cmd on Mac) is required */
-    ctrlOrCmd?: boolean;
-    /** Whether Shift is required */
-    shift?: boolean;
-    /** Whether Alt is required */
-    alt?: boolean;
-    /** Callback when shortcut is triggered */
-    handler: () => void;
-    /** Description for accessibility */
-    description?: string;
-    /** Whether shortcut works in input fields */
-    allowInInput?: boolean;
-}
-/**
- * Hook options
- */
-export interface UseKeyboardShortcutsOptions {
-    /** Whether shortcuts are enabled */
-    enabled?: boolean;
-    /** Shortcuts to register */
-    shortcuts: KeyboardShortcut[];
-}
-/**
- * Hook to handle keyboard shortcuts
- */
-export declare function useKeyboardShortcuts({ enabled, shortcuts, }: UseKeyboardShortcutsOptions): void;
-/**
- * Default chat shortcuts
- */
-export declare function useChatKeyboardShortcuts({ onToggle, onNewChat, onClear, onFocusInput, enabled, }: {
-    onToggle?: () => void;
-    onNewChat?: () => void;
-    onClear?: () => void;
-    onFocusInput?: () => void;
-    enabled?: boolean;
-}): void;
-/**
- * Get shortcut display string
- */
-export declare function getShortcutDisplay(shortcut: KeyboardShortcut): string;
-export default useKeyboardShortcuts;

package/lib/hooks/useKeyboardShortcuts.js

@@ -1,153 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/**
- * Keyboard shortcuts hook for Chat.
- * Provides keyboard shortcut handling for the chat interface.
- *
- * @module components/chat/hooks/useKeyboardShortcuts
- */
-import { useEffect, useCallback } from 'react';
-/**
- * Platform detection - check if running on macOS
- */
-function isMacOS() {
-    if (typeof navigator === 'undefined')
-        return false;
-    return /Mac|iPod|iPhone|iPad/.test(navigator.platform);
-}
-/**
- * Hook to handle keyboard shortcuts
- */
-export function useKeyboardShortcuts({ enabled = true, shortcuts, }) {
-    const handleKeyDown = useCallback((event) => {
-        if (!enabled)
-            return;
-        const target = event.target;
-        const isInInput = target.tagName === 'INPUT' ||
-            target.tagName === 'SELECT' ||
-            target.tagName === 'TEXTAREA' ||
-            target.isContentEditable;
-        for (const shortcut of shortcuts) {
-            // Skip if in input and not allowed
-            if (isInInput && !shortcut.allowInInput) {
-                // Exception: always allow Escape
-                if (shortcut.key !== 'Escape') {
-                    continue;
-                }
-            }
-            // Check key match
-            if (event.key.toLowerCase() !== shortcut.key.toLowerCase()) {
-                continue;
-            }
-            // Check modifiers
-            const ctrlOrCmdPressed = isMacOS() ? event.metaKey : event.ctrlKey;
-            if (shortcut.ctrlOrCmd && !ctrlOrCmdPressed) {
-                continue;
-            }
-            if (!shortcut.ctrlOrCmd &&
-                ctrlOrCmdPressed &&
-                shortcut.key !== 'Escape') {
-                continue;
-            }
-            if (shortcut.shift && !event.shiftKey) {
-                continue;
-            }
-            if (shortcut.alt && !event.altKey) {
-                continue;
-            }
-            // Prevent default and execute handler
-            event.preventDefault();
-            event.stopPropagation();
-            shortcut.handler();
-            break;
-        }
-    }, [enabled, shortcuts]);
-    useEffect(() => {
-        if (!enabled)
-            return;
-        document.addEventListener('keydown', handleKeyDown);
-        return () => {
-            document.removeEventListener('keydown', handleKeyDown);
-        };
-    }, [enabled, handleKeyDown]);
-}
-/**
- * Default chat shortcuts
- */
-export function useChatKeyboardShortcuts({ onToggle, onNewChat, onClear, onFocusInput, enabled = true, }) {
-    const shortcuts = [];
-    // Toggle chat: Ctrl/Cmd + K
-    if (onToggle) {
-        shortcuts.push({
-            key: 'k',
-            ctrlOrCmd: true,
-            handler: onToggle,
-            description: 'Toggle chat sidebar',
-        });
-    }
-    // New chat: Ctrl/Cmd + Shift + N
-    if (onNewChat) {
-        shortcuts.push({
-            key: 'n',
-            ctrlOrCmd: true,
-            shift: true,
-            handler: onNewChat,
-            description: 'Start new chat',
-        });
-    }
-    // Clear: Ctrl/Cmd + Shift + Delete
-    if (onClear) {
-        shortcuts.push({
-            key: 'Backspace',
-            ctrlOrCmd: true,
-            shift: true,
-            handler: onClear,
-            description: 'Clear chat messages',
-        });
-    }
-    // Focus input: /
-    if (onFocusInput) {
-        shortcuts.push({
-            key: '/',
-            handler: onFocusInput,
-            description: 'Focus chat input',
-        });
-    }
-    // Close on Escape
-    if (onToggle) {
-        shortcuts.push({
-            key: 'Escape',
-            handler: onToggle,
-            description: 'Close chat sidebar',
-            allowInInput: true,
-        });
-    }
-    useKeyboardShortcuts({ enabled, shortcuts });
-}
-/**
- * Get shortcut display string
- */
-export function getShortcutDisplay(shortcut) {
-    const parts = [];
-    const isMac = isMacOS();
-    if (shortcut.ctrlOrCmd) {
-        parts.push(isMac ? '⌘' : 'Ctrl');
-    }
-    if (shortcut.shift) {
-        parts.push(isMac ? '⇧' : 'Shift');
-    }
-    if (shortcut.alt) {
-        parts.push(isMac ? '⌥' : 'Alt');
-    }
-    // Format key name
-    let keyDisplay = shortcut.key.toUpperCase();
-    if (shortcut.key === 'Escape')
-        keyDisplay = 'Esc';
-    if (shortcut.key === 'Backspace')
-        keyDisplay = isMac ? '⌫' : 'Del';
-    parts.push(keyDisplay);
-    return parts.join(isMac ? '' : '+');
-}
-export default useKeyboardShortcuts;

package/lib/hooks/useMobile.d.ts

@@ -1 +0,0 @@
-export declare function useIsMobile(): boolean;

package/lib/hooks/useMobile.js

@@ -1,19 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import * as React from 'react';
-const MOBILE_BREAKPOINT = 768;
-export function useIsMobile() {
-    const [isMobile, setIsMobile] = React.useState(undefined);
-    React.useEffect(() => {
-        const mql = window.matchMedia(`(max-width: ${MOBILE_BREAKPOINT - 1}px)`);
-        const onChange = () => {
-            setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
-        };
-        mql.addEventListener('change', onChange);
-        setIsMobile(window.innerWidth < MOBILE_BREAKPOINT);
-        return () => mql.removeEventListener('change', onChange);
-    }, []);
-    return !!isMobile;
-}

package/lib/hooks/useNotebookAIAgent.d.ts

@@ -1,8 +0,0 @@
-import type { Agent } from '../state';
-/**
- * Get the document AI Agent if any.
- *
- * It handles checking the AI Agent is alive so it should only be use once per document.
- */
-export declare function useNotebookAIAgent(notebookId: string): Agent | undefined;
-export default useNotebookAIAgent;

package/lib/hooks/useNotebookAIAgent.js

@@ -1,73 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { useEffect } from 'react';
-import { useAgentStore } from '../state';
-import { useAIAgents } from './useAgents';
-/**
- * Get the document AI Agent if any.
- *
- * It handles checking the AI Agent is alive so it should only be use once per document.
- */
-export function useNotebookAIAgent(notebookId) {
-    const { getAIAgent } = useAIAgents();
-    const agents = useAgentStore(state => state.agents);
-    const upsertAgent = useAgentStore(state => state.upsertAgent);
-    const deleteAgent = useAgentStore(state => state.deleteAgent);
-    const getAgentById = useAgentStore(state => state.getAgentById);
-    // Check AI Agent is alive.
-    useEffect(() => {
-        let abortController;
-        const refreshAIAgent = async () => {
-            abortController = new AbortController();
-            try {
-                const response = await getAIAgent(notebookId, {
-                    signal: abortController.signal,
-                });
-                if (!response.success) {
-                    deleteAgent(notebookId);
-                    return;
-                }
-                const currentAgent = getAgentById(notebookId);
-                const runtimeId = response.agent.runtime?.id;
-                if (currentAgent) {
-                    // Update existing agent if runtime changed
-                    if (currentAgent.runtimeId !== runtimeId) {
-                        upsertAgent({
-                            id: notebookId,
-                            baseUrl: currentAgent.baseUrl,
-                            transport: currentAgent.transport,
-                            runtimeId,
-                            status: 'running',
-                        });
-                    }
-                }
-                else {
-                    // Add new agent - assume it's a notebook agent with document tracking
-                    upsertAgent({
-                        id: notebookId,
-                        name: `Notebook ${notebookId}`,
-                        description: 'AI agent for notebook',
-                        baseUrl: '', // Will be set by the actual agent implementation
-                        transport: 'vercel-ai', // Default transport for notebook agents
-                        documentId: notebookId,
-                        runtimeId,
-                        status: 'running',
-                    });
-                }
-            }
-            catch (r) {
-                deleteAgent(notebookId);
-            }
-        };
-        const refreshInterval = setInterval(refreshAIAgent, 60_000);
-        return () => {
-            abortController?.abort('Component unmounted');
-            clearInterval(refreshInterval);
-        };
-    }, [agents, notebookId, getAIAgent, deleteAgent, getAgentById, upsertAgent]);
-    const aiAgent = getAgentById(notebookId);
-    return aiAgent;
-}
-export default useNotebookAIAgent;

package/lib/renderers/a2ui/components/A2UIRenderer.d.ts

@@ -1,7 +0,0 @@
-import { type ReactNode } from 'react';
-export interface A2UIRendererProps {
-    surfaceId: string;
-    className?: string;
-    fallback?: ReactNode;
-}
-export declare function A2UIRenderer({ surfaceId, className, fallback, }: A2UIRendererProps): import("react/jsx-runtime").JSX.Element;

package/lib/renderers/a2ui/components/A2UIRenderer.js

@@ -1,102 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-/*
- Copyright 2025 Google LLC
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
-      https://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- */
-import { useMemo } from 'react';
-import { useA2UI } from '../hooks/useA2UI.js';
-import { cn } from '../lib/utils.js';
-import { Text, Image, Icon, Video, AudioPlayer, Divider, } from './content/index.js';
-import { Row, Column, List, Card, Tabs, Modal } from './layout/index.js';
-import { Button, CheckBox, TextField, DateTimeInput, MultipleChoice, Slider, } from './interactive/index.js';
-export function A2UIRenderer({ surfaceId, className, fallback = null, }) {
-    const { getSurface } = useA2UI();
-    const surface = getSurface(surfaceId);
-    const componentTree = surface?.componentTree;
-    if (!componentTree) {
-        return _jsx(_Fragment, { children: fallback });
-    }
-    return (_jsx("div", { className: cn('a2ui-surface', className), children: _jsx(ComponentRenderer, { node: componentTree, surfaceId: surfaceId }) }));
-}
-function ComponentRenderer({ node, surfaceId }) {
-    const renderChild = useMemo(() => (childNode) => (_jsx(ComponentRenderer, { node: childNode, surfaceId: surfaceId }, childNode.id)), [surfaceId]);
-    const children = useMemo(() => {
-        const props = node.properties;
-        if (props.children && Array.isArray(props.children)) {
-            return props.children.map(child => child ? (_jsx(ComponentWrapper, { node: child, children: _jsx(ComponentRenderer, { node: child, surfaceId: surfaceId }) }, child.id)) : null);
-        }
-        if (props.child) {
-            return (_jsx(ComponentWrapper, { node: props.child, children: _jsx(ComponentRenderer, { node: props.child, surfaceId: surfaceId }) }, props.child.id));
-        }
-        return null;
-    }, [node.properties, surfaceId]);
-    switch (node.type) {
-        case 'Text':
-            return (_jsx(Text, { node: node, surfaceId: surfaceId }));
-        case 'Image':
-            return (_jsx(Image, { node: node, surfaceId: surfaceId }));
-        case 'Icon':
-            return (_jsx(Icon, { node: node, surfaceId: surfaceId }));
-        case 'Video':
-            return (_jsx(Video, { node: node, surfaceId: surfaceId }));
-        case 'AudioPlayer':
-            return (_jsx(AudioPlayer, { node: node, surfaceId: surfaceId }));
-        case 'Divider':
-            return (_jsx(Divider, { node: node, surfaceId: surfaceId }));
-        case 'Row':
-            return (_jsx(Row, { node: node, surfaceId: surfaceId, children: children }));
-        case 'Column':
-            return (_jsx(Column, { node: node, surfaceId: surfaceId, children: children }));
-        case 'List':
-            return (_jsx(List, { node: node, surfaceId: surfaceId, children: children }));
-        case 'Card':
-            return (_jsx(Card, { node: node, surfaceId: surfaceId, children: children }));
-        case 'Tabs':
-            return (_jsx(Tabs, { node: node, surfaceId: surfaceId, renderChild: renderChild }));
-        case 'Modal':
-            return (_jsx(Modal, { node: node, surfaceId: surfaceId, renderChild: renderChild }));
-        case 'Button':
-            return (_jsx(Button, { node: node, surfaceId: surfaceId, children: children }));
-        case 'CheckBox':
-            return (_jsx(CheckBox, { node: node, surfaceId: surfaceId }));
-        case 'TextField':
-            return (_jsx(TextField, { node: node, surfaceId: surfaceId }));
-        case 'DateTimeInput':
-            return (_jsx(DateTimeInput, { node: node, surfaceId: surfaceId }));
-        case 'MultipleChoice':
-            return (_jsx(MultipleChoice, { node: node, surfaceId: surfaceId }));
-        case 'Slider':
-            return (_jsx(Slider, { node: node, surfaceId: surfaceId }));
-        default:
-            console.warn(`Unknown component type: ${node.type}`);
-            return null;
-    }
-}
-function ComponentWrapper({ node, children, }) {
-    const style = useMemo(() => {
-        const weight = node.weight;
-        if (typeof weight !== 'number') {
-            return undefined;
-        }
-        return { flex: weight };
-    }, [node.weight]);
-    if (!style) {
-        return _jsx(_Fragment, { children: children });
-    }
-    return _jsx("div", { style: style, children: children });
-}

package/lib/renderers/a2ui/components/SurfaceRenderer.d.ts

@@ -1,7 +0,0 @@
-import { Types } from '@a2ui/lit/0.8';
-export interface SurfaceRendererProps {
-    surfaceId: string;
-    surface: Types.Surface;
-    className?: string;
-}
-export declare function SurfaceRenderer({ surfaceId, surface, className, }: SurfaceRendererProps): import("react/jsx-runtime").JSX.Element | null;