@datalayer/core 1.0.23 → 1.0.25

package/README.md

@@ -2,7 +2,7 @@
 
 [![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor&message=%E2%9D%A4&logo=GitHub&style=flat&color=1ABC9C)](https://github.com/sponsors/datalayer)
 
-# ☰ Datalayer Core
+# ☰ 🌀 Datalayer Core
 
 <p align="center">
   <strong>Python and Typescript libraries for Datalayer</strong>
@@ -12,7 +12,7 @@
   <a href="https://pypi.org/project/datalayer-core/"><img src="https://img.shields.io/pypi/v/datalayer-core.svg" alt="PyPI version"></img></a>
   <a href="https://pypi.org/project/datalayer-core/"><img src="https://img.shields.io/pypi/pyversions/datalayer-core.svg" alt="Python versions"></img></a>
   <a href="https://github.com/datalayer/core/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-BSD%203--Clause-blue.svg" alt="License"></img></a>
-  <a href="https://docs.datalayer.app/"><img src="https://img.shields.io/badge/docs-datalayer.app-blue" alt="Documentation"></img></a>
+  <a href="https://datalayer.ai/docs/"><img src="https://img.shields.io/badge/docs-datalayer.app-blue" alt="Documentation"></img></a>
   <a href="https://github.com/datalayer/core/actions/workflows/py-tests.yml"><img src="https://github.com/datalayer/core/actions/workflows/py-tests.yml/badge.svg" alt="Units Tests"></img></a><a href="https://github.com/datalayer/core/actions/workflows/ts-tests.yml"><img src="https://github.com/datalayer/core/actions/workflows/ts-tests.yml/badge.svg" alt="Units Tests"></img></a>
 </p>
 
@@ -118,7 +118,7 @@ datalayer runtime list
 datalayer runtime create ai-env --given-name my-runtime-123
 
 # Execute a script in a runtime
-datalayer runtime exec my-script.py --runtime <runtime-id>
+datalayer runtime exec my-script.py --agent <agent-id>
 
 # Create a snapshot from a runtime but do not terminate the runtime
 datalayer snapshots create <pod-name> my-snapshot 'AI work!' False
@@ -151,6 +151,29 @@ datalayer usage team-allocate-member --team-uid <team_uid> --member-uid <member_
 datalayer usage team-revoke-member --team-uid <team_uid> --member-uid <member_uid> --amount 5
 ```
 
+### 5. Evals CLI (Multi-Agentspec)
+
+Use comma-separated agentspec ids to create one experiment per agentspec variant:
+
+```bash
+# Creates one experiment per agentspec in the list
+datalayer evals experiments create my-exp \
+  --evalset-id <evalset_id> \
+  --agent-spec-ids example-evals,example-evals-nocodemode,example-custom
+```
+
+Generate a comparison report:
+
+```bash
+datalayer evals report <evalset_id> --run-limit 50 --export
+```
+
+How to interpret grouped comparisons in the report:
+
+- `Within-Agentspec Pairwise Latest-Pass Deltas`: compares experiments using the same agentspec id.
+- `Cross-Agentspec Pairwise Latest-Pass Deltas`: compares experiments using different agentspec ids.
+- Pairwise sections compute all combinations for the selected experiments, not just two agentspecs.
+
 ## Examples
 
 ### Python Examples
@@ -217,10 +240,10 @@ Key platform features accessible through this Client and CLI:
 
 ## Documentation
 
-- **Command Line Interface (CLI)**: [https://docs.datalayer.app/cli/](https://docs.datalayer.app/cli/)
+- **Command Line Interface (CLI)**: [https://datalayer.ai/docs/cli/](https://datalayer.ai/docs/cli/)
 - **Core Python Client**: [core.datalayer.tech/python/](https://core.datalayer.tech/python/)
-- **Platform Documentation**: [docs.datalayer.app](https://docs.datalayer.app/)
-- **API Reference**: [API documentation](https://docs.datalayer.app/api/)
+- **Platform Documentation**: [docs.datalayer.app](https://datalayer.ai/docs/)
+- **API Reference**: [API documentation](https://datalayer.ai/docs/api/)
 
 ## Development
 
@@ -317,7 +340,7 @@ This project is licensed under the [BSD 3-Clause License](https://github.com/dat
 
 ## Support
 
-- **Documentation**: [Datalayer Platform Documentation](https://docs.datalayer.app/)
+- **Documentation**: [Datalayer Platform Documentation](https://datalayer.ai/docs/)
 - **Issues**: [GitHub Issues](https://github.com/datalayer/core/issues)
 - **Community**: [Datalayer Platform](https://datalayer.app/)
 

package/lib/api/constants.d.ts

@@ -6,6 +6,7 @@ export declare const API_BASE_PATHS: {
     readonly IAM: "/api/iam/v1";
     readonly OTEL: "/api/otel/v1";
     readonly RUNTIMES: "/api/runtimes/v1";
+    readonly SCHEDULER: "/api/scheduler/v1";
     readonly SPACER: "/api/spacer/v1";
 };
 /**
@@ -20,6 +21,8 @@ export declare const DEFAULT_SERVICE_URLS: {
     readonly OTEL: "https://prod1.datalayer.run";
     /** Default URL for Runtimes service */
     readonly RUNTIMES: "https://r1.datalayer.run";
+    /** Default URL for Scheduler (cron schedules and runs) service */
+    readonly SCHEDULER: "https://prod1.datalayer.run";
     /** Default URL for Spacer (workspaces and collaboration) service */
     readonly SPACER: "https://prod1.datalayer.run";
 };

package/lib/api/constants.js

@@ -10,6 +10,7 @@ export const API_BASE_PATHS = {
     IAM: '/api/iam/v1',
     OTEL: '/api/otel/v1',
     RUNTIMES: '/api/runtimes/v1',
+    SCHEDULER: '/api/scheduler/v1',
     SPACER: '/api/spacer/v1',
 };
 /**
@@ -24,6 +25,8 @@ export const DEFAULT_SERVICE_URLS = {
     OTEL: 'https://prod1.datalayer.run',
     /** Default URL for Runtimes service */
     RUNTIMES: 'https://r1.datalayer.run',
+    /** Default URL for Scheduler (cron schedules and runs) service */
+    SCHEDULER: 'https://prod1.datalayer.run',
     /** Default URL for Spacer (workspaces and collaboration) service */
     SPACER: 'https://prod1.datalayer.run',
 };

package/lib/api/index.d.ts

@@ -11,6 +11,7 @@ export type { IRequestDatalayerAPIOptions } from './DatalayerApi';
 export * as iam from './iam';
 export * as otel from './otel';
 export * as runtimes from './runtimes';
+export * as scheduler from './scheduler';
 export * as spacer from './spacer';
 /**
  * @deprecated Please import directly from '@datalayer/core/stateful' instead.

package/lib/api/index.js

@@ -16,6 +16,7 @@ export { requestDatalayerAPI, RunResponseError, NetworkError, } from './Datalaye
 export * as iam from './iam/index.js';
 export * as otel from './otel/index.js';
 export * as runtimes from './runtimes/index.js';
+export * as scheduler from './scheduler/index.js';
 export * as spacer from './spacer/index.js';
 /**
  * @deprecated Please import directly from '@datalayer/core/stateful' instead.

package/lib/api/runtimes/checkpoints.d.ts

@@ -10,9 +10,9 @@ export interface RuntimeCheckpointData {
     description: string;
     /** Runtime that was checkpointed */
     runtime_uid: string;
-    /** Agent spec identifier (e.g. "mocks/monitor-sales-kpis") */
+    /** Agentspec identifier (e.g. "mocks/monitor-sales-kpis") */
     agent_spec_id: string;
-    /** Full agent spec payload */
+    /** Full agentspec payload */
     agentspec: Record<string, any>;
     /** Additional metadata */
     metadata: Record<string, any>;
@@ -37,9 +37,9 @@ export interface CreateRuntimeCheckpointRequest {
     name?: string;
     /** Checkpoint description */
     description?: string;
-    /** Agent spec identifier */
+    /** Agentspec identifier */
     agentspec_id?: string;
-    /** Full agent spec payload to persist */
+    /** Full agentspec payload to persist */
     agentspec?: Record<string, any>;
     /** Additional metadata */
     metadata?: Record<string, any>;

package/lib/api/runtimes/runtimes.d.ts

@@ -73,9 +73,9 @@ export interface PauseRuntimeBody {
     name?: string;
     /** Checkpoint description */
     description?: string;
-    /** Agent spec identifier */
+    /** Agentspec identifier */
     agent_spec_id?: string;
-    /** Full agent spec payload to persist with the checkpoint */
+    /** Full agentspec payload to persist with the checkpoint */
     agentspec?: Record<string, any>;
     /** Additional metadata */
     metadata?: Record<string, any>;
@@ -107,7 +107,7 @@ export interface ResumeRuntimeBody {
     checkpoint_mode?: 'criu' | 'light';
     /** Explicit checkpoint identifier */
     checkpoint_id?: string;
-    /** Agent spec identifier (required by the operator for restore) */
+    /** Agentspec identifier (required by the operator for restore) */
     agent_spec_id?: string;
     /** Specific checkpoint timestamp to restore from */
     checkpoint_timestamp?: string;

package/lib/api/scheduler/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Scheduler API module for the Datalayer platform.
+ *
+ * @module api/scheduler
+ */
+export * from './schedules';

package/lib/api/scheduler/index.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Scheduler API module for the Datalayer platform.
+ *
+ * @module api/scheduler
+ */
+export * from './schedules.js';

package/lib/api/scheduler/schedules.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Raw schedule document as returned by the scheduler service.
+ *
+ * Fields follow the Solr suffix convention (`_s`, `_b`, `_dt`, `_i`).
+ */
+export interface ScheduleDoc {
+    uid?: string;
+    type_s?: string;
+    notebook_uid_s?: string;
+    owner_uid_s?: string;
+    cron_expression_s?: string;
+    preset_s?: string;
+    enabled_b?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Request payload to create or update a notebook schedule.
+ */
+export interface UpsertScheduleRequest {
+    /** Target notebook uid. */
+    notebookUid: string;
+    /** Cron expression (e.g. `* * * * *`). */
+    cronExpression: string;
+    /** Optional preset identifier (e.g. `every-minute`, `hourly`, `daily`, `custom`). */
+    preset?: string;
+    /** Whether the schedule is enabled. Defaults to `true`. */
+    enabled?: boolean;
+}
+/**
+ * Request payload to update an existing schedule by uid.
+ */
+export interface UpdateScheduleRequest {
+    cronExpression?: string;
+    preset?: string;
+    enabled?: boolean;
+}
+/**
+ * Response shape for listing schedules.
+ */
+export interface ListSchedulesResponse {
+    success: boolean;
+    message: string;
+    schedules: ScheduleDoc[];
+}
+/**
+ * Response shape for a single schedule mutation.
+ */
+export interface ScheduleResponse {
+    success: boolean;
+    message: string;
+    schedule: ScheduleDoc;
+}
+/**
+ * List the schedules owned by the authenticated user.
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @param includeDisabled - Include disabled schedules in the result
+ * @returns Promise resolving to the list of schedules
+ */
+export declare const listSchedules: (token: string, baseUrl?: string, includeDisabled?: boolean) => Promise<ListSchedulesResponse>;
+/**
+ * Create or update the schedule for a notebook.
+ * @param token - Authentication token
+ * @param data - Schedule configuration
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the upserted schedule
+ */
+export declare const upsertSchedule: (token: string, data: UpsertScheduleRequest, baseUrl?: string) => Promise<ScheduleResponse>;
+/**
+ * Update an existing schedule by uid.
+ * @param token - Authentication token
+ * @param scheduleUid - The schedule uid
+ * @param data - Fields to update
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the updated schedule
+ */
+export declare const updateSchedule: (token: string, scheduleUid: string, data: UpdateScheduleRequest, baseUrl?: string) => Promise<ScheduleResponse>;
+/**
+ * Disable a schedule by uid.
+ * @param token - Authentication token
+ * @param scheduleUid - The schedule uid
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the disabled schedule
+ */
+export declare const disableSchedule: (token: string, scheduleUid: string, baseUrl?: string) => Promise<ScheduleResponse>;

package/lib/api/scheduler/schedules.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Scheduler schedules API functions for the Datalayer platform.
+ *
+ * Provides functions for listing, creating, and updating cron schedules that
+ * trigger automated notebook executions.
+ *
+ * @module api/scheduler/schedules
+ */
+import { requestDatalayerAPI } from '../DatalayerApi.js';
+import { API_BASE_PATHS, DEFAULT_SERVICE_URLS } from '../constants.js';
+/**
+ * List the schedules owned by the authenticated user.
+ * @param token - Authentication token
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @param includeDisabled - Include disabled schedules in the result
+ * @returns Promise resolving to the list of schedules
+ */
+export const listSchedules = async (token, baseUrl = DEFAULT_SERVICE_URLS.SCHEDULER, includeDisabled = false) => {
+    const query = includeDisabled ? '?includeDisabled=true' : '';
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SCHEDULER}/schedules${query}`,
+        method: 'GET',
+        token,
+    });
+};
+/**
+ * Create or update the schedule for a notebook.
+ * @param token - Authentication token
+ * @param data - Schedule configuration
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the upserted schedule
+ */
+export const upsertSchedule = async (token, data, baseUrl = DEFAULT_SERVICE_URLS.SCHEDULER) => {
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SCHEDULER}/schedules`,
+        method: 'POST',
+        token,
+        body: {
+            enabled: true,
+            preset: 'custom',
+            ...data,
+        },
+    });
+};
+/**
+ * Update an existing schedule by uid.
+ * @param token - Authentication token
+ * @param scheduleUid - The schedule uid
+ * @param data - Fields to update
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the updated schedule
+ */
+export const updateSchedule = async (token, scheduleUid, data, baseUrl = DEFAULT_SERVICE_URLS.SCHEDULER) => {
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SCHEDULER}/schedules/${scheduleUid}`,
+        method: 'PUT',
+        token,
+        body: data,
+    });
+};
+/**
+ * Disable a schedule by uid.
+ * @param token - Authentication token
+ * @param scheduleUid - The schedule uid
+ * @param baseUrl - Base URL for the scheduler service (defaults to production)
+ * @returns Promise resolving to the disabled schedule
+ */
+export const disableSchedule = async (token, scheduleUid, baseUrl = DEFAULT_SERVICE_URLS.SCHEDULER) => {
+    return requestDatalayerAPI({
+        url: `${baseUrl}${API_BASE_PATHS.SCHEDULER}/schedules/${scheduleUid}/disable`,
+        method: 'POST',
+        token,
+    });
+};

package/lib/components/checkout/StripeCheckout.js

@@ -670,6 +670,37 @@ export function StripeCheckout({ checkoutPortal, appearance, accountUid, showSta
         }
         void startSubscriptionCheckout(pendingSubscriptionPlan);
     }, [pendingSubscriptionPlan, startSubscriptionCheckout]);
+    // Auto-open the subscription checkout when the page is opened with
+    // `?upgrade` or `?action=upgrade` (e.g. from the Plan Overview
+    // "Upgrade to Team Plan" CTA).
+    useEffect(() => {
+        if (typeof window === 'undefined') {
+            return;
+        }
+        if (autoActionTriggeredRef.current) {
+            return;
+        }
+        if (isPaidSubscription || isCancellationScheduled) {
+            return;
+        }
+        try {
+            const params = new URLSearchParams(window.location.search);
+            const action = String(params.get('action') || '').toLowerCase();
+            const shouldAutoUpgrade = params.has('upgrade') || action === 'upgrade';
+            if (shouldAutoUpgrade && pendingSubscriptionPlan) {
+                autoActionTriggeredRef.current = true;
+                startPendingSubscriptionCheckout();
+            }
+        }
+        catch (_error) {
+            // Ignore malformed URLs.
+        }
+    }, [
+        isPaidSubscription,
+        isCancellationScheduled,
+        pendingSubscriptionPlan,
+        startPendingSubscriptionCheckout,
+    ]);
     const openPortal = useCallback((url) => {
         if (!url) {
             return;
@@ -825,7 +856,22 @@ export function StripeCheckout({ checkoutPortal, appearance, accountUid, showSta
                                     checkout ||
                                     !pendingSubscriptionPlan, children: subscriptionPaymentIntentMutation.isPending
                                     ? 'Preparing checkout...'
-                                    : 'Continue pending payment' }), _jsx(Button, { variant: "danger", onClick: onCancelSubscription, children: "Cancel pending plan change" })] })] })) : !isPaidSubscription ? (_jsxs(_Fragment, { children: [_jsxs(Box, { role: "radiogroup", sx: {
+                                    : 'Continue pending payment' }), _jsx(Button, { variant: "danger", onClick: onCancelSubscription, children: "Cancel pending plan change" })] }), cancelViewOpen && (_jsxs(Box, { sx: {
+                            marginTop: 'var(--stack-gap-normal)',
+                            border: '1px solid',
+                            borderColor: 'border.default',
+                            borderRadius: 'var(--borderRadius-medium)',
+                            backgroundColor: 'canvas.subtle',
+                            padding: 'var(--stack-padding-normal)',
+                            display: 'grid',
+                            gap: 'var(--stack-gap-condensed)',
+                        }, children: [_jsx(Text, { as: "h4", sx: { fontWeight: 'bold' }, children: "Cancel pending plan change" }), _jsx(Text, { as: "p", sx: { color: 'fg.muted' }, children: "This pending plan change will be canceled immediately." }), _jsxs(Box, { sx: {
+                                    display: 'flex',
+                                    gap: 'var(--stack-gap-condensed)',
+                                    flexWrap: 'wrap',
+                                }, children: [_jsx(Button, { variant: "danger", onClick: () => void onConfirmCancelSubscription(), disabled: isCancelActionPending, leadingVisual: () => isCancelActionPending ? _jsx(Spinner, { size: "small" }) : undefined, children: isCancelActionPending
+                                            ? 'Canceling pending plan change...'
+                                            : 'Confirm cancel pending plan change' }), _jsx(Button, { variant: "default", onClick: onAbortCancelView, disabled: isCancelActionPending, children: "Keep pending plan change" })] })] }))] })) : !isPaidSubscription ? (_jsxs(_Fragment, { children: [_jsxs(Box, { role: "radiogroup", sx: {
                             display: 'grid',
                             gap: 'var(--stack-gap-condensed)',
                             maxHeight: '260px',
@@ -847,7 +893,7 @@ export function StripeCheckout({ checkoutPortal, appearance, accountUid, showSta
                             subscriptionPaymentIntentMutation.isPending ||
                             checkout, children: subscriptionPaymentIntentMutation.isPending
                             ? 'Preparing Team plan checkout...'
-                            : 'Update to Team Plan' })] })) : null] })) : null;
+                            : 'Upgrade to Team Plan' })] })) : null] })) : null;
     const topUpSection = (_jsxs(Box, { children: [_jsx(Text, { as: "h3", sx: sectionTitleSx, children: "Topup your wallet with credits" }), _jsx(Box, { role: "radiogroup", sx: {
                     display: 'grid',
                     gap: 'var(--stack-gap-normal)',

package/lib/components/display/LiveRelativeTime.d.ts

@@ -1,10 +1 @@
-type ILiveRelativeTimeProps = {
-    value?: Date | string | number;
-    refreshIntervalMs?: number;
-    fallback?: string;
-};
-/**
- * Display a live-updating relative time label (e.g. "5m ago").
- */
-export declare function LiveRelativeTime({ value, refreshIntervalMs, fallback, }: ILiveRelativeTimeProps): JSX.Element;
-export {};
+export { LiveRelativeTime } from '../time/LiveRelativeTime';

package/lib/components/display/LiveRelativeTime.js

@@ -1,21 +1,6 @@
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 /*
- * Copyright (c) 2023-2025 Datalayer, Inc.
+ * Copyright (c) 2023-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import { useEffect, useMemo, useState } from 'react';
-import { formatRelativeTime } from '../../utils/index.js';
-/**
- * Display a live-updating relative time label (e.g. "5m ago").
- */
-export function LiveRelativeTime({ value, refreshIntervalMs = 1000, fallback = '—', }) {
-    const [now, setNow] = useState(() => new Date());
-    useEffect(() => {
-        const timer = window.setInterval(() => {
-            setNow(new Date());
-        }, refreshIntervalMs);
-        return () => window.clearInterval(timer);
-    }, [refreshIntervalMs]);
-    const label = useMemo(() => formatRelativeTime(value, now), [value, now]);
-    return _jsx(_Fragment, { children: label ?? fallback });
-}
+// Backward compatibility export. Use ../../components/time/LiveRelativeTime.
+export { LiveRelativeTime } from '../time/LiveRelativeTime.js';

package/lib/components/index.d.ts

@@ -1,4 +1,7 @@
 export * from './auth';
 export * from './billing';
+export * from './scheduler';
 export * from './sharing';
 export * from './sparklines';
+export * from './time';
+export * from './timeline';

package/lib/components/index.js

@@ -4,5 +4,8 @@
  */
 export * from './auth/index.js';
 export * from './billing/index.js';
+export * from './scheduler/index.js';
 export * from './sharing/index.js';
 export * from './sparklines/index.js';
+export * from './time/index.js';
+export * from './timeline/index.js';

package/lib/components/runtimes/RuntimePickerBase.js

@@ -85,24 +85,26 @@ export function RuntimePickerBase(props) {
                         //                icon={() => <kernelIcon.react className="dla-Cell-runtime-icon" tag={'span'} />}
                         icon: () => (_jsx("span", { className: "dla-Cell-runtime-icon", children: _jsx(CpuIcon, {}) })), "aria-label": trans.__('Assign a Runtime to the Cell.'), title: trans.__('Assign a Runtime to the Cell.'), size: "small", variant: "invisible" }) })) : (_jsxs(ActionMenu.Button, { variant: "default", disabled: disabled || groupedRuntimeDescs === null, children: [_jsx(Text, { fontWeight: 'bold', children: trans.__('Runtime:') }), ' ' + (runtimeDesc?.displayName ?? trans.__('No Runtime'))] })), _jsx(ActionMenu.Overlay, { ...overlayProps, width: "medium", sx: { overflowY: 'auto' }, side: variant === 'cell' ? 'outside-left' : 'outside-right', children: _jsxs(ActionList, { selectionVariant: "single", children: [variant === 'cell' && (_jsxs(ActionList.Item, { selected: runtimeDesc === undefined, onSelect: () => {
                                     setRuntimeDesc(undefined);
-                                }, children: [preference?.location && (_jsx(ActionList.LeadingVisual, { children: preference.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : preference.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) })), trans.__('Assign the Notebook Runtime')] }, 'null')), !!preActions && preActions, Object.entries(groupedRuntimeDescs ?? {}).map(([group, runtimeDescs]) => (_jsxs(ActionList.Group, { children: [_jsx(ActionList.GroupHeading, { children: group }), runtimeDescs.map(runtimeDesc => {
-                                        const annotation = runtimeDesc.podName
-                                            ? ` - ${runtimeDesc.podName.split('-', 2).reverse()[0]}`
-                                            : runtimeDesc.kernelId
-                                                ? ` - ${runtimeDesc.kernelId}`
+                                }, children: [preference?.location && (_jsx(ActionList.LeadingVisual, { children: preference.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : preference.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) })), trans.__('Assign the Notebook Runtime')] }, 'null')), !!preActions && preActions, Object.entries(groupedRuntimeDescs ?? {}).map(([group, runtimeDescs]) => (_jsxs(ActionList.Group, { children: [_jsx(ActionList.GroupHeading, { children: group }), runtimeDescs.map(candidateRuntimeDesc => {
+                                        const annotation = candidateRuntimeDesc.podName
+                                            ? ` - ${candidateRuntimeDesc.podName.split('-', 2).reverse()[0]}`
+                                            : candidateRuntimeDesc.kernelId
+                                                ? ` - ${candidateRuntimeDesc.kernelId}`
                                                 : '';
-                                        const fullDisplayName = (runtimeDesc.displayName ?? '') + annotation;
-                                        const displayName = (runtimeDesc.displayName?.length ?? 0) >
+                                        const fullDisplayName = (candidateRuntimeDesc.displayName ?? '') + annotation;
+                                        const displayName = (candidateRuntimeDesc.displayName?.length ?? 0) >
                                             RUNTIME_DISPLAY_NAME_MAX_LENGTH
-                                            ? runtimeDesc.displayName.slice(0, RUNTIME_DISPLAY_NAME_MAX_LENGTH) + '…'
-                                            : (runtimeDesc.displayName ?? '');
-                                        return (_jsxs(ActionList.Item, { title: fullDisplayName, selected: (runtimeDesc.location === runtimeDesc?.location ||
-                                                (isRuntimeRemote(runtimeDesc.location) &&
+                                            ? candidateRuntimeDesc.displayName.slice(0, RUNTIME_DISPLAY_NAME_MAX_LENGTH) + '…'
+                                            : (candidateRuntimeDesc.displayName ?? '');
+                                        return (_jsxs(ActionList.Item, { title: fullDisplayName, selected: (candidateRuntimeDesc.location ===
+                                                runtimeDesc?.location ||
+                                                (isRuntimeRemote(candidateRuntimeDesc.location) &&
                                                     isRuntimeRemote(runtimeDesc?.location ?? 'local'))) &&
-                                                (runtimeDesc.kernelId ?? runtimeDesc.name) ===
+                                                (candidateRuntimeDesc.kernelId ??
+                                                    candidateRuntimeDesc.name) ===
                                                     (runtimeDesc?.kernelId ?? runtimeDesc?.name), onSelect: () => {
-                                                setRuntimeDesc(runtimeDesc);
-                                            }, children: [_jsx(ActionList.LeadingVisual, { children: runtimeDesc.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : runtimeDesc.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) }), displayName + annotation.slice(0, 10)] }, runtimeDesc.name));
+                                                setRuntimeDesc(candidateRuntimeDesc);
+                                            }, children: [_jsx(ActionList.LeadingVisual, { children: candidateRuntimeDesc.location === 'local' ? (_jsx(LaptopSimpleIcon, {})) : candidateRuntimeDesc.location === 'browser' ? (_jsx(BrowserIcon, {})) : (_jsx(CloudUploadIcon, {})) }), displayName + annotation.slice(0, 10)] }, candidateRuntimeDesc.name));
                                     })] }, group))), !!postActions && (_jsxs(_Fragment, { children: [_jsx(ActionList.Divider, {}), postActions] }))] }) })] })) : (
         /*
          * Section for Radio display.
@@ -110,9 +112,9 @@ export function RuntimePickerBase(props) {
         _jsxs(_Fragment, { children: [defaultSet && (_jsx(RadioGroup, { name: "kernel-options", "aria-labelledby": "kernel-options", children: Object.entries(groupedRuntimeDescs ?? {}).map(([group, runtimeDescs]) => (_jsxs(Box, { children: [_jsx(Box, { as: "h4", style: { marginTop: 0 }, children: group }), runtimeDescs.map(k => {
                                 return (_jsxs(Box, { title: k.name, children: [_jsxs(FormControl, { children: [_jsx(Radio, { value: k.kernelId, onChange: () => {
                                                         setRuntimeDesc(k);
-                                                    }, checked: (k.location === k?.location ||
+                                                    }, checked: (k.location === runtimeDesc?.location ||
                                                         (isRuntimeRemote(k.location) &&
-                                                            isRuntimeRemote(k?.location ?? 'local'))) &&
+                                                            isRuntimeRemote(runtimeDesc?.location ?? 'local'))) &&
                                                         (k.kernelId ?? k.name) ===
                                                             (runtimeDesc?.kernelId ?? runtimeDesc?.name) }), _jsx(FormControl.Label, { children: _jsxs(Box, { display: "flex", children: [_jsx(Box, { children: k.displayName }), k.kernelId && k.location === 'remote' && (_jsx(Box, { ml: 3, mt: 1, children: _jsx(CreditsIndicator, { kernelId: k.kernelId, serviceManager: multiServiceManager.remote }, "credits-indicator") }))] }) }), _jsx(FormControl.Caption, { children: _jsxs(LabelGroup, { sx: { marginTop: 1 }, children: [_jsx(Label, { variant: "secondary", children: k.name }), _jsx(Label, { variant: "secondary", sx: { marginLeft: 1 }, children: k.location }), k.burningRate && (_jsxs(Label, { variant: "sponsors", sx: { marginLeft: 1 }, children: [k.burningRate, " credits/second"] })), k.gpu && (_jsx(Label, { variant: "success", sx: { marginLeft: 1 }, children: "GPU" }))] }) })] }), _jsx(ActionList.Divider, {})] }, k.kernelId));
                             })] }, group))) })), !!postActions && _jsx(_Fragment, { children: postActions })] })) }));

package/lib/components/runtimes/RuntimePickerCell.js

@@ -99,6 +99,6 @@ export function RuntimePickerCell(props) {
     const datalayerMeta = model.getMetadata('datalayer') ?? {};
     return (_jsxs(_Fragment, { children: [_jsx(RuntimePickerBase, { display: "menu", filterRuntime: filterKernel, preference: preference, multiServiceManager: multiServiceManager, runtimeDesc: datalayerMeta.kernel ? datalayerMeta.kernel : undefined, setRuntimeDesc: setSelectedRuntimeDesc, variant: 'cell', preActions: _jsxs(ActionList.Item, { disabled: !multiServiceManager.remote, onSelect: setCell, selected: hasCellRuntime, title: !multiServiceManager.remote
                         ? 'You are not connected with Datalayer.'
-                        : 'Assign a new temporary Runtime on each Cell execution.', children: [_jsx(ActionList.LeadingVisual, { children: _jsx(CloudUploadIcon, {}) }), trans.__('Assign a Cell Runtime')] }), postActions: token || !logIn ? (_jsxs(_Fragment, { children: [RuntimeSnippetsFacade.supports(preference?.language ?? '') && (_jsx(ActionList.Item, { onSelect: openVariableDialog, disabled: !isForeign, title: trans.__('Define variables to transfer between the document kernel and the cell kernel.'), children: trans.__('Define Cell Variables Transfer') })), !configuration.whiteLabel && (_jsx(ActionList.Item, { onSelect: openSnippetDialog, disabled: snippets.length === 0, title: trans.__('Inject a code snippet at the end of the cell.'), children: trans.__('Inject Code Snippet') }))] })) : (_jsx(ActionList.Item, { onSelect: props.logIn, title: 'Connect to the Runtime provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Connect to the Runtime provider" }) })), translator: translator }), isVariableDialogOpen && (_jsx(RuntimeCellVariablesDialog, { model: model, onClose: closeVariableDialog, preference: preference, sessionContext: sessionContext, translator: translator })), isSnippetDialogOpen && (_jsx(SnippetDialog, { language: language, model: model, snippets: snippets, onClose: closeSnippetDialog, markdownParser: markdownParser, sanitizer: sanitizer })), isKernelDialogOpen && (_jsx(RuntimeLauncherDialog, { manager: multiServiceManager.remote, onSubmit: onStartRemote, startRuntime: true, submitLabel: "Assign", markdownParser: markdownParser, sanitizer: sanitizer }))] }));
+                        : 'Assign a new temporary Runtime on each Cell execution.', children: [_jsx(ActionList.LeadingVisual, { children: _jsx(CloudUploadIcon, {}) }), trans.__('Assign a Cell Runtime')] }), postActions: token || !logIn ? (_jsxs(_Fragment, { children: [RuntimeSnippetsFacade.supports(preference?.language ?? '') && (_jsx(ActionList.Item, { onSelect: openVariableDialog, disabled: !isForeign, title: trans.__('Define variables to transfer between the document kernel and the cell kernel.'), children: trans.__('Define Cell Variables Transfer') })), !configuration.whiteLabel && (_jsx(ActionList.Item, { onSelect: openSnippetDialog, disabled: snippets.length === 0, title: trans.__('Inject a code snippet at the end of the cell.'), children: trans.__('Inject Code Snippet') }))] })) : (_jsx(ActionList.Item, { onSelect: props.logIn, title: 'Connect to the Runtime provider.', children: _jsx(ExternalTokenSilentLogin, { message: "Connect to the Runtime provider" }) })), translator: translator }), isVariableDialogOpen && (_jsx(RuntimeCellVariablesDialog, { model: model, onClose: closeVariableDialog, preference: preference, sessionContext: sessionContext, translator: translator })), isSnippetDialogOpen && (_jsx(SnippetDialog, { language: language, model: model, snippets: snippets, onClose: closeSnippetDialog, markdownParser: markdownParser, sanitizer: sanitizer })), isKernelDialogOpen && (_jsx(RuntimeLauncherDialog, { manager: multiServiceManager.remote, onSubmit: onStartRemote, startRuntime: 'defer', submitLabel: "Assign", markdownParser: markdownParser, sanitizer: sanitizer }))] }));
 }
 export default RuntimePickerCell;

package/lib/components/scheduler/ScheduleMenu.d.ts

@@ -0,0 +1,54 @@
+import { type Icon } from '@primer/octicons-react';
+import { type ScheduleDoc } from '../../api/scheduler/schedules';
+/**
+ * Supported schedule presets.
+ */
+export type SchedulePreset = 'every-minute' | 'hourly' | 'daily' | 'custom';
+/**
+ * Props for the self-contained {@link ScheduleMenu} component.
+ *
+ * The component performs the scheduler service calls internally. Provide the
+ * `notebookUid`, an authentication `token`, and the scheduler service
+ * `baseUrl` (configurable via props) to enable scheduling.
+ */
+export type ScheduleMenuProps = {
+    /** Target notebook uid to schedule (used to create/update a schedule). */
+    notebookUid?: string;
+    /**
+     * Existing schedule uid to update in place. When provided, changes are
+     * persisted with a PUT update instead of a notebook upsert.
+     */
+    scheduleUid?: string;
+    /** Authentication token used for scheduler API calls. */
+    token?: string;
+    /** Base URL of the scheduler service. Defaults to the production service. */
+    baseUrl?: string;
+    /** Force-disable the menu. When omitted, the menu is enabled if a token and notebook uid are present. */
+    enabled?: boolean;
+    /** Icon shown on the anchor button (replaced by a spinner while saving). */
+    icon?: Icon;
+    /** Optional color for the anchor icon. */
+    iconColor?: string;
+    /** Accessible label for the anchor button. */
+    ariaLabel?: string;
+    /** Initial preset selection. */
+    initialPreset?: SchedulePreset;
+    /** Initial cron expression. */
+    initialCronExpression?: string;
+    /** Called after a schedule is successfully saved. */
+    onSaved?: (schedule: ScheduleDoc) => void;
+    /** Called after a schedule is successfully deleted/disabled. */
+    onDeleted?: (schedule: ScheduleDoc) => void;
+    /** Called when saving a schedule fails. */
+    onError?: (error: unknown) => void;
+};
+/**
+ * Self-contained schedule menu that lets a user pick a cron schedule for a
+ * notebook and persists it to the scheduler service.
+ *
+ * The component owns its loading state and renders a spinner in place of the
+ * anchor icon while a save request is in flight. The scheduler service URL is
+ * configurable through the `baseUrl` prop.
+ */
+export declare const ScheduleMenu: ({ notebookUid, scheduleUid, token, baseUrl, enabled, icon, iconColor, ariaLabel, initialPreset, initialCronExpression, onSaved, onDeleted, onError, }: ScheduleMenuProps) => import("react/jsx-runtime").JSX.Element;
+export default ScheduleMenu;