@datalayer/agent-runtimes 1.3.10 → 1.3.11

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

@@ -1,5 +1,5 @@
 import type { EnvironmentData, ListEnvironmentsResponse } from '../../models/EnvironmentDTO';
-import type { ICreateEnvironmentBuildsRequest, ICreateEnvironmentRequest, ICreateEnvironmentVersionRequest, IDatalayerEnvironment, IEnvironmentArtifactsPage, IEnvironmentBuildLogChunk, IEnvironmentBuildLogPage, IEnvironmentBuildRecord, IEnvironmentBuildsCreated, IEnvironmentBuildsPage, IEnvironmentFork, IEnvironmentPublicationRecord, IEnvironmentRecord, IEnvironmentsError, IEnvironmentsPageQuery, IEnvironmentTrial, IEnvironmentValidationReport, IEnvironmentVersionRecord, IEnvironmentVersionsPage, IForkEnvironmentVersionRequest, IListEnvironmentsQuery, IPromoteEnvironmentVersionRequest, ITrialEnvironmentVersionRequest, IUpdateEnvironmentRequest, IUpdateEnvironmentVersionRequest, IValidateEnvironmentVersionRequest } from '../../models/Environment';
+import type { ICreateEnvironmentBuildsRequest, ICreateEnvironmentRequest, ICreateEnvironmentVersionRequest, IDatalayerEnvironment, IEnvironmentArtifactsPage, IEnvironmentBuildLogChunk, IEnvironmentBuildLogPage, IEnvironmentBuildRecord, IEnvironmentBuildsCreated, IEnvironmentBuildsPage, IEnvironmentFork, IEnvironmentPublicationRecord, IEnvironmentQuotas, IEnvironmentRecord, IEnvironmentVersionSandboxes, IEnvironmentsError, IEnvironmentsPageQuery, IEnvironmentTrial, IEnvironmentValidationReport, IEnvironmentVersionRecord, IEnvironmentVersionsPage, IForkEnvironmentVersionRequest, IListEnvironmentsQuery, IPromoteEnvironmentVersionRequest, ITrialEnvironmentVersionRequest, IUpdateEnvironmentRequest, IUpdateEnvironmentVersionRequest, IValidateEnvironmentVersionRequest } from '../../models/Environment';
 /** What every environments call may carry. */
 export interface IEnvironmentsRequestOptions {
     /** Sent as `X-Correlation-Id`; a refusal answers with it. */
@@ -197,6 +197,27 @@ export declare const createEnvironmentBuilds: (token: string, versionUid: string
  * @returns Promise resolving to one page of builds
  */
 export declare const listEnvironmentBuilds: (token: string, versionUid: string, page?: IEnvironmentsPageQuery, options?: IEnvironmentsRequestOptions, baseUrl?: string) => Promise<IEnvironmentBuildsPage>;
+/**
+ * The sandboxes running a version now: yours by uid, anybody else's counted (E2-19).
+ * @param token - Authentication token
+ * @param versionUid - The version's uid
+ * @param options - Correlation id and abort signal
+ * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
+ * @returns Promise resolving to the version's live sandboxes
+ */
+export declare const getEnvironmentVersionSandboxes: (token: string, versionUid: string, options?: IEnvironmentsRequestOptions, baseUrl?: string) => Promise<IEnvironmentVersionSandboxes>;
+/**
+ * An owner's build quotas and what it holds against each (E1-13, E2-19).
+ * @param token - Authentication token
+ * @param owner - The caller's own when empty; an organization's by its uid
+ * @param options - Correlation id and abort signal
+ * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
+ * @returns Promise resolving to the limits and the holdings
+ */
+export declare const getEnvironmentQuotas: (token: string, owner?: {
+    ownerType?: "user" | "organization";
+    ownerUid?: string;
+}, options?: IEnvironmentsRequestOptions, baseUrl?: string) => Promise<IEnvironmentQuotas>;
 /**
  * List a version's artifacts, one per variant and region.
  * @param token - Authentication token

package/lib/api/runtimes/environments.js

@@ -293,6 +293,37 @@ export const listEnvironmentBuilds = async (token, versionUid, page = {}, option
     validateToken(token);
     return send(token, 'GET', registryUrl(baseUrl, `/environment-versions/${segment(versionUid, 'Version UID')}/builds`, { ...page }), options);
 };
+/**
+ * The sandboxes running a version now: yours by uid, anybody else's counted (E2-19).
+ * @param token - Authentication token
+ * @param versionUid - The version's uid
+ * @param options - Correlation id and abort signal
+ * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
+ * @returns Promise resolving to the version's live sandboxes
+ */
+export const getEnvironmentVersionSandboxes = async (token, versionUid, options = {}, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    return send(token, 'GET', registryUrl(baseUrl, `/environment-versions/${segment(versionUid, 'Version UID')}/sandboxes`), options);
+};
+/**
+ * An owner's build quotas and what it holds against each (E1-13, E2-19).
+ * @param token - Authentication token
+ * @param owner - The caller's own when empty; an organization's by its uid
+ * @param options - Correlation id and abort signal
+ * @param baseUrl - Base URL for the API (defaults to production Runtimes URL)
+ * @returns Promise resolving to the limits and the holdings
+ */
+export const getEnvironmentQuotas = async (token, owner = {}, options = {}, baseUrl = DEFAULT_SERVICE_URLS.RUNTIMES) => {
+    validateToken(token);
+    const query = {};
+    if (owner.ownerType) {
+        query.ownerType = owner.ownerType;
+    }
+    if (owner.ownerUid) {
+        query.ownerUid = owner.ownerUid;
+    }
+    return send(token, 'GET', registryUrl(baseUrl, '/environment-quotas', query), options);
+};
 /**
  * List a version's artifacts, one per variant and region.
  * @param token - Authentication token

package/lib/chat/ChatFloating.d.ts

@@ -49,6 +49,13 @@ export interface ChatFloatingProps extends ChatCommonProps {
     buttonTooltip?: string;
     /** Brand color override. Defaults to the theme's `accent.emphasis` token. */
     brandColor?: string;
+    /**
+     * A soft light breathing around the button while the chat is closed, as
+     * if it were alive (see `ButtonGlow`). Still, and dimmer, for a reader who
+     * asks the system for reduced motion.
+     * @default true
+     */
+    buttonGlow?: boolean;
     /** Offset from edge (in pixels) */
     offset?: number;
     /** Animation duration (in ms) */
@@ -92,5 +99,5 @@ export interface ChatFloatingProps extends ChatCommonProps {
  * ChatFloating component
  * A floating chat window built on ChatBase
  */
-export declare function ChatFloating({ endpoint, protocol: protocolProp, useStore: useStoreMode, title, description, position, defaultOpen, width, height, showHeader, showButton, showNewChatButton, showClearButton, showSettingsButton, enableKeyboardShortcuts, toggleShortcut, showPoweredBy, promptVariant, mentionableAgents, poweredByProps, clickOutsideToClose, escapeToClose, className, onSettingsClick, onNewChat, onOpen, onClose, onStateUpdate, children, brandIcon, buttonIcon, buttonTooltip, brandColor, offset, animationDuration, renderToolResult, frontendTools, initialState: _initialState, suggestions, submitOnSuggestionClick, hideMessagesAfterToolUI, defaultViewMode, onViewModeChange, sidebarMountPoint, showPanelBackdrop, availableModels, showModelSelector, showToolsMenu, showSkillsMenu, showTokenUsage, showContextRing, themeVariant, colorMode, runtimeId, historyEndpoint, authToken, historyAuthToken, pendingPrompt, showInformation, onInformationClick, onToolCallStart, onToolCallComplete, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, panelProps, launching, launchingMessage, }: ChatFloatingProps): React.JSX.Element;
+export declare function ChatFloating({ endpoint, protocol: protocolProp, useStore: useStoreMode, title, description, position, defaultOpen, width, height, showHeader, showButton, showNewChatButton, showClearButton, showSettingsButton, enableKeyboardShortcuts, toggleShortcut, showPoweredBy, promptVariant, mentionableAgents, poweredByProps, clickOutsideToClose, escapeToClose, className, onSettingsClick, onNewChat, onOpen, onClose, onStateUpdate, children, brandIcon, buttonIcon, buttonTooltip, brandColor, buttonGlow, offset, animationDuration, renderToolResult, frontendTools, initialState: _initialState, suggestions, submitOnSuggestionClick, hideMessagesAfterToolUI, defaultViewMode, onViewModeChange, sidebarMountPoint, showPanelBackdrop, availableModels, showModelSelector, showToolsMenu, showSkillsMenu, showTokenUsage, showContextRing, themeVariant, colorMode, runtimeId, historyEndpoint, authToken, historyAuthToken, pendingPrompt, showInformation, onInformationClick, onToolCallStart, onToolCallComplete, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, panelProps, launching, launchingMessage, }: ChatFloatingProps): React.JSX.Element;
 export default ChatFloating;

package/lib/chat/ChatFloating.js

@@ -23,6 +23,7 @@ import { XIcon, CommentDiscussionIcon, GrabberIcon, } from '@primer/octicons-rea
 import { AiAgentIcon } from '@datalayer/icons-react';
 import { createPortal } from 'react-dom';
 import { ChatBase } from './base/ChatBase';
+import { ButtonGlow } from './display/ButtonGlow';
 import { useViewportDrag } from './useViewportDrag';
 import { disabledChatViewModes, resolveMountPoint } from './viewModes';
 import { useChatOpen, useChatMessages, useChatStore, } from '../stores/chatStore';
@@ -46,7 +47,7 @@ function useIsMobile(breakpoint = 640) {
  * ChatFloating component
  * A floating chat window built on ChatBase
  */
-export function ChatFloating({ endpoint, protocol: protocolProp, useStore: useStoreMode = true, title = 'Chat', description = 'Start a conversation with the AI agent.', position = 'bottom-right', defaultOpen = false, width = 400, height = 550, showHeader = true, showButton = true, showNewChatButton = true, showClearButton = true, showSettingsButton = false, enableKeyboardShortcuts = true, toggleShortcut = '/', showPoweredBy = true, promptVariant, mentionableAgents, poweredByProps, clickOutsideToClose = false, escapeToClose = true, className, onSettingsClick, onNewChat, onOpen, onClose, onStateUpdate, children, brandIcon, buttonIcon, buttonTooltip = 'Chat with AI', brandColor, offset = 20, animationDuration = 200, renderToolResult, frontendTools, initialState: _initialState, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, defaultViewMode = 'floating', onViewModeChange, sidebarMountPoint = null, showPanelBackdrop = false, availableModels, showModelSelector = false, showToolsMenu = false, showSkillsMenu = false, showTokenUsage = true, showContextRing = false, themeVariant, colorMode, runtimeId, historyEndpoint, authToken, historyAuthToken, pendingPrompt, showInformation = false, onInformationClick, onToolCallStart, onToolCallComplete, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, panelProps, launching = false, launchingMessage, }) {
+export function ChatFloating({ endpoint, protocol: protocolProp, useStore: useStoreMode = true, title = 'Chat', description = 'Start a conversation with the AI agent.', position = 'bottom-right', defaultOpen = false, width = 400, height = 550, showHeader = true, showButton = true, showNewChatButton = true, showClearButton = true, showSettingsButton = false, enableKeyboardShortcuts = true, toggleShortcut = '/', showPoweredBy = true, promptVariant, mentionableAgents, poweredByProps, clickOutsideToClose = false, escapeToClose = true, className, onSettingsClick, onNewChat, onOpen, onClose, onStateUpdate, children, brandIcon, buttonIcon, buttonTooltip = 'Chat with AI', brandColor, buttonGlow = true, offset = 20, animationDuration = 200, renderToolResult, frontendTools, initialState: _initialState, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, defaultViewMode = 'floating', onViewModeChange, sidebarMountPoint = null, showPanelBackdrop = false, availableModels, showModelSelector = false, showToolsMenu = false, showSkillsMenu = false, showTokenUsage = true, showContextRing = false, themeVariant, colorMode, runtimeId, historyEndpoint, authToken, historyAuthToken, pendingPrompt, showInformation = false, onInformationClick, onToolCallStart, onToolCallComplete, showToolApprovalBanner, pendingApprovals, onApproveApproval, onRejectApproval, panelProps, launching = false, launchingMessage, }) {
     // Store-based state
     const storeIsOpen = useChatOpen();
     const storeMessages = useChatMessages();
@@ -555,7 +556,9 @@ export function ChatFloating({ endpoint, protocol: protocolProp, useStore: useSt
                 }, children: _jsxs(Box, { sx: {
                         position: 'relative',
                         display: 'inline-flex',
-                    }, onMouseEnter: () => setIsHovered(true), onMouseLeave: () => setIsHovered(false), children: [_jsx(Tooltip, { text: `${buttonTooltip}${shortcutHint ? ` (${shortcutHint})` : ''}`, direction: position.includes('right') ? 'w' : 'e', children: _jsx(IconButton, { icon: buttonIcon
+                        // The glow's halos go behind the button, not behind the page.
+                        isolation: 'isolate',
+                    }, onMouseEnter: () => setIsHovered(true), onMouseLeave: () => setIsHovered(false), children: [buttonGlow && _jsx(ButtonGlow, { color: brandColor }), _jsx(Tooltip, { text: `${buttonTooltip}${shortcutHint ? ` (${shortcutHint})` : ''}`, direction: position.includes('right') ? 'w' : 'e', children: _jsx(IconButton, { icon: buttonIcon
                                     ? buttonIcon
                                     : CommentDiscussionIcon, "aria-label": buttonTooltip, onClick: handleToggle, size: "large", sx: {
                                     width: 56,

package/lib/chat/display/ButtonGlow.d.ts

@@ -0,0 +1,9 @@
+export interface ButtonGlowProps {
+    /**
+     * The colour of the light: the button's own. A theme token or any CSS
+     * colour; the theme's `accent.emphasis` when absent.
+     */
+    color?: string;
+}
+export declare function ButtonGlow({ color }: ButtonGlowProps): import("react").JSX.Element;
+export default ButtonGlow;

package/lib/chat/display/ButtonGlow.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * A soft light breathing around a round button, as if it were alive.
+ *
+ * Two blurred halos in the button's colour swell and fade on cycles of
+ * different lengths, 3.4 s and 5.3 s, so the light drifts rather than
+ * blinks: the two never line up the same way twice in a row. For a reader
+ * who asks the system for less motion, the halos hold still, a little dimmer.
+ *
+ * The halos sit behind the button: the parent must be `position: relative`
+ * and make a stacking context of its own (`isolation: 'isolate'`), or they
+ * would slip behind the page instead.
+ *
+ * @module chat/display/ButtonGlow
+ */
+import { Box } from '@datalayer/primer-addons';
+const halo = (color) => ({
+    position: 'absolute',
+    inset: 0,
+    borderRadius: '50%',
+    bg: color || 'accent.emphasis',
+    zIndex: -1,
+    pointerEvents: 'none',
+    willChange: 'transform, opacity',
+});
+export function ButtonGlow({ color }) {
+    return (_jsxs(_Fragment, { children: [_jsx(Box, { "aria-hidden": true, "data-button-glow": "breath", sx: {
+                    ...halo(color),
+                    filter: 'blur(10px)',
+                    animation: 'agentRuntimesGlowBreath 3.4s ease-in-out infinite',
+                    '@keyframes agentRuntimesGlowBreath': {
+                        '0%, 100%': { transform: 'scale(0.9)', opacity: 0.35 },
+                        '50%': { transform: 'scale(1.25)', opacity: 0.7 },
+                    },
+                    '@media (prefers-reduced-motion: reduce)': {
+                        animation: 'none',
+                        transform: 'scale(1.1)',
+                        opacity: 0.4,
+                    },
+                } }), _jsx(Box, { "aria-hidden": true, "data-button-glow": "aura", sx: {
+                    ...halo(color),
+                    filter: 'blur(18px)',
+                    animation: 'agentRuntimesGlowAura 5.3s ease-in-out infinite',
+                    '@keyframes agentRuntimesGlowAura': {
+                        '0%, 100%': { transform: 'scale(1)', opacity: 0.15 },
+                        '40%': { transform: 'scale(1.55)', opacity: 0.4 },
+                        '70%': { transform: 'scale(1.3)', opacity: 0.25 },
+                    },
+                    '@media (prefers-reduced-motion: reduce)': {
+                        animation: 'none',
+                        transform: 'scale(1.3)',
+                        opacity: 0.2,
+                    },
+                } })] }));
+}
+export default ButtonGlow;

package/lib/chat/display/EmptyState.js

@@ -50,6 +50,9 @@ export function ChatEmptyState({ emptyState, brandIcon, description, suggestions
                 cursor: 'pointer',
                 display: 'inline-flex',
                 alignItems: 'center',
+                // A short opener sits in the middle of its fixed-width chip, not
+                // against its left edge with the rest of the chip empty.
+                justifyContent: 'center',
                 width: SUGGESTION_CHIP_WIDTH,
                 flex: `0 0 ${SUGGESTION_CHIP_WIDTH}px`,
                 '&:hover': {
@@ -57,7 +60,7 @@ export function ChatEmptyState({ emptyState, brandIcon, description, suggestions
                     color: 'var(--button-primary-fgColor-rest)',
                     borderColor: 'accent.emphasis',
                 },
-            }, onClick: () => handleSuggestionClick(suggestion), children: _jsx(Truncate, { title: suggestion.message, maxWidth: "100%", sx: { minWidth: 0 }, children: suggestion.title }) }, index))) }));
+            }, onClick: () => handleSuggestionClick(suggestion), children: _jsx(Truncate, { inline: true, title: suggestion.message, maxWidth: "100%", sx: { minWidth: 0 }, children: suggestion.title }) }, index))) }));
     return (_jsx(ThemeProvider, { children: _jsxs(Box, { sx: {
                 display: 'flex',
                 flexDirection: 'column',

package/lib/chat/header/ChatHeaderBase.js

@@ -1,9 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Heading, IconButton, Label, Text, Tooltip, Truncate, } from '@primer/react';
+import { Heading, IconButton, Label, Text, Truncate } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
 import { KernelIndicator } from '@datalayer/jupyter-react';
-import { PlusIcon, TrashIcon, GearIcon, CommentDiscussionIcon, DeviceMobileIcon, SidebarExpandIcon, GrabberIcon, InfoIcon, } from '@primer/octicons-react';
-import { CHAT_VIEW_MODES, SIDEBAR_NEEDS_MOUNT_POINT } from '../viewModes';
+import { PlusIcon, TrashIcon, GearIcon, InfoIcon, } from '@primer/octicons-react';
+import { ChatViewModeToggle } from './ChatViewModeToggle';
 import { AiAgentIcon } from '@datalayer/icons-react';
 import { EphemeralSurfaceControl } from '../EphemeralSurfaceControl';
 export function toRuntimeExecutionState(runtimeStatus) {
@@ -29,16 +29,6 @@ export function toRuntimeExecutionState(runtimeStatus) {
     return undefined;
 }
 // ---------------------------------------------------------------------------
-// Props
-// ---------------------------------------------------------------------------
-/** The drawing of each mode in the header's toggle. */
-const VIEW_MODE_ICONS = {
-    floating: CommentDiscussionIcon,
-    'floating-small': DeviceMobileIcon,
-    'floating-draggable': GrabberIcon,
-    sidebar: SidebarExpandIcon,
-};
-// ---------------------------------------------------------------------------
 // Component
 // ---------------------------------------------------------------------------
 export function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, headerContent, headerActions, showInformation, onInformationClick, padding, kernelIndicatorState, kernelIndicatorPlacement = 'left', runtimeStatus, kernel, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, headerButtons, messageCount, onNewChat, onClear, chatViewMode, onChatViewModeChange, disabledViewModes = [], showEphemeralSurfaceControl = false, enableEphemeralNotebookOption = false, enableEphemeralDocumentOption = false, ephemeralSurfaceMode = 'none', onEphemeralSurfaceModeChange, }) {
@@ -90,47 +80,5 @@ export function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, head
                                         color: 'fg.muted',
                                         minWidth: 0,
                                         maxWidth: '100%',
-                                    }, children: _jsx(Truncate, { title: subtitle, maxWidth: "40ch", children: subtitle }) }))] })), disableReason && (_jsx(Label, { variant: "attention", sx: { flexShrink: 0 }, children: disableReason })), headerContent, showInformation && (_jsx(IconButton, { icon: InfoIcon, "aria-label": "Information", variant: "invisible", size: "small", onClick: onInformationClick })), kernelIndicatorPlacement === 'center' && kernelIndicatorElement] }), _jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1, flexShrink: 0 }, children: [kernelIndicatorPlacement === 'right' && kernelIndicatorElement, headerButtons?.showNewChat && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "New chat", variant: "invisible", size: "small", onClick: onNewChat })), headerButtons?.showClear && messageCount > 0 && (_jsx(IconButton, { icon: TrashIcon, "aria-label": "Clear messages", variant: "invisible", size: "small", onClick: onClear })), headerButtons?.showSettings && (_jsx(IconButton, { icon: GearIcon, "aria-label": "Settings", variant: "invisible", size: "small", onClick: headerButtons.onSettings })), showEphemeralSurfaceControl && (_jsx(EphemeralSurfaceControl, { mode: ephemeralSurfaceMode, onChange: onEphemeralSurfaceModeChange, enableNotebook: enableEphemeralNotebookOption, enableDocument: enableEphemeralDocumentOption })), chatViewMode && onChatViewModeChange && (_jsx(Box, { sx: {
-                                display: 'inline-flex',
-                                alignItems: 'center',
-                                bg: 'neutral.muted',
-                                borderRadius: '6px',
-                                p: '2px',
-                                gap: '1px',
-                            }, children: CHAT_VIEW_MODES.map(({ mode, label }) => {
-                                const ModeIcon = VIEW_MODE_ICONS[mode];
-                                const selected = chatViewMode === mode;
-                                /* Greyed rather than left out: the person sees the mode
-                                   exists, and that this page has no place for it. */
-                                const disabled = disabledViewModes.includes(mode);
-                                return (_jsx(Tooltip, { text: disabled && mode === 'sidebar'
-                                        ? `${label} — ${SIDEBAR_NEEDS_MOUNT_POINT}`
-                                        : label, direction: "n", children: _jsx(Box, { as: "button", "aria-label": label, "aria-disabled": disabled || undefined, onClick: () => {
-                                            if (!disabled) {
-                                                onChatViewModeChange(mode);
-                                            }
-                                        }, sx: {
-                                            display: 'inline-flex',
-                                            alignItems: 'center',
-                                            justifyContent: 'center',
-                                            width: 26,
-                                            height: 24,
-                                            borderRadius: '4px',
-                                            border: 'none',
-                                            cursor: disabled ? 'not-allowed' : 'pointer',
-                                            opacity: disabled ? 0.45 : 1,
-                                            bg: selected ? 'canvas.default' : 'transparent',
-                                            boxShadow: selected ? 'shadow.small' : 'none',
-                                            color: selected ? 'fg.default' : 'fg.muted',
-                                            transition: 'all 0.15s ease',
-                                            '&:hover': disabled
-                                                ? {}
-                                                : {
-                                                    color: 'fg.default',
-                                                    bg: selected
-                                                        ? 'canvas.default'
-                                                        : 'neutral.subtle',
-                                                },
-                                        }, children: _jsx(ModeIcon, { size: 14 }) }) }, mode));
-                            }) })), headerActions] })] }) }));
+                                    }, children: _jsx(Truncate, { title: subtitle, maxWidth: "40ch", children: subtitle }) }))] })), disableReason && (_jsx(Label, { variant: "attention", sx: { flexShrink: 0 }, children: disableReason })), headerContent, showInformation && (_jsx(IconButton, { icon: InfoIcon, "aria-label": "Information", variant: "invisible", size: "small", onClick: onInformationClick })), kernelIndicatorPlacement === 'center' && kernelIndicatorElement] }), _jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1, flexShrink: 0 }, children: [kernelIndicatorPlacement === 'right' && kernelIndicatorElement, headerButtons?.showNewChat && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "New chat", variant: "invisible", size: "small", onClick: onNewChat })), headerButtons?.showClear && messageCount > 0 && (_jsx(IconButton, { icon: TrashIcon, "aria-label": "Clear messages", variant: "invisible", size: "small", onClick: onClear })), headerButtons?.showSettings && (_jsx(IconButton, { icon: GearIcon, "aria-label": "Settings", variant: "invisible", size: "small", onClick: headerButtons.onSettings })), showEphemeralSurfaceControl && (_jsx(EphemeralSurfaceControl, { mode: ephemeralSurfaceMode, onChange: onEphemeralSurfaceModeChange, enableNotebook: enableEphemeralNotebookOption, enableDocument: enableEphemeralDocumentOption })), chatViewMode && onChatViewModeChange && (_jsx(ChatViewModeToggle, { value: chatViewMode, onChange: onChatViewModeChange, disabledModes: disabledViewModes })), headerActions] })] }) }));
 }

package/lib/chat/header/ChatViewModeToggle.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The segmented toggle for how a chat is shown — the four modes of
+ * `CHAT_VIEW_MODES`, drawn as icons in a pill, the current one raised.
+ *
+ * It grew up in the chat header, and lives apart from it so the same
+ * control can stand elsewhere: a composer floating over a page as a
+ * draggable card carries it in its own footer, where the person deciding
+ * how the chat should sit has the chat under their hands. The rules — the
+ * order, the words, which modes are greyed out — stay in `viewModes.ts`;
+ * this is only their drawing.
+ *
+ * @module chat/header/ChatViewModeToggle
+ */
+import type { JSX } from 'react';
+import { type Icon } from '@primer/octicons-react';
+import type { ChatViewMode } from '../../types/chat';
+/** The drawing of each mode. */
+export declare const VIEW_MODE_ICONS: Record<ChatViewMode, Icon>;
+export type ChatViewModeToggleProps = {
+    /** The mode the chat is in now. */
+    value?: ChatViewMode;
+    /** The mode the person picked. */
+    onChange: (mode: ChatViewMode) => void;
+    /** Modes shown greyed out: the sidebar, when the host has no mount point. */
+    disabledModes?: readonly ChatViewMode[];
+    /** Where the tooltips open. Above by default; below for a control at the top of its window. */
+    tooltipDirection?: 'n' | 's';
+};
+export declare function ChatViewModeToggle({ value, onChange, disabledModes, tooltipDirection, }: ChatViewModeToggleProps): JSX.Element;

package/lib/chat/header/ChatViewModeToggle.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Tooltip } from '@primer/react';
+import { Box } from '@datalayer/primer-addons';
+import { CommentDiscussionIcon, DeviceMobileIcon, GrabberIcon, SidebarExpandIcon, } from '@primer/octicons-react';
+import { CHAT_VIEW_MODES, SIDEBAR_NEEDS_MOUNT_POINT } from '../viewModes';
+/** The drawing of each mode. */
+export const VIEW_MODE_ICONS = {
+    floating: CommentDiscussionIcon,
+    'floating-small': DeviceMobileIcon,
+    'floating-draggable': GrabberIcon,
+    sidebar: SidebarExpandIcon,
+};
+export function ChatViewModeToggle({ value, onChange, disabledModes = [], tooltipDirection = 'n', }) {
+    return (_jsx(Box, { role: "group", "aria-label": "Display mode", "data-chat-view-mode-toggle": "", sx: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            bg: 'neutral.muted',
+            borderRadius: '6px',
+            p: '2px',
+            gap: '1px',
+        }, children: CHAT_VIEW_MODES.map(({ mode, label }) => {
+            const ModeIcon = VIEW_MODE_ICONS[mode];
+            const selected = value === mode;
+            /* Greyed rather than left out: the person sees the mode exists, and
+               that this page has no place for it. */
+            const disabled = disabledModes.includes(mode);
+            return (_jsx(Tooltip, { text: disabled && mode === 'sidebar'
+                    ? `${label} — ${SIDEBAR_NEEDS_MOUNT_POINT}`
+                    : label, direction: tooltipDirection, children: _jsx(Box, { as: "button", type: "button", "aria-label": label, "aria-pressed": selected, "aria-disabled": disabled || undefined, onClick: () => {
+                        if (!disabled) {
+                            onChange(mode);
+                        }
+                    }, sx: {
+                        display: 'inline-flex',
+                        alignItems: 'center',
+                        justifyContent: 'center',
+                        width: 26,
+                        height: 24,
+                        borderRadius: '4px',
+                        border: 'none',
+                        cursor: disabled ? 'not-allowed' : 'pointer',
+                        opacity: disabled ? 0.45 : 1,
+                        bg: selected ? 'canvas.default' : 'transparent',
+                        boxShadow: selected ? 'shadow.small' : 'none',
+                        color: selected ? 'fg.default' : 'fg.muted',
+                        transition: 'all 0.15s ease',
+                        '&:hover': disabled
+                            ? {}
+                            : {
+                                color: 'fg.default',
+                                bg: selected ? 'canvas.default' : 'neutral.subtle',
+                            },
+                    }, children: _jsx(ModeIcon, { size: 14 }) }) }, mode));
+        }) }));
+}

package/lib/chat/index.d.ts

@@ -59,6 +59,7 @@ export { McpStatusIndicator, type McpStatusIndicatorProps, type McpServerStatus,
 export { PoweredByTag, type PoweredByTagProps } from './display/PoweredByTag';
 export { FloatingBrandButton, type FloatingBrandButtonProps, } from './display/FloatingBrandButton';
 export { ChatHeader, type ChatHeaderProps } from './header/ChatHeader';
+export { ChatViewModeToggle, VIEW_MODE_ICONS, type ChatViewModeToggleProps, } from './header/ChatViewModeToggle';
 export { MessagePart, type MessagePartProps, TextPart, type TextPartProps, ReasoningPart, type ReasoningPartProps, ToolPart, type ToolPartProps, DynamicToolPart, type DynamicToolPartProps, } from './parts';
 export { ToolCallDisplay, type ToolCallDisplayProps } from './tools';
 export { ToolApprovalDialog, useToolApprovalDialog, type ToolApprovalDialogProps, } from './tools/ToolApprovalDialog';

package/lib/chat/index.js

@@ -68,6 +68,7 @@ export { McpStatusIndicator, SandboxStatusIndicator, } from './indicators';
 export { PoweredByTag } from './display/PoweredByTag';
 export { FloatingBrandButton, } from './display/FloatingBrandButton';
 export { ChatHeader } from './header/ChatHeader';
+export { ChatViewModeToggle, VIEW_MODE_ICONS, } from './header/ChatViewModeToggle';
 // Components - Message part renderers
 export { MessagePart, TextPart, ReasoningPart, ToolPart, DynamicToolPart, } from './parts';
 // Components - Tool UI

package/lib/components/code-sandboxes/CodeSandboxLauncher.d.ts

@@ -62,6 +62,14 @@ export interface ICodeSandboxLauncherProps {
      * Optional submit button label override.
      */
     submitLabel?: string;
+    /**
+     * A published environment to offer and select: the version uid of its
+     * publication, as the Library page that sent the reader here names it.
+     * Nobody's listing holds another account's environment, so it is read from
+     * the publication, offered under *Library* and priced by the rate the
+     * publication carries (D-12, E2-19).
+     */
+    libraryVersionUid?: string;
 }
 /**
  * The launcher of a new code sandbox.

package/lib/components/code-sandboxes/CodeSandboxLauncher.js

@@ -10,7 +10,8 @@ import { NO_RUNTIME_AVAILABLE_LABEL } from '@datalayer/core/lib/i18n';
 import { isCodeSandboxProviderAvailable } from './codeSandboxProviders';
 import { CodeSandboxVariant, codeSandboxVariantOf, codeSandboxVariantTitle, } from '../../models/CodeSandboxVariant';
 import { CodeSandboxEnvironmentSelect, } from './CodeSandboxEnvironmentSelect';
-import { codeSandboxEnvironmentOptions, codeSandboxEnvironmentVersion, firstLaunchableCodeSandboxEnvironment, } from './codeSandboxEnvironments';
+import { codeSandboxEnvironmentOptions, codeSandboxEnvironmentVersion, firstLaunchableCodeSandboxEnvironment, libraryEnvironmentOf, } from './codeSandboxEnvironments';
+import { getEnvironmentPublication } from '../../api/runtimes/environments';
 import { getCodeSandboxGivenName, listCodeSandboxGivenNames, nextCodeSandboxGivenName, setCodeSandboxGivenName, } from './CodeSandboxNames';
 import { iamStore, runtimesStore, useCoreStore, useIAMStore, } from '../../state/substates';
 import { createRuntime as createRuntimeRecord } from '../../runtimes/actions';
@@ -42,7 +43,7 @@ const NOT_AVAILABLE_RETRIES = 5;
  * The launcher of a new code sandbox.
  */
 export function CodeSandboxLauncher(props) {
-    const { dialogTitle, kernelSnapshot, manager, onSubmit, markdownParser, sanitizer, upgradeSubscription, usageRoute = '/plans', submitLabel, startRuntime = true, } = props;
+    const { dialogTitle, kernelSnapshot, manager, onSubmit, markdownParser, sanitizer, upgradeSubscription, usageRoute = '/plans', submitLabel, startRuntime = true, libraryVersionUid, } = props;
     const hasExample = startRuntime === 'with-example';
     const shouldStartRuntime = startRuntime !== 'defer';
     const user = iamStore.getState().user;
@@ -56,7 +57,45 @@ export function CodeSandboxLauncher(props) {
      * below.
      */
     const jupyterAvailable = isCodeSandboxProviderAvailable('local', runtimesStore.getState().multiServiceManager);
-    const environments = manager.environments.get();
+    const listed = manager.environments.get();
+    /*
+     * A publication somebody else owns, which no listing of the viewer's holds
+     * (D-12, E2-19): read by its version uid, offered under *Library* beside
+     * the rest, priced by the rate the publication carries, and selected below,
+     * since it is what the reader came here to launch.
+     */
+    const [libraryEntry, setLibraryEntry] = useState();
+    const [libraryRefusal, setLibraryRefusal] = useState('');
+    useEffect(() => {
+        if (!libraryVersionUid) {
+            return undefined;
+        }
+        let current = true;
+        getEnvironmentPublication(iamStore.getState().token ?? '', libraryVersionUid, {}, runtimesStore.getState().runtimesUrl)
+            .then(publication => {
+            if (!current) {
+                return;
+            }
+            const entry = libraryEnvironmentOf(publication);
+            if (entry) {
+                setLibraryEntry(entry);
+            }
+            else {
+                setLibraryRefusal('This environment is no longer published, so it cannot be launched from the Library.');
+            }
+        })
+            .catch(() => {
+            if (current) {
+                setLibraryRefusal('This published environment could not be read, so it cannot be launched from here.');
+            }
+        });
+        return () => {
+            current = false;
+        };
+    }, [libraryVersionUid]);
+    const environments = useMemo(() => libraryEntry && !listed.some(entry => entry.name === libraryEntry.name)
+        ? [...listed, libraryEntry]
+        : listed, [listed, libraryEntry]);
     /*
      * The sandboxes of this Jupyter Server, offered beside those of the platform.
      *
@@ -168,6 +207,17 @@ export function CodeSandboxLauncher(props) {
     const [runtimeName, setRuntimeName] = useState(() => givenNameFor(firstLaunchableCodeSandboxEnvironment(environments)));
     // Whether the runtim name has been changed by the user or not
     const [hasCustomRuntimeName, setHasCustomRuntimeName] = useState(false);
+    // The publication the reader came to launch, selected once it is read.
+    useEffect(() => {
+        if (!libraryEntry) {
+            return;
+        }
+        setSelection(libraryEntry.name);
+        if (!hasCustomRuntimeName) {
+            setRuntimeName(givenNameFor(libraryEntry));
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [libraryEntry]);
     const [homeFolder, setHomeFolder] = useState(false);
     const [openExample, setOpenExample] = useState(false);
     const [waitingForRuntime, setWaitingForRuntime] = useState(false);
@@ -294,7 +344,6 @@ export function CodeSandboxLauncher(props) {
                 }
             }
             else if (shouldStartRuntime) {
-                success = false;
                 let availableTrial = 1;
                 let retryDelay = NOT_AVAILABLE_INIT_RETRY;
                 // Should return success status.
@@ -437,7 +486,7 @@ export function CodeSandboxLauncher(props) {
                     event.preventDefault();
                     handleSubmitRuntime();
                 }
-            }, children: [_jsxs(FormControl, { disabled: !!kernelSnapshot?.environment || environments.length === 0, children: [_jsx(FormControl.Label, { children: "Environment" }), _jsx(CodeSandboxEnvironmentSelect, { disabled: !!kernelSnapshot?.environment || environments.length === 0, options: environmentOptions, selectedKey: selection, onSelect: handleSelectionChange }), _jsx(FormControl.Caption, { children: _jsx(_Fragment, { children: markdownParser ? (_jsx(Box, { sx: { img: { maxWidth: '100%' } }, children: _jsx(Markdown, { text: description, markdownParser: markdownParser, sanitizer: sanitizer }) })) : sanitizer ? (
+            }, children: [libraryRefusal ? (_jsx(Text, { as: "p", sx: { color: 'attention.fg' }, "data-testid": "library-refusal", children: libraryRefusal })) : null, _jsxs(FormControl, { disabled: !!kernelSnapshot?.environment || environments.length === 0, children: [_jsx(FormControl.Label, { children: "Environment" }), _jsx(CodeSandboxEnvironmentSelect, { disabled: !!kernelSnapshot?.environment || environments.length === 0, options: environmentOptions, selectedKey: selection, onSelect: handleSelectionChange }), _jsx(FormControl.Caption, { children: _jsx(_Fragment, { children: markdownParser ? (_jsx(Box, { sx: { img: { maxWidth: '100%' } }, children: _jsx(Markdown, { text: description, markdownParser: markdownParser, sanitizer: sanitizer }) })) : sanitizer ? (
                                 // The description of an environment carries markup. With no
                                 // parser to render it, the sanitizer of the application is
                                 // enough to show it as what it is rather than as its tags.

package/lib/components/code-sandboxes/codeSandboxEnvironments.d.ts

@@ -14,7 +14,7 @@
  *
  * @module components/code-sandboxes/codeSandboxEnvironments
  */
-import type { IDatalayerEnvironment } from '../../models';
+import type { IDatalayerEnvironment, IEnvironmentPublicationRecord } from '../../models';
 import type { ICodeSandboxEnvironmentOption } from './CodeSandboxEnvironmentSelect';
 /**
  * The variant a sandbox of THIS platform starts on.
@@ -84,3 +84,14 @@ export declare function codeSandboxEnvironmentOption(environment: IDatalayerEnvi
 export declare function codeSandboxEnvironmentOptions(environments: readonly IDatalayerEnvironment[], viewer?: ICodeSandboxEnvironmentViewer, decorate?: (environment: IDatalayerEnvironment) => Partial<ICodeSandboxEnvironmentOption>): ICodeSandboxEnvironmentOption[];
 /** The first entry a launcher may open on: never one that cannot be launched. */
 export declare function firstLaunchableCodeSandboxEnvironment(environments: readonly IDatalayerEnvironment[]): IDatalayerEnvironment | undefined;
+/**
+ * A publication, as the picker offers it to somebody who does not own it
+ * (D-12, E2-19).
+ *
+ * Nobody's listing holds another account's environment, so a reader who came
+ * from its Library page is offered it from the publication itself: launched by
+ * its environment uid and the version the publication froze, listed under
+ * *Library*, and priced by the rate the publication carries. `undefined` for a
+ * publication that has been withdrawn, which is no longer anyone's to launch.
+ */
+export declare function libraryEnvironmentOf(publication: IEnvironmentPublicationRecord): IDatalayerEnvironment | undefined;

package/lib/components/code-sandboxes/codeSandboxEnvironments.js

@@ -121,7 +121,7 @@ export function codeSandboxEnvironmentOption(environment, viewer, extra = {}) {
     return {
         key: environment.name,
         title: environment.title || environment.name,
-        name: environment.name,
+        name: environment.label || environment.name,
         group: CODE_SANDBOX_ENVIRONMENT_GROUP_TITLES[group],
         version: version === undefined ? undefined : `v${version}`,
         sizeClass: environment.sizeClass || undefined,
@@ -145,3 +145,40 @@ export function codeSandboxEnvironmentOptions(environments, viewer, decorate) {
 export function firstLaunchableCodeSandboxEnvironment(environments) {
     return environments.find(isCodeSandboxEnvironmentLaunchable);
 }
+/**
+ * A publication, as the picker offers it to somebody who does not own it
+ * (D-12, E2-19).
+ *
+ * Nobody's listing holds another account's environment, so a reader who came
+ * from its Library page is offered it from the publication itself: launched by
+ * its environment uid and the version the publication froze, listed under
+ * *Library*, and priced by the rate the publication carries. `undefined` for a
+ * publication that has been withdrawn, which is no longer anyone's to launch.
+ */
+export function libraryEnvironmentOf(publication) {
+    if (publication.status !== 'published') {
+        return undefined;
+    }
+    const snapshot = publication.snapshot;
+    const spec = snapshot.spec
+        ?.spec;
+    const version = snapshot.versionNumber;
+    return {
+        name: publication.environmentUid,
+        label: snapshot.environmentName || undefined,
+        uid: publication.environmentUid,
+        title: snapshot.title || snapshot.environmentName,
+        description: snapshot.readme ?? '',
+        language: spec?.language?.name ?? 'python',
+        origin: 'user',
+        owner: publication.ownerUid,
+        fromLibrary: true,
+        sizeClass: snapshot.sizeClass,
+        burning_rate: publication.burningRate ?? undefined,
+        promotedVersion: version === null || version === undefined
+            ? null
+            : { uid: publication.versionUid, version, status: 'ready' },
+        variants: Object.keys(snapshot.variants ?? {}),
+        availableVariants: Object.keys(snapshot.variants ?? {}),
+    };
+}

package/lib/components/icons/ArtifactIcon.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { createElement } from 'react';
-import { DatabaseIcon, RowsIcon, BookIcon, DiffModifiedIcon, PencilIcon, FeedIssueDraftIcon, FeedRocketIcon, MilestoneIcon, OrganizationIcon, PeopleIcon, RocketIcon, FileIcon, StackIcon, GearIcon, GraphIcon, NumberIcon, PaperAirplaneIcon, ArchiveIcon, TagIcon, MortarBoardIcon, ContainerIcon, HomeIcon, ShareIcon, FileDirectoryIcon, TrophyIcon, QuestionIcon, PersonIcon, MailIcon, ZapIcon, } from '@primer/octicons-react';
+import { DatabaseIcon, RowsIcon, BookIcon, DiffModifiedIcon, PencilIcon, FeedIssueDraftIcon, FeedRocketIcon, MilestoneIcon, OrganizationIcon, PeopleIcon, RocketIcon, FileIcon, StackIcon, GearIcon, GraphIcon, NumberIcon, PaperAirplaneIcon, ArchiveIcon, TagIcon, MortarBoardIcon, ContainerIcon, HomeIcon, ShareIcon, FileDirectoryIcon, TrophyIcon, QuestionIcon, PersonIcon, MailIcon, FileMediaIcon, ZapIcon, } from '@primer/octicons-react';
 import { GalileoIcon, CircleWhiteIcon, BookOpenIcon, CameraIcon, CellIcon, NotebookOutlineIcon, } from '@datalayer/icons-react';
 const ARTIFACT_ICONS = new Map([
     ['assignment', MilestoneIcon],
@@ -13,6 +13,7 @@ const ARTIFACT_ICONS = new Map([
     ['credits', NumberIcon],
     ['dataset', StackIcon],
     ['datasource', DatabaseIcon],
+    ['deck', FileMediaIcon],
     ['document', FileIcon],
     ['documentation', BookOpenIcon],
     ['environment', ContainerIcon],