@datalayer/agent-runtimes 1.5.1 → 1.5.2

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

@@ -9,6 +9,7 @@ import type { AssistantCharacter } from '../../chat/assistant/characters';
 import type { AssistantCharacterData } from '../../chat/assistant/formats/types';
 import type { PresenceState } from '../../chat/presence/presenceStatus';
 import type { ChatWords } from '../../chat/words';
+import type { ChatViewMode } from '../../types/chat';
 /** Lifecycle of the sandbox a workspace is attached to. */
 export type SandboxState = 'idle' | 'starting' | 'running' | 'stopping' | 'error';
 /** What the workspace knows about the sandbox behind it. */
@@ -196,6 +197,21 @@ export type LoopWorkspaceContext = {
      * part of the page and the chat's stay together at the trailing edge.
      */
     chatHeaderActions?: ReactNode;
+    /**
+     * The chat's view, as the host keeps it: the chat's title bar offers the
+     * views with its view-mode toggle (`ChatViewModeToggle`). Unsaid, the
+     * title bar offers none.
+     */
+    chatViewModes?: LoopChatViewModes;
+};
+/** The chat's view in a workspace whose host keeps it (`chatViewModes`). */
+export type LoopChatViewModes = {
+    /** The view the chat is in. */
+    value: ChatViewMode;
+    /** The person picked another view. */
+    onChange: (mode: ChatViewMode) => void;
+    /** The views offered, in the toggle's order; all of them when unsaid. */
+    offered?: readonly ChatViewMode[];
 };
 /**
  * How a prompt typed in the shell reaches whatever should answer it.

package/lib/apps/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @module apps
  */
-export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopRunProps, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, runForwardedProps, type CommandArgSpec, type CommandContribution, type CommandResult, type EditorToolbarContext, type EditorToolbarContribution, type LoopCommandContext, type LoopViewProps, type LoopWorkspaceContext, type MentionCandidate, type MentionContribution, type PromptChannel, type RunPropsContribution, type SandboxSnapshot, type SandboxState, type ViewControls, type ViewTypeContribution, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, type LoopPromptState, type SuggestedPrompt, } from './core';
+export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopRunProps, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, runForwardedProps, type CommandArgSpec, type CommandContribution, type CommandResult, type EditorToolbarContext, type EditorToolbarContribution, type LoopCommandContext, type LoopViewProps, type LoopWorkspaceContext, type LoopChatViewModes, type MentionCandidate, type MentionContribution, type PromptChannel, type RunPropsContribution, type SandboxSnapshot, type SandboxState, type ViewControls, type ViewTypeContribution, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, type LoopPromptState, type SuggestedPrompt, } from './core';
 export { useEditorToolbar } from './core/toolbar';
 export { LoopWorkspace, PluginToggles, ViewSwitcher, WorkspaceFullScreenAction, buildLoopReactor, useWorkspaceFullScreen, type LoopWorkspaceProps, type PluginTogglesProps, type ViewSwitcherProps, } from './shell';
 export { A2uiPlugin, A2UI_PLUGIN_NAME } from './plugins/a2ui';

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

@@ -1845,7 +1845,19 @@ export default function ChatView({ workspace }) {
                             showNewChat: config?.headerButtons?.newChat ?? false,
                             showClear: config?.headerButtons?.clear ?? false,
                         }, renderHeader: HeaderComponent
-                            ? headerProps => (_jsx(HeaderComponent, { workspace: workspace, header: headerProps }))
+                            ? headerProps => (_jsx(HeaderComponent, { workspace: workspace, header: 
+                                /* The chat's view, when the host keeps it: the
+                                   title bar's toggle, given to the header only —
+                                   the chat itself stays where the workspace
+                                   places it, whichever view is picked. */
+                                workspace.chatViewModes
+                                    ? {
+                                        ...headerProps,
+                                        chatViewMode: workspace.chatViewModes.value,
+                                        onChatViewModeChange: workspace.chatViewModes.onChange,
+                                        offeredViewModes: workspace.chatViewModes.offered,
+                                    }
+                                    : headerProps }))
                             : undefined, 
                         /*
                           The (i), which opens the agent's details over the transcript.

package/lib/apps/shell/LoopWorkspace.d.ts

@@ -22,7 +22,7 @@
 import type { JSX } from 'react';
 import type { ReactNode } from 'react';
 import { type PlatformInput, type PluginRef, type ReactorPlatform } from '@datalayer/reactor';
-import { type LoopWorkspaceContext, type SandboxSnapshot } from '../core';
+import { type LoopChatViewModes, type LoopWorkspaceContext, type SandboxSnapshot } from '../core';
 export type LoopWorkspaceProps = {
     /** Server backing this session. */
     serverUrl: string;
@@ -93,6 +93,13 @@ export type LoopWorkspaceProps = {
      * to `LoopSlots.chatHeader` instead, and both end up in the same row.
      */
     chatHeaderActions?: ReactNode;
+    /**
+     * The chat's view, kept by the host: offered in the chat's title bar by
+     * its view-mode toggle. The host draws the view picked — for the
+     * assistant, a chat layout (`LoopChatLayout`) that hands the transcript
+     * and the composer to `ChatFloating`'s assistant mode.
+     */
+    chatViewModes?: LoopChatViewModes;
     /**
      * The host's own controls for the workspace header row.
      *

package/lib/apps/shell/LoopWorkspace.js

@@ -13,21 +13,21 @@ export function buildLoopReactor(extensions) {
     return buildReactorFromPlugins(extensions);
 }
 export function LoopWorkspace(props) {
-    const { serverUrl, agentId, conversationId, model, sandbox = { state: 'idle' }, extensions = [], reactor: providedReactor, manageReactor = true, initialViewType, onSend, layout = 'page', showViewSelector = true, showHeader = true, chatHeaderActions, headerActions, headerContainer, sidebarRail = false, } = props;
+    const { serverUrl, agentId, conversationId, model, sandbox = { state: 'idle' }, extensions = [], reactor: providedReactor, manageReactor = true, initialViewType, onSend, layout = 'page', showViewSelector = true, showHeader = true, chatHeaderActions, chatViewModes, headerActions, headerContainer, sidebarRail = false, } = props;
     // Building the platform is a one-time act: rebuilding it on every render
     // would restart every plugin.
     const reactor = useMemo(() => providedReactor ?? buildLoopReactor(extensions), 
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [providedReactor]);
     useReactor(reactor, { autoStart: manageReactor });
-    return (_jsx(WorkspaceBody, { serverUrl: serverUrl, agentId: agentId, conversationId: conversationId, model: model, initialSandbox: sandbox, initialViewType: initialViewType, onSend: onSend, layout: layout, showViewSelector: showViewSelector, showHeader: showHeader, chatHeaderActions: chatHeaderActions, headerActions: headerActions, headerContainer: headerContainer, sidebarRail: sidebarRail }));
+    return (_jsx(WorkspaceBody, { serverUrl: serverUrl, agentId: agentId, conversationId: conversationId, model: model, initialSandbox: sandbox, initialViewType: initialViewType, onSend: onSend, layout: layout, showViewSelector: showViewSelector, showHeader: showHeader, chatHeaderActions: chatHeaderActions, chatViewModes: chatViewModes, headerActions: headerActions, headerContainer: headerContainer, sidebarRail: sidebarRail }));
 }
 /**
  * Split from `LoopWorkspace` so the hooks below run with the platform already
  * registered — `useContributions` needs a reactor in the store, and `useReactor`
  * registers it during the parent's render.
  */
-function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, model, initialSandbox, initialViewType, onSend, layout = 'page', showViewSelector = true, showHeader = true, chatHeaderActions, headerActions, headerContainer, sidebarRail = false, }) {
+function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, model, initialSandbox, initialViewType, onSend, layout = 'page', showViewSelector = true, showHeader = true, chatHeaderActions, chatViewModes, headerActions, headerContainer, sidebarRail = false, }) {
     /*
      * Which agent the session is talking to.
      *
@@ -119,6 +119,7 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
         viewControls,
         setViewControls,
         chatHeaderActions,
+        chatViewModes,
     }), [
         serverUrl,
         agentId,
@@ -131,6 +132,7 @@ function WorkspaceBody({ serverUrl, agentId: initialAgentId, conversationId, mod
         viewControls,
         setViewControls,
         chatHeaderActions,
+        chatViewModes,
     ]);
     // `submit` must not be rebuilt whenever the workspace object changes — the
     // chat holds on to it — so it reads the current values through refs.

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

@@ -69,6 +69,8 @@ export interface ChatBaseHeaderProps {
     onChatViewModeChange?: (mode: ChatViewMode) => void;
     /** Modes shown greyed out: the sidebar, when the host has no mount point. */
     disabledViewModes?: readonly ChatViewMode[];
+    /** The modes the toggle offers; all of them when unsaid. */
+    offeredViewModes?: readonly ChatViewMode[];
     /** Show the companion-surface segmented control (None / Notebook / Document). */
     showEphemeralSurfaceControl?: boolean;
     /** Whether the Notebook option is available in the surface control. */
@@ -80,5 +82,5 @@ export interface ChatBaseHeaderProps {
     /** Callback fired when the user changes the companion-surface mode. */
     onEphemeralSurfaceModeChange?: (mode: EphemeralSurfaceMode) => void;
 }
-export declare function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, headerContent, headerActions, showInformation, onInformationClick, padding, kernelIndicatorState, kernelIndicatorPlacement, runtimeStatus, kernel, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, headerButtons, messageCount, onNewChat, onClear, chatViewMode, onChatViewModeChange, disabledViewModes, showEphemeralSurfaceControl, enableEphemeralNotebookOption, enableEphemeralDocumentOption, ephemeralSurfaceMode, onEphemeralSurfaceModeChange, }: ChatBaseHeaderProps): import("react").JSX.Element;
+export declare function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, headerContent, headerActions, showInformation, onInformationClick, padding, kernelIndicatorState, kernelIndicatorPlacement, runtimeStatus, kernel, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, headerButtons, messageCount, onNewChat, onClear, chatViewMode, onChatViewModeChange, disabledViewModes, offeredViewModes, showEphemeralSurfaceControl, enableEphemeralNotebookOption, enableEphemeralDocumentOption, ephemeralSurfaceMode, onEphemeralSurfaceModeChange, }: ChatBaseHeaderProps): import("react").JSX.Element;
 export {};

package/lib/chat/header/ChatHeaderBase.js

@@ -31,7 +31,7 @@ export function toRuntimeExecutionState(runtimeStatus) {
 // ---------------------------------------------------------------------------
 // Component
 // ---------------------------------------------------------------------------
-export function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, headerContent, headerActions, showInformation, onInformationClick, padding, kernelIndicatorState, kernelIndicatorPlacement = 'left', runtimeStatus, kernel, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, headerButtons, messageCount, onNewChat, onClear, chatViewMode, onChatViewModeChange, disabledViewModes = [], showEphemeralSurfaceControl = false, enableEphemeralNotebookOption = false, enableEphemeralDocumentOption = false, ephemeralSurfaceMode = 'none', onEphemeralSurfaceModeChange, }) {
+export function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, headerContent, headerActions, showInformation, onInformationClick, padding, kernelIndicatorState, kernelIndicatorPlacement = 'left', runtimeStatus, kernel, kernelEnvironmentName, kernelCpu, kernelMemory, kernelGpu, headerButtons, messageCount, onNewChat, onClear, chatViewMode, onChatViewModeChange, disabledViewModes = [], offeredViewModes, showEphemeralSurfaceControl = false, enableEphemeralNotebookOption = false, enableEphemeralDocumentOption = false, ephemeralSurfaceMode = 'none', onEphemeralSurfaceModeChange, }) {
     const effectiveIndicatorState = kernelIndicatorState ?? toRuntimeExecutionState(runtimeStatus);
     /*
      * No indicator where there is nothing to indicate.
@@ -58,5 +58,5 @@ export function ChatBaseHeader({ title, subtitle, disableReason, brandIcon, head
                                         color: 'fg.muted',
                                         minWidth: 0,
                                         maxWidth: '100%',
-                                    }, children: _jsx(Truncate, { title: subtitle, maxWidth: "40ch", children: subtitle }) }))] })), disableReason && (_jsx(Label, { variant: "attention", sx: { flexShrink: 0 }, children: disableReason })), headerContent, showInformation && (_jsx(IconButton, { icon: InfoIcon, "aria-label": "Information", variant: "invisible", size: "small", onClick: onInformationClick })), kernelIndicatorPlacement === 'center' && kernelIndicatorElement] }), _jsxs(Box, { display: "flex", alignItems: "center", gap: 1, flexShrink: 0, children: [kernelIndicatorPlacement === 'right' && kernelIndicatorElement, headerButtons?.showNewChat && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "New chat", variant: "invisible", size: "small", onClick: onNewChat })), headerButtons?.showClear && messageCount > 0 && (_jsx(IconButton, { icon: TrashIcon, "aria-label": "Clear messages", variant: "invisible", size: "small", onClick: onClear })), headerButtons?.showSettings && (_jsx(IconButton, { icon: GearIcon, "aria-label": "Settings", variant: "invisible", size: "small", onClick: headerButtons.onSettings })), showEphemeralSurfaceControl && (_jsx(EphemeralSurfaceControl, { mode: ephemeralSurfaceMode, onChange: onEphemeralSurfaceModeChange, enableNotebook: enableEphemeralNotebookOption, enableDocument: enableEphemeralDocumentOption })), chatViewMode && onChatViewModeChange && (_jsx(ChatViewModeToggle, { value: chatViewMode, onChange: onChatViewModeChange, disabledModes: disabledViewModes })), headerActions] })] }) }));
+                                    }, children: _jsx(Truncate, { title: subtitle, maxWidth: "40ch", children: subtitle }) }))] })), disableReason && (_jsx(Label, { variant: "attention", sx: { flexShrink: 0 }, children: disableReason })), headerContent, showInformation && (_jsx(IconButton, { icon: InfoIcon, "aria-label": "Information", variant: "invisible", size: "small", onClick: onInformationClick })), kernelIndicatorPlacement === 'center' && kernelIndicatorElement] }), _jsxs(Box, { display: "flex", alignItems: "center", gap: 1, flexShrink: 0, children: [kernelIndicatorPlacement === 'right' && kernelIndicatorElement, headerButtons?.showNewChat && (_jsx(IconButton, { icon: PlusIcon, "aria-label": "New chat", variant: "invisible", size: "small", onClick: onNewChat })), headerButtons?.showClear && messageCount > 0 && (_jsx(IconButton, { icon: TrashIcon, "aria-label": "Clear messages", variant: "invisible", size: "small", onClick: onClear })), headerButtons?.showSettings && (_jsx(IconButton, { icon: GearIcon, "aria-label": "Settings", variant: "invisible", size: "small", onClick: headerButtons.onSettings })), showEphemeralSurfaceControl && (_jsx(EphemeralSurfaceControl, { mode: ephemeralSurfaceMode, onChange: onEphemeralSurfaceModeChange, enableNotebook: enableEphemeralNotebookOption, enableDocument: enableEphemeralDocumentOption })), chatViewMode && onChatViewModeChange && (_jsx(ChatViewModeToggle, { value: chatViewMode, onChange: onChatViewModeChange, disabledModes: disabledViewModes, modes: offeredViewModes })), headerActions] })] }) }));
 }

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

@@ -23,7 +23,13 @@ export type ChatViewModeToggleProps = {
     onChange: (mode: ChatViewMode) => void;
     /** Modes shown greyed out: the sidebar, when the host has no mount point. */
     disabledModes?: readonly ChatViewMode[];
+    /**
+     * The modes offered, in `CHAT_VIEW_MODES` order whatever order they are
+     * given in: all of them when unsaid. A host that places only some of them
+     * — the workspace: its sidebar, or the assistant over it — leaves the rest out.
+     */
+    modes?: readonly ChatViewMode[];
     /** Where the tooltips open. Above by default; below for a control at the top of its window. */
     tooltipDirection?: 'n' | 's';
 };
-export declare function ChatViewModeToggle({ value, onChange, disabledModes, tooltipDirection, }: ChatViewModeToggleProps): JSX.Element;
+export declare function ChatViewModeToggle({ value, onChange, disabledModes, modes, tooltipDirection, }: ChatViewModeToggleProps): JSX.Element;

package/lib/chat/header/ChatViewModeToggle.js

@@ -11,8 +11,11 @@ export const VIEW_MODE_ICONS = {
     assistant: PaperclipIcon,
     sidebar: SidebarExpandIcon,
 };
-export function ChatViewModeToggle({ value, onChange, disabledModes = [], tooltipDirection = 'n', }) {
-    return (_jsx(Box, { role: "group", "aria-label": "Display mode", "data-chat-view-mode-toggle": "", display: "inline-flex", alignItems: "center", bg: "neutral.muted", borderRadius: "6px", p: "2px", gap: "1px", children: CHAT_VIEW_MODES.map(({ mode, label }) => {
+export function ChatViewModeToggle({ value, onChange, disabledModes = [], modes, tooltipDirection = 'n', }) {
+    const offered = modes
+        ? CHAT_VIEW_MODES.filter(option => modes.includes(option.mode))
+        : CHAT_VIEW_MODES;
+    return (_jsx(Box, { role: "group", "aria-label": "Display mode", "data-chat-view-mode-toggle": "", display: "inline-flex", alignItems: "center", bg: "neutral.muted", borderRadius: "6px", p: "2px", gap: "1px", children: offered.map(({ mode, label }) => {
             const ModeIcon = VIEW_MODE_ICONS[mode];
             const selected = value === mode;
             /* Greyed rather than left out: the person sees the mode exists, and

package/lib/protocols/agentProtocols.js

@@ -15,6 +15,7 @@ import { AgenticCommercePlugin } from './agentic-commerce';
 import { ProtocolsCorePlugin } from './core';
 import { McpPlugin } from './mcp';
 import { PactPlugin } from './pact';
+import { PapPlugin } from './pap';
 import { UcpPlugin } from './ucp';
 import { WebBotAuthPlugin } from './web-bot-auth';
 export const AGENT_PROTOCOLS_EXTENSION = 'agent-protocols';
@@ -22,7 +23,7 @@ export const AgentProtocolsExtension = defineExtension({
     name: AGENT_PROTOCOLS_EXTENSION,
     version: '1.0.0',
     displayName: 'Agent protocols',
-    description: 'MCP, A2A, Web Bot Auth, UCP, the Agentic Commerce Protocol and PACT, each a plugin; their extensions its contribution points.',
+    description: 'MCP, A2A, Web Bot Auth, UCP, the Agentic Commerce Protocol, PACT and PAP, each a plugin; their extensions its contribution points.',
     plugins: [
         ProtocolsCorePlugin,
         McpPlugin,
@@ -31,6 +32,7 @@ export const AgentProtocolsExtension = defineExtension({
         UcpPlugin,
         AgenticCommercePlugin,
         PactPlugin,
+        PapPlugin,
     ],
 });
 /**

package/lib/protocols/pap/index.d.ts

@@ -0,0 +1,4 @@
+export declare const PAP_PLUGIN = "agent-runtimes.protocols.pap";
+/** The PAP draft the SDK implements (its `PROTOCOL_PROFILE`; Python reads it from the SDK). */
+export declare const PAP_PROTOCOL_PROFILE = "0.1";
+export declare const PapPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;

package/lib/protocols/pap/index.js

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The Personal Agent Protocol as a Reactor Plugin of the `agent-protocols`
+ * Extension. PAP's own plugins and points (`pap.*`, `pap.company.*`) come
+ * with its SDK, registered on the PAP Reactor a personal agent or a company
+ * builds; this plugin says what a runtime implements of PAP on
+ * `protocols.description`. It declares no point here: the one the Python
+ * runtime adds, `pap.company.operationTickets`, is where a perform turn
+ * redeems its ticket, and a TypeScript runtime performs no company
+ * operation. The twin of `agent_runtimes.protocols.pap`.
+ *
+ * @module protocols/pap
+ */
+import { contribution, definePlugin } from '@datalayer/reactor';
+import { DEFAULT_ORDER, ProtocolDescriptions } from '../core';
+export const PAP_PLUGIN = 'agent-runtimes.protocols.pap';
+/** The PAP draft the SDK implements (its `PROTOCOL_PROFILE`; Python reads it from the SDK). */
+export const PAP_PROTOCOL_PROFILE = '0.1';
+export const PapPlugin = definePlugin({
+    name: PAP_PLUGIN,
+    version: '1.0.0',
+    description: "Personal Agent Protocol: a person's agent at companies, and an application as a company, over the PAP SDK.",
+    contributionPoints: [],
+    contributes: [
+        contribution(ProtocolDescriptions, {
+            id: 'pap',
+            name: 'Personal Agent Protocol',
+            layer: 'consent',
+            version: PAP_PROTOCOL_PROFILE,
+            roles: ['personal-agent', 'company'],
+            status: 'implemented',
+            specification: 'https://personalagentprotocol.org/docs/spec',
+            plugin: PAP_PLUGIN,
+            catalogue: 'pap',
+            points: [],
+        }, { id: 'pap', order: DEFAULT_ORDER }),
+    ],
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.5.1",
+    "version": "1.5.2",
     "type": "module",
     "workspaces": [
         ".",
@@ -160,7 +160,7 @@
         "@datalayer/lexical-loro": "^1.0.6",
         "@datalayer/primer-addons": "^1.0.39",
         "@datalayer/primer-rjsf": "^1.0.3",
-        "@datalayer/personal-agent-protocol": "^0.6.0",
+        "@datalayer/personal-agent-protocol": "^0.15.0",
         "@datalayer/reactor": "^1.3.0",
         "@datalayer/reactor-commands": "^1.0.4",
         "@datalayer/reactor-manager": "^1.0.4",