@datalayer/agent-runtimes 1.3.19 → 1.3.20

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

@@ -20,5 +20,14 @@ export type AppRendererProps = Omit<LoopEmbedProps, 'agentId'> & {
     /** The application to render. */
     app: AppSpec;
 };
+/**
+ * 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, ...embed }: AppRendererProps): React.JSX.Element;
 export default AppRenderer;

package/lib/loop/apps/AppRenderer.js

@@ -73,6 +73,8 @@ 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 }) {
     const chatOnly = app.interface.layout === 'chat';
@@ -87,6 +89,28 @@ 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),
+        }
+        : undefined, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [source]);
     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 +120,9 @@ 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, datalayerCreatePayload: datalayerCreatePayload, ...embed, plugins: allPlugins }));
 }
 export default AppRenderer;

package/lib/loop/embed/LoopEmbed.js

@@ -63,6 +63,10 @@ export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions,
     [
         preset.serverUrl,
         preset.target,
+        preset.datalayerAgentSpecId,
+        preset.targetFixed,
+        // 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/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/presets.d.ts

@@ -120,6 +120,12 @@ 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 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, 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.
@@ -88,6 +88,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.20",
     "type": "module",
     "workspaces": [
         ".",