@datalayer/agent-runtimes 1.0.29 → 1.3.11

package/lib/loop/embed/LoopEmbed.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Loop, ready to drop into somebody else's page.
+ *
+ * The supported way to embed the workspace: a plugin set from `loopPlugins`, a
+ * query client, an optional theme, and the shell. Everything a host has to do
+ * around Loop, done once here instead of once per host.
+ *
+ * It exists because the landing page was embedding the *example*. An example is
+ * written to be read — its props are demonstration switches, its wiring is
+ * whatever made the demo clearest, and none of it is a promise. A page that
+ * embeds Loop needs a supported surface, and the two drifting apart should not
+ * be able to break somebody's home page.
+ *
+ * What a host still owns is the frame it puts around this and how much of the
+ * page to give it. `WindowFrame` is there for the first; the second is a
+ * `height` on whatever wraps this.
+ *
+ * @module loop/embed/LoopEmbed
+ */
+import { useMemo, useRef } from 'react';
+import { QueryClientProvider } from '@tanstack/react-query';
+import { useReactor } from '@datalayer/reactor/react';
+import { Box } from '@datalayer/primer-addons';
+import { internalQueryClient } from '../../utils';
+import { buildLoopReactor, LoopWorkspace } from '../shell';
+import { loopPlugins } from '../presets';
+import { WindowFrame } from '../plugins/window-frame';
+export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions, headerActions, frameTitle, frameHeight, plugins = [], ...preset }) {
+    /*
+     * The latest `firstPromptHook`, kept in a ref rather than closed over
+     * directly.
+     *
+     * The reactor below is built once — see the comment on it — and a host's
+     * hook is exactly the kind of prop that is *not* stable across renders (it
+     * usually closes over the page's own state). Closing over it directly
+     * would either freeze the plugin config at whichever value happened to be
+     * current on the one render that built the reactor, or force this into the
+     * dependency array and restart every plugin whenever the host re-renders
+     * with a fresh inline function. The ref sidesteps both: the wrapper handed
+     * to `loopPlugins` below never changes identity, and it always reaches
+     * whatever the host most recently passed.
+     */
+    const firstPromptHookRef = useRef(preset.firstPromptHook);
+    firstPromptHookRef.current = preset.firstPromptHook;
+    // Built once: rebuilding would restart every plugin on each render.
+    const reactor = useMemo(() => buildLoopReactor([
+        ...loopPlugins({
+            ...preset,
+            // A framed embed wants the title bar's slots open; a host that
+            // asked for a frame should not also have to remember the plugin.
+            windowFrame: preset.windowFrame || frameTitle !== undefined,
+            firstPromptHook: () => firstPromptHookRef.current?.(),
+        }),
+        ...plugins,
+    ]), 
+    // `preset.firstPromptHook` is deliberately absent — see the ref above.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+        preset.serverUrl,
+        preset.target,
+        preset.defaultEditor,
+        preset.showViewSelector,
+        preset.hideChatHeader,
+        preset.promptPlacement,
+        preset.autoFocusPrompt,
+        preset.fullScreenTopOffset,
+        preset.showAgentVariants,
+        preset.agentSummary,
+        preset.teamId,
+        preset.teamPicker,
+        preset.pageLayout,
+        preset.pageLayoutTurnPanel,
+        preset.pageLayoutTurnPanelFooter,
+        preset.pageLayoutPrompt,
+        preset.pageLayoutPromptAnchor,
+        // By its fields: a host that writes the size inline hands over a new
+        // object every render, and the reactor must not be rebuilt for that.
+        preset.pageLayoutSize?.format,
+        preset.pageLayoutSize?.width,
+        preset.pageLayoutSize?.height,
+        preset.localAgentSpec,
+        preset.floatingPrompt,
+        preset.editorSelector,
+        preset.editors,
+        preset.graph,
+        preset.commandPalette,
+        preset.pluginsPanel,
+        preset.windowFrame,
+        frameTitle !== undefined,
+        plugins,
+    ]);
+    /*
+     * No theme provider here, deliberately.
+     *
+     * The views read Primer's CSS custom properties — the document editor reads
+     * them as variables, because that is how Lexical's stylesheets are written —
+     * so *something* above this has to define them. But a provider mounted here
+     * writes into the shared primer-addons store, which is the store the host
+     * page reads from: an embedded Loop would overwrite the reader's theme the
+     * moment it finished loading. Installing a global from inside a component
+     * somebody dropped into their page is not this component's business.
+     *
+     * A host provides `DatalayerThemeProvider` (or `ThemedProvider`) once, which
+     * every Datalayer application already does.
+     */
+    /*
+     * Started here, because this is what built it.
+     *
+     * `LoopWorkspace` starts the platform only when it is managing it, and it is
+     * told not to below — the reactor is this component's, and a shell that
+     * stopped it on unmount would be stopping somebody else's. Registering
+     * without starting leaves every plugin inactive, so nothing contributes a
+     * view and the workspace draws "No view is available yet".
+     */
+    useReactor(reactor);
+    const shell = (_jsx(LoopWorkspace, { serverUrl: preset.serverUrl ?? '', agentId: agentId, reactor: reactor, manageReactor: false, showViewSelector: preset.showViewSelector, showHeader: showHeader, chatHeaderActions: chatHeaderActions, headerActions: headerActions }));
+    return (_jsx(QueryClientProvider, { client: internalQueryClient, children: frameTitle !== undefined ? (_jsx(WindowFrame, { title: frameTitle, height: frameHeight, children: shell })) : (_jsx(Box, { sx: { height: '100%', minHeight: 0 }, children: shell })) }));
+}
+export default LoopEmbed;

package/lib/loop/extensions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The notebook capability: the editor, and the toolbar that reports on it.
+ *
+ * The sandbox plugin is deliberately absent even though the editor depends on
+ * it. It arrives as a dependency, and a package should not claim to deliver
+ * something it merely relies on — the whole workspace runs on that sandbox.
+ */
+export declare const NotebookExtension: import("@datalayer/reactor").ReactorExtension;
+/** The document capability: the same arrangement, for prose. */
+export declare const DocumentExtension: import("@datalayer/reactor").ReactorExtension;

package/lib/loop/extensions.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The Loop plugins, grouped the way they are installed.
+ *
+ * Splitting the editors from their toolbars bought a real thing — a toolbar
+ * can be switched off, and the chat can fill one without the editor knowing —
+ * but it also doubled the length of the plugin list, and a list of peers is a
+ * worse way to read a system than a list of capabilities.
+ *
+ * An extension fixes exactly that and nothing else: it groups, and it has no
+ * lifecycle of its own. Each member is still enabled and disabled on its own,
+ * still appears on the graph as itself, and still contributes as itself. The
+ * grouping is only how a reader is told "these arrived together, and this is
+ * what you would uninstall to lose the capability".
+ *
+ * @module loop/extensions
+ */
+import { defineExtension } from '@datalayer/reactor';
+import { DocumentPlugin } from './plugins/document';
+import { DocumentToolbarPlugin } from './plugins/document-toolbar';
+import { NotebookPlugin } from './plugins/notebook';
+import { NotebookToolbarPlugin } from './plugins/notebook-toolbar';
+/**
+ * The notebook capability: the editor, and the toolbar that reports on it.
+ *
+ * The sandbox plugin is deliberately absent even though the editor depends on
+ * it. It arrives as a dependency, and a package should not claim to deliver
+ * something it merely relies on — the whole workspace runs on that sandbox.
+ */
+export const NotebookExtension = defineExtension({
+    name: '@datalayer/loop-extension-notebook',
+    displayName: 'Notebooks',
+    description: 'A notebook beside the chat, and the toolbar that reports on it.',
+    octicon: 'rows',
+    emoji: '\u{1F4D3}',
+    plugins: [NotebookPlugin, NotebookToolbarPlugin],
+});
+/** The document capability: the same arrangement, for prose. */
+export const DocumentExtension = defineExtension({
+    name: '@datalayer/loop-extension-document',
+    displayName: 'Documents',
+    description: 'A rich-text document beside the chat, and the toolbar that reports on it.',
+    octicon: 'file',
+    emoji: '\u{1F4C4}',
+    plugins: [DocumentPlugin, DocumentToolbarPlugin],
+});

package/lib/loop/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The LOOP workspace: contracts, shell, and the plugins that come with it.
+ *
+ * A host embeds the workspace through this surface — never by deep import — so
+ * what is public is a decision rather than an accident of file layout (§3.5).
+ *
+ * @module loop
+ */
+export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, type CommandArgSpec, type CommandContribution, type CommandResult, type EditorToolbarContext, type EditorToolbarContribution, type LoopCommandContext, type LoopViewProps, type LoopWorkspaceContext, type MentionCandidate, type MentionContribution, type PromptChannel, 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';
+export { AgentspecsPlugin, AGENTSPECS_PLUGIN_NAME } from './plugins/agentspecs';
+export { ChatPlugin, CHAT_PLUGIN_NAME, type ChatPluginConfig, } from './plugins/chat';
+export { ChatHeaderPlugin, CHAT_HEADER_PLUGIN_NAME, } from './plugins/chat-header';
+export { InputPromptPlugin, INPUT_PROMPT_PLUGIN_NAME, type InputPromptPluginConfig, } from './plugins/input-prompt';
+export { createChatExtrasPlugin, CHAT_EXTRAS_PLUGIN_NAME, type ChatExtrasHandle, } from './plugins/chat-extras';
+export { LoopChatExtras, LoopChatLayout, LoopChatTurn, LoopOpeningDocument, LoopOpeningNotebook, LoopPromptPanel, type ChatLayoutContribution, type ChatLayoutParts, type ChatTurnContribution, type ChatTurnSnapshot, type ChatTurnStatus, type LoopChatExtrasValue, type OpeningDocumentContribution, type OpeningNotebookContribution, type PromptPanelContribution, } from './core';
+export { LoopPageLayoutPlugin, LOOP_PAGE_LAYOUT_PLUGIN_NAME, openConversationPanel, pageLayoutSheet, pageLayoutPanelOpen, type LoopPageLayoutConfig, } from './plugins/page-layout';
+export { useOptionalTeamSelection } from './plugins/agents/useTeamSelection';
+export type { TeamMember, TeamSelection } from './plugins/agents/team';
+export { ChatViewPlugin, CHAT_VIEW_PLUGIN_NAME } from './plugins/chat-view';
+export { NotebookViewPlugin, NOTEBOOK_VIEW_PLUGIN_NAME, } from './plugins/notebook-view';
+export { DocumentViewPlugin, DOCUMENT_VIEW_PLUGIN_NAME, } from './plugins/document-view';
+export { defineViewPlugin, type ViewPluginOptions, } from './plugins/view-switch';
+export { defineAgentCapacityPlugin, type AgentCapacityOptions, } from './plugins/agent-capacity';
+export { AgentCheckpointsPlugin, AGENT_CHECKPOINTS_PLUGIN_NAME, } from './plugins/agent-checkpoints';
+export { AgentCodeSandboxPlugin, AGENT_CODE_SANDBOX_PLUGIN_NAME, } from './plugins/agent-code-sandbox';
+export { AgentCodemodePlugin, AgentNoCodemodePlugin, AGENT_CODEMODE_PLUGIN_NAME, AGENT_NO_CODEMODE_PLUGIN_NAME, } from './plugins/agent-codemode';
+export { AgentCompactionPlugin, AGENT_COMPACTION_PLUGIN_NAME, } from './plugins/agent-compaction';
+export { AgentEvalsPlugin, AGENT_EVALS_PLUGIN_NAME, } from './plugins/agent-evals';
+export { AgentGuardrailsPlugin, AGENT_GUARDRAILS_PLUGIN_NAME, } from './plugins/agent-guardrails';
+export { AgentHooksPlugin, AGENT_HOOKS_PLUGIN_NAME, } from './plugins/agent-hooks';
+export { AgentInferencePlugin, AGENT_INFERENCE_PLUGIN_NAME, } from './plugins/agent-inference';
+export { AgentMcpPlugin, AGENT_MCP_PLUGIN_NAME } from './plugins/agent-mcp';
+export { AgentMemoryPlugin, AGENT_MEMORY_PLUGIN_NAME, } from './plugins/agent-memory';
+export { AgentMonitoringPlugin, AGENT_MONITORING_PLUGIN_NAME, } from './plugins/agent-monitoring';
+export { AgentNotificationsPlugin, AGENT_NOTIFICATIONS_PLUGIN_NAME, } from './plugins/agent-notifications';
+export { AgentOtelPlugin, AGENT_OTEL_PLUGIN_NAME } from './plugins/agent-otel';
+export { AgentOutputsPlugin, AGENT_OUTPUTS_PLUGIN_NAME, } from './plugins/agent-outputs';
+export { AgentParametersPlugin, AGENT_PARAMETERS_PLUGIN_NAME, } from './plugins/agent-parameters';
+export { AgentSkillsPlugin, AGENT_SKILLS_PLUGIN_NAME, } from './plugins/agent-skills';
+export { AgentSubagentsPlugin, AGENT_SUBAGENTS_PLUGIN_NAME, } from './plugins/agent-subagents';
+export { AgentA2APlugin, AGENT_A2A_PLUGIN_NAME } from './plugins/agent-a2a';
+export { CheckpointsSidebarPlugin, CHECKPOINTS_SIDEBAR_PLUGIN_NAME, CheckpointsSidebar, } from './plugins/checkpoints-sidebar';
+export { A2ASidebarPlugin, A2ASidebar, A2A_SIDEBAR_PLUGIN_NAME, describeRemoteAgents, remoteStatusOf, type A2ARemoteAgentView, type A2ARemoteStatus, } from './plugins/a2a-sidebar';
+export { AgentToolApprovalsPlugin, AGENT_TOOL_APPROVALS_PLUGIN_NAME, } from './plugins/agent-tool-approvals';
+export { AgentTriggersPlugin, AGENT_TRIGGERS_PLUGIN_NAME, } from './plugins/agent-triggers';
+export { SANDBOX_CAPACITIES, SandboxCapacityPlugins, } from './plugins/agent-code-sandboxes';
+export { AgentA2uiPlugin, AGENT_A2UI_PLUGIN_NAME } from './plugins/agent-a2ui';
+export { AgentA2uiJupyterOutputPlugin, AGENT_A2UI_JUPYTER_OUTPUT_PLUGIN_NAME, } from './plugins/agent-a2ui-jupyter-output';
+export { defineA2uiScenePlugin, type A2uiSceneOptions, } from './plugins/a2ui-scene';
+export { GraphViewPlugin, GRAPH_PLUGIN_NAME, GRAPH_VIEW_TYPE, } from './plugins/graph';
+export { PluginsPanelPlugin, PLUGINS_PANEL_PLUGIN_NAME, PluginsPanel, } from './plugins/plugins-panel';
+export { AGENTS_PLUGIN_NAME, AgentsPlugin, SandboxSelector, browserSource, createBrowserSandboxService, createServerSandboxService, createSwitchableSandboxService, suppliedSource, useOptionalSandboxService, useSandboxService, type AgentsConfig, type AgentsOutput, type SandboxExecution, type SandboxService, type SandboxTarget, type ServiceManagerSource, type SwitchableSandboxService, } from './plugins/agents';
+export { DocumentPlugin, DOCUMENT_PLUGIN_NAME } from './plugins/document';
+export { DocumentToolbarPlugin, DOCUMENT_TOOLBAR_PLUGIN_NAME, } from './plugins/document-toolbar';
+export { ShellPlugin, EditorSelector, SHELL_PLUGIN_NAME, NONE_EDITOR, chooseEditor, EditorsPlugin, EDITORS_PLUGIN_NAME, type ShellPluginConfig, } from './plugins/shell';
+export { ModelsPlugin, MODELS_PLUGIN_NAME } from './plugins/models';
+export { NotebookPlugin, NOTEBOOK_PLUGIN_NAME } from './plugins/notebook';
+export { NotebookToolbarPlugin, NOTEBOOK_TOOLBAR_PLUGIN_NAME, } from './plugins/notebook-toolbar';
+export { WindowFrame, WindowFramePlugin, WINDOW_ACTIONS_SLOT, WINDOW_CONTROLS_SLOT, WINDOW_FRAME_PLUGIN_NAME, type WindowFrameProps, } from './plugins/window-frame';
+export { LoopCommandsPlugin, COMMANDS_PLUGIN_NAME } from './plugins/commands';
+export { PromptPlugin, PROMPT_PLUGIN_NAME } from './plugins/prompt';
+export { LoopEmbed, type LoopEmbedProps } from './embed/LoopEmbed';
+export { SubagentActivityPlugin, SubagentPulse, SUBAGENT_ACTIVITY_PLUGIN_NAME, } from './plugins/subagent-activity';
+export { loopPlugins, type LoopPresetOptions } from './presets';
+export { DocumentExtension, NotebookExtension } from './extensions';

package/lib/loop/index.js

@@ -0,0 +1,87 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The LOOP workspace: contracts, shell, and the plugins that come with it.
+ *
+ * A host embeds the workspace through this surface — never by deep import — so
+ * what is public is a decision rather than an accident of file layout (§3.5).
+ *
+ * @module loop
+ */
+// The contracts. A plugin depends on these and on the reactor, never on the shell.
+export { LoopCommand, LoopDocumentToolbar, LoopMention, LoopNotebookToolbar, LoopSlots, LoopViewType, canOpenView, createPromptChannel, parseCommand, useLoopPromptStore, suggestLoopPrompt, focusPrompt, onPromptFocusRequest, } from './core';
+export { useEditorToolbar } from './core/toolbar';
+// The shell.
+export { LoopWorkspace, PluginToggles, ViewSwitcher, WorkspaceFullScreenAction, buildLoopReactor, useWorkspaceFullScreen, } from './shell';
+// The plugins that ship with it.
+export { A2uiPlugin, A2UI_PLUGIN_NAME } from './plugins/a2ui';
+export { AgentspecsPlugin, AGENTSPECS_PLUGIN_NAME } from './plugins/agentspecs';
+export { ChatPlugin, CHAT_PLUGIN_NAME, } from './plugins/chat';
+export { ChatHeaderPlugin, CHAT_HEADER_PLUGIN_NAME, } from './plugins/chat-header';
+export { InputPromptPlugin, INPUT_PROMPT_PLUGIN_NAME, } from './plugins/input-prompt';
+export { createChatExtrasPlugin, CHAT_EXTRAS_PLUGIN_NAME, } from './plugins/chat-extras';
+// The live channels a host feeds the workspace through, and what it can
+// read back: the chat extras, the opening notebook, and who the team is
+// talking to. A page composing panels around a `LoopEmbed` needs all three.
+export { LoopChatExtras, LoopChatLayout, LoopChatTurn, LoopOpeningDocument, LoopOpeningNotebook, LoopPromptPanel, } from './core';
+export { LoopPageLayoutPlugin, LOOP_PAGE_LAYOUT_PLUGIN_NAME, openConversationPanel, pageLayoutSheet, pageLayoutPanelOpen, } from './plugins/page-layout';
+export { useOptionalTeamSelection } from './plugins/agents/useTeamSelection';
+export { ChatViewPlugin, CHAT_VIEW_PLUGIN_NAME } from './plugins/chat-view';
+export { NotebookViewPlugin, NOTEBOOK_VIEW_PLUGIN_NAME, } from './plugins/notebook-view';
+export { DocumentViewPlugin, DOCUMENT_VIEW_PLUGIN_NAME, } from './plugins/document-view';
+export { defineViewPlugin, } from './plugins/view-switch';
+export { defineAgentCapacityPlugin, } from './plugins/agent-capacity';
+// The agent-capacity plugins: one folder per capacity, one line each.
+export { AgentCheckpointsPlugin, AGENT_CHECKPOINTS_PLUGIN_NAME, } from './plugins/agent-checkpoints';
+export { AgentCodeSandboxPlugin, AGENT_CODE_SANDBOX_PLUGIN_NAME, } from './plugins/agent-code-sandbox';
+export { AgentCodemodePlugin, AgentNoCodemodePlugin, AGENT_CODEMODE_PLUGIN_NAME, AGENT_NO_CODEMODE_PLUGIN_NAME, } from './plugins/agent-codemode';
+export { AgentCompactionPlugin, AGENT_COMPACTION_PLUGIN_NAME, } from './plugins/agent-compaction';
+export { AgentEvalsPlugin, AGENT_EVALS_PLUGIN_NAME, } from './plugins/agent-evals';
+export { AgentGuardrailsPlugin, AGENT_GUARDRAILS_PLUGIN_NAME, } from './plugins/agent-guardrails';
+export { AgentHooksPlugin, AGENT_HOOKS_PLUGIN_NAME, } from './plugins/agent-hooks';
+export { AgentInferencePlugin, AGENT_INFERENCE_PLUGIN_NAME, } from './plugins/agent-inference';
+export { AgentMcpPlugin, AGENT_MCP_PLUGIN_NAME } from './plugins/agent-mcp';
+export { AgentMemoryPlugin, AGENT_MEMORY_PLUGIN_NAME, } from './plugins/agent-memory';
+export { AgentMonitoringPlugin, AGENT_MONITORING_PLUGIN_NAME, } from './plugins/agent-monitoring';
+export { AgentNotificationsPlugin, AGENT_NOTIFICATIONS_PLUGIN_NAME, } from './plugins/agent-notifications';
+export { AgentOtelPlugin, AGENT_OTEL_PLUGIN_NAME } from './plugins/agent-otel';
+export { AgentOutputsPlugin, AGENT_OUTPUTS_PLUGIN_NAME, } from './plugins/agent-outputs';
+export { AgentParametersPlugin, AGENT_PARAMETERS_PLUGIN_NAME, } from './plugins/agent-parameters';
+export { AgentSkillsPlugin, AGENT_SKILLS_PLUGIN_NAME, } from './plugins/agent-skills';
+export { AgentSubagentsPlugin, AGENT_SUBAGENTS_PLUGIN_NAME, } from './plugins/agent-subagents';
+export { AgentA2APlugin, AGENT_A2A_PLUGIN_NAME } from './plugins/agent-a2a';
+export { CheckpointsSidebarPlugin, CHECKPOINTS_SIDEBAR_PLUGIN_NAME, CheckpointsSidebar, } from './plugins/checkpoints-sidebar';
+export { A2ASidebarPlugin, A2ASidebar, A2A_SIDEBAR_PLUGIN_NAME, describeRemoteAgents, remoteStatusOf, } from './plugins/a2a-sidebar';
+export { AgentToolApprovalsPlugin, AGENT_TOOL_APPROVALS_PLUGIN_NAME, } from './plugins/agent-tool-approvals';
+export { AgentTriggersPlugin, AGENT_TRIGGERS_PLUGIN_NAME, } from './plugins/agent-triggers';
+export { SANDBOX_CAPACITIES, SandboxCapacityPlugins, } from './plugins/agent-code-sandboxes';
+export { AgentA2uiPlugin, AGENT_A2UI_PLUGIN_NAME } from './plugins/agent-a2ui';
+export { AgentA2uiJupyterOutputPlugin, AGENT_A2UI_JUPYTER_OUTPUT_PLUGIN_NAME, } from './plugins/agent-a2ui-jupyter-output';
+export { defineA2uiScenePlugin, } from './plugins/a2ui-scene';
+export { GraphViewPlugin, GRAPH_PLUGIN_NAME, GRAPH_VIEW_TYPE, } from './plugins/graph';
+export { PluginsPanelPlugin, PLUGINS_PANEL_PLUGIN_NAME, PluginsPanel, } from './plugins/plugins-panel';
+export { AGENTS_PLUGIN_NAME, AgentsPlugin, SandboxSelector, browserSource, createBrowserSandboxService, createServerSandboxService, createSwitchableSandboxService, suppliedSource, useOptionalSandboxService, useSandboxService, } from './plugins/agents';
+export { DocumentPlugin, DOCUMENT_PLUGIN_NAME } from './plugins/document';
+export { DocumentToolbarPlugin, DOCUMENT_TOOLBAR_PLUGIN_NAME, } from './plugins/document-toolbar';
+export { ShellPlugin, EditorSelector, SHELL_PLUGIN_NAME, NONE_EDITOR, chooseEditor, 
+// The names this plugin outgrew, kept so nothing breaks in the same step.
+EditorsPlugin, EDITORS_PLUGIN_NAME, } from './plugins/shell';
+export { ModelsPlugin, MODELS_PLUGIN_NAME } from './plugins/models';
+export { NotebookPlugin, NOTEBOOK_PLUGIN_NAME } from './plugins/notebook';
+export { NotebookToolbarPlugin, NOTEBOOK_TOOLBAR_PLUGIN_NAME, } from './plugins/notebook-toolbar';
+// The window a page puts around Loop, and the slots that make its title bar
+// extensible.
+export { WindowFrame, WindowFramePlugin, WINDOW_ACTIONS_SLOT, WINDOW_CONTROLS_SLOT, WINDOW_FRAME_PLUGIN_NAME, } from './plugins/window-frame';
+export { LoopCommandsPlugin, COMMANDS_PLUGIN_NAME } from './plugins/commands';
+export { PromptPlugin, PROMPT_PLUGIN_NAME } from './plugins/prompt';
+// Loop, ready to drop into somebody else's page.
+export { LoopEmbed } from './embed/LoopEmbed';
+export { SubagentActivityPlugin, SubagentPulse, SUBAGENT_ACTIVITY_PLUGIN_NAME, } from './plugins/subagent-activity';
+// The set a workspace normally has, so a host starts from a working Loop
+// rather than assembling one — and never from the example.
+export { loopPlugins } from './presets';
+// The extensions that group them, for hosts that would rather install a
+// capability than assemble one.
+export { DocumentExtension, NotebookExtension } from './extensions';

package/lib/loop/plugins/a2a-sidebar/A2ASidebar.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The A2A sidebar: the agents the chat's agent reaches over A2A, what each
+ * is doing, and the run under way — the same boxed live run the chat shows
+ * under the delegation's tool card, kept in view here while the chat scrolls.
+ *
+ * What it knows comes from two places. The agentspec behind the workspace's
+ * agent blueprint declares the subagents with an `a2a` target; the runtime
+ * store holds the `agent.subagent` events, and the ones marked
+ * `transport: 'a2a'` say where each agent was launched, its card, its task
+ * and how far it has got.
+ *
+ * @module loop/plugins/a2a-sidebar/A2ASidebar
+ */
+import React from 'react';
+import { type LoopWorkspaceContext } from '../../core';
+import { type AgentStreamSubagentPayload } from '../../../types/stream';
+import type { SubAgentspecConfig } from '../../../types/agentspecs';
+/** Fixed height (px) of the live run box. */
+export declare const A2A_ACTIVE_PANEL_HEIGHT = 280;
+export type A2ARemoteStatus = 'idle' | 'launching' | 'working' | 'done' | 'stopped' | 'failed';
+/** One A2A agent as the sidebar shows it. */
+export interface A2ARemoteAgentView {
+    name: string;
+    description?: string;
+    /** The agentspec it is launched from, as `<id>:<version>`. */
+    ref?: string;
+    /** `local`, `cloud`, `remote`, or the `auto` not yet decided. */
+    launch?: string;
+    url?: string;
+    taskId?: string | null;
+    card?: AgentStreamSubagentPayload['agentCard'];
+    runtimeUid?: string;
+    status: A2ARemoteStatus;
+}
+type Activity = Record<string, readonly AgentStreamSubagentPayload[]>;
+/** Where a remote run stands, from its events. */
+export declare function remoteStatusOf(events: readonly AgentStreamSubagentPayload[] | undefined): A2ARemoteStatus;
+/**
+ * The A2A agents to show: the ones the spec declares, each with what its
+ * latest run said about it, plus any the events name that the spec did not.
+ */
+export declare function describeRemoteAgents(declared: readonly SubAgentspecConfig[], activity: Activity): A2ARemoteAgentView[];
+export interface A2ASidebarProps {
+    /** Forwarded by the shell; unused, the sidebar reads the stores. */
+    workspace?: LoopWorkspaceContext;
+}
+export declare function A2ASidebar(_props: A2ASidebarProps): React.ReactElement;
+export default A2ASidebar;

package/lib/loop/plugins/a2a-sidebar/A2ASidebar.js

@@ -0,0 +1,190 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * The A2A sidebar: the agents the chat's agent reaches over A2A, what each
+ * is doing, and the run under way — the same boxed live run the chat shows
+ * under the delegation's tool card, kept in view here while the chat scrolls.
+ *
+ * What it knows comes from two places. The agentspec behind the workspace's
+ * agent blueprint declares the subagents with an `a2a` target; the runtime
+ * store holds the `agent.subagent` events, and the ones marked
+ * `transport: 'a2a'` say where each agent was launched, its card, its task
+ * and how far it has got.
+ *
+ * @module loop/plugins/a2a-sidebar/A2ASidebar
+ */
+import { useMemo, useState } from 'react';
+import { Heading, Label, Link, Text, Timeline } from '@primer/react';
+import { AlertIcon, BroadcastIcon, CheckCircleIcon, CloudIcon, DependabotIcon, DeviceDesktopIcon, } from '@primer/octicons-react';
+import { Box } from '@datalayer/primer-addons';
+import { useContributions } from '@datalayer/reactor/react';
+import { LoopAgentBlueprint } from '../../core';
+import { getAgentspecs } from '../../../specs/agents';
+import { SubagentChatPanel } from '../../../chat/messages/ChatMessageList';
+import { A2AAgentDialog } from '../../../chat/tools/A2AAgentDialog';
+import { useAgentRuntimeActiveSubagentToolCallId, useAgentRuntimeStore, } from '../../../stores/agentRuntimeStore';
+import { SUBAGENT_STOPPED, } from '../../../types/stream';
+/** Fixed height (px) of the live run box. */
+export const A2A_ACTIVE_PANEL_HEIGHT = 280;
+/** Where a remote run stands, from its events. */
+export function remoteStatusOf(events) {
+    if (!events || events.length === 0)
+        return 'idle';
+    if (events.some(event => event.phase === 'error')) {
+        return events.some(event => event.phase === 'error' && event.error === SUBAGENT_STOPPED)
+            ? 'stopped'
+            : 'failed';
+    }
+    if (events.some(event => event.phase === 'end'))
+        return 'done';
+    let state;
+    for (const event of events) {
+        if (event.phase === 'status' && event.state)
+            state = event.state;
+    }
+    return state === 'launching' ? 'launching' : 'working';
+}
+/**
+ * The A2A agents to show: the ones the spec declares, each with what its
+ * latest run said about it, plus any the events name that the spec did not.
+ */
+export function describeRemoteAgents(declared, activity) {
+    const views = declared
+        .filter(subagent => subagent.a2a)
+        .map(subagent => ({
+        name: subagent.name,
+        description: subagent.description,
+        ref: subagent.ref,
+        launch: subagent.a2a?.launch ?? 'auto',
+        url: subagent.a2a?.url,
+        status: 'idle',
+    }));
+    // Runs are keyed by tool call; the ones over A2A, in the order they were
+    // opened, so the last run seen for a name is the latest.
+    for (const events of Object.values(activity)) {
+        const first = events[0];
+        if (!first || !events.some(event => event.transport === 'a2a'))
+            continue;
+        let view = views.find(entry => entry.name === first.subagentName);
+        if (!view) {
+            view = { name: first.subagentName, status: 'idle' };
+            views.push(view);
+        }
+        view.status = remoteStatusOf(events);
+        for (const event of events) {
+            if (event.url)
+                view.url = event.url;
+            if (event.launch && event.launch !== 'auto')
+                view.launch = event.launch;
+            if (event.taskId)
+                view.taskId = event.taskId;
+            if (event.agentCard)
+                view.card = event.agentCard;
+            if (event.runtimeUid)
+                view.runtimeUid = event.runtimeUid;
+        }
+    }
+    return views;
+}
+const STATUS_LABEL = {
+    idle: { text: 'idle', variant: 'secondary' },
+    launching: { text: 'launching', variant: 'accent' },
+    working: { text: 'working', variant: 'accent' },
+    done: { text: 'done', variant: 'success' },
+    stopped: { text: 'stopped', variant: 'attention' },
+    failed: { text: 'failed', variant: 'danger' },
+};
+function StatusBadge({ status, }) {
+    switch (status) {
+        case 'done':
+            return (_jsx(Box, { sx: { color: 'success.fg', display: 'flex' }, children: _jsx(CheckCircleIcon, {}) }));
+        case 'stopped':
+            return (_jsx(Box, { sx: { color: 'attention.fg', display: 'flex' }, children: _jsx(AlertIcon, {}) }));
+        case 'failed':
+            return (_jsx(Box, { sx: { color: 'danger.fg', display: 'flex' }, children: _jsx(AlertIcon, {}) }));
+        case 'launching':
+        case 'working':
+            return (_jsx(Box, { sx: { color: 'accent.fg', display: 'flex' }, children: _jsx(DependabotIcon, {}) }));
+        default:
+            return _jsx(BroadcastIcon, {});
+    }
+}
+function LaunchChip({ launch, }) {
+    if (!launch)
+        return null;
+    const Icon = launch === 'cloud'
+        ? CloudIcon
+        : launch === 'local'
+            ? DeviceDesktopIcon
+            : BroadcastIcon;
+    return (_jsxs(Box, { sx: {
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 1,
+            fontSize: 0,
+            color: 'fg.muted',
+        }, children: [_jsx(Icon, { size: 12 }), _jsx(Text, { sx: { fontSize: 0 }, children: launch })] }));
+}
+function SectionHeading({ children }) {
+    return (_jsx(Heading, { as: "h4", sx: { fontSize: 1, mb: 2 }, children: children }));
+}
+export function A2ASidebar(_props) {
+    const blueprints = useContributions(LoopAgentBlueprint);
+    const specId = blueprints[0]?.value.specId;
+    const declared = useMemo(() => (specId ? (getAgentspecs(specId)?.subagents?.subagents ?? []) : []), [specId]);
+    const activity = useAgentRuntimeStore(state => state.subagentActivity);
+    const agents = useMemo(() => describeRemoteAgents(declared, activity), [declared, activity]);
+    const activeKey = useAgentRuntimeActiveSubagentToolCallId();
+    // The agent whose details are open over the workspace, if any.
+    const [shown, setShown] = useState(null);
+    const activeOverA2A = activeKey !== null &&
+        (activity[activeKey] ?? []).some(event => event.transport === 'a2a');
+    return (_jsxs(Box, { "data-a2a-sidebar": true, sx: { display: 'flex', flexDirection: 'column', gap: 4 }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2 }, children: [_jsx(BroadcastIcon, { size: 16 }), _jsx(Heading, { as: "h3", sx: { fontSize: 2, m: 0, flex: 1 }, children: "A2A agents" }), _jsx(Label, { variant: "accent", children: agents.length })] }), _jsxs(Box, { children: [_jsx(SectionHeading, { children: "Running now" }), activeKey && activeOverA2A ? (_jsx(SubagentChatPanel, { toolCallId: activeKey, height: A2A_ACTIVE_PANEL_HEIGHT })) : (_jsx(Box, { "data-a2a-sidebar-idle": true, sx: {
+                            height: A2A_ACTIVE_PANEL_HEIGHT,
+                            display: 'flex',
+                            alignItems: 'center',
+                            justifyContent: 'center',
+                            border: '1px solid',
+                            borderColor: 'border.muted',
+                            borderRadius: 2,
+                            bg: 'canvas.default',
+                        }, children: _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', m: 0 }, children: "No A2A agent running" }) }))] }), _jsxs(Box, { children: [_jsx(SectionHeading, { children: "Remote agents" }), agents.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0 }, children: "This agent declares no A2A agents." })) : (_jsx(Timeline, { children: agents.map(agent => {
+                            const status = STATUS_LABEL[agent.status];
+                            return (_jsxs(Timeline.Item, { "data-a2a-agent": agent.name, children: [_jsx(Timeline.Badge, { children: _jsx(StatusBadge, { status: agent.status }) }), _jsxs(Timeline.Body, { children: [_jsxs(Box, { sx: {
+                                                    display: 'flex',
+                                                    alignItems: 'center',
+                                                    gap: 2,
+                                                    mb: 1,
+                                                    flexWrap: 'wrap',
+                                                }, children: [_jsx(Text, { sx: { fontWeight: 'bold', fontSize: 1 }, children: agent.name }), _jsx(Label, { variant: status.variant, size: "small", children: status.text }), _jsx(LaunchChip, { launch: agent.launch })] }), agent.description ? (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mt: 0, mb: 1 }, children: agent.description })) : null, _jsxs(Box, { sx: {
+                                                    display: 'flex',
+                                                    flexDirection: 'column',
+                                                    gap: '2px',
+                                                    fontSize: 0,
+                                                    color: 'fg.muted',
+                                                }, children: [agent.card?.name ? (_jsxs(Text, { sx: { fontSize: 0 }, children: ["Card: ", agent.card.name, agent.card.version ? ` v${agent.card.version}` : ''] })) : agent.ref ? (_jsx(Text, { sx: { fontSize: 0, fontFamily: 'mono' }, children: agent.ref })) : null, agent.url ? (_jsx(Link, { as: "button", type: "button", "data-a2a-card-button": agent.name, onClick: () => setShown(agent), sx: {
+                                                            fontSize: 0,
+                                                            fontFamily: 'mono',
+                                                            overflow: 'hidden',
+                                                            textOverflow: 'ellipsis',
+                                                            whiteSpace: 'nowrap',
+                                                            display: 'block',
+                                                            maxWidth: '100%',
+                                                            textAlign: 'left',
+                                                        }, title: `${agent.url} — open the agent's details`, children: agent.url })) : null, agent.taskId ? (_jsxs(Text, { sx: { fontSize: 0, fontFamily: 'mono' }, children: ["task ", agent.taskId] })) : null, agent.runtimeUid ? (_jsxs(Text, { sx: { fontSize: 0, fontFamily: 'mono' }, children: ["runtime ", agent.runtimeUid] })) : null] })] })] }, agent.name));
+                        }) }))] }), shown ? (_jsx(A2AAgentDialog, { details: {
+                    name: shown.name,
+                    url: shown.url,
+                    launch: shown.launch,
+                    state: shown.status,
+                    taskId: shown.taskId,
+                    runtimeUid: shown.runtimeUid,
+                    card: shown.card,
+                    ref: shown.ref,
+                    description: shown.description,
+                }, onClose: () => setShown(null) })) : null, _jsxs(Box, { children: [_jsx(SectionHeading, { children: "How it works" }), _jsxs(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mb: 2 }, children: ["The orchestrator delegates with ", _jsx("code", { children: "delegate_task" }), ", as with in-process subagents \u2014 but each of these agents is a separate agent spoken to over the A2A protocol. On the first delegation it is launched from its agentspec: beside the orchestrator on the local server, or on a Datalayer runtime when the orchestrator runs in the cloud."] }), _jsxs(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mb: 0 }, children: ["The remote run streams back over ", _jsx("code", { children: "message/stream" }), ": its text, its tool calls and results, and the task's states, shown here and in the chat as the run goes."] })] })] }));
+}
+export default A2ASidebar;

package/lib/loop/plugins/a2a-sidebar/index.d.ts

@@ -0,0 +1,5 @@
+import type { ReactorReactOutput } from '@datalayer/reactor/react';
+export declare const A2A_SIDEBAR_PLUGIN_NAME = "@datalayer/loop-plugin-a2a-sidebar";
+export declare const A2ASidebarPlugin: import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, ReactorReactOutput>;
+export { A2ASidebar, describeRemoteAgents, remoteStatusOf, type A2ARemoteAgentView, type A2ARemoteStatus, } from './A2ASidebar';
+export default A2ASidebarPlugin;

package/lib/loop/plugins/a2a-sidebar/index.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * `@datalayer/loop-plugin-a2a-sidebar` — the agents reached over A2A, at the
+ * side of the workspace.
+ *
+ * The chat boxes a delegated run under its tool card; this keeps the same box
+ * in view while the chat scrolls, and lists every A2A agent the chat's agent
+ * can reach with where it runs, its card, and what it is doing.
+ *
+ * @module loop/plugins/a2a-sidebar
+ */
+import { definePlugin } from '@datalayer/reactor';
+import { LoopSlots } from '../../core';
+import { A2ASidebar } from './A2ASidebar';
+export const A2A_SIDEBAR_PLUGIN_NAME = '@datalayer/loop-plugin-a2a-sidebar';
+export const A2ASidebarPlugin = definePlugin({
+    name: A2A_SIDEBAR_PLUGIN_NAME,
+    displayName: 'A2A sidebar',
+    description: 'The agents reached over A2A, and the run under way.',
+    octicon: 'broadcast',
+    emoji: '\u{1F4E1}',
+    build: () => ({
+        components: [
+            {
+                id: 'a2a-sidebar',
+                slot: LoopSlots.sidebar,
+                // Part of the work, so above the plugins panel (900).
+                order: 100,
+                Component: ({ workspace }) => (_jsx(A2ASidebar, { workspace: workspace })),
+            },
+        ],
+    }),
+});
+export { A2ASidebar, describeRemoteAgents, remoteStatusOf, } from './A2ASidebar';
+export default A2ASidebarPlugin;