@datalayer/agent-runtimes 1.3.10 → 1.3.11

package/lib/examples/DecksAgent.d.ts

@@ -5,7 +5,7 @@
  * Reactor plugin with a Python half of its own, and here it is mounted into
  * an agent workspace — its list in the sidebar, its view as an editor beside
  * the conversation, its commands in the palette and in a menu on the
- * composer, and its tools in the agent's hands. `worker-decks` writes a deck
+ * composer, and its tools in the agent's hands. `example-decks` writes a deck
  * as data, saves it, opens it, and steps through it while you talk.
  *
  * Everything runs in the browser: the agent on the Vercel AI harness, the

package/lib/examples/DecksAgent.js

@@ -11,7 +11,7 @@ registerDecks(exampleDecks);
 // Module-level, so the embed builds its reactor once rather than on every
 // render of this component.
 const DECK_PLUGINS = [LoopDecksPlugin, DeckViewPlugin];
-const DecksAgent = () => (_jsx(ThemedProvider, { children: _jsx(Box, { sx: { height: '100vh', minHeight: 0 }, children: _jsx(LoopEmbed, { target: "browser", agentId: "worker-decks", 
+const DecksAgent = () => (_jsx(ThemedProvider, { children: _jsx(Box, { sx: { height: '100vh', minHeight: 0 }, children: _jsx(LoopEmbed, { target: "browser", agentId: "example-decks", 
             /* The deck open beside the chat from the first frame. */
             defaultEditor: "deck", 
             /* The header carries the editor choice — deck, notebook, document, or

package/lib/loop/core/index.d.ts

@@ -824,14 +824,23 @@ export type ChatLayoutContribution = {
     /**
      * How this layout wants the composer built.
      *
-     * `floating-top` is a floating card anchored to the top edge rather than
+     * `floating-top` and `floating-bottom` are a floating card anchored to
+     * that edge of the layout rather than
      * the bottom — a command line over the document, sized by the card.
      * `docked-top` is that same command line standing in the flow instead: the
      * layout gives it a mount point and the composer fills it, so its width is
      * the layout's to decide and the page below starts under it rather than
      * behind it.
      */
-    prompt?: 'docked' | 'floating' | 'floating-top' | 'docked-top';
+    prompt?: 'docked' | 'floating' | 'floating-top' | 'floating-bottom' | 'docked-top';
+    /**
+     * The same, live, for a layout whose stance changes while it is on
+     * screen — the page layout moves the composer between a floating card
+     * and its side panel as the person picks a display mode. Read over
+     * `prompt` by the chat view whenever it is given; `prompt` is then only
+     * the stance the layout starts in.
+     */
+    promptStance?: ReadonlySignal<'docked' | 'floating' | 'floating-top' | 'floating-bottom' | 'docked-top'>;
 };
 export declare const LoopChatLayout: import("@datalayer/reactor").ContributionPoint<ChatLayoutContribution>;
 /**

package/lib/loop/embed/LoopEmbed.js

@@ -77,6 +77,12 @@ export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions,
         preset.pageLayoutTurnPanel,
         preset.pageLayoutTurnPanelFooter,
         preset.pageLayoutPrompt,
+        preset.pageLayoutPromptAnchor,
+        // By its fields: a host that writes the size inline hands over a new
+        // object every render, and the reactor must not be rebuilt for that.
+        preset.pageLayoutSize?.format,
+        preset.pageLayoutSize?.width,
+        preset.pageLayoutSize?.height,
         preset.localAgentSpec,
         preset.floatingPrompt,
         preset.editorSelector,

package/lib/loop/plugins/chat/ChatView.js

@@ -4,6 +4,8 @@ import { Box, IconButton, SegmentedControl, Text, Truncate, } from '@primer/reac
 import { useColorPalette } from '@datalayer/primer-addons';
 import { ScreenFullIcon, ScreenNormalIcon } from '@primer/octicons-react';
 import { signal } from '@datalayer/reactor';
+/* A signal to read when the layout publishes no live stance: the hook needs one. */
+const NO_STANCE = signal(undefined);
 import { useContributions, useSignalValue, useGate, useReactorPlatform, ReactorLazy, ReactorSlot, useSlotComponents, } from '@datalayer/reactor/react';
 import { ChatBase } from '../../../chat/base/ChatBase';
 import { SUGGESTION_CHIP_WIDTH } from '../../../chat/display/EmptyState';
@@ -123,6 +125,11 @@ export default function ChatView({ workspace }) {
        its own way; first contribution wins. */
     const layoutEntries = useContributions(LoopChatLayout);
     const layout = layoutEntries[0]?.value;
+    // The composer's stance: live when the layout publishes one (the page
+    // layout, moving the composer as the display mode changes), its starting
+    // stance otherwise.
+    const liveStance = useSignalValue(layout?.promptStance ?? NO_STANCE);
+    const promptStance = liveStance ?? layout?.prompt;
     /* The current turn, kept for whoever shows the conversation without the
        transcript. The chat plugin contributed the feed at build; this view is
        its writer — begin on send, the reply as it arrives, end when it stops. */
@@ -1183,13 +1190,14 @@ export default function ChatView({ workspace }) {
         // In a draggable card over the workspace when the host asked for the
         // floating placement; the dragging is the prompt's own feature.
         placement: floatingPrompt ||
-            layout?.prompt === 'floating' ||
-            layout?.prompt === 'floating-top'
+            promptStance === 'floating' ||
+            promptStance === 'floating-top' ||
+            promptStance === 'floating-bottom'
             ? 'floating'
             : 'docked',
         // Where a floating card starts: the page layout wants it over the top
         // of the sheet, like a document's title bar; everyone else, bottom.
-        floatingAnchor: layout?.prompt === 'floating-top' ? 'top' : 'bottom',
+        floatingAnchor: promptStance === 'floating-top' ? 'top' : 'bottom',
         // The agent is working: `isLoading` disables the editor and turns the
         // send button into a stop — the person keeps a way out.
         isLoading: busy,
@@ -1206,8 +1214,9 @@ export default function ChatView({ workspace }) {
         // Both of the page layout's placements are that bar — one floating over
         // the page, one docked above it — so both take the tighter padding.
         padding: topPrompt ||
-            layout?.prompt === 'floating-top' ||
-            layout?.prompt === 'docked-top'
+            promptStance === 'floating-top' ||
+            promptStance === 'floating-bottom' ||
+            promptStance === 'docked-top'
             ? 2
             : 3,
         promptVariant: 'lexical',

package/lib/loop/plugins/page-layout/index.d.ts

@@ -1,6 +1,9 @@
+import { type PageSize } from '@datalayer/primer-addons/lib/reactor';
+import type { ChatViewMode } from '../../../types/chat';
 import { type TurnPanelFooter } from './TurnPanel';
 export { pageLayoutPanelOpen, pageLayoutSheet, openPagePanel as openConversationPanel, } from '@datalayer/primer-addons/lib/reactor';
 export type { TurnPanelFooter } from './TurnPanel';
+export type { PageSize, PageSizeFormat, } from '@datalayer/primer-addons/lib/reactor';
 export declare const LOOP_PAGE_LAYOUT_PLUGIN_NAME = "@datalayer/loop-plugin-page-layout";
 /** What a host may set on the page layout. */
 export type LoopPageLayoutConfig = {
@@ -22,6 +25,20 @@ export type LoopPageLayoutConfig = {
      * kept clear for it — the document application's title bar, movable.
      */
     prompt: 'docked' | 'floating';
+    /**
+     * Which edge of the page a floating composer starts at: `top` (the
+     * default), where a document's title bar would be, or `bottom`, where a
+     * chat's composer waits. Either way it is dragged from there. Only read
+     * with a `floating` prompt.
+     */
+    promptAnchor?: 'top' | 'bottom';
+    /**
+     * The sheet's size: free (the default) at the layout's reading width, or
+     * a paper — `{ format: 'letter' }`, `{ format: 'a4' }` — whose width the
+     * sheet takes and whose height it is at least, with a free `width` or
+     * `height` over either. Omitted: free.
+     */
+    pageSize?: PageSize;
     /**
      * What the turn panel draws under the reply.
      *
@@ -31,5 +48,24 @@ export type LoopPageLayoutConfig = {
      */
     turnPanelFooter: TurnPanelFooter;
 };
+/**
+ * How the page layout shows the chat, when the composer is the floating
+ * card: the card itself over the page (`floating-draggable`, where it
+ * starts), or the conversation panel with the composer standing in it —
+ * beside the page (`sidebar`), over its right edge at full height
+ * (`floating`), or as a window in its corner (`floating-small`). The four
+ * modes of the chat header's toggle, which the card carries in its own
+ * footer. One signal for the workspace, as `pageLayoutPanelOpen` is: the
+ * mode is the person's, not a build's.
+ */
+export declare const pageLayoutChatMode: import("@datalayer/reactor").Signal<ChatViewMode>;
+/** Where a mode puts the composer (the band) and the conversation (the panel). */
+export type PageLayoutChatPlacement = {
+    bandMode: 'floating' | 'panel';
+    panelMode: 'docked' | 'overlay' | 'popup';
+};
+export declare function pageLayoutForChatMode(mode: ChatViewMode): PageLayoutChatPlacement;
+/** Picks a mode: the layout follows, and so does the composer's stance. */
+export declare function setPageLayoutChatMode(mode: ChatViewMode): void;
 export declare const LoopPageLayoutPlugin: import("@datalayer/reactor").ReactorPlugin<LoopPageLayoutConfig, unknown, unknown>;
 export default LoopPageLayoutPlugin;

package/lib/loop/plugins/page-layout/index.js

@@ -2,7 +2,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { CommentDiscussionIcon } from '@primer/octicons-react';
 import { definePlugin, signal } from '@datalayer/reactor';
 import { useContributions, useSignalValue } from '@datalayer/reactor/react';
-import { PageLayout, PagePanelToggle, } from '@datalayer/primer-addons/lib/reactor';
+import { PageLayout, PagePanelToggle, openPagePanel, } from '@datalayer/primer-addons/lib/reactor';
+import { ChatViewModeToggle } from '../../../chat/header/ChatViewModeToggle';
 import { LoopChatLayout, LoopChatTurn, LoopPromptPanel, LoopSlots, } from '../../core';
 import { TurnPanel } from './TurnPanel';
 /*
@@ -14,6 +15,53 @@ export { pageLayoutPanelOpen, pageLayoutSheet, openPagePanel as openConversation
 export const LOOP_PAGE_LAYOUT_PLUGIN_NAME = '@datalayer/loop-plugin-page-layout';
 /* A signal to read when no chat contributed a turn: the hook needs one. */
 const NO_TURN = signal({ id: 0, status: 'idle' });
+/**
+ * How the page layout shows the chat, when the composer is the floating
+ * card: the card itself over the page (`floating-draggable`, where it
+ * starts), or the conversation panel with the composer standing in it —
+ * beside the page (`sidebar`), over its right edge at full height
+ * (`floating`), or as a window in its corner (`floating-small`). The four
+ * modes of the chat header's toggle, which the card carries in its own
+ * footer. One signal for the workspace, as `pageLayoutPanelOpen` is: the
+ * mode is the person's, not a build's.
+ */
+export const pageLayoutChatMode = signal('floating-draggable');
+/** The composer's stance for the chat view, following the mode above. */
+const promptStance = signal('floating-top');
+/*
+ * Which edge the card returns to when the mode puts it back over the page:
+ * the build's own `promptAnchor`, kept here because the mode is picked
+ * through a module-level function, as `pageLayoutChatMode` itself is. One
+ * page layout to a page, the assumption that signal already makes.
+ */
+let floatingStance = 'floating-top';
+export function pageLayoutForChatMode(mode) {
+    switch (mode) {
+        case 'sidebar':
+            return { bandMode: 'panel', panelMode: 'docked' };
+        case 'floating':
+            return { bandMode: 'panel', panelMode: 'overlay' };
+        case 'floating-small':
+            return { bandMode: 'panel', panelMode: 'popup' };
+        default:
+            return { bandMode: 'floating', panelMode: 'docked' };
+    }
+}
+/** Picks a mode: the layout follows, and so does the composer's stance. */
+export function setPageLayoutChatMode(mode) {
+    pageLayoutChatMode.value = mode;
+    const { bandMode } = pageLayoutForChatMode(mode);
+    promptStance.value = bandMode === 'floating' ? floatingStance : 'docked-top';
+    // The composer went into the panel: the panel opens to show it.
+    if (bandMode === 'panel') {
+        openPagePanel();
+    }
+}
+/** The toggle in the floating composer's footer. */
+function ChatModeAction() {
+    const mode = useSignalValue(pageLayoutChatMode);
+    return _jsx(ChatViewModeToggle, { value: mode, onChange: setPageLayoutChatMode });
+}
 /**
  * The chat view's parts on the page layout.
  *
@@ -21,10 +69,16 @@ const NO_TURN = signal({ id: 0, status: 'idle' });
  * what the agent is doing — the turn's `activity` — is the line at the top
  * of the sheet, so the change is seen where it happens.
  */
-function LoopPageLayout({ parts, promptMode, }) {
+function LoopPageLayout({ parts, promptMode, pageSize, }) {
     const turnEntries = useContributions(LoopChatTurn);
     const turn = useSignalValue(turnEntries[0]?.value.turn ?? NO_TURN);
-    return (_jsx(PageLayout, { page: parts.editors, hasPage: parts.hasEditor, panel: parts.transcript, band: parts.prompt, chips: parts.chips, picker: parts.picker, transient: parts.transient, activity: turn.activity, bandMode: promptMode }));
+    const chatMode = useSignalValue(pageLayoutChatMode);
+    // The display modes are the floating card's own; a docked composer stays
+    // docked above the page, whatever mode was picked elsewhere.
+    const placement = promptMode === 'floating'
+        ? pageLayoutForChatMode(chatMode)
+        : { bandMode: 'docked', panelMode: 'docked' };
+    return (_jsx(PageLayout, { page: parts.editors, hasPage: parts.hasEditor, panel: parts.transcript, band: parts.prompt, chips: parts.chips, picker: parts.picker, transient: parts.transient, activity: turn.activity, bandMode: placement.bandMode, panelMode: placement.panelMode, pageSize: pageSize }));
 }
 /** The header button that opens and closes the conversation panel. */
 function ConversationToggle() {
@@ -32,7 +86,13 @@ function ConversationToggle() {
 }
 export const LoopPageLayoutPlugin = definePlugin({
     name: LOOP_PAGE_LAYOUT_PLUGIN_NAME,
-    config: { turnPanel: 'below', turnPanelFooter: 'full', prompt: 'docked' },
+    config: {
+        turnPanel: 'below',
+        turnPanelFooter: 'full',
+        prompt: 'docked',
+        promptAnchor: 'top',
+        pageSize: undefined,
+    },
     displayName: 'Page layout',
     description: 'The editor — or, in the chat view, the conversation — on a centred sheet, the prompt docked above it at the same width or floating over it as a draggable card, the current turn under the prompt, the conversation in a side panel.',
     octicon: 'file',
@@ -42,15 +102,24 @@ export const LoopPageLayoutPlugin = definePlugin({
           The layout, contributed per build because the composer's stance is
           configuration: `docked-top` means the layout owns the composer's width
           — `PageLayout` gives it a mount point the width of the sheet, so the
-          prompt and the page read as one column; `floating-top` is the draggable
+          prompt and the page read as one column; `floating-top` and
+          `floating-bottom` are the draggable
           card, sized by itself, over a strip of canvas kept clear for it. The
           component closes over the choice once, per build.
         */
         const promptMode = config.prompt;
-        const ConfiguredLayout = (parts) => (_jsx(LoopPageLayout, { parts: parts, promptMode: promptMode }));
+        const pageSize = config.pageSize;
+        floatingStance =
+            config.promptAnchor === 'bottom' ? 'floating-bottom' : 'floating-top';
+        if (promptMode === 'floating') {
+            promptStance.value = floatingStance;
+        }
+        const ConfiguredLayout = (parts) => (_jsx(LoopPageLayout, { parts: parts, promptMode: promptMode, pageSize: pageSize }));
         ctx.contribute(LoopChatLayout, {
             id: 'page-layout',
-            prompt: promptMode === 'floating' ? 'floating-top' : 'docked-top',
+            prompt: promptMode === 'floating' ? floatingStance : 'docked-top',
+            // Live only for the card: its display modes move the composer.
+            promptStance: promptMode === 'floating' ? promptStance : undefined,
             Component: ConfiguredLayout,
         }, { id: 'page-layout' });
         // The turn panel is configuration-dependent, so it is contributed here
@@ -73,6 +142,17 @@ export const LoopPageLayoutPlugin = definePlugin({
                     slot: LoopSlots.header,
                     Component: ConversationToggle,
                 },
+                // The display modes, in the floating card's footer — and only
+                // there: a docked composer has none to pick.
+                ...(promptMode === 'floating'
+                    ? [
+                        {
+                            id: 'page-layout-chat-mode',
+                            slot: LoopSlots.promptAction,
+                            Component: ChatModeAction,
+                        },
+                    ]
+                    : []),
             ],
         };
     },

package/lib/loop/presets.d.ts

@@ -22,6 +22,7 @@
 import { type PluginRef } from '@datalayer/reactor';
 import { type AgentsConfig, type SandboxTarget } from './plugins/agents';
 import { type ChatPluginConfig } from './plugins/chat';
+import { type PageSize } from './plugins/page-layout';
 export type LoopPresetOptions = {
     /** Where the agent runtimes service is. */
     serverUrl?: string;
@@ -81,6 +82,19 @@ export type LoopPresetOptions = {
      * as a draggable card over the top of the canvas.
      */
     pageLayoutPrompt?: 'docked' | 'floating';
+    /**
+     * Which edge a floating composer starts at: `top` (the default) or
+     * `bottom`. It is dragged from there either way. Only read with
+     * `pageLayoutPrompt: 'floating'`.
+     */
+    pageLayoutPromptAnchor?: 'top' | 'bottom';
+    /**
+     * The page layout's sheet: free (the default) at its reading width, or a
+     * paper — `{ format: 'letter' }`, `{ format: 'a4' }` — whose width it
+     * takes and whose height it is at least; a free `width` or `height` over
+     * either. Only read with `pageLayout`.
+     */
+    pageLayoutSize?: PageSize;
     /**
      * What the turn panel draws under the reply: the full turn footer
      * (counters, copy, dismiss — the default), `actions` only, or `none`.

package/lib/loop/presets.js

@@ -51,7 +51,7 @@ import { LoopPageLayoutPlugin } from './plugins/page-layout';
  * be installed or signed into, and the switches a demonstration wants are off.
  */
 export function loopPlugins(options = {}) {
-    const { serverUrl, target = 'browser', defaultEditor = 'notebook', showViewSelector = true, hideChatHeader = false, promptPlacement, autoFocusPrompt = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
+    const { serverUrl, target = 'browser', defaultEditor = 'notebook', showViewSelector = true, hideChatHeader = false, promptPlacement, autoFocusPrompt = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutPromptAnchor = 'top', pageLayoutSize, pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
     return [
         // The chat owns the editor beside it, so which one opens is its
         // configuration rather than the workspace's.
@@ -127,6 +127,8 @@ export function loopPlugins(options = {}) {
                     turnPanel: pageLayoutTurnPanel,
                     turnPanelFooter: pageLayoutTurnPanelFooter,
                     prompt: pageLayoutPrompt,
+                    promptAnchor: pageLayoutPromptAnchor,
+                    pageSize: pageLayoutSize,
                 }),
             ]
             : []),

package/lib/models/Deck.d.ts

@@ -0,0 +1,14 @@
+import { IItem } from './Item';
+/**
+ * A deck: a presentation described as data, on the `@datalayer/decks`
+ * engine. `spec` is the deck specification the engine renders — the
+ * item's content, the way `nbformat` is a notebook's — present when the
+ * item was read on its own and absent in a listing.
+ */
+export type IBaseDeck = IItem & {
+    spec?: any;
+};
+export type IDeck = IBaseDeck & {
+    type: 'deck';
+};
+export default IDeck;

package/lib/models/Deck.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

package/lib/models/Environment.d.ts

@@ -170,6 +170,12 @@ export interface IDatalayerEnvironment {
      * from its public page expects to find it.
      */
     fromLibrary?: boolean;
+    /**
+     * How a reader is shown an entry whose launch name is not its name: a
+     * Library entry is launched by its environment's uid, and shown as the
+     * name its owner gave it, `steps-drill`, rather than that uid (E2-19).
+     */
+    label?: string;
 }
 /**
  * A refusal, as every registry route answers one (section 10): a code, a
@@ -358,6 +364,27 @@ export interface IEnvironmentConformanceReport {
     passed: boolean;
     checks: IEnvironmentConformanceCheck[];
 }
+/** One step of a build as its workflow ran it (E2-19). */
+export interface IEnvironmentBuildStep {
+    name: string;
+    status: 'running' | 'succeeded' | 'failed' | 'skipped';
+    startedAt?: string;
+    finishedAt?: string;
+    /** For a failure: its section 10 code. */
+    code?: string;
+    message?: string;
+    /**
+     * What the step found, for a page to list rather than leave in the log:
+     * `{kind: 'egress_refused', subject: 'github.com'}` for a host the build
+     * pool's egress proxy refused.
+     */
+    findings?: IEnvironmentBuildFinding[];
+}
+/** One finding of a build's step (E2-19): what it found, and what about. */
+export interface IEnvironmentBuildFinding {
+    kind: string;
+    subject: string;
+}
 export interface IEnvironmentBuildRecord {
     uid: string;
     environmentUid: string;
@@ -367,6 +394,13 @@ export interface IEnvironmentBuildRecord {
     region: string;
     /** Counted from 1; a retry is the next attempt. */
     attempt: number;
+    /**
+     * What this build is for: `build`, or `resolve` — a build that stops once
+     * the version has its lock (PLAN_ENVS.md E1-26). Absent from a Runtimes
+     * before that, and from every build recorded before the term existed, each
+     * of which is a build.
+     */
+    kind?: string;
     /** The request's key, suffixed with the variant and region. */
     idempotencyKey: string;
     /** `queued` when created; see `TERMINAL_ENVIRONMENT_BUILD_STATUSES`. */
@@ -379,6 +413,28 @@ export interface IEnvironmentBuildRecord {
      * report with `passed: false` names the checks that failed and why.
      */
     conformanceReport?: IEnvironmentConformanceReport | Record<string, never>;
+    /**
+     * Whether the retry route takes this build: cancelled, or failed under a
+     * code another attempt can pass (section 10). Said by Runtimes with the
+     * build, so a page offers Retry only where it would be taken (E2-19).
+     * Absent from a Runtimes before 1.0.36.
+     */
+    retryable?: boolean;
+    /**
+     * The build's steps as its workflow ran them (E2-19), each kept by its
+     * name: `resolve`, `build`, `attest`, `smoke_test`… Absent from a Runtimes
+     * before 1.0.37 and from a build nothing reported for.
+     */
+    steps?: IEnvironmentBuildStep[];
+    /**
+     * What the build spent (E2-19): its minutes by the daily quota's own rule —
+     * from its claim to its end, or to now while it runs — and those minutes at
+     * its variant's rate, in credits. `metered` is false where the provider
+     * bills the owner's own account (D-8). Absent from a Runtimes before them.
+     */
+    buildMinutes?: number;
+    credits?: number;
+    metered?: boolean;
     cacheHit: boolean;
     correlationId: string;
     requestedBy: string;
@@ -481,6 +537,13 @@ export interface IEnvironmentPublicationRecord {
     publishedAt: string;
     updatedAt: string;
     snapshot: IEnvironmentPublicationSnapshot;
+    /**
+     * What a second of the snapshot's size class costs, priced by Runtimes when
+     * the publication is read (E2-15, E2-19): what a launch of it reserves by,
+     * since a stranger has no listing entry of it to read a rate from. Absent
+     * from a Runtimes before 1.0.35, and `null` for a class nothing prices.
+     */
+    burningRate?: number | null;
     /** What a conditional write names in `If-Match`. */
     etag: string;
 }
@@ -640,3 +703,57 @@ export interface IEnvironmentBuildLogPage {
     complete: boolean;
 }
 export default IEnvironment;
+/** Section 13's preview limits, per owner. */
+export interface IEnvironmentQuotaLimits {
+    concurrentBuilds: number;
+    buildMinutesPerDay: number;
+    retainedVersions: number;
+    storedGib: number;
+}
+/** What an owner stores, and how it was measured. */
+export interface IEnvironmentStoredHoldings {
+    gib: number;
+    bytes: number;
+    source: string;
+    meteredArtifacts: number;
+    unmeteredArtifacts: number;
+}
+/** What an owner holds against each limit right now. */
+export interface IEnvironmentQuotaHoldings {
+    openBuilds: number;
+    buildMinutesToday: number;
+    retainedVersions: number;
+    storage: IEnvironmentStoredHoldings;
+}
+/**
+ * An owner's build quotas and holdings, `GET /environment-quotas`: the numbers
+ * a `DL_ENV_QUOTA_EXCEEDED` refusal quotes, read before one (E2-19).
+ */
+export interface IEnvironmentQuotas {
+    ownerType: 'user' | 'organization';
+    ownerUid: string;
+    limits: IEnvironmentQuotaLimits;
+    holdings: IEnvironmentQuotaHoldings;
+}
+/**
+ * One sandbox running a version. The caller's own carries its runtime uid,
+ * its digest and why it waits, if it does — the scheduler's own words, such
+ * as `Unschedulable: 0/6 nodes are available: 4 Insufficient cpu.`; anybody
+ * else's only its phase and start, so a page counts it without naming it.
+ */
+export interface IEnvironmentVersionSandbox {
+    /** `Pending` or `Running`: Kubernetes' phase of the sandbox's pod. */
+    phase: string;
+    startedAt: string;
+    yours: boolean;
+    runtimeUid?: string;
+    digest?: string;
+    waiting?: string;
+    /** Credits a second, for the caller's own: what it burns while it runs. */
+    burningRate?: number;
+}
+/** `GET /environment-versions/{uid}/sandboxes`. */
+export interface IEnvironmentVersionSandboxes {
+    versionUid: string;
+    sandboxes: IEnvironmentVersionSandbox[];
+}

package/lib/models/ItemType.d.ts

@@ -1,2 +1,2 @@
-export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
+export type IItemType = 'assignment' | 'authoring' | 'cell' | 'content' | 'credits' | 'dataset' | 'datasource' | 'deck' | 'document' | 'documentation' | 'environment' | 'exercise' | 'growth' | 'home' | 'invite' | 'lesson' | 'library' | 'mail' | 'management' | 'notebook' | 'onboarding' | 'organization' | 'page' | 'runtime' | 'runtime-snapshot' | 'settings' | 'share' | 'space' | 'storage' | 'success' | 'support' | 'tag' | 'team' | 'usage' | 'user' | 'undefined';
 export default IItemType;

package/lib/models/Runtime.d.ts

@@ -97,6 +97,12 @@ export interface IRuntimeRecord {
      * Runtime credits reservation expiration timestamp
      */
     expired_at?: string;
+    /**
+     * Why the runtime's pod does not run yet, in Kubernetes' own words — the
+     * scheduler's `Unschedulable: 0/6 nodes are available: 4 Insufficient
+     * cpu.`, or an image that cannot be pulled — or empty once it runs.
+     */
+    waiting?: string;
 }
 /**
  * Runtime description (UI layer).

package/lib/models/SpaceItem.d.ts

@@ -1,9 +1,10 @@
 import { INotebook } from './Notebook';
 import { IDocument } from './Document';
+import { IDeck } from './Deck';
 import { ICell } from './Cell';
 import { IEnvironment } from './Environment';
 import { ILesson } from './Lesson';
 import { IExercise } from './Exercise';
 import { IAssignment } from './Assignment';
-export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument;
+export type ISpaceItem = INotebook | ICell | IEnvironment | ILesson | IExercise | IAssignment | IDocument | IDeck;
 export default ISpaceItem;

package/lib/models/environments.generated.d.ts

@@ -1,7 +1,7 @@
 /** The `$id` of the JSON Schema these types are generated from. */
 export declare const ENVIRONMENT_SCHEMA_ID = "https://datalayer.io/schemas/environments/v1alpha1/environment.json";
 /** The sha256 of the schema text these types are generated from. */
-export declare const ENVIRONMENT_SCHEMA_SHA256 = "76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201";
+export declare const ENVIRONMENT_SCHEMA_SHA256 = "df0f8dc57cd82b8b0a77727071cb9a084a64c099703a8b9747ebe0f0958fe8f0";
 /** The `apiVersion` an Environment document carries. */
 export declare const ENVIRONMENT_API_VERSION = "environments.datalayer.io/v1alpha1";
 /** The `kind` an Environment document carries. */
@@ -25,6 +25,8 @@ export interface BuildSecret {
     name: string;
 }
 export interface BuildSpec {
+    dependencyFile?: DependencyFileSpec | null;
+    image?: ImageSourceSpec | null;
     /** Default: `"packages"`. */
     source?: 'packages' | 'dependencyFile' | 'dockerfile' | 'image';
 }
@@ -35,12 +37,31 @@ export interface Compatibility {
     regions?: string[];
     variants?: VariantSet;
 }
+/** One immutable file the Environment bakes from an external source. */
+export interface ContentsBuildEntry {
+    path: string;
+    /** Pattern: `^[0-9a-f]{64}$`. */
+    sha256: string;
+    /** Minimum: 0. */
+    sizeBytes?: number | null;
+    source: string;
+}
+/** A `requirements.txt`, a `pyproject.toml` with its `uv.lock`, or a conda `environment.yml` (E3-01, E3-02). */
+export interface DependencyFileSpec {
+    /** Default: `""`. */
+    content?: string;
+    /** Default: `""`. */
+    lockContent?: string;
+    /** Default: `"requirements"`. */
+    sourceFormat?: 'requirements' | 'pyproject' | 'conda';
+}
 export interface EnvironmentSpec {
     base: Base;
     build?: BuildSpec;
     buildSecrets?: BuildSecret[];
     commands?: Commands;
     compatibility?: Compatibility;
+    contentsBuild?: ContentsBuildEntry[];
     /** Default: `"sandbox-contract/v1"`. */
     contract?: string;
     env?: Record<string, string>;
@@ -58,6 +79,13 @@ export interface FileEntry {
     /** Minimum: 0. */
     sizeBytes?: number | null;
 }
+/** An existing OCI image, imported as the build's base (E3-04). */
+export interface ImageSourceSpec {
+    /** Pattern: `^dlsec_[0-9A-Za-z]+$`. */
+    credentialSecretId?: string | null;
+    /** Default: `""`. */
+    reference?: string;
+}
 export interface Language {
     name?: 'python';
     /** Pattern: `^3\.\d+$`. */

package/lib/models/environments.generated.js

@@ -6,7 +6,7 @@
 /** The `$id` of the JSON Schema these types are generated from. */
 export const ENVIRONMENT_SCHEMA_ID = 'https://datalayer.io/schemas/environments/v1alpha1/environment.json';
 /** The sha256 of the schema text these types are generated from. */
-export const ENVIRONMENT_SCHEMA_SHA256 = '76eb8c80d1e27f7c6519946a6f7022b53a717ff2645d993b34aaa54dea658201';
+export const ENVIRONMENT_SCHEMA_SHA256 = 'df0f8dc57cd82b8b0a77727071cb9a084a64c099703a8b9747ebe0f0958fe8f0';
 /** The `apiVersion` an Environment document carries. */
 export const ENVIRONMENT_API_VERSION = 'environments.datalayer.io/v1alpha1';
 /** The `kind` an Environment document carries. */

package/lib/models/index.d.ts

@@ -6,6 +6,7 @@ export * from './CodeSandboxSnapshot';
 export * from './CodeSandboxSnapshotDTO';
 export * from './Content';
 export * from './Course';
+export * from './Deck';
 export * from './Document';
 export * from './Environment';
 export * from './EnvironmentDTO';