@datalayer/agent-runtimes 1.3.90 → 1.3.91

package/lib/chat/words.d.ts

@@ -20,6 +20,13 @@ export type ChatWords = {
     demoKeyExpired: string;
     /** The person's key has run out. */
     keyExpired: string;
+    /**
+     * No runtime is assigned to the conversation on Datalayer (the pool had
+     * none, or its launch was refused), with why: nothing is sent.
+     */
+    noRuntime: (reason: string) => string;
+    /** Its runtime is still being assigned: nothing is sent until it is. */
+    runtimeStarting: string;
     /** The empty chat's title. */
     startConversation: string;
     /** The empty chat's line when it has no starters. */

package/lib/chat/words.js

@@ -30,6 +30,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Suggested prompts',
         demoKeyExpired: 'This demo runs on a shared key, and its time is up. Sign in to keep going.',
         keyExpired: 'Your key has expired. Sign in to keep going.',
+        noRuntime: reason => `No runtime is assigned to this conversation, so nothing can be sent. ${reason}`,
+        runtimeStarting: 'Its runtime is being assigned: you can send once it is.',
         startConversation: 'Start a conversation',
         sendToBegin: 'Send a message to begin chatting',
         copyTurn: 'Copy this turn',
@@ -99,6 +101,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Suggestions de questions',
         demoKeyExpired: 'Cette démo utilise une clé partagée, et son temps est écoulé. Connectez-vous pour continuer.',
         keyExpired: 'Votre clé a expiré. Connectez-vous pour continuer.',
+        noRuntime: reason => `Aucun runtime n’est attribué à cette conversation : rien ne peut être envoyé. ${reason}`,
+        runtimeStarting: 'Son runtime est en cours d’attribution : vous pourrez envoyer une fois qu’il le sera.',
         startConversation: 'Commencer une conversation',
         sendToBegin: 'Envoyez un message pour commencer',
         copyTurn: 'Copier cet échange',
@@ -170,6 +174,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Preguntas sugeridas',
         demoKeyExpired: 'Esta demo usa una clave compartida y su tiempo se ha agotado. Inicia sesión para continuar.',
         keyExpired: 'Tu clave ha caducado. Inicia sesión para continuar.',
+        noRuntime: reason => `No hay ningún runtime asignado a esta conversación, así que no se puede enviar nada. ${reason}`,
+        runtimeStarting: 'Se le está asignando un runtime: podrás enviar cuando lo tenga.',
         startConversation: 'Empieza una conversación',
         sendToBegin: 'Envía un mensaje para empezar',
         copyTurn: 'Copiar este turno',
@@ -241,6 +247,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Vorgeschlagene Fragen',
         demoKeyExpired: 'Diese Demo läuft mit einem geteilten Schlüssel, und ihre Zeit ist abgelaufen. Melde dich an, um weiterzumachen.',
         keyExpired: 'Dein Schlüssel ist abgelaufen. Melde dich an, um weiterzumachen.',
+        noRuntime: reason => `Diesem Gespräch ist keine Runtime zugewiesen, daher kann nichts gesendet werden. ${reason}`,
+        runtimeStarting: 'Eine Runtime wird zugewiesen: Du kannst senden, sobald sie da ist.',
         startConversation: 'Ein Gespräch beginnen',
         sendToBegin: 'Sende eine Nachricht, um zu beginnen',
         copyTurn: 'Diesen Austausch kopieren',
@@ -312,6 +320,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Domande suggerite',
         demoKeyExpired: 'Questa demo usa una chiave condivisa e il suo tempo è scaduto. Accedi per continuare.',
         keyExpired: 'La tua chiave è scaduta. Accedi per continuare.',
+        noRuntime: reason => `Nessun runtime è assegnato a questa conversazione, quindi non si può inviare nulla. ${reason}`,
+        runtimeStarting: 'Gli si sta assegnando un runtime: potrai inviare appena sarà pronto.',
         startConversation: 'Inizia una conversazione',
         sendToBegin: 'Invia un messaggio per iniziare',
         copyTurn: 'Copia questo scambio',
@@ -383,6 +393,8 @@ export const CHAT_WORDS = {
         suggestedPrompts: 'Perguntas sugeridas',
         demoKeyExpired: 'Esta demonstração usa uma chave compartilhada e o tempo dela acabou. Entre para continuar.',
         keyExpired: 'Sua chave expirou. Entre para continuar.',
+        noRuntime: reason => `Nenhum runtime está atribuído a esta conversa, então nada pode ser enviado. ${reason}`,
+        runtimeStarting: 'Um runtime está sendo atribuído: você poderá enviar assim que estiver.',
         startConversation: 'Comece uma conversa',
         sendToBegin: 'Envie uma mensagem para começar',
         copyTurn: 'Copiar esta troca',

package/lib/components/a2ui/styles.js

@@ -36,21 +36,32 @@ export const A2UI_RENDER_SCOPE_SX = {
     '& .a2ui-caption': {
         color: 'var(--a2ui-text-caption-color, var(--a2ui-color-on-surface, #656d76))',
     },
+    /*
+     * A button is the theme's filled button (STUDIO P-04, T-30): its fill and
+     * its label are Primer's primary-button properties, which every theme and
+     * an application's accent set together (`themeAccentVars`), so the label
+     * is always the accent's own text on it. The label is a Text inside the
+     * button, which the `.a2ui-text` rule above paints in the surface's ink —
+     * a dark label on Spatial's dark accent — so it inherits the button's.
+     */
     '& .a2ui-button': {
         appearance: 'none',
         cursor: 'pointer',
-        border: '1px solid var(--a2ui-color-primary, #1f883d)',
-        background: 'var(--a2ui-color-primary, #1f883d)',
-        color: 'var(--a2ui-color-on-primary, #ffffff)',
+        border: '1px solid var(--button-primary-bgColor-rest)',
+        background: 'var(--button-primary-bgColor-rest)',
+        color: 'var(--button-primary-fgColor-rest)',
         borderRadius: 'var(--a2ui-button-border-radius, 6px)',
         padding: 'var(--a2ui-button-padding, 5px 16px)',
         fontWeight: 'var(--a2ui-button-font-weight, 500)',
         boxShadow: 'var(--a2ui-button-box-shadow, none)',
         transition: 'background-color 0.15s ease, border-color 0.15s ease',
     },
+    '& .a2ui-button .a2ui-text': {
+        color: 'inherit',
+    },
     '& .a2ui-button:hover': {
-        background: 'var(--a2ui-color-primary-hover, #1a7f37)',
-        borderColor: 'var(--a2ui-color-primary-hover, #1a7f37)',
+        background: 'var(--button-primary-bgColor-hover)',
+        borderColor: 'var(--button-primary-bgColor-hover)',
     },
     '& .a2ui-button:disabled': {
         opacity: 0.6,

package/lib/loop/apps/AppFeedback.js

@@ -5,7 +5,7 @@ import { ThumbsdownIcon, ThumbsupIcon } from '@primer/octicons-react';
 import { contribution, definePlugin, signal } from '@datalayer/reactor';
 import { useContributions, useSignalValue } from '@datalayer/reactor/react';
 import { useIAMStore } from '../../state';
-import { LoopChatTurn, LoopPromptPanel, } from '../core';
+import { LoopChatTurn, LoopPromptPanel, agentServerOf, } from '../core';
 import { answerIdOf, FEEDBACK_WORDS, sendFeedback } from './feedback';
 export const APP_FEEDBACK_PLUGIN_NAME = '@datalayer/loop-plugin-app-feedback';
 /* A signal to read when no chat contributed a turn: the hook needs one. */
@@ -28,11 +28,20 @@ export function AppFeedback({ app, workspace, }) {
     const thread = turn.thread;
     const choice = liked?.turn === turn.id ? liked.liked : null;
     const done = said?.turn === turn.id ? said : null;
-    const agentBaseUrl = workspace.sandbox.agentBaseUrl || workspace.serverUrl || '';
+    // The runtime that answered: none, nothing is sent (no stand-in server).
+    const agentBaseUrl = agentServerOf(workspace.sandbox, workspace.serverUrl);
     const send = async () => {
         if (choice === null) {
             return;
         }
+        if (agentBaseUrl === undefined) {
+            setSaid({
+                turn: turn.id,
+                state: 'refused',
+                says: FEEDBACK_WORDS.noRuntime,
+            });
+            return;
+        }
         setSaid({ turn: turn.id, state: 'sending', says: '' });
         try {
             await sendFeedback({
@@ -64,7 +73,7 @@ export function AppFeedback({ app, workspace, }) {
             flexDirection: 'column',
             gap: 4,
             padding: '4px 8px',
-        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 4 }, children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.ask }), _jsx(IconButton, { size: "small", variant: choice === true ? 'default' : 'invisible', icon: ThumbsupIcon, "aria-label": FEEDBACK_WORDS.liked, "aria-pressed": choice === true, onClick: () => setLiked({ turn: turn.id, liked: true }) }), _jsx(IconButton, { size: "small", variant: choice === false ? 'default' : 'invisible', icon: ThumbsdownIcon, "aria-label": FEEDBACK_WORDS.disliked, "aria-pressed": choice === false, onClick: () => setLiked({ turn: turn.id, liked: false }) })] }), choice !== null ? (_jsxs(_Fragment, { children: [_jsx(Textarea, { "aria-label": FEEDBACK_WORDS.comment, placeholder: FEEDBACK_WORDS.comment, value: comment, rows: 2, resize: "vertical", block: true, onChange: event => setComment(event.target.value) }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx(Button, { size: "small", variant: "default", disabled: done?.state === 'sending', onClick: () => void send(), children: FEEDBACK_WORDS.send }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.where(app.name) })] })] })) : null, done?.state === 'refused' ? (
+        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 4 }, children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.ask }), _jsx(IconButton, { size: "small", variant: choice === true ? 'default' : 'invisible', icon: ThumbsupIcon, "aria-label": FEEDBACK_WORDS.liked, "aria-pressed": choice === true, unsafeDisableTooltip: true, onClick: () => setLiked({ turn: turn.id, liked: true }) }), _jsx(IconButton, { size: "small", variant: choice === false ? 'default' : 'invisible', icon: ThumbsdownIcon, "aria-label": FEEDBACK_WORDS.disliked, "aria-pressed": choice === false, unsafeDisableTooltip: true, onClick: () => setLiked({ turn: turn.id, liked: false }) })] }), choice !== null ? (_jsxs(_Fragment, { children: [_jsx(Textarea, { "aria-label": FEEDBACK_WORDS.comment, placeholder: FEEDBACK_WORDS.comment, value: comment, rows: 2, resize: "vertical", block: true, onChange: event => setComment(event.target.value) }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx(Button, { size: "small", variant: "default", disabled: done?.state === 'sending', onClick: () => void send(), children: FEEDBACK_WORDS.send }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.where(app.name) })] })] })) : null, done?.state === 'refused' ? (
             // Said in the ink, as an alert: not a verdict, so not its colour.
             _jsx(Text, { role: "alert", sx: { fontSize: 0, color: 'fg.default' }, children: done.says })) : null] }));
 }

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

@@ -32,13 +32,14 @@ export declare const answerIdOf: (answers: number) => string | undefined;
 /** What the feedback strip says, in a person's words. */
 export declare const FEEDBACK_WORDS: {
     readonly ask: "Was this answer useful?";
-    readonly liked: "Useful";
-    readonly disliked: "Not useful";
+    readonly liked: "This answer was useful";
+    readonly disliked: "This answer was not useful";
     readonly comment: "Anything to add? (optional)";
     readonly send: "Send";
     readonly kept: (app: string) => string;
     readonly where: (app: string) => string;
     readonly tooLong: "A comment is at most 2000 characters.";
+    readonly noRuntime: "No runtime is assigned to this conversation, so nothing can be sent.";
     readonly noSession: "This conversation has no name the application knows yet: send a message first.";
 };
 /** Whether an application keeps feedback: its record names it. */

package/lib/loop/apps/feedback.js

@@ -9,13 +9,15 @@ export const answerIdOf = (answers) => answers > 0 ? `answer-${answers}` : undef
 /** What the feedback strip says, in a person's words. */
 export const FEEDBACK_WORDS = {
     ask: 'Was this answer useful?',
-    liked: 'Useful',
-    disliked: 'Not useful',
+    // The thumbs' names (P-24): what pressing one says of the answer.
+    liked: 'This answer was useful',
+    disliked: 'This answer was not useful',
     comment: 'Anything to add? (optional)',
     send: 'Send',
     kept: (app) => `Thank you. Kept in ${app}’s record.`,
     where: (app) => `What you say is kept with this conversation in ${app}’s record, for its builder to read.`,
     tooLong: `A comment is at most ${FEEDBACK_COMMENT_LIMIT} characters.`,
+    noRuntime: 'No runtime is assigned to this conversation, so nothing can be sent.',
     noSession: 'This conversation has no name the application knows yet: send a message first.',
 };
 /** Whether an application keeps feedback: its record names it. */

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

@@ -8,6 +8,7 @@ import type { ContextSnapshotData } from '../../types/context';
 import type { AssistantCharacter } from '../../chat/assistant/characters';
 import type { AssistantCharacterData } from '../../chat/assistant/formats/types';
 import type { PresenceState } from '../../chat/presence/presenceStatus';
+import type { ChatWords } from '../../chat/words';
 /** Lifecycle of the sandbox a workspace is attached to. */
 export type SandboxState = 'idle' | 'starting' | 'running' | 'stopping' | 'error';
 /** What the workspace knows about the sandbox behind it. */
@@ -53,6 +54,24 @@ export type SandboxSnapshot = {
      */
     agentBaseUrl?: string;
 };
+/**
+ * The agent-runtimes server a workspace's agent is on, or nothing while
+ * there is none.
+ *
+ * On Datalayer the agent is on its runtime and nowhere else: until one is
+ * assigned there is nothing to address, and the host's own server is not a
+ * stand-in — on a hosted page it is the page's own origin, which answered a
+ * question with a 404 while the pool had no runtime (STUDIO P-24, round 9).
+ * Every other target's agent is on the host's server, or on the one its
+ * sandbox names.
+ */
+export declare function agentServerOf(sandbox: Pick<SandboxSnapshot, 'target' | 'agentBaseUrl'>, serverUrl: string): string | undefined;
+/**
+ * What is said while {@link agentServerOf} names no server: the runtime is
+ * being assigned, or — its launch refused, the pool empty — none is, and
+ * why. One sentence for the chat, the page and the computer alike.
+ */
+export declare function noRuntimeSaid(sandbox: Pick<SandboxSnapshot, 'state' | 'errorReason'>, words: Pick<ChatWords, 'noRuntime' | 'runtimeStarting'>): string;
 /**
  * What a view reads while the sandbox plugin is absent.
  *

package/lib/loop/core/index.js

@@ -14,6 +14,33 @@
  * @module loop/core
  */
 import { defineContributionPoint, defineGate } from '@datalayer/reactor';
+/**
+ * The agent-runtimes server a workspace's agent is on, or nothing while
+ * there is none.
+ *
+ * On Datalayer the agent is on its runtime and nowhere else: until one is
+ * assigned there is nothing to address, and the host's own server is not a
+ * stand-in — on a hosted page it is the page's own origin, which answered a
+ * question with a 404 while the pool had no runtime (STUDIO P-24, round 9).
+ * Every other target's agent is on the host's server, or on the one its
+ * sandbox names.
+ */
+export function agentServerOf(sandbox, serverUrl) {
+    if (sandbox.target === 'datalayer') {
+        return sandbox.agentBaseUrl || undefined;
+    }
+    return sandbox.agentBaseUrl || serverUrl;
+}
+/**
+ * What is said while {@link agentServerOf} names no server: the runtime is
+ * being assigned, or — its launch refused, the pool empty — none is, and
+ * why. One sentence for the chat, the page and the computer alike.
+ */
+export function noRuntimeSaid(sandbox, words) {
+    return sandbox.state === 'error'
+        ? words.noRuntime(sandbox.errorReason ?? '')
+        : words.runtimeStarting;
+}
 /**
  * What a view reads while the sandbox plugin is absent.
  *

package/lib/loop/plugins/app-computer/AppComputer.js

@@ -5,7 +5,8 @@ import { Box } from '@datalayer/primer-addons';
 import { signal } from '@datalayer/reactor';
 import { useContributions, useSignalValue } from '@datalayer/reactor/react';
 import { useIAMStore } from '@datalayer/core/lib/state/substates/IAMState';
-import { LoopChatTurn, } from '../../core';
+import { useChatWords } from '../../../chat/ChatLanguage';
+import { LoopChatTurn, agentServerOf, noRuntimeSaid, IDLE_SANDBOX_SNAPSHOT, } from '../../core';
 import { COMPUTER_PARTS, COMPUTER_WORDS, computerParts, downloadComputerFile, handBackComputer, hasComputer, listComputerFiles, parentOf, partsOff, readComputer, runOnComputer, takeOverComputer, terminalEntries, } from '../../apps/computer';
 const NO_TURN = signal({ id: 0, status: 'idle' });
 const NO_CONVERSATION = signal([]);
@@ -109,9 +110,23 @@ export function AppComputer({ app, workspace, }) {
             setEnded(turn.id);
         }
     }, [settled, turn.id]);
-    const serverUrl = workspace?.sandbox.agentBaseUrl || workspace?.serverUrl || '';
+    const chatText = useChatWords();
+    /*
+     * The runtime its agent is on, or nothing while none is assigned: then the
+     * computer is asked nothing and says why, rather than asking the host's
+     * server (on a hosted page, the page's own origin). Outside a workspace
+     * there is none either.
+     */
+    const serverUrl = workspace
+        ? agentServerOf(workspace.sandbox, workspace.serverUrl)
+        : undefined;
+    const noRuntime = serverUrl === undefined
+        ? noRuntimeSaid(workspace?.sandbox ?? IDLE_SANDBOX_SNAPSHOT, chatText)
+        : undefined;
     const agentId = workspace?.agentId || app.id;
-    const context = useMemo(() => ({ serverUrl, agentId, token: token || undefined }), [serverUrl, agentId, token]);
+    const context = useMemo(() => serverUrl === undefined
+        ? undefined
+        : { serverUrl, agentId, token: token || undefined }, [serverUrl, agentId, token]);
     const parts = computerParts(app);
     const [state, setState] = useState();
     const [error, setError] = useState('');
@@ -125,6 +140,9 @@ export function AppComputer({ app, workspace, }) {
         };
     }, []);
     const read = useCallback(() => {
+        if (!context) {
+            return;
+        }
         readComputer(context).then(found => {
             if (alive.current) {
                 setState(found);
@@ -135,11 +153,14 @@ export function AppComputer({ app, workspace, }) {
     }, [context]);
     const used = hasComputer(parts);
     useEffect(() => {
-        if (used && serverUrl) {
+        if (used && context) {
             read();
         }
-    }, [used, serverUrl, read, ended]);
+    }, [used, context, read, ended]);
     const act = (step) => {
+        if (!context) {
+            return;
+        }
         setBusy(true);
         step(context).then(() => {
             if (alive.current) {
@@ -154,10 +175,10 @@ export function AppComputer({ app, workspace, }) {
         });
     };
     const me = Boolean(state?.yours);
-    return (_jsxs(Box, { "data-testid": "app-computer", children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: COMPUTER_WORDS.title }), _jsx(Parts, { app: app }), !used ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0, mt: 1 }, children: COMPUTER_WORDS.none })) : (_jsxs(_Fragment, { children: [_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0, mt: 1 }, children: COMPUTER_WORDS.noBrowser }), error ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'danger.fg', m: 0, mt: 2 }, children: error })) : null, state ? (_jsxs(Box, { mt: 2, "data-testid": "computer-holder", children: [_jsx(Text, { as: "p", sx: { fontSize: 1, m: 0, mb: 1 }, children: !state.held
+    return (_jsxs(Box, { "data-testid": "app-computer", children: [_jsx(Heading, { as: "h3", sx: { fontSize: 2, mb: 2 }, children: COMPUTER_WORDS.title }), _jsx(Parts, { app: app }), !used ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0, mt: 1 }, children: COMPUTER_WORDS.none })) : (_jsxs(_Fragment, { children: [_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0, mt: 1 }, children: COMPUTER_WORDS.noBrowser }), noRuntime ? (_jsx(Text, { as: "p", role: "status", sx: { fontSize: 1, color: 'fg.default', m: 0, mt: 2 }, children: noRuntime })) : null, error ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'danger.fg', m: 0, mt: 2 }, children: error })) : null, state && context ? (_jsxs(Box, { mt: 2, "data-testid": "computer-holder", children: [_jsx(Text, { as: "p", sx: { fontSize: 1, m: 0, mb: 1 }, children: !state.held
                                     ? COMPUTER_WORDS.agentHas
                                     : me
                                         ? COMPUTER_WORDS.youHave
-                                        : COMPUTER_WORDS.someoneHas }), !state.held ? (_jsx(Button, { size: "small", disabled: busy, onClick: () => act(takeOverComputer), children: COMPUTER_WORDS.takeOver })) : me ? (_jsxs(_Fragment, { children: [_jsx(Button, { size: "small", variant: "primary", disabled: busy, onClick: () => act(handBackComputer), children: COMPUTER_WORDS.handBack }), _jsx(YourTerminal, { context: context })] })) : null] })) : null, _jsx(Terminal, { conversation: conversation }), state ? (_jsx(Files, { context: context, state: state, ended: ended })) : null] }))] }));
+                                        : COMPUTER_WORDS.someoneHas }), !state.held ? (_jsx(Button, { size: "small", disabled: busy, onClick: () => act(takeOverComputer), children: COMPUTER_WORDS.takeOver })) : me ? (_jsxs(_Fragment, { children: [_jsx(Button, { size: "small", variant: "primary", disabled: busy, onClick: () => act(handBackComputer), children: COMPUTER_WORDS.handBack }), _jsx(YourTerminal, { context: context })] })) : null] })) : null, _jsx(Terminal, { conversation: conversation }), state && context ? (_jsx(Files, { context: context, state: state, ended: ended })) : null] }))] }));
 }
 export default AppComputer;

package/lib/loop/plugins/app-page/AppPage.js

@@ -5,7 +5,8 @@ import { Box } from '@datalayer/primer-addons';
 import { signal } from '@datalayer/reactor';
 import { useContributions, useSignalValue } from '@datalayer/reactor/react';
 import { catalogOfBlocks } from '../../../components/a2ui';
-import { LoopCanvasBlock, LoopChatTurn, } from '../../core';
+import { useChatWords } from '../../../chat/ChatLanguage';
+import { LoopCanvasBlock, LoopChatTurn, agentServerOf, noRuntimeSaid, } from '../../core';
 import { InlineSurface, SURFACE_CATALOG_ID, } from '../a2ui-surface/InlineSurface';
 import { useOwnComponents } from '../a2ui-surface/ownComponents';
 import { appPageAction, appPageData, appPageMessages, pageInputsOf, pageOf, } from './appPageModel';
@@ -73,12 +74,25 @@ export function AppPage({ app, workspace }) {
         ...outputsData(outputs),
     }), [app, turn, conversation, outputs]);
     const token = useIAMStore(state => state.token) ?? '';
-    const pageContext = useRef({ serverUrl: '', agentId: '' });
-    pageContext.current = {
-        serverUrl: workspace.sandbox?.agentBaseUrl || workspace.serverUrl || '',
-        agentId: workspace.agentId || app.id,
-        token: token || undefined,
-    };
+    const chatText = useChatWords();
+    /*
+     * Where its page runs: the runtime its agent is on, or nothing while none
+     * is assigned — then a run is not sent and the page says why, rather than
+     * reaching for the host's server (on a hosted page, the page's own origin).
+     */
+    const pageServer = agentServerOf(workspace.sandbox, workspace.serverUrl);
+    const pageContext = useRef(null);
+    pageContext.current =
+        pageServer === undefined
+            ? null
+            : {
+                serverUrl: pageServer,
+                agentId: workspace.agentId || app.id,
+                token: token || undefined,
+            };
+    const noRuntime = useRef('');
+    noRuntime.current =
+        pageServer === undefined ? noRuntimeSaid(workspace.sandbox, chatText) : '';
     const pageSession = useRef(null);
     const pageRunning = useRef(false);
     const pageNext = useRef(null);
@@ -96,6 +110,10 @@ export function AppPage({ app, workspace }) {
                 const next = pageNext.current;
                 pageNext.current = null;
                 const context = pageContext.current;
+                if (!context) {
+                    setRefusal(noRuntime.current);
+                    continue;
+                }
                 try {
                     pageSession.current ??= openPageSession(context);
                     const turn = await runPageIn(context, await pageSession.current, next);

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

@@ -41,7 +41,7 @@ import { AGENTS_PLUGIN_NAME } from '../agents/plugin';
 import { useConfig } from '../../../hooks/useConfig';
 import { useSkills, useSkillActions } from '../../../hooks/useSkills';
 import { AI_MODEL_CATALOGUE, isChatModel } from '../../../specs/models';
-import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
+import { LoopAgentBlueprint, LoopAgentGate, LoopChatComposer, LoopChatExtras, LoopChatHeader, LoopChatLayout, LoopChatSuggestion, LoopChatSurface, LoopChatTurn, LoopCommand, LoopFrontendTool, LoopRunProps, LoopSlots, agentServerOf, noRuntimeSaid, canOpenView, runForwardedProps, onPromptFocusRequest, onSurfaceRequest, useLoopPromptStore, } from '../../core';
 import { messageText, turnWritersOf } from './turnState';
 import { isInactiveSurfaceContribution, orderToolContributions, toolsForChatView, } from './chatViewTools';
 import { useAgentCommandTools } from '../../../tools/adapters/commands';
@@ -946,8 +946,12 @@ export default function ChatView({ workspace }) {
      * opened against. Addressing the latter would be talking to a machine that
      * has never heard of it. The same value for every other target, where the
      * two are the same server.
+     *
+     * Nothing while a Datalayer runtime is not assigned (the pool had none, or
+     * it is still being given): the chat is off and says so below, rather than
+     * sending to the host's server — on a hosted page, the page's own origin.
      */
-    const agentServerUrl = workspace.sandbox.agentBaseUrl || workspace.serverUrl;
+    const agentServerUrl = agentServerOf(workspace.sandbox, workspace.serverUrl);
     /*
      * Who a single request may be addressed to.
      *
@@ -1041,12 +1045,25 @@ export default function ChatView({ workspace }) {
      * Studio's Preview and the hosted page, rather than left unanswered.
      */
     const ambient = useChatAvailability();
-    const chatDisabled = gateBlocked || keyExpired || Boolean(inPageRefusal) || ambient.disabled;
+    /*
+     * No agent to talk to: a Datalayer runtime not assigned (STUDIO P-24,
+     * round 9). Said in a sentence — why, when its launch was refused — and
+     * nothing is sent; the header does not say *Ready*.
+     */
+    const noRuntime = agentServerUrl === undefined
+        ? noRuntimeSaid(workspace.sandbox, chatText)
+        : undefined;
+    const chatDisabled = gateBlocked ||
+        keyExpired ||
+        Boolean(inPageRefusal) ||
+        Boolean(noRuntime) ||
+        ambient.disabled;
     const disabledReason = keyExpired
         ? expiredKeyIsTemporary
             ? chatText.demoKeyExpired
             : chatText.keyExpired
         : (inPageRefusal ??
+            noRuntime ??
             gateReason ??
             (ambient.disabled ? ambient.disableReason : undefined));
     /*
@@ -1250,6 +1267,10 @@ export default function ChatView({ workspace }) {
             ? openedThread.thread
             : undefined
         : givenThread;
+    /*
+     * None without a server (`noRuntime`): the chat is off and connects to
+     * nothing — no address is made up for it.
+     */
     const protocol = useMemo(() => inPage
         ? browserProtocolConfig({
             agentId: member?.specId ?? agentId,
@@ -1280,23 +1301,25 @@ export default function ChatView({ workspace }) {
             // its session API does on a runtime.
             modeEffect: blueprintTurn?.modeEffect,
         })
-        : {
-            type: 'ag-ui',
-            // An application's agent is spoken to through its session API
-            // (LOOP R-04): each thread a session, recorded under its uid,
-            // run in the name the application runs in, and taking what the
-            // page did besides the message — the same AG-UI events back.
-            endpoint: runsApp
-                ? `${agentServerUrl}/api/v1/apps/agents/${encodeURIComponent(agentId)}/ag-ui/`
-                : `${agentServerUrl}/api/v1/ag-ui/${agentId}/`,
-            ...(runsApp && iamToken ? { authToken: iamToken } : {}),
-            agentId,
-            // `/api/v1/configure`, not `/api/v1/configure/config`: the hooks
-            // strip one trailing `config`/`configure` segment to find the API
-            // base, so the longer form doubles it.
-            configEndpoint: `${agentServerUrl}/api/v1/configure`,
-            enableConfigQuery: true,
-        }, [
+        : agentServerUrl !== undefined
+            ? {
+                type: 'ag-ui',
+                // An application's agent is spoken to through its session API
+                // (LOOP R-04): each thread a session, recorded under its uid,
+                // run in the name the application runs in, and taking what the
+                // page did besides the message — the same AG-UI events back.
+                endpoint: runsApp
+                    ? `${agentServerUrl}/api/v1/apps/agents/${encodeURIComponent(agentId)}/ag-ui/`
+                    : `${agentServerUrl}/api/v1/ag-ui/${agentId}/`,
+                ...(runsApp && iamToken ? { authToken: iamToken } : {}),
+                agentId,
+                // `/api/v1/configure`, not `/api/v1/configure/config`: the hooks
+                // strip one trailing `config`/`configure` segment to find the API
+                // base, so the longer form doubles it.
+                configEndpoint: `${agentServerUrl}/api/v1/configure`,
+                enableConfigQuery: true,
+            }
+            : undefined, [
         agentId,
         inPage,
         inference,
@@ -1321,7 +1344,7 @@ export default function ChatView({ workspace }) {
      * need one, and a browser agent has none — hence the menus below being
      * gated on the data rather than switched on unconditionally.
      */
-    const configQuery = useConfig(!inPage, protocol.type === 'ag-ui' ? protocol.configEndpoint : undefined, undefined, agentId);
+    const configQuery = useConfig(!inPage, protocol?.type === 'ag-ui' ? protocol.configEndpoint : undefined, undefined, agentId);
     const skillsQuery = useSkills(true);
     const skillActions = useSkillActions(agentId);
     // `undefined` until the runtime answers: its answer is then the list.
@@ -1338,7 +1361,7 @@ export default function ChatView({ workspace }) {
          * catalogue that was never going to arrive. The agentspecs catalogue below
          * is the answer for this case and needs no request at all.
          */
-        if (inPage) {
+        if (inPage || agentServerUrl === undefined) {
             return undefined;
         }
         let cancelled = false;
@@ -1424,7 +1447,7 @@ export default function ChatView({ workspace }) {
      */
     const selectModel = useCallback(async (model) => {
         setPickedModel(model);
-        if (inPage) {
+        if (inPage || agentServerUrl === undefined) {
             return;
         }
         await fetch(`${agentServerUrl}/api/v1/configure/inference/provider`, {
@@ -1663,7 +1686,9 @@ export default function ChatView({ workspace }) {
                         brandIcon: presence?.face ? (_jsx(PresenceFace, { face: presence.face, size: 20, state: presenceNow })) : (_jsx(BrandIcon, { size: 20 })), 
                         // An application says what it is doing, in plain words, beside
                         // its name (T-08); an agent's chat keeps its header as it is.
-                        headerContent: presence ? _jsx(PresenceLine, { state: presenceNow }) : undefined, emptyState: {
+                        headerContent: 
+                        // Not *Ready* with no runtime: the header says why instead.
+                        presence && !noRuntime ? (_jsx(PresenceLine, { state: presenceNow })) : undefined, emptyState: {
                             // An application's own face, at the page's size of the three
                             // (LOOP T-08, T-19): the thing a person's eye lands on first.
                             icon: presence?.face ? (_jsx("span", { "aria-hidden": true, style: { fontSize: FACE_LARGE, lineHeight: 1 }, children: _jsx(FaceDrawing, { face: presence.face, size: FACE_LARGE }) })) : (_jsx(BrandIcon, { size: 48 })),

package/package.json

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