@datalayer/agent-runtimes 1.3.28 → 1.3.30

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

@@ -8,13 +8,13 @@ import { computed, signal } from '@datalayer/reactor';
 const NO_STANCE = signal(undefined);
 import { useContributions, useSignalValue, useGate, useReactorPlatform, ReactorLazy, ReactorSlot, useSlotComponents, } from '@datalayer/reactor/react';
 import { ChatBase } from '../../../chat/base/ChatBase';
-import { readServerCatalogue } from '../../../chat/base/modelChoice';
+import { offeredModels as offeredModelsFor, readServerCatalogue, } from '../../../chat/base/modelChoice';
 import { SUGGESTION_CHIP_WIDTH } from '../../../chat/display/EmptyState';
 import { AnonymousKeyExpired } from '@datalayer/core/lib/components/anonymous/AnonymousKeyExpired';
 import { useAnonymousSessionStore } from '../../../runtimes/browser/anonymousToken';
 import { browserProtocolConfig } from '../../../runtimes/browser';
 import { useBrowserInference } from '../../../hooks/useBrowserInference';
-import { getAgentspecs } from '../../../specs/agents';
+import { agentInstructions, inPageAgentRefusal, resolveAgentspec, } from '../../apps/agent';
 import { targetRunsAgentInPage, } from '../agents/switchable';
 import { agentIcon } from '../agents/agentIcons';
 import { specSubagents } from '../agents/specSubagents';
@@ -43,8 +43,8 @@ import { turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
 import { useAgentCommandTools } from '../../../tools/adapters/commands';
 import { NONE_EDITOR, seedEditorChoice, setEditorOptions, } from '../shell/editorChoice';
-import { PresenceFace, PresenceLine } from './Presence';
-import { presenceState } from './presenceStatus';
+import { PresenceFace, PresenceLine } from '../../../chat/presence/Presence';
+import { presenceState, presenceToolOf, } from '../../../chat/presence/presenceStatus';
 /** No editor: the conversation on its own. */
 const NO_SURFACE = '';
 /**
@@ -212,18 +212,7 @@ export default function ChatView({ workspace }) {
      */
     const handleDisplayItemsChange = useCallback((items) => {
         // The newest tool call, for an application's line of status (T-08).
-        let newest;
-        for (let index = items.length - 1; index >= 0; index -= 1) {
-            const item = items[index];
-            if (typeof item.toolName === 'string' && item.toolCallId) {
-                newest = item;
-                break;
-            }
-        }
-        const open = !!newest && newest.status !== 'complete' && newest.status !== 'error';
-        const pendingApproval = open &&
-            newest?.result
-                ?.pending_approval === true;
+        const { open, pendingApproval } = presenceToolOf(items);
         setPresenceTool(previous => previous.open === open && previous.pendingApproval === pendingApproval
             ? previous
             : { open, pendingApproval });
@@ -666,9 +655,23 @@ export default function ChatView({ workspace }) {
      * icon for want of this lookup — it used the document tools and called
      * nobody.
      */
-    const blueprintSpecId = useContributions(LoopAgentBlueprint)[0]?.value.specId;
-    const spec = getAgentspecs(member?.specId ?? agentId) ??
-        (blueprintSpecId ? getAgentspecs(blueprintSpecId) : undefined);
+    const blueprint = useContributions(LoopAgentBlueprint)[0]?.value;
+    const blueprintSpecId = blueprint?.specId;
+    /*
+     * An agent of the catalogue or a Cog's, as a runtime resolves it: an
+     * application on a Cog looked up among the agentspecs alone was turned in
+     * the page with no instructions at all (LOOP H-01).
+     */
+    const spec = resolveAgentspec(member?.specId ?? agentId) ??
+        (blueprintSpecId ? resolveAgentspec(blueprintSpecId) : undefined);
+    /*
+     * The blueprint's words and model — an application's — on top of its
+     * spec's, for the agent it contributes; never for a team's member.
+     */
+    const blueprintTurn = member ? undefined : blueprint;
+    // Turned in the page, an agent that resolves to nothing is refused rather
+    // than run bare.
+    const inPageRefusal = inPage && !member ? inPageAgentRefusal(blueprintSpecId, spec) : undefined;
     /*
      * The team's name for a member first, then the spec's own.
      *
@@ -956,12 +959,12 @@ export default function ChatView({ workspace }) {
      * for something that was never theirs.
      */
     const expiredKeyIsTemporary = !signedInUser;
-    const chatDisabled = gateBlocked || keyExpired;
+    const chatDisabled = gateBlocked || keyExpired || Boolean(inPageRefusal);
     const disabledReason = keyExpired
         ? expiredKeyIsTemporary
             ? 'This demo runs on a shared key, and its time is up. Sign in to keep going.'
             : 'Your key has expired. Sign in to keep going.'
-        : gateReason;
+        : (inPageRefusal ?? gateReason);
     /*
      * The prompt's text, held here rather than inside `InputPrompt`.
      *
@@ -992,7 +995,7 @@ export default function ChatView({ workspace }) {
      * the member being addressed changes.
      */
     const [pickedModel, setPickedModel] = useState();
-    const activeModel = pickedModel ?? spec?.model ?? workspace.model ?? '';
+    const activeModel = pickedModel ?? blueprintTurn?.model ?? spec?.model ?? workspace.model ?? '';
     /*
      * The team, in the shape the footer asks for.
      *
@@ -1082,7 +1085,7 @@ export default function ChatView({ workspace }) {
     const protocol = useMemo(() => inPage
         ? browserProtocolConfig({
             agentId: member?.specId ?? agentId,
-            instructions: spec?.systemPrompt,
+            instructions: agentInstructions(spec, blueprintTurn?.instructions),
             model: activeModel || undefined,
             inference,
             // Who this member may hand work to, and what they are told. Both
@@ -1122,6 +1125,7 @@ export default function ChatView({ workspace }) {
         agentTools,
         team,
         spec,
+        blueprintTurn,
         activeModel,
         agentServerUrl,
     ]);
@@ -1139,7 +1143,8 @@ export default function ChatView({ workspace }) {
     const configQuery = useConfig(!inPage, protocol.type === 'ag-ui' ? protocol.configEndpoint : undefined, undefined, agentId);
     const skillsQuery = useSkills(true);
     const skillActions = useSkillActions(agentId);
-    const [catalogModels, setCatalogModels] = useState([]);
+    // `undefined` until the runtime answers: its answer is then the list.
+    const [catalogModels, setCatalogModels] = useState(undefined);
     useEffect(() => {
         /*
          * Only where there is a server to ask.
@@ -1154,23 +1159,31 @@ export default function ChatView({ workspace }) {
             return undefined;
         }
         let cancelled = false;
-        void fetch(`${agentServerUrl}/api/v1/configure/models`)
-            .then(response => (response.ok ? response.json() : { models: [] }))
+        // The agent's own models (its model and model_additionals), each saying
+        // whether its inference serves it.
+        void fetch(`${agentServerUrl}/api/v1/configure/models?agent_id=${encodeURIComponent(agentId)}`)
+            .then(response => (response.ok ? response.json() : null))
             .then(payload => {
             if (!cancelled) {
                 // In the chat's shape: the route says `available`, the menu and
                 // the opening pick read `isAvailable`, and an unmapped row passes
                 // for usable. See `readServerCatalogue`.
-                setCatalogModels(readServerCatalogue(payload));
+                // A runtime that did not answer offers nothing: the agentspecs
+                // catalogue is not its answer.
+                setCatalogModels(payload ? readServerCatalogue(payload) : []);
             }
         })
             // No catalogue is not an error worth a banner: the menu simply has
             // nothing to offer, and the agent answers on whatever it was given.
-            .catch(() => undefined);
+            .catch(() => {
+            if (!cancelled) {
+                setCatalogModels([]);
+            }
+        });
         return () => {
             cancelled = true;
         };
-    }, [agentServerUrl, inPage]);
+    }, [agentServerUrl, agentId, inPage]);
     /*
      * What to offer when the server has no catalogue of its own.
      *
@@ -1179,16 +1192,14 @@ export default function ChatView({ workspace }) {
      * with nothing in it is a control that opens onto an empty list — so the
      * agentspecs catalogue stands in, filtered to the models marked available.
      */
-    const offeredModels = useMemo(() => catalogModels.length > 0
-        ? catalogModels
-        : Object.values(AI_MODEL_CATALOGUE)
-            // A typed-judgment model answers typed questions, not a chat.
-            .filter(model => model.available && isChatModel(model))
-            .map(model => ({
-            id: model.id,
-            name: model.name,
-            provider: model.provider,
-        })), [catalogModels]);
+    const offeredModels = useMemo(() => offeredModelsFor(catalogModels, () => Object.values(AI_MODEL_CATALOGUE)
+        // A typed-judgment model answers typed questions, not a chat.
+        .filter(model => model.available && isChatModel(model))
+        .map(model => ({
+        id: model.id,
+        name: model.name,
+        provider: model.provider,
+    }))), [catalogModels]);
     /*
      * The tools the agent can call, from both sides.
      *

package/lib/loop/plugins/chat/index.d.ts

@@ -1,4 +1,4 @@
-import type { PresenceState } from './presenceStatus';
+import type { PresenceState } from '../../../chat/presence/presenceStatus';
 /** What a host may set on the chat. */
 /** Who is answering, as the person meets them. */
 export interface ChatPresence {

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

@@ -0,0 +1,31 @@
+/**
+ * The split: the conversation and the work side by side, one hairline
+ * between them that a person drags (LOOP T-07, an Appspec's `layout: split`).
+ *
+ * The page layout's other arrangement. Where `page` puts the work on a sheet
+ * and the conversation in a panel that opens when wanted, `split` keeps both
+ * on screen: the conversation on the left — its transcript with the composer
+ * under it — and the work on the right, the way the reference screens show a
+ * mail, a document or the agent's computer beside the chat.
+ *
+ * The hairline is a separator a person can move with the pointer or the
+ * keyboard (arrows by a step, Home and End to the bounds); the share it
+ * leaves the conversation is kept while the workspace is mounted.
+ *
+ * @module loop/plugins/page-layout/SplitLayout
+ */
+import type { JSX } from 'react';
+import type { ChatLayoutParts } from '../../core';
+/** The conversation's share of the width when the split opens. */
+export declare const SPLIT_DEFAULT_SHARE = 0.4;
+/** The narrowest and widest the conversation may be made. */
+export declare const SPLIT_MIN_SHARE = 0.2;
+export declare const SPLIT_MAX_SHARE = 0.8;
+/** How far an arrow key moves the hairline. */
+export declare const SPLIT_KEY_STEP = 0.05;
+/** A share, held within the bounds. */
+export declare function clampSplitShare(share: number): number;
+/** Where a key moves the hairline, or `null` for a key it ignores. */
+export declare function splitShareForKey(share: number, key: string): number | null;
+export declare function SplitLayout({ editors, hasEditor, transcript, prompt, chips, picker, transient, }: ChatLayoutParts): JSX.Element;
+export default SplitLayout;

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

@@ -0,0 +1,129 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useRef, useState } from 'react';
+import { Box } from '@datalayer/primer-addons';
+/** The conversation's share of the width when the split opens. */
+export const SPLIT_DEFAULT_SHARE = 0.4;
+/** The narrowest and widest the conversation may be made. */
+export const SPLIT_MIN_SHARE = 0.2;
+export const SPLIT_MAX_SHARE = 0.8;
+/** How far an arrow key moves the hairline. */
+export const SPLIT_KEY_STEP = 0.05;
+/** A share, held within the bounds. */
+export function clampSplitShare(share) {
+    if (!Number.isFinite(share)) {
+        return SPLIT_DEFAULT_SHARE;
+    }
+    return Math.min(SPLIT_MAX_SHARE, Math.max(SPLIT_MIN_SHARE, share));
+}
+/** Where a key moves the hairline, or `null` for a key it ignores. */
+export function splitShareForKey(share, key) {
+    switch (key) {
+        case 'ArrowLeft':
+            return clampSplitShare(share - SPLIT_KEY_STEP);
+        case 'ArrowRight':
+            return clampSplitShare(share + SPLIT_KEY_STEP);
+        case 'Home':
+            return SPLIT_MIN_SHARE;
+        case 'End':
+            return SPLIT_MAX_SHARE;
+        default:
+            return null;
+    }
+}
+export function SplitLayout({ editors, hasEditor, transcript, prompt, chips, picker, transient, }) {
+    const [share, setShare] = useState(SPLIT_DEFAULT_SHARE);
+    const row = useRef(null);
+    const dragging = useRef(false);
+    const shareAt = useCallback((clientX) => {
+        const box = row.current?.getBoundingClientRect();
+        if (!box || box.width <= 0) {
+            return null;
+        }
+        return clampSplitShare((clientX - box.left) / box.width);
+    }, []);
+    const onPointerDown = (event) => {
+        dragging.current = true;
+        event.currentTarget.setPointerCapture?.(event.pointerId);
+        event.preventDefault();
+    };
+    const onPointerMove = (event) => {
+        if (!dragging.current) {
+            return;
+        }
+        const next = shareAt(event.clientX);
+        if (next !== null) {
+            setShare(next);
+        }
+    };
+    const onPointerUp = (event) => {
+        dragging.current = false;
+        event.currentTarget.releasePointerCapture?.(event.pointerId);
+    };
+    const onKeyDown = (event) => {
+        const next = splitShareForKey(share, event.key);
+        if (next !== null) {
+            event.preventDefault();
+            setShare(next);
+        }
+    };
+    const percent = Math.round(share * 100);
+    return (_jsxs(Box, { "data-testid": "loop-split-layout", sx: {
+            flex: '1 1 auto',
+            minHeight: 0,
+            display: 'flex',
+            flexDirection: 'column',
+        }, children: [picker, _jsxs(Box, { ref: row, sx: {
+                    flex: '1 1 auto',
+                    minHeight: 0,
+                    display: 'flex',
+                    // The hidden editors position themselves against this row.
+                    position: 'relative',
+                    overflow: 'hidden',
+                }, children: [_jsxs(Box, { "data-testid": "loop-split-conversation", sx: {
+                            flex: hasEditor ? `0 0 ${percent}%` : '1 1 auto',
+                            minWidth: 0,
+                            minHeight: 0,
+                            display: 'flex',
+                            flexDirection: 'column',
+                            // The transcript draws a rule on its left when an editor is on
+                            // screen, for the split it sits on the right of. Here it is on
+                            // the left, and the hairline is the separator: the rule is
+                            // pushed out of the row, which clips it.
+                            ml: hasEditor ? '-1px' : 0,
+                        }, children: [transcript, chips, prompt] }), hasEditor ? (_jsx(Box, { role: "separator", "aria-orientation": "vertical", "aria-label": "Resize the conversation and the page", "aria-valuemin": Math.round(SPLIT_MIN_SHARE * 100), "aria-valuemax": Math.round(SPLIT_MAX_SHARE * 100), "aria-valuenow": percent, tabIndex: 0, onPointerDown: onPointerDown, onPointerMove: onPointerMove, onPointerUp: onPointerUp, onPointerCancel: onPointerUp, onKeyDown: onKeyDown, sx: {
+                            // A hairline to the eye, a few pixels to the pointer.
+                            flex: '0 0 7px',
+                            mx: '-3px',
+                            zIndex: 1,
+                            cursor: 'col-resize',
+                            touchAction: 'none',
+                            display: 'flex',
+                            justifyContent: 'center',
+                            outline: 'none',
+                            '&::before': {
+                                content: '""',
+                                width: '1px',
+                                height: '100%',
+                                bg: 'border.default',
+                            },
+                            '&:hover::before, &:focus-visible::before': {
+                                width: '3px',
+                                bg: 'accent.emphasis',
+                            },
+                        } })) : null, _jsx(Box, { "data-testid": "loop-split-page", sx: hasEditor
+                            ? {
+                                flex: '1 1 0',
+                                minWidth: 0,
+                                minHeight: 0,
+                                display: 'flex',
+                            }
+                            : // Mounted but out of sight: the editors keep their place.
+                                {
+                                    position: 'absolute',
+                                    inset: 0,
+                                    visibility: 'hidden',
+                                    pointerEvents: 'none',
+                                    zIndex: -1,
+                                }, children: editors })] }), transient] }));
+}
+export default SplitLayout;

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

@@ -3,10 +3,23 @@ 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 { SplitLayout, SPLIT_DEFAULT_SHARE, SPLIT_KEY_STEP, SPLIT_MAX_SHARE, SPLIT_MIN_SHARE, clampSplitShare, splitShareForKey, } from './SplitLayout';
 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 = {
+    /**
+     * How the parts are arranged.
+     *
+     * `page` (the default): the work on a centred sheet, the composer over
+     * it, the conversation in a panel that opens when wanted. `split`: the
+     * conversation and the work side by side, the conversation on the left
+     * with the composer under it, one hairline between them that a person
+     * drags (`SplitLayout`) — an Appspec's `layout: split`. The split keeps
+     * the conversation on screen, so it has no turn panel, no conversation
+     * toggle and no display modes; the other settings are the page's.
+     */
+    arrangement?: 'page' | 'split';
     /**
      * Where the turn panel hangs on the composer.
      *

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

@@ -6,12 +6,14 @@ import { PageLayout, PagePanelToggle, openPagePanel, } from '@datalayer/primer-a
 import { ChatViewModeToggle } from '../../../chat/header/ChatViewModeToggle';
 import { LoopChatLayout, LoopChatTurn, LoopPromptPanel, LoopSlots, } from '../../core';
 import { TurnPanel } from './TurnPanel';
+import { SplitLayout } from './SplitLayout';
 /*
  * The layout's state is primer-addons', re-exported under the names the
  * Loop always had: a host that opened the conversation panel by calling
  * `openConversationPanel()` keeps doing so.
  */
 export { pageLayoutPanelOpen, pageLayoutSheet, openPagePanel as openConversationPanel, } from '@datalayer/primer-addons/lib/reactor';
+export { SplitLayout, SPLIT_DEFAULT_SHARE, SPLIT_KEY_STEP, SPLIT_MAX_SHARE, SPLIT_MIN_SHARE, clampSplitShare, splitShareForKey, } from './SplitLayout';
 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' });
@@ -35,6 +37,8 @@ const promptStance = signal('floating-top');
  * page layout to a page, the assumption that signal already makes.
  */
 let floatingStance = 'floating-top';
+/** The modes the page layout does not place. */
+const PAGE_LAYOUT_DISABLED_MODES = ['assistant'];
 export function pageLayoutForChatMode(mode) {
     switch (mode) {
         case 'sidebar':
@@ -60,7 +64,9 @@ export function setPageLayoutChatMode(mode) {
 /** The toggle in the floating composer's footer. */
 function ChatModeAction() {
     const mode = useSignalValue(pageLayoutChatMode);
-    return _jsx(ChatViewModeToggle, { value: mode, onChange: setPageLayoutChatMode });
+    // The page layout places the chat itself: the floating assistant, which
+    // ChatFloating draws, is offered greyed out with its reason (T-21).
+    return (_jsx(ChatViewModeToggle, { value: mode, onChange: setPageLayoutChatMode, disabledModes: PAGE_LAYOUT_DISABLED_MODES }));
 }
 /**
  * The chat view's parts on the page layout.
@@ -87,6 +93,7 @@ function ConversationToggle() {
 export const LoopPageLayoutPlugin = definePlugin({
     name: LOOP_PAGE_LAYOUT_PLUGIN_NAME,
     config: {
+        arrangement: 'page',
         turnPanel: 'below',
         turnPanelFooter: 'full',
         prompt: 'docked',
@@ -94,10 +101,16 @@ export const LoopPageLayoutPlugin = definePlugin({
         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.',
+    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; or, split, the conversation and the work side by side with a hairline to drag.',
     octicon: 'file',
     emoji: '\u{1F4C4}',
     build: ({ config, ...ctx }) => {
+        if (config.arrangement === 'split') {
+            // The conversation is on screen: the composer docked under it, and
+            // nothing that stands in for a transcript out of sight.
+            ctx.contribute(LoopChatLayout, { id: 'split-layout', prompt: 'docked', Component: SplitLayout }, { id: 'split-layout' });
+            return { components: [] };
+        }
         /*
           The layout, contributed per build because the composer's stance is
           configuration: `docked-top` means the layout owns the composer's width

package/lib/loop/presets.d.ts

@@ -34,6 +34,11 @@ export type LoopPresetOptions = {
      * A surface id rather than a fixed union, because the surfaces are
      * contributed: an editor plugin the preset has never heard of is still a
      * valid answer, and `'none'` is how a host asks for the chat alone.
+     *
+     * The notebook when unsaid, and none when `editors` is off. Said with
+     * `editors` off, it is honoured: the surface of a plugin the host mounts —
+     * an application's page — opens beside the chat without the notebook and
+     * the document.
      */
     defaultEditor?: ChatPluginConfig['defaultSurface'];
     /** Whether the chat offers its surface switcher. */
@@ -82,6 +87,13 @@ export type LoopPresetOptions = {
      * `LoopChatLayout` point.
      */
     pageLayout?: boolean;
+    /**
+     * How the page layout arranges the parts: `page` (the default), the work
+     * on a sheet with the conversation in a panel; or `split`, the
+     * conversation and the work side by side with a hairline to drag. Only
+     * read with `pageLayout`.
+     */
+    pageLayoutArrangement?: 'page' | 'split';
     /**
      * Where the page layout hangs the current turn on the composer: `below`
      * (the default), `above`, or `none`. Only read with `pageLayout`.

package/lib/loop/presets.js

@@ -52,12 +52,13 @@ 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, chatHeaderButtons = false, promptPlacement, autoFocusPrompt = true, suggestionLabels = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutPromptAnchor = 'top', pageLayoutSize, pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, datalayerAgentSpecId, datalayerCreatePayload, targetFixed, themeVariant, presence, showTokenUsage, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
+    const { serverUrl, target = 'browser', defaultEditor: askedEditor, showViewSelector = true, hideChatHeader = false, chatHeaderButtons = false, promptPlacement, autoFocusPrompt = true, suggestionLabels = true, fullScreenTopOffset = 0, showAgentVariants = false, agentSummary = true, teamId, teamPicker = true, pageLayout = false, pageLayoutArrangement = 'page', pageLayoutTurnPanel = 'below', pageLayoutPrompt = 'docked', pageLayoutPromptAnchor = 'top', pageLayoutSize, pageLayoutTurnPanelFooter = 'full', localAgent, localAgentSpec, datalayerAgentSpecId, datalayerCreatePayload, targetFixed, themeVariant, presence, showTokenUsage, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
+    const defaultEditor = askedEditor ?? (editors ? 'notebook' : 'none');
     return [
         // The chat owns the editor beside it, so which one opens is its
         // configuration rather than the workspace's.
         configurePlugin(ChatPlugin, {
-            defaultSurface: editors ? defaultEditor : 'none',
+            defaultSurface: defaultEditor,
             // The chat's strip stands down when the header selector offers the
             // same choice; see `editorSelector` — and when there is no editor
             // to choose.
@@ -130,13 +131,14 @@ export function loopPlugins(options = {}) {
         // happens to be on is a workspace with a trap in it. The selector itself
         // stays behind the old switch.
         configurePlugin(ShellPlugin, {
-            defaultEditor: editors ? defaultEditor : 'none',
+            defaultEditor,
             showSelector: editors && editorSelector,
         }),
         ...(floatingPrompt ? [PromptPlugin] : []),
         ...(pageLayout
             ? [
                 configurePlugin(LoopPageLayoutPlugin, {
+                    arrangement: pageLayoutArrangement,
                     turnPanel: pageLayoutTurnPanel,
                     turnPanelFooter: pageLayoutTurnPanelFooter,
                     prompt: pageLayoutPrompt,

package/lib/specs/actions.js

@@ -439,6 +439,8 @@ export const SERVER_ACTIONS = {
  * to reproduce.
  */
 export const APP_BEHAVIOURS = {
+    'customer-interview': {},
+    'data-quality': {},
     'inbox-triage': {
         'google-workspace.append_table_rows': 'leave_to_me',
         'google-workspace.batch_modify_gmail_message_labels': 'do_it',
@@ -561,8 +563,13 @@ export const APP_BEHAVIOURS = {
         'google-workspace.update_drive_file': 'leave_to_me',
         'google-workspace.update_paragraph_style': 'leave_to_me',
     },
+    'model-choice': {},
+    'pipeline-report': {},
     'quote-calculator': {},
+    'report-from-a-file': {},
     'ship-or-fix': {},
+    'supplier-comparison': {},
+    'support-desk': {},
     'web-research': {
         'tavily.tavily_crawl': 'do_it',
         'tavily.tavily_extract': 'do_it',
@@ -576,6 +583,8 @@ export const APP_BEHAVIOURS = {
  * application and tool, each condition and the behaviour when it holds.
  */
 export const APP_ESCALATIONS = {
+    'customer-interview': {},
+    'data-quality': {},
     'inbox-triage': {
         'google-workspace.batch_modify_gmail_message_labels': [
             {
@@ -610,7 +619,12 @@ export const APP_ESCALATIONS = {
             },
         ],
     },
+    'model-choice': {},
+    'pipeline-report': {},
     'quote-calculator': {},
+    'report-from-a-file': {},
     'ship-or-fix': {},
+    'supplier-comparison': {},
+    'support-desk': {},
     'web-research': {},
 };

package/lib/specs/agents/agents.js

@@ -3380,6 +3380,7 @@ export const EXAMPLE_ONE_TRIGGER_AGENTSPEC_0_0_1 = {
     domain: undefined,
     enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['github:0.0.1']
@@ -4389,6 +4390,7 @@ export const EXAMPLE_SIMPLE_AGENTSPEC_0_0_1 = {
     domain: undefined,
     enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['events:0.0.1']
@@ -5021,6 +5023,7 @@ export const JUPYTER_NOTEBOOK_COMPACTOR_AGENTSPEC_0_0_1 = {
     domain: undefined,
     enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [].filter(Boolean),
     tools: [TOOL_MAP['runtime-echo:0.0.1']],
@@ -7663,6 +7666,7 @@ export const WORKER_CRAWLER_AGENTSPEC_0_0_1 = {
     domain: 'market-analyst',
     enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [MCP_SERVER_MAP['tavily:0.0.1']],
     skills: [
         SKILL_MAP['github:0.0.1']

package/lib/specs/apps.d.ts

@@ -7,10 +7,17 @@
  * This file is AUTO-GENERATED from YAML specifications.
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
  */
-import type { AppKind, AppSpec } from '../types/agentspecs';
+import type { AppBuilt, AppKind, AppSpec } from '../types/agentspecs';
+export declare const CUSTOMER_INTERVIEW_APP_0_0_1: AppSpec;
+export declare const DATA_QUALITY_APP_0_0_1: AppSpec;
 export declare const INBOX_TRIAGE_APP_0_0_1: AppSpec;
+export declare const MODEL_CHOICE_APP_0_0_1: AppSpec;
+export declare const PIPELINE_REPORT_APP_0_0_1: AppSpec;
 export declare const QUOTE_CALCULATOR_APP_0_0_1: AppSpec;
+export declare const REPORT_FROM_A_FILE_APP_0_0_1: AppSpec;
 export declare const SHIP_OR_FIX_APP_0_0_1: AppSpec;
+export declare const SUPPLIER_COMPARISON_APP_0_0_1: AppSpec;
+export declare const SUPPORT_DESK_APP_0_0_1: AppSpec;
 export declare const WEB_RESEARCH_APP_0_0_1: AppSpec;
 export declare const APP_CATALOGUE: Record<string, AppSpec>;
 /** An application, by `id` or `id:version`, or undefined. */
@@ -21,5 +28,10 @@ export declare function getApp(ref: string): AppSpec | undefined;
  * Appspec have to give back.
  */
 export declare const APP_SOURCES: Record<string, Record<string, unknown>>;
+/**
+ * How each application was built: `python` (its `app.py`), `canvas` (its
+ * page composed on the Canvas) or `written` (its spec written out).
+ */
+export declare const APP_BUILT: Record<string, AppBuilt>;
 /** Every application of the catalogue, or those of a kind. */
 export declare function listApps(kind?: AppKind): AppSpec[];