@datalayer/agent-runtimes 1.3.19 → 1.3.21

package/lib/chat/messages/ChatMessageList.js

@@ -679,7 +679,18 @@ export function ChatMessageList({ displayItems, isLoading, isStreaming, showLoad
                                                 }, children: message.directedTo.name })] })) : speaker.role ? (_jsx(Label, { size: "small", children: speaker.role })) : null, message.createdAt ? (_jsx(RelativeTime, { datetime: message.createdAt.toISOString(), sx: { fontSize: 0, color: 'fg.muted' } })) : null] })) : null, _jsxs(Box, { sx: {
                                     p: 2,
                                     overflowX: 'auto',
-                                    borderRadius: 2,
+                                    // The theme's bubble (LOOP T-03, T-06): today's 6px elsewhere.
+                                    borderRadius: 'var(--theme-radius-bubble, 6px)',
+                                    // A message arriving, at the theme's pace (LOOP T-10): no
+                                    // motion in a theme that sets none, nor when motion is reduced.
+                                    animation: 'chatMessageArrive var(--theme-motion-message, 0ms) var(--theme-motion-easing, ease) both',
+                                    '@keyframes chatMessageArrive': {
+                                        from: { opacity: 0, transform: 'translateY(4px)' },
+                                        to: { opacity: 1, transform: 'none' },
+                                    },
+                                    '@media (prefers-reduced-motion: reduce)': {
+                                        animation: 'none',
+                                    },
                                     backgroundColor: isUser
                                         ? 'accent.emphasis'
                                         : speaker
@@ -748,7 +759,7 @@ export function ChatMessageList({ displayItems, isLoading, isStreaming, showLoad
                                 display: 'flex',
                                 alignItems: 'center',
                                 p: 2,
-                                borderRadius: 2,
+                                borderRadius: 'var(--theme-radius-bubble, 6px)',
                                 bg: 'canvas.subtle',
                                 minHeight: '32px',
                             }, children: _jsx(TypingDots, {}) })] }) })), _jsx("div", { ref: messagesEndRef })] }));

package/lib/chat/prompt/InputPromptBase.js

@@ -212,7 +212,8 @@ export function InputPromptBase({ variant = 'lexical', placeholder = 'Ask anythi
                 }, sx: {
                     border: '1px solid',
                     borderColor: 'border.default',
-                    borderRadius: 2,
+                    // The theme's card (LOOP T-03, T-06): today's 6px elsewhere.
+                    borderRadius: 'var(--theme-radius-card, 6px)',
                     bg: 'canvas.default',
                     overflow: 'hidden',
                     transition: 'border-color 0.2s ease',

package/lib/loop/apps/AppRenderer.d.ts

@@ -16,9 +16,29 @@ export declare const agentIdOf: (app: Pick<AppSpec, "agent" | "team">) => string
  * is not an agent spec, and is refused here rather than launched as one.
  */
 export declare function defineAppPlugin(app: AppSpec): ReactorPlugin<Record<string, never>, unknown, unknown>;
+/** Which instance of an application runs, as the platform knows it (LOOP R-07). */
+export type AppInstance = {
+    /** Its `app` item. */
+    appUid?: string;
+    /** The deployment it runs as, when it is one. */
+    deploymentUid?: string;
+    /** The version that runs. */
+    version?: number;
+};
 export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
     /** The application to render. */
     app: AppSpec;
+    /** What its record is kept under, on Datalayer: the application, its deployment. */
+    instance?: AppInstance;
 };
-export declare function AppRenderer({ app, plugins, ...embed }: AppRendererProps): React.JSX.Element;
+/**
+ * An application in a LOOP workspace: its agent, its starters, its layout.
+ *
+ * Every other prop is `LoopEmbed`'s, and wins over what the application
+ * implies — a host that wants the editors beside a chat still says so.
+ */
+/** No host plugins: one array, so that it never reads as a change. */
+/** The agentspec a runtime is allocated with before an application's agent is created on it. */
+export declare const DATALAYER_BOOTSTRAP_AGENTSPEC = "example-simple";
+export declare function AppRenderer({ app, plugins, instance, ...embed }: AppRendererProps): React.JSX.Element;
 export default AppRenderer;

package/lib/loop/apps/AppRenderer.js

@@ -73,8 +73,10 @@ export function defineAppPlugin(app) {
  * implies — a host that wants the editors beside a chat still says so.
  */
 /** No host plugins: one array, so that it never reads as a change. */
+/** The agentspec a runtime is allocated with before an application's agent is created on it. */
+export const DATALAYER_BOOTSTRAP_AGENTSPEC = 'example-simple';
 const NO_PLUGINS = [];
-export function AppRenderer({ app, plugins = NO_PLUGINS, ...embed }) {
+export function AppRenderer({ app, plugins = NO_PLUGINS, instance, ...embed }) {
     const chatOnly = app.interface.layout === 'chat';
     /*
      * The application plugin, made once per application. `LoopEmbed` rebuilds
@@ -87,6 +89,37 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, ...embed }) {
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [source]);
     const allPlugins = useMemo(() => (appPlugin ? [appPlugin, ...plugins] : plugins), [appPlugin, plugins]);
+    /*
+     * On Datalayer, the application runs on a runtime: allocated with a plain
+     * agentspec, its agent created there with the application's spec — so that
+     * the runtime registers it and decides every tool call by its rules (LOOP
+     * R-03, R-05), as `loop apps run --cloud` does.
+     */
+    const datalayerCreatePayload = useMemo(() => app.agent
+        ? {
+            // Under the application's id, over AG-UI: what the workspace's
+            // chat addresses (`agentId` below).
+            name: app.id,
+            transport: 'ag-ui',
+            agent_spec_id: agentIdOf(app),
+            app_spec: dumpAppspec(app),
+            // Code Mode calls every tool through `execute_code`, which an
+            // application without a shell is refused: its tools are called
+            // one by one instead, each decided by its rules.
+            enable_codemode: Boolean(app.permissions?.computer?.shell),
+            ...(instance
+                ? {
+                    app_instance: {
+                        app_uid: instance.appUid ?? '',
+                        deployment_uid: instance.deploymentUid ?? '',
+                        version: instance.version ?? 0,
+                    },
+                }
+                : {}),
+        }
+        : undefined, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [source, instance?.appUid, instance?.deploymentUid, instance?.version]);
     if (!appPlugin) {
         return (_jsxs("div", { role: "status", style: { padding: 16 }, children: ["\u201C", app.name, "\u201D is run by a team, which the workspace does not run as an application yet."] }));
     }
@@ -96,6 +129,12 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, ...embed }) {
     , { 
         // The application's own agent: created under its id, so that its
         // spec is applied to an agent of its own, never to the one it extends.
-        agentId: app.id, editors: !chatOnly, showViewSelector: !chatOnly, teamPicker: false, showAgentVariants: false, graph: false, pluginsPanel: false, ...embed, plugins: allPlugins }));
+        agentId: app.id, editors: !chatOnly, showViewSelector: !chatOnly, teamPicker: false, showAgentVariants: false, graph: false, pluginsPanel: false, datalayerAgentSpecId: DATALAYER_BOOTSTRAP_AGENTSPEC, 
+        // Where an application runs is decided by its host — the Studio's
+        // Preview, the hosted page — not offered to its user.
+        targetFixed: true, 
+        // Applications first (LOOP T-12): an application's conversation wears
+        // the `loop` theme; a host may say otherwise.
+        themeVariant: "loop", datalayerCreatePayload: datalayerCreatePayload, ...embed, plugins: allPlugins }));
 }
 export default AppRenderer;

package/lib/loop/apps/checks.d.ts

@@ -9,6 +9,8 @@ export interface AppCheck {
     attention: string[];
     setup: string[];
 }
+/** The Guards the runtime executes (agent-runtimes `loop/apps/guards.py`). */
+export declare const EXECUTED_GUARDS: readonly string[];
 /** The instant checks of an application as an editor holds it. */
 export declare function checkApp(app: AppSpec, read?: string[]): AppCheck;
 /**

package/lib/loop/apps/checks.js

@@ -256,8 +256,26 @@ function attentionNotes(app) {
     if (app.record.include.length === 0) {
         notes.push('It keeps no record of what it did.');
     }
+    // A Guard the runtime does not run checks nothing (LOOP R-06): said here,
+    // where the builder decides, rather than found out in production.
+    for (const ref of app.checks.guards) {
+        const guard = own(GUARD_CATALOGUE, idOf(ref));
+        if (guard && !EXECUTED_GUARDS.includes(guard.id)) {
+            const judge = guard.method === 'cog'
+                ? 'a Cog'
+                : guard.method === 'human'
+                    ? 'a person'
+                    : 'a method';
+            notes.push(`The ${guard.name} is judged by ${judge} the runtime does not run yet: nothing is checked by it.`);
+        }
+    }
     return notes;
 }
+/** The Guards the runtime executes (agent-runtimes `loop/apps/guards.py`). */
+export const EXECUTED_GUARDS = [
+    'sensitive-data-guard',
+    'tool-use-policy-guard',
+];
 /** Whether a spec of the catalogue says it is not offered today. */
 const isOff = (spec) => {
     const fields = (spec ?? {});

package/lib/loop/embed/LoopEmbed.js

@@ -63,6 +63,11 @@ export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions,
     [
         preset.serverUrl,
         preset.target,
+        preset.datalayerAgentSpecId,
+        preset.targetFixed,
+        preset.themeVariant,
+        // By its content: an application's spec written inline is a new object each render.
+        JSON.stringify(preset.datalayerCreatePayload ?? null),
         preset.defaultEditor,
         preset.showViewSelector,
         preset.hideChatHeader,

package/lib/loop/index.d.ts

@@ -66,4 +66,4 @@ 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';
-export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, type BehaviourOptions, type ToolArguments, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, type AppCheck, defineAppPlugin, type AppRendererProps, readAppspecYaml, writeAppspecYaml, type ParsedAppspec, } from './apps';
+export { BEHAVIOURS as APP_BEHAVIOUR_ORDER, DEFAULT_BEHAVIOURS as APP_DEFAULT_BEHAVIOURS, behaviourFor, classesOf, isReadOnly, toolBehaviours, toolEscalations, type BehaviourOptions, type ToolArguments, APP_SCHEMA, APPSPEC_KEY_ORDER, DEFAULT_LAYOUTS as APP_DEFAULT_LAYOUTS, dumpAppspec, emptyAppspec, parseAppspec, AppRenderer, checkApp, checkAppspec, type AppCheck, defineAppPlugin, type AppRendererProps, type AppInstance, readAppspecYaml, writeAppspecYaml, type ParsedAppspec, } from './apps';

package/lib/loop/plugins/agents/DatalayerAgentBridge.js

@@ -19,8 +19,9 @@ import { useOptionalSandboxService } from './useSandboxService';
 const DEFAULT_DATALAYER_AGENTSPEC = 'jupyter-tutor';
 export function DatalayerAgentBridge() {
     const reactor = useReactorPlatform();
-    const agentSpecId = reactor.getConfig(AGENTS_PLUGIN_NAME)?.datalayerAgentSpecId ??
-        DEFAULT_DATALAYER_AGENTSPEC;
+    const agentsConfig = reactor.getConfig(AGENTS_PLUGIN_NAME);
+    const agentSpecId = agentsConfig?.datalayerAgentSpecId ?? DEFAULT_DATALAYER_AGENTSPEC;
+    const createPayload = agentsConfig?.datalayerCreatePayload;
     const service = useOptionalSandboxService();
     const target = useSignalValue(service?.target ?? IDLE_SANDBOX_TARGET_SIGNAL);
     const onDatalayer = target === 'datalayer';
@@ -45,12 +46,21 @@ export function DatalayerAgentBridge() {
      * spec id in it and hands that over. Same thing, said in the place the
      * creation actually looks.
      */
+    // An application names its own agent and transport; a bare spec, the spec's.
+    const agentName = typeof createPayload?.name === 'string' ? createPayload.name : agentSpecId;
+    const protocol = createPayload?.transport === 'ag-ui' ||
+        createPayload?.transport === 'vercel-ai'
+        ? createPayload.transport
+        : undefined;
     const agentConfig = useMemo(() => ({
-        name: agentSpecId,
+        name: agentName,
+        ...(protocol ? { protocol } : {}),
         agentSpecId,
         model: AGENTSPECS[agentSpecId]?.model,
         description: AGENTSPECS[agentSpecId]?.description,
-    }), [agentSpecId]);
+        // An application's spec, when the workspace runs one.
+        ...(createPayload ? { createPayload } : {}),
+    }), [agentSpecId, agentName, protocol, createPayload]);
     const { runtime, status, error } = useAgentRuntimes({
         agentSpecId,
         agentConfig,

package/lib/loop/plugins/agents/plugin.d.ts

@@ -73,6 +73,18 @@ export type AgentsConfig = {
      * The other targets take their agent from wherever they already run one.
      */
     datalayerAgentSpecId?: string;
+    /**
+     * What the agent created on that runtime is created with besides its spec:
+     * an application's `app_spec`, so that the runtime runs the application and
+     * decides its tool calls by its rules (LOOP R-05, R-03).
+     */
+    datalayerCreatePayload?: Record<string, unknown>;
+    /**
+     * The target is the host's decision, not the reader's: started there even
+     * with the control hidden. For an application that runs where it is
+     * deployed; a workspace leaves it unset.
+     */
+    targetFixed?: boolean;
 };
 export type AgentsOutput = {
     sandbox: SwitchableSandboxService;

package/lib/loop/plugins/agents/plugin.js

@@ -57,8 +57,10 @@ export const AgentsPlugin = definePlugin({
             sandbox: createSwitchableSandboxService({
                 serverUrl: config.serverUrl,
                 // Pinned when there is no choice to make: a host that hid the control
-                // must not be started on a target the reader cannot move off.
-                initialTarget: showVariants ? config.target : 'browser',
+                // must not be started on a target the reader cannot move off — unless
+                // the host fixed the target itself, as an application deployed on
+                // Datalayer is (AppRenderer): there is nothing for the reader to move.
+                initialTarget: showVariants || config.targetFixed ? config.target : 'browser',
                 kernelSource: config.kernelSource,
                 localAgent: config.localAgent,
                 // The capacity plugins' say, read at switch time — lazily, because a

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

@@ -1397,10 +1397,10 @@ export default function ChatView({ workspace }) {
                             ? 'attention.muted'
                             : 'danger.muted',
                     }, children: chatExtras.errorBanner.message })) : null, _jsx(Box, { sx: { flex: '1 1 auto', minHeight: 0, display: 'flex' }, children: _jsx(ChatBase
-                    // The header says why, beside the title, for the same reason the
-                    // placeholder does: a dead control with no explanation is worse
-                    // than an absent one.
+                    // The theme it wears, when the host names one (an application's).
                     , { 
+                        // The theme it wears, when the host names one (an application's).
+                        themeVariant: config?.themeVariant, 
                         // The header says why, beside the title, for the same reason the
                         // placeholder does: a dead control with no explanation is worse
                         // than an absent one.

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

@@ -1,5 +1,11 @@
 /** What a host may set on the chat. */
 export type ChatPluginConfig = {
+    /**
+     * The theme the conversation wears, by name: the person's unless said. An
+     * application says `loop` (LOOP T-06, T-12) — the conversation then takes
+     * the theme's bubbles, pills and colours whatever the page around it wears.
+     */
+    themeVariant?: string;
     /**
      * What the empty prompt says.
      *

package/lib/loop/presets.d.ts

@@ -120,6 +120,14 @@ export type LoopPresetOptions = {
     teamId?: string;
     /** What a local agent is created from, when one is. */
     localAgent?: AgentsConfig['localAgent'];
+    /** The agentspec a Datalayer runtime is allocated with (the `datalayer` target). */
+    datalayerAgentSpecId?: string;
+    /** What the agent on that runtime is created with besides its spec — an `app_spec`. */
+    datalayerCreatePayload?: Record<string, unknown>;
+    /** The target is the host's to fix, even with the agent control hidden. */
+    targetFixed?: boolean;
+    /** The theme the conversation wears, by name; the person's unless said. */
+    themeVariant?: string;
     /**
      * The agentspec the local agent is created from, by id.
      *

package/lib/loop/presets.js

@@ -52,7 +52,7 @@ 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, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = 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, floatingPrompt = false, editorSelector = false, editors = true, graph = false, commandPalette = false, pluginsPanel = false, windowFrame = false, firstPromptHook, } = options;
     return [
         // The chat owns the editor beside it, so which one opens is its
         // configuration rather than the workspace's.
@@ -68,6 +68,7 @@ export function loopPlugins(options = {}) {
             autoFocusPrompt,
             suggestionLabels,
             fullScreenTopOffset,
+            themeVariant,
         }),
         // The composer and the title bar are plugins of their own: the chat
         // assembles their props, these render them. In the preset by default —
@@ -88,6 +89,9 @@ export function loopPlugins(options = {}) {
         configurePlugin(AgentsPlugin, {
             serverUrl,
             target,
+            datalayerAgentSpecId,
+            datalayerCreatePayload,
+            targetFixed,
             showAgentVariants,
             showAgentSummary: agentSummary,
             teamId,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.19",
+    "version": "1.3.21",
     "type": "module",
     "workspaces": [
         ".",