@datalayer/agent-runtimes 1.3.11 → 1.3.13

package/lib/components/a2ui/A2uiMarkdownProvider.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * Provides the A2UI v0.9 markdown renderer to every `A2uiSurface` beneath
+ * it. Without it, `Text` components fall back to the raw markdown string
+ * (`## Title` instead of a rendered heading).
+ *
+ * In the library rather than the examples: the loop's own surface plugin
+ * draws surfaces, and needs the same context the examples had.
+ */
+export declare const A2uiMarkdownProvider: React.FC<React.PropsWithChildren>;
+export default A2uiMarkdownProvider;

package/lib/components/a2ui/A2uiMarkdownProvider.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MarkdownContext } from '@a2ui/react/v0_9';
+import { renderMarkdown } from '@a2ui/markdown-it';
+/**
+ * Provides the A2UI v0.9 markdown renderer to every `A2uiSurface` beneath
+ * it. Without it, `Text` components fall back to the raw markdown string
+ * (`## Title` instead of a rendered heading).
+ *
+ * In the library rather than the examples: the loop's own surface plugin
+ * draws surfaces, and needs the same context the examples had.
+ */
+export const A2uiMarkdownProvider = ({ children, }) => (_jsx(MarkdownContext.Provider, { value: renderMarkdown, children: children }));
+export default A2uiMarkdownProvider;

package/lib/components/a2ui/index.d.ts

@@ -1,2 +1,3 @@
+export * from './A2uiMarkdownProvider';
 export * from './A2uiSurfaceComposed';
 export * from './styles';

package/lib/components/a2ui/index.js

@@ -2,5 +2,6 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
+export * from './A2uiMarkdownProvider';
 export * from './A2uiSurfaceComposed';
 export * from './styles';

package/lib/examples/A2UiAgentExample.js

@@ -25,17 +25,15 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
 import { Box, setupPrimerPortals } from '@datalayer/primer-addons';
 import { Button, Spinner, Text } from '@primer/react';
-import { basicCatalog } from '@a2ui/react/v0_9';
 import { A2UI_RENDER_SCOPE_SX, A2uiSurfaceComposed } from '../components/a2ui';
 import { ThemedProvider } from './utils/themedProvider';
 import { A2uiMarkdownProvider } from './utils/a2uiMarkdownProvider';
 import { useA2uiProcessor } from './utils/a2ui';
+import { createA2uiSurfacePlugin, validateA2uiSubmission, } from '../loop/plugins/a2ui-surface';
 import { useExampleAgentRuntime } from './hooks/useExampleAgentRuntime';
 import { uniqueAgentId } from './utils/agentId';
-import { useSpecRenderToolResult, specRendererClassName, } from './hooks/useSpecRenderToolResult';
 import { LoopEmbed } from '../loop';
 import { AgentA2uiPlugin } from '../loop/plugins/agent-a2ui';
-import { createChatExtrasPlugin } from '../loop/plugins/chat-extras';
 setupPrimerPortals();
 const AGENT_NAME = 'a2ui-agent';
 const AGENTSPEC_ID = 'example-a2ui-agent';
@@ -57,156 +55,6 @@ const SUGGESTIONS = [
         message: 'Make a product configurator for a laptop with CPU, RAM and add-ons.',
     },
 ];
-/**
- * Whether a submitted form value should count as "not provided" for the
- * purpose of required-field validation. Handles the value shapes the A2UI
- * basic catalog emits: strings (text/email), arrays (choice), booleans
- * (checkbox).
- */
-function isEmptyValue(value) {
-    if (value === null || value === undefined) {
-        return true;
-    }
-    if (typeof value === 'string') {
-        return value.trim() === '';
-    }
-    if (Array.isArray(value)) {
-        return value.length === 0;
-    }
-    if (typeof value === 'boolean') {
-        return value === false;
-    }
-    return false;
-}
-/**
- * Basic email format check (matches the intent of the backend `email` field
- * type). Intentionally permissive: requires `local@domain.tld` with no spaces.
- */
-const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-/**
- * Validate a single submitted value against its backend-provided rule. Returns
- * a human-readable error message, or `null` when the value is acceptable.
- */
-function validateFieldValue(rule, value) {
-    const empty = isEmptyValue(value);
-    if (empty) {
-        // Optional fields left blank are fine; only required ones fail here.
-        return rule.required ? `${rule.label} is required.` : null;
-    }
-    if (rule.format === 'email' &&
-        typeof value === 'string' &&
-        !EMAIL_PATTERN.test(value.trim())) {
-        return `${rule.label} must be a valid email address.`;
-    }
-    if (rule.pattern && typeof value === 'string') {
-        let matches;
-        try {
-            matches = new RegExp(rule.pattern).test(value.trim());
-        }
-        catch {
-            matches = true; // Ignore malformed patterns rather than blocking.
-        }
-        if (!matches) {
-            return `${rule.label} is not in the expected format.`;
-        }
-    }
-    if (rule.minLength !== undefined &&
-        typeof value === 'string' &&
-        value.trim().length < rule.minLength) {
-        return `${rule.label} must be at least ${rule.minLength} characters.`;
-    }
-    if (rule.type === 'slider' && typeof value === 'number') {
-        if (rule.min !== undefined && value < rule.min) {
-            return `${rule.label} must be at least ${rule.min}.`;
-        }
-        if (rule.max !== undefined && value > rule.max) {
-            return `${rule.label} must be at most ${rule.max}.`;
-        }
-    }
-    return null;
-}
-/**
- * Normalize a backend tool result (object or JSON string) into A2UI messages,
- * rewriting the catalog id to the frontend catalog so the renderer accepts it.
- */
-function extractToolResult(result) {
-    if (!result) {
-        return null;
-    }
-    let obj = result;
-    if (typeof result === 'string') {
-        try {
-            obj = JSON.parse(result);
-        }
-        catch {
-            return null;
-        }
-    }
-    if (typeof obj !== 'object' ||
-        obj === null ||
-        !Array.isArray(obj.messages)) {
-        return null;
-    }
-    const parsed = obj;
-    const messages = (parsed.messages ?? []).map(message => {
-        const payload = message;
-        if (payload.createSurface &&
-            payload.createSurface.catalogId !== basicCatalog.id) {
-            return {
-                ...payload,
-                createSurface: {
-                    ...payload.createSurface,
-                    catalogId: basicCatalog.id,
-                },
-            };
-        }
-        return message;
-    });
-    return { ...parsed, messages };
-}
-/**
- * Renders a fully interactive A2UI surface *inline* in the chat transcript.
- *
- * Uses its own `useA2uiProcessor` instance (independent from the canvas
- * processor) so the same generated surface can be filled in and submitted from
- * both places. Messages are processed once on mount.
- */
-const InlineA2uiSurface = ({ messages, onAction, validationError }) => {
-    const { surfaces, processMessages, resetSurfaces, themeStyle } = useA2uiProcessor(onAction);
-    const processedRef = useRef(false);
-    useEffect(() => {
-        if (processedRef.current) {
-            return;
-        }
-        processedRef.current = true;
-        resetSurfaces();
-        processMessages(messages);
-    }, [messages, processMessages, resetSurfaces]);
-    if (surfaces.length === 0) {
-        return null;
-    }
-    return (_jsxs(Box, { style: themeStyle, sx: {
-            ...A2UI_RENDER_SCOPE_SX,
-            display: 'flex',
-            flexDirection: 'column',
-            gap: 2,
-        }, children: [validationError && (_jsx(Box, { role: "alert", sx: {
-                    px: 3,
-                    py: 2,
-                    borderRadius: 2,
-                    bg: 'danger.subtle',
-                    border: '1px solid',
-                    borderColor: 'danger.muted',
-                    color: 'danger.fg',
-                    fontSize: 1,
-                }, children: validationError })), surfaces.map(surface => (_jsx(Box, { sx: {
-                    border: '1px solid',
-                    borderColor: 'border.default',
-                    borderRadius: 2,
-                    p: 3,
-                    bg: 'canvas.default',
-                }, children: _jsx(A2uiSurfaceComposed, { surface: surface }) }, surface.id)))] }));
-};
 const A2UiAgentExample = () => {
     const agentName = useMemo(() => uniqueAgentId(AGENT_NAME), []);
     const { agentId, error: chatError, status, isReady, baseUrl, } = useExampleAgentRuntime({
@@ -221,8 +69,6 @@ const A2UiAgentExample = () => {
     const isCreatingChat = !isReady && status !== 'error';
     const [surfaceTitle, setSurfaceTitle] = useState(null);
     const [submissions, setSubmissions] = useState([]);
-    const [pendingPrompt, setPendingPrompt] = useState(undefined);
-    void pendingPrompt;
     const [validationError, setValidationError] = useState(null);
     const submissionSeq = useRef(0);
     // Validation rules per surface id, populated from each tool result so the
@@ -241,9 +87,7 @@ const A2UiAgentExample = () => {
             // Block submission when any field fails validation (required, email
             // format, pattern, length, slider range).
             const rules = fieldRulesBySurfaceRef.current[action.surfaceId] ?? [];
-            const errors = rules
-                .map(rule => validateFieldValue(rule, values[rule.id]))
-                .filter((message) => message !== null);
+            const errors = validateA2uiSubmission(rules, values);
             if (errors.length > 0) {
                 setValidationError({
                     surfaceId: action.surfaceId,
@@ -252,23 +96,19 @@ const A2UiAgentExample = () => {
                 return;
             }
             setValidationError(null);
+            // The canvas copy: recorded here, since the transcript's own copy is
+            // the one that goes back to the agent.
             submissionSeq.current += 1;
-            const seq = submissionSeq.current;
-            setSubmissions(prev => [
-                {
-                    id: seq,
-                    values,
-                },
-                ...prev,
-            ]);
-            // Feed the submission back to the agent so it replies with a confirmation.
-            const title = surfaceTitleRef.current ?? 'the form';
-            const json = JSON.stringify(values, null, 2);
-            setPendingPrompt(`I just submitted "${title}" (submission #${seq}). Here are the values:\n\n\`\`\`json\n${json}\n\`\`\`\n\nPlease confirm you received them and briefly summarize what happens next.`);
+            setSubmissions(prev => [{ id: submissionSeq.current, values }, ...prev]);
         }
     }, []);
     const { surfaces, processMessages, resetSurfaces, themeStyle } = useA2uiProcessor(handleAction);
-    // Stable ref so the memoized renderer can push surfaces without re-creating.
+    /*
+     * The transcript's surfaces are the loop's own — the preset's surface
+     * plugin draws, checks and submits them. This example asks for an instance
+     * of its own so the canvas beside the chat can mirror what was drawn, and
+     * the "Submitted values" panel can record what went back to the agent.
+     */
     const showSurfaceRef = useRef(() => { });
     useEffect(() => {
         showSurfaceRef.current = (messages) => {
@@ -276,59 +116,27 @@ const A2UiAgentExample = () => {
             processMessages(messages);
         };
     }, [resetSurfaces, processMessages]);
-    const processedToolCallIds = useRef(new Set());
-    const renderers = useMemo(() => ({
-        'a2ui-surface': (context, binding) => {
-            const parsed = context.status === 'complete'
-                ? extractToolResult(context.result)
-                : null;
-            if (context.status === 'complete' &&
-                parsed?.messages &&
-                parsed.messages.length > 0 &&
-                context.toolCallId &&
-                !processedToolCallIds.current.has(context.toolCallId)) {
-                processedToolCallIds.current.add(context.toolCallId);
-                showSurfaceRef.current(parsed.messages);
-                setSurfaceTitle(parsed.title ?? 'A2UI surface');
-                if (parsed.surfaceId) {
-                    fieldRulesBySurfaceRef.current[parsed.surfaceId] =
-                        parsed.fieldRules ?? [];
+    const chatPlugins = useMemo(() => [
+        AgentA2uiPlugin,
+        createA2uiSurfacePlugin({
+            onRendered: rendered => {
+                showSurfaceRef.current(rendered.messages);
+                setSurfaceTitle(rendered.title);
+                if (rendered.surfaceId) {
+                    fieldRulesBySurfaceRef.current[rendered.surfaceId] =
+                        rendered.result.fieldRules ?? [];
                 }
                 setValidationError(null);
-            }
-            return (_jsx("div", { className: specRendererClassName(binding), children: context.status === 'complete' &&
-                    parsed?.messages &&
-                    parsed.messages.length > 0 ? (_jsxs(Box, { sx: { display: 'flex', flexDirection: 'column', gap: 2 }, children: [_jsxs(Box, { sx: {
-                                display: 'flex',
-                                alignItems: 'center',
-                                gap: 2,
-                                color: 'fg.muted',
-                            }, children: [_jsx(Text, { sx: { fontSize: 2 }, children: "\uD83C\uDF9B\uFE0F" }), _jsx(Text, { sx: { fontWeight: 'bold', color: 'fg.default' }, children: parsed.title ?? 'A2UI surface' }), _jsx(Text, { sx: { fontSize: 0 }, children: "\u00B7 also in the canvas \u2192 fill it in and submit" })] }), _jsx(InlineA2uiSurface, { messages: parsed.messages, onAction: handleAction, validationError: validationError &&
-                                parsed.surfaceId &&
-                                validationError.surfaceId === parsed.surfaceId
-                                ? validationError.message
-                                : null })] })) : (_jsxs(Box, { sx: {
-                        border: '1px solid',
-                        borderColor: 'border.default',
-                        borderRadius: 2,
-                        px: 3,
-                        py: 2,
-                        bg: 'canvas.default',
-                        display: 'flex',
-                        alignItems: 'center',
-                        gap: 2,
-                    }, children: [_jsx(Spinner, { size: "small" }), _jsx(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: "Rendering A2UI surface..." })] })) }));
-        },
-    }), [handleAction, validationError]);
-    const renderToolResult = useSpecRenderToolResult(AGENTSPEC_ID, renderers);
-    // The chat column is the shared loop on the A2UI capacity plugin; the
-    // example's own surface renderer reaches the transcript through the
-    // chat-extras channel, so tool results still draw as A2UI surfaces.
-    const { plugin: extrasPlugin, setExtras } = useMemo(() => createChatExtrasPlugin(), []);
-    const chatPlugins = useMemo(() => [AgentA2uiPlugin, extrasPlugin], [extrasPlugin]);
-    useEffect(() => {
-        setExtras({ renderToolResult });
-    }, [renderToolResult, setExtras]);
+            },
+            onSubmitted: submitted => {
+                submissionSeq.current += 1;
+                setSubmissions(prev => [
+                    { id: submissionSeq.current, values: submitted.values },
+                    ...prev,
+                ]);
+            },
+        }),
+    ], []);
     const clearCanvas = useCallback(() => {
         resetSurfaces();
         setSurfaceTitle(null);
@@ -446,6 +254,11 @@ const A2UiAgentExample = () => {
                                 justifyContent: 'center',
                                 height: '100%',
                                 gap: 3,
-                            }, children: [_jsx(Spinner, { size: "large" }), _jsx(Text, { sx: { color: 'fg.muted' }, children: "Creating A2UI agent..." })] })) : chatError || !agentId ? (_jsx(Box, { sx: { p: 3 }, children: _jsxs(Text, { sx: { color: 'danger.fg' }, children: ["Failed to initialize chat:", ' ', chatError || 'No agent id returned'] }) })) : (_jsx(LoopEmbed, { serverUrl: baseUrl, target: "local", agentId: agentId, defaultEditor: "none", showHeader: true, plugins: chatPlugins })) })] }) }) }));
+                            }, children: [_jsx(Spinner, { size: "large" }), _jsx(Text, { sx: { color: 'fg.muted' }, children: "Creating A2UI agent..." })] })) : chatError || !agentId ? (_jsx(Box, { sx: { p: 3 }, children: _jsxs(Text, { sx: { color: 'danger.fg' }, children: ["Failed to initialize chat:", ' ', chatError || 'No agent id returned'] }) })) : (_jsx(LoopEmbed, { serverUrl: baseUrl, target: "local", 
+                            // What lets the target take: without the choice the agents
+                            // plugin pins the sandbox to the page, whatever `target` says,
+                            // and the chat then turns in-page, where the server's tools
+                            // do not exist.
+                            showAgentVariants: true, agentId: agentId, defaultEditor: "none", showHeader: true, plugins: chatPlugins })) })] }) }) }));
 };
 export default A2UiAgentExample;

package/lib/examples/A2UiJupyterOutputExample.js

@@ -765,7 +765,17 @@ const A2UiJupyterOutputExample = () => {
                                             borderRadius: 2,
                                             overflow: 'hidden',
                                             bg: 'canvas.default',
-                                        }, children: agentReady && agentId ? (_jsx(LoopEmbed, { serverUrl: serverUrl, target: "local", agentId: agentId, defaultEditor: "none", showHeader: true, plugins: chatPlugins })) : (_jsxs(Box, { sx: {
+                                        }, children: agentReady && agentId ? (_jsx(LoopEmbed, { serverUrl: serverUrl, target: "local", 
+                                            // No `showAgentVariants` on purpose: without the choice the
+                                            // agents plugin pins the sandbox to the page, and this chat is
+                                            // meant to turn in the page. The server agent above speaks
+                                            // vercel-ai and only runs the code; it has no AG-UI route, so a
+                                            // chat addressing it on the server got "404 Not Found". The
+                                            // demo tool below is a frontend tool, and the in-page loop
+                                            // calls it.
+                                            agentId: agentId, defaultEditor: "none", showHeader: true, 
+                                            // A reader asks for one demonstration after another: `+` starts over.
+                                            chatHeaderButtons: true, plugins: chatPlugins })) : (_jsxs(Box, { sx: {
                                                 height: '100%',
                                                 display: 'flex',
                                                 alignItems: 'center',

package/lib/examples/A2UiViewerExample.d.ts

@@ -3,8 +3,15 @@
  *
  * The scene lives in `./scenes/A2UiViewerScene` and arrives as an A2UI scene
  * plugin — one workspace view, ordered ahead of the chat. The rest is the
- * standard chat plugins; there is no agent behind this scene, so the
- * workspace runs on the browser target and costs no server.
+ * standard chat plugins.
+ *
+ * The workspace runs on whatever the header's target says, like the examples
+ * with an agent of their own. It used to be pinned to the browser — there is
+ * no agent behind the scene, so the page was the cheapest place — which left
+ * the header's *Local* selected and ignored: the sandbox stayed in the page.
+ * On Local the loop asks the local agent-runtimes server for its shell agent
+ * and the Jupyter server that agent starts beside itself, which is what
+ * choosing Local means everywhere else here.
  *
  * @module examples/A2UiViewerExample
  */

package/lib/examples/A2UiViewerExample.js

@@ -8,8 +8,15 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *
  * The scene lives in `./scenes/A2UiViewerScene` and arrives as an A2UI scene
  * plugin — one workspace view, ordered ahead of the chat. The rest is the
- * standard chat plugins; there is no agent behind this scene, so the
- * workspace runs on the browser target and costs no server.
+ * standard chat plugins.
+ *
+ * The workspace runs on whatever the header's target says, like the examples
+ * with an agent of their own. It used to be pinned to the browser — there is
+ * no agent behind the scene, so the page was the cheapest place — which left
+ * the header's *Local* selected and ignored: the sandbox stayed in the page.
+ * On Local the loop asks the local agent-runtimes server for its shell agent
+ * and the Jupyter server that agent starts beside itself, which is what
+ * choosing Local means everywhere else here.
  *
  * @module examples/A2UiViewerExample
  */
@@ -17,6 +24,8 @@ import { useMemo } from 'react';
 import { Box, setupPrimerPortals } from '@datalayer/primer-addons';
 import { ThemedProvider } from './utils/themedProvider';
 import { LoopEmbed } from '../loop';
+import { useRuntimeTargetStore } from './utils/runtimeTargetStore';
+import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
 import { defineA2uiScenePlugin } from '../loop/plugins/a2ui-scene';
 setupPrimerPortals();
 const ScenePlugin = defineA2uiScenePlugin({
@@ -25,8 +34,29 @@ const ScenePlugin = defineA2uiScenePlugin({
     description: 'Paste A2UI protocol messages and watch the surface they describe.',
     load: () => import('./scenes/A2UiViewerScene'),
 });
+const AGENTSPEC_ID = 'example-a2ui-viewer';
 const A2UiViewerExample = () => {
+    /*
+     * The agent's surfaces, and what pressing their Submit does, are the
+     * loop's own: its spec binds `render_a2ui_surface` to the `a2ui-surface`
+     * renderer, and the preset's surface plugin draws, checks and submits.
+     * Nothing here but the scene.
+     */
     const plugins = useMemo(() => [ScenePlugin], []);
-    return (_jsx(ThemedProvider, { children: _jsx(Box, { sx: { height: '100vh', minHeight: 0 }, children: _jsx(LoopEmbed, { target: "browser", agentId: "loop-shell", defaultEditor: "none", showHeader: true, plugins: plugins }) }) }));
+    // The header's choice; the shell remounts this example when it changes.
+    const target = useRuntimeTargetStore(state => state.target);
+    const serverUrl = useExampleAgentRuntimesUrl();
+    return (_jsx(ThemedProvider, { children: _jsx(Box, { sx: { height: '100vh', minHeight: 0 }, children: _jsx(LoopEmbed, { target: target, 
+                // An in-page agent has no server to ask; the others need to know
+                // where theirs is.
+                serverUrl: target === 'browser' ? undefined : serverUrl, agentId: AGENTSPEC_ID, 
+                // What a server target creates that agent from. Without it the
+                // chat on Local posted to an agent nobody had created — a 404.
+                localAgentSpec: AGENTSPEC_ID, 
+                // What lets the header's target take: without the choice the
+                // sandbox plugin pins itself to the page, whatever `target` says.
+                showAgentVariants: true, defaultEditor: "none", showHeader: true, 
+                // A reader asks for one surface after another: `+` starts over.
+                chatHeaderButtons: true, plugins: plugins }) }) }));
 };
 export default A2UiViewerExample;

package/lib/examples/main.js

@@ -259,6 +259,23 @@ const ensureLocalJupyterToken = () => {
         setJupyterServerToken(DEFAULT_LOCAL_JUPYTER_SERVER_TOKEN);
     }
 };
+/**
+ * Whether somebody signed in to this browser and is still signed in.
+ *
+ * The shell's own persisted sign-in, or the token core stored at sign-in —
+ * either one is a person, and a configured key must not stand in for them.
+ */
+const hasPersistedSignIn = () => {
+    try {
+        if (useSimpleAuthStore.getState().token) {
+            return true;
+        }
+        return Boolean(window.localStorage.getItem(DATALAYER_IAM_TOKEN_KEY));
+    }
+    catch {
+        return false;
+    }
+};
 // Load configurations from DOM
 const loadConfigurations = () => {
     // Load Datalayer configuration
@@ -277,36 +294,22 @@ const loadConfigurations = () => {
             if (datalayerConfig.iamUrl) {
                 datalayerConfig.runtimesUrl = resolveRuntimesUrl(datalayerConfig.runtimesUrl);
                 coreStore.getState().setConfiguration(datalayerConfig);
-                // Also set the token in the IAM store for API authentication
-                if (datalayerConfig.token) {
-                    // Use the setLogin method to set the token in IAM store
-                    // For now, we'll just set a minimal user object since we don't have full user data
-                    iamStore.getState().setLogin({
-                        id: 'example-id',
-                        handle: 'example-user',
-                        email: 'example@datalayer.com',
-                        firstName: 'Example',
-                        lastName: 'User',
-                        initials: 'EU',
-                        displayName: 'Example User',
-                        avatarUrl: '',
-                        roles: [],
-                        setRoles: () => { },
-                        iamProviders: [],
-                        settings: {},
-                        unsubscribedFromOutbounds: false,
-                        onboarding: {
-                            clients: {
-                                Platform: 0,
-                                JupyterLab: 0,
-                                CLI: 0,
-                                VSCode: 0,
-                            },
-                            position: 'top',
-                            tours: {},
-                        },
-                        events: [],
-                    }, datalayerConfig.token);
+                /*
+                  A configured token — `VITE_DATALAYER_API_KEY` — is for a browser
+                  nobody has signed in to. Somebody's own sign-in wins over it.
+        
+                  This used to sign the configured token in as a made-up user,
+                  `example-id`, on every load. Core claims the browser's session for
+                  whoever signs in and forgets it when a *different* person appears —
+                  and a made-up user is a different person from whoever really signed
+                  in, so every refresh wiped the real session: token, user and the
+                  persisted sign-in of the shell. Now the token is only set, and core
+                  asks IAM who it belongs to, which claims the session under the real
+                  identity or logs the token out if IAM refuses it.
+                */
+                if (datalayerConfig.token && !hasPersistedSignIn()) {
+                    iamStore.setState({ token: datalayerConfig.token });
+                    void iamStore.getState().refreshUserByToken(datalayerConfig.token);
                 }
             }
         }
@@ -476,12 +479,11 @@ const AgentRuntimesIAMCallback = () => {
         const providerAccessToken = provider
             ? params.get(`${provider}_access_token`)
             : null;
+        // Only the providers whose token the browser is handed. A LinkedIn or
+        // Bluesky token never leaves IAM (IBrowserTokenProviderName), so there is
+        // nothing of theirs to keep here.
         if (providerAccessToken &&
-            (provider === 'github' ||
-                provider === 'google' ||
-                provider === 'linkedin' ||
-                provider === 'okta' ||
-                provider === 'bluesky')) {
+            (provider === 'github' || provider === 'google' || provider === 'okta')) {
             iamStore
                 .getState()
                 .setIAMProviderAccessToken(provider, providerAccessToken);

package/lib/examples/utils/a2uiMarkdownProvider.d.ts

@@ -1,7 +1 @@
-import React from 'react';
-/**
- * Provides the A2UI v0.9 markdown renderer to all child `A2uiSurface`
- * instances. Without it, `Text` components fall back to the raw markdown
- * string (e.g. `## Title` instead of a rendered `<h2>`).
- */
-export declare const A2uiMarkdownProvider: React.FC<React.PropsWithChildren>;
+export { A2uiMarkdownProvider } from '../../components/a2ui';

package/lib/examples/utils/a2uiMarkdownProvider.js

@@ -1,9 +1,7 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { MarkdownContext } from '@a2ui/react/v0_9';
-import { renderMarkdown } from '@a2ui/markdown-it';
-/**
- * Provides the A2UI v0.9 markdown renderer to all child `A2uiSurface`
- * instances. Without it, `Text` components fall back to the raw markdown
- * string (e.g. `## Title` instead of a rendered `<h2>`).
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
  */
-export const A2uiMarkdownProvider = ({ children, }) => (_jsx(MarkdownContext.Provider, { value: renderMarkdown, children: children }));
+// Moved into the library, beside the surface components: the loop's own
+// surface plugin needs the same context the examples had.
+export { A2uiMarkdownProvider } from '../../components/a2ui';

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

@@ -183,12 +183,25 @@ export type LoopWorkspaceContext = {
  * publishes, a mounted view subscribes, and neither imports the other.
  */
 export type PromptChannel = {
-    /** Publish a prompt. Returns whether anything was listening. */
+    /**
+     * Publish a prompt. Returns whether it will be answered: `false` only when
+     * nothing is listening and nothing is coming — a view that has not mounted
+     * yet holds the message instead (see {@link createPromptChannel}).
+     */
     submit: (message: string) => boolean;
     /** Listen for prompts. Returns an unsubscribe. */
     subscribe: (listener: (message: string) => void) => () => void;
 };
-/** Create a prompt channel. The shell owns one per workspace. */
+/**
+ * Create a prompt channel. The shell owns one per workspace.
+ *
+ * The shell's composer is on screen before the view that answers it: the
+ * editor and its sandbox are megabytes and take a moment, and the prompt is
+ * ready to type into immediately. A message sent in that moment used to be
+ * dropped — it appeared in the conversation and was never answered, and the
+ * only way to find out was to send it again — so an unheard message is held
+ * and handed to the first view that subscribes, in the order it was sent.
+ */
 export declare function createPromptChannel(): PromptChannel;
 /**
  * What the active view tells the shell about itself.
@@ -205,6 +218,15 @@ export type ViewControls = {
     stop?: () => void;
     /** Start the view's work over — the chat resets its conversation. */
     newChat?: () => void;
+    /**
+     * Say something as the reader: the chat sends it as the next turn.
+     *
+     * For whatever speaks on the reader's behalf — a form pressed on a
+     * rendered surface, whose values the agent should answer. The chat had
+     * this control from the start and kept it to itself; a host with a
+     * message had no way in.
+     */
+    send?: (message: string) => void;
 };
 /** Props every view receives. */
 export type LoopViewProps = {
@@ -548,6 +570,15 @@ export type LoopChatExtrasValue = {
      * on the chip's text, which is how the chat tells openers apart already.
      */
     hiddenOpeners?: string[];
+    /**
+     * Every opener off, however many there are.
+     *
+     * `hiddenOpeners` takes a page's exceptions by name; this is the page that
+     * wants none of them — a landing page whose composer has moved under a
+     * conversation that has started, where a row of openers over it would be
+     * offering a first question to somebody who has already asked one.
+     */
+    hideOpeners?: boolean;
     /**
      * Told what the agent has used, each time the chat learns it.
      *