@datalayer/core 1.2.28 → 1.2.29

package/lib/hooks/useMcp.d.ts

@@ -1,4 +1,4 @@
-import { type McpTaskAnswered, type McpActivity, type McpActivityFilters, type McpAuditFilters, type McpBindingListFilters, type McpGatewayVersion, type McpMetricsFilters, type McpMetricsSnapshot, type McpOrganizationOverview, type McpOrganizationUsage, type McpOrganizationOverviewFilters, type McpPolicyFilters, type McpRunLogs, type McpRunTrace, type McpTaskEvent, type McpTaskListFilters, type McpWorkerList, type McpWorkflowsHealth } from '../api/mcp';
+import { type McpTaskAnswered, type McpTaskCancelled, type McpActivity, type McpActivityFilters, type McpAuditFilters, type McpBindingListFilters, type McpGatewayVersion, type McpMetricsFilters, type McpMetricsSnapshot, type McpOrganizationOverview, type McpOrganizationUsage, type McpOrganizationOverviewFilters, type McpPolicyFilters, type McpRunLogs, type McpRunTrace, type McpTaskEvent, type McpTaskListFilters, type McpWorkerList, type McpWorkflowsHealth } from '../api/mcp';
 import { type ConnectedAgent } from '../api/iam/connectedAgents';
 import { type OrganizationTeam } from '../api/iam/organizationTeams';
 import { setAuditSettings, type McpAuditSettings } from '../api/iam/mcpAuditSettings';
@@ -28,7 +28,7 @@ export declare const useTaskEvents: (taskUid?: string, options?: {
     enabled?: boolean;
     onEvent?: (event: McpTaskEvent) => void;
 }) => void;
-export declare const useCancelTask: () => import("@tanstack/react-query").UseMutationResult<McpTask, Error, string, unknown>;
+export declare const useCancelTask: () => import("@tanstack/react-query").UseMutationResult<McpTaskCancelled, Error, string, unknown>;
 export declare const useAnswerTask: () => import("@tanstack/react-query").UseMutationResult<McpTaskAnswered, Error, {
     taskUid: string;
     input: Record<string, unknown>;

package/lib/hooks/useMcp.js

@@ -124,8 +124,11 @@ export const useCancelTask = () => {
     const mcpUrl = useMcpServerUrl();
     return useMutation({
         mutationFn: taskUid => cancelTask(token ?? '', taskUid, mcpUrl),
-        onSuccess: task => {
-            queryClient.setQueryData(queryKeys.mcp.task(task.uid), task);
+        // The gateway answers `{uid, cancelled, status}`, not the task: read the
+        // task again rather than caching that reply in its place (the run page
+        // lost its tool and output on a cancel, as it did on an answer).
+        onSuccess: (_cancelled, taskUid) => {
+            queryClient.invalidateQueries({ queryKey: queryKeys.mcp.task(taskUid) });
             queryClient.invalidateQueries({ queryKey: queryKeys.mcp.tasks() });
             queryClient.invalidateQueries({ queryKey: queryKeys.mcp.activity() });
         },

package/lib/hooks/useNavigate.d.ts

@@ -5,8 +5,15 @@ export interface NavigateOptions {
     state?: unknown;
     /** Open the destination in a new tab and leave this one where it is. */
     newTab?: boolean;
-    /** Scroll to the top on arrival; on by default. */
-    scroll?: boolean;
+    /**
+     * Where the reader lands: the top of the page when unsaid or `true`; an
+     * element, by its id (with or without its `#`), scrolled into view once
+     * the page has it; `false` to leave the scroll where it is. The page and
+     * every scroll panel marked `data-scroll-root` are scrolled, so a layout
+     * that scrolls inside its own panel lands at the top too (the user,
+     * 6 November 2026: the Trust page opened scrolled down).
+     */
+    scroll?: boolean | string;
     /**
      * Close the layout's side portals on the way; on by default. Only the
      * history API host has them.
@@ -40,5 +47,12 @@ export type Navigate = (to: NavigateTarget, optionsOrEvent?: NavigateOptions | N
 export declare function isNewTabClick(event: NavigateEvent): boolean;
 /** Open `to` in a new tab, without handing it this window. */
 export declare function openInNewTab(to: string): void;
+/**
+ * Scroll on arrival: to the top (`undefined` or `true`), to an element by
+ * its id (a string, `#` or not), or nowhere (`false`). Done now and again
+ * on the next frames, since the page navigated to renders after the call
+ * and a layout's panel keeps its scroll across pages.
+ */
+export declare function scrollOnArrival(target: boolean | string | undefined): void;
 export declare const useNavigate: () => Navigate;
 export default useNavigate;

package/lib/hooks/useNavigate.js

@@ -62,6 +62,68 @@ function isLinkTo(event, to) {
         return false;
     }
 }
+/**
+ * The scroll panels a layout marks, beside the page itself: `data-scroll-root`,
+ * or the `dla-scroll-root` class for a component that passes a class name but
+ * no data attribute (Primer's `PageLayout.Content`, whose own element is the
+ * one that scrolls; 9 November 2026, a card on /agentspecs/identities opened
+ * its page scrolled down).
+ */
+const scrollRoots = () => Array.from(document.querySelectorAll('[data-scroll-root], .dla-scroll-root'));
+const nextFrame = (run) => {
+    if (typeof requestAnimationFrame === 'function') {
+        requestAnimationFrame(run);
+    }
+    else {
+        setTimeout(run, 16);
+    }
+};
+/** How many frames an element is waited for: a page loaded lazily takes a few. */
+const ARRIVAL_FRAMES = 60;
+/**
+ * Scroll on arrival: to the top (`undefined` or `true`), to an element by
+ * its id (a string, `#` or not), or nowhere (`false`). Done now and again
+ * on the next frames, since the page navigated to renders after the call
+ * and a layout's panel keeps its scroll across pages.
+ */
+export function scrollOnArrival(target) {
+    if (target === false || typeof document === 'undefined') {
+        return;
+    }
+    const id = typeof target === 'string' ? target.replace(/^#/, '') : '';
+    if (!id) {
+        const toTop = () => {
+            window.scrollTo(0, 0);
+            document.body.scrollTop = 0;
+            document.documentElement.scrollTop = 0;
+            for (const root of scrollRoots()) {
+                root.scrollTop = 0;
+            }
+        };
+        toTop();
+        let frames = 0;
+        const again = () => {
+            toTop();
+            if (++frames < 2) {
+                nextFrame(again);
+            }
+        };
+        nextFrame(again);
+        return;
+    }
+    let tries = 0;
+    const attempt = () => {
+        const element = document.getElementById(id);
+        if (element) {
+            element.scrollIntoView({ block: 'start' });
+            return;
+        }
+        if (++tries < ARRIVAL_FRAMES) {
+            nextFrame(attempt);
+        }
+    };
+    attempt();
+}
 const isEvent = (value) => !!value && typeof value.preventDefault === 'function';
 function parseCall(optionsOrEvent, third, fourth) {
     if (isEvent(optionsOrEvent)) {
@@ -129,10 +191,7 @@ export const useNavigate = () => {
             return;
         }
         event?.preventDefault();
-        if (options.scroll !== false) {
-            window.scrollTo(0, 0);
-            document.body.scrollTop = 0;
-        }
+        scrollOnArrival(options.scroll);
         // Where the reader is now, for the shell they are in. A new tab and a
         // step back through history are both already past by here. Only for
         // somebody signed in: the shells are theirs, and a page a visitor read
@@ -152,7 +211,8 @@ export const useNavigate = () => {
         nativeNavigate(to, {
             replace: options.replace,
             state: options.state,
-            scroll: options.scroll,
+            // Scrolled above, after the page has rendered.
+            scroll: false,
         });
     }, [rrNavigate, nativeNavigate, layoutStore]);
 };

package/lib/models/Usage.d.ts

@@ -8,6 +8,15 @@ interface IResources {
     memory: string;
     'nvidia.com/gpu'?: string;
 }
+/**
+ * What ran and hosted the agent a usage record is for (`runtime_engine`):
+ * a Datalayer runtime, kagent, or AWS AgentCore in an organization's AWS
+ * account. IAM records it from the launch; a record from before, or of a
+ * call with no agent runtime behind it, has none.
+ */
+export type UsageRuntimeEngine = 'datalayer' | 'kagent' | 'agentcore';
+/** The engine a raw record says, or `undefined` when it says none (or one not known). */
+export declare const usageRuntimeEngineOf: (value: unknown) => UsageRuntimeEngine | undefined;
 export interface IRawUsage {
     account_uid: string;
     resource_uid: string;
@@ -26,6 +35,7 @@ export interface IRawUsage {
     usage_period_label?: string;
     usage_period_start?: string;
     usage_period_end?: string;
+    runtime_engine?: UsageRuntimeEngine | null;
     metadata: Map<string, string>;
 }
 export declare const asUsage: (u: any) => {
@@ -46,6 +56,7 @@ export declare const asUsage: (u: any) => {
     usagePeriodLabel: any;
     usagePeriodStart: Date | undefined;
     usagePeriodEnd: Date | undefined;
+    runtimeEngine: UsageRuntimeEngine | undefined;
     metadata: Map<string, string>;
 };
 export interface IUsage {
@@ -66,6 +77,8 @@ export interface IUsage {
     usagePeriodLabel?: string;
     usagePeriodStart?: Date;
     usagePeriodEnd?: Date;
+    /** What ran and hosted its agent; absent on a record that says none. */
+    runtimeEngine?: UsageRuntimeEngine;
     metadata: Map<string, string>;
 }
 export {};

package/lib/models/Usage.js

@@ -2,6 +2,10 @@
  * Copyright (c) 2023-2025 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
+/** The engine a raw record says, or `undefined` when it says none (or one not known). */
+export const usageRuntimeEngineOf = (value) => value === 'datalayer' || value === 'kagent' || value === 'agentcore'
+    ? value
+    : undefined;
 export const asUsage = (u) => {
     const usagePeriodKey = u.usage_period_key;
     const usagePeriodLabel = u.usage_period_label;
@@ -25,6 +29,7 @@ export const asUsage = (u) => {
         usagePeriodLabel,
         usagePeriodStart: usagePeriodStart ? new Date(usagePeriodStart) : undefined,
         usagePeriodEnd: usagePeriodEnd ? new Date(usagePeriodEnd) : undefined,
+        runtimeEngine: usageRuntimeEngineOf(u.runtime_engine),
         metadata: new Map(Object.entries(u.metadata ?? {})),
     };
 };

package/lib/otel/client/OtelClient.d.ts

@@ -1,5 +1,53 @@
 import type { OtelSpan, OtelLog, OtelMetric, OtelQueryResult } from '../types';
 import type { OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable } from '../hooks';
+export interface FetchTokenUsageOptions {
+    /** The window, in hours back from now (24 by default). */
+    hours?: number;
+    /** Only these services (runtimes); every one by default. */
+    serviceNames?: string[];
+    accountUid?: string;
+}
+/** What `GET /api/otel/v1/metrics/tokens` answers. */
+export interface OtelTokenUsage {
+    total: number;
+    prompt: number;
+    completion: number;
+    by_service: Array<{
+        service_name: string;
+        total: number;
+        prompt: number;
+        completion: number;
+    }>;
+    window?: {
+        start: number;
+        end: number;
+        hours: number;
+    };
+    /**
+     * When telemetry last reached the store, whatever the account: `at` in
+     * unix nanoseconds, from rows ingested since the service started
+     * (`ingest`) or from its newest stored file (`files`); `null` with the
+     * `reason` when nothing was ever stored or the time could not be read.
+     * Absent from a service that does not say it.
+     */
+    last_received?: OtelLastReceived;
+    /**
+     * The same for the asked account, known only from what arrived since the
+     * service started (`since`, unix nanoseconds): `at` is `null`, with a
+     * `reason`, until rows of the account arrive.
+     */
+    account_last_received?: OtelAccountLastReceived;
+}
+export interface OtelLastReceived {
+    at: number | null;
+    source: 'ingest' | 'files' | null;
+    reason: string | null;
+}
+export interface OtelAccountLastReceived {
+    at: number | null;
+    since: number;
+    reason: string | null;
+}
 export interface OtelClientOptions {
     /**
      * Base URL of the OTEL service.
@@ -65,6 +113,14 @@ export declare class OtelClient {
         data: OtelMetric[];
         count: number;
     }>;
+    /**
+     * The tokens agents counted over the last `hours` (24 by default): total,
+     * prompt and completion, overall and per service, in one request — the
+     * service reads each counter's increase over the window in one scan. The
+     * answer also says when telemetry last reached the store (`last_received`),
+     * so a total of 0 can be told from a store that stopped receiving.
+     */
+    fetchTokenUsage(options?: FetchTokenUsageOptions): Promise<OtelTokenUsage>;
     /** Sum all values for one metric name, with optional service filter. */
     fetchMetricTotal(metricName: string, options?: FetchMetricTotalOptions): Promise<number>;
     /** List known service names observed in traces. */

package/lib/otel/client/OtelClient.js

@@ -177,6 +177,31 @@ export class OtelClient {
             : [];
         return { data: normalized, count: normalized.length };
     }
+    /**
+     * The tokens agents counted over the last `hours` (24 by default): total,
+     * prompt and completion, overall and per service, in one request — the
+     * service reads each counter's increase over the window in one scan. The
+     * answer also says when telemetry last reached the store (`last_received`),
+     * so a total of 0 can be told from a store that stopped receiving.
+     */
+    async fetchTokenUsage(options = {}) {
+        const params = new URLSearchParams({ hours: String(options.hours ?? 24) });
+        for (const name of options.serviceNames ?? []) {
+            params.append('service_name', name);
+        }
+        if (options.accountUid)
+            params.set('account_uid', options.accountUid);
+        const resp = await otelFetch(`${this.baseUrl}/api/otel/v1/metrics/tokens?${params}`, this.token, this.userUid);
+        return {
+            total: Number(resp.total ?? 0),
+            prompt: Number(resp.prompt ?? 0),
+            completion: Number(resp.completion ?? 0),
+            by_service: Array.isArray(resp.by_service) ? resp.by_service : [],
+            window: resp.window,
+            last_received: resp.last_received,
+            account_last_received: resp.account_last_received,
+        };
+    }
     /** Sum all values for one metric name, with optional service filter. */
     async fetchMetricTotal(metricName, options = {}) {
         const { serviceName, limit = 500, fallbackWithoutService = true, accountUid, } = options;

package/lib/otel/client/index.d.ts

@@ -1,2 +1,2 @@
 export { OtelClient, createOtelClient } from './OtelClient';
-export type { OtelClientOptions, FetchTracesOptions, FetchLogsOptions, FetchMetricsOptions, FetchMetricTotalOptions, OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable, } from './OtelClient';
+export type { OtelClientOptions, FetchTracesOptions, FetchLogsOptions, FetchMetricsOptions, FetchMetricTotalOptions, FetchTokenUsageOptions, OtelTokenUsage, OtelLastReceived, OtelAccountLastReceived, OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable, } from './OtelClient';

package/lib/otel/index.d.ts

@@ -20,7 +20,7 @@ export type { ResolvedOtelAuth } from './auth';
 export { useOtelTraces, useOtelTrace, useOtelLogs, useOtelMetrics, useOtelServices, useOtelStats, useOtelQuery, useOtelSystem, useOtelWebSocket, setOtelOnUnauthorized, } from './hooks';
 export type { OtelWsMessage, OtelWsCallbacks, OtelSystemData, OtelSystemProcess, OtelSystemDisk, OtelSystemTable, } from './hooks';
 export { OtelClient, createOtelClient } from './client';
-export type { OtelClientOptions, FetchTracesOptions, FetchLogsOptions, FetchMetricsOptions, FetchMetricTotalOptions, } from './client';
+export type { OtelClientOptions, FetchTracesOptions, FetchLogsOptions, FetchMetricsOptions, FetchMetricTotalOptions, FetchTokenUsageOptions, OtelTokenUsage, OtelLastReceived, OtelAccountLastReceived, } from './client';
 export { OtelLive } from './views';
 export { OtelTracesList } from './views';
 export { OtelSpanDetail } from './views';

package/lib/otel/views/OtelLive.js

@@ -292,7 +292,7 @@ export const OtelLive = ({ baseUrl = getOtelConsumeUrl(), wsBaseUrl, token, auto
                                 ? tracesLoading
                                 : signal === 'logs'
                                     ? logsLoading
-                                    : metricsLoading }) }), _jsx(Box, { pr: 2, flexShrink: 0, children: _jsx(Label, { variant: wsConnected ? 'success' : 'secondary', size: "small", children: wsConnected ? '● Live' : '○ Polling' }) })] }), timelineBounds && rangeStart && rangeEnd && (_jsx(Box, { px: 3, pt: 2, pb: 1, borderBottom: "1px solid", borderColor: "border.default", bg: "canvas.subtle", flexShrink: 0, position: "relative", zIndex: 0, children: _jsx(OtelTimelineRangeSlider, { timelineStart: timelineBounds.start, timelineEnd: timelineBounds.end, selectedStart: rangeStart, selectedEnd: rangeEnd, onRangeChange: handleRangeChange, histogram: histogram, height: 48, tickCount: 6 }) })), _jsxs(Box, { display: "flex", flex: 1, minHeight: 0, overflow: "hidden", children: [_jsxs(Box, { display: "flex", flexDirection: "column", flex: hasDetail ? '0 0 55%' : '1 1 100%', minHeight: 0, overflow: "hidden", children: [signal === 'traces' && (_jsx(OtelTracesList, { spans: filteredTraces, loading: tracesLoading, selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect })), signal === 'logs' && (_jsx(OtelLogsList, { logs: filteredLogs, loading: logsLoading, selectedLogIndex: selectedLogIdx, onSelectLog: handleLogSelect })), signal === 'metrics' && (_jsx(OtelMetricsList, { metrics: filteredMetrics, loading: metricsLoading }))] }), hasDetail && (_jsxs(Box, { flex: "0 0 45%", minHeight: 0, overflow: "auto", borderLeft: "1px solid", borderColor: "border.default", children: [signal === 'traces' && selectedSpan && (_jsx(OtelSpanDetail, { span: selectedSpan, traceSpans: traceSpans ?? undefined, onClose: handleCloseDetail })), signal === 'logs' && selectedLogIdx !== null && logs && (_jsxs(Box, { p: 3, children: [_jsxs(Box, { display: "flex", justifyContent: "space-between", mb: 3, children: [_jsx(Text, { sx: { fontWeight: 'bold', fontSize: 2 }, children: "Log Detail" }), _jsx(Button, { size: "small", variant: "invisible", onClick: handleCloseDetail, children: "\u2715" })] }), _jsx(Box, { as: "pre", m: 0, fontSize: 1, fontFamily: "mono", whiteSpace: "pre-wrap", wordBreak: "break-word", children: JSON.stringify(logs[selectedLogIdx], null, 2) })] }))] }))] }), signal === 'traces' && selectedSpan && spanTree.length > 0 && (_jsxs(_Fragment, { children: [_jsxs(Box, { display: "flex", gap: 1, px: 3, py: 1, bg: "canvas.subtle", borderTop: "1px solid", borderColor: "border.default", flexShrink: 0, children: [_jsx(Button, { size: "small", variant: bottomPane === 'timeline' ? 'primary' : 'invisible', leadingVisual: ClockIcon, onClick: () => toggleBottomPane('timeline'), children: "Timeline" }), _jsx(Button, { size: "small", variant: bottomPane === 'tree' ? 'primary' : 'invisible', leadingVisual: GitBranchIcon, onClick: () => toggleBottomPane('tree'), children: "Span Tree" })] }), bottomPane && (_jsxs(Box, { height: 260, overflow: "auto", borderTop: "1px solid", borderColor: "border.default", flexShrink: 0, children: [bottomPane === 'timeline' && (_jsx(OtelTimeline, { spans: traceSpans ?? [], selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect })), bottomPane === 'tree' && (_jsx(OtelSpanTree, { spans: spanTree, selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect, defaultExpandDepth: 3 }))] }))] }))] }));
+                                    : metricsLoading }) }), wsConnected ? null : (_jsx(Box, { pr: 2, flexShrink: 0, children: _jsx(Label, { variant: "secondary", size: "small", children: "\u25CB Polling" }) }))] }), timelineBounds && rangeStart && rangeEnd && (_jsx(Box, { px: 3, pt: 2, pb: 1, borderBottom: "1px solid", borderColor: "border.default", bg: "canvas.subtle", flexShrink: 0, position: "relative", zIndex: 0, children: _jsx(OtelTimelineRangeSlider, { timelineStart: timelineBounds.start, timelineEnd: timelineBounds.end, selectedStart: rangeStart, selectedEnd: rangeEnd, onRangeChange: handleRangeChange, histogram: histogram, height: 48, tickCount: 6 }) })), _jsxs(Box, { display: "flex", flex: 1, minHeight: 0, overflow: "hidden", children: [_jsxs(Box, { display: "flex", flexDirection: "column", flex: hasDetail ? '0 0 55%' : '1 1 100%', minHeight: 0, overflow: "hidden", children: [signal === 'traces' && (_jsx(OtelTracesList, { spans: filteredTraces, loading: tracesLoading, selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect })), signal === 'logs' && (_jsx(OtelLogsList, { logs: filteredLogs, loading: logsLoading, selectedLogIndex: selectedLogIdx, onSelectLog: handleLogSelect })), signal === 'metrics' && (_jsx(OtelMetricsList, { metrics: filteredMetrics, loading: metricsLoading }))] }), hasDetail && (_jsxs(Box, { flex: "0 0 45%", minHeight: 0, overflow: "auto", borderLeft: "1px solid", borderColor: "border.default", children: [signal === 'traces' && selectedSpan && (_jsx(OtelSpanDetail, { span: selectedSpan, traceSpans: traceSpans ?? undefined, onClose: handleCloseDetail })), signal === 'logs' && selectedLogIdx !== null && logs && (_jsxs(Box, { p: 3, children: [_jsxs(Box, { display: "flex", justifyContent: "space-between", mb: 3, children: [_jsx(Text, { sx: { fontWeight: 'bold', fontSize: 2 }, children: "Log Detail" }), _jsx(Button, { size: "small", variant: "invisible", onClick: handleCloseDetail, children: "\u2715" })] }), _jsx(Box, { as: "pre", m: 0, fontSize: 1, fontFamily: "mono", whiteSpace: "pre-wrap", wordBreak: "break-word", children: JSON.stringify(logs[selectedLogIdx], null, 2) })] }))] }))] }), signal === 'traces' && selectedSpan && spanTree.length > 0 && (_jsxs(_Fragment, { children: [_jsxs(Box, { display: "flex", gap: 1, px: 3, py: 1, bg: "canvas.subtle", borderTop: "1px solid", borderColor: "border.default", flexShrink: 0, children: [_jsx(Button, { size: "small", variant: bottomPane === 'timeline' ? 'primary' : 'invisible', leadingVisual: ClockIcon, onClick: () => toggleBottomPane('timeline'), children: "Timeline" }), _jsx(Button, { size: "small", variant: bottomPane === 'tree' ? 'primary' : 'invisible', leadingVisual: GitBranchIcon, onClick: () => toggleBottomPane('tree'), children: "Span Tree" })] }), bottomPane && (_jsxs(Box, { height: 260, overflow: "auto", borderTop: "1px solid", borderColor: "border.default", flexShrink: 0, children: [bottomPane === 'timeline' && (_jsx(OtelTimeline, { spans: traceSpans ?? [], selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect })), bottomPane === 'tree' && (_jsx(OtelSpanTree, { spans: spanTree, selectedSpanId: selectedSpan?.span_id, onSelectSpan: handleSpanSelect, defaultExpandDepth: 3 }))] }))] }))] }));
 };
 // ── Client-side filter helpers ──────────────────────────────────────
 function filterSpans(spans, q) {

package/lib/state/substates/LayoutState.js

@@ -5,6 +5,23 @@
 import { createStore } from 'zustand/vanilla';
 import { useStore } from 'zustand';
 import { registerSessionState } from '../sessionEnd.js';
+/**
+ * Whether an update is about the entity the layout holds. An update naming
+ * another space or organization (by `uid`, else `id`) replaces the one held:
+ * merged over it, the fields the new one does not carry (an organization's
+ * handle, a team) stayed from the one left. An update naming none, or one
+ * naming the same, is merged onto what is held.
+ */
+const entityUid = (entity) => {
+    const record = entity;
+    const uid = record?.uid ?? record?.id;
+    return typeof uid === 'string' && uid.trim() ? uid.trim() : undefined;
+};
+const sameEntity = (held, update) => {
+    const heldUid = entityUid(held);
+    const updateUid = entityUid(update);
+    return !heldUid || !updateUid || heldUid === updateUid;
+};
 /**
  * Name of the cookie holding the space last selected by the user.
  *
@@ -25,7 +42,9 @@ const readSpaceContextCookie = () => {
     }
     try {
         const parsed = JSON.parse(decodeURIComponent(match[1]));
-        if (!parsed || typeof parsed !== 'object' || typeof parsed.id !== 'string') {
+        if (!parsed ||
+            typeof parsed !== 'object' ||
+            typeof parsed.id !== 'string') {
             return undefined;
         }
         return {
@@ -102,7 +121,9 @@ export const layoutStore = createStore((set, get) => ({
         return {
             organization: organization
                 ? {
-                    ...state.organization,
+                    ...(sameEntity(state.organization, organization)
+                        ? state.organization
+                        : undefined),
                     ...organization,
                 }
                 : undefined,
@@ -121,7 +142,7 @@ export const layoutStore = createStore((set, get) => ({
     updateLayoutSpace: (space) => set((state) => {
         const next = space
             ? {
-                ...state.space,
+                ...(sameEntity(state.space, space) ? state.space : undefined),
                 ...space,
             }
             : undefined;

package/lib/state/substates/NavigationState.d.ts

@@ -15,7 +15,7 @@
  * `datalayer-research` organization, at `/research` (the public papers, read
  * signed in, at `/research/papers/…` beside them).
  */
-export type NavigationView = 'studio' | 'home' | 'agentify' | 'research' | 'admin' | 'apps';
+export type NavigationView = 'studio' | 'home' | 'spaces' | 'agentify' | 'research' | 'admin' | 'apps';
 /** The shells, and where each one opens when it has not been visited. */
 export declare const NAVIGATION_VIEW_HOMES: Record<NavigationView, string>;
 /** Well-known view identifiers for {@link NavigationState.tabsByView}. */
@@ -77,13 +77,21 @@ export declare function isRememberableRoute(route: string): boolean;
  */
 export declare function isHostedAppRoute(route: string): boolean;
 /**
- * Whether a page belongs to no shell: the settings, the documentation and
- * the decks.
+ * Whether a page belongs to no shell: the settings, the documentation, the
+ * presentations and the agentspecs catalogue (since 8 November 2026: reached
+ * from an agent's picker on /agents/new, its env var's page swapped the
+ * Sessions sidebar for the Studio's).
  *
  * They are read from whichever shell the reader is in — its sidebar stays
  * beside them and the header's selector does not move — so they are never a
  * shell's own page: opening one does not change the shell, and no shell
  * returns to one.
+ *
+ * The presentations are `/decks/<collection>/<slug>` and their list,
+ * `/presentations`. Bare `/decks` is not one of them: it is the selected
+ * space's decks table, a page of the Spaces shell (the user, 12 November
+ * 2026). Neutral, it took the current shell whenever one was given, and the
+ * Sessions sidebar stayed beside it.
  */
 export declare function isShellNeutralRoute(route: string): boolean;
 /**

package/lib/state/substates/NavigationState.js

@@ -38,6 +38,9 @@ export const NAVIGATION_VIEW_HOMES = {
     // of its own to be sent to. It was `/power` until 2026-10-09, when the
     // shell took the name it is called by everywhere else.
     home: '/platform',
+    // The spaces and what they hold: the Workspace of the Sessions shell,
+    // a shell of its own since 9 November 2026.
+    spaces: '/spaces',
     agentify: '/agentify',
     // The research areas and their spaces.
     research: '/research',
@@ -60,6 +63,7 @@ const FORMER_TABS_KEY = 'datalayer_view_tabs';
 const COOKIE_MAX_AGE_DAYS = 365;
 const isView = (value) => value === 'studio' ||
     value === 'home' ||
+    value === 'spaces' ||
     value === 'agentify' ||
     value === 'research' ||
     value === 'admin' ||
@@ -243,17 +247,26 @@ export function isHostedAppRoute(route) {
             (segments.length === 4 && segments[2] === 'preview')));
 }
 /**
- * Whether a page belongs to no shell: the settings, the documentation and
- * the decks.
+ * Whether a page belongs to no shell: the settings, the documentation, the
+ * presentations and the agentspecs catalogue (since 8 November 2026: reached
+ * from an agent's picker on /agents/new, its env var's page swapped the
+ * Sessions sidebar for the Studio's).
  *
  * They are read from whichever shell the reader is in — its sidebar stays
  * beside them and the header's selector does not move — so they are never a
  * shell's own page: opening one does not change the shell, and no shell
  * returns to one.
+ *
+ * The presentations are `/decks/<collection>/<slug>` and their list,
+ * `/presentations`. Bare `/decks` is not one of them: it is the selected
+ * space's decks table, a page of the Spaces shell (the user, 12 November
+ * 2026). Neutral, it took the current shell whenever one was given, and the
+ * Sessions sidebar stayed beside it.
  */
 export function isShellNeutralRoute(route) {
     const path = pathOf(route);
-    return ['/settings', '/docs', '/decks'].some(prefix => path === prefix || path.startsWith(`${prefix}/`));
+    return (path.startsWith('/decks/') ||
+        ['/settings', '/docs', '/presentations', '/agentspecs'].some(prefix => path === prefix || path.startsWith(`${prefix}/`)));
 }
 /**
  * The shell a route belongs to, read off its first segment.
@@ -275,8 +288,8 @@ export function viewForRoute(route, current) {
         return current;
     }
     // The root is the Studio: what a signed-in reader opens on. The settings
-    // are read from it too, with its sidebar beside them — and so is the
-    // agentspecs catalogue, the specs an app is composed from.
+    // and the agentspecs catalogue are read from it too, with its sidebar
+    // beside them, when no shell is current.
     if (path === '/' ||
         path === '/studio' ||
         path.startsWith('/studio/') ||
@@ -286,6 +299,10 @@ export function viewForRoute(route, current) {
         path.startsWith('/agentspecs/')) {
         return 'studio';
     }
+    if (SPACES_SHELL_ROUTES.some(prefix => path === prefix || path.startsWith(`${prefix}/`)) ||
+        SPACES_SHELL_EXACT_ROUTES.includes(path)) {
+        return 'spaces';
+    }
     if (path === '/agentify' || path.startsWith('/agentify/')) {
         return 'agentify';
     }
@@ -315,6 +332,32 @@ export function viewForRoute(route, current) {
     }
     return 'home';
 }
+/**
+ * The Spaces shell's pages: the spaces, then the work they hold — what was
+ * the Workspace of the Sessions sidebar until 9 November 2026, when it became
+ * a shell of its own.
+ */
+const SPACES_SHELL_ROUTES = [
+    '/spaces',
+    '/items',
+    // The Library, public and private, beside the Spaces sidebar (the user,
+    // 9 November 2026).
+    '/library',
+    '/shared',
+    '/notebooks',
+    '/documents',
+    '/cells',
+    // The selected space's spreadsheets (the user, 12 November 2026).
+    '/spreadsheets',
+    '/datasets',
+    '/contents',
+];
+/**
+ * The selected space's decks, `/decks` itself only (the user, 12 November
+ * 2026): `/decks/<collection>/<slug>` are presentations, drawn by their own
+ * page, not the Spaces shell's.
+ */
+const SPACES_SHELL_EXACT_ROUTES = ['/decks'];
 /**
  * `/<account>/<space>/<kind>[/…]` for the kinds a space shows beside the
  * Agentify sidebar — decks, spreadsheets (Cells), courses and what a course

package/lib/views/mcp/McpObservability.d.ts

@@ -24,6 +24,8 @@ import type { JSX } from 'react';
 import type { McpWorkflowsHealth } from '../../api/mcp/operations';
 import { type McpErrorStateFn, type McpRoutes } from './types';
 export type McpObservabilityPane = 'runs' | 'live' | 'metrics';
+/** Every pane, in the order the switcher shows them. */
+export declare const ALL_PANES: readonly McpObservabilityPane[];
 export interface McpObservabilityProps {
     /** The application's words for a failed request. */
     errorState: McpErrorStateFn;
@@ -32,6 +34,13 @@ export interface McpObservabilityProps {
     /** Which pane is open; the address owns it. */
     pane: McpObservabilityPane;
     onPaneChange: (pane: McpObservabilityPane) => void;
+    /**
+     * The panes offered, in this order; all three when unsaid. The Live pane
+     * reads the platform's own engine and is a platform administrator's
+     * (the user, 6 November 2026): an application shows an account its runs
+     * and metrics, and its admin page the live engine.
+     */
+    panes?: readonly McpObservabilityPane[];
     /** The run to open, when the address names one. */
     taskUid?: string;
     /** The trace to open — what a synchronous call leaves behind. */
@@ -67,13 +76,23 @@ export declare const stageOf: (name: string) => string;
  * second is usually a problem with the network between them, and sending
  * somebody to the wrong one costs an hour.
  *
- * A healthy engine with a backlog is still healthy, and says so with the
- * backlog beside it: a queue is a queue, not a fault.
+ * An engine taking work is healthy; a queue it was told to run that nobody
+ * serves is drawn as a warning beside it — work sent there is accepted and
+ * never done. The engine reports no backlog of its own (DBOS's pending and
+ * enqueued are both `running`), so what is running is counted among the
+ * newest runs it lists, and said as such.
  */
 export declare const engineLook: (health: McpWorkflowsHealth | undefined, failed: boolean) => {
     label: string;
     variant: "success" | "attention" | "danger" | "secondary";
     note: string;
 };
-export declare const McpObservability: ({ errorState, routes, pane, onPaneChange, taskUid, traceId, onSelect, agent, org, showTitle, }: McpObservabilityProps) => JSX.Element;
+/** Each queue the engine polls, with how many of its newest runs are running there and the oldest of them. */
+export declare const engineQueues: (health: McpWorkflowsHealth | undefined, now?: number) => {
+    name: string;
+    running: number;
+    oldestSeconds?: number;
+    served: boolean;
+}[];
+export declare const McpObservability: ({ errorState, routes, pane, onPaneChange, panes, taskUid, traceId, onSelect, agent, org, showTitle, }: McpObservabilityProps) => JSX.Element;
 export default McpObservability;