@datalayer/agent-runtimes 1.3.90 → 1.3.93

package/dist-embed/datalayer-app.js

@@ -0,0 +1,4 @@
+[diffend] Oversized file quarantined before diffing.
+name: package/dist-embed/datalayer-app.js
+size: 61290574 bytes
+sha256: 6c6e8ca337bfb08e2a5bdb0bd38aff8df124448d068ffd8f39af80975686a273

package/dist-embed/lite-service-worker.js

@@ -0,0 +1,91 @@
+const CACHE = "precache";
+const broadcast = new BroadcastChannel("/api/drive.v1");
+let enableCache = false;
+self.addEventListener("install", onInstall);
+self.addEventListener("activate", onActivate);
+self.addEventListener("fetch", onFetch);
+function onInstall(event) {
+  void self.skipWaiting();
+  event.waitUntil(cacheAll());
+}
+function onActivate(event) {
+  const searchParams = new URL(location.href).searchParams;
+  enableCache = searchParams.get("enableCache") === "true";
+  event.waitUntil(self.clients.claim());
+}
+async function onFetch(event) {
+  const {
+    request
+  } = event;
+  const url = new URL(event.request.url);
+  if (url.pathname === "/api/service-worker-heartbeat") {
+    event.respondWith(new Response("ok"));
+    return;
+  }
+  let responsePromise = null;
+  if (shouldBroadcast(url)) {
+    responsePromise = broadcastOne(request);
+  } else if (!shouldDrop(request, url)) {
+    responsePromise = maybeFromCache(event);
+  }
+  if (responsePromise) {
+    event.respondWith(responsePromise);
+  }
+}
+async function maybeFromCache(event) {
+  const {
+    request
+  } = event;
+  if (!enableCache) {
+    return await fetch(request);
+  }
+  let response = await fromCache(request);
+  if (response) {
+    event.waitUntil(refetch(request));
+  } else {
+    response = await fetch(request);
+    event.waitUntil(updateCache(request, response.clone()));
+  }
+  return response;
+}
+async function fromCache(request) {
+  const cache = await openCache();
+  const response = await cache.match(request);
+  if (!response || response.status === 404) {
+    return null;
+  }
+  return response;
+}
+async function refetch(request) {
+  const fromServer = await fetch(request);
+  await updateCache(request, fromServer);
+  return fromServer;
+}
+function shouldBroadcast(url) {
+  return url.origin === location.origin && url.pathname.includes("/api/drive");
+}
+function shouldDrop(request, url) {
+  return request.method !== "GET" || url.origin.match(/^http/) === null || url.pathname.includes("/api/");
+}
+async function broadcastOne(request) {
+  const promise = new Promise((resolve) => {
+    broadcast.onmessage = (event) => {
+      resolve(new Response(JSON.stringify(event.data)));
+    };
+  });
+  const message = await request.json();
+  message.receiver = "broadcast.ts";
+  broadcast.postMessage(message);
+  return await promise;
+}
+async function openCache() {
+  return await caches.open(CACHE);
+}
+async function updateCache(request, response) {
+  const cache = await openCache();
+  return cache.put(request, response);
+}
+async function cacheAll() {
+  const cache = await openCache();
+  return await cache.addAll([]);
+}

package/lib/{loop → apps}/apps/AppComposer.d.ts

@@ -26,7 +26,7 @@
  * P-26), its words are theirs; the composer's own, the chat's language's
  * (`useChatLanguage`).
  *
- * @module loop/apps/AppComposer
+ * @module apps/apps/AppComposer
  */
 import { type JSX } from 'react';
 import type { AppSpec, AppStarterSpec } from '../../types/agentspecs';

package/lib/{loop → apps}/apps/AppComposer.js

@@ -31,7 +31,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * P-26), its words are theirs; the composer's own, the chat's language's
  * (`useChatLanguage`).
  *
- * @module loop/apps/AppComposer
+ * @module apps/apps/AppComposer
  */
 import { useRef } from 'react';
 import { ActionList, ActionMenu, IconButton, Text, Token } from '@primer/react';

package/lib/{loop → apps}/apps/AppFeedback.d.ts

@@ -10,7 +10,7 @@
  * application whose record keeps feedback, in the Studio's Preview and on
  * the hosted page alike.
  *
- * @module loop/apps/AppFeedback
+ * @module apps/apps/AppFeedback
  */
 import type { JSX } from 'react';
 import type { AppSpec } from '../../types/agentspecs';

package/lib/{loop → apps}/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}/apps/AppKept.d.ts

@@ -7,7 +7,7 @@
  * `AppRenderer` adds the plugin for an application that runs as a
  * deployment — at its address, embedded — not for its builder's Preview.
  *
- * @module loop/apps/AppKept
+ * @module apps/apps/AppKept
  */
 import type { JSX } from 'react';
 import type { AppSpec } from '../../types/agentspecs';

package/lib/{loop → apps}/apps/AppRenderer.d.ts

@@ -42,7 +42,7 @@
  * function: `appPreset`, the preset per kind, as `loopPlugins` is for the
  * examples.
  *
- * @module loop/apps/AppRenderer
+ * @module apps/apps/AppRenderer
  */
 import { type ComponentType } from 'react';
 import { type PluginRef, type ReactorExtension, type ReactorPlugin } from '@datalayer/reactor';

package/lib/{loop → apps}/apps/AppRenderer.js

@@ -47,7 +47,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * function: `appPreset`, the preset per kind, as `loopPlugins` is for the
  * examples.
  *
- * @module loop/apps/AppRenderer
+ * @module apps/apps/AppRenderer
  */
 import { useMemo } from 'react';
 import { defineExtension, } from '@datalayer/reactor';
@@ -125,7 +125,7 @@ export function defineAppPlugin(app, shown = app) {
         suggestions: startersAsOpeners(shown.interface.starters),
         // In the page, the agent is told what a runtime tells it: its own
         // spec's prompt, then the application's instructions; on the
-        // application's model when it names one (`loop/apps/agent`).
+        // application's model when it names one (`apps/apps/agent`).
         instructions: app.instructions,
         model: app.model,
         // Its modes and its profiles (LOOP P-19, P-20), as the session API

package/lib/{loop → apps}/apps/AppRuntimePlugins.js

@@ -26,7 +26,7 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * A plugin of its own, with no backend requirement, so that it keeps
  * listening while the application's plugin is stood down. It renders nothing.
  *
- * @module loop/apps/AppRuntimePlugins
+ * @module apps/apps/AppRuntimePlugins
  */
 import { useCallback, useEffect } from 'react';
 import { definePlugin } from '@datalayer/reactor';

package/lib/{loop → apps}/apps/agent.js

@@ -13,7 +13,7 @@
  * browser, so it resolves it the same way: an application on a Cog that the
  * page looked up among the agentspecs alone ran with no instructions at all.
  *
- * @module loop/apps/agent
+ * @module apps/apps/agent
  */
 import { getAgentspecs } from '../../specs/agents';
 import { getCog } from '../../specs/cogs';

package/lib/{loop → apps}/apps/appspec.d.ts

@@ -22,7 +22,7 @@
  *
  * Pure: nothing here calls a service or renders.
  *
- * @module loop/apps/appspec
+ * @module apps/apps/appspec
  */
 import type { AppAccent, AppThemeMode, AppThemeVariant, AppAssistantCharacter, AppEmbedMode, AppCustomComponentSpec, AppVoiceSpec, AppKind, AppLayout, AppPageOutputComponent, AppSpec } from '../../types/agentspecs';
 /** The version of the spec itself. */

package/lib/{loop → apps}/apps/checks.js

@@ -22,7 +22,7 @@
  *
  * Pure: nothing here calls a service.
  *
- * @module loop/apps/checks
+ * @module apps/apps/checks
  */
 import { getAgentspecs } from '../../specs/agents';
 import { getCog } from '../../specs/cogs';

package/lib/{loop → apps}/apps/composer.d.ts

@@ -7,7 +7,7 @@
  *
  * Pure: no React, no network.
  *
- * @module loop/apps/composer
+ * @module apps/apps/composer
  */
 import type { AppCommandSpec, AppModeEffect, AppProfileSpec, AppSpec, AppStarterSpec } from '../../types/agentspecs';
 /** Where a command's prompt takes the words typed after it. */

package/lib/{loop → apps}/apps/computer.d.ts

@@ -7,7 +7,7 @@
  *
  * Pure but for `fetch`: no React.
  *
- * @module loop/apps/computer
+ * @module apps/apps/computer
  */
 import type { AppSpec } from '../../types/agentspecs';
 import type { ConversationEntry } from '../core';

package/lib/{loop → apps}/apps/customComponents.js

@@ -14,7 +14,7 @@
  * does not open. How it is drawn, in a sandboxed frame of no origin, is
  * `components/a2ui/custom`.
  *
- * @module loop/apps/customComponents
+ * @module apps/apps/customComponents
  */
 import { getComponent } from '../../specs/uiPlugins';
 /** Its name: a word starting with a capital letter, as the catalog's are named. */

package/lib/{loop → apps}/apps/feedback.d.ts

@@ -10,7 +10,7 @@
  *
  * Pure: no React; the network is the `fetch` it is handed.
  *
- * @module loop/apps/feedback
+ * @module apps/apps/feedback
  */
 import type { AppSpec } from '../../types/agentspecs';
 /** The longest comment kept, as the runtime holds it (`COMMENT_LIMIT`). */
@@ -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}/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 → apps}/apps/hostTools.d.ts

@@ -4,7 +4,7 @@
  * each function it offers. Apart from `embed/hostBridge`, which calls the
  * page, so that the checks read them as a pure module.
  *
- * @module loop/apps/hostTools
+ * @module apps/apps/hostTools
  */
 import type { AppHostBridgeSpec, AppHostUser } from '../../types/agentspecs';
 /** The tool its agent reads what the page passes it with. */

package/lib/{loop → apps}/apps/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Applications in LOOP: what an application does when its agent calls a tool.
  *
- * @module loop/apps
+ * @module apps/apps
  */
 export * from './agent';
 export * from './AppComposer';

package/lib/{loop → apps}/apps/index.js

@@ -5,7 +5,7 @@
 /**
  * Applications in LOOP: what an application does when its agent calls a tool.
  *
- * @module loop/apps
+ * @module apps/apps
  */
 export * from './agent';
 export * from './AppComposer';

package/lib/{loop → apps}/apps/kept.d.ts

@@ -10,7 +10,7 @@
  *
  * Pure: no React.
  *
- * @module loop/apps/kept
+ * @module apps/apps/kept
  */
 import type { AppSpec } from '../../types/agentspecs';
 import type { ChatTurnSnapshot } from '../core';

package/lib/{loop → apps}/apps/language.d.ts

@@ -17,7 +17,7 @@
  *
  * Pure: no React, no network ({@link preferredLanguages} reads the browser's).
  *
- * @module loop/apps/language
+ * @module apps/apps/language
  */
 import type { AppInterfaceSpec, AppSpec } from '../../types/agentspecs';
 /**

package/lib/{loop → apps}/apps/pluginPair.d.ts

@@ -13,7 +13,7 @@
  * The page follows what its runtime holds with Reactor's
  * `useBackendPluginStream`, on `appPluginsBase` (`AppRuntimePlugins`).
  *
- * @module loop/apps/pluginPair
+ * @module apps/apps/pluginPair
  */
 import type { SandboxSnapshot } from '../core';
 import type { SandboxTarget } from '../plugins/agents/switchable';

package/lib/{loop → apps}/apps/records.d.ts

@@ -6,7 +6,7 @@
  *
  * Pure but for `fetch`: no React.
  *
- * @module loop/apps/records
+ * @module apps/apps/records
  */
 /** What a record entry is. */
 export type RecordKind = 'session' | 'tool_call' | 'decision' | 'check' | 'approval' | 'output' | 'feedback'

package/lib/{loop → apps}/apps/rules.js

@@ -32,7 +32,7 @@
  *
  * Pure: nothing here calls a tool or renders.
  *
- * @module loop/apps/rules
+ * @module apps/apps/rules
  */
 import { SERVER_ACTIONS, BACKEND_TOOL_ACTIONS } from '../../specs/actions';
 /** The four behaviours, from the freest to the most restricted. */

package/lib/{loop → apps}/apps/saved.d.ts

@@ -7,7 +7,7 @@
  *
  * Pure: no React.
  *
- * @module loop/apps/saved
+ * @module apps/apps/saved
  */
 /** The runtime's tool that saves a result as a page of a Space. */
 export declare const SAVE_TOOL = "save_to_space";

package/lib/{loop → apps}/apps/saved.js

@@ -11,7 +11,7 @@
  *
  * Pure: no React.
  *
- * @module loop/apps/saved
+ * @module apps/apps/saved
  */
 /** The runtime's tool that saves a result as a page of a Space. */
 export const SAVE_TOOL = 'save_to_space';

package/lib/{loop → apps}/apps/settingsInputs.d.ts

@@ -7,7 +7,7 @@
  *
  * Pure: no React, no network.
  *
- * @module loop/apps/settingsInputs
+ * @module apps/apps/settingsInputs
  */
 /** The nine inputs: the field each is, and the widget it is drawn with. */
 export declare const SETTING_INPUTS: Record<string, {

package/lib/{loop → apps}/apps/settingsInputs.js

@@ -11,7 +11,7 @@
  *
  * Pure: no React, no network.
  *
- * @module loop/apps/settingsInputs
+ * @module apps/apps/settingsInputs
  */
 /** The nine inputs: the field each is, and the widget it is drawn with. */
 export const SETTING_INPUTS = {

package/lib/{loop → apps}/apps/threads.d.ts

@@ -11,7 +11,7 @@
  *
  * Pure: the network is the `fetch` it is handed.
  *
- * @module loop/apps/threads
+ * @module apps/apps/threads
  */
 import type { ChatMessage } from '../../types/messages';
 /** What opening a thread says, in a person's words. */

package/lib/{loop → apps}/apps/uploads.d.ts

@@ -8,7 +8,7 @@
  *
  * Pure: no React, no network.
  *
- * @module loop/apps/uploads
+ * @module apps/apps/uploads
  */
 import type { AppSpec, AppUploadsSpec } from '../../types/agentspecs';
 /** The largest file a person may send an application, in megabytes. */

package/lib/{loop → apps}/apps/visitorToken.js

@@ -14,7 +14,7 @@
  * visitor is on the servers (turns a day, a session's minutes, a rate and a
  * ceiling for the day), not the life of a key.
  *
- * @module loop/apps/visitorToken
+ * @module apps/apps/visitorToken
  */
 import { useEffect, useState } from 'react';
 /** The id this tab keeps for its visitor. */

package/lib/{loop → apps}/apps/yaml.js

@@ -25,7 +25,7 @@
  *
  * Pure: nothing here reads or writes a disk.
  *
- * @module loop/apps/yaml
+ * @module apps/apps/yaml
  */
 import { Document, isMap, isScalar, isSeq, parseDocument, } from 'yaml';
 import { dumpAppspec, parseAppspec } from './appspec';

package/lib/{loop → apps}/core/a2uiComponents.js

@@ -4,12 +4,12 @@
  */
 /**
  * A component an application adds to the A2UI catalog it is drawn with (LOOP
- * P-17), as a contribution point, re-exported by `loop/core`: the components
+ * P-17), as a contribution point, re-exported by `apps/core`: the components
  * its developer wrote, contributed by the application's own plugin, so that
  * its page, the elements its code shows and its answers draw them — in that
  * application's workspace, and in no other.
  *
- * @module loop/core/a2uiComponents
+ * @module apps/core/a2uiComponents
  */
 import { defineContributionPoint } from '@datalayer/reactor';
 export const LoopA2uiComponent = defineContributionPoint('loop.a2ui.component');

package/lib/{loop → apps}/core/canvasBlocks.js

@@ -4,10 +4,10 @@
  */
 /**
  * The Canvas's palette as a contribution point (LOOP C-12), re-exported by
- * `loop/core`: kept apart so that reading the palette loads the reactor and
+ * `apps/core`: kept apart so that reading the palette loads the reactor and
  * the catalogue, and nothing of the workspace.
  *
- * @module loop/core/canvasBlocks
+ * @module apps/core/canvasBlocks
  */
 import { defineContributionPoint } from '@datalayer/reactor';
 export const LoopCanvasBlock = defineContributionPoint('loop.canvas.block');

package/lib/{loop → apps}/core/focusRequests.js

@@ -16,7 +16,7 @@
  * it renders the composer in every placement — docked, in-column, floating —
  * and the command should reach it wherever it is.
  *
- * @module loop/core/focusRequests
+ * @module apps/core/focusRequests
  */
 const listeners = new Set();
 /**

package/lib/{loop → apps}/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 → apps}/core/index.js

@@ -11,9 +11,36 @@
  * never on the shell, so the shell can be replaced (a browser page, a JupyterLab
  * panel) without touching a single plugin.
  *
- * @module loop/core
+ * @module apps/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 → apps}/core/promptStore.js

@@ -23,7 +23,7 @@
  * on their behalf — `submit` exists for the host that genuinely wants that,
  * and defaults to off.
  *
- * @module loop/core/promptStore
+ * @module apps/core/promptStore
  */
 import { create } from 'zustand';
 export const useLoopPromptStore = create((set, get) => ({

package/lib/{loop → apps}/core/surfaceRequests.d.ts

@@ -18,7 +18,7 @@
  * screen can say so rather than failing silently — which is how this went
  * unnoticed.
  *
- * @module loop/core/surfaceRequests
+ * @module apps/core/surfaceRequests
  */
 /** Told which surface somebody asked for. */
 export type SurfaceRequestListener = (surfaceId: string) => void;

package/lib/{loop → apps}/core/toolbar.js

@@ -9,7 +9,7 @@
  * provider, no toolbar, and no items either — has to be the same in both or
  * the two editors disagree about what switching a toolbar plugin off means.
  *
- * @module loop/core/toolbar
+ * @module apps/core/toolbar
  */
 import { useMemo } from 'react';
 import { useContributions } from '@datalayer/reactor/react';