@datalayer/core 1.0.24 → 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>
@@ -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

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/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;