@datalayer/agent-runtimes 1.3.29 → 1.3.30

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' });
@@ -91,6 +93,7 @@ function ConversationToggle() {
 export const LoopPageLayoutPlugin = definePlugin({
     name: LOOP_PAGE_LAYOUT_PLUGIN_NAME,
     config: {
+        arrangement: 'page',
         turnPanel: 'below',
         turnPanelFooter: 'full',
         prompt: 'docked',
@@ -98,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,7 @@ export const SERVER_ACTIONS = {
  * to reproduce.
  */
 export const APP_BEHAVIOURS = {
+    'customer-interview': {},
     'data-quality': {},
     'inbox-triage': {
         'google-workspace.append_table_rows': 'leave_to_me',
@@ -563,9 +564,12 @@ export const APP_BEHAVIOURS = {
         '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',
@@ -579,6 +583,7 @@ 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': [
@@ -615,8 +620,11 @@ 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,13 +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. */
@@ -24,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[];